公式：データの検証　外部キールール

外部キーを設定したカラムに、null を代入しようとしたこと。

してない。。。

公式：モデルのないフォーム

モデルとは関係なく、ユーザ入力を必要とする場合
Form オブジェクトを作成すると、モデルがある場合と同じように
フォームを利用できる。

公式：モデルのないフォーム　フォームの作成

• _buildSchema は FormHelper が HTML フォームを作成する際に使用する スキーマデータを定義するために使います。フィールドの型、長さ、および精度を定義できます。
• _buildValidator はバリデーターを加えることができる Cake\Validation\Validator のインスタンスを受け取ります。
• _execute では execute() が呼ばれ、データが有効な時に望むふるまいを定義します。

addField メソッドで、項目を定義。

protected function _buildSchema(Schema $schema)
{
    return $schema->addField('name', 'string')
        ->addField('email', ['type' => 'string'])
        ->addField('body', ['type' => 'text']);
}

_buildValidator メソッドで、バリデーションを定義。

protected function _buildValidator(Validator $validator)
{
    return $validator->add('name', 'length', [
            'rule' => ['minLength', 10],
            'message' => '名前は必須です'
        ])->add('email', 'format', [
            'rule' => 'email',
            'message' => '有効なメールアドレスが要求されます',
        ]);
}

下記のようにコントローラからバリデーションだけを利用することもできるみたい。

$contact = new ContactForm();
$isValid = $contact->validate($this->request->getData());

_execute メソッドに実行処理を定義する？

コントローラから下記のように利用。

$contact = new ContactForm();
$result = $contact->execute($this->request->getData();

公式：モデルのないフォーム　フォーム値の設定

$contact = new ContactForm();
if ($this->request->is('post')) {
    if ($contact->execute($this->request->getData())) {
        $this->Flash->success('すぐにご連絡いたします。');
    } else {
        $this->Flash->error('フォーム送信に問題がありました。');
    }
}

if ($this->request->is('get')) {
    // たとえばユーザーモデルの値
    $this->request->data('name', 'John Doe');
    $this->request->data('email','john.doe@example.com');
}

$this->set('contact', $contact);

GET のとき、つまり最初にそのページを訪れたときは、手動で値を設定し
POST のとき、つまりユーザ入力値がある場合は、フォーム値を基に処理を行っている。

公式：モデルのないフォーム　フォームエラーの取得

公式：モデルのないフォーム　コントローラーから各フォームフィールドを無効化
無効化は invalidate の訳で、ここでは「誤っていることを示す」の意味。

公式：データの保存

とあるエンティティを保存しようとしたら、保存できない。

object(MyPlugin\Model\Entity\MyEntity) {

	'hoge' => (int) 1,
	'[new]' => true,
	'[accessible]' => [
		'hoge' => true,
	],
	'[dirty]' => [
		'hoge' => true,
	],
	'[original]' => [],
	'[virtual]' => [],
	'[errors]' => [
		'hoge' => [
			'_required' => 'This field is required'
		]
	],
	'[invalid]' => [],
	'[repository]' => 'MyPlugin.MyEntity'

}

hoge に値が入っていて、dirty も true なのに
This field is required

エンティティを吐き出してみたらエラー内容がわかった。

if (! $this->save($entity)) {
    dd($entity);
}

hoge の値をコントローラ側で代入していた。

$entity->hoge = 1;

上記を取りやめ、フォーム側に hidden で持たせたら
無事に保存できた。

echo $this->Form->hidden('hoge', ['value' => 1]);

hideichi.com：[cakephp] saveできない時のチェックリスト（2015-04-01）
→時期的に CakePHP2 の可能性がある。

公式：データベースの基本　トランザクションを使う

CakePHP3 では、save 処理にトランザクション機能が含まれているので
トランザクションを利用する場合には、save メソッドのトランザクション機能を
明示的にオフにする必要があるとのこと。

//save()単位の原子性を無効に。
$result = $this->Tags->save($tagEntity,['atomic' => false]);

Qiita：CakePHP3でデータベースのトランザクションを使う　トランザクションを実装する（2017-08-29）

下記、どちらでもよいらしい。

use Cake\Datasource\ConnectionManager;
$connection = ConnectionManager::get('default');

'Datasources' => [
    'default' => [

他の設定を取ってきたければ、default の部分を変更。

$connectiopn = $this->Hoge->getConnection();

設定を変更していなければ、どの Table から取得しても OK。

use Cake\Core\Exception\Exception;
use Cake\Datasource\ConnectionManager;

$connection = ConnectionManager::get('default'); // コネクションを取得

$connection->begin(); // トランザクション開始

try {
    if ($this->Hoge->save($hoge)) {
        if ($this->Moge->save($moge)) {
            $connection->commit(); // コミット
        } else {
            throw new Exception();
        }
    } else {
        throw new Exception();
    }
} catch (Exception $exception) {
    $connection->rollback(); //ロールバック
}

Connection オブジェクト には、transactional メソッド が存在する。

1. begin を呼び出します。
2. 引数で渡されたクロージャーを実行します。
3. もしクロージャー内で例外が発生したら、ロールバックを発行して例外を再度 throw します。
4. クロージャーが false を返したら、ロールバックを発行して false を返します。
5. クロージャーが正常終了したら、トランザクションをコミットします。

公式：データベースの基本　トランザクションを使う

これは、データ保存の一連の処理を渡すことで、

1. 例外が発生したら、例外
2. 戻り値が false ならロールバックをする
3. それ以外ならコミット

というトランザクション処理のショートカット（？）メソッド。
未試行。

public function insert($hoge, $moge){
    // データ保存の一連の処理をクロージャへ定義
    $saveProcess = function() use($hoge, $moge) {
        if (! $this->Hoge->save($hoge)) {
            return false;
        }

        if (! $this->Moge->save($moge)) {
            return false;
        }

        return true;
    };

    $connectiopn = $this->Hoge->getConnection(); // コネクションを取得
    return $connectiopn->transactional($saveProcess);
}

上記例では、成功時に true を返しているけど
任意の値を返しても OK？

上記だと、それだけ完結するので
外から呼び出して、他のトランザクションに組み込む方法。
Qiita：CakePHP3でデータベースのトランザクションを使う　別のトランザクションに含められるように改良（2017-08-29）
未試行。

public function insert($hoge, $moge, $atomic = true){
    // データ保存の一連の処理をクロージャへ定義
    $saveProcess = function() use($hoge, $moge) {
        // 同上
    };

    $connectiopn = $this->Hoge->getConnection(); // コネクションを取得

    $result;
    //$atomic = true。つまり単独処理なら処理を行い
    if($atomic){
        $result = $connectiopn->transactional($saveProcess);
    //$atomic = false。つまり他の処理から呼ばれたら保存処理のみを返却
    } else {
        $result = $saveProcess();
    }

    return $result;
}

これはいいね！ 8-P
わかりやすく、使いやすそう。

公式：データベースの基本

下記2種ある。

• 生の SQL を書く
• クエリービルダーを利用する

コネクションを取得して、生の SQL をセットして、実行。

use Cake\Datasource\ConnectionManager;

$connection = ConnectionManager::get('default');
$results = $connection->execute('SELECT * FROM articles')->fetchAll('assoc');

プリペアドステートメントを利用する場合には
値を連想配列にして execute メソッドの第2引数として渡す。

$results = $connection
    ->execute('SELECT * FROM articles WHERE id = :id', ['id' => 1])
    ->fetchAll('assoc');

(?)疑問符プレースホルダ

$stmt = $conn->prepare(
    'SELECT * FROM articles WHERE published = ? AND created > ?'
);

// 複数項目のバインド
$stmt->bind(
    [true, new DateTime('2013-01-01')],
    ['boolean', 'date']
);

// １項目ずつのバインド
$stmt->bindValue(1, true, 'boolean');
$stmt->bindValue(2, new DateTime('2013-01-01'), 'date');

名前付きプレースホルダ

$stmt = $conn->prepare(
    'SELECT * FROM articles WHERE published = :published AND created > :created'
);

// 複数項目のバインド
$stmt->bind(
    ['published' => true, 'created' => new DateTime('2013-01-01')],
    ['published' => 'boolean', 'created' => 'date']
);

// １項目ずつのバインド
$stmt->bindValue('published', true, 'boolean');
$stmt->bindValue('created', new DateTime('2013-01-01'), 'date');

複合データ型（オブジェクト型）の場合は、
必ずデータ型も渡す必要があるのかしらね。。。
未試行。

$results = $connection
    ->execute(
        'SELECT * FROM articles WHERE created >= :created',
        ['created' => new DateTime('1 day ago')],
        ['created' => 'datetime']
    )
    ->fetchAll('assoc');

クエリービルダーを利用するとチェーンで記述可能。

$results = $connection
    ->newQuery()
    ->select('*')
    ->from('articles')
    ->where(['created >' => new DateTime('1 day ago'), ['created' => 'datetime']])
    ->order(['title' => 'DESC'])
    ->execute()
    ->fetchAll('assoc');

クエリービルダーを使用する場合は、 execute() メソッドを呼ぶまではサーバーに SQL は 送信されず、メソッド呼び出し後に順次処理されます。
最初に送信してから、順次結果セットを作成します。

公式：データベースの基本　クエリーの実行

後述の項目で検証。

• Query：SQL を生成しただけで、未発行
• CallbackStatement：SQL を発行済み
• ResultSet：SQL 発行により得た結果セット（レコードセット）

という理解で合っているのかしら。。。

use Cake\Datasource\ConnectionManager;

$connection = ConnectionManager::get('default');
$results = $connection->execute('SELECT * FROM articles')->fetchAll('assoc');

execute までで CallbackStatement を取得。

fetchAll(‘assoc’) で、結果セットを配列にて取得。

$results = $connection
    ->newQuery()
    ->select('*')
    ->from('articles')
    ->where(['created >' => new DateTime('1 day ago'), ['created' => 'datetime']])
    ->order(['title' => 'DESC'])
    ->execute()
    ->fetchAll('assoc');

->newQuery() で Query を取得。
->order([‘title’ => ‘DESC’])　まで全て Query の設定。

->execute() で CallbackStatement を取得。

fetchAll(‘assoc’) で、結果セットを配列にて取得。

find や get というマジックメソッドの場合は、
（用語の使い方が合っているか不明）
そこらに転がっている例を見る限り、少し異なる。

$results = $table // Table オブジェクト内では $this
    ->find()
    ->select('*')
    ->from('articles')
    ->where(['created >' => new DateTime('1 day ago'), ['created' => 'datetime']])
    ->order(['title' => 'DESC'])
    ->all();

->find() で、Query を取得できる。

find メソッドを追っかけていくと
Table オブジェクトの query メソッドにて、
Query オブジェクトを new している。

->order([‘title’ => ‘DESC’]) まで全て Query の設定。

->all() で、ResultSet オブジェクトを取得できる。

あれ？
CallbackStatement はどこへいったのかしらね？

all メソッドの中を覗くと

$results = $this->_decorateResults($this->_execute());

こういう1行があるので、中で処理を終えてしまっているみたい。

execute（find, get 可）しないと、SQL は発行されない。

ただ、Query オブジェクトを取得して、設定を終えておくと
Query オブジェクトを利用する際に、自動的に execute してくれる
と理解してよいのかしらね。

ん～。。。

不確かな情報ばかりで中身は薄いけど、
追っかけた内容を残しておくためのメモ。

公式：Flash
公式：フラッシュ

FlashComponent にてメッセージをセッションへ格納し
FlashHelper にて、セッションから取り出したメッセージをテンプレートへ出力する。

コントローラ内で、下記のように指定。

$this->Flash->set('This is a message');

テンプレート内で、下記のように指定。

echo $this->Flash->render();

と、公式に書いてあるけど、こんなことを書かなくても出力される。。。
なぜ～。

ちなみに、FlashComponent にてセッションキーを変更した場合は
下記のように独自キーを指定する。

echo $this->Flash->render('other');

テンプレートへ出力する際にはエレメントを利用する。

デフォルトのファイルは、下記3種。

※/vendor/cakephp/cakephp/src の方ではなく /app/src の方

$this->Flash->set('This is a message');
$this->Flash->success('This is a message');
$this->Flash->greatSuccess('This is a message');

上から順番に、下記エレメントを利用して出力される。

つまり、メソッド名とエレメント名が連動しており
その名称は独自につけることが可能。

公式：Flash　ルーティングのプレフィックスとフラッシュメッセージ
プレフィクスを利用している場合は、
下記を用意することで、プレフィクス別に設定可能。

こちらを配置して、中身を書き換えることでカスタマイズできそう。

公式：Flash　フラッシュメッセージとテーマ
FlashHelper では、テーマを設定できるみたい？

読んでもピンとはこないけど、
時間がある時に試そう。

protected $_defaultConfig = [
    'key' => 'flash',
    'element' => 'default',
    'params' => [],
    'clear' => false,
    'duplicate' => true
];

公式で「下記の通りです」と3種並べられている割には、
あちこち見ると増えていく。。。

// コントローラーの中で
$this->Flash->success('The user has been saved', [
    'key' => 'positive',
    'params' => [
        'name' => $user->name,
        'email' => $user->email
    ]
]);

公式：クッキー

バージョン 3.5.0 で撤廃: クッキーは、 ServerRequest で利用できます。
クッキー をご覧ください。
クッキーの暗号化は クッキー暗号化ミドルウェア をご覧ください。

公式：クッキー

とのことなので、CookieComponent はサヨナラ～。

ただし、
Qiita：CakePHP3.5でCookieComponentが非推奨になり、Cookieの読み書きに苦労した話（2018-03-28）
にも書いてある通り、
クッキーを利用する＝クッキー暗号化ミドルウェアを利用しなければならない
ではない。

3.4.x までの CookieComponent に代わって
3.5.x では、クッキーコレクション というのを利用する？

ん～よくわからないけど、あれこれ試した結果
今のところはクッキーコレクションを利用しなくてもクッキーを利用できた。

public function __construct(
    $name,
    $value = '',
    $expiresAt = null,
    $path = '',
    $domain = '',
    $secure = false,
    $httpOnly = false
)

$cookieValue = $this->request->getCookie('HOGE');

$cookie = new Cookie(
    'HOGE',                     // name（名前）
    'hogehoge',                 // value（値）
    new DateTime('+30 day'),	// expiresAt（期限）
    '/',                        // path（パス）
    'example.com',              // domain（ドメイン名）
    false,                      // secure
    true                        // httpOnly
);

$this->response = $this->response->withCookie($cookie);

$this->response = $this->response->withExpiredCookie('HOGE');

公式：データの削除

deleteAll メソッドに条件を渡す。

$this->deleteAll(['id' => 1]);

php からサーバコマンドを実行する方法。

公式：exec、system

php からサーバコマンドを実行するには
exec と system の２つの関数が用意されている。

二者の違いは、出力を返すか返さないかみたいだけど
引数指定次第でどちらも出力を返すみたいなので
結果的には、同じ働きなのかしらね～。

string exec ( string $command [, array &$output [, int &$return_var ]] )

第1引数：コマンド文字列
第2引数：出力格納用変数。省略可。省略すると出力を受け取れない
第3引数：コマンド実行結果ステータス格納用変数。省略可。省略するとステータスを受け取れない

string system ( string $command [, int &$return_var ] )

第1引数：コマンド文字列
第2引数：コマンド実行結果ステータス格納用変数。省略可。省略するとステータスを受け取れない

どちらもコマンド文字列に「 > /dev/null &」と付記してやることで、非同期に処理を実行できる。

注意:

プログラムがこの関数で始まる場合、 バックグラウンドで処理を続けさせるには、
プログラムの出力をファイルや別の出力ストリームにリダイレクトする必要があります。
そうしないと、プログラムが実行を終えるまで PHP はハングしてしまいます。

どうやら、上記付記内容は、出力をリダイレクトさせるものらしい。

SAMURAI：【PHP入門】外部コマンドの実行(exec)とコマンドライン実行の方法（2017-10-16）

公式：ロギング

'Log' => [
    'debug' => [
        'className' => 'Cake\Log\Engine\FileLog',
        'path' => LOGS,
        'file' => 'debug',
        'url' => env('LOG_DEBUG_URL', null),
        'scopes' => false,
        'levels' => ['notice', 'info', 'debug'],
    ],
    'error' => [
        'className' => 'Cake\Log\Engine\FileLog',
        'path' => LOGS,
        'file' => 'error',
        'url' => env('LOG_ERROR_URL', null),
        'scopes' => false,
        'levels' => ['warning', 'error', 'critical', 'alert', 'emergency'],
    ],
    // To enable this dedicated query log, you need set your datasource's log flag to true
    'queries' => [
        'className' => 'Cake\Log\Engine\FileLog',
        'path' => LOGS,
        'file' => 'queries',
        'url' => env('LOG_QUERIES_URL', null),
        'scopes' => ['queriesLog'],
    ],
],

公式：ロギング　レベルを使う

クラス内で、

$this->log($message, $level);

// 例
$this->log('オス！　おら悟空！', 'info');

とするだけ。

クラスならコントローラやモデルはもちろん
自作も含めて、どこでも使えるのかしら。。。

こちらを見ても、log メソッドは見つからない。
その代り、各レベル名のメソッドが揃っているので、どこかで変換しているんだろうね。