Skip to content

Latest commit

 

History

History
192 lines (124 loc) · 5.07 KB

README.md

File metadata and controls

192 lines (124 loc) · 5.07 KB

サンプルアプリケーション Tinitter

これは下記書籍向けサンプルアプリケーションのTinitterです。

Webアプリエンジニア養成読本 [しくみ、開発、環境構築・運用…全体像を最新知識で最初から! ](Software Design plus)

表紙画像

  • 掲示板プログラム
  • ニックネームとテキストを投稿できる
  • 投稿をページ送りで見る事ができる

単純なPHP製のウェブアプリケーションです。

書籍時点からの非互換なアップデート

masterブランチの対象PHPバージョンを7.3 に上げました。

php5系で動作をさせたい場合には、php5.6ブランチを参照ください。

正誤情報(2014/04/14更新)

上記書籍にて一部誤りがございました、以下正誤情報をご覧ください。

お詫びと訂正

お詫び申し上げます。

ダウンロード

(勿論Gitでcloneいただいても問題ありません)



以下は通常版についての解説になります。 通常版以外のREADMEは各ブランチ(上のリンクやプルダウンで選択)を変更してください。

構成要素

  • WAF: Slim Framework
  • Template Engine: Twig
  • ORM: Illuminate/Eloquent
  • Varidator: Respect/Validation
  • Test: phpunit, faker

確認動作環境

  • PHP 7.3以上
  • sqlite3 サポート
  • (DBセットアップのためにsqlite3のcli)

セットアップ

以下の実行でMac,Linux系ならばサンプル的なセットアップが完了します。

$ make dev-setup

以後は個別に実行する際の手順です。

composerでライブラリを取得

Composerインストール

# プロジェクトトップディレクトリで
$ php -r "eval('?>'.file_get_contents('https://getcomposer.org/installer'));"

Composerでライブラリのインストール

# プロジェクトトップディレクトリで
$ php composer.phar install

config を作成

# サンプルコンフィグファイルをコピーして作成する
$ cp config.php.sample config.php

SQLiteを使う場合には、内容を変更する必要はありません。 Mysqlを利用する場合には、後述の設定を行ってください。

.htaccess設定

Apacheの場合、以下の設定をおこなってください

$ cp htdocs/.htaccess.sample htdocs/.htaccess

DBセットアップ

SQLite利用時

# プロジェクトトップディレクトリで
$ sqlite3 sqlite.db < schema.sqlite3.sql

データを初期化したい場合、上記を再度実行してください。

Mysql利用時(オプショナル)

  • DB名:tinitter
  • ユーザー名:tinitter_user
  • パスワード:tinitter_pass の場合

以下を実行してDBにテーブルを登録

$ mysql -u tinitter_user -p tinitter < schema.mysql.sql
# プロンプトがでたら、パスワードを入力

config.phpを修正し、既存の$db_settings〜を以下のように書き換えます。

$db_settings = [
    'driver'    => 'mysql',
    'host'      => '127.0.0.1',
    'port'      => '3306',
    'database'  => 'tinitter',
    'username'  => 'tinitter_user',
    'password'  => 'tinitter_pass',
    'charset'   => 'utf8',
    'collation' => 'utf8_unicode_ci'
];

上記設定をしても、テストはSQLiteで動作します。詳しくはテストの項目を参照ください。

Builtin Serverでの起動

# プロジェクトディレクトリで
$ make strt
# あるいは
# プロジェクトの`htdocs/`ディレクトリで
$ php -S 127.0.0.1:8080

http://localhost:8080/にアクセス

他の実行環境での実行

プロジェクトのhtdocs/をDocumentRootに設定してください。

設定項目

デバッグモード切替

DEBUG定数をtrue/falseで切り換える。

# config.php
define('DEBUG', true);

true時は、例外時にSlimがスタックトレースを出力します。本番ではfalseにします。

自動テスト

$ make test

あるいは、test/README.mdを参照してください