はじめに
この記事では、WordPressでアップロードした画像が表示されない場合の対処法を詳しく解説します。画像はウェブサイトにとって非常に重要な要素であり、問題が発生するとユーザー体験やSEOに影響を与える可能性があります。
症状・背景
このテーマが必要になる主な場面:
- サイト上の特定のページまたは投稿で画像が表示されない
- メディアライブラリから画像を選択してもアップロードできない
- 既存の画像が突然表示されなくなった
- 新しい画像を追加した直後に問題が発生
手順・設定方法
ステップ1: ファイルの存在とアクセス権限を確認する
# WordPressインストールディレクトリ内のメディアファイルの存在を確認します。
find /var/www/html/wordpress/wp-content/uploads -name "*.jpg"
# アクセス権限をチェックし、必要に応じて修正します。通常、wp-contentフォルダは755で、サブフォルダとファイルは644です。
ls -l /var/www/html/wordpress/wp-content/uploads
chmod 755 /var/www/html/wordpress/wp-content/uploadsステップ2: ファイルのURLを確認する
# WordPressサイト上の画像の完全なパスをチェックします。これは通常、adminまたはwp-adminページから可能です。
echo "http://example.com/wp-admin/post.php?post=123&action=edit"
# 画像ファイルが正しくリソースサーバーに配置されていることを確認します（HTTPS対応サイトでは特に重要）。
curl -I http://example.com/wp-content/uploads/your-image.jpgステップ3: WordPressの設定をチェックする
# WordPressのメディアライブラリとアップロードパスが正しく設定されていることを確認します。通常、wp-config.phpファイルで調整可能。
grep 'UPLOADS' /var/www/html/wordpress/wp-config.php
# メディアの最大サイズや他のアップロード制限をチェックします（functions.phpまたはプラグイン経由）。
php -r "echo ini_get('upload_max_filesize');"ステップ4: キャッシュとプラグインの影響を確認する
# フルページキャッシュプラグインが有効になっていないか確認します。これにより、画像が正しく表示されない場合があります。
wp plugin list | grep wp-super-cache
# 一時的にすべてのプラグインを無効にし、問題が解決するかどうかをチェックします。
wp plugin deactivate --all注意事項
- FTPアクセスやサーバー管理権限がない場合、ホスティングプロバイダーに連絡して対処法を確認してください。
- 手動でPHPのファイルサイズ制限を変更する前に、ホスティングプロバイダーやサーバーベースの設定と整合性があることを確認してください。
- ファイルパスや権限を手動で修正する際は、バックアップを取ることを忘れないでください。
- サイトが公開されている場合、ファイル操作やプラグインの有効化/無効化を行う前に、必ずテスト環境で確認すること。
まとめ
1. ファイルとフォルダの存在およびアクセス権限: 画像ファイルの存在と適切なアクセス権限を確保します。
2. URLの整合性: 正しいURLで画像が参照されていることを確認し、必要に応じて修正します。
3. WordPress設定: メディアライブラリおよびアップロードパスが正しく設定されているかチェックします。
4. キャッシュとプラグインの影響: キャッシュやプラグインによる問題がないことを確認します。
関連記事: