ブログ一覧に戻る

公開日:

WooCommerceのログ削除処理でftp_nlist() Fatal Errorになるときの直し方

WooCommerceのログ削除処理 wc_cleanup_logs() 実行時に、FTPExt filesystem環境で ftp_nlist() のFatal Errorが出た状態から、ファイルシステム方式、Action Scheduler、ログ削除の影響確認までやった事例をご紹介します。

発生したケース

WooCommerceのスケジュール処理中に、サイトのエラーログへ ftp_nlist() のFatal Errorが出るケースがありました。

公開ページや注文画面がすぐ落ちるとは限りません。ところが、WooCommerceのログ削除処理 wc_cleanup_logs() が走ったタイミングで、WordPressのファイルシステムAPIがFTPExt方式を使い、FTP接続がない状態でファイル確認を行って落ちていました。

PHP Fatal error:
Uncaught TypeError:
ftp_nlist(): Argument #1 ($ftp) must be of type FTP\Connection, null given

場所:
wp-admin/includes/class-wp-filesystem-ftpext.php

関連処理:
wc_cleanup_logs()
Automattic\WooCommerce\Internal\Admin\Logging\FileV2\File->is_readable()

このケースでは、WooCommerceの注文データや商品データの問題ではなく、WooCommerceログ削除処理とWordPressファイルシステム方式の組み合わせで起きる問題と判断しました。

WooCommerce FTPExtログ削除Fatal Error確認フロー

このケースの解決方法

このケースで解決につながる対応は、WooCommerceを修正版へ更新し、ログ削除処理がFTPExt方式でFatal Errorにならないか確認することです。すぐに更新できない場合は、ファイルシステム方式を direct に切り替えられる環境か、サーバー管理者へ確認します。

具体的な解決手順:
1. Action Schedulerのhook名とエラー時刻を控える
2. `wc_cleanup_logs()` と `ftp_nlist()` のFatal Errorか確認する
3. WooCommerceを修正版へ更新できるかステージングで検証する
4. 必要に応じて `FS_METHOD` やFTP関連定数を確認する
5. direct方式へ切り替えられるかサーバー管理者へ確認する
6. 更新後にログ削除ジョブが再失敗しないか確認する

この問題は注文データではなく、ログ削除時のファイル操作方式で落ちていると判断します。注文や決済を直接触る前に、Action Schedulerとファイルシステム方式を確認します。

保守現場ではこう判断する

ftp_nlist() が出ている場合、WooCommerce本体の画面だけを見るのではなく、サーバーのファイル操作方式を確認します。

状態判断
wc_cleanup_logs() が出るWooCommerceログ削除処理を確認
WP_Filesystem_FTPext が出る直接ファイル操作ではなくFTP方式を使っている
FTP\Connection, null givenFTP接続が初期化されないままファイル確認している
Action Scheduler経由で発生バックグラウンド処理の再発を確認する
セキュリティ方針でdirect方式不可サーバー設定変更だけで片付けない

このエラーは「ログ削除だから軽い」とは判断しません。Fatal Errorがバックグラウンド処理で繰り返されると、Action Schedulerの失敗、管理画面のノイズ、監視通知の増加につながります。

具体的な解決手順

WooCommerce FTPExtログ削除エラー確認

[ ] debug.logまたはサーバーログで wc_cleanup_logs() が出ているか確認する
[ ] wp-admin/includes/class-wp-filesystem-ftpext.php が出ているか確認する
[ ] DISALLOW_FILE_MODS、FS_METHOD、FTP_* 定数を確認する
[ ] WooCommerce > ステータス > スケジュール済みアクションを確認する
[ ] wc_cleanup_logs 関連の失敗回数と実行間隔を確認する
[ ] WooCommerceのログ保存先と権限を確認する
[ ] WooCommerce更新で修正済みか確認する
[ ] direct方式へ変更できるか、セキュリティ要件と合わせて判断する

ftp_nlist() の一般的な機能を深く理解する必要はありません。重要なのは、WooCommerceのログ削除処理がファイルの存在確認を行うとき、WordPress側がFTPExt方式を使い、FTP接続がない状態で処理が進んでいることです。

実際の復旧手順

  1. エラーが出ているAction Schedulerのhook名と時刻を控える
  2. WooCommerceログ削除処理で落ちているか確認する
  3. FS_METHOD やFTP関連定数を確認する
  4. WooCommerceの修正版へ更新できるかステージングで検証する
  5. direct方式へ切り替えられる環境か、サーバー管理者へ確認する
  6. すぐ切り替えられない場合は、失敗ジョブの再実行間隔とログ増加を監視する
  7. 更新後に wc_cleanup_logs() が再失敗しないか確認する
  8. WooCommerceログ、注文、決済、メール処理に副作用がないか確認する

セキュリティポリシーでFTP方式を使っているサイトでは、安易に FS_METHOD を direct に変えるのは避けます。ファイル権限や運用ルールを確認してから判断します。

やってはいけない対応

NG理由
失敗したActionだけ削除して終わる次回のログ削除で再発する
FS_METHOD を本番で即変更するサーバーのセキュリティ方針に反する可能性がある
WooCommerceログを全削除する調査材料を失う
注文・商品データを疑って先に触るログ上の原因はファイルシステム処理側

顧客向け通知例

WooCommerceのバックグラウンド処理でFatal Errorが出ている状態を確認しました。

ログ上では、注文や商品データではなく、WooCommerceのログ削除処理がファイル確認を行う際に、サーバーのファイルシステム方式と噛み合わずエラーになっている可能性があります。

まずAction Schedulerの失敗状況、WooCommerceログ、サーバーのファイル操作方式を確認します。修正版への更新またはサーバー設定の見直しを検証環境で確認してから本番反映します。

公式情報

WooCommerceはWordPress向けのECプラットフォームで、ログ管理やバックグラウンド処理にもAction Schedulerを利用します。今回のようなサーバー依存の問題では、WooCommerce公式配布元とGitHub issueを確認します。

確認環境

確認対象:
- WordPress:
- WooCommerce:
- PHP:
- FS_METHOD:
- FTP関連定数:
- Action Schedulerの失敗hook:
- WooCommerceログ保存先:

復旧確認チェック

復旧確認:
[ ] wc_cleanup_logs() のFatal Errorが再発していない
[ ] Action Schedulerに同じ失敗ジョブが増えていない
[ ] WooCommerceログが正常に記録・削除される
[ ] 注文、決済、メール送信に副作用がない
[ ] ファイルシステム方式の変更有無を記録した
[ ] セキュリティ方針と復旧方法に矛盾がない

NexraOneでできること

NexraOneはWooCommerceのファイルシステム処理を修正するツールではありません。ただし、Fatal ErrorやWP-Cron、バックグラウンド処理の異常を監視できると、公開ページが表示されていても裏側でWooCommerceの定期処理が失敗している状態に気付きやすくなります。

ECサイトでは、トップページが200を返すことだけでは足りません。注文・決済・メールだけでなく、ログ削除やスケジュール処理も保守対象に含める必要があります。

あわせて確認したい記事

WooCommerceのAction Schedulerでpast-due actionsが増えるときの確認方法 と、WordPressのWP-Cronが止まったときの確認チェックリスト を確認してください。Fatal Error全般は、WordPress Fatal Errorの原因と確認方法 が近いです。

まとめ

WooCommerceのログ削除処理で ftp_nlist() のFatal Errorが出る場合、注文データよりも先に、WooCommerceログ削除、Action Scheduler、WordPressファイルシステム方式を確認します。

失敗ジョブを削除するだけで終わらせず、WooCommerce更新、FTPExt接続、サーバー設定、ログ削除の再実行まで確認してください。

※本記事では、公開されている事例や保守現場での知見をもとに、実務で確認すべきポイントを整理しています。

この記事を書いた人

uehiro
uehiroWebアプリケーションエンジニア

2019年よりWeb制作・システム開発に従事。WordPress・PowerCMS・Movable TypeのCMS構築・運用支援のほか、Next.js・Astro・Nuxt.jsを活用したヘッドレスCMS・モダンWeb開発に携わる。約150件の制作・運用支援実績を持ち、現在はWordPress監視サービス「NexraOne」の開発・運営を担当。

WordPress Monitoring Service

WordPressサイトの異常に、
早く気づける体制を作りませんか?

死活監視、WP-Cron、Fatal Error、SSL・ドメイン期限、更新検知をまとめて確認。
3サイトまで無料でWordPress監視を始められます。

ブログ一覧に戻る

合わせてこんな記事も読まれています

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

2026-11-18

wp-maintenance

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

WordPressには決まったサポート期限がなく、正式に保守されているのは最新版だけです。古い版へのセキュリティ修正は好意で出ているもので、2026年11月時点で4.7以降に届いています。PHPが古いサイトが6.9系で止まる理由、修正が届かない版、更新を先送りできないサイトの見分け方を、WordPress.orgの公式情報をもとに整理します。

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

2026-11-16

wp-maintenance

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

WordPressのセキュリティ対策を業者に頼むと、1回の設定は2万円台から、月額の運用は5,500円から3万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。

WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること

2026-11-13

wp-maintenance

WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること

WordPressの表示速度の改善(高速化)を業者に頼むと、公開価格は1サイト1万円前後から6万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、スコア保証の読み方、頼む前に自社で確かめておくことを整理します。

最新記事はこちら

ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき

2026-11-20

wp-guide

ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき

ACF PROのライセンスキーは「ACF」→「Updates」か、wp-config.phpのACF_PRO_LICENSEで有効にします。開発・ステージング環境がサイト数に数えられないURLの条件、サイトを移転したときの再有効化、期限が切れたときにできなくなること、旧ライセンス(買い切り)とComposerでの入れ方をまとめました。

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

2026-11-18

wp-maintenance

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

WordPressには決まったサポート期限がなく、正式に保守されているのは最新版だけです。古い版へのセキュリティ修正は好意で出ているもので、2026年11月時点で4.7以降に届いています。PHPが古いサイトが6.9系で止まる理由、修正が届かない版、更新を先送りできないサイトの見分け方を、WordPress.orgの公式情報をもとに整理します。

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

2026-11-16

wp-maintenance

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

WordPressのセキュリティ対策を業者に頼むと、1回の設定は2万円台から、月額の運用は5,500円から3万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。