https://github.com/b13/t3ext-environment
TYPO3 Extension: allow environment-dependent settings
https://github.com/b13/t3ext-environment
Last synced: 12 months ago
JSON representation
TYPO3 Extension: allow environment-dependent settings
- Host: GitHub
- URL: https://github.com/b13/t3ext-environment
- Owner: b13
- License: mit
- Created: 2013-07-19T15:06:32.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2020-09-25T07:13:58.000Z (almost 6 years ago)
- Last Synced: 2023-08-21T08:08:40.983Z (almost 3 years ago)
- Language: PHP
- Size: 30.3 KB
- Stars: 12
- Watchers: 16
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
TYPO3 Extension Environment
===========================
Created by Benjamin Mack, b:dreizehn GmbH, in 2013.
Published under the MIT license.
What does it do?
----------------
The TYPO3 extension "Environment", compatible with TYPO3 CMS 4.5 until
TYPO3 CMS 7.99.99, allows for context-specific settings, so the TYPO3
installation has different options for each context. This means that all
logging and debugging settings can be turned on for the development
environment.
Of course, this extension makes most sense if you have multiple server scenarios and a local development environment.
Installation
------------
1) Install the extension.
2) Add the following Rewrite statements to your .htaccess file after the RewriteBase
statement or to your Apache webserver configuration.
# Make sure the context variable is set with every http request
RewriteCond %{HTTP_HOST} ^(.*)staging-system\.org$
RewriteRule .? - [E=TYPO3_CONTEXT:Production/Staging]
RewriteCond %{HTTP_HOST} ^(.*)development-system\.org$
RewriteRule .? - [E=TYPO3_CONTEXT:Development]
3) Add the following code to your typo3conf/AdditionalConfiguration.php for
TYPO3 CMS >= 6.0
// load the environment / context configuration for this installation
if (\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::isLoaded('environment')) {
include('ext/environment/Includes/Bootstrap/InitializeContext.php');
}
3a) For installations prior to 6.0, please include this at the bottom of the localconf.php
// load the environment / context configuration for this installation
if (t3lib_extMgm::isLoaded('environment')) {
include('ext/environment/Includes/Bootstrap/InitializeContext.php');
}
3b) For installations using TYPO3 CMS 6.2+, just add this to your typo3conf/AdditionalConfiguration.php
// load the environment / context configuration for this installation
include('ext/environment/Includes/Bootstrap/InitializeContext.php');
After that, you have a PHP constant named "TYPO3_CONTEXT" that
is set to the environment variable placed in your server settings.
4) You can now define context-specific configurations, and create files like
* typo3conf/AdditionalConfiguration.Development.php
* typo3conf/AdditionalConfiguration.Production.php
and add configuration options like different DB settings and debugging
settings, that get included depending on what context you have set in your
server settings. Examples are provided in
[Resources/Public/Examples](https://github.com/b13/t3ext-environment/tree/master/Resources/Public/Examples).
Please make sure that the PHP files always start with the following lines
[GLOBAL]
With TYPO3 CMS 6.2, you can use the newly defined "applicationContext" TypoScript condition.
Environment-dependent email redirection
---------------------------------------
You can redirect any outgoing email to a specific email address by setting the
following TYPO3_CONF_VARS option:
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['environment']['redirectEmails'] = 'benni@typo3.org';
You can add multiple addresses separated via comma, or in a simple array.
It makes most sense if you put this in a environment-dependent installation like
typo3conf/AdditionalConfiguration.Development.php and remove it in the
Production environment settings.
Thanks
------
Big thanks goes to:
* the b13 specialists for braining and finding the optimal out-of-the-box solutions,
* Jesus Christ who saved my life.