1: 在线文档
2: 在线DEMO 管理后台账号 superAdmin, 密码 123456
1: 基于YAF 和 PDO 开发的一个PHP 框架, 简单, 易用, 高效
2: 底层使用的鸟哥的 YAF, MySQL 封装使用的是 PDO 类, 支持链式操作, 功能强大且调用非常方便
3: 支持多种运行环境, 根据运行环境决定域名常量, MySQL参数, 错误报告等
4: 支持默认模型 [可以不创建模型文件也能对表进行CURD]
5: DEMO 中包括用户的简单登录,注册,注销.文章的发布,管理,分页,个人资料修改
6: 后台管理登录,注销,修改密码, 文章&用户管理, 权限分配
7: dev 下MySQL 和PHP 错误全部都打印出来, 方便调试, test , product 下将不打印, 分别记录在对应的文件里
8: 二种简易省市区三级联动
9: 二个模块:User, Admin
10: 一些常用的函数封装, 位于 function 目录
11: 前台使用 Bootstrap, 后台使用 Ace, 响应式布局。集成 UEditor, 上传, 二维码生成功能, uploadify, URL伪静态示例，删除了复杂的示例
12: 全面使用 yaf.library 来实现类的自动加载
15: 使用 setErrorHandle 来实现自定义错误输出, 方便 debug
16: 感谢 Vampire, 果儿-高级程序猿, 资料空白，藕酥胖胖鱼, 黑白, 赵鹏, 落舞者等的建议和帮忙
17: 当前版本 2.2
1: 安装YAF 扩展, 然后在 php.ini 里加入如下内容, 重启 WEB 服务
[YAF]
extension = yaf.so
yaf.environ = dev
2: 配置好 application.ini 里的MySQL参数并将 dym.sql 导入自己的数据库 [导入前记得设置导入编码为UTF8]
3: 配置虚拟主机, 写对应的HOSTS
4: 解压文件至指定目录,运行
5: WEB 服务器开启 URL Rewrite 功能, Apache 下有 .htaccess [该文件默认为隐藏文件], Nginx 的虚拟主机需要加如下代码
location / {
if (!-e $request_filename) {
rewrite ^/(.*)$ /index.php?$1 last;
}
}
6: Nginx 下配置文件示例 [请将 root 指向 public 目录]
server {
listen 80;
server_name dev.yof.com;
root /usr/www/YOF/public;
index index.php;
location / {
if (!-e $request_filename) {
rewrite ^/(.*)$ /index.php?$1 last;
}
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fcgi.conf;
}
location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$ {
expires 30d;
}
location ~ .*\.(js|css)?$ {
expires 12h;
}
}
2: php.ini 中或调用 ini_set('yaf.environ') 来设置运行环境, 目前支持 dev, test, product
A: 开发环境请设置为 dev, 此时所有错误将打印出来方便调试
B: 线上测试环境设置为 test,
此时 PHP 的错误将记录在 APP_PATH.'/log/php/' 下的 $当天日期.log
SQL 的错误将记录在 APP_PATH.'/log/sql/' 下的 $当天日期.log
C: 正式生产环境设置为 product
此时 PHP 的错误将记录在 APP_PATH.'/log/php/' 下的 $当天日期.log
SQL 的错误将记录在 APP_PATH.'/log/sql/' 下的 $当天日期.log
注:正式生产环境千万不能设置为 dev, 切记!!!
3: 配置网站域名, 图片域名, 静态文件域名等, 避免硬编码
请打开 init.php, 根据 dev, test, product 自行对 $SERVER_DOMAIN, $STATIC_DOMAIN, $IMG_DOMAIN 根据情况设置
applicatoin => 程序主目录
controllers => 不使用modules 情况下的控制器目录
function => 封装好的函数目录, 包括 F_Array.php , F_Basic.php, F_String.php, F_Network.php, F_File.php,等
library => 封装好的类库
core => 核心类目录, 包括助手类 Helper.php, 基础控制器 C_Basic.php, PDO 类 Model.php
model => 模型文件, 默认一个模型对应一个表
modules => YAF 默认的模块文件, 示例有二个:User, Admin
plugins => YAF 默认的插件位置, 示例有 Router.php, Admin.php
views => 视力文件默认目录
conf => 配置文件目录, application.ini
> YOF_VERSION => YOF 版本, 目前是 2.2public => 公用文件, JS, CSS, IMG 等一般位于此
APP_PATH => 根目录
ENV => 运行环境
TB_PK => 表主键, 默认为 id
TB_PREFIX => 表前缀
APP_NAME => APP 名称
LIB_PATH => 类目录, 即 APP_PATH.'/application/library'
CORE_PATH => 核心类目录, 即 APP_PATH.'/application/library/core'
MODEL_PATH => 模型目录, 即 APP_PATH.'/application/model'
FUNC_PATH => 函数目录, 即 APP_PATH.'/application/function'
ADMIN_PATH => Admin 模块目录, APP_PATH.'/application/modules/Admin'
CSS_PATH => CSS 路径, 即 /css
JS_PATH => JS 路径, 即 /js
IMG_PATH => IMG 路径, 即 /img
ADMIN_CSS_PATH => 管理后台 CSS 路径, '/admin/css'
ADMIN_JS_PATH => 管理后台 JS 路径, '/admin/js'
CUR_DATE => 当前日期, 格式 Y-m-d
CUR_TIMESTAMP => 当前时间戳
SERVER_DOMAIN => 网站域名
STATIC_DOMAIN => 静态文件域名
IMG_DOMAIN => 图片域名
SITE_PROVINCE => 三级联动中默认显示的省份, 440000 是广东
SITE_CITY => 三级联动中默认显示的城市, 440100 是广州
SITE_REGION => 三级联动中默认显示的省份, 440106 是珠江新城
一: 控制器
A:不是模块下的情况: 在 APP_PATH.'/controllers' 目录下按 YAF 规则创建控制器, 如示例中的 Article.php
B: 模块下的情况: 在 APP_PATH.'/modules/模块/controllers' 目录下按 YAF 规则创建控制器, 如示例中的 User/controllers/User.php
C: 基本控制器 APP_PATH.'/controllers/core/C_Basic.php', 对 request, session, cookie 中的方法进行了简易封装, 令业务控制器可以少写不少的代码!
二: 模型
A: 常规模型: 在 APP_PATH.'/model' 目录下按 M_$模型名称.php 规则创建, 指定对应的表, 如示例中的 M_Admin, M_Role.php等
B: 不创建模型, 使用默认模型, 这种情况下不需要创建模型文件. 如示例中并没有 M_Articles.php,也可以操作 article 表, 按默认模型的方式调用即可
A: 常规模型: $this->m_role = $this->load('Role');
B: 默认模型: $this->m_article = $this->load('Article');, 示例中并没有 M_Articles.php 也可以加载, 但参数 Article 必须与表名对应, 即对应的表名必须是 TB_PREFIX.'article'
1:先借助 Field($field), Where($where), Order($order), Limit($limt)拼接好 SQL 语句, 不调用这几个方法代表不设置对应的条件
2: 调用 Select, SelectOne, Update, Delete, Insert
3: 便捷方法: SelectByID($field, $id), UpdateByID($m, $id), DeleteByID($id), SelectFieldByID($field, $id),
$buffer['articles'] = $m_article->Where($where)->Order($order)->Limit($limit)->Select();
$field = array('id');
$where = array('username' => $username, 'password' => $password);
$data = $this->m_user->Field($field)->Where($where)->SelectOne();
$code = $this->m_user->UpdateByID($m, USER_ID); // $code 是所影响的行数
$articleID = $this->m_article->Insert($m); // $m 是一个数组, key 是表中的字段名, $articleID 是返回的自增长ID
$code = $this->m_article->DeleteByID($articleID); // $code 是所影响的行数
由于鄙人觉得复杂的 SQL 用函数来拼接有以下问题 1: 新手难以掌握, 2: 学习成本高 3: 效率低和难以维护, 故复杂的SQL, 如联表查询等用如下方式实现
1: 在模型里新建一个方法, 接收参数, 写原生的SQL, 并调用 Query($sql), 这样比较直观. 如 M_Admin.php 的
// 查询文章列表 [建议将此方法写在 M_Article 里]
public function getUserArticles($userID){
$sql = 'SELECT u.username, a.* FROM '.TB_PREFIX.'user AS u '
. ' LEFT JOIN '.TB_PREFIX.'article AS a ON a.userID = u.id '
. ' WHERE a.userID = "'.$userID.'" ORDER BY a.addTime DESC LIMIT 10';
return $this->Query($sql);
}
控制器里调用: $data = $this->load('Admin')->getUserArticles($userID)
2:通用的方法,如经常会调用到的 SQL 语句, 请在模型里封装, 如 M_City.php 里的 getCityNameById()
三: 视图
A: 在 YAF 指定的视图目录里创建与 Action 一样的文件名.php|.html
B: 控制器调用 $this->getView()->assign($buffer);
C: 视图文件里用模板引擎或原生PHP 展示数据就可以了
四: function 目录里文件的引用
如要导入 F_File.php 里的函数, 使用 Helper::import('File') 即可
1: 先在 APP_PATH.'/conf/application.ini' 中添加模拟, DEMO 中有 Index,User,Admin,Api 四个模块. 注 Index模块 必不可少
2: 在 APP_PATH.'/application/modules' 中创建模块目录, 比如说DEMO 中的 Api
3: 建立 controllers, views 目录
4: 按 http://你的域名/模块名/控制器/方法 的规则调用, 如调用 Api 模块 Article 中的index
http://dev.yaf.com/api/article/index
DEMO 中处理方式是增加一个Module, 名为 Admin, 按照基本的 MVC 模式去写就好了
DEMO 中处理方式是增加一个Module, 名为 Api, 按照基本的 MVC 模式去写就好了, 当然了别忘了给接口作安全验证
Q:如果又有网站, 又有 APP, 还要出手机端网站,如果只调用一次数据就能满足?
A: 借助 Library, 让其调用模型,出统一的数据. API,网站,手机网站的控制器调用 Library 中的方法即可
B: 如 APP_PATH.'/application/modules/User/controllers/User.php' 中的 ProfileAction 调用省市区三级联动
$buffer['cityElement'] = new City()->generateCityElement($provinceID, $cityID, $regionID, 1);
1: 先加载一个模型,比如 $m_article = $this->load('Article');
2: 启动事务: $m_article->beginTransaction();
3: 执行业务 SQL ....
4: 调用 Commit: $m_article->Commit(); 或 Rollback : $m_article->Rollback();
1:该文件是 MySQL 的PDO 封装类
2:读者可能有这么一个疑问, 复杂的 WHERE 该如何调用呢? 我的回答是: 自行写原生的 WHERE. 如查询 username 为 abc, password 为 cba 的 WHERE 可以用
$where = array('username' => 'abc', 'password' => 'cba');
但如果是 username 为 abc 或 cba, ID < 100 的 WHERE 呢? 用字符串模式
$where = ' `username` = "abc" OR `username` = "cba" '
$where = ' `id` < "100"'
当然, 你也可以使用 YOF 中的类来写得更优雅些 请点击这里查看强大的 SQL 拼接方法, 支持Where, ORR, Order 无限次数调用, 或者打开 application/controllers/Test.php 查看测试用例
3: 特殊的 Update 语句, 比如 id 为 1 的文章的阅读数要加 1, 按如下方式调用
$m = array('views' => 'views+1');
$where = array('id' => 1);
$this->m_article->Where($where)->Limit(1)->Update($m, TRUE); // Update 加第二个参数: TRUE
根据 YAF 规则扩展插件
自行编写类库
其他: 若发现有BUG 或更好的建议,请联系大眼猫 QQ: 381345509, 谢谢!