教義のバイナリを使用したケースに敏感なクエリ：DQL関数拡張ガイド

Doctrine ormおよびQuery Builderにケースに敏感なクエリにMySQLバイナリキーワードを実装します。 Doctrineはデフォルトですべてのデータベースネイティブ関数を直接サポートしていないため、Beberlei/DoctrineExtensionsライブラリをインストールし、カスタムDQL関数を登録して、DQLステートメントで正確なマッチングにバイナリを使用し、そのアプリケーションと予防策を議論することにより、この問題を解決します。

教義とネイティブSQL関数との互換性を理解します

データベース操作にDoctrine ORMを使用する場合、開発者は通常、クエリビルダーまたはDQL（Doctrine Query Language）を使用する傾向があります。ただし、MySQLのバイナリキーワードなどの特定のデータベース関数は、DQLの標準カテゴリに分類されることはありません。 r.name = binary：where句のクエリビルダーの条項に直接名前を付けると、教義がこのバイナリ関数を解析できないため、エラーが発生します。

これは、DQLがSQL関数の一般的なセットのみをサポートするデータベース抽象化言語として設計されているためです。特定のデータベース（MySQLなど）の非標準関数の場合、「カスタムDQL関数」メカニズムを介してDoctrine ORMを拡張する必要があります。

解決策：DoctrineExtensionsライブラリを紹介します

DoctrineのバイナリなどのMySQL固有の機能をシームレスに使用するために、最も推奨され便利な方法は、Beberlei/DoctrineExtensionsライブラリを使用することです。このライブラリは、DQL拡張機能として多数の一般的に使用されるデータベース関数を提供し、Doctrineの柔軟性を大幅に向上させます。

1. DoctrineExtensionsをインストールします

まず、Beberlei/DoctrineExtensionsライブラリを作曲家を介してプロジェクトに追加します。

作曲家には、Beberlei/DoctrineExtensionsが必要です

2。バイナリ関数を登録するようにDoctrineを構成します

インストールが完了すると、バイナリ関数をDoctrine構成に登録して、認識可能なDQL関数にする必要があります。これは通常、Symfonyプロジェクトのconfig/packages/doctrine.yamlファイルで行われるか、他のPHPプロジェクトのDoctrine ORMを通じて直接構成されています。

Symfony構成例：

 ＃config/packages/doctrine.yaml

教義：
    Orm：
        ＃...その他のORM構成DQL：
            string_functions：
                バイナリ：doctrineextensions \ query \ mysql \ binary

この構成は、DQLにバイナリ関数が表示される場合、DoctrineExtensions \ Query \ mySql \ binaryクラスを使用して処理する必要があることを教義に伝えています。 string_functionsは、これが文字列を処理する関数であることを意味します。

3. DQLまたはクエリビルダーでバイナリを使用します

上記の構成を完了した後、DQLクエリまたはクエリビルダーでバイナリキーワードを使用して、ケースに敏感な比較を使用できます。

クエリビルダーの使用例：

  entityManager = $ entityManager;
    }

    /**
     *名前に基づくケースに敏感なクエリ*
     * @param string $ name to query * @return array
     */
    public function findRecordScaseSensitive（String $ name）：array
    {
        $ repo = $ this-> entitymanager-> getRepository（record :: class）;

        $ repo-> createquerybuilder（ 'r'）を返します
             - > select（ 'r.id'、 'r.name'）//その他のフィールドを選択できます - > where（ 'binary（r.name）=：name'）//注：dqlでは、バイナリは通常、バイナリ（列）などの関数として使用されます
             - > setParameter（ 'name'、$ name）
             - > getQuery（）
             - > getResult（）;
    }
}

重要なヒント： DQLでは、バイナリは通常、ネイティブSQLのような列名の直前に配置されるのではなく、機能、つまりバイナリ（式）として使用されます。列=バイナリ「テキスト」は一部のMySQLネイティブクエリで有効ですが、DQL関数の構文習慣に沿った関数バイナリ（列）と見なされます。 DoctrineExtensionsのバイナリクラスも登録および機能形式で解析されます。

さらに探求：DoctrineExtensionsによって提供されるその他の機能

Beberlei/DoctrineExtensionsはバイナリ関数を提供するだけでなく、日付、時刻、数値、文字列処理などの複数の側面をカバーする多数の他の実用的なMySQL（およびPostgreSQL、sqliteなど）関数拡張も含まれます。例えば：

• 日付関数： date_format、datediff、from_unixtimeなど。
• 数値関数： ACO、天井、床、円形など。
• 文字列関数： concat_ws、group_concat、md5、置換、regexpなど。

DoctrineExtensionsの公式ドキュメントまたはgithubリポジトリのconfig/mysql.ymlファイルに相談することにより、登録および使用できる機能をさらに見つけることができます。

メモとベストプラクティス

1. データベースの互換性：バイナリキーワードはMySQLに固有のものです。プロジェクトが複数のデータベース（MySQLやPostgreSQLなど）をサポートする必要がある場合、バイナリを使用するとDQLの移植性が低下する場合があります。この場合、キャラクターセットの調整やデータベース列の照合、またはアプリケーションレベルでのケースセンシティブなど、データベース全体で他のケースに敏感なメソッドを考慮することをお勧めします（ただし、これは通常効率が低くなります）。
2. パフォーマンスへの影響： Where句でバイナリ（R.Name）などの関数を使用すると、R.Name列に作成されたインデックスを使用してデータベースが使用され、完全なテーブルスキャンとクエリパフォーマンスに影響を与えます。ケースに敏感なクエリがコア要件であり、データボリュームが大きい場合、次の選択肢が推奨されます。
   • 列の並べ替えを変更します。名前列の並べ替えをケースに敏感に設定します（たとえば、UTF8MB4_BINまたはUTF8MB4_0900_AS_CSなど）。このようにして、デフォルト=比較はケースに敏感になり、インデックスはバイナリ関数を使用せずに正常に機能します。
   • ケースに敏感なインデックスの追加：列のデフォルトの照合を変更しない場合は、バイナリ（名前）の関数インデックスの作成を検討してください（データベースバージョンがサポートしている場合）。
3. DQL関数の命名： doctrine.yamlに登録されている関数名（たとえば、バイナリ）はDQLで使用する名前になります。この名前が明確であり、DQLビルトイン関数と矛盾しないことを確認してください。

要約します

Beberlei/DoctrineExtensionsライブラリを通じて、Doctrine ORMのDQL機能が大幅に強化されており、開発者はORMの抽象化の利点を維持しながら、データベースに固有の強力な機能を利用できるようになりました。 Doctrine Query Builderでケースに敏感なクエリが必要なシナリオの場合、バイナリDQL関数を登録すると、簡潔で効果的なソリューションが提供されます。ただし、このような特定のデータベース関数を実装する場合、データベースの互換性とクエリパフォーマンスに対する潜在的な影響を考慮し、特定のニーズに基づいて最も適切な戦略を選択することが重要です。

以上が教義のバイナリを使用したケースに敏感なクエリ：DQL関数拡張ガイドの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。