bnf / static-docroot
Composer 插件,确保在单个请求期间,DOCUMENT_ROOT 是静态和稳定的,适用于基于符号链接的部署。
1.1.3
2017-04-04 12:52 UTC
Requires
- php: >=5.5.0
- composer-plugin-api: ^1.1
Requires (Dev)
- composer/composer: ^1.0
This package is auto-updated.
Last update: 2024-09-06 09:27:53 UTC
README
此包作为 composer 插件,以自动修补 $_SERVER['DOCUMENT_ROOT']
和 $_SERVER['SCRIPT_FILENAME']
到它们的真实路径,以确保它们不包含符号链接。这意味着它们是静态和稳定的。这意味着我们希望它们的目的地在一个请求期间不会改变。当它们包含可能在部署期间更改的符号链接时,就会发生这种情况。
composer require bnf/static-docroot
此插件的行为可以通过根 composer.json
文件的 extra
部分的配置来影响
"extra": {
"bnf/static-docroot": {
"web-dir": "public"
}
}
web-dir
您可以从基本目录指定一个相对路径,其中公共文档根应该位于。
默认值 由 extra|typo3/cms|web-dir
衍生,如果未设置,则作为最后手段使用 "web"
。这意味着如果您已经配置了 typo3/cms
web-dir
,则不需要添加 bnf/static-docroot
部分。
"extra": {
"typo3/cms": {
"web-dir": "web"
}
}
关于 TYPO3 8.7 的说明:自 TYPO3 8.7 LTS 以来,此包不再需要。 https://review.typo3.org/#/c/52295/ 修复了 TYPO3,使其基于 __DIR__
进行基础路径计算,因此实际上与该包相同。如果您有一个使用 $_SERVER['DOCUMENT_ROOT']
而不是 GeneralUtility::getIndpEnv()
的(不好的)扩展,您可能仍然需要此包。