AtomでPHPのコーディング規約に整形するツール php-cs-fixer を使えるようにしました。
brew install php-cs-fixer
次に、Atomにfixerのパッケージをインストールします。php-cs-fixer 専用のものもありますが、他のコードも書く場合は Atom-Beautify の方が便利かと思い、自分はAtom-Beautifyを使っています。
以上でインストール完了です。
PHPのファイルをAtomで開いて、 [Packages]>[Atom Beautify]>[Beautify]で、コーディング規約に沿ってインデントなどを調整してくれます。
データベースのテストを行うには、PHPUnitのエクステンションであるDBUnitを利用することができます。
PHPUnit マニュアル – 第8章 データベースのテスト
ComposerでDBUnitをインストールします。composer.jsonの"require-dev"に、以下を追加します。
"phpunit/dbunit": ">=1.2"
追加したら、 composer update してインストール環境を更新。
開発や本番など、データベースの接続条件を変更したい場合は、bootstrap.xmlを利用すると良いです。
詳しくは、PHPUnit マニュアル – 第8章 データベースのテストの「ヒント: 自前でのデータベーステストケースの抽象化」を参照。
Illuminate Databaseは、SQLで操作することができますが、Eloquent ORM(Objecte-Relational Model)というオブジェクト操作になぞらえた操作もできます。
Illuminate Databaseをインストールして、データの挿入、取り出しを行う例を示します。データベースエンジンはMySQLを利用しますが、Illuminate Databaseは、PostgresやSQL Serverなどにも対応しています。
composer require illuminate/database
事前に、利用するデータベースを作成しておきます。
mysql -u データベースを作成できるユーザー名 -p
CREATE DATABASE IF NOT EXISTS test_eloquentorm CHARACTER SET=utf8;
GRANT SELECT,DELETE,INSERT,UPDATE,CREATE ON test_eloquentorm.* TO 'eloquent_user'@'localhost';
Eloquent ORMを使って、以下を行うコードを示します。
<?php // 必要なクラスを自動的に読み込む require __DIR__ . '/vendor/autoload.php'; // 必要なクラスを宣言 use Illuminate\Database\Capsule\Manager as Capsule; use Illuminate\Database\Eloquent\Model as Eloquent; // 操作したいテーブルに対して、Eloquentクラスを継承したクラスを定義 // デフォルトでは、クラス名を小文字にして複数形にしたテーブル名を自動的に参照。以下の例ではusers class User extends Eloquent{}; // Illuminate Databaseを設定 $capsule = new Capsule; // データベースに接続 $capsule->addConnection([ 'driver' => 'mysql', 'host' => 'localhost', 'database' => 'test_eloquentorm', 'username' => '', // ユーザー名 'password' => '', // パスワード 'charset' => 'utf8', 'collation' => 'utf8_unicode_ci', 'prefix' => '' ]); // Illuminate DatabaseのインスタンスをCapsuleでアクセス可能にする $capsule->setAsGlobal(); // Eloquent ORMを起動 $capsule->bootEloquent(); // スキーマのインスタンスを取得 $schema = $capsule->schema(); // テーブル users がないかを確認 if (!$schema->hasTable('users')) { // なければテーブルの作成 // カラムの指定方法は http://readouble.com/laravel/5/0/dev/ja/schema.html $schema->create('users', function($table) { $table->increments('id'); $table->string('name', 100); $table->timestamps(); }); } // 名前 という名前で新規ユーザーを追加 $user = new User; $user->name = "名前"; $user->save(); // データを取り出す $lists = User::all(); foreach($lists as $user) { echo $user->name.":".$user->created_at."\n"; } ?>
以上です。各コードの説明は参照URLを参照してください。
例えば、事前に'custom_table'という名前でテーブルを作成していた場合は、以下のように、モデルクラスの$tableプロパティにテーブル名を設定します。
class User extends Eloquent {
protected $table = 'custom_table';
}
SlimPHPのテンプレートエンジンとして、Twigを利用する手順をまとめておきます。
掲載したコードは Templates - Slim Framework のものを、SlimPHPのSkeletonプロジェクトで動くように書き換えたものです。
composer create-project slim/slim-skeleton slim-twig-test cd slim-twig-test composer require slim/twig-view
composer update
テンプレート用のパスと、Twigのオプションを設定します。PHPの組み込みサーバーで動作しているかどうかで、デバッグと本番設定を切り替えられるようにします。本番用は cache を利用し、デバッグ用は debug フラグをtrueにして、更新を監視するようにします。
<?php return [ 'settings' => [ 'displayErrorDetails' => true, // set to false in production // Twig settings 'view' => [ 'template_path' => __DIR__ . '/../templates/', 'options' => [ 'cache' => __DIR__ . '/../cache/' ] ], // Monolog settings 'logger' => [ 'name' => 'slim-app', 'path' => __DIR__ . '/../logs/app.log', ], ], ];
<?php return [ 'settings' => [ 'displayErrorDetails' => true, // set to false in production // Twig settings 'view' => [ 'template_path' => __DIR__ . '/../templates/', 'options' => [ 'debug' => true ] ], // Monolog settings 'logger' => [ 'name' => 'slim-app', 'path' => __DIR__ . '/../logs/app.log', ], ], ];
<?php if (PHP_SAPI == 'cli-server') { // To help the built-in PHP dev server, check if the request was actually for // something which should probably be served as a static file $file = __DIR__ . $_SERVER['REQUEST_URI']; if (is_file($file)) { return false; } $settings = require __DIR__ . '/../src/settings-debug.php'; } else { $settings = require __DIR__ . '/../src/settings.php'; } require __DIR__ . '/../vendor/autoload.php'; session_start(); // Instantiate the app $app = new \Slim\App($settings); // Set up dependencies require __DIR__ . '/../src/dependencies.php'; // Register middleware require __DIR__ . '/../src/middleware.php'; // Register routes require __DIR__ . '/../src/routes.php'; // Run app $app->run();
SlimPHPのコンテナにTwigを追加します。
<?php // DIC configuration $container = $app->getContainer(); // view renderer $container['view'] = function ($c) { $settings = $c->get('settings')['view']; $view = new \Slim\Views\Twig( $settings['template_path'], $settings['options'] ); $view->addExtension(new \Slim\Views\TwigExtension( $c['router'], $c['request']->getUri() )); return $view; }; // monolog $container['logger'] = function ($c) { $settings = $c->get('settings')['logger']; $logger = new Monolog\Logger($settings['name']); $logger->pushProcessor(new Monolog\Processor\UidProcessor()); $logger->pushHandler(new Monolog\Handler\StreamHandler($settings['path'], Monolog\Logger::DEBUG)); return $logger; };
リクエストに応じた処理を呼び出すルートを設定します。今回は、 http://0.0.0.0:8080/hello を呼び出すと、与えられた配列のユーザー一覧を表示して、 http://0.0.0.0:8080/hello/ユーザー名 とすると、指定したユーザーのプロフィールを表示するようにします。
<?php // Routes // ユーザー一覧 $app->get('/hello', function($request, $response, $args) { // ユーザー一覧 $users = [ 'Tama', 'Kotta', 'Tanaka' ]; return $this->view->render($response, 'list.html', [ 'list' => $users ]); })->setName('list'); // 指定のユーザーのプロフィールを表示 $app->get('/hello/{name}', function ($request, $response, $args) { return $this->view->render($response, 'profile.html', [ 'name' => $args['name'] ]); })->setName('profile');
Twigのサンプルテンプレートを準備して、ルートに対応させます。
ユーザー一覧ページとプロフィールページのひな形となるレイアウト layout.html を作成します。
<!DOCTYPE html> <html lang="ja"> <head> <meta charset="UTF-8"> <title>SlimPHP Twig Test-{% block title %}{% endblock %}</title> </head> <body> <h1>{% block pagetitle %}{% endblock %}</h1> <div id='content'> {% block content %} {% endblock %} </div> <hr /> <div id='footer'> © Copyright 2016 by YuTanaka </div> </body> </html>
{% extends "layout.html" %}
{% block title %}User List{% endblock %}
{% block pagetitle %}User List{% endblock %}
{% block content %}
<ul>
{% for item in list %}
<li><a href="{{ path_for('profile', {'name': item}) }}">{{item}}</a></li>
{% endfor %}
</ul>
{% endblock %}
{% extends "layout.html" %}
{% block title %}Profile{% endblock %}
{% block pagetitle %}{{name}}'s Profile{% endblock %}
{% block content %}
<p>これは「{{name}}」のプロフィールです。</p>
<p><a href="{{ path_for('list') }}">一覧へ</a></p>
{% endblock %}
準備ができたら、PHPの組み込みサーバーを起動して、動作を確認します。
php -S 0.0.0.0:8080 -t public public/index.php
PHP用のテンプレートエンジンであるTwigについての自分向けの勉強メモです。
composerを推奨
Sentinelで認証しようとしたところ、以下のようなエラーが発生しました。
Fatal error: Call to undefined function Illuminate\Support\random_bytes() in /Users/user/project/vendor/illuminate/support/Str.php on line 233
原因を調べると、PHP5とPHP7の命令の違いのようです。それを解決するためのComposerパッケージをインストールすることで治りました。以下を、Composer.jsonの"require"に追加して、 composer update で直りました。
"paragonie/random_compat": "~1.1"
以上です。
