Advanced Configuration Tricks
Advanced Configuration Tricks
Configuration of zend-mvc applications happens in several steps:
- Initial configuration is passed to the
Application
instance and used to seed theModuleManager
andServiceManager
. In this tutorial, we will call this configuration system configuration. - The
ModuleManager
'sConfigListener
aggregates configuration and merges it while modules are being loaded. In this tutorial, we will call this configurationapplication configuration. - Once configuration is aggregated from all modules, the
ConfigListener
will also merge application configuration globbed in specified directories (typicallyconfig/autoload/
). - Finally, immediately prior to the merged application configuration being passed to the
ServiceManager
, it is passed to a specialEVENT_MERGE_CONFIG
event to allow further modification.
In this tutorial, we'll look at the exact sequence, and how you can tie into it.
System configuration
To begin module loading, we have to tell the Application
instance about the available modules and where they live, optionally provide some information to the default module listeners (e.g., where application configuration lives, and what files to load; whether to cache merged configuration, and where; etc.), and optionally seed the ServiceManager
. For purposes of this tutorial we will call this the system configuration.
When using the skeleton application, the system configuration is by default inconfig/application.config.php
. The defaults look like this:
return [
// Retrieve list of modules used in this application.
'modules' => require __DIR__ . '/modules.config.php',
// These are various options for the listeners attached to the ModuleManager
'module_listener_options' => [
// This should be an array of paths in which modules reside.
// If a string key is provided, the listener will consider that a module
// namespace, the value of that key the specific path to that module's
// Module class.
'module_paths' => [
'./module',
'./vendor',
],
// An array of paths from which to glob configuration files after
// modules are loaded. These effectively override configuration
// provided by modules themselves. Paths may use GLOB_BRACE notation.
'config_glob_paths' => [
realpath(__DIR__) . '/autoload/{{,*.}global,{,*.}local}.php',
],
// Whether or not to enable a configuration cache.
// If enabled, the merged configuration will be cached and used in
// subsequent requests.
'config_cache_enabled' => true,
// The key used to create the configuration cache file name.
'config_cache_key' => 'application.config.cache',
// Whether or not to enable a module class map cache.
// If enabled, creates a module class map cache which will be used
// by in future requests, to reduce the autoloading process.
'module_map_cache_enabled' => true,
// The key used to create the class map cache file name.
'module_map_cache_key' => 'application.module.cache',
// The path in which to cache merged configuration.
'cache_dir' => 'data/cache/',
// Whether or not to enable modules dependency checking.
// Enabled by default, prevents usage of modules that depend on other modules
// that weren't loaded.
// 'check_dependencies' => true,
],
// Used to create an own service manager. May contain one or more child arrays.
//'service_listener_options' => [
// [
// 'service_manager' => $stringServiceManagerName,
// 'config_key' => $stringConfigKey,
// 'interface' => $stringOptionalInterface,
// 'method' => $stringRequiredMethodName,
// ],
// ],
// Initial configuration with which to seed the ServiceManager.
// Should be compatible with Zend\ServiceManager\Config.
// 'service_manager' => [],
];
The system configuration is for the bits and pieces related to the MVC that run before your application is ready. The configuration is usually brief, and quite minimal.
Also, system configuration is used immediately, and is not merged with any other configuration — which means, with the exception of the values under theservice_manager
key, it cannot be overridden by a module.
This leads us to our first trick: how do you provide environment-specific system configuration?
Environment-specific system configuration
What happens when you want to change the set of modules you use based on the environment? Or if the configuration caching should be enabled based on environment?
It is for this reason that the default system configuration we provide in the skeleton application is in PHP; providing it in PHP means you can programmatically manipulate it.
As an example, let's make the following requirements:
- We want to use the
ZendDeveloperTools
module in development only. - We want to have configuration caching on in production only.
zfcampus/zf-development-mode provides a concise and conventions-based approach to switching between specifically production and development. The package is installed by default with version 3+ skeletons, and can be installed with existing v2 skeletons using the following:
$ composer require zfcampus/zf-development-mode
The approach it takes is as follows:
- The user provides production settings in
config/application.config.php
. - The user provides development settings in
config/development.config.php.dist
to override bootstrap-level settings such as modules and configuration caching, and optionally also inconfig/autoload/development.local.php.dist
(to override application settings). - The bootstrap script (
public/index.php
) checks forconfig/development.config.php
, and, if found, merges its configuration with the application configuration prior to configuring theApplication
instance.
When you execute:
$ ./vendor/bin/zf-development-mode enable
The .dist
files are copied to versions removing the suffix; doing so ensures they will then be used when invoking the application.
As such, to accomplish our goals, we will do the following:
- In
config/development.config.php.dist
, addZendDeveloperTools
to the list of modules:
'modules' => [
'ZendDeveloperTools',
],
- Also in
config/development.config.php.dist
, we will disable config caching:
'config_cache_enable' => false,
- In
config/application.config.php
, we will enable config caching:
'config_cache_enable' => true,
Enabling development mode now enables the selected module, and disables configuration caching; disabling development mode enables configuration caching. (Also, either operation clears the configuration cache.)
If you require additional environments, you can extend zf-development-mode to address them using the same workflow.
Environment-specific application configuration
Sometimes you want to change application configuration to load things such as database adapters, log writers, cache adapters, and more based on the environment. These are typically managed in the service manager, and may be defined by modules. You can override them at the application level viaZend\ModuleManager\Listener\ConfigListener
, by specifying a glob path in thesystem configuration — the module_listener_options.config_glob_paths
key from the previous examples.
The default value for this is config/autoload/{{,*.}global,{,*.}local}.php
. What this means is that it will look for application configuration files in theconfig/autoload
directory, in the following order:
global.php
*.global.php
local.php
*.local.php
This allows you to define application-level defaults in "global" configuration files, which you would then commit to your version control system, and environment-specific overrides in your "local" configuration files, which you would omit from version control.
Additional glob patterns for development mode
When using zf-development-mode, as detailed in the previous section, the shipped
config/development.config.php.dist
file provides an additional glob pattern for specifying development configuration:
config/autoload/{,*.}{global,local}-development.php
This will match files such as:
- database.global-development.php
- database.local-development.php
These will only be considered when development mode is enabled!
This is a great solution for development, as it allows you to specify alternate configuration that's specific to your development environment without worrying about accidently deploying it. However, what if you have more environments &mdash such as a "testing" or "staging" environment — and they each have their own specific overrides?
To accomplish this, we'll provide an environment variable via our web server configuration, APP_ENV
. In Apache, you'd put a directive like the following in either your system-wide apache.conf or httpd.conf, or in the definition for your virtual host; alternately, it can be placed in an .htaccess file.
SetEnv "APP_ENV" "development"
For other web servers, consult the web server documentation to determine how to set environment variables.
To simplify matters, we'll assume the environment is "production" if no environment variable is present.
With that in place, We can alter the glob path in the system configuration slightly:
'config_glob_paths' => [
realpath(__DIR__) . sprintf('config/autoload/{,*.}{global,%s,local}.php', getenv('APP_ENV') ?: 'production')
],
The above will allow you to define an additional set of application configuration files per environment; furthermore, these will be loaded only if that environment is detected!
As an example, consider the following tree of configuration files:
config/
autoload/
global.php
local.php
users.development.php
users.testing.php
users.local.php
If $env
evaluates to testing
, then the following files will be merged, in the following order:
global.php
users.testing.php
local.php
users.local.php
Note that users.development.php
is not loaded — this is because it will not match the glob pattern!
Also, because of the order in which they are loaded, you can predict which values will overwrite the others, allowing you to both selectively overwrite as well as debug later.
Order of config merging
The files under
config/autoload/
are merged after your module configuration, detailed in next section. We have detailed it here, however, as setting up the application configuration glob path happens within thesystem configuration (config/application.config.php
).
Module Configuration
One responsibility of modules is to provide their own configuration to the application. Modules have two general mechanisms for doing this.
First, modules that either implementZend\ModuleManager\Feature\ConfigProviderInterface
and/or a getConfig()
method can return their configuration. The default, recommended implementation of the getConfig()
method is:
public function getConfig()
{
return include __DIR__ . '/config/module.config.php';
}
where module.config.php
returns a PHP array. From that PHP array you can provide general configuration as well as configuration for all the availableManager
classes provided by the ServiceManager. Please refer to theConfiguration mapping table to see which configuration key is used for each specific Manager
.
Second, modules can implement a number of interfaces and/or methods related to specific service manager or plugin manager configuration. You will find an overview of all interfaces and their matching Module Configuration functions inside the Configuration mapping table.
Most interfaces are in the Zend\ModuleManager\Feature
namespace (some have moved to the individual components), and each is expected to return an array of configuration for a service manager, as denoted in the section on default service configuration.
Configuration mapping table
Manager name | Interface name | Module method name | Config key name |
---|---|---|---|
ControllerPluginManager |
ControllerPluginProviderInterface |
getControllerPluginConfig() |
controller_plugins |
ControllerManager |
ControllerProviderInterface |
getControllerConfig() |
controllers |
FilterManager |
FilterProviderInterface |
getFilterConfig() |
filters |
FormElementManager |
FormElementProviderInterface |
getFormElementConfig() |
form_elements |
HydratorManager |
HydratorProviderInterface |
getHydratorConfig() |
hydrators |
InputFilterManager |
InputFilterProviderInterface |
getInputFilterConfig() |
input_filters |
RoutePluginManager |
RouteProviderInterface |
getRouteConfig() |
route_manager |
SerializerAdapterManager |
SerializerProviderInterface |
getSerializerConfig() |
serializers |
ServiceLocator |
ServiceProviderInterface |
getServiceConfig() |
service_manager |
ValidatorManager |
ValidatorProviderInterface |
getValidatorConfig() |
validators |
ViewHelperManager |
ViewHelperProviderInterface |
getViewHelperConfig() |
view_helpers |
LogProcessorManager |
LogProcessorProviderInterface |
getLogProcessorConfig |
log_processors |
LogWriterManager |
LogWriterProviderInterface |
getLogWriterConfig |
log_writers |
Configuration Priority
Considering that you may have service configuration in your module configuration file, what has precedence?
The order in which they are merged is:
- configuration returned by the various service configuration methods in a module class
- configuration returned by
getConfig()
In other words, your getConfig()
wins over the various service configuration methods. Additionally, and of particular note: the configuration returned from those methods will not be cached.
Use cases for service configuration methods
Use the various service configuration methods when you need to define closures or instance callbacks for factories, abstract factories, and initializers. This prevents caching problems, and also allows you to write your configuration files in other markup formats.
Manipulating merged configuration
Occasionally you will want to not just override an application configuration key, but actually remove it. Since merging will not remove keys, how can you handle this?
Zend\ModuleManager\Listener\ConfigListener
triggers a special event,Zend\ModuleManager\ModuleEvent::EVENT_MERGE_CONFIG
, after merging all configuration, but prior to it being passed to the ServiceManager
. By listening to this event, you can inspect the merged configuration and manipulate it.
The ConfigListener
itself listens to the event at priority 1000 (i.e., very high), which is when the configuration is merged. You can tie into this to modify the merged configuration from your module, via the init()
method.
namespace Foo;
use Zend\ModuleManager\ModuleEvent;
use Zend\ModuleManager\ModuleManager;
class Module
{
public function init(ModuleManager $moduleManager)
{
$events = $moduleManager->getEventManager();
// Registering a listener at default priority, 1, which will trigger
// after the ConfigListener merges config.
$events->attach(ModuleEvent::EVENT_MERGE_CONFIG, array($this, 'onMergeConfig'));
}
public function onMergeConfig(ModuleEvent $e)
{
$configListener = $e->getConfigListener();
$config = $configListener->getMergedConfig(false);
// Modify the configuration; here, we'll remove a specific key:
if (isset($config['some_key'])) {
unset($config['some_key']);
}
// Pass the changed configuration back to the listener:
$configListener->setMergedConfig($config);
}
}
At this point, the merged application configuration will no longer contain the key some_key
.
Cached configuration and merging
If a cached config is used by the
ModuleManager
, theEVENT_MERGE_CONFIG
event will not be triggered. However, typically that means that what is cached will be what was originally manipulated by your listener.
Configuration merging workflow
To cap off the tutorial, let's review how and when configuration is defined and merged.
- System configuration
- Defined in
config/application.config.php
- No merging occurs
- Allows manipulation programmatically, which allows the ability to:
- Alter flags based on computed values
- Alter the configuration glob path based on computed values
- Configuration is passed to the
Application
instance, and then theModuleManager
in order to initialize the system.
- Application configuration
- The
ModuleManager
loops through each module class in the order defined in the system configuration- Service configuration defined in
Module
class methods is aggregated - Configuration returned by
Module::getConfig()
is aggregated - Files detected from the service configuration
config_glob_paths
setting are merged, based on the order they resolve in the glob path. ConfigListener
triggersEVENT_MERGE_CONFIG
:ConfigListener
merges configuration- Any other event listeners manipulate the configuration
- Merged configuration is finally passed to the
ServiceManager
- Service configuration defined in
Advanced Configuration Tricks的更多相关文章
- openwrt advanced configuration
openwrt高级配置(汗 照着标题就翻译过来了) openwrt Kamikaze 8.09的一般配置文件都在目录 /etc/config 下面,可以使用脚本来调用参数和设置参数. 比如 sbin/ ...
- Bing Advanced Search Tricks You Should Know
Bing is one of the world's most popular search engines that has gained many fans with its ease of us ...
- Google Analytics Advanced Configuration - Google Analytics 高级配置
该文档提供了Android SDK v3的部分元素的高级配置说明. Overview - 概述 Android Google Analytics SDK提供了Tracker类,应用可以用它给Googl ...
- Nginx - Configuration File Syntax
Configuration Directives The Nginx configuration file can be described as a list of directives organ ...
- Jmeter-Maven-Plugin高级应用:Remote Server Configuration
Remote Server Configuration Pages 12 Home Adding additional libraries to the classpath Advanced Conf ...
- Jmeter-Maven-Plugin高级应用:Proxy Configuration
Proxy Configuration Pages 12 Home Adding additional libraries to the classpath Advanced Configuratio ...
- Spring Boot Reference Guide
Spring Boot Reference Guide Authors Phillip Webb, Dave Syer, Josh Long, Stéphane Nicoll, Rob Winch, ...
- App Distribution Guide--(三)---Configuring Your Xcode Project for Distribution
Configuring Your Xcode Project for Distribution You can edit your project settings anytime, but some ...
- gentoo 安装
加载完光驱后 1进行ping命令查看网络是否通畅 2设置硬盘的标识为GPT(主要用于64位且启动模式为UEFI,还有一个是MBR,主要用于32位且启动模式为bois) parted -a optima ...
随机推荐
- 【转】NDK上建立自己的项目
原文网址:http://www.cnblogs.com/sardine/archive/2011/07/30/2121845.html 建立Android.mk文件 ~/android-ndk/app ...
- LA3942-Remember the Word(Trie)
题意: 有s个不同的单词,给出一个长字符串把这个字符串分解成若干个单词的连接(可重复使用),有多少种分解方法 分析: dp[i]表示i开始的字符串能分解的方法数 dp[i]=sum(dp[i+len( ...
- 用JDK自带的工具生成客户端调用Webservice的代码
JAVA下客户端调用Webservice代码简直是让人心生畏惧,今日尝试,做记录如下,参考网上的众多解决方案,下面这种方式是比较简单的. 在jdk的bin目录下有一个wsimport.exe的工具,使 ...
- 如何制作网页小动画?——gif or png
一.场景与动画 为了拉动网站氛围,或者吸引用户浏览焦点,需要使用一些小动画.这种动画不是(gif)单纯的重复,而是需要需要一些控制和交互,比如在动画完成后打开一个对话框.动画有几个基本要素(时间控制, ...
- JDK1.5新特性(五)……Typesafe Enums
援引 Typesafe Enums - This flexible object-oriented enumerated type facility allows you to create enum ...
- POJ 2429
思路:a/n*b/n=lcm/gcd 所以这道题就是分解ans.dfs枚举每种素数情况.套Miller_Rabin和pollard_rho模板 //#pragma comment(linker, &q ...
- RxJava 复杂场景 Schedulers调度
参考: https://blog.piasy.com/2016/10/14/Complex-RxJava-2-scheduler/ 以Zip为例,学习Schedulers的线程调度 要求: * cre ...
- 【Hadoop代码笔记】通过JobClient对Jobtracker的调用详细了解Hadoop RPC
Hadoop的各个服务间,客户端和服务间的交互采用RPC方式.关于这种机制介绍的资源很多,也不难理解,这里不做背景介绍.只是尝试从Jobclient向JobTracker提交作业这个最简单的客户端服务 ...
- hdoj 2098 分拆素数和
分拆素数和 Time Limit: 1000/1000 MS (Java/Others) Memory Limit: 32768/32768 K (Java/Others)Total Submi ...
- CALayer精讲
前言 CALayer包含在QuartzCore框架中,这是一个跨平台的框架,既可以用在iOS中又可以用在Mac OS X中.后面要学Core Animation就应该先学好Layer(层). 我们看一 ...