-
-
Notifications
You must be signed in to change notification settings - Fork 9.6k
[RFC] [Config] Use a Factory for ConfigCache instances #7781
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Closed
Closed
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
31 changes: 31 additions & 0 deletions
31
src/Symfony/Component/Config/ConfigCacheFactoryInterface.php
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,31 @@ | ||
<?php | ||
|
||
/* | ||
* This file is part of the Symfony package. | ||
* | ||
* (c) Fabien Potencier <fabien@symfony.com> | ||
* | ||
* For the full copyright and license information, please view the LICENSE | ||
* file that was distributed with this source code. | ||
*/ | ||
|
||
namespace Symfony\Component\Config; | ||
|
||
/** | ||
* Interface for a ConfigCache factory. This factory creates | ||
* an instance of ConfigCacheInterface and initializes the | ||
* cache if necessary. | ||
* | ||
* @author Matthias Pigulla <mp@webfactory.de> | ||
*/ | ||
interface ConfigCacheFactoryInterface | ||
{ | ||
/** | ||
* Creates a cache instance and (re-)initializes it if necessary. | ||
* | ||
* @param string $file The absolute cache file path | ||
* @param callable $callable The callable to be executed when the cache needs to be filled (i. e. is not fresh). The cache will be passed as the only parameter to this callback. | ||
* @return ConfigCacheInterface $configCache The cache instance. | ||
*/ | ||
public function cache($file, $callable); | ||
} |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,44 @@ | ||
<?php | ||
|
||
/* | ||
* This file is part of the Symfony package. | ||
* | ||
* (c) Fabien Potencier <fabien@symfony.com> | ||
* | ||
* For the full copyright and license information, please view the LICENSE | ||
* file that was distributed with this source code. | ||
*/ | ||
|
||
namespace Symfony\Component\Config; | ||
|
||
/** | ||
* Interface for ConfigCache | ||
* | ||
* @author Matthias Pigulla <mp@webfactory.de> | ||
*/ | ||
interface ConfigCacheInterface | ||
{ | ||
/** | ||
* Gets the cache file path. | ||
* | ||
* @return string The cache file path | ||
*/ | ||
public function __toString(); | ||
|
||
/** | ||
* Checks if the cache is still fresh. | ||
* | ||
* @return Boolean true if the cache is fresh, false otherwise | ||
*/ | ||
public function isFresh(); | ||
|
||
/** | ||
* Writes cache. | ||
* | ||
* @param string $content The content to write into the cache | ||
* @param ResourceInterface[] $metadata An array of ResourceInterface instances | ||
* | ||
* @throws \RuntimeException When the cache file cannot be written | ||
*/ | ||
public function write($content, array $metadata = null); | ||
} |
48 changes: 48 additions & 0 deletions
48
src/Symfony/Component/Config/DefaultConfigCacheFactory.php
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,48 @@ | ||
<?php | ||
|
||
/* | ||
* This file is part of the Symfony package. | ||
* | ||
* (c) Fabien Potencier <fabien@symfony.com> | ||
* | ||
* For the full copyright and license information, please view the LICENSE | ||
* file that was distributed with this source code. | ||
*/ | ||
|
||
namespace Symfony\Component\Config; | ||
|
||
/** | ||
* Default implementation for ConfigCacheFactoryInterface | ||
* that will create an instance of ConfigCache. | ||
* | ||
* @author Matthias Pigulla <mp@webfactory.de> | ||
*/ | ||
class DefaultConfigCacheFactory implements ConfigCacheFactoryInterface | ||
{ | ||
/** @var bool Debug flag passed to the ConfigCache */ | ||
private $debug; | ||
|
||
/** | ||
* Constructor. | ||
* | ||
* @param bool $debug The debug flag to pass to ConfigCache. | ||
*/ | ||
public function __construct($debug) | ||
{ | ||
$this->debug = $debug; | ||
} | ||
|
||
/** | ||
* {@inheritdoc} | ||
*/ | ||
public function cache($file, $callback) | ||
{ | ||
$cache = new ConfigCache($file, $this->debug); | ||
|
||
if (!$cache->isFresh()) { | ||
call_user_func($callback, $cache); | ||
} | ||
|
||
return $cache; | ||
} | ||
} |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
AFAIU, this is only for BC reasons. So, it should be deprecated in 2.7 so that we can remove it in 3.0.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just to make sure I don't get you wrong: For example here __toString() is used to
require
the cache file. You want to replace this with an explicit method instead of __toString() and make that method part of the interface?There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Exactly. Having a
__toString()
method in an interface looks weird to me. So, replacing that with agetPath()
method or something similar seems better to me.