MyQEE PHP Framework ![passing](./manual/html/assets/images/passing.png)
====
## 简介
MyQEE是一个开源、快速、优雅的轻量级PHP框架,支持HMVC模式,建立在PHP5.2基础之上,支持多项目管理开发,数据库内置自动主从分离功能,MySQL支持事务操作功能并且支持自动嵌套功能,多驱动设计灵活适应各种环境。点击访问 [MyQEE入门指引](./manual/guide/zh-cn/starting.md)。
> 拒绝粗糙不堪、复杂的代码,选择MyQEE,选择为WEB艺术家创造的PHP框架吧。
## MyQEE PHP框架的特色
* MyQEE是一套轻量级的框架,但不是简陋的框架,系统具备完善的底层类库和强大的扩展功能设计;
* 特有的 [HMVC](./manual/guide/zh-cn/hmvc.md) (分层MVC设计)和多项目支持,开发更灵活;
* 支持时下最流行的PHP包管理器 [Composer](http://getcomposer.org/) ,并且可以使用 Composer 安装 MyQEE 提供的官方类库;
* 代码一致性设计:例如 `MySQL` 和 `MongoDB` 的查询语句完全不同,但是在 MyQEE 里可以做到实现90%的一致性,你的代码既可以使用在 `MySQL` 的环境里也可以用在 `MongoDB` 上;
* 包括`Database`, `Cache`, `HttpClient`, `Session`, `Storage`, `Upload` 等支持多驱动,可以适应不同环境的需求,其中数据库支持 `MySQL`, `MySQLI`, `Mongo`, `SQLite`, `Postgre`,缓存支持 `Memcache`, `File`, `Redis`, `Apc`, `Database`, `SQLite`, `WinCache` 等;
* 数据库提供强大的 `QueryBuilder` 功能,可实现同相同程序兼容多种数据库,解决SQL注入隐患和迁移环境后顾之忧;
* 云引擎支持:支持SAE和BAE等云引擎,MyQEE网站就运行在SAE上;
* 高性能和优雅的代码:经测试 MyQEE 的初始化速度比 Codeigniter 等优秀的轻量级框架还快;
* 完备和详细的文档和API支持,更可简单的生成自己的团队文档;
* 为团队开发而生,特别提供团队类库功能,多项目设置可以帮助团队成员之间规划独立和共用的代码;
* ORM支持,提供了特有的高性能ORM;
* 支持 `RESTFul`,支持 [PHPRPC](http://www.phprpc.org/);
* 独创5模式运行设计:普通控制器、后台、命令行、系统调用、RESTFul的控制器相互分离,系统更加安全可靠;
## 安全性
* 系统内置XSS安全过滤;
* 防SQL注入,强大的QueryBuilder;
* 强制数据类型转换;
* 普通控制器、后台、命令行、系统调用、RESTFul 5种运行模式相互隔离,安全更有保障;
## 安装配置
系统要求:推荐lamp架构,php至少5.2.3以上版本,推荐5.3以上最新版本,apache或nginx需要支持rewrite
使用 Composer 直接安装MyQEE:
``` bash
composer create-project myqee/myqee ./test
```
如果你已经安装过 [composer](http://getcomposer.org/) 只需要上面一条命令即可把MyQEE安装到 `./test` 目录。
如果你没有安装过 `composer` ,很简单,运行:
``` bash
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
```
如果你是window系统,请参考 [http://getcomposer.org/doc/00-intro.md#installation-windows](http://getcomposer.org/doc/00-intro.md#installation-windows)
**Apache配置样例:**
``` ApacheConf
<Virtualhost *>
# 网站域名,(写入配置时请把中文注释去掉,下同)
ServerName www.myqee.com
# DocumentRoot一定要/结尾
DocumentRoot "D:/php/myqee_v2/wwwroot/"
# 以下内容无需修改
DirectoryIndex index.html index.php
RewriteEngine On
RewriteRule .*/\..* - [F,L]
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_FILENAME} !-f [AND]
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_FILENAME} !-d
RewriteRule ^/.* /index.php [PT,L]
# 以下是一些文件的缓存设置,可修改或去掉
<IfModule expires_module>
ExpiresActive On
ExpiresByType text/css "access plus 3 days"
ExpiresByType image/png "access plus 14 days"
ExpiresByType image/gif "access plus 14 days"
ExpiresByType image/jpeg "access plus 14 days"
ExpiresByType application/x-shockwave-flash "access plus 28 days"
</IfModule>
</Virtualhost>
```
!!! 注意,请去掉中文注释
**Nginx配置样例:**
``` Nginx
server {
set $www /home/www/myqee/wwwroot/;
root $www;
index index.html index.htm index.php;
listen 80;
charset utf-8;
server_name www.myqee.com;
server_name myqee.com;
location ~* .(css|js)$ {
if (-f $request_filename) {
expires 3d;
break;
}
}
location ~* .(jpg|gif|png|jpeg|bmp)$ {
if (-f $request_filename) {
expires 15d;
break;
}
}
location ~* .(swf|zip|rar|gz|7z)$ {
if (-f $request_filename) {
expires 1m;
break;
}
}
# rewrite
if (!-e $request_filename) {
rewrite ^/.* /index.php last;
}
location ~ \.php$ {
fastcgi_split_path_info ^(.+\.php)(/.+)$;
# With php5-fpm:
fastcgi_pass unix:/var/run/php5-fpm.sock;
fastcgi_index index.php;
include fastcgi_params;
}
}
```
!!! 其中 `fastcgi_params` 指 `/etc/nginx/fastcgi_params` 文件,某些系统可指定为 `/etc/nginx/fastcgi_php` 可设置 `include fastcgi_php;`
## 升级
升级方法及注意事项请看[UPGRADE.md](UPGRADE.md)文件
##修改日志
请查阅[CHANGELOG.md](CHANGELOG.md)文件
## 商业友好的开源协议
MyQEE遵循Apache2开源协议发布。Apache Licence是著名的非盈利开源组织Apache采用的协议。该协议和BSD类似,鼓励代码共享和尊重原作者的著作权,同样允许代码修改,再作为开源或商业软件发布。