test

Author: bernardhanna

app/Console/Commands/ResourcesExportS3Urls.php

@@ -13,7 +13,8 @@ class ResourcesExportS3Urls extends Command
 {
     protected $signature = 'resources:export-s3-urls
                             {--active-only : Only rows with active=1}
-                            {--json : Output JSON array instead of CSV}';
+                            {--json : Output JSON array instead of CSV}
+                            {--output= : Write CSV or JSON to this path (e.g. storage/app/resources_s3_urls.csv)}';
 
     protected $description = 'Export ResourceItem id, name, source, thumbnail (for matching local filenames to live S3 keys)';
 
@@ -25,8 +26,22 @@ public function handle(): int
         }
         $rows = $q->get(['id', 'name', 'source', 'thumbnail']);
 
+        $outputPath = $this->option('output');
+        $outputPath = is_string($outputPath) ? trim($outputPath) : '';
+
         if ($this->option('json')) {
-            $this->line($rows->toJson(JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
+            $payload = $rows->toJson(JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+            if ($outputPath !== '') {
+                $full = $this->resolveOutputPath($outputPath);
+                if ($full === null) {
+                    return self::FAILURE;
+                }
+                file_put_contents($full, $payload);
+                $this->info("Wrote JSON ({$rows->count()} items) to: {$full}");
+
+                return self::SUCCESS;
+            }
+            $this->line($payload);
 
             return self::SUCCESS;
         }
@@ -46,9 +61,43 @@ public function handle(): int
             ]);
         }
         rewind($out);
-        $this->output->write(stream_get_contents($out) ?: '');
+        $csv = stream_get_contents($out) ?: '';
         fclose($out);
 
+        if ($outputPath !== '') {
+            $full = $this->resolveOutputPath($outputPath);
+            if ($full === null) {
+                return self::FAILURE;
+            }
+            file_put_contents($full, $csv);
+            $this->info("Wrote CSV ({$rows->count()} rows) to: {$full}");
+
+            return self::SUCCESS;
+        }
+
+        $this->output->write($csv);
+
         return self::SUCCESS;
     }
+
+    /**
+     * @return string|null Absolute path, or null on error
+     */
+    private function resolveOutputPath(string $path): ?string
+    {
+        $full = str_starts_with($path, DIRECTORY_SEPARATOR) || preg_match('#^[a-zA-Z]:\\\\#', $path) === 1
+            ? $path
+            : base_path($path);
+
+        $dir = dirname($full);
+        if (! is_dir($dir)) {
+            if (! @mkdir($dir, 0755, true) && ! is_dir($dir)) {
+                $this->error("Cannot create directory: {$dir}");
+
+                return null;
+            }
+        }
+
+        return $full;
+    }
 }

docs/resources/resources-s3-urls-export.example.csv

@@ -0,0 +1 @@
+id,name,source,thumbnail,pdf_basename,thumb_basename

resources/views/admin/resources-import/index.blade.php

@@ -47,7 +47,7 @@ class="rounded border-gray-300">
                             <input type="file" name="file" id="file" accept=".csv,.xlsx,.xls" required
                                    class="block w-full max-w-md" aria-required="true">
                             <p class="text-sm text-gray-600 mt-1">Required column: <code>name_of_the_resource</code>. Optional: link, description, image, filters_type, filters_target_audience, filters_level_of_difficulty, filters_programming_language, filters_subjects, filters_topics, filters_language, category, group_name, <code>s3_suffix</code> (or <code>file_suffix</code>) per row for file naming. Max 10 MB.</p>
-                            <p class="text-sm text-gray-600 mt-1">After verify, the preview step lets you choose <strong>batch</strong> / <strong>stable</strong> / <strong>preserve</strong> naming or a <strong>custom suffix</strong>. On the server: <code>php artisan resources:export-s3-urls &gt; stamps.csv</code> then rename local PDFs/images to match <code>pdf_basename</code> / <code>thumb_basename</code> and import with <code>--preserve-filenames</code>. See <code>resources:import --help</code>.</p>
+                            <p class="text-sm text-gray-600 mt-1">After verify, the preview step lets you choose <strong>batch</strong> / <strong>stable</strong> / <strong>preserve</strong> naming or a <strong>custom suffix</strong>. On the server: <code>php artisan resources:export-s3-urls --output=storage/app/resources_s3_urls.csv</code> then rename local PDFs/images to match <code>pdf_basename</code> / <code>thumb_basename</code> and import with <code>--preserve-filenames</code>. Example header: <code>docs/resources/resources-s3-urls-export.example.csv</code>. See <code>resources:import --help</code>.</p>
                             <p id="file-required-hint" class="text-sm text-amber-600 mt-1 hidden">Please select a file first, then click Verify.</p>
                         </div>