Troubleshooting ​

php: command not found ​

Pasang PHP 8.3+ dan pastikan executable berada di PATH. Di Windows, tutup dan buka kembali PowerShell setelah installer mengubah PATH.

Ekstensi SQLite tidak ditemukan ​

bash
php -m

Pastikan daftar memuat PDO dan pdo_sqlite, lalu aktifkan extension pada php.ini yang digunakan PHP CLI.

No Cloudflare auth profile is selected ​

Tambahkan profil atau sediakan credential CI:

bash
php cuanaff auth add personal --account=0123456789abcdef0123456789abcdef
php cuanaff auth status --json

Credential store desktop tidak tersedia ​

  • macOS: pastikan command security tersedia.
  • Linux desktop: pasang secret-tool dan jalankan dalam sesi DBus/desktop.
  • Windows: jalankan dari Windows PowerShell atau PowerShell 7 dengan Credential Manager tersedia.

Pada sistem headless, Cuanaff otomatis memakai file private 0600. Lihat backend aktual lewat auth list --json.

Profile salah saat deploy ​

bash
php cuanaff auth list --json
php cuanaff auth use work
php cuanaff auth status work --json

Atau selalu berikan --profile=work pada site:deploy agar pilihan eksplisit.

Build atau audit gagal ​

Jalankan berurutan dan baca errors pada JSON:

bash
php cuanaff catalog:validate --site=demo-affiliate --json
php cuanaff site:build demo-affiliate --clean --json
php cuanaff site:audit demo-affiliate --profile=publish --json

Jangan deploy sebelum ketiganya sukses. Link rusak, metadata kosong, konten tipis, dan duplikasi adalah kegagalan publish yang disengaja. Untuk panduan lengkap inspeksi skema situs, opsi parameter, dan perbaikan galat relasi penawaran harga toko, pelajari modul Panduan Perintah catalog:validate.

Production langsung terdeploy ​

site:deploy tanpa --dry-run memang langsung menerbitkan ke production; tidak ada flag konfirmasi terpisah dan tidak ada environment lain. Uji selalu dengan --dry-run lebih dulu, lalu jalankan command yang sama tanpa flag itu bila outputnya sudah benar.

Foto produk tidak muncul atau berstatus missing ​

Gunakan batch sweeper media untuk melengkapi foto hero resmi pabrikan secara massal atau mendiagnosis penyebab kegagalan:

bash
php cuanaff product:media --site=nama-site --missing --dry-run

Jika foto gagal terunduh karena judul marketplace terlalu panjang dan kotor, tercemar nama toko seller, atau merupakan produk aksesoris unbranded tanpa merek pabrikan resmi, ikuti solusi lengkap di Panduan Troubleshooting Media & Penanganan Unbranded SKU.