開発環境構築方法

設置

必要な環境

PHP 8 以上
MariaDB 10 以上、もしくは MySQL 8 以上

データベースの作成

MariaDBもしくはMySQLでデータベースを作成しておく。
一例として、以下で作成する。

データベース名: freo2
文字コード: utf8mb4

このデータベースには、以下の情報で接続できるものとする。

接続先: localhost
ユーザー名: username
パスワード: password

プログラムの取得

https://github.com/refirio/freo2 からプログラムを取得し、プログラムを実行できる場所に配置する。
（一例だが「Code → Download ZIP」からZIPファイルをダウンロードして展開する。）
ここでは、公開フォルダ直下に作成した「freo2」内に、index.php などのファイルを配置するものとする。

必要に応じて、files 内の各ディレクトリのパーミッションを 0777 に設定する。
（プログラムから読み書きできるようにする。XAMPP環境など、設定が不要な場合もある。）

プログラムの設定

config.default.php を複製して config.php を作成し、設定を行う。
まずは設置URLの設定を行う。今回は http://localhost/freo2/ に設置するものとする。

define('APP_HTTP_URL', 'https://example.com');
↓
define('APP_HTTP_URL', 'http://localhost/freo2/index.php');

直後に以下の設定を追加する。

define('APP_STORAGE_TYPE', 'file');
define('APP_STORAGE_URL', 'http://localhost/freo2');
define('APP_MAIL_SEND', false);
define('APP_MAIL_LOG', true);

さらにデータベースの設定を行う。
データベースの情報は「データベースの作成」で準備したものを使用する。

define('DATABASE_HOST', '');
define('DATABASE_PORT', '');
define('DATABASE_USERNAME', '');
define('DATABASE_PASSWORD', '');
define('DATABASE_NAME', '');
↓
define('DATABASE_HOST', 'localhost');
define('DATABASE_PORT', '');
define('DATABASE_USERNAME', 'username');
define('DATABASE_PASSWORD', 'password');
define('DATABASE_NAME', 'freo2');

index.php と同じ階層に mail フォルダを作成しておきます。
システムからメールを送信した場合、実際に送信する代わりに、
このフォルダ内に送信内容が記録されたテキストファイルが作成されます。

セットアップ

以下にアクセスし、「levis: PHP Framework」という画面が表示されることを確認する。

http://localhost/freo2/index.php/?_mode=info_levis

「Menu」の「migrate」リンクをクリックし、ページ下部の「status」がすべて「success」になっていることを確認する。

初期設定

以下にアクセスし、トップページが表示されることを確認する。

http://localhost/freo2/index.php/

メニューの「ログイン」リンクをクリックし、認証画面が表示されることを確認する。
以下の情報でログインし、ダッシュボードが表示されることを確認する。

ユーザー名: admin
パスワード: abcd1234

画面右上の「管理者さん」から「ユーザー情報編集」をクリックし、必要に応じて各種情報を更新する。
登録完了すると、ダッシュボード画面に戻ってくる。
画面左のメニューから「設定」をクリックする。さらに「基本設定」をクリックし、必要に応じて各種情報を更新する。

テスト

テストについて

単体テストとブラウザテストがある。
どちらもデータベースを読み書きするため、テスト用にデータベースを作成しておくことを推奨する。
一例として、以下で作成する。

データベース名: freo2-test
照合順序: utf8mb4_general_ci

テスト実行時、config.php でテスト用データベースを参照させる。

define('DATABASE_NAME', 'freo2');
↓
define('DATABASE_NAME', 'freo2-test');

単体テストの実行

以下にアクセスしてテストを実行する。

http://localhost/freo2/index.php/?_mode=test_index

ブラウザテストの実行

以下にアクセスしてテストを実行する。

http://localhost/freo2/index.php/tool/test

フレームワーク

levis: PHP Framework
https://refirio.org/levis/