MySQL、CakePHP 2.3で「tinyint(1)」の Boolean型の動作を再確認

2014/01/14 2018/03/21

MySQL、CakePHPで「tinyint(1)」のフィールドは Boolean型として認識

MySQLでの「tinyint(1)」のフィールドは Boolean型と認識するが．．．

　
MySQLの「tinyint(1)」の悲劇　Boolean型になるとは．．．
この記事に「結論が間違っています」コメントをいただきました。
　
そのために検証を行った結果、「tinyint(1)」のフィールドが「Boolean型」として処理されるのは MySQLの機能ではなく、CakePHPの機能によって起こっていることを確認しました。
　
※厳密な表現では、MySQLでは「tinyint(1)」で設定されたフィールドは Boolean型として処理する仕様となっているため、その定義に従って、CakePHPでは「0」「1」しか持てないように処理している、ということになるでしょう。
　
　MySQLの定義については以下参照
　http://dev.mysql.com/doc/refman/5.1/ja/numeric-type-overview.html
　
　
また、コメントでご指摘をいただいた通り、「tinyint(1)」を設定していても MySQLのテーブル上は -128～127まで保存されることを確認しました。
　
そして、「0」の場合は「False」、「0」以外の場合は「True」として扱うものと定義してあるようです。
　
　

Cakephpでの「tinyint(1)」のフィールドの扱い方

　
しかし、それを CakePHPで処理をするとちょっと違う結果になることを改めて確認しました。
　
　
具体的には、下記の様にテーブルを作成し、このテーブルをもとに CakePHPの bakeコマンドにて、Model、Controller、Viewを作成し、データの登録、一覧表示を行ってみました。
——————————————–

CREATE TABLE IF NOT EXISTS `testints` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `test1` tinyint(4) NOT NULL,
  `test2` smallint(6) NOT NULL,
  `test3` int(11) NOT NULL,
  `test4` bigint(20) NOT NULL,
  `created` datetime DEFAULT NULL,
  `modified` datetime DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB  DEFAULT CHARSET=utf8;

CREATE TABLE IF NOT EXISTS `testints` (

`id` int(11) NOT NULL AUTO_INCREMENT,

`test1` tinyint(4) NOT NULL,

`test2` smallint(6) NOT NULL,

`test3` int(11) NOT NULL,

`test4` bigint(20) NOT NULL,

`created` datetime DEFAULT NULL,

`modified` datetime DEFAULT NULL,

PRIMARY KEY (`id`)

) ENGINE=InnoDB DEFAULT CHARSET=utf8;

——————————————–
　
この状態でデータを登録すると、当たり前ですがデータは問題なく「-128」～「127」まで問題なく登録できました。
　
その次に、phpMyAdminなどで、test1の項目を「tinyint(1)」に変えてみたところ、大きな変化が現れました。
　
まず、一覧画面。
　
変更前

　
変更後

　
それまで -128、127などが編集されていた項目が「1」になり、0が編集されていた項目は nullに変わってしまいました。
　
また、入力画面では、通常のテキスト入力項目だったものが、チェックボックスの項目に変わってしまうという自動処理が行われていました。
　
変更前

　
変更後

　
　

PHPフレームワーク CakePHP 3入門

Cakephpで入力形式を変えてみた場合

　
これをもとのテキスト形式の入力に戻す場合は、「/app/View/Testints/add.ctp」の 6行目に下記の様に「, array ( ‘type’ => ‘text’ )」を追加することでテキスト形式の入力に戻すことは可能です。
　
———————–

echo $this->Form->input('test1', array ( 'type' => 'text' ) );

1	echo $this->Form->input('test1', array ( 'type' => 'text' ) );

———————–
　
ですが、テキスト形式で入力できるようにしたとして 0以外の数値が入力されてもデータベースには 1として保存されますので、実質 Boolean型としてしか使えませんので注意が必要です。
　
これが、前回の記事「MySQLの「tinyint(1)」の悲劇　Boolean型になるとは．．．」で陥っていたトラブルの原因でした。
　
そして、これは MySQLの Boolean型としての定義を、CakePHPの機能によって Boolean型としての処理として実装しているということが今回の実験で判明しました。
　
　

「tinyint(1)」以外の項目をチェック

　
さらに実験をしてみたところ、「tinyint(1)」以外の「「tinyint(2)」「tinyint(3)」では「tinyint(1)」のような変化はなく、「smallint(1)」「int(1)」も「tinyint(1)」のような変化はありませんでした。
　
ただ、「bigint」はさらなる衝撃な動作をしました。
なんと、「bigint(1)」のように設定すると、設定した数値の桁数分だけしか入力できなくなるのです。
　
例えば、
「bigint(1)」ならば、1桁しか入力できませんので「0～9」まで。
「bigint(2)」ならば、2桁しか入力できませんので「-9～99」まで。
といった感じ。
　
つまり、設定した数値の値に従って、入力エリアに自動的に「maxlength」が設定されるようです。（HTMLのソース上に maxlengthが設定してあるのを確認しました。）
　
ですが、これはあくまでも入力画面における処理であり、「tinyint(1)」の処理とは違うようで、下記の様に入力タイプを「text」と明示して設定すると、「maxlength」の制限はなくなり、通常通り「bigint(20)」と変わらない動きになりました。
また、入力画面上のみの処理のため、あらかじめ入力されていたデータは「tinyint(1)」の様に加工されることなくそのまま表示されていました。（入力画面でも入力されている値がそのまま表示されていました。）
———————–

echo $this->Form->input('test4', array ( 'type' => 'text' ) );

1	echo $this->Form->input('test4', array ( 'type' => 'text' ) );

———————–
　
　

「tinyint(1)」の MySQL、CakePHPでの動作のまとめ

　
今回は、tinyint、smallint、int、bigintの 4つの型での検証ですが、その他の項目でも同じような動きをする項目があるかもしれません。
もし、そんなことをご存知の方がいらっしゃいましたら、情報提供をしていただけますと幸いです。
　
　
ちなみに、当然ですが「tinyint(0)」は設定することができません。
　
　
tinyint()を始め、MySQLの数値型についての詳細は、下記に解説記事を書いていますので、あわせて参照してください。
MySQLの数値型（int、tinyint、bigint、decimal、number、float）の解説

- CakePHP 3.x 4.x 5.x, MySQL

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP4系でJSONレスポンスの処理ではwithStringBodyを使う。3との違い解説

responseの値を指定する方法は3系では「body」だが、4系では「withStringBody」になりる。加えてJSON形式なら「withType」で指定するなど4系では結構異なる処理がある。

: CakePHP4のcake cache clear_allでPermission deniedはパーミッションの変更が必要

CakePHP4でキャッシュをクリアするコマンドcake cache clear_allでPermission deniedのエラーが出るのはcakeにパーミッションが足りないとき。その対処方法を解説。

: CakePHP4のFrozenDateで1ヵ月前、先月、今月1日、来月末の日付などを算出する方法

CakePHPには「FrozenDate」の日付を扱う関数が用意されている。これを利用して、1ヶ月後、月末日、月初日、5日後などを指定して日付を取得できる。それを解説。

: CakePHP3ログファイルへの出力・$this->log()、独自ログへの出力方法の解説

コントロール、モデルの変数の中身を見るときはログに出力する方法が有効です。$this->log()を利用すると変数だけじゃなく、連想配列、オブジェクトも簡単にログ出力ができます。

: CakePHP4 のコマンドプログラムからコンポーネントを読み込む方法解説

CakePHP4でコマンドプログラムからコンポーネントを呼び出す方法を解説。コントローラーから呼び出すときと大差はないが、use句でコンポーネントを指定する事がポイント。

: CakePHP 2.3　デバッグキット（DebugKit）超初心者向けフォロー講座

CakePHP初心者に向けてデバッグキット（DebugKit）のインストール方法、はまりポイントを解説。

: CakePHP5でヘルパーから他のヘルパーを読み込む方法・CakePHP4からの変更点

CakePHP5のヘルパーで他のヘルパーを読み込む方法を解説。公式の日本語CookbookはCakePHP4のソースのままで間違っているため注意が必要。CakePHP4からの移行の際も同じ点に注意が必要。