 |
14 |
yii2によるスキャフォールディング (3) |
 |
続いて目玉アイコンをクリックした時のビューであるview.phpを修正します。実行結果は図550.1のとおりです。
以下にview.phpのDtailViewの修正法を示します。自動生成されたコードを見ると、
<?= DetailView::widget([
'model' => $model,
'attributes' => [
'id',
'title',
'pages',
'link',
'category_id',
],
]) ?>
同様に修正します。
<?= DetailView::widget([
'model' => $model,
'attributes' => [
'id',
'title',
'pages',
'link',
'category.name',
],
]) ?>
これを実行した結果を図550.2に示します。
|
11 |
yii2によるスキャフォールディング (2) |
|
index.php/?r=docsとしてドキュメント一覧表を表示します。表549.1に示すように、index.phpにより実行されます。
yii2も標準ではリレーション先まで見てくれないため、手修正を行います。前稿のように、views/docs/index.phpの修正法を示します。自動生成されたindex.phpを見ると、
<?= GridView::widget([
'dataProvider' => $dataProvider,
'filterModel' => $searchModel,
'columns' => [
['class' => 'yiigridSerialColumn'],
'id',
'title',
'pages',
'link',
'category_id',
これをyii2のGridViewのcolumnsにおいて、(リレーション名).(メンバ名)でリレーション先を表示できるとあるように修正します。
<?= GridView::widget([
'dataProvider' => $dataProvider,
'filterModel' => $searchModel,
'columns' => [
['class' => 'yiigridSerialColumn'],
'id',
'title',
'pages',
'link',
'category.name',
これを実行した結果を図549.2に示します。数字ではなく、カテゴリ名が表示されています。
タイトル行がNameですが、Categoryに変更したい場合は、’category.name:text:Category'のように修正します。
|
9 |
yii2によるスキャフォールディング |
|
次にyii2でも同様な作業を行います。yii2のインストール法はcomposerを用います。yii2決定版ガイドのyiiインストール法にあるとおり、以下のコマンドによりbasic applicationを作成します。アプリ名をここではdoctest21としました。同じく太字が入力部分です。
$ composer create-project --prefer-dist yiisoft/yii2-app-basic doctest21
yiiと同様に、適宜config/web.php及びconfig/db.phpを修正して、アプリURI/?r=giiを実行し、giiによりモデルとCRUDを生成します。
まず、giiを有効化します。修正するファイルは、config/web.phpです。
$config['bootstrap'][] = 'gii';
$config['modules']['gii'] = [
'class' => 'yiigiiModule',
// uncomment the following to add your IP if you are not connecting from localhost.
'allowedIPs' => ['127.0.0.1'],
];
次にconfig/db.phpを修正し、mysqlを使用することを宣言します。
return [
'class' => 'yiidbConnection',
'dsn' => 'mysql:host=localhost;dbname=test1',
'username' => 'root',
'password' => 'XXXXXXXX',
'charset' => 'utf8',
表548.1に画面、コントローラ中のアクション、ビューの対応表を示します。これに従い、それぞれのアクション及びビューを修正します。コントローラはcontrollers/DocsController.phpであり、docs関連ビューは全て、views/docs/の下にあります。
| アイコン | コントローラ内 メソッド(アクション) |
1次ビューファイル (黄色がアクションに対応) |
2次ビューファイル |
|---|---|---|---|
| 一覧表示 | actionIndex() | index.php | 無し |
 |
actionCreate() | create.php | _form.php |
 |
actionView() | view.php | 無し |
 |
actionUpdate() | update.php | _form.php |
|
8 |
yii-giiによるスキャフォールディングの修正法 |
|
元に戻って、標準のgiiにより生成されるコードの追加の修正法を示します。前稿までにCListViewの修正を示しましたが、ここではもう一つのCGridViewの修正を行います。
標準のgiiではテーブル表示にCListViewとCGridViewの2種類を選択するとができます。見かけが良いのはCGridViewで、図547.1のようにエクセルライクな表を作成してくれます。
views/docs/index.phpの修正法を示します。自動生成されたindex.phpを見ると、
<?php $this->widget('zii.widgets.grid.CGridView', array(
'id'=>'docs-grid',
'dataProvider'=>$model->search(),
'filter'=>$model,
'columns'=>array(
'id',
'title',
'pages',
'link',
'category_id',
array(
'class'=>'CButtonColumn',
),
),
)); ?>
のように変数ではなくラベルになっています。従って\$model->(リレーション名)->(メンバ名)のように手修正することができないと思っていました。ところがyii2のGridViewのcolumnsにおいて、(リレーション名).(メンバ名)でリレーション先を表示できるとあったため、yiiで実行してみたところ、正常に表示されることが分かりました。この機能はマニュアルに書かれてないようです。
<?php $this->widget('zii.widgets.grid.CGridView', array(
'id'=>'docs-grid',
'dataProvider'=>$model->search(),
'filter'=>$model,
'columns'=>array(
'id',
'title',
'pages',
'link',
'category.name',
array(
'class'=>'CButtonColumn',
),
),
)); ?>
これを実行した結果を図547.2に示します。
図547.1ではCategoryのタイトルで数字となっていたカラムが、Nameのタイトルでカテゴリ名に変化しています。ちなみにこのカラムタイトルは、"attribute:format:label"のようにラベルとして指定可能です。例えば元のままの"Category"としたければ、
'category.name:text:Category',
のように記述します。
yiiにおいてはgiixを使えばリレーションに関する手修正は必要ないため、ここまでとします。
|
7 |
yii-giixによるスキャフォールディング (2) |
|
新規に追加されたGiixModel GeneratorとGiixCrud Generatorのうち、まずモデルジェネレータでデータベーステーブルに対応するdocs及びcategoryの2つのモデルを作成します。モデル指定では'*'が可能であり、全てのモデルを一度に作成できます。
次に、CRUDジェネレータで今作成した2つのモデルを個々に指定し、それぞれに対してコントローラ及び関連ビューを作成します。
try it(/?r=docs)をクリックしdocsを表示します。
次にcreate docsをクリックすると、docsのレコード入力画面になりますが、標準のgiiではcategory_idは数値を入力しなければなりませんでした。ところが、giixでは、次のようにリレーション先のメンバのドロップダウンリストの選択画面を生成してくれます。
giixの秀逸なところは、これまでのように手修正することなしに、リレーションをたどってくれるところです。番号で入力することなく、別の配列のメンバを直接指定することができます。
また、別の表に分けないとcategory nameをひとつひとつテキスト入力する必要がありますが、分離してリレーションを張り、フォーリンキー制約を解釈できるgiixの機能により、ドロップダウンで選択するのみで良くなりました。giixを用いればCRUDの全てにおいて外部制約が自動的に解釈され、数字にはなりません。
リレーションに関してはgiixでは全く修正が不要です。
|
4 |
yii-giixによるスキャフォールディング |
|
標準では前稿のようにマニュアル修正が必要でした。これを自動で行うgiixという拡張があります。 yii extensionsからダウンロードし、以下のようにprotected/config/main.phpを設定します。
importにgiixを設定します。
'import'=>array(
:
'ext.giix.components.*', // giix components
:
),
次にmodulesのgiiのうち、generatorPathsをgiixを使用するように設定します。
'modules'=>array(
:
'gii'=>array(
'class'=>'system.gii.GiiModule',
'ipFilters'=>array('127.0.0.1'),
'generatorPaths' => array(
'ext.giix.generators', // giix generators
),
),
ブラウザでアプリケーションにアクセスし、/?r=giiとしてgiixを起動します(r=giixではない)。
新規にGiixModel GeneratorとGiixCrud Generatorが追加されています。
|
3 |
yii-giiによるスキャフォールディング |
|
ブラウザでアプリケーションにアクセスし、/?r=giiとしてgiiを起動します。パスワードを適宜入力します。IPアドレスが許可されていれば、図544.1の画面が現れます。様々なジェネレータが用意されています。
まず、モデルジェネレータでデータベーステーブルに対応するdocs及びcategoryの2つのモデルを作成します。
次に、CRUDジェネレータで今作成した2つのモデルを指定し、それぞれに対してコントローラ及び関連ビューを作成します。
try it(/?r=category)をクリックしcategoryを表示します。
docsテーブルの中のカテゴリ種別は別のテーブルcateogryのidを示しています。これをforeign keyとして以下のようにリレーションが張られています。protected/models/Docs.php(一部)は以下のようになっています。
public function relations()
{
return array(
'category' => array(self::BELONGS_TO, 'Category', 'category_id'),
);
}
Docモデル中のリレーションcategoryは、"Docs belong to a Category"と読みます。n対1の関係を示します。
protected/models/Category.php(一部)は以下のようになっています。
public function relations()
{
return array(<br />
'docs' => array(self::HAS_MANY, 'Docs', 'category_id'),
);
}
Categoryモデル中のリレーションdocsは、"A Category has many docs"と読みます。1対nの関係を示します。
データベース内容一覧を表示するためのviews/docs/_view.phpを見ると、自動生成後は
<b><?php echo CHtml::encode($data->getAttributeLabel('category_id')); ?>:</b>
<?php echo CHtml::encode($data->category_id); ?>
となっており、図544.3のようにcategory_idとして数字が表示されます。
<b><?php echo CHtml::encode($data->getAttributeLabel('category_id')); ?>:</b>
<?php echo CHtml::encode($data->category->name); ?>
これを表示すると図544.4のようにカテゴリ名で表示されます。
これがYiiの素晴らしい機能で、$data->(リレーション名)->(参照メンバ)のように、リレーションをあたかも構造体のように辿ることができます。自動的にリレーション先の表のメンバを参照可能です。
|
2 |
データベースの作成とyiiのスキャフォールディング準備 |
|
ER図作成ツールであるmysqlworkbenchをダウンロードし、インストールします。次にER図を作成します。これは前稿で設計した仕様を入力します。
まずyiiを用いて実行します。yiiのインストールは済んでいるものとします。次のとおりyiicにより、アプリケーションひな形ディレクトリを作成します。太字が入力する部分です。
\$ /var/www/html/yii/framework/yiic webapp doctest
Create a Web application under '/var/www/html/yii/demos/doctest'? (yes|no) [no]:yes
mkdir /var/www/html/yii/demos/doctest
mkdir /var/www/html/yii/demos/doctest/protected
:
mkdir /var/www/html/yii/demos/doctest/images
Your application has been created successfully under /var/www/html/yii/demos/doctest.
models, views, controllersを一時書き込み可能とします。Giiの自動生成による書き込みはウェブブラウザによるため、第3者が書き込めなければなりません。セキュリティ上問題があるため、完了後には書き込み不可にしておきます。
\$ chmod og+w protected/models protected/views protected/controllers
giiの設定をします。コメントを外し、パスワード設定、IPアドレス許可等の変更を行います。
\$ emacs protected/config/main.php
これによりprotected/config/main.phpを以下のように修正します。
'modules'=>array(
// uncomment the following to enable the Gii tool
'gii'=>array(
'class'=>'system.gii.GiiModule',
'password'=>false,
'ipFilters'=>array('127.0.0.1','::1'),
),
),
mysqlサーバの設定をします。コメントを外し、ユーザ名、mysqlパスワード設定等の変更を行います。
\$ emacs protected/config/database.php
これによりprotected/config/database.phpを以下のように修正します。
// This is the database connection configuration.
return array(
// uncomment the following lines to use a MySQL database
'connectionString' => 'mysql:host=localhost;dbname=test1',
'emulatePrepare' => true,
'username' => 'root',
'password' => 'XXXXXXXX',
'charset' => 'utf8',
);
|
1 |
yii/yii2/laravelによる表アプリの作成 |
|
ハードウェアの設計と並行してソフトウェアを設計します。まずは、PHPフレームワークであるyii/yii2と、laravelを取り上げます。これら3者を用いて同じテーマでアプリケーションを設計します。
対象となるアプリケーションは、弊社社内で使用している「資料一覧表」の作成とします。一覧表の作成は非常に汎用的であり、資料に限らず10以上のモノを管理しようとすると、一覧表は不可欠です。
docsとcategoryの2つの表で管理します。docsとその例を表542.1で示します。
| id | 題名(title) | ページ数(pages) | 保存場所(link) | 分類(category_id) |
|---|---|---|---|---|
| 1 | ISO 26262 第1版 Part 1 | 29 | ー | 1 |
| 2 | ISO 26262 第1版 Part 2 | 35 | ー | 1 |
| 3 | 平成26年度電子部品信頼性調査研究委員会報告 (FIDESの解説) | 125 | ー | 2 |
| 4 | 平成27年度電子部品信頼性調査研究委員会報告－改 (IEC/TR 62380, FIDES) | 192 | ー | 2 |
| 5 | Bluespec SystemVerilogリファレンスガイド | 453 | ー | 3 |
| 6 | BSVユーザガイド | 142 | ー | 3 |
| : | : | : | : | : |
次に分類(category)表とその例を表542.2で示します。
| id | 分類(category) |
|---|---|
| 1 | 車載機能安全規格 |
| 2 | 故障率データベース |
| 3 | 技術文書 |
| : | : |
categoryをdocsの表に埋め込めば一枚の表にすることは可能ですが、このように表を分離し、categoryをユニークにすることにより、n対1の関係となるので、修正が容易となるメリットがあります。
(参考情報)https://johobase.com/dividing-multiple-tables-merit/
ここに示されるように、資料表のレコードが100万件有り、分類に修正が入ると100万レコードの修正になるのに対し、表が分離されていると1つのレコードの修正で済みます。
このcategory_idカラムのように他の表のインデクスとなっているカラムをフォーリンキーと呼び、これでリレーションが張られていることになります。この「関係性」の機能を持つデータベースをリレーショナルデータベースと呼びます。
