29c657f7a7
Add 100+ automated unit tests from .expect file specifications Add session system test Add rsx:constants:regenerate command test Add rsx:logrotate command test Add rsx:clean command test Add rsx:manifest:stats command test Add model enum system test Add model mass assignment prevention test Add rsx:check command test Add migrate:status command test 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
123 lines
3.8 KiB
PHP
123 lines
3.8 KiB
PHP
<?php
|
|
/**
|
|
* CODING CONVENTION:
|
|
* This file follows the coding convention where variable_names and function_names
|
|
* use snake_case (underscore_wherever_possible).
|
|
*/
|
|
|
|
namespace App\RSpade\Commands\Rsx;
|
|
|
|
use App\Console\Commands\FrameworkDeveloperCommand;
|
|
use App\Models\File_Storage_Model;
|
|
use Rsx\Models\File_Attachment_Model;
|
|
|
|
/**
|
|
* Storage Info Command
|
|
* =====================
|
|
*
|
|
* PURPOSE:
|
|
* Display detailed information about physical file storage by hash.
|
|
*
|
|
* FRAMEWORK DEVELOPER ONLY:
|
|
* This command is hidden unless IS_FRAMEWORK_DEVELOPER=true in .env
|
|
* Provides low-level access to physical storage system for debugging.
|
|
*
|
|
* DISPLAYS:
|
|
* - Storage hash and file size
|
|
* - Storage path on disk
|
|
* - Physical file existence
|
|
* - Reference count (number of attachments)
|
|
* - Audit information (created/updated)
|
|
*/
|
|
class RsxStorageInfoCommand extends FrameworkDeveloperCommand
|
|
{
|
|
/**
|
|
* The name and signature of the console command.
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $signature = 'rsx:storage:info {hash : SHA-256 hash or incremented variant}';
|
|
|
|
/**
|
|
* The console command description.
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $description = 'Display detailed information about physical file storage';
|
|
|
|
/**
|
|
* Execute the console command.
|
|
*/
|
|
public function handle()
|
|
{
|
|
$hash = $this->argument('hash');
|
|
|
|
// Find storage by hash
|
|
$storage = File_Storage_Model::where('hash', $hash)->first();
|
|
|
|
if (!$storage) {
|
|
$this->error("Error: File storage not found with hash: {$hash}");
|
|
return 1;
|
|
}
|
|
|
|
// Count references
|
|
$attachments = File_Attachment_Model::where('file_storage_id', $storage->id)->get();
|
|
$ref_count = $attachments->count();
|
|
|
|
// Display storage information
|
|
$this->info('');
|
|
$this->info('File Storage Information');
|
|
$this->info('========================');
|
|
$this->info('');
|
|
|
|
$this->info('Storage:');
|
|
$this->info(" ID: {$storage->id}");
|
|
$this->info(" Hash: {$storage->hash}");
|
|
$this->info(" Size: {$storage->size} bytes ({$storage->get_human_size()})");
|
|
$this->info('');
|
|
|
|
$this->info('Physical File:');
|
|
$this->info(" Path: {$storage->get_storage_path()}");
|
|
$this->info(" Full Path: {$storage->get_full_path()}");
|
|
$this->info(" Exists: " . ($storage->file_exists() ? 'Yes' : 'No'));
|
|
|
|
if ($storage->file_exists()) {
|
|
$mime = mime_content_type($storage->get_full_path());
|
|
$this->info(" MIME Type: {$mime}");
|
|
}
|
|
|
|
$this->info('');
|
|
|
|
$this->info('References:');
|
|
$this->info(" Attachments: {$ref_count}");
|
|
|
|
if ($ref_count > 0 && $ref_count <= 10) {
|
|
$this->info('');
|
|
$this->info(' Attachment Keys:');
|
|
foreach ($attachments as $attachment) {
|
|
$attached_to = $attachment->fileable_type
|
|
? " → {$attachment->fileable_type}:{$attachment->fileable_id}"
|
|
: " (orphaned)";
|
|
$this->info(" - " . substr($attachment->key, 0, 24) . "... {$attached_to}");
|
|
}
|
|
} elseif ($ref_count > 10) {
|
|
$this->info(" (Use rsx:file:list to see all attachments)");
|
|
}
|
|
|
|
$this->info('');
|
|
|
|
$this->info('Audit:');
|
|
$this->info(" Created: {$storage->created_at}");
|
|
$this->info(" Updated: {$storage->updated_at}");
|
|
if ($storage->created_by) {
|
|
$this->info(" Created By: User #{$storage->created_by}");
|
|
}
|
|
if ($storage->updated_by) {
|
|
$this->info(" Updated By: User #{$storage->updated_by}");
|
|
}
|
|
$this->info('');
|
|
|
|
return 0;
|
|
}
|
|
}
|