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

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:

php application auth add personal --account=0123456789abcdef0123456789abcdef
php application 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

php application auth list --json
php application auth use work
php application 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:

php application catalog:validate --site=demo-affiliate --json
php application site:build demo-affiliate --clean --json
php application 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.

Production meminta konfirmasi

Ini guard, bukan bug. Gunakan mode interaktif untuk konfirmasi manual, atau tambahkan --confirm-production pada automation yang sudah memiliki approval terpisah. Uji selalu dengan --dry-run lebih dulu.