Naifyが重視する設計原則
処理の役割と呼び出し順を明確にし、変更時に確認しやすい構成を目指す。
標準的なPHPで構成する
Naifyは、クラス、関数、インターフェースなど標準的なPHPの仕組みを使う。独自の記法を抑え、PHPの知識で処理を追いやすくする。
処理の担当を決める
リクエストの受け取り、ルーティング、業務処理、レスポンスの生成をどこで行うかを決める。フレームワークとアプリケーションの担当を分け、共通処理を置く場所を揃える。
コアの役割を絞る
NaifyはWebアプリケーションの基本処理を担い、DBやテンプレートなどは別パッケージとして組み合わせる。必要な機能を選び、依存関係と変更の影響範囲を把握しやすくする。
規約を実装と照らし合わせる
どのフレームワークでも、規約が守られないまま変更を重ねると、保守上の問題が起こりうる。Naifyでも、役割分担をチームで共有し、レビューとテストで確認する必要がある。
AIが実装を補助する場合も、処理の配置と変更範囲を決め、人間が規約に沿っているかを確認する。
変更時に確認しやすい構成
- 初期化と呼び出しを明示する
- 役割ごとにクラスを分ける
- 共通処理の入口を揃える
- 例外的な処理は理由と確認方法を残す