project wula {🖫 41, ⚐ 13, ★ 10}

wula/wula

Thursday, August 2, 2018
by windywany
Repository
3 Watchers
10 Stars
41 Installations

PHP
0 Dependents
0 Suggesters
6 Forks
0 Open issues
13 Versions
0 % Grown

The README.md

wula(wula@php、乌拉)是wulaphp框架的炮架子，它为wulaphp框架提供web应用开发的基础目录结构:, _(*1)

wula
|--conf # 配置目录，可通过CONF_DIR常量自定义
   |--.env #开发环境配置
   |--.env.example # 环境配置示例文件
   |--cache_config.php # 缓存配置文件
   |--config.php # 应用配置文件，可通过.env(将.env.example复制到.env)文件进行配置
   |--dbconfig.php # 数据库配置文件，可通过.env文件中的db段进行配置
   |--cluster_config.php # 基于Redis的分布式运行时缓存 
|--crontab # 定时任务运行目录，可随意命名，如果不需要定时任务可删除
   |--cron.php # 定时任务脚本, 通过crontab服务运行
|--extensions # 扩展目录, 可通过EXTENSION_DIR常量自定义
   |-- ... # 扩展的实现...
|--includes # 应用使用的第三方库（不可通过composer加载），可通过LIBS_DIR常量自定义
   |-- common.php # 第三方库加载入口。
|--logs # 目录日志，可通过LOGS_DIR常量自定义
|--tmp # 运行临时目录，可通过TMP_DIR常量自定义
|--vendor # composer库目录,不可自定义
|--wwwroot # 网站根目录，如果网站根目录不是此目录，需要修改WWWROOT_DIR常量值
   |--assets  # 公共资源目录，类型为wula-assset的composer包会安装到此目录
   |--modules # 模块目录, 可通过MODULE_DIR常量修改。
      |--home # home模块
         |--classes # 模块类目录，此目录中的类文件可以按需自动加载(autoload) 
         |--controllers # 模块控制器目录
            |--IndexController.php # 默认控制器，首页请求由此控制器处理
         |--views # 视图目录
            |--index # 对应Controller的视图目录
              |--index.tpl # 基于Smarty的视图模板文件，对应Controller中的Action.
         |--bootstrap.php # 模块引导文件
      | -- ... # 其它模块
   |--themes # 网站前台主题目录,可通过THEME_DIR常量自定义
      |--default # 默认主题
         |--index.tpl # 网站首页模板
         |--404.tpl # 404页面模板
         |--403.tpl # 403页面模板
         |--500.tpl # 500页面模板
         |--template.php # 主题数据处理器定义文件 
   |--index.php # 网站入口,一般情况不需要修改.
   |--robots.txt # 蜘蛛抓取规则文件（可删除）
   |--favicon.ico # 网站图标（可删除）
   |--crossdomain.xml # flash跨域文件（可删除）
|--bootstrap.php # 引导文件
|--composer.json # composer配置文件
|--artisan # wula命令行工具

注：, _(*2)

下文中的your_project_public_dir应为wwwroot目录的绝对路径.

当your_project_public_dir目录是wwwroot的上级目录时，要将WWWROOT_DIR常量定义为/wwwroot/

wwwroot目录名可以自定义.

以上所有常量的自定义都应该放在bootstrap.php文件中.

0 环境要求

php >=5.6.9 || >= 7.1
PDO (PDO_MySQL)
mysqlnd 扩展
mbstring 扩展
curl 扩展
json 扩展
SPL 扩展

1 安装

1.1 通过composer安装:

开发模式: composer create-project wula/wula
生产模式: composer create-project --no-dev wula/wula

1.2 压缩文件安装

从这儿下载，然后解压。, _(*3)

2. 配置

wula可以部署在apache或nginx中，需要他们支持重写功能。, _(*4)

2.1 apache 配置

apache 需要开启重写功能支持
请检查wwwroot目录中的.htaccess文件，此文件必须存在.

2.1.1 apache 虚拟主机配置

<VirtualHost *:80>
    <Directory "your_project_public_dir">
        Options FollowSymLinks
        AllowOverride All
        Order allow,deny
        Allow from all
    </Directory>        
    ServerAdmin your-email-address
    DocumentRoot "your_project_public_dir"
    ServerName your_server_name
    # other directives can be here
</VirtualHost>

注:, _(*5)

your_project_public_dir 应指是 wwwroot的绝对路径., _(*6)

配置完成后重启apache生效., _(*7)

2.1.2 apache 独立主机配置

修改apache的配置文件中的以下内容: - 修改DocumentRoot, _(*8)

DocumentRoot "your_project_public_dir"

<Directory "your_web_public_dir">
    Options FollowSymLinks -Indexes
    AllowOverride all
    Order allow,deny
    Allow from all
</Directory>

注:, _(*9)

your_project_public_dir 应指是 wwwroot的绝对路径., _(*10)

配置完成后重启apache生效., _(*11)

2.2 nginx 配置 (推荐)

在nginx的配置中添加一个server如下：, _(*12)

server {
    listen       80;
    server_name  your_server_name;
    root your_project_public_dir;
    location / {
        index index.php index.html index.htm;
        if (!-e $request_filename){
            rewrite ^(.*)$ index.php last;
        }
    }
    location ~ /(modules|assets|themes)/.+\.(php[s345]?|tpl|inc)$ {
        return 404;
    }        
    error_page  404              /404.html;
    location ~ \.php$ {
        fastcgi_pass   127.0.0.1:9000; #unix:/tmp/fpm56.sock;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  $document_root/$fastcgi_script_name;
        #fastcgi_param  APPMODE pro;
        include        fastcgi_params;
    }
    location ~ /\.ht {
        deny  all;
    }
}

注:, _(*13)

your_project_public_dir 应指是 wwwroot的绝对路径., _(*14)

可以通过fastcgi_param APPMODE 来定义wulaphp的运行模式: * pro 为线上生产环境 * dev 为开发环境（默认） * test 为测试环境, _(*15)

配置完成后重新加载nginx的配置生效., _(*16)