英語版stackoverflowに、Doctrine2でMySQLのField関数をつかったORDER BYについて質問/回答がありました。

- [Doctrine 2 mysql FIELD function in order by][1]

上記ページのpolianychさんの回答と、それにつけられたMr Hashさんのコメントを合わせて、設定等補足すると以下のようになります。


## Field関数を使えるようエクステンションを有効にする

- https://github.com/beberlei/DoctrineExtensions
- packagist では [beberlei/DoctrineExtensions][2]

beberlei/DoctrineExtensionsはstableリリースがないので、インストールする場合は次のようにdev-masterを指定します。

    $ composer require beberlei/DoctrineExtensions:dev-master


## カスタム関数を登録する

Doctrineを直接使っている場合は、

    $doctrineConfig = $this->em->getConfiguration();
    $doctrineConfig->addCustomStringFunction('FIELD', 'DoctrineExtensions\Query\Mysql\Field');

とします([Doctrineのマニュアル](http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/cookbook/dql-user-defined-functions.html))。


Symfonyを使っている場合は、コンフィギュレーションファイルで

    doctrine:
        orm:
            # ...
            dql:
                string_functions:
                    FIELD: DoctrineExtensions\Query\Mysql\Field

と記述すれば利用できます([Symfonyのマニュアル](http://symfony.com/doc/current/cookbook/doctrine/custom_dql_functions.html))。


## QueryBuilder内の記述

    $qb
        ->select("r, field(r.id, :ids) as HIDDEN field")
        ->from("Entities\Round", "r")
        ->where("r.id IN :ids")
        ->setParameter('ids', $ids)
        ->orderBy("field");


  [1]: https://stackoverflow.com/questions/5957330/doctrine-2-mysql-field-function-in-order-by
  [2]: https://packagist.org/packages/beberlei/DoctrineExtensions