2026年6月2日
2026年6月2日
WordPressで日本語スラッグが原因の問題解決
はじめに
日本語を含むスラッグを使用することで、サイトのSEOやユーザビリティが向上することがあります。しかし、その一方でさまざまな問題も引き起こす可能性があります。本記事では、WordPressで日本語スラッグを適切に使用するための設定方法と、発生しがちなエラーの対処法について解説します。
症状・背景
このテーマが必要になる主な場面:
- 日本語スラッグを使用した際に、サイトが正常に表示されない場合
- URLに日本語を含むと、内部リンクが正しく機能しない場合
- 404エラーが発生し、特定のページが見つからない場合
手順・設定方法
ステップ1: WordPress管理画面での設定変更
# パーマリンク設定ページを開く
wp admin menu edit permalink
# 日本語スラッグを使用するオプションを有効にする
wp option update blog_charset "UTF-8"
スtep2: .htaccessファイルの編集
# .htaccessファイルに以下のように記述を追加
echo 'AddDefaultCharset UTF-8' >> /var/www/html/.htaccess
# URLエンコードを使用するように設定
echo 'RewriteCond %{REQUEST_URI} !^/wp-content/plugins/' >> /var/www/html/.htaccess
ステップ3: ファイル名とディレクトリ名の変更
# WordPressのインストール先ディレクトリで使用している日本語ファイルを適切にエンコードする
find . -type f -name '*[!a-zA-Z0-9._-]*' -exec rename 'y/A-Za-z/+A-Za-z/' {} \;
# ディレクトリ名も同様に変更
mv 旧ディレクトリ名 新しいディレクトリ名
ステップ4: サーバー設定の確認
# Apacheの場合、以下のようにVirtualHost設定を確認・修正する
echo 'AddDefaultCharset UTF-8' >> /etc/httpd/conf/httpd.conf
# Nginxの場合、serverブロック内で以下の行を追加
echo 'add_header "Content-Type" "text/html; charset=UTF-8";' >> /etc/nginx/sites-available/default
注意事項
- ファイル名やディレクトリ名の変更は、バックアップを取ること。
- .htaccessファイルの編集には注意し、テストサーバーで確認すること。
- サーバー設定の変更は管理者と相談すること。
まとめ
1. UTF-8エンコーディング: 日本語スラッグを使用する際は、必ずUTF-8を使用するように設定します。
2. .htaccessの修正: .htaccessファイルに追加することで、ウェブサーバーが日本語を適切に処理できるようになります。
3. ファイル名とディレクトリ名の変更: ファイルやディレクトリにも日本語を使用する場合は、エンコードを行い、適切な形式に変換します。
4. サーバーレベルでの設定: サーバー設定を確認・修正することで、全体的な問題解決につながります。
5. テストとバックアップ: 重要なファイルや設定の変更前には必ずバックアップを取り、その後でテストを行います。
関連記事: