WP Ultimate CSV インポーターは、CSV ファイルのインポート、XML、TSV、およびExcelファイルをWordPressに置き換えます。 また、プラグインを使ってWordPressデータをエクスポートすることもできます。 ただし、他の柔軟なツールと同様に、使用中に問題が発生する可能性があります。 このトラブルシューティング ガイドでは、ユーザーが直面した問題のほとんどと、問題が発生した場合の修正方法について説明します。
開始する前に、サーバーがインポートとエクスポートに関する次の要件を満たしていることを確認してください。
CSV/XML のインポートとエクスポートのサーバー要件 #
PHP 設定 #
- PHPバージョン: 7.4 以上 (8.x 推奨)。
- max_execution_time:300以上(ファイルサイズとサーバー速度によって異なります)。
- memory_limit:少なくとも512M、大量輸入の場合は1024Mが優先されます。
- upload_max_filesize: 最大のインポート ファイルに一致するように、少なくとも 128M 以上。
- post_max_size: upload_max_filesize より大きい (例: 256M)。
- max_input_vars: 5000 以上 (カスタムフィールドをインポートする場合に便利です)。
- allow_url_fopen: オン (外部 URL からインポートする場合)。
- mbstring,xml,シンプルXML,json,libxmlextensions: 有効。
php.ini ファイルの一部の設定を変更し、ホスティング サーバーのセットアップで上記のいくつかの拡張機能を有効にする必要があります。
この詳細はプラグイン内でも確認できますセキュリティとパフォーマンス>>設定.
ファイルアップロードの問題 – すべてのサーバー関連の問題と解決策 #
1.1 サーバー構成の制限 #
A. upload_max_filesize制限 #
発行：ファイルがこの制限を超えると、アップロードが失敗するか、サイレントに切り捨てられます。
解決する：ファイルphp.ini増加:
upload_max_filesize = 512M
または.htaccessの場合:
nginxを使用している場合は、
php_value upload_max_filesize 512M
B. post_max_size制限 #
発行：投稿ペイロード全体(ファイルを含む)が許可されたサイズを超え、アップロードに失敗します。
解決する：ファイル内の変更php.ini
post_max_size = 512M
C. max_execution_time タイムアウト #
発行：大きなファイルのアップロード中にアップロード プロセスがタイムアウトします。
解決する：ファイル内の変更php.ini
max_execution_time = 300
- または、この実行タイムアウトエラーを回避するには、可能であれば SFTP オプションまたはチャンクアップロードを使用します。
D. memory_limit疲労 #
発行：アップロード処理中にサーバーのメモリが不足し、致命的なエラーが発生します。
解決する：ファイルの変更php.ini
memory_limit = 512M
E. max_input_time 制限 #
発行：受信データの処理中にタイムアウトし、アップロードが不完全になります。
解決する：php.iniファイルの以下の行を変更して修正します
max_input_time = 300
1.2 サーバータイムアウトエラー #
- 504 ゲートウェイ タイムアウト
理由：PHPがアップロードを処理する間のNginxタイムアウト。
- 524 (クラウドフレア)
理由：アップロードまたは処理がCloudflareの100秒のタイムアウトを超えています。
- 408 リクエスト タイムアウト:
理由：アップロードに時間がかかりすぎると、クライアントが切断されます。
修正する解決策:
- proxy_read_timeoutを増やします(Nginxサーバー内)。
- 直接アップロードを使用します(大きなファイルの場合はCloudflareをバイパスします)。
- 非常に大きなファイルには、HTTP の代わりに FTP アップロードを使用します。
1.3 権限と所有権の問題 #
- アップロードディレクトリ(wp-content/uploadsまたは同等のもの)には書き込み権限がありません。
- ユーザーの所有権が正しくありません (たとえば、www-data ではなく root が所有しています)。
解決する：
以下のコマンドを実行して、uploads フォルダーのファイル権限と所有権の問題を修正します。
chmod -R 755 /パス/先/アップロード
chown -R www-data:www-data /path/to/uploads
- スタックに応じてユーザー/グループを調整します。
1.4 ディスク容量の枯渇 #
理由：サーバーのディスク容量が不足しているため、アップロードに失敗します。
解決する：
- df -h でモニターします。
- 未使用のログ、キャッシュをクリアします。
- 常に制限に達している場合は、ストレージを拡張します。
1.5 ModSecurityまたはファイアウォールのブロック #
理由：セキュリティモジュールは、次の理由でアップロードをブロックします。
- 大きな POST 要求。
- 安全でないとフラグが立てられたファイルの種類。
解決する：
- サーバー/ファイアウォールのログを確認します。
- アップロード中にIPをホワイトリストに登録するか、厳格なルールを一時的に無効にします。
- ModSecurity ルールを調整して、大きなファイルのアップロードを安全に許可します。
WP Ultimate CSV Importer Pro
Get Ultimate CSV/XML Importer to import data on WordPress faster, quicker and safer.
1.6 サーバリソース制限(CPU/IO) #
理由：共有ホスティングは、大規模なアップロード中に CPU または IO をスロットルし、アップロードの速度が遅くなり、ランダムな障害が発生します。
解決する：
- トップまたはiotopでモニターします。
- トラフィックの少ない時間帯にアップロードをスケジュールします。
- 上位のホスティング プランまたは VPS にアップグレードします。
1.7 セッションとガベージコレクションの問題 #
理由：アップロードが長すぎると、session.gc_maxlifetimeが低すぎるとセッションがドロップする可能性があります。
解決する：
session.gc_maxlifetime = 86400
アップロード中にファイルの値を増やすか、キープアライブ ping を実装php.ini。
1.8 アップロードが100%で止まる #
問題の理由:多くの場合、
- アップロード後にPHPがファイルを処理しますが、制限に達しています。
- 破損により一致しない特定のコンテンツ長を予期するサーバー。
解決する：
- アップロード設定を検証します。
- ブラウザーコンソールでJSアップロードハンドラーエラーを確認します。
- アップロード後の処理中にバックエンドの問題がないかerror_logを確認します。
CSV/XML/XLS/XLSX のエンコードとファイル検証の問題: 問題の理由と解決策 #
一般的なエンコーディングの問題と理由 #
以下は、WP Ultimate CSV Importer でのインポートに使用される複数のファイル タイプでエンコーディングの問題が発生する一般的な理由です。
- 文字化け (文字化け)
異なるエンコーディング (ANSI、ISO-8859-1 など) を想定したエディタで UTF-8 ファイルを開くことが原因で発生します。 - BOM(バイトオーダーマーク)の問題
UTF-8 BOM は、一部のパーサーで問題を引き起こす可能性があります。 - 特殊文字(€、éなど)©が正しく表示されない
ファイルは、一致するエンコーディングで保存または読み取られません。 - CSV 区切り文字の問題
、または ; エンコードが正しく処理されていない場合に分割の問題を引き起こすフィールド内。 - インポート時のエンコードの不一致
UTF-8 ファイルを Excel にインポートすると、デフォルトで ANSI が設定されるため、文字が破損します。 - 非表示のコントロール文字 (印刷不可)
これにより、インポートパーサーが壊れたり、予期しない出力が生成されたりする可能性があります。 - 誤った宣言による XML 解析エラー
たとえば、ファイルの内容は UTF-8 ですが、XML ヘッダーには encoding=”ISO-8859-1″ と表示されます。 - XLS/XLSX コンテンツの破損
これはまれですが、XLSX 内の基礎となる XML が間違ったエンコーディングで手動で変更された場合に発生する可能性があります。
エンコーディングの問題に対する推奨される解決策: #
- ファイルを常にBOM なしの UTF-8輸入者が明示的にBOMを要求しない限り。
- 次のようなツールを使用してエンコーディングを確認します。
- file ??????(ファイル入力filename.csv)±
- Notepad++ (エンコード メニュー)。
- VS Code (右下のエンコード インジケーター)。
- file ??????(ファイル入力filename.csv)±
- 対してExcel CSV の問題使う：
- BOM を含む UTF-8 CSV古い Excel バージョンとの互換性のために。
- または、UTF-8 を手動で指定して「テキストからのデータ→」を使用してインポートします。
- BOM を含む UTF-8 CSV古い Excel バージョンとの互換性のために。
- XML の場合は、次のことを確認してください。
- XML 宣言は実際のエンコードと一致します。
- 例: <?xml version=”1.0″ encoding=”UTF-8″?>。
- XML 宣言は実際のエンコードと一致します。
- 以下を使用して、非表示のコントロール文字を削除します。
- iconv -c -f UTF-8 -t UTF-8 input.csv -o cleaned.csv
- 正規表現をサポートするテキストエディタは、x00-x1Fを置き換えます。
- iconv -c -f UTF-8 -t UTF-8 input.csv -o cleaned.csv
CSV ファイルの検証に関する一般的な問題 #
CSV ファイル形式は検証の問題が発生しやすく、最も一般的な理由は次のとおりです。
- 区切り文字の不一致による列の欠落または余分な。
- テキストフィールド内のエスケープされていない特殊文字(コンマ、引用符)。
- 引用符で囲まれたフィールド内での改行処理が正しくありません。
- 引用符の使用に一貫性がありません。
- 空の行または不正な行。
- 間違ったデータ型 (日付形式など)。
- ファイルサイズが大きいと、アップロード中に切り捨てられる。
ファイル検証の問題に対する推奨ソリューション #
1. CSV ファイルの検証の場合:
- CSV 検証ツール (CSV Lint や CSVKit など) を使用します。
- 次のことを確認します。
- 区切り文字と引用符文字は一貫しています。
- すべての行の列数は同じです。
- 区切り文字と引用符文字は一貫しています。
- 特殊文字を含むフィールドは引用符を使用してエスケープします。
- 改行文字を LF (n) に標準化します。
- 大きなファイルの場合:
- 処理する前に、より小さなチャンクに分割します。
- PHP のインポートで使用する場合は、PHP のメモリ制限を増やします。
- 処理する前に、より小さなチャンクに分割します。
2. XLS/XLSX ファイル検証の場合:
- 好むXLSXのオーバーXLSのUnicode処理が改善されたため。
- 必要な場合を除き、内部 XML ファイルの編集は避け、編集する場合は UTF-8 を一貫して使用してください。
一般的なインポートの問題と解決策 #
1. インポートファイルがアップロードされない #
エラーメッセージが表示されないインポートファイルがアップロードされない問題が発生した場合は、2つの理由が考えられます。
- ファイルサイズが大きすぎます:インポート ファイルがサーバーの最大アップロード サイズを超える可能性があります。
- タイムアウトの問題:ファイルのアップロードプロセス中にサーバーがタイムアウトすることがあります。
ソリューション：
- 最大アップロードサイズを増やす:
- php.ini ファイルを編集または変更し、upload_max_filesize、post_max_size、max_execution_time の値を増やします。
- または、ホスティング プロバイダーに問い合わせて、これらの制限を引き上げてください。
- 大きなファイルには FTP を使用します。ファイルが大きすぎる場合は、FTP 経由で直接アップロードし、インポートにインポーターの FTP オプションを使用することを検討してください。
2. インポートが開始しない、またはフリーズする #
考えられる原因:
- サーバー構成:サーバーでは、実行時間やメモリ割り当てに制限がある場合があります。
- CSV ファイルの問題:CSV ファイルには、空の行、特殊文字、予期しない改行などの書式設定の問題がある可能性があります。
ソリューション：
- PHP の制限を引き上げる:
- php.iniのmax_execution_timeとmemory_limitを変更して、インポートプロセスにより多くのリソースを使用できるようにします。
- max_input_vars がより高い値 (フィールドが多い場合は 5000 以上など) に設定されていることを確認します。
- CSV 形式を確認します。
- テキスト エディターで CSV ファイルを開き、問題を引き起こす可能性のある予期しない空行、コンマ、特殊文字がないことを確認します。
- CSV ファイルが UTF-8 形式でエンコードされていることを確認してください。
- より小さなインポートを実行します。CSV ファイルが大きい場合は、小さなファイルに分割して、一度に 1 つずつインポートしてみてください。
3. インポート後にデータが表示されない #
データが正常にインポートされたように見えるのに、Web サイトのフロントエンドに表示されない場合は、以下にいくつかの原因が考えられます。
考えられる原因:
- フィールドマッピングの問題:CSVファイルのフィールドがWordPressのフィールドに正しくマッピングされていない可能性があります。
- キャッシュの問題:場合によっては、キャッシュプラグインによって、新しくインポートされたデータが表示されないことがあります。
ソリューション：
- フィールドマッピングの確認:
- CSV ファイルのフィールドがそれぞれの WordPress フィールドに正しくマッピングされていることを確認してください。 カスタムフィールドまたはタクソノミーが正しく構成されていることを再確認します。
- キャッシュをクリア:
- キャッシュ プラグインまたはブラウザ キャッシュからキャッシュをクリアして、最新のコンテンツを確実に表示できるようにします。
4. インポート後のデータ形式が正しくない #
考えられる原因:
- CSV ファイルのエンコーディング:CSV ファイルのエンコードが正しくなく、フォーマットの問題が発生する可能性があります。
- 日付または数値の書式設定が正しくない:WordPressサイトの地域設定が、CSVファイルで使用されている形式と一致しない可能性があります。
ソリューション：
- 正しいエンコーディングを確認します。
- CSV ファイルを UTF-8 エンコードで保存していることを確認します。 不明な場合は、Notepad++ などのテキスト エディターを使用して、エンコーディングを確認して調整できます。
- 日付と数値の形式を確認します。
- CSV ファイルの日付形式が WordPress サイトの設定で使用されている形式と一致していることを確認してください。 行きます設定>一般WordPress管理画面で、日付と時刻の形式を確認して更新します。
5. 画像または添付ファイルの欠落 #
CSVファイルでリンクされている画像や添付ファイルが正しくインポートされません。
考えられる原因:
- 画像のURLが間違っている:CSV ファイル内の画像 URL が壊れているか、形式が正しくない可能性があります。
- サーバーの制限:サーバーが外部 URL のダウンロードを許可していない可能性があります。
ソリューション：
- 画像のURLを確認します。
- CSV ファイル内の画像 URL は正確で、一般に公開されている必要があります
- ローカルパスを使用する:
- より良い結果を得るには、外部 URL ではなく画像のローカル パスを使用してみてください。
- サーバー権限を増やす:
- サーバーが外部要求を許可し、インポート中にファイルをダウンロードするために必要な権限が設定されていることを確認します。
6. プラグインの競合 #
プラグインが予期しない動作をしている、データをインポートしない、インポートプロセスでエラーが表示されるなど。
考えられる原因:
- 他のプラグインとの競合:WordPressサイトの別のプラグインがインポートプロセスを妨げている可能性があります。
ソリューション：
- 他のプラグインを無効にする:
- 他のプラグインを 1 つずつ無効にして、競合の原因となっているプラグインを特定します。 また、問題を切り分けるために、必須ではないプラグインをすべて一時的に無効にすることもできます。
- テーマの競合を確認する:
- 場合によっては、アクティブなテーマがインポートに干渉することがあります。 そのため、テーマをデフォルトのWordPressテーマに切り替えたり変更したりして、問題が解決しないかどうかを確認できます。
7. プラグインが管理パネルに表示されない #
ザWP Ultimate CSV インポーターpluginはWordPressの管理メニューに表示されません。
考えられる原因:
- プラグインのインストールの問題:プラグインが正しくインストールまたはアクティブ化されていない可能性があります。
- 権限の問題:プラグインにアクセスするためのユーザーアカウントの権限がありません。
ソリューション：
- プラグインを再インストールします。
- WordPressの管理パネルからプラグインを削除し、再アップロードして再インストールしてみてください。 インストールしたら、アクティブ化されていることを確認してください。
- ユーザー権限を確認します。
- WordPress ユーザー ロールに、プラグインとその機能にアクセスするために必要な権限があることを確認してください。 すべての機能を使用するには、管理者アクセスが必要です。
8. 予期しないインポート結果 (余分なデータ、間違った行) #
インポートには、余分な行、空のフィールド、またはソース CSV ファイルと一致しない誤ったデータが表示されます。
考えられる原因:
- CSV の重複行:CSV ファイルに余分な空の行や重複したデータがある可能性があります。
- 不適切なフィールドマッピング:フィールドマッピングが正しくないと、データが間違った列またはフィールドに配置される可能性があります。
ソリューション：
- CSV の重複を確認します。
- スプレッドシート エディター (Excel や Google スプレッドシートなど) で CSV ファイルを開き、空白行や重複した行を削除します。
- フィールドマッピングの確認:
- インポートプロセス中に、各CSVフィールドと対応するWordPressフィールドのマッピングを再確認してください。 マッピングが正しくないと、データが正しく入力されない可能性があります。
インポート/エクスポート終了の問題の処理 #
プロセス全体が完了する前にインポートまたはエクスポート プロセスが突然停止した場合は、時間、メモリ、またはリソースの制限により、サーバーがプロセスを終了したことを意味します。
最初に行うべきことは次のとおりです。
2.1 反復あたりのレコード数の減少 #
「設定のインポート(インポート中)」に移動し、「レコードのアダプティブファイル処理を要しますか?」などのテキストとともに提供される直感的なファイル処理オプションを選択します。
- まず、バッチごとに処理されるレコード数を減らします。
- 試みる：
- 50 → 20 → 10 → 1
- 50 → 20 → 10 → 1
- これにより、リクエストごとのワークロードが軽減され、サーバーのタイムアウトやメモリの枯渇を回避できます。
2.2 それでもイテレーションごとに 1 レコードで失敗する場合は、以下を確認してください。 – 一般的なインポートおよびエクスポート サーバー エラー #
A. 500 – 内部サーバ エラー #
- インポート/エクスポート中に一般的なサーバーエラーが発生します。 多くの場合、次の理由で発生します。
- プラグイン/テーマの PHP 致命的なエラー。
- メモリ不足 (memory_limit)。
- .htaccessが破損しています。
- PHP の設定ミス。
- プラグイン/テーマの PHP 致命的なエラー。
修正方法は次のとおりです。
error_logをチェックして、特定のPHPエラーを特定します。
たとえば、512M memory_limit増やします。
競合するプラグイン/テーマを無効にし、インポート/エクスポートを再試行します。
.htaccess を (保存>パーマリンク>設定).
WP CLIまたはcronを使用している場合は、正しいPHPパスを確認してください。
B. 503 – サービスが利用できない #
- サーバーが過負荷になっているか、メンテナンス中です。
- 次の場合に発生する可能性があります。
- インポート/エクスポート プロセスが使用可能な CPU またはメモリを超えています。
- ホスティング プロバイダーは、リソースを大量に消費するプロセスをレート制限します。
- サーバーセキュリティシステム(ModSecurity、WAF)は、インポート/エクスポートスクリプトをブロックします。
- インポート/エクスポート プロセスが使用可能な CPU またはメモリを超えています。
それらを修正する方法:
オフピーク時に待ってから再試行してください。
使うバッチ処理(インポートあたりのレコードチャンクが小さくなり、つまり、イテレーションのインポート/エクスポート)。
セキュリティシステムでサーバーのIPをホワイトリストに登録します。
ホスティングに確認して、リソース制限を増やすか、サーバーログを確認してください。
C. 504 – ゲートウェイ タイムアウト #
- サーバーは、ゲートウェイ/プロキシのタイムアウト期間内に応答しませんでした。
- 大規模なインポート/エクスポート中または共有ホスティングで一般的です。
それらを修正する方法:
max_execution_timeとmax_input_timeを高めます。
cron ベースのインポート/エクスポートを使用して、ブラウザーのタイムアウトを回避します。
大きなファイルを小さなチャンクに分割します。
インポート/エクスポート中にサーバーの負荷を確認し、リソース使用量を最適化します。
D. 524 – タイムアウトが発生しました (Cloudflare) #
- Cloudflareはサーバーに到達しましたが、サーバーは100秒.
それらを修正する方法:
使うWP-CLI(英語)又はcron ジョブ大規模なインポート/エクスポートを実行します。
処理中にドメインのCloudflareプロキシを一時的に一時停止します。
インポート/エクスポートを最適化して、より小さなバッチで実行します。
ホスティングに相談して、サーバー処理の遅延を確認します。
E. 502 – 悪いゲートウェイ #
- アップストリーム サーバーが正しく応答しませんでした。
- 次の場合に発生する可能性があります。
- PHP-FPM は、負荷の高いインポート/エクスポート中にクラッシュします。
- リバース プロキシ (Nginx) 構成の問題。
- PHP-FPM は、負荷の高いインポート/エクスポート中にクラッシュします。
それらを修正する方法:
PHP-FPMとNginxのログを確認します。
PHP-FPM または Web サーバーを再起動します。
インポート/エクスポートを最適化して、サーバーに負荷をかけないようにします。
F. 403 – 禁じられた #
- インポート/エクスポート操作をブロックする権限またはセキュリティ制限。
それらを修正する方法:
フォルダーの権限を確認します (755 や 775 など)。
ファイル処理をブロックしている .htaccess またはサーバー・セキュリティー・ルールを確認します。
IP をホワイトリストに登録するか、ModSecurity/WAF ルールを調整します。
インポート/エクスポートがプラグインを介してトリガーされる場合は、ユーザーの役割/機能を確認します。
G. 404 – 見つかりません #
- インポート/エクスポート エンドポイントまたはファイルの URL にアクセスできません。
それらを修正する方法:
正しいファイルパスとURLを確認します。
パーマリンクの設定を確認し、. htaccessを再生成します。
ファイルが存在し、サーバー上で読み取り可能であることを確認します。
H. 408 – 要求タイムアウト #
- クライアントが要求を送信するのに時間がかかりすぎました。
それらを修正する方法:
ファイルのアップロード中にネットワークの状態を確認します。
大きなファイルの場合は、他のアップロードではなく FTP/SFTP アップロードを試してください。
php.iniのmax_input_timeを増やします。
WP Ultimate CSV Importer Pro
Get Ultimate CSV/XML Importer to import data on WordPress faster, quicker and safer.
ベストプラクティス #
- ステージング環境を使用する
インポートは、ライブ (実稼動) サイトで実行する前に、必ずステージング サイトでテストしてください。
- トライアルインスタンスをお試しください
サインアップするプライベートトライアルはこちら購入前にすべてのユースケースをテストしたい場合。 トライアルインスタンスの試用中に問題が発生した場合は、お気軽にお問い合わせください。サポートチーム助けを求めてください。
- サポートが必要な場合は、当社のチームにお問い合わせください
インポートまたはエクスポート中に問題が発生した場合、または特定のユースケースを試すためのガイダンスが必要な場合は、サポートチームにお問い合わせください。[email protected]インポート/エクスポート ファイルのサンプル、正確なエラー メッセージのスクリーンショット、表示時期の詳細、PHP バージョンとサーバー設定の詳細、error_logs や PHP-FPM ログなどの関連ログを共有します。 私たちのチームは、問題のトラブルシューティングを支援し、お客様の質問に答える準備ができています。
