thinkphp 入口文件模块绑定/多模块开启

Posted 2023-02-27 qikexun

Thinkphp 3.2 版本后将整个项目 APP_PATH 路径下的 Application 作为一个应用，应用下可以存在多个模块，如系统默认生成的 Common Home Admin 等

完整Url路由模版如下

    index.php/module/controller/action/param1/val1/param2/val2

入口文件中的常量参数：

    //绑定Web模块
    define('BIND_MODULE', 'Web');
    //绑定Site控制器
    define('BIND_CONTROLLER', 'Site');
    //绑定show动作
    define('BIND_ACTION', 'show');

// 应用入口文件

// 检测PHP环境
if (version_compare(PHP_VERSION,'5.3.0','<')) die('require PHP > 5.3.0 !');

// 开启调试模式 建议开发阶段开启 部署阶段注释或者设为false
define('APP_DEBUG', true);

//绑定Web模块
define('BIND_MODULE', 'Web');
//绑定Site控制器
define('BIND_CONTROLLER', 'Site');
//绑定show动作
define('BIND_ACTION', 'show');

// 定义应用目录
define('APP_PATH', './Application/');

// 引入ThinkPHP入口文件
require './ThinkPHP/ThinkPHP.php';

// 亲^_^ 后面不需要任何代码了 就是如此简单

BIND_MODULE 会将当前入口文件与定义的 模块 严格绑定，url 中不再存有module的占位

    index.php/controller/action/param1/val1/param2/val2

BIND_CONTROLLER会将当前入口文件与定义的 控制器 严格绑定，url 中不再存有 controller 的占位

    index.php/action/param1/val1/param2/val2

BIND_ACTION 会将当前入口文件与定义的 动作 严格绑定，url 中不再存有 action 的占位

    index.php/param1/val1/param2/val2

所以如果要开启单个入口文件下的多模块访问，这几个 BIND 参数是不可以使用的

多模块的设置

默认是开启多模块的， 在入口文件中没有绑定任何模块的话 ，多模块便默认开启并有效

Common 模块中的config/config.php：

<?php
return array(
    'MULTI_MODULE' => true, //是否开启多模块
    'DEFAULT_MODULE' => 'Web', //默认模块指定为 Web
);

这里需要注意的是

    DEFAULT_MODULE    默认值为 Home

    DEFAULT_CONTROLLER    默认值为 Index

    DEFAULT_ACTION    默认值为 index

这三个参数只有当我们不填写路由参数直接访问 index.php 时，系统会根据默认参数路由

如果我们填写了路由参数的话，必须按照  index.php/module/controller/action 的模式去访问

如下图：

此时如果我不写模块，则系统会把我本意为控制器作为模块处理

关闭多模块或者在入口文件中设定 BIND_MODULE 的模块值：

如果我们关闭多模块，系统会根据 DEFAULT_MODULE 的值作为默认模块进行访问，我们不需要也不能在 url 中填写模块名，它已经被内定了，其实就相当于在入口文件中 BIND_MODULE 为默认模块

<?php
return array(
   'MULTI_MODULE' => false,
   'DEFAULT_MODULE' => 'Web'
);

总结：

1、单模块模式：

index.php/controller/action/param1/val1/param2/val2

在入口文件中

    define('BIND_MODULE', 'Web')

或者在 Common/Conf/config.php 中设定

    'MULTI_MODULE' => false，

    'DEFAULT_MODULE' => 'Web'  

即可达到相同的效果，url中不需要也不可以填写模块名，已经被初始内定了

2、多模块模式：

index.php/module/controller/action/param1/val1/param2/val2

在入口文件中不可以 BIND 任何模块，

Common/Conf/config.php 中设定

    'MULTI_MODULE' => true，

url 中需要按 module/controller/action 的模式去访问，设定的默认模块，默认控制器和默认动作可以起到默认路由的作用。