カテゴリー: blog

現在（絶賛）評価中のWordPress 6.5（Beta）を、いくつかの開発環境で試してみると、日本語で表示されないものがありました。Beta 1のころから3まで症状は解決しなかったので、昨日少し調べてみた。

前提としてその開発環境のロケールは’ja’となっている。これはサイトの言語設定、ユーザーの言語設定とも確認済み。

個別に__()などで翻訳テキストを取得しても、原文（英語）がそのまま返ってくる。

その開発環境のPHPバージョンは次の通り：

PHP 7.4.32 (cli) (built: Sep 28 2022 20:48:52) ( ZTS Visual C++ 2017 x86 )

そんなわけでmoファイルの読み込み部分をトレースしてみる。

「WordPress 6.5 Beta 1の紹介ページ」では直接触れられていないのだが、PHPの翻訳ファイルへの対応が含まれている。この対応にともなって翻訳処理が変更されており、wp-includesディレクトリにはl10nディレクトリが追加され、その中には5つのPHPファイルが存在する。その中の1つがclass-wp-translation-file-mo.phpである。

class-wp-translation-file-mo.phpでは、読み込んだmoファイルの先頭の4バイトを次のように定義されたクラス定数と比較し、moファイルが有効なファイルか評価している。

const MAGIC_MARKER = 0x950412de;

:

if ( self::MAGIC_MARKER === $big ) {
	return 'N';
}

このコード、何の問題もないように見えるのだが、32ビット版PHPの場合は落とし穴が潜んでいる。self::MAGIC_MARKERをダンプすると、期待していたint型ではなく、float型になっていたのだ。

float(2500072158)

このことにより、読み込んだmoファイルは不適切なものとなり、正常に読み込まれていなかった。そして結果的にサイトの表記は英語のままとなっていた。

class-wp-translation-file-mo.phpの問題部分を自分なりに修正し、問題の開発環境にて日本語で表示されることを確認。この問題についてtracに報告した。

今朝、PHPの整数についてドキュメントを見直す。そこには、確かにint型の範囲を超える数値はfloat型になる旨が書かれている。個人的な感覚として、0x950412deはそのまま（8バイトの）int型になってもよさそうなのだが、32ビット版PHPではそうならなかった。

何はともあれ、次かその次のBetaでは修正されることを期待したい。

昨日、久しぶりにMacBook Air（以降MacBook）を立ち上げる。OSのアップデート通知に従い「macOS Sonoma 14.3.1」をインストール。なんだかんだで約1時間、本来の目的である新しいプラグインの動作検証を行った。

このMacBook、Web開発環境を構築する前だったので、この機に少し進めることにした。

Visual Studio Codeから

「ターミナル」を開いて「Homebrew」をインストール。バージョンは4.2.10でした。

% brew -v
Homebrew 4.2.10

続いて「Visual Studio Code」をインストールする。

% brew install visual-studio-code
% code -v
1.86.2
903b1e9d8990623e3d7da1df3d33db3e42d80eda
arm64

「Launchpad」から「Visual Studio Code」をクリックし、起動確認。拡張機能の「Japanese Language Pack」も適用しておく。

あと「Git」も忘れずにインストールする。

% brew install git

% git -v
git version 2.44.0

昨年末にjoyokanji.infoサーバーのメンテナンスを実施し、PHP 8.1へバージョンアップしました。当日は軽くいくつかのページを閲覧しただけで済ませてしまい不具合の発見が遅れてしまった。

存在しないテーブルのクエリー

PHP（PHP-FPM）のエラーログには次の内容が出力される。

Table 'データベース名.テーブル名' doesn't exist

これま見たままのエラーで、以前はPHP Fatal errorではなかったのでしょう。対応としては、テーブルが存在する場合のみクエリーを実行するようにしました。

get_magic_quotes_gpc関数の呼び出し

エラーログの内容は次の通り。

Call to undefined function get_magic_quotes_gpc()

PHP 8.0.0で削除された関数を数か所で呼び出していました。対応としては、本関数が存在しない場合は呼び出さないように修正しました。

空のIN句を含んだクエリー

エラーログは以下の通り。

You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ') ORDER BY id'

該当のソースコードから次のようなIN句が原因でした。

IN () ORDER BY id

本来マッチした漢字のリストが入るもので、これをマッチした漢字がなくてもクエリーを実行していたことが原因でした。対応としてはマッチした漢字がない場合はクエリーを実行しないように修正しました。

mb_convert_encoding関数で’auto’を指定

エラーログに次の内容が複数回出力されていました。

mb_convert_encoding(): Unable to detect character encoding

これは文書として指定されたものを内部でUTF-8に変換する際、mb_convert_encoding関数を呼び出していたのですが、第3パラメータ$from_encodingに’auto’が含まれていたことが原因でした。暫定的な対応として$from_encodingの内容を見直し、’auto’を含めないように修正しました。

usort関数のコールバックで勘違い

エラーログは次の通り。

usort(): Returning bool from comparison function is deprecated, return an integer less than, equal to, or greater than zero

これはコールバックの戻り値を返すところで、次のように記述していたことが原因でした。

return $a->id > $b->id;

bool値が返ることが原因だったので、次のように修正しました。

return $a->id - $b->id;

まだ気になるところも残っているが…

この週末にエラーログを見ながらいくつか調整。フォームから入力された内容を検証処理を追加したり、文書のUTF-8変換処理を調整したりしました。mb_convert_encoding関数に指定する$from_encodingの最適解を知りたい。

画像ブロックですでにアップロード済みの画像を再利用する際、「メディアライブラリ」を開いてその中から選択するが、画像が多くなったら「日付」だけで絞り込むのはしんどい感じがしたので、カスタムタクソノミーを追加したいと思ったのが、先月くらい。Googleで検索してもそれっぽい内容を検索できず、ChatGPTで問い合わせしても意図した通りの挙動にはならず、ちょっと時間がかかってしまった。

ChatGPT（無料版）でやりとりしている中でちょっと意外だったのが、現時点で対応しているWordPressのバージョンは「5.8」ということ。5.9のリリースは2022年1月になるので、WordPressに関しては2021年以前の情報がベースになるらしい。分野によってどの程度違いがあるのか少し気になる。。。

さて本題も戻すと、「メディア」－「ライブラリ」で表示される内容は、リスト表示とグリッド表示の2種類があり、画像ブロックで表示される「メディアライブラリ」はグリッド表示とほぼ同じふるまいになっていた。拡張方法は、2つの表示内容でまったく異なっており、リスト表示はPHPだけで済むが、グリッド表示のほうはJavaScriptも用意する必要がある。

グリッド表示で今回使用したのが、admin_enqueue_scriptsアクションのほか、ajax_query_attachments_args、media_view_settings、media_view_stringsフィルターになる。media_view_settingsとmedia_view_stringsフィルターはwp_enqueue_media関数内で呼び出されるもので、JavaScript側ではwp.media.view.settingsとwp.media.view.l10nのプロパティからそれぞれのデータを参照できる。JavaScript側へデータを渡す汎用的な方法としてはwp_add_inline_script関数を使用すうこともできるが、メディアライブラリ用のJavaScriptであれば、media_view_settingsおよびmedia_view_stringsフィルターを使うほうがよいと判断した。

admin_enqueue_scriptsアクションのコールバック関数のポイントは、第1パラメータをチェックする際、投稿編集ページも含めること。post.phpだけでなく、post-new.phpも指定する。

if ( in_array( $hook_suffix, [ 'upload.php', 'post.php', 'post-new.php' ] ) ) {

ajax_query_attachments_argsフィルターのコールバック関数ではカスタムタクソノミー「グループ」を検索条件に追加する処理を行う。プルダウンメニューの選択が変わる度にこのフィルターは呼び出されており、$query[‘tax_query’]に検索条件を設定することになる。

今回予想以上に時間がかかってしまったが、想定通りに動いてくれればその苦労も報われた。既存ブロックのちょっとした拡張はなかなか面白い。