検索結果が0件になってしまう

Question

実現したいこと

WordPress（REST API + WP_Query）で商品一覧APIを自作しています。
プラグインは使わず、ACFのカスタムフィールドを含めた検索を実現したいのですが、
どうしても検索結果が 0件 になってしまい詰まっています。

REST API（/custom/v1/products）で以下の検索を実現したいです。

• フリーワード検索（検索窓1つ）
• 製品型番検索（ACF：model_number）
• 製品名検索（ACF：product_name）
• 製品カテゴリ検索（ACF：product_category）
• メーカー固定（ACF：manufacturer が「アマダ / AMADA」）

発生している問題・分からないこと

検索パラメータ keyword を指定すると 常に0件
keyword を外すと通常の一覧は取得できる
ACFの値自体は管理画面では正しく登録されている

エラーメッセージ

エラーメッセージは特にありません

該当のソースコード

$args = [
    'post_type'      => 'product',
    'post_status'    => 'publish',
    'posts_per_page' => 12,
    'paged'          => $page,
    'meta_query'     => [
        'relation' => 'OR',
        [
            'key'     => 'manufacturer',
            'value'   => 'アマダ',
            'compare' => 'LIKE',
        ],
        [
            'key'     => 'manufacturer',
            'value'   => 'AMADA',
            'compare' => 'LIKE',
        ],
    ],
];

$keyword = $request->get_param('keyword');
if ($keyword) {
    $args['meta_query'][] = [
        'relation' => 'OR',
        [
            'key'     => 'model_number',
            'value'   => $keyword,
            'compare' => 'LIKE',
        ],
        [
            'key'     => 'product_category',
            'value'   => $keyword,
            'compare' => 'LIKE',
        ],
        [
            'key'     => 'product_name',
            'value'   => $keyword,
            'compare' => 'LIKE',
        ],
    ];
}

試したこと・調べたこと

• teratailやGoogle等で検索した
• ソースコードを自分なりに変更した
• 知人に聞いた
• その他

上記の詳細・結果

ACFの複数フィールドを OR 条件で検索する場合、

• meta_query の relation の正しい組み方は？
• manufacturer 条件と keyword 条件を
• 「メーカーAND（型番OR製品名ORカテゴリ）」にしたい場合のベストプラクティス
• この構成で 0 件になる場合に疑うべきポイント（meta_key名、保存形式など）

補足

特になし

Answer 1

問題はmeta_queryのネスト構造にあります。現在の構造では、メーカー条件（アマダ/AMADA）と検索条件がOR関係になっています。これは「メーカーがアマダ または AMADA または 検索キーワードに一致する商品」という意味になります。

Answer 2

デバッグ文を埋め込んで、変数の中身を見て、どこまで意図通りに動いているかを確認するとよいです。
(他の2つの質問にも同じことが言えます。)

WordPressの場合、wp-config.phpでデフォルトが

define( 'WP_DEBUG', false );

これを

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

に書き換えます。

提示されているソースで言うと、21行目と22行目の間に

error_log(print_r($keyword, true));

22行目と23行目の間に

error_log(print_r('if文に入った', true));

40行目と41行目の間に

error_log(print_r($args, true));

を入れます。
この状態で実行すると、wp-content/debug.logにログ出力されます。
これで、$keywordに正しいキーワードが入っているか、if文に入ったかどうか、$argsが書き換わったかどうかが確認できます。