MyQEE PHP Framework

简介

MyQEE是一个开源、快速、优雅的轻量级PHP框架，支持HMVC模式，建立在PHP5.2基础之上，支持多项目管理开发，数据库内置自动主从分离功能，MySQL支持事务操作功能并且支持自动嵌套功能，多驱动设计灵活适应各种环境。点击访问 MyQEE入门指引。

拒绝粗糙不堪、复杂的代码，选择MyQEE，选择为WEB艺术家创造的PHP框架吧。

MyQEE PHP框架的特色

• MyQEE是一套轻量级的框架，但不是简陋的框架，系统具备完善的底层类库和强大的扩展功能设计；
• 特有的 HMVC (分层MVC设计)和多项目支持，开发更灵活；
• 支持时下最流行的PHP包管理器 Composer ，并且可以使用 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；
• 独创5模式运行设计：普通控制器、后台、命令行、系统调用、RESTFul的控制器相互分离，系统更加安全可靠；

安全性

• 系统内置XSS安全过滤；
• 防SQL注入，强大的QueryBuilder；
• 强制数据类型转换；
• 普通控制器、后台、命令行、系统调用、RESTFul 5种运行模式相互隔离，安全更有保障；

安装配置

系统要求：推荐lamp架构，php至少5.2.3以上版本，推荐5.3以上最新版本，apache或nginx需要支持rewrite

使用 Composer 直接安装MyQEE：

    composer create-project myqee/myqee ./test

如果你已经安装过 composer 只需要上面一条命令即可把MyQEE安装到 ./test 目录。

如果你没有安装过 composer ，很简单，运行：

    curl -sS https://getcomposer.org/installer | php
    mv composer.phar /usr/local/bin/composer

如果你是window系统，请参考 http://getcomposer.org/doc/00-intro.md#installation-windows

Apache配置样例：

<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配置样例：

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_pass   127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
        
        # 以下解决用php输出js,css等文件导致出错的问题
        gzip on;
        gzip gzip_min_length 1100;
        gzip_buffers 4 8k;
        gzip_types text/plain application/x-javascript text/css image;
    }
}

!!! 其中 fastcgi_params 指 /etc/nginx/fastcgi_params 文件，某些系统可指定为 /etc/nginx/fastcgi_php 可设置 include fastcgi_php;

升级

升级方法及注意事项请看UPGRADE.md文件

##修改日志

请查阅CHANGELOG.md文件

商业友好的开源协议

MyQEE遵循Apache2开源协议发布。Apache Licence是著名的非盈利开源组织Apache采用的协议。该协议和BSD类似，鼓励代码共享和尊重原作者的著作权，同样允许代码修改，再作为开源或商业软件发布。