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. テストとバックアップ: 重要なファイルや設定の変更前には必ずバックアップを取り、その後でテストを行います。

関連記事:

お気軽にご相談ください

お見積りへ お問い合わせへ