# Z-PHP框架v2.0 文檔
>[danger][Z-PHP框架](http://www.z-php.com) 目前由我個人開發和維護，所有喜歡的PHPer都可以使用。
框架本身不存在任何后門或是收集、統計信息之類的代碼。
歡迎大家使用并提出改進意見，QQ交流群：592429541
最新版請移步 [官網](http://www.z-php.com/doc) 查看
## 一些規范：
1. 大小寫：沒有強制要求，建議目錄和控制器類名全部使用小寫。
2. 控制器名：xxx.class.php。
## 開始使用：
1. 下載程序文件解壓后，將 core 目錄復制到網站根目錄外層，以網站根目錄是 /htdocs/public_html 為例core就放在/htdocs 目錄下。
2. 在/htdocs/public_html 目錄下建立入口文件 index.php，內容如下：
<?php
define('IN',str_replace('\\','/',dirname(__FILE__)) . '/'); //定義http請求的根目錄
define('APP_PATH','home'); //定義應用目錄名稱
define('DEBUG',1); //開啟debug
require('../core/core.php'); //加載框架
\z\z::start();
3. 在瀏覽器訪問剛才建立的入口文件，成功的話會顯示歡迎信息并且程序會自動建立項目目錄結構。詳見目錄結構。
應用目錄就是入口文件定義的home，歡迎信息就是/htdocs/home/controller/index.class.php 控制器輸出的。
>[danger]關于目錄結構
之所以將程序文件放在站點根目錄之外主要是處于安全問題的考慮
這樣用戶就訪問不到 public_html 目錄之外的內容
而 public_html 目錄下就只有入口文件和網站的靜態資源文件，如css,image,js 等等
如果你是用虛擬主機不能指定站點的根目錄，請參考以下配置
core就放在站點根目錄下
在站點根目錄下建立入口文件 index.php，內容如下
<?php
define('RES_PATH','public_html'); //定義資源文件的目錄
define('APP_PATH','home'); //定義應用目錄名稱
define('DEBUG',1); //開啟debug
require('./core/core.php'); //加載框架（注意這里的路徑）
\z\z::start();
