図解 ThinkPHP5 フレームワーク (4): フレームワーク構成が 1 枚の絵で丸わかり (完成版)
- 天蓬老师オリジナル
- 2017-05-18 18:09:4010914ブラウズ
このコースは、設定ファイル形式（php/ini/json/xml）からシーン設定、モジュール設定、拡張設定、独立設定、動的設定、カスタム設定の読み込み、環境変数、パノラマ表示まで、10のモジュールに分かれています。 PHP5 設定の世界を考えてみましょう~~。
より良い効果を得るために、画像を新しいウェブページで開いて表示してください。または、ダウンロードしてローカルで表示します。この画像は xmind マインドマップで作成したものです。一番下に xmind のソースファイルのダウンロードがあります。xmind ソフトウェアで開くとよいでしょう。
1. マインドマップ:
1 構成ディレクトリ
1.1 デフォルトの構成ディレクトリ
1.1.1 アプリケーション構成: アプリケーションディレクトリ
1. 1 .2 モジュール設定: application/module ディレクトリ
1.2 カスタム設定ディレクトリ
1.2.1 エントリファイル:define('CONF_PATH', __DIR__.'/../config/');
1.2.2 ユーザーの定義カスタム構成ファイルのディレクトリはアプリケーション ディレクトリと同じレベルにあります
1.2.3 アプリケーション構成ファイルには 3 つが含まれます: config.php/database.php/route.php
1.2.4 モジュール構成ファイルには 3 つが含まれます: config. php/database .php
1.2.5 アプリケーションの初期化時にルートが生成されているため、モジュール内でroute.phpを設定しないでください
1.3 設定ディレクトリを拡張します
1.3.1 アプリケーションの下に追加のディレクトリを作成しますまたはモジュール設定ディレクトリ
1.3.2 追加ディレクトリに作成される設定ファイルの名前は拡張設定名なので、拡張設定はすべて2次元配列になります
1 追加ディレクトリに作成: myconf.php
2. myconf.php ファイル内:
<?php return [ 'site_name'=>'www.php.cn', ];
3 コントローラーでのアクセス:
dump(\think\Config::get());
最後に確認できます:
["myconf"] => array(1) {
["site_name"] => string(10) "www.php.cn"
}1.3.3 最終的に作成された拡張設定項目はアプリケーション設定とマージされます。 items (dump(thinkConfig::get());// View)
2 設定形式
2.1 配列形式
2.1.1 これはデフォルトの形式です。必要はありませんエントリーファイルで CONF_EXT を設定します
2.1.2 設定ファイル: config.php、内容は return によって返される配列です
<?php return [ 'my_name' => '朱老师', ];
2.1.3 2 次元配列で表される 2 つの設定をサポートします
<?php
return [
'my_info' => [
'my_name' => '朱老师',
'my_age' => 28,
'my_sex' => '男',
],
];2.1.4 返されたコンテンツは自動的にアプリケーション設定とマージされ、配列で返されます["my_info"] => array(3) {
["my_name"] => string(9) "朱老师"
["my_age"] => int(28)
["my_sex"] => string(3) "男"
}
2.2.1 エントリファイルの設定形式を変更します:define('CONF_EXT', '.ini');
<?php // 定义应用目录 define('APP_PATH', __DIR__ . '/../application/'); //定义配置目录 define('CONF_PATH', __DIR__ . '/../config/'); // 更改配置格式为ini格式 define('CONF_EXT', '.ini'); // 加载框架引导文件 require __DIR__ . '/../thinkphp/start.php';
2.2.2 設定ファイル: config.ini、内容は、記号で接続された名前と値のペアで構成され、コメントはセミコロンの後に記述されます。 名前にはハンガリー語の命名法が使用され、名前と値は等号で接続され、値には区切り文字は必要ありません
config.ini 内容： my_name=朱老师 ;我的姓名 ;my_name是配置名称,朱老师是值,分号后面是该配置项的注释部分,可以省略
2.2.3 セカンダリ構成をサポートし、構成項目は一対の角かっこ内に配置されます
config.ini の第 2 レベルの構成コンテンツ[base_info]
my_name=朱老师;我的姓名
my_age=28 ;我的年龄
my_sex=男 ;我的性别
2.2.4 返されたコンテンツは、アプリケーション構成と自動的にマージされ、配列で返されます
アプリケーション構成で返される結果は、次の 2 つです。次元配列:
["base_info"] => array(3) {
["my_name"] => string(9) "朱老师"
["my_age"] => string(2) "28"
["my_sex"] => string(3) "男"
}2.3 xml形式2.3.1 エントリファイルの構成形式を変更します:define('CONF_EXT', '.xml');
<?php // 定义应用目录 define('APP_PATH', __DIR__ . '/../application/'); //定义配置目录 define('CONF_PATH', __DIR__ . '/../config/'); // 更改配置格式为ini格式 define('CONF_EXT', '.xml'); // 加载框架引导文件 require __DIR__ . '/../thinkphp/start.php';2.3.2 構成ファイル:config.xml,構成アイテムはタグのペアに配置され、タグ名は構成アイテムです
<config> <my_home>安徽省合肥市</my_home> </config> <!--标签名就是配置项,可以自定义,根标签一定是config,其它字符串也行,内容在标签对中,--> <abc> <my_home>安徽省合肥市</my_home> </abc> <!--标签只要成对出现就行-->2.3.3 二次構成をサポートし、構成アイテムはタグのペアに配置されます
<abc> <info> <my_home>安徽省合肥市</my_home> <my_work>中文网</my_work> </info> </abc>
2.3.4 コンテンツを自動的に返し、 apply 構成のマージ、配列として返されます
アプリケーション構成で返される結果は 2 次元配列です:
["info"] => array(2) {
["my_home"] => string(18) "安徽省合肥市"
["my_work"] => string(9) "中文网"
}2.4 json 形式
2.4.1 エントリ ファイルの構成形式を変更します:define( 'CONF_EXT', '.json');
<?php // 定义应用目录 define('APP_PATH', __DIR__ . '/../application/'); //定义配置目录 define('CONF_PATH', __DIR__ . '/../config/'); // 更改配置格式为ini格式 define('CONF_EXT', '.xml'); // 加载框架引导文件 require __DIR__ . '/../thinkphp/start.php';2.4.2 構成ファイル: config.json、構成項目は json オブジェクトに配置され、構成項目の名前と値のペアは JavaScript オブジェクトによって表されます
{
"my_name":"朱老师",
"my_age":28,
"my_sex":"男"
} 特記事項: 最後の構成項目の後にカンマを追加しないでください2.4.3 二次構成をサポートします。構成項目は 1 組のタグに配置されます
{
"base_info":{
"my_name":"朱老师",
"my_age":28,
"my_sex":"男"
}
}すべての構成の上に 1 つのレイヤーを追加するだけです。現在のデータをネストするだけです。
2.4.4 返されたコンテンツは、アプリケーション構成と自動的にマージされ、配列として返されます
["base_info"] => array(3) {
["my_name"] => string(9) "朱老师"
["my_age"] => int(28)
["my_sex"] => string(3) "男"
}
3 シナリオ構成
3.1 目的: 異なる環境で異なる構成アイテムを使用します
3.2 アプリケーション設定 config.php の「app_status」=>「シーン名」を変更します。
このシーン名は、アプリケーション設定ディレクトリの下にある設定ファイルに対応します。設定ファイルの内容は、デフォルトでは配列モードです。 。
たとえば、自宅で作業し、オフィスとは異なるデータベース接続パラメータを使用する場合があります。 次に、最初に次のように設定できます:
同样，如果你到了公司，要换成公司的数据库，可以在应用配置文件中:
<?php return [ // 应用模式状态,将home改成office 'app_status' => 'office', ];
3.3 在应用配置目录下创建与场景名称同名的php文件做为配置文件,以数组方式返回配置项
然后在当前应用配置目录下面创建一个:home.php文件
里面写上如下内容：
实际上就是database.php中的内容复制一份就行。
<?php
return [
// 数据库类型
'type' => 'mysql',
// 服务器地址
'hostname' => 'localhost',
// 数据库名
'database' => 'home',
// 用户名
'username' => 'root_home',
// 密码
'password' => 'root_home',
// 端口
'hostport' => '',
// 连接dsn
'dsn' => '',
// 数据库连接参数
'params' => [],
// 数据库编码默认采用utf8
'charset' => 'utf8',
// 数据库表前缀
'prefix' => '',
// 数据库调试模式
'debug' => true,
// 数据库部署方式:0 集中式(单一服务器),1 分布式(主从服务器)
'deploy' => 0,
// 数据库读写是否分离 主从式有效
'rw_separate' => false,
// 读写分离后 主服务器数量
'master_num' => 1,
// 指定从服务器序号
'slave_no' => '',
// 是否严格检查字段是否存在
'fields_strict' => true,
// 数据集返回类型
'resultset_type' => 'array',
// 自动写入时间戳字段
'auto_timestamp' => false,
// 时间字段取出后的默认时间格式
'datetime_format' => 'Y-m-d H:i:s',
// 是否需要进行SQL性能分析
'sql_explain' => false,
// Builder类
'builder' => '',
// Query类
'query' => '\\think\\db\\Query',
];同样，如果你到了公司，要换成公司的数据库，
然后在应用配置目录下创建office.php文件，将数据库配置信息写入，以数据形式返回，就可以了。
4 模块配置
4.1 模块也可以有自己的独立配置:模块名/config.php
4.2 模块配置优先于应用配置,相同配置会覆盖应用配置
4.3 模块也支持场景状态配置，原理与步骤与应用一致
1.创建模块配置文件: application/index/config.php
2. 添加配置项，修改应用状态
<?php return [ // 模块模式状态 'app_status' => 'module_office', ];
3.在index模块目录下创建: modult_office.php，做为模块的场景状态配置文件
文件内容也以数据库连接为例：
<?php
return [
// 数据库类型
'type' => 'mysql',
// 服务器地址
'hostname' => 'localhost',
// 数据库名
'database' => 'modult_office',
// 用户名
'username' => 'modult_office',
// 密码
'password' => 'modult_office',
// 端口
'hostport' => '',
// 连接dsn
'dsn' => '',
// 数据库连接参数
'params' => [],
// 数据库编码默认采用utf8
'charset' => 'utf8',
// 数据库表前缀
'prefix' => '',
// 数据库调试模式
'debug' => true,
// 数据库部署方式:0 集中式(单一服务器),1 分布式(主从服务器)
'deploy' => 0,
// 数据库读写是否分离 主从式有效
'rw_separate' => false,
// 读写分离后 主服务器数量
'master_num' => 1,
// 指定从服务器序号
'slave_no' => '',
// 是否严格检查字段是否存在
'fields_strict' => true,
// 数据集返回类型
'resultset_type' => 'array',
// 自动写入时间戳字段
'auto_timestamp' => false,
// 时间字段取出后的默认时间格式
'datetime_format' => 'Y-m-d H:i:s',
// 是否需要进行SQL性能分析
'sql_explain' => false,
// Builder类
'builder' => '',
// Query类
'query' => '\\think\\db\\Query',
];
4. 保存后，打开浏览器查看，可以看到配置更新结果
5 其它位置的配置文件
5.1 全部在控制器的方法中动态调用Config类中的方法完成手工加载
5.2 用Config::load(配置文件):可以加载任何位置的配置文件,默认Array格式
先在与config目录中创建同级的newconf目录，在该目录下创建conf.php，如果是.php文件，就默认是以数组方式返回配置项,采用Config::load()方法手工动态加载
config/newconf/conf.php文件内容
<?php return [ 'user_define' =>'www.php.cn' ];
控制器中的:index/index/中的index方法
<?php
namespace app\index\controller;
class Index
{
public function index()
{
//手工加载指定目录下的配置文件,注意Config类的命名空间
\think\Config::load(APP_PATH.'../config/newconf/conf.php');
dump(\think\Config::get());
}
}5.3 如果是其它格式(ini/xml/json)用Config::parse(文件,'类型')来加载
先在与config目录中创建同级的newconf目录，在该目录下创建conf.ini，按框架的约定,不论是什么格式的配置文件，最终必须是以数组方式返回配置项，所以第一步就是要将其它格式的数组，解析成数组，所以就不能再用Config::load()方法了，Config类提供了一个Config::parse()方法来加载其它格式的配置文件，这个方法有二个参数，第一个是要加载的配置文件，第二个就是当前配置文件的格式，如ini,xml或json等
我们以ini格式为例
config/newconf/conf.ini文件内容
my_system = mac_os my_phone = huawei
控制器中的:index/index/中的index方法
<?php
namespace app\index\controller;
class Index
{
public function index()
{
//手工加载指定目录下的配置文件,注意Config类的命名空间
\think\Config::parse(APP_PATH.'../config/newconf/conf.ini','ini');
dump(\think\Config::get());
}
}5.4 最终与前面一样，都是与应用配置合并后以数组方式返回全部配置项
["my_system"] => string(6) "mac_os" ["my_phone"] => string(6) "huawei"
6 读取配置项
6.1 方法1:Config::get('参数'),不传入参数则是读取应用的全部配置项
6.2 方法二:作用助手函数config(),不需要导入命名空间直接使用,效率低不推荐
6.3 Config::get('my_info.my_system')方法可以读取二级配置,配置项之间用.点连接
6.4 Config::has(''app_status''):has方法检测某个配置项是否存在,返回布尔值
在控制器中检测:某个配置项是否存在
<?php
namespace app\index\controller;
class Index
{
public function index()
{
dump(\think\Config::has('app_status'));
}
}6.5 如何用助手函数:config('?配置参数');也返回布尔值
<?php
namespace app\index\controller;
class Index
{
public function index()
{
dump(config('?app_status'));
}
}7 动态设置参数
7.1 配置项可以写在配置文件，也可以用Config::set()方法动态设置
7.2 Config::set(名称,值),可以逐个设置，也可用数组批量设置:Config::set(数组)
一、名值对方式，逐个设置
<?php
namespace app\index\controller;
class Index
{
public function index()
{
\think\Config::set('site_domain','www.php.cn');
dump(\think\Config::get());
}
}二、数组方式，批量设置
<?php
namespace app\index\controller;
use think\Config;
class Index
{
public function index()
{
$config = [
'site_domain' => 'www.php.cn',
'site_name' => 'PHP中文网',
'php_tools' => 'PHP程序员工具箱',
];
Config::set($config);
dump(Config::get());
}
}7.3 助手函数config(名值对/数组),也可以进行动态设置
将上面的用Config类的代码微微改一下就行，
去掉上面的空间导入
将Config::set()和Config::get()全部换成config()就可了。
<?php
namespace app\index\controller;
class Index
{
public function index()
{
$config = [
'site_domain' => 'www.php.cn',
'site_name' => 'PHP中文网',
'php_tools' => 'PHP程序员工具箱',
];
config($config);
dump(config());
}
}8 独立配置文件
8.1 5.0.1以上版本,直接将独立配置文件放在应用或模块的extra目录下即可
自动读取的独配置文件都是二级配置参数，一级配置名称就是扩展配置的文件名。
8.2 默认设置了2个独立配置文件，database.php(数据库配置) 和 validate.php(验证规 则)
8.3 四类默认加载的独立配置文件不用放在extra目录下
8.3.1 应用或者模块配置文件:config.php
8.3.2 数据库配置文件:database.php
8.3.3 行为定义文件:tags.php
8.3.4 场景配置文件:例如home.php，office.php
9 配置参数的作用域
9.1 类似于命名空间,以二维数组方式来收纳参数
9.2 切换作用域: Config::range()，默认值为:_sys_
9.3 可以将扩展配置或独立配置归纳到作用域,或动态设置Config::set()
<?php
namespace app\index\controller;
use think\Config;
class Index
{
public function index()
{
//设置一组配置项
$config = [
'user_name'=>'peter',
'user_age'=>28,
];
//批量设置,写入user作用域
Config::set($config,'user');
//输出全部配置项，发现作用域相当于二维数组名称
dump(Config::get());
//用二维数组方式获取user作用域中的user_name值
dump(Config::get('user.user_name'));
//同样用数组的方式来设置配置项的值
Config::set('user.user_name','php.cn');
echo '<hr>';
//查看设置好的新值
dump(Config::get('user.user_name'));
//切换作用域到系统全局_sys_(默认):用 Config::range()方法
Config::range('_sys_');
//查看全部配置项
dump(Config::get());
}
}10 系统环境变量配置
10.1 在应用同级目录创建.env文件来模拟系统变量,内容格式为:ini
app_status = office ;配置场景为office
10.2 原生方法:获取系统环境变量:$_ENV,getenv(变量名),
10.3 TP提供Env.php类,该类只有一个方法:Env::get(变量名)来获取环境变量
10.4 .env文件不支持非标量，如需使用数组，要用_下划线连接方式进行参数分级设置
注意，环境变量不支持数组参数，如果需要使用数组参数可以，使用下划线分割定义配置参数名：
database_username = database_password = root 123456 //或者使用 [database] username = password = root 123456
10.5 对于数组参数，访问时可以用下划线或者.点语法都可以
获取环境变量的值可以使用下面的两种方式获取：
Env::get('database.username'); Env::get('database.password'); // 同时下面的方式也可以获取 Env::get('database_username'); Env::get('database_password');
可以支持默认值，例如：
// 获取环境变量 如果不存在则使用默认值root Env::get('database.username','root');
10.6 环境变量读取优先于应用配置参数,所以可以配置参数中引用环境变量
可以直接在应用配置中使用环境变量，例如：
return [ 'hostname' => Env::get('hostname','127.0.0.1'), ];
三、思维导图下载：
以上が図解 ThinkPHP5 フレームワーク (4): フレームワーク構成が 1 枚の絵で丸わかり (完成版)の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。