PHPackages                             xiaoniuge/think-dotenv - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. xiaoniuge/think-dotenv

ActiveLibrary[Utility & Helpers](/categories/utility)

xiaoniuge/think-dotenv
======================

ThinkPHP3.2集成php-dotenv

v1.0.0(2y ago)036Apache-2.0PHP

Since Apr 1Pushed 2y ago1 watchersCompare

[ Source](https://github.com/doyouhaobaby/think-dotenv)[ Packagist](https://packagist.org/packages/xiaoniuge/think-dotenv)[ RSS](/packages/xiaoniuge-think-dotenv/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

介绍
==

[](#介绍)

> ThinkPHP 3.2 集成 [php-dotenv](https://github.com/josegonzalez/php-dotenv)

[composer中文文档](http://www.kancloud.cn/thinkphp/composer)

dotenv简介
--------

[](#dotenv简介)

dotenv 解决一套代码在多处部署时各处代码所用的环境变量及配置的相互独立问题:

1. 团队协作时, 不同成员本地开发环境的系统,服务器类型,数据库用户密码都可能不同. 如果环境配置写死在项目中, 可能每次更新完代码都需要重新修改本地配置.
2. 本地与线上环境配置肯定不同, 如果直接利用版本库部署代码到线上, 必须防止将本地配置推送到线上.
3. 新增加入一个自定义的 .env

```
// 自定义 .env
if (getenv('RUNTIME_ENVIRONMENT')) {
   $env = '.'.getenv('RUNTIME_ENVIRONMENT');
} else {
   $env = '.env';
}

$env_file = $path.'/'.$env;
```

使用
--

[](#使用)

\##安装篇

```
composer require snowair/think-dotenv:dev-master

```

\##配置篇

- 在 Common/Conf/tags.php 增加一个行为,如果已经添加过,就不用再添加了: ```
    return array(
         'app_init'=>array(
            'Snowair\Think\Behavior\HookAgent'
         ),
    )

    ```

修改 `.gitignore`, 添加`.env`文件到排除列表

现在你可以在项目根目录(即`APP_PATH`目录)下创建`.env`文件定义独立的环境配置了! 就是这么简单.

- `.env` 文件的格式见文档:

默认行为
----

[](#默认行为)

\###原来

```
config.php

return array(
        'DB_TYPE'   => 'mysql', // 数据库类型
        'DB_HOST'   => 'localhost', // 服务器地址
        'DB_NAME'   => 'dbname', // 数据库名
        'DB_USER'   => 'root', // 用户名
        'DB_PWD'    => '123456', // 密码
        'DB_PORT'   => 3306, // 端口
        'DB_PREFIX' => '', // 数据库表前缀
);

```

\###现在

```
.env

DB_TYPE=mysql
DB_HOST=localhost
DB_NAME=dbname
DB_USER=root
....

```

应用启动后, .env 文件中的配置项将覆盖config.php中的这些同名的配置项.

因此, 不同的机器,通过创建自己的.env文件,就可以避免开发和部署时的配置冲突问题.

注: windows平台创建以`.`号开头的特殊文件可能需要从编辑器中创建.

现在你就可以去验证下是否OK了。

### 复杂配置

[](#复杂配置)

TP中有些配置的值是数组, 使用 dotenv的配置格式为: `KeyP1.KeyP2.Key...=value`

例如:

```
"MODULE_ALLOW_LIST"=>array('Home','Admin','Api'),

```

如果想使用 .env 文件进行配置, 文件内容如下:

```
MODULE_ALLOW_LIST.0=Home
MODULE_ALLOW_LIST.1=Admin
MODULE_ALLOW_LIST.2=Api

```

高级用法
----

[](#高级用法)

一般情况下, 以上默认行为已经足够应付绝大多数场景. 但也许你也需要dotenv提供的其他功能(见文档).

think-dotenv 提供了以下配置对应dotenv提供的其他功能:

```
 "DOTENV" => array(
    "toEnv"=>true,              // 是否将 .env导入到 $_ENV 变量, 默认为false
    "toServer"=>true,           // 是否将 .env导入到 $_SERVER 变量, 默认为false
    "toConst"=>true,            // 是否将 .env导入到常量, 默认为false
    "expect"=>'env1,env2,env3', // 强制要求定义的env配置列表, 如果.env文件中没有定义, 则抛出异常

 ),

```

注意: 这些配置必须定义在 Conf/config.php 等配置文件中.

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 87.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

772d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/735e710d4c01fcfa7c2bb9d5e6760112cc192b578cac4978ce99ddb6aa726fe5?d=identicon)[hunzhiwange](/maintainers/hunzhiwange)

---

Top Contributors

[![doyouhaobaby](https://avatars.githubusercontent.com/u/2012511?v=4)](https://github.com/doyouhaobaby "doyouhaobaby (7 commits)")[![xuwenzhi](https://avatars.githubusercontent.com/u/7285911?v=4)](https://github.com/xuwenzhi "xuwenzhi (1 commits)")

### Embed Badge

![Health badge](/badges/xiaoniuge-think-dotenv/health.svg)

```
[![Health](https://phpackages.com/badges/xiaoniuge-think-dotenv/health.svg)](https://phpackages.com/packages/xiaoniuge-think-dotenv)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)