CakePHPでPreflight RequestでMissingControllerExceptionになる

Question

###前提・実現したいこと
CakePHPでREST APIを作り、AngularからHttp.getでデータを取得するプログラムを作っています

###発生している問題・エラーメッセージ
AuthorizationヘッダをくっつけてGETリクエストすると404 Not Foundになります

エラーメッセージ
2017-06-22 11:22:05 Error: [Cake\Routing\Exception\MissingControllerException] Controller class Users.json could not be found.
Exception Attributes: array (
  'class' => 'Users.json',
  'plugin' => false,
  'prefix' => false,
  '_ext' => false,
)
Request URL: /users.json
Referer URL: http://localhost:4200/account

###該当のソースコード
一部抜粋

// Routes.php
Router::scope('/', function ($routes) {
    $routes->extensions(['json']);
    $routes->resources('Users');
});

// AppController
class AppController extends Controller
{
    public function initialize()
    {
        parent::initialize();

        $this->loadComponent('RequestHandler');
        $this->loadComponent('Flash');

        // CORS
        $this->response->cors($this->request)
            ->allowOrigin(['*'])
            ->allowMethods(['GET', 'POST', 'OPTIONS'])
            ->allowHeaders(['X-CSRF-Token, Authorization'])
            ->allowCredentials()
            ->exposeHeaders(['Link'])
            ->maxAge(300)
            ->build();
    }
}

// UsersController
class UsersController extends AppController
{
    public function index()
    {
        $users = $this->paginate($this->Users);

        $this->set(compact('users'));
        $this->set('_serialize', 'users');
    }
}

	private getServerData(user: firebase.User) {
		user.getToken(true).then((token) => {
			let headers = new Headers({
				'Authorization': 'Bearer ' + token,
			});
			let options = new RequestOptions({
				headers: headers
			});
			this.http.get(
				'http://localhost:8765/users.json',
				options
			).subscribe((res) => {
				console.log(res);
			});
		});
	}

###試したこと
以下の例では200が返ってきて成功します
・Authorizationヘッダなし
・Chromeを--disable-web-securityで起動しCORSを無効化した状態でリクエスト
・当該URLをアドレスバーで直接叩く
・アドレスから.jsonを取り払ってリクエスト

404 Not Foundになるのは
・localhost:8765/users""".json"""に
・Authorization: Bearer hogehogeをつけて
・プリフライトリクエスト(OPTIONSメソッド)が送信される状態
でリクエストしたときになります

###補足情報(言語/FW/ツール等のバージョンなど)
Angular 4
CakePHP 3.4

Answer 1

resources()が対応するメソッドに、 OPTIONS が含まれていないかもしれません
https://book.cakephp.org/3.0/en/development/routing.html#creating-restful-routes

★リクエストが成功する時

1. /users.json というパターンに対応するRoutingを探す
2. routesで「GET users.json は users/index」として「UsersController::index」と解釈
3. 実行する

★リクエストが失敗する時

1. /users.json というパターンに対応するRoutingを探す
2. OPTIONSメソッドに対応する /users.jsonが 存在しない
3. fallbackとして「Cakeの元々の規則に沿ったRouting」を探す
4. /:controller/:action としての解釈なので、 第一階層 = users.json までを「コントローラー名」として解釈する
5. 結果、「対応するコントローラーがない」エラーになる

のかな・・？と思いました。
※たぶん、 routes.phpの中にて $routes->fallbacks()を読んでいますよね‥？

対応策としては、

1. Routingの設定 or Middleware layerで「OPTIONSでのリクエストを拾えるようにする」
2. 「OPTIONSでのリクエストの時に、結果を返せるようにする」

というものになるでしょうか。

今手元でコードを読んだり検証したりができていないので、↑の内容はもしかしたら齟齬がある・・かもしれないのですが、
こちらの回答などは「たぶん大丈夫そう？」と思ったので、よろしければお試しください。
https://stackoverflow.com/questions/39365229/cakephp-3-rest-api-cors-request-and-options-method

Comments

[HALBY]

回答ありがとうございます！
StackOverflowのその回答のコードは前に試してみたのですが、同じエラーを吐いてしまいます
beforeFilterにたどり着く前に例外を投げてしまうようです

[HALBY]

Stack Traceはこんな感じです
#0 ~(略)~/vendor/cakephp/cakephp/src/Http/ControllerFactory.php(65): Cake\Http\ControllerFactory->missingController(Object(Cake\Http\ServerRequest))
#1 ~(略)~/vendor/cakephp/cakephp/src/Http/ActionDispatcher.php(90): Cake\Http\ControllerFactory->create(Object(Cake\Http\ServerRequest), Object(Cake\Http\Response))
#2 ~(略)~/vendor/cakephp/cakephp/src/Http/BaseApplication.php(78): Cake\Http\ActionDispatcher->dispatch(Object(Cake\Http\ServerRequest), Object(Cake\Http\Response))
#3 ~(略)~/vendor/cakephp/cakephp/src/Http/Runner.php(65): Cake\Http\BaseApplication->__invoke(Object(Cake\Http\ServerRequest), Object(Cake\Http\Response), Object(Cake\Http\Runner))
#4 ~(略)~/vendor/cakephp/cakephp/src/Routing/Middleware/RoutingMiddleware.php(59): Cake\Http\Runner->__invoke(Object(Cake\Http\ServerRequest), Object(Cake\Http\Response))
#5 ~(略)~/vendor/cakephp/cakephp/src/Http/Runner.php(65): Cake\Routing\Middleware\RoutingMiddleware->__invoke(Object(Cake\Http\ServerRequest), Object(Cake\Http\Response), Object(Cake\Http\Runner))
#6 ~(略)~/vendor/cakephp/cakephp/src/Routing/Middleware/AssetMiddleware.php(93): Cake\Http\Runner->__invoke(Object(Cake\Http\ServerRequest), Object(Cake\Http\Response))
#7 ~(略)~/vendor/cakephp/cakephp/src/Http/Runner.php(65): Cake\Routing\Middleware\AssetMiddleware->__invoke(Object(Cake\Http\ServerRequest), Object(Cake\Http\Response), Object(Cake\Http\Runner))
#8 ~(略)~/vendor/cakephp/cakephp/src/Error/Middleware/ErrorHandlerMiddleware.php(92): Cake\Http\Runner->__invoke(Object(Cake\Http\ServerRequest), Object(Cake\Http\Response))
#9 ~(略)~/vendor/cakephp/cakephp/src/Http/Runner.php(65): Cake\Error\Middleware\ErrorHandlerMiddleware->__invoke(Object(Cake\Http\ServerRequest), Object(Cake\Http\Response), Object(Cake\Http\Runner))
#10 ~(略)~/vendor/cakephp/debug_kit/src/Middleware/DebugKitMiddleware.php(52): Cake\Http\Runner->__invoke(Object(Cake\Http\ServerRequest), Object(Cake\Http\Response))
#11 ~(略)~/vendor/cakephp/cakephp/src/Http/Runner.php(65): DebugKit\Middleware\DebugKitMiddleware->__invoke(Object(Cake\Http\ServerRequest), Object(Cake\Http\Response), Object(Cake\Http\Runner))
#12 ~(略)~/vendor/cakephp/cakephp/src/Http/Runner.php(51): Cake\Http\Runner->__invoke(Object(Cake\Http\ServerRequest), Object(Cake\Http\Response))
#13 ~(略)~/vendor/cakephp/cakephp/src/Http/Server.php(80): Cake\Http\Runner->run(Object(Cake\Http\MiddlewareQueue), Object(Cake\Http\ServerRequest), Object(Cake\Http\Response))
#14 ~(略)~/webroot/index.php(37): Cake\Http\Server->run()
#15 {main}

[o0h]

やはり、 `「OPTIONSでのリクエストを拾えるようにする」` の辺りの問題かと思いますね。
「OPTIONSで来た時に、対応するコントローラーが見つからない」ので
「コントローラーを起動できない」 = 「beforeFIlterより前に」になるかと思います。

### ざっくばらんにやるなら
1. OPTIONSリクエストを受け取れるようにする
```php
// routes.phpの修正
Router::scope('/', function ($routes) {
$routes->extensions(['json']);
$routes->resources('Users', [
'map' => [
'options' => ['action' => 'options', 'method' => 'OPTIONS', 'path' => ''],
]
]);
});
```
2. OPTIONSを捌けるようにメソッドを生やす
```php
// AppController
public function options()
{
if ($this->request->is('options')) {
return $this->response;
}
}
```

こうすることで、
1. `OPTIONS users.json`のリクエストも捌いて、コントローラーを起動できるようになり
2. 対応アクションとして `AppController::options()`が呼び出されるようになる

ので、件のエラーは解消するかと思います。
※ CORS用の出力については、こちらの内容も参照してみてください。
https://book.cakephp.org/3.0/ja/controllers/request-response.html#cors

### 丁寧目にやるなら
https://github.com/ozee31/cakephp-cors を利用します。
このプラグインの場合、「Middlewareレイヤーを利用する」という方法を採用しています
(Middlewareについては [コチラ](https://book.cakephp.org/3.0/ja/controllers/middleware.html)

---
ちなみに、私の関わっているPJでは「(自前で実装した)MiddlewareでCORSを捌く」方法を利用していて、処理も簡潔になるため、このやり方の方がオススメです^^

[HALBY]

このプラグインで一発で解決しました！ありがとうございます！