NoName Frameworkまたは自転車の発明方法

こんにちは、habrauser！

今日、私はあなたの裁判所に一定量のバイドロコッドを提出したいと思います。これを誇らしげに「私の枠組み」と呼びます。 カットの下には、四角い車輪を備えた多数の自転車、コードに関するばかげたコメント、かなりかなりの量の完全に意味のないテキスト、および他の多くの同様の恐怖が表示されます。 これが怖くない人-[もっと読む]ボタンをクリックしてください。

現時点では、フレームワークにいくつかの変更が加えられているため、この記事のすべての例が機能するわけではなく、フレームワークの構造はわずかに異なります。

簡単な紹介

現時点では、モスクワ近郊の大学で3年生で、コンピューターソフトウェアと自動化システムの学位を取得しています。 3年目の2学期に、彼らは「今、準備ができました」のようなことを私たちに話しました。そして、新しいテーマ、コンピューターネットワークソフトウェア、または言い換えれば、HTMLを学び始めました。 少し前に、クラスメートの1人がHTML、CSS、およびPHPの学習を開始し、これである程度の成功を収めました。彼はオンラインストアを作りました。 どういうわけか私は彼にソースコードを見せてくれるように頼みましたが、特に驚いたことはありませんでした。

これを見て、私は黙っておくことができず、MVC、ベース、そしてすべてのジャズについて何かをこすり始めました。 当然、彼は私の言葉からほとんど何も理解していませんでした（ご覧のとおり、私はあまりよく説明していません）。 しかし、文字通り数週間後、上記のテーマが明らかになりました。 先生は私たちと以前にそれを行いましたが、問題なく私たちは彼と同級生を自分で扱うことに同意しました。 その結果、特定の数のペアについて、サイトは自分の手でゼロから書き直され、クラスメートは新しいサイトに加えて印象的な知識を受け取りました（役に立つと思います）。

私はソースコードを捨て（私たちは彼のラップトップで作業しました）、自宅でいろいろと調べ、機能を追加し、リファクタリングし、何かを作り直しました。 その結果、いくつかのプロジェクトが非常にうまく機能する一種のフレームワークを得ました。 今、私は自分の作品を人々に公開することを決めたので、彼は私にウェブプログラミングを投げかけるか、または私の考えをさらに発展させることを決めました。 そして、あなたは決して知らない、突然誰かが役に立つ。

フレームワーク機能

1. 軽量。 まあ、非常に小さい。 開梱すると、約34キロバイトかかります（標準のウェルカムテキストとロゴ画像を削除した場合）
2. OOPの欠如。 これが利点であるか、その逆であるかはわかりませんが、理論的にはOOPアプリケーションは手続き型スタイルで記述されたアプリケーションよりもはるかに多くのリソースを消費します。 （これが最初に実証された人がまだ基礎を完全に理解していなかった場合、オブジェクトについてどのようなスピーチがあり得るか）
3. MVC。 さて、ここでは何も説明する必要はないと思います。
4. ルーティング。 （私の意見では）ルーティングは非常に使いやすいですが、同時に設定が非常に柔軟ですが、改良が必要です。 デフォルトのルーティングは「Controller / Action / Param-1 / Value-1 / Param-2 / Value-2」です。
5. JSONおよびXML。 これらの形式のいずれかで回答を得るには、それぞれアドレス「.json」または「.xml」を追加する必要があります。 つまり、アドレス "/ goods / view / id / 3"で製品に関する情報を受け取った場合、アドレス "/goods/view/id/3.json"でJSON形式で取得できます。
6. 機能。 コミュニティは1人だけなので、すぐに使用できる機能はあまりありません。 これまでのところ、SOAPディスパッチスクリプトが不十分であり、セッションを使用したユーザー認証が非常に機能しています。
7. バックトレース。 プレゼント。 アプリケーションがデバッグモードでない場合は切断されます。
8. DB。 MySQLのみがサポートされています。 これはマイナスですが、現時点では重要ではありません。
9. ORM。 OOPは原則としてフレームワークに存在しないため、ここにはありません。 ただし、データベースには何らかのバインドがあります。
10. ACL。 現時点では利用できませんが、フレームワークの開発計画（少なくともいくつかの肯定的なレビューを受けた場合にのみ開発されます）はそもそもです。
11. デバッグモード。 存在し、いくつかのエラーの出力、バックトラックの出力、使用された設定に影響します。

フレームワーク構造

スキーム

 |  -アプリ/
     |  -構成/
         |  -デバッグ/
             |  -* .php
         |  -* .php
     |  -コントローラー/
         |  -* /
             |  -* Action.php
     |  -モデル/
         |  -* .php
     |  -ビュー/
         |  -カスタム/
             |  -* .phtml
         |  -レイアウト/
             |  -default.phtml
         |  -スクリプト/
             |  -* /
                 |  -* .phtml
 |  -ライブラリ/
     |  -機能/
         |  -default.php
         |  -* .php
     |  -初期化/
         |  -configs.php
         |  -init.php
         |  -predispatch.php
     |  -モデル/
         |  -basemodel.php
     |  -ルーター/
         |  -router.php
     |  -include.php
 |  -ファイル/
     |  -*
 |  -index.php
 |  -.htaccess

すべてを順番に検討しましょう

一番下、つまり.htaccessファイルから始めましょう。 その内容は次のとおりです。

RewriteEngine on RewriteCond %{REQUEST_URI} !/files RewriteRule .*$ index.php [L] AddDefaultCharset UTF-8 

つまり、「/ files」で始まる以外のリクエストは、index.phpにリダイレクトされます。 実際、これが唯一の最良の書き換えオプションとはほど遠いものではありませんが、私はすでにそれを使用することに慣れており、まだ変更しないことに決めました。 さて、デフォルトのエンコーディング：UTF-8。 ここではこれ以上興味深いものは見当たりません。

index.phpに移りましょう。 その内容は次のとおりです。

 //     (     ) define('APP_DEBUG', TRUE); //    define('APP_PATH', dirname(__FILE__) . DIRECTORY_SEPARATOR . 'app' . DIRECTORY_SEPARATOR); define('LIBRARY_PATH', dirname(__FILE__) . DIRECTORY_SEPARATOR . 'library' . DIRECTORY_SEPARATOR); //   ,     require_once(LIBRARY_PATH . 'include.php'); //   startAction(); //   loadLayout($_response['layout']); 

ここでは、すべてのアクションがコメントされているため、何も説明する必要はないと思います。

フォルダーファイル 。 覚えているかもしれませんが、このフォルダーのみが直接アクセスできます。つまり、 index.phpをバイパスします。 したがって、スタイルシート、JavaScriptファイル、画像などのリソースがその中に形成されます。

次に、 アプリフォルダーについて考えます。 名前が示すように、これはアプリケーション自体のフォルダーです。 これには、アプリケーション構成（ configフォルダー）、コントローラー（ controllersフォルダー）およびこれらのコントローラーのアクション、モデル（ modelsフォルダー）およびビュー（ viewsフォルダー）が含まれています。

コントローラーは、PHPファイルを含むフォルダーです-アクション。 フォルダ名はcamelCaseである必要があります。 アクションファイルの名前もcamelCaseにある必要がありますが、末尾に「Action」という接尾辞があります。
つまり、ファイルシステム内の名前「goods」とアクション「index」 、 「show」 、 「new」 、 「edit」 、および「delete」を持つコントローラーは次のようになります。

 |  -コントローラー/
   |  -商品/
     |  -indexAction.php
     |  -showAction.php
     |  -newAction.php
     |  -editAction.php
     |  -deleteAction.php

オプションで、任意のコントローラーに_init.phpファイルを含めることができます。 このファイルの内容は、このコントローラーでアクションを実行する前に実行されます。

次に、モデル（フォルダー「models」 ）について説明します。 私の理解では、モデルはコントローラーでさらに処理する必要のない、すぐに使用できるデータを返す必要があります。 つまり、たとえば、ブロック5で最新のニュースを表示する必要があります。 コントローラから直接リクエストを行うことができますが、私の理解では、コードを次の形式に減らす方がより正確です。

 loadModel('news'); $_view['last_news'] = getLastNews(5); 

ここでは、 「news」モデルでgetLastNews()メソッドが宣言され、単純にフォーマットされてビューに表示されるままになっているデータの配列を返します。
モデル自体は、単一のファイルに結合されたメソッドのコレクションです。

ビュー、 「ビュー」フォルダーに移りましょう。 3つのサブディレクトリ： custom 、 layout 、 scriptsが含まれています。 すべてのビューの拡張子は.phtmlです。
レイアウトフォルダーには、アプリケーションのすべてのレイアウトが含まれます。 説明する特別なものはありません。 コンテンツをレイアウトに出力するには、 content()メソッドを使用しcontent() 。
scriptsフォルダーには、アクションゲームのビューが含まれています。 構造は次のとおりです： scripts / <Controller name> / <ActionName> .phtml
さて、 「カスタム」フォルダーには、最初の2つのフォルダーに適さない他のすべてのビューがあります。 たとえば、ヘッダーなどによってサイドバーブロックが個別に取り出される場合があります。

そして最後に、 「config」フォルダー。 構成を複製できるdebugサブディレクトリが含まれています。 定数APP_DEBUGがtrueの場合、アプリケーションはconfig / debugフォルダーで要求された構成を見つけようとします。構成が存在しない場合にのみ、構成フォルダーから接続します。 アプリケーションがデバッグモードでない場合、 デバッグフォルダーは無視されます。
すべての構成は配列を返すPHPファイルです。つまり、その内容は次のようになります。

 return array( // . . . ); 

フォルダ「ライブラリ」 。 実際、これはフレームワークそのものであるため、詳細に検討することはしません（恥ずかしい）。 いくつかの詳細のみを説明します。
フォルダー「機能」 。 フレームワークの機能を拡張する必要がある場合、ここにあります。 このフォルダーからのPHPファイルは、 loadFunction($fnc)メソッドを使用してロードされます。 自動ロードはまだありませんが、近い将来になります。 また、ファイル「default.php」にも注意を払う必要があります。 フレームワークのすべての主要機能が含まれており、アプリケーションの起動時に接続されます。
initフォルダーでは、init.phpファイルに興味があります。 アプリケーションが起動するたびに実行され、そこで動的な構成を実行する必要があります。
「models」フォルダーで 、 「basemodel.php」ファイルに注意してください。 これは、上で書いたMySQLのバインディングです。

フレームワークを使用する

このフレームワークで小さなアプリケーションを作成してみましょう。 読んだ本のカタログにしてください。

プロジェクトの作成と設定

リンクの1つでフレームワークをダウンロードします： github.com/SazereS/NoNameFramework.git yadi.sk/d/ZAnE6Yq_4kgBe troloload.ru/f/5979_nonameframework.zip dl.dropboxusercontent.com/u/85783372/NoNameFrameworkz

フレームワークをサイトフォルダーに解凍します。 私たちのアプリケーションはデータベースを使用するので、すぐにあなたにとって便利な方法でそれを作成します。
app / configに移動して、 mysql.phpファイルを開きます。 デフォルト値を独自の値に置き換えます。 次のようになりました。

 // mysql.php return array( 'dbHost' => 'localhost', 'dbUser' => 'root', 'dbPass' => '', 'dbName' => 'test', ); 

次に、 ライブラリ/ init / init.phpを開き、行initDb();を確認しinitDb(); コメントが外されました。
この初期設定では、完了したと見なすことができます。

CRUDアプリケーションの作成

まず、データベースにテーブルが必要です。 それを本と呼び、列id、title、author、comment、markで構成します。 これを行うには、作成したデータベースに対してこのリクエストを実行します。

 CREATE TABLE `books` ( `id` INT(10) NOT NULL AUTO_INCREMENT, `title` VARCHAR(80) NOT NULL, `author` VARCHAR(40) NOT NULL, `comment` TEXT NOT NULL, `mark` INT NOT NULL, PRIMARY KEY (`id`) ) COLLATE='utf8_general_ci' ENGINE=MyISAM; 

モデルも必要です。 これを行うには、 modelsフォルダーにbooks.phpファイルを作成します。

ブックコントローラーを作成します。 これを行うには、 app / controllersフォルダーにbooksフォルダーを作成します。

CRUDは、作成、読み取り、更新、削除（作成、読み取り、更新、削除）の略語です。 コントローラが生成するのはこれらのアクションです。 これらのアクションごとにアクションを作成します。 これらのアクションの名前はnew 、 view 、 edit 、およびdeleteです。 さらに、すべての書籍をリストするアクションが必要です。 これを「インデックス」と呼びます。 これを行うには、 booksフォルダーにindexAction.php、newAction.php、viewAction.php、editAction.php、deleteAction.phpの 5つのファイルを作成します。

一部のアクションゲームにはビューファイルが必要です。 必要に応じて作成します。 新しいアクションから始めましょう。 これを行うには、 views / scriptsフォルダーに（コントローラーの名前で） ブックのサブフォルダーを作成し、その中にnew.phtmlファイル（アクションの名前で）を作成します。 次のテキストを一時的に挿入します： books/new 。 次に、Webサーバーを起動して、アドレス「http：// <サイトアドレス> / books / new」に移動します。 そこで、教科書/ newが表示されるはずです。

行動に戻りましょう。 newAction.phpファイルを開き、次のコードを追加します。

 <?php //   models/books.php loadModel('books'); // ,     POST if(isPost()){ //  ,      $post $post = getPost(); //      if(newBook($post)){ //   -       redirect('books'); } else { //    -      $_view['form'] = $post; } } 

$ _view変数に注意してください。 コントローラがビューと通信するのは彼女の助けを借りてです。 渡されたすべての値は、ビューとレイアウトの両方から利用できます。
さらに、 newBook()関数にも関心があります。 実際、この機能はまだ存在しません。 作成しましょう。 これを行うには、モデル（ books.php ）を開き、次のコードをそこに挿入します。

 <?php function newBook($array) { //      'books'     return insertRow('books', $array); } 

これで、モデルとアクションの処理が完了し、ビューに戻ります。 次のコードをそこに貼り付けます：

 <form method="post"> <label> : </label> <br /> <input type="text" name="title" value="<?=$_view['form']['title'] ?>" /> <br /> <label>: </label> <br /> <input type="text" name="author" value="<?=$_view['form']['author'] ?>" /> <br /> <label>  : </label> <br /> <textarea name="comment"><?=$_view['form']['comment'] ?></textarea> <br /> <label>   ( 1  10): </label> <br /> <input type="text" name="mark" value="<?=$_view['form']['mark'] ?>" /> <br /> <button type="submit"></button> </form> 

これで、ブラウザでページを更新し、フォームを介してデータを追加できます。 データは追加されますが、リダイレクト後、ビューの欠落に関するメッセージが表示されます。 作成しましょう（ファイルはindex.phtmlと呼ばれます）。

次に、アクションインデックスに移動します 。 コードをそこに挿入します。

 <?php //   loadModel('books'); //           $_view['books'] = getAllBooks(); 

ご覧のとおり、存在しないgetAllBooks()関数を再び使用しました。 これらの行をモデルに追加します。

 function getAllBooks() { //   ,     return fetchAll('books'); } 

ビューに移動して、そこにこれを挿入します。

 <?php if($_view['books']) foreach ($_view['books'] as $v) { ?> #<?=$v['id'] ?>: <a href="<?=baseUrl('books/view/id/'.$v['id']) ?>"><?=$v['title'] ?></a><br /> <?php } ?> 

ここで、新しいbaseUrl()関数をbaseUrl()ました。 正しいリンクを作成する必要があります。 この場合、サイトのルートからリンクを作成することでこれを行わなくてもかまいませんが、特にlocalhost / framework / testのようなアドレスにサイトがあるサイトの場合、不必要なトラブルを排除できます。

これでこのアクションで終了できます。 論理チェーンビューの次のアクションに進みます 。 類推によってすべてが明確であるため、ここでコード全体を紹介します。

viewAction.php：

 <?php loadModel('books'); //    getBook() ,     $_view['book'] = getBook(getParam('id')); 

モデルの追加：

 function getBook($id) { //  -      return fetchRow('books', 'id = ' . $id); } 

表示（作成することを忘れないでください）：

 <strong>: </strong> <?=$_view['book']['title'] ?><br /> <strong>: </strong> <?=$_view['book']['author'] ?><br /> <strong>: </strong><br /> <?=$_view['book']['comment'] ?><br /> <strong>: </strong> <?=$_view['book']['mark'] ?>  10<br /> <a href="<?=baseUrl('books/edit/id/'.$_view['book']['id']) ?>"></a><br /> <a href="<?=baseUrl('books/delete/id/'.$_view['book']['id']) ?>"></a><br /> 

今すぐeditAction

editAction.php：

 loadModel('books'); //      $_view['form'] = getBook(getParam('id')); if(isPost()){ $post = getPost(); //    if(updateBook(getParam('id'), $post)){ //   -       redirect('books/view/id/'. getParam('id')); } else { //    -      $_view['form'] = $post; } } //         //  edit.phtml,  new.phtml setResponse('action', 'new'); 

new.phtmlのフォームを使用するため、このアクションのビューは作成していません。

モデルに関数を追加します。

 function updateBook($id, $values) { //        $id return updateRow('books', 'id = ' . $id, $values); } 

最後に、最後のアクションはdeleteです。

deleteAction.php：

 loadModel('books'); deleteBook(getParam('id')); redirect('books'); 

モデルの機能：

 function deleteBook($id) { //     return deleteRow('books', 'id = ' . $id); } 

このアクションは、インデックスアクションにリダイレクトされるため、原則としてプレゼンテーションは必要ありません。

これで、結果のコードをわずかに改善できます。 お気づきかもしれませんが、毎回、アクションの開始時に、同じ操作loadModel('books') 。 個別に取り出しましょう。 これを行うには、コントローラーのフォルダーに_init.phpファイルを作成し、この行をそこに配置して、コントローラーから削除します。 リンクを突いて、プロジェクトが機能していることを確認します。

次に、新しいレコードとすべてのレコードのリストを作成するためのリンクを作成します。 これを行うには、ファイルapp / views / layout / default.phtmlを開きます。 content()ルーチンは、ビューのコンテンツをレイアウトで表示します。 そのすぐ上に次のコード行を追加します。

 <a href="<?=baseUrl('books') ?>"> </a><br /> <a href="<?=baseUrl('books/new') ?>"> </a><br /> 

これで、リストへのリンクと追加フォームがアプリケーションのすべてのページに表示されます。

ルーティング

各アクションのアドレスが理想的にどのように見えるかを決めましょう。 このオプションをお勧めします：

 'books' => ''、
 'books / new'-> 'book / new'、
 'books / view / id / {id}'-> 'book / {id}'、
 'books / edit / id / {id}'-> 'book / {id} / edit'、
 'books / delete / id / {id}'-> 'book / {id} / delete'、

それが機能するために？ config / router.phpファイルを開き、配列を次の形式にキャストします 。

 return array( #  -    '' => 'books', #   'book/new' => 'books/new', 'book/{id|int}' => 'books/view/id/{id}', 'book/{id|int}/edit' => 'books/edit/id/{id}', 'book/{id|int}/delete' => 'books/delete/id/{id}', ); 

本/ 1では、 ID 1の本に関する情報が開きますが、残りは同様です。

ルート構文についてもう少し

連想配列のキーはルートパターンであり、値はすべてのパラメーターを含む実際のアクションアドレスです。 動的な部分は中括弧で囲まれています。 ルートの各ブロックは完全に静的または完全に動的である可能性があることに注意してください。つまり、 'user/{id}' => 'users/profile/id/{id}' -エントリ'id{id}' => 'users/profile/id/{id}' -間違っています。つまり、現時点ではyoursite.com/id33523のようなリンクを取得できませんが、近いうちに修正する予定です。

ルートは、データ型（string-string、str、integer-int、integer、fractional-float、real）および送信された値の最大長でフィルタリングされます。 フィルターを追加するには、パラメーター名の後に、垂直バーでフィルターを指定します。 例：

  #   '{id|int}' => 'index/index/id/{id}', #    'test/{test|3}' => 'index/index/result/success1/param/{test}', 'test/{test|integer}' => 'index/index/result/success2/param/{test}', 'test/{test|float}' => 'index/index/result/success2/param/{test}', 'test/{test|str|5}' => 'index/index/result/success4/param/{test}', 'test/{test|string}' => 'index/index/result/success5/param/{test}', #      'view' '{controller}/{id|int}' => '{controller}/view/id/{id}', #       '{controller}/{action}/{id|int}' => '{controller}/{action}/id/{id}', 

おわりに

実際、これはこのフレームワークのすべての機能ではありませんが、=）と書くのはうんざりです。 少なくとも誰かが私の創造物が役に立つと思うことを望みます。さもなければ、なぜ私はここに十字架につけられますか？

ダウンロードリンク

GitHub： github.com/SazereS/NoNameFramework.git
Yandex.Disk： yadi.sk/d/ZAnE6Yq_4kgBe
Dropbox： dl.dropboxusercontent.com/u/85783372/NoNameFramework.zip
Troloload： troloload.ru/f/5979_nonameframework.zip

よろしくお願いします！ エラーで鼻を突くと、弱点を指摘することをheしないでください。 「プログラミングの終了はあなたのものではありません」のような文でさえ、引数でサポートされていれば感謝されます。 事前に感謝します！