tonyair/silverstripe-framework
1
0
Fork 0
mirror of https://github.com/silverstripe/silverstripe-framework synced 2024-10-22 12:05:37 +00:00
Code Issues Projects Releases Wiki Activity

3.1 changelog improvements

Browse Source
This commit is contained in:
Ingo Schommer 2013-03-25 09:52:55 +01:00
parent 3334eafcb1
commit c8f26e673a
1 changed files with 15 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/en/changelogs/3.1.0.md
View File

@ -40,9 +40,8 @@ The configuration system added in SilverStripe 3.0 builds on this by using this
of defining the default value.
In SilverStripe 3.0, it was possible to edit this value at run-time and have the change propagate into the
configuration system. This is no longer the case, for performance reasons. If you change a static value
through direct assignment, then the configuration system will silently ignore it.
Reading a static value directly will give you stale data.
configuration system. This is no longer the case, for performance reasons. We've marked all "configurable"
statics as `private`, so you can't set or retrieve their value directly.
When using static setters or getters, the system throws a deprecation warning.
Notable exceptions to this rule are all static setters which accept objects, such as `SS_Cache::add_backend()`.
@ -60,12 +59,12 @@ Here's an example on how to rewrite a common `_config.php` configuration:
global $database;
$database = 'SS_mydb';
require_once('conf/ConfigureFromEnv.php');
SSViewer::set_theme('simple');
if(class_exists('SiteTree')) SiteTree::enable_nested_urls();
if(Director::isLive()) Email::setAdminEmail('support@mydomain.com');
if(is_defined('MY_REDIRECT_EMAILS')) Email::send_all_emails_to('developer@mydomain.com');
@ -76,7 +75,7 @@ Here's an example on how to rewrite a common `_config.php` configuration:
SSViewer::set_theme('basic');
}
The ugpraded `_config.php`:
The ugpraded `_config.php`:
:::php
<?php
@ -85,11 +84,11 @@ Here's an example on how to rewrite a common `_config.php` configuration:
global $database;
$database = 'SS_mydb';
require_once('conf/ConfigureFromEnv.php');
// Removed SiteTree::enable_nested_urls() since its configured by default
// Requires PHP objects, keep in PHP config
SS_Log::add_writer(new SS_LogFileWriter(BASE_PATH . '/mylog.log'), SS_Log::WARN);
// Non-trivial conditional, keep in PHP config
@ -98,7 +97,7 @@ Here's an example on how to rewrite a common `_config.php` configuration:
Config::inst()->update('SSViewer'. 'theme', 'basic');
}
The upgraded `config.yml`:
The upgraded `config.yml`:
:::yml
---
@ -122,6 +121,11 @@ Some examples of changed notations (not exhaustive, there's over a hundred in to
* `Director::setBaseURL`: Use `Director.alternate_base_url` instead
* `SSViewer::setOption('rewriteHashlinks', ...)`: Use `SSViewer.rewrite_hashlinks` instead
**Important**: Please remember to upgrade the installer project as well, particularly
your `.htaccess` or `web.config` files. Web access to these sensitive YAML configuration files
needs to be explicitly denied through these configuration files (see the [3.0.5 security release](/changelogs/3.0.4))
for details.
For more information about how to use the config system, see the ["Configuration" topic](/topic/configuration).
### default_cast is now Text