Naifyが重視する設計原則

処理の役割と呼び出し順を明確にし、変更時に確認しやすい構成を目指す。

標準的なPHPで構成する

Naifyは、クラス、関数、インターフェースなど標準的なPHPの仕組みを使う。独自の記法を抑え、PHPの知識で処理を追いやすくする。

処理の担当を決める

リクエストの受け取り、ルーティング、業務処理、レスポンスの生成をどこで行うかを決める。フレームワークとアプリケーションの担当を分け、共通処理を置く場所を揃える。

コアの役割を絞る

NaifyはWebアプリケーションの基本処理を担い、DBやテンプレートなどは別パッケージとして組み合わせる。必要な機能を選び、依存関係と変更の影響範囲を把握しやすくする。

規約を実装と照らし合わせる

どのフレームワークでも、規約が守られないまま変更を重ねると、保守上の問題が起こりうる。Naifyでも、役割分担をチームで共有し、レビューとテストで確認する必要がある。

AIが実装を補助する場合も、処理の配置と変更範囲を決め、人間が規約に沿っているかを確認する。

変更時に確認しやすい構成

  • 初期化と呼び出しを明示する
  • 役割ごとにクラスを分ける
  • 共通処理の入口を揃える
  • 例外的な処理は理由と確認方法を残す