このページの2つのバージョン間の差分を表示します。
両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン 次のリビジョン 両方とも次のリビジョン | ||
apricot:core:top [2020/04/30 11:13] y2sunlight |
apricot:core:top [2020/05/07 11:56] y2sunlight [utilities.php] |
||
---|---|---|---|
行 9: | 行 9: | ||
* Apricot コア | * Apricot コア | ||
* Apricot コア作成の準備 | * Apricot コア作成の準備 | ||
- | * [[apricot: | + | * [[apricot: |
* [[apricot: | * [[apricot: | ||
* [[apricot: | * [[apricot: | ||
* [[apricot: | * [[apricot: | ||
+ | * [[apricot: | ||
* [[apricot: | * [[apricot: | ||
* [[apricot: | * [[apricot: | ||
- | ---- | + | \\ |
まずは、apricotのコアを作る為に以下を準備します。 | まずは、apricotのコアを作る為に以下を準備します。 | ||
行 23: | 行 24: | ||
* コアフォルダ、名前空間、オートローディングの設定 | * コアフォルダ、名前空間、オートローディングの設定 | ||
* コア構築のヘルパーとなるグローバル関数とベースクラス | * コア構築のヘルパーとなるグローバル関数とベースクラス | ||
- | \\ | + | |
+ | ---- | ||
===== 環境設定 ===== | ===== 環境設定 ===== | ||
行 56: | 行 58: | ||
\\ | \\ | ||
- | ===== コアフォルダ ===== | + | ===== フォルダの作成 |
+ | |||
+ | === coreフォルダ | ||
以下に示すようにプロジェクトフォルダ下に、コア用のフォルダ core を作成し、その下に4つのフォルダ(Derivations, | 以下に示すようにプロジェクトフォルダ下に、コア用のフォルダ core を作成し、その下に4つのフォルダ(Derivations, | ||
行 70: | 行 74: | ||
</ | </ | ||
- | > クラスを保存するフォルダはUpperCamelCaseそれ以外はsnake_caseを使用しています | + | * core フォルダは[[https:// |
+ | |||
+ | === configフォルダ === | ||
+ | |||
+ | 同様に、アプリケーション設定用のフォルダ config を作成し、その下に2つのフォルダ(setting, | ||
+ | |||
+ | < | ||
+ | apricot [プロジェクト] | ||
+ | | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | </ | ||
+ | |||
+ | === assetsフォルダ === | ||
+ | |||
+ | 同様に、リソース用のフォルダ assets を作成し、その下に3つのフォルダ(lang, | ||
+ | |||
+ | < | ||
+ | apricot [プロジェクト] | ||
+ | | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | </ | ||
+ | |||
+ | === var フォルダ === | ||
+ | |||
+ | 同様に、フォルダ var を作成し、その下に3つのフォルダ(cache, | ||
+ | |||
+ | < | ||
+ | apricot [プロジェクト] | ||
+ | | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | </ | ||
\\ | \\ | ||
行 150: | 行 195: | ||
グローバル関数を保存するためのPHPファイルを core\helper に作成します。目的別に2種類のPHPファイルがあります。 | グローバル関数を保存するためのPHPファイルを core\helper に作成します。目的別に2種類のPHPファイルがあります。 | ||
- | * utilities.php --- PHPの基本的な組み込み関数を拡張する目的 | ||
* boilerplates.php --- apricotでよく使用される定型文的なコードパターンを関数化したもの\\ ( apricotではボイラープレートと呼んでいる ) | * boilerplates.php --- apricotでよく使用される定型文的なコードパターンを関数化したもの\\ ( apricotではボイラープレートと呼んでいる ) | ||
+ | |||
+ | * utilities.php --- PHPの組み込み関数を拡張した関数群\\ ( apricot内部で使用することが主な目的 ) | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ==== boilerplates.php ==== | ||
+ | boilerplates.php へは関数を逐次追加します。現段階での内容は以下の通りです。 | ||
+ | |||
+ | ^関数^機能^ | ||
+ | |env($key, $default = null)|環境変数(.envファイル設定値)の取得| | ||
+ | |abort(int $code, string $message=null)|HTTP例外(400, | ||
+ | |||
+ | <code php boilerplates.php> | ||
+ | <?php | ||
+ | /** | ||
+ | * Get Environment Variable | ||
+ | * @param string $key | ||
+ | * @param mixed $default | ||
+ | * @return mixed environment Variable | ||
+ | */ | ||
+ | function env($key, $default = null) | ||
+ | { | ||
+ | $value = getenv($key); | ||
+ | if ($value === false) | ||
+ | { | ||
+ | return $default; | ||
+ | } | ||
+ | | ||
+ | switch (strtolower($value)) | ||
+ | { | ||
+ | case ' | ||
+ | case ' | ||
+ | case ' | ||
+ | case ' | ||
+ | } | ||
+ | return $value; | ||
+ | } | ||
+ | |||
+ | /** | ||
+ | * Abort | ||
+ | * @param int $code | ||
+ | * @param string $message | ||
+ | * @throws \Core\Exceptions\HttpException | ||
+ | */ | ||
+ | function abort(int $code, string $message=null) | ||
+ | { | ||
+ | throw new Core\Exceptions\HttpException($code, | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ==== utilities.php ==== | ||
+ | |||
+ | utilities.php にはapricot内部で使用する様々な関数が実装さいれています。ほとんどの場合、アプリケーションから使用することはないと思います。使用法などは以下のソースコードを参照して下さい。 | ||
{{fa> | {{fa> | ||
行 294: | 行 393: | ||
return (new \ReflectionClass($object))-> | return (new \ReflectionClass($object))-> | ||
} | } | ||
- | </ | ||
+ | /** | ||
+ | * Get SQL text from a file | ||
+ | * @param string $filename | ||
+ | * @return array | ||
+ | */ | ||
+ | function file_get_sql(string $filename): | ||
+ | { | ||
+ | if (!file_exists($filename)) return []; | ||
- | boilerplates.php へは関数を逐次追加します。現段階での内容は以下の通りです。 | + | // Read a file |
+ | $text = file_get_contents($filename); | ||
+ | $text = str_replace([" | ||
- | <code php boilerplates.php> | + | // Remove comment |
- | <?php | + | $text = preg_replace("/ |
+ | $text = preg_replace("/ | ||
- | /** | + | |
- | * Abort | + | $sql = preg_split("/ |
- | * @param int $code | + | |
- | * @param string $message | + | $item = trim($item); |
- | * @throws \Core\Exceptions\HttpException | + | }); |
- | */ | + | |
- | function abort(int $code, string | + | return !empty(trim($val)); |
- | { | + | }); |
- | | + | return $sql; |
} | } | ||
</ | </ |