mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-10-22 14:05:37 +02:00
Compare commits
6 Commits
a6b0f6be15
...
985a3d3b5f
Author | SHA1 | Date | |
---|---|---|---|
|
985a3d3b5f | ||
|
8a7c70133f | ||
|
82b0851a2a | ||
|
7401bcf02e | ||
|
969d7b4bd2 | ||
|
8ec068f3fd |
@ -36,8 +36,9 @@
|
|||||||
"psr/container": "^1.1 || ^2.0",
|
"psr/container": "^1.1 || ^2.0",
|
||||||
"psr/http-message": "^1",
|
"psr/http-message": "^1",
|
||||||
"sebastian/diff": "^4.0",
|
"sebastian/diff": "^4.0",
|
||||||
"silverstripe/config": "^2",
|
"silverstripe/config": "^2.2",
|
||||||
"silverstripe/assets": "^2.3",
|
"silverstripe/assets": "^2.3",
|
||||||
|
"silverstripe/supported-modules": "^1.1",
|
||||||
"silverstripe/vendor-plugin": "^2",
|
"silverstripe/vendor-plugin": "^2",
|
||||||
"sminnee/callbacklist": "^0.1.1",
|
"sminnee/callbacklist": "^0.1.1",
|
||||||
"symfony/cache": "^6.1",
|
"symfony/cache": "^6.1",
|
||||||
|
@ -19,7 +19,6 @@ use SilverStripe\View\TemplateGlobalProvider;
|
|||||||
*/
|
*/
|
||||||
class Controller extends RequestHandler implements TemplateGlobalProvider
|
class Controller extends RequestHandler implements TemplateGlobalProvider
|
||||||
{
|
{
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* An array of arguments extracted from the URL.
|
* An array of arguments extracted from the URL.
|
||||||
*
|
*
|
||||||
|
@ -3,11 +3,14 @@
|
|||||||
namespace SilverStripe\Dev;
|
namespace SilverStripe\Dev;
|
||||||
|
|
||||||
use BadMethodCallException;
|
use BadMethodCallException;
|
||||||
|
use RuntimeException;
|
||||||
use SilverStripe\Control\Director;
|
use SilverStripe\Control\Director;
|
||||||
use SilverStripe\Core\Environment;
|
use SilverStripe\Core\Environment;
|
||||||
use SilverStripe\Core\Injector\InjectionCreator;
|
use SilverStripe\Core\Injector\InjectionCreator;
|
||||||
use SilverStripe\Core\Injector\InjectorLoader;
|
use SilverStripe\Core\Injector\InjectorLoader;
|
||||||
use SilverStripe\Core\Manifest\Module;
|
use SilverStripe\Core\Manifest\Module;
|
||||||
|
use SilverStripe\Core\Path;
|
||||||
|
use SilverStripe\SupportedModules\MetaData;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Handles raising an notice when accessing a deprecated method, class, configuration, or behaviour.
|
* Handles raising an notice when accessing a deprecated method, class, configuration, or behaviour.
|
||||||
@ -77,6 +80,18 @@ class Deprecation
|
|||||||
*/
|
*/
|
||||||
private static bool $showNoReplacementNotices = false;
|
private static bool $showNoReplacementNotices = false;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @internal
|
||||||
|
*/
|
||||||
|
private static bool $showNoticesCalledFromSupportedCode = false;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Cache of supported module directories, read from silverstripe/supported-modules repositories.json
|
||||||
|
*
|
||||||
|
* @internal
|
||||||
|
*/
|
||||||
|
private static array $supportedModuleDirectories = [];
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Enable throwing deprecation warnings. By default, this excludes warnings for
|
* Enable throwing deprecation warnings. By default, this excludes warnings for
|
||||||
* deprecated code which is called by core Silverstripe modules.
|
* deprecated code which is called by core Silverstripe modules.
|
||||||
@ -146,6 +161,12 @@ class Deprecation
|
|||||||
if (!$level) {
|
if (!$level) {
|
||||||
$level = 1;
|
$level = 1;
|
||||||
}
|
}
|
||||||
|
$called = Deprecation::get_called_from_trace($backtrace, $level);
|
||||||
|
return ($called['class'] ?? '') . ($called['type'] ?? '') . ($called['function'] ?? '');
|
||||||
|
}
|
||||||
|
|
||||||
|
private static function get_called_from_trace(array $backtrace, int $level): array
|
||||||
|
{
|
||||||
$newLevel = $level;
|
$newLevel = $level;
|
||||||
// handle closures inside withSuppressedNotice()
|
// handle closures inside withSuppressedNotice()
|
||||||
if (Deprecation::$insideNoticeSuppression
|
if (Deprecation::$insideNoticeSuppression
|
||||||
@ -163,8 +184,51 @@ class Deprecation
|
|||||||
if ($level == 4 && ($backtrace[$newLevel]['class'] ?? '') === InjectionCreator::class) {
|
if ($level == 4 && ($backtrace[$newLevel]['class'] ?? '') === InjectionCreator::class) {
|
||||||
$newLevel = $newLevel + 4;
|
$newLevel = $newLevel + 4;
|
||||||
}
|
}
|
||||||
|
// handle noticeWithNoReplacment()
|
||||||
|
foreach ($backtrace as $trace) {
|
||||||
|
if (($trace['class'] ?? '') === Deprecation::class
|
||||||
|
&& ($trace['function'] ?? '') === 'noticeWithNoReplacment'
|
||||||
|
) {
|
||||||
|
$newLevel = $newLevel + 1;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
$called = $backtrace[$newLevel] ?? [];
|
$called = $backtrace[$newLevel] ?? [];
|
||||||
return ($called['class'] ?? '') . ($called['type'] ?? '') . ($called['function'] ?? '');
|
return $called;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static function isCalledFromSupportedCode(array $backtrace): bool
|
||||||
|
{
|
||||||
|
$called = Deprecation::get_called_from_trace($backtrace, 1);
|
||||||
|
$file = $called['file'] ?? '';
|
||||||
|
if (!$file) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
return Deprecation::fileIsInSupportedModule($file);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Check whether a file (path to file) is in a supported module
|
||||||
|
*/
|
||||||
|
public static function fileIsInSupportedModule(string $file): bool
|
||||||
|
{
|
||||||
|
// Cache the supported modules list
|
||||||
|
if (count(Deprecation::$supportedModuleDirectories) === 0) {
|
||||||
|
// Do not make a network request when fetching metadata which could slow down a website
|
||||||
|
// While there is a small risk of the list being out of date, there is minimal downside to this
|
||||||
|
$metaData = MetaData::getAllRepositoryMetaData(fromRemote: false);
|
||||||
|
$dirs = array_map(fn($module) => "/vendor/{$module['packagist']}/", $metaData['supportedModules']);
|
||||||
|
// This is a special case for silverstripe-framework when running in CI
|
||||||
|
// Needed because module is run in the root folder rather than in the vendor folder
|
||||||
|
$dirs[] = '/silverstripe-framework/';
|
||||||
|
Deprecation::$supportedModuleDirectories = $dirs;
|
||||||
|
}
|
||||||
|
foreach (Deprecation::$supportedModuleDirectories as $dir) {
|
||||||
|
if (str_contains($file, $dir)) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false;
|
||||||
}
|
}
|
||||||
|
|
||||||
public static function isEnabled(): bool
|
public static function isEnabled(): bool
|
||||||
@ -245,6 +309,22 @@ class Deprecation
|
|||||||
return Deprecation::$shouldShowForCli;
|
return Deprecation::$shouldShowForCli;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* If true, deprecation warnings will be shown for deprecated code which is called by core Silverstripe modules.
|
||||||
|
*/
|
||||||
|
public static function getShowNoticesCalledFromSupportedCode(): bool
|
||||||
|
{
|
||||||
|
return Deprecation::$showNoticesCalledFromSupportedCode;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Set whether deprecation warnings will be shown for deprecated code which is called by core Silverstripe modules.
|
||||||
|
*/
|
||||||
|
public static function setShowNoticesCalledFromSupportedCode(bool $value): void
|
||||||
|
{
|
||||||
|
Deprecation::$showNoticesCalledFromSupportedCode = $value;
|
||||||
|
}
|
||||||
|
|
||||||
public static function outputNotices(): void
|
public static function outputNotices(): void
|
||||||
{
|
{
|
||||||
if (!Deprecation::isEnabled()) {
|
if (!Deprecation::isEnabled()) {
|
||||||
@ -258,9 +338,13 @@ class Deprecation
|
|||||||
$arr = array_shift(Deprecation::$userErrorMessageBuffer);
|
$arr = array_shift(Deprecation::$userErrorMessageBuffer);
|
||||||
$message = $arr['message'];
|
$message = $arr['message'];
|
||||||
$calledWithNoticeSuppression = $arr['calledWithNoticeSuppression'];
|
$calledWithNoticeSuppression = $arr['calledWithNoticeSuppression'];
|
||||||
|
$isCalledFromSupportedCode = $arr['isCalledFromSupportedCode'];
|
||||||
if ($calledWithNoticeSuppression && !Deprecation::$showNoReplacementNotices) {
|
if ($calledWithNoticeSuppression && !Deprecation::$showNoReplacementNotices) {
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
if ($isCalledFromSupportedCode && !Deprecation::$showNoticesCalledFromSupportedCode) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
Deprecation::$isTriggeringError = true;
|
Deprecation::$isTriggeringError = true;
|
||||||
user_error($message, E_USER_DEPRECATED);
|
user_error($message, E_USER_DEPRECATED);
|
||||||
Deprecation::$isTriggeringError = false;
|
Deprecation::$isTriggeringError = false;
|
||||||
@ -294,6 +378,10 @@ class Deprecation
|
|||||||
$data = [
|
$data = [
|
||||||
'key' => sha1($string),
|
'key' => sha1($string),
|
||||||
'message' => $string,
|
'message' => $string,
|
||||||
|
// Setting to `false` as here as any SCOPE_CONFIG notices from supported modules have
|
||||||
|
// already been filtered out if needed if they came from a supported module in
|
||||||
|
// SilverStripe\Config\Transformer\YamlTransformer::checkForDeprecatedConfig()
|
||||||
|
'isCalledFromSupportedCode' => false,
|
||||||
'calledWithNoticeSuppression' => Deprecation::$insideNoticeSuppression
|
'calledWithNoticeSuppression' => Deprecation::$insideNoticeSuppression
|
||||||
];
|
];
|
||||||
} else {
|
} else {
|
||||||
@ -322,13 +410,13 @@ class Deprecation
|
|||||||
|
|
||||||
$level = Deprecation::$insideNoticeSuppression ? 4 : 2;
|
$level = Deprecation::$insideNoticeSuppression ? 4 : 2;
|
||||||
$string .= " Called from " . Deprecation::get_called_method_from_trace($backtrace, $level) . '.';
|
$string .= " Called from " . Deprecation::get_called_method_from_trace($backtrace, $level) . '.';
|
||||||
|
|
||||||
if ($caller) {
|
if ($caller) {
|
||||||
$string = $caller . ' is deprecated.' . ($string ? ' ' . $string : '');
|
$string = $caller . ' is deprecated.' . ($string ? ' ' . $string : '');
|
||||||
}
|
}
|
||||||
$data = [
|
$data = [
|
||||||
'key' => sha1($string),
|
'key' => sha1($string),
|
||||||
'message' => $string,
|
'message' => $string,
|
||||||
|
'isCalledFromSupportedCode' => Deprecation::isCalledFromSupportedCode($backtrace),
|
||||||
'calledWithNoticeSuppression' => Deprecation::$insideNoticeSuppression
|
'calledWithNoticeSuppression' => Deprecation::$insideNoticeSuppression
|
||||||
];
|
];
|
||||||
}
|
}
|
||||||
@ -360,6 +448,23 @@ class Deprecation
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Shorthand method to create a suppressed notice for something with no immediate replacement.
|
||||||
|
* If $message is empty, then a standardised message will be used
|
||||||
|
*/
|
||||||
|
public static function noticeWithNoReplacment(
|
||||||
|
string $atVersion,
|
||||||
|
string $message = '',
|
||||||
|
int $scope = Deprecation::SCOPE_METHOD
|
||||||
|
): void {
|
||||||
|
if ($message === '') {
|
||||||
|
$message = 'Will be removed without equivalent functionality to replace it.';
|
||||||
|
}
|
||||||
|
Deprecation::withSuppressedNotice(
|
||||||
|
fn() => Deprecation::notice($atVersion, $message, $scope)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
private static function varAsBoolean($val): bool
|
private static function varAsBoolean($val): bool
|
||||||
{
|
{
|
||||||
if (is_string($val)) {
|
if (is_string($val)) {
|
||||||
|
@ -5,6 +5,7 @@ namespace SilverStripe\Forms\GridField;
|
|||||||
use SilverStripe\Core\Convert;
|
use SilverStripe\Core\Convert;
|
||||||
use InvalidArgumentException;
|
use InvalidArgumentException;
|
||||||
use LogicException;
|
use LogicException;
|
||||||
|
use SilverStripe\Dev\Deprecation;
|
||||||
use SilverStripe\View\ViewableData;
|
use SilverStripe\View\ViewableData;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -228,9 +229,11 @@ class GridFieldDataColumns extends AbstractGridFieldComponent implements GridFie
|
|||||||
* @param ViewableData $record
|
* @param ViewableData $record
|
||||||
* @param string $columnName
|
* @param string $columnName
|
||||||
* @return string|null - returns null if it could not found a value
|
* @return string|null - returns null if it could not found a value
|
||||||
|
* @deprecated 5.4.0 Will be removed without equivalent functionality to replace it.
|
||||||
*/
|
*/
|
||||||
protected function getValueFromRelation($record, $columnName)
|
protected function getValueFromRelation($record, $columnName)
|
||||||
{
|
{
|
||||||
|
Deprecation::notice('5.4.0', 'Will be removed without equivalent functionality to replace it.');
|
||||||
$fieldNameParts = explode('.', $columnName ?? '');
|
$fieldNameParts = explode('.', $columnName ?? '');
|
||||||
$tmpItem = clone($record);
|
$tmpItem = clone($record);
|
||||||
for ($idx = 0; $idx < sizeof($fieldNameParts ?? []); $idx++) {
|
for ($idx = 0; $idx < sizeof($fieldNameParts ?? []); $idx++) {
|
||||||
|
@ -13,7 +13,8 @@ class DBBoolean extends DBField
|
|||||||
{
|
{
|
||||||
public function __construct($name = null, $defaultVal = 0)
|
public function __construct($name = null, $defaultVal = 0)
|
||||||
{
|
{
|
||||||
$this->defaultVal = ($defaultVal) ? 1 : 0;
|
$defaultValue = $defaultVal ? 1 : 0;
|
||||||
|
$this->setDefaultValue($defaultValue);
|
||||||
|
|
||||||
parent::__construct($name);
|
parent::__construct($name);
|
||||||
}
|
}
|
||||||
@ -25,7 +26,7 @@ class DBBoolean extends DBField
|
|||||||
'precision' => 1,
|
'precision' => 1,
|
||||||
'sign' => 'unsigned',
|
'sign' => 'unsigned',
|
||||||
'null' => 'not null',
|
'null' => 'not null',
|
||||||
'default' => $this->defaultVal,
|
'default' => $this->getDefaultValue(),
|
||||||
'arrayValue' => $this->arrayValue
|
'arrayValue' => $this->arrayValue
|
||||||
];
|
];
|
||||||
$values = ['type' => 'boolean', 'parts' => $parts];
|
$values = ['type' => 'boolean', 'parts' => $parts];
|
||||||
|
@ -122,6 +122,7 @@ abstract class DBField extends ViewableData implements DBIndexable
|
|||||||
* @var $default mixed Default-value in the database.
|
* @var $default mixed Default-value in the database.
|
||||||
* Might be overridden on DataObject-level, but still useful for setting defaults on
|
* Might be overridden on DataObject-level, but still useful for setting defaults on
|
||||||
* already existing records after a db-build.
|
* already existing records after a db-build.
|
||||||
|
* @deprecated 5.4.0 Use getDefaultValue() and setDefaultValue() instead
|
||||||
*/
|
*/
|
||||||
protected $defaultVal;
|
protected $defaultVal;
|
||||||
|
|
||||||
|
@ -13,7 +13,8 @@ class DBFloat extends DBField
|
|||||||
|
|
||||||
public function __construct($name = null, $defaultVal = 0)
|
public function __construct($name = null, $defaultVal = 0)
|
||||||
{
|
{
|
||||||
$this->defaultVal = is_float($defaultVal) ? $defaultVal : (float) 0;
|
$defaultValue = is_float($defaultVal) ? $defaultVal : (float) 0;
|
||||||
|
$this->setDefaultValue($defaultValue);
|
||||||
|
|
||||||
parent::__construct($name);
|
parent::__construct($name);
|
||||||
}
|
}
|
||||||
@ -23,7 +24,7 @@ class DBFloat extends DBField
|
|||||||
$parts = [
|
$parts = [
|
||||||
'datatype' => 'float',
|
'datatype' => 'float',
|
||||||
'null' => 'not null',
|
'null' => 'not null',
|
||||||
'default' => $this->defaultVal,
|
'default' => $this->getDefaultValue(),
|
||||||
'arrayValue' => $this->arrayValue
|
'arrayValue' => $this->arrayValue
|
||||||
];
|
];
|
||||||
$values = ['type' => 'float', 'parts' => $parts];
|
$values = ['type' => 'float', 'parts' => $parts];
|
||||||
|
@ -15,7 +15,8 @@ class DBInt extends DBField
|
|||||||
|
|
||||||
public function __construct($name = null, $defaultVal = 0)
|
public function __construct($name = null, $defaultVal = 0)
|
||||||
{
|
{
|
||||||
$this->defaultVal = is_int($defaultVal) ? $defaultVal : 0;
|
$defaultValue = is_int($defaultVal) ? $defaultVal : 0;
|
||||||
|
$this->setDefaultValue($defaultValue);
|
||||||
|
|
||||||
parent::__construct($name);
|
parent::__construct($name);
|
||||||
}
|
}
|
||||||
@ -43,7 +44,7 @@ class DBInt extends DBField
|
|||||||
'datatype' => 'int',
|
'datatype' => 'int',
|
||||||
'precision' => 11,
|
'precision' => 11,
|
||||||
'null' => 'not null',
|
'null' => 'not null',
|
||||||
'default' => $this->defaultVal,
|
'default' => $this->getDefaultValue(),
|
||||||
'arrayValue' => $this->arrayValue
|
'arrayValue' => $this->arrayValue
|
||||||
];
|
];
|
||||||
$values = ['type' => 'int', 'parts' => $parts];
|
$values = ['type' => 'int', 'parts' => $parts];
|
||||||
|
@ -948,7 +948,7 @@ class SSTemplateParser extends Parser implements TemplateParser
|
|||||||
$arguments = $res['arguments'];
|
$arguments = $res['arguments'];
|
||||||
|
|
||||||
// Note: 'type' here is important to disable subTemplates in SSViewer::getSubtemplateFor()
|
// Note: 'type' here is important to disable subTemplates in SSViewer::getSubtemplateFor()
|
||||||
$res['php'] = '$val .= \\SilverStripe\\View\\SSViewer::execute_template([["type" => "Includes", '.$template.'], '.$template.'], $scope->getItem(), [' .
|
$res['php'] = '$val .= \\SilverStripe\\View\\SSViewer::execute_template([["type" => "Includes", '.$template.'], '.$template.'], $scope->getCurrentItem(), [' .
|
||||||
implode(',', $arguments)."], \$scope, true);\n";
|
implode(',', $arguments)."], \$scope, true);\n";
|
||||||
|
|
||||||
if ($this->includeDebuggingComments) { // Add include filename comments on dev sites
|
if ($this->includeDebuggingComments) { // Add include filename comments on dev sites
|
||||||
|
@ -3897,7 +3897,7 @@ class SSTemplateParser extends Parser implements TemplateParser
|
|||||||
$arguments = $res['arguments'];
|
$arguments = $res['arguments'];
|
||||||
|
|
||||||
// Note: 'type' here is important to disable subTemplates in SSViewer::getSubtemplateFor()
|
// Note: 'type' here is important to disable subTemplates in SSViewer::getSubtemplateFor()
|
||||||
$res['php'] = '$val .= \\SilverStripe\\View\\SSViewer::execute_template([["type" => "Includes", '.$template.'], '.$template.'], $scope->getItem(), [' .
|
$res['php'] = '$val .= \\SilverStripe\\View\\SSViewer::execute_template([["type" => "Includes", '.$template.'], '.$template.'], $scope->getCurrentItem(), [' .
|
||||||
implode(',', $arguments)."], \$scope, true);\n";
|
implode(',', $arguments)."], \$scope, true);\n";
|
||||||
|
|
||||||
if ($this->includeDebuggingComments) { // Add include filename comments on dev sites
|
if ($this->includeDebuggingComments) { // Add include filename comments on dev sites
|
||||||
|
@ -15,6 +15,7 @@ use SilverStripe\ORM\FieldType\DBField;
|
|||||||
use SilverStripe\ORM\FieldType\DBHTMLText;
|
use SilverStripe\ORM\FieldType\DBHTMLText;
|
||||||
use SilverStripe\Security\Permission;
|
use SilverStripe\Security\Permission;
|
||||||
use InvalidArgumentException;
|
use InvalidArgumentException;
|
||||||
|
use SilverStripe\Dev\Deprecation;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Parses a template file with an *.ss file extension.
|
* Parses a template file with an *.ss file extension.
|
||||||
@ -86,6 +87,7 @@ class SSViewer implements Flushable
|
|||||||
*
|
*
|
||||||
* @config
|
* @config
|
||||||
* @var string
|
* @var string
|
||||||
|
* @deprecated 5.4.0 Will be moved to SilverStripe\View\SSTemplateEngine.global_key
|
||||||
*/
|
*/
|
||||||
private static $global_key = '$CurrentReadingMode, $CurrentUser.ID';
|
private static $global_key = '$CurrentReadingMode, $CurrentUser.ID';
|
||||||
|
|
||||||
@ -134,6 +136,7 @@ class SSViewer implements Flushable
|
|||||||
* List of items being processed
|
* List of items being processed
|
||||||
*
|
*
|
||||||
* @var array
|
* @var array
|
||||||
|
* @deprecated 5.4.0 Will be moved to SilverStripe\View\SSTemplateEngine
|
||||||
*/
|
*/
|
||||||
protected static $topLevel = [];
|
protected static $topLevel = [];
|
||||||
|
|
||||||
@ -141,6 +144,7 @@ class SSViewer implements Flushable
|
|||||||
* List of templates to select from
|
* List of templates to select from
|
||||||
*
|
*
|
||||||
* @var array
|
* @var array
|
||||||
|
* @deprecated 5.4.0 Will be moved to SilverStripe\View\SSTemplateEngine
|
||||||
*/
|
*/
|
||||||
protected $templates = null;
|
protected $templates = null;
|
||||||
|
|
||||||
@ -148,6 +152,7 @@ class SSViewer implements Flushable
|
|||||||
* Absolute path to chosen template file
|
* Absolute path to chosen template file
|
||||||
*
|
*
|
||||||
* @var string
|
* @var string
|
||||||
|
* @deprecated 5.4.0 Will be moved to SilverStripe\View\SSTemplateEngine
|
||||||
*/
|
*/
|
||||||
protected $chosen = null;
|
protected $chosen = null;
|
||||||
|
|
||||||
@ -155,6 +160,7 @@ class SSViewer implements Flushable
|
|||||||
* Templates to use when looking up 'Layout' or 'Content'
|
* Templates to use when looking up 'Layout' or 'Content'
|
||||||
*
|
*
|
||||||
* @var array
|
* @var array
|
||||||
|
* @deprecated 5.4.0 Will be moved to SilverStripe\View\SSTemplateEngine
|
||||||
*/
|
*/
|
||||||
protected $subTemplates = [];
|
protected $subTemplates = [];
|
||||||
|
|
||||||
@ -165,11 +171,13 @@ class SSViewer implements Flushable
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* @var TemplateParser
|
* @var TemplateParser
|
||||||
|
* @deprecated 5.4.0 Will be moved to SilverStripe\View\SSTemplateEngine
|
||||||
*/
|
*/
|
||||||
protected $parser;
|
protected $parser;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @var CacheInterface
|
* @var CacheInterface
|
||||||
|
* @deprecated 5.4.0 Will be moved to SilverStripe\View\SSTemplateEngine
|
||||||
*/
|
*/
|
||||||
protected $partialCacheStore = null;
|
protected $partialCacheStore = null;
|
||||||
|
|
||||||
@ -185,6 +193,7 @@ class SSViewer implements Flushable
|
|||||||
public function __construct($templates, TemplateParser $parser = null)
|
public function __construct($templates, TemplateParser $parser = null)
|
||||||
{
|
{
|
||||||
if ($parser) {
|
if ($parser) {
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'The $parser parameter is deprecated and will be removed');
|
||||||
$this->setParser($parser);
|
$this->setParser($parser);
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -207,9 +216,11 @@ class SSViewer implements Flushable
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* Triggered early in the request when someone requests a flush.
|
* Triggered early in the request when someone requests a flush.
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::flush()
|
||||||
*/
|
*/
|
||||||
public static function flush()
|
public static function flush()
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::flush()');
|
||||||
SSViewer::flush_template_cache(true);
|
SSViewer::flush_template_cache(true);
|
||||||
SSViewer::flush_cacheblock_cache(true);
|
SSViewer::flush_cacheblock_cache(true);
|
||||||
}
|
}
|
||||||
@ -220,9 +231,11 @@ class SSViewer implements Flushable
|
|||||||
* @param string $content The template content
|
* @param string $content The template content
|
||||||
* @param bool|void $cacheTemplate Whether or not to cache the template from string
|
* @param bool|void $cacheTemplate Whether or not to cache the template from string
|
||||||
* @return SSViewer
|
* @return SSViewer
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::renderString()
|
||||||
*/
|
*/
|
||||||
public static function fromString($content, $cacheTemplate = null)
|
public static function fromString($content, $cacheTemplate = null)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::renderString()');
|
||||||
$viewer = SSViewer_FromString::create($content);
|
$viewer = SSViewer_FromString::create($content);
|
||||||
if ($cacheTemplate !== null) {
|
if ($cacheTemplate !== null) {
|
||||||
$viewer->setCacheTemplate($cacheTemplate);
|
$viewer->setCacheTemplate($cacheTemplate);
|
||||||
@ -325,9 +338,11 @@ class SSViewer implements Flushable
|
|||||||
* Get the current item being processed
|
* Get the current item being processed
|
||||||
*
|
*
|
||||||
* @return ViewableData
|
* @return ViewableData
|
||||||
|
* @deprecated 5.4.0 Will be removed without equivalent functionality to replace it.
|
||||||
*/
|
*/
|
||||||
public static function topLevel()
|
public static function topLevel()
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be removed without equivalent functionality to replace it.');
|
||||||
if (SSViewer::$topLevel) {
|
if (SSViewer::$topLevel) {
|
||||||
return SSViewer::$topLevel[sizeof(SSViewer::$topLevel)-1];
|
return SSViewer::$topLevel[sizeof(SSViewer::$topLevel)-1];
|
||||||
}
|
}
|
||||||
@ -385,9 +400,11 @@ class SSViewer implements Flushable
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* @param string|array $templates
|
* @param string|array $templates
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::setTemplate()
|
||||||
*/
|
*/
|
||||||
public function setTemplate($templates)
|
public function setTemplate($templates)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::setTemplate()');
|
||||||
$this->templates = $templates;
|
$this->templates = $templates;
|
||||||
$this->chosen = $this->chooseTemplate($templates);
|
$this->chosen = $this->chooseTemplate($templates);
|
||||||
$this->subTemplates = [];
|
$this->subTemplates = [];
|
||||||
@ -398,9 +415,11 @@ class SSViewer implements Flushable
|
|||||||
*
|
*
|
||||||
* @param array|string $templates
|
* @param array|string $templates
|
||||||
* @return string
|
* @return string
|
||||||
|
* @deprecated 5.4.0 Will be removed without equivalent functionality to replace it
|
||||||
*/
|
*/
|
||||||
public static function chooseTemplate($templates)
|
public static function chooseTemplate($templates)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be removed without equivalent functionality to replace it');
|
||||||
return ThemeResourceLoader::inst()->findTemplate($templates, SSViewer::get_themes());
|
return ThemeResourceLoader::inst()->findTemplate($templates, SSViewer::get_themes());
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -408,9 +427,11 @@ class SSViewer implements Flushable
|
|||||||
* Set the template parser that will be used in template generation
|
* Set the template parser that will be used in template generation
|
||||||
*
|
*
|
||||||
* @param TemplateParser $parser
|
* @param TemplateParser $parser
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::setParser()
|
||||||
*/
|
*/
|
||||||
public function setParser(TemplateParser $parser)
|
public function setParser(TemplateParser $parser)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::setParser()');
|
||||||
$this->parser = $parser;
|
$this->parser = $parser;
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -418,9 +439,11 @@ class SSViewer implements Flushable
|
|||||||
* Returns the parser that is set for template generation
|
* Returns the parser that is set for template generation
|
||||||
*
|
*
|
||||||
* @return TemplateParser
|
* @return TemplateParser
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::getParser()
|
||||||
*/
|
*/
|
||||||
public function getParser()
|
public function getParser()
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::getParser()');
|
||||||
if (!$this->parser) {
|
if (!$this->parser) {
|
||||||
$this->setParser(Injector::inst()->get('SilverStripe\\View\\SSTemplateParser'));
|
$this->setParser(Injector::inst()->get('SilverStripe\\View\\SSTemplateParser'));
|
||||||
}
|
}
|
||||||
@ -433,9 +456,11 @@ class SSViewer implements Flushable
|
|||||||
* @param array|string $templates
|
* @param array|string $templates
|
||||||
*
|
*
|
||||||
* @return bool
|
* @return bool
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::hasTemplate()
|
||||||
*/
|
*/
|
||||||
public static function hasTemplate($templates)
|
public static function hasTemplate($templates)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::hasTemplate()');
|
||||||
return (bool)ThemeResourceLoader::inst()->findTemplate($templates, SSViewer::get_themes());
|
return (bool)ThemeResourceLoader::inst()->findTemplate($templates, SSViewer::get_themes());
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -452,9 +477,11 @@ class SSViewer implements Flushable
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* @return string
|
* @return string
|
||||||
|
* @deprecated 5.4.0 Will be removed without equivalent functionality to replace it
|
||||||
*/
|
*/
|
||||||
public function exists()
|
public function exists()
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be removed without equivalent functionality to replace it');
|
||||||
return $this->chosen;
|
return $this->chosen;
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -462,9 +489,11 @@ class SSViewer implements Flushable
|
|||||||
* @param string $identifier A template name without '.ss' extension or path
|
* @param string $identifier A template name without '.ss' extension or path
|
||||||
* @param string $type The template type, either "main", "Includes" or "Layout"
|
* @param string $type The template type, either "main", "Includes" or "Layout"
|
||||||
* @return string Full system path to a template file
|
* @return string Full system path to a template file
|
||||||
|
* @deprecated 5.4.0 Will be removed without equivalent functionality to replace it
|
||||||
*/
|
*/
|
||||||
public static function getTemplateFileByType($identifier, $type = null)
|
public static function getTemplateFileByType($identifier, $type = null)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be removed without equivalent functionality to replace it');
|
||||||
return ThemeResourceLoader::inst()->findTemplate(['type' => $type, $identifier], SSViewer::get_themes());
|
return ThemeResourceLoader::inst()->findTemplate(['type' => $type, $identifier], SSViewer::get_themes());
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -475,9 +504,11 @@ class SSViewer implements Flushable
|
|||||||
*
|
*
|
||||||
* @param bool $force Set this to true to force a re-flush. If left to false, flushing
|
* @param bool $force Set this to true to force a re-flush. If left to false, flushing
|
||||||
* may only be performed once a request.
|
* may only be performed once a request.
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::flushTemplateCache()
|
||||||
*/
|
*/
|
||||||
public static function flush_template_cache($force = false)
|
public static function flush_template_cache($force = false)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::flushTemplateCache()');
|
||||||
if (!SSViewer::$template_cache_flushed || $force) {
|
if (!SSViewer::$template_cache_flushed || $force) {
|
||||||
$dir = dir(TEMP_PATH);
|
$dir = dir(TEMP_PATH);
|
||||||
while (false !== ($file = $dir->read())) {
|
while (false !== ($file = $dir->read())) {
|
||||||
@ -496,9 +527,11 @@ class SSViewer implements Flushable
|
|||||||
*
|
*
|
||||||
* @param bool $force Set this to true to force a re-flush. If left to false, flushing
|
* @param bool $force Set this to true to force a re-flush. If left to false, flushing
|
||||||
* may only be performed once a request.
|
* may only be performed once a request.
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::flushCacheBlockCache()
|
||||||
*/
|
*/
|
||||||
public static function flush_cacheblock_cache($force = false)
|
public static function flush_cacheblock_cache($force = false)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::flushCacheBlockCache()');
|
||||||
if (!SSViewer::$cacheblock_cache_flushed || $force) {
|
if (!SSViewer::$cacheblock_cache_flushed || $force) {
|
||||||
$cache = Injector::inst()->get(CacheInterface::class . '.cacheblock');
|
$cache = Injector::inst()->get(CacheInterface::class . '.cacheblock');
|
||||||
$cache->clear();
|
$cache->clear();
|
||||||
@ -512,9 +545,11 @@ class SSViewer implements Flushable
|
|||||||
* Set the cache object to use when storing / retrieving partial cache blocks.
|
* Set the cache object to use when storing / retrieving partial cache blocks.
|
||||||
*
|
*
|
||||||
* @param CacheInterface $cache
|
* @param CacheInterface $cache
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::setPartialCacheStore()
|
||||||
*/
|
*/
|
||||||
public function setPartialCacheStore($cache)
|
public function setPartialCacheStore($cache)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::setPartialCacheStore()');
|
||||||
$this->partialCacheStore = $cache;
|
$this->partialCacheStore = $cache;
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -522,9 +557,11 @@ class SSViewer implements Flushable
|
|||||||
* Get the cache object to use when storing / retrieving partial cache blocks.
|
* Get the cache object to use when storing / retrieving partial cache blocks.
|
||||||
*
|
*
|
||||||
* @return CacheInterface
|
* @return CacheInterface
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::getPartialCacheStore()
|
||||||
*/
|
*/
|
||||||
public function getPartialCacheStore()
|
public function getPartialCacheStore()
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::getPartialCacheStore()');
|
||||||
if ($this->partialCacheStore) {
|
if ($this->partialCacheStore) {
|
||||||
return $this->partialCacheStore;
|
return $this->partialCacheStore;
|
||||||
}
|
}
|
||||||
@ -552,11 +589,13 @@ class SSViewer implements Flushable
|
|||||||
* @param ViewableData $item The item to use as the root scope for the template
|
* @param ViewableData $item The item to use as the root scope for the template
|
||||||
* @param array $overlay Any variables to layer on top of the scope
|
* @param array $overlay Any variables to layer on top of the scope
|
||||||
* @param array $underlay Any variables to layer underneath the scope
|
* @param array $underlay Any variables to layer underneath the scope
|
||||||
* @param ViewableData $inheritedScope The current scope of a parent template including a sub-template
|
* @param SSViewer_Scope|null $inheritedScope The current scope of a parent template including a sub-template
|
||||||
* @return string The result of executing the template
|
* @return string The result of executing the template
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::includeGeneratedTemplate()
|
||||||
*/
|
*/
|
||||||
protected function includeGeneratedTemplate($cacheFile, $item, $overlay, $underlay, $inheritedScope = null)
|
protected function includeGeneratedTemplate($cacheFile, $item, $overlay, $underlay, $inheritedScope = null)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::includeGeneratedTemplate()');
|
||||||
if (isset($_GET['showtemplate']) && $_GET['showtemplate'] && Permission::check('ADMIN')) {
|
if (isset($_GET['showtemplate']) && $_GET['showtemplate'] && Permission::check('ADMIN')) {
|
||||||
$lines = file($cacheFile ?? '');
|
$lines = file($cacheFile ?? '');
|
||||||
echo "<h2>Template: $cacheFile</h2>";
|
echo "<h2>Template: $cacheFile</h2>";
|
||||||
@ -596,6 +635,9 @@ class SSViewer implements Flushable
|
|||||||
*/
|
*/
|
||||||
public function process($item, $arguments = null, $inheritedScope = null)
|
public function process($item, $arguments = null, $inheritedScope = null)
|
||||||
{
|
{
|
||||||
|
if ($inheritedScope !== null) {
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'The $inheritedScope parameter is deprecated and will be removed');
|
||||||
|
}
|
||||||
// Set hashlinks and temporarily modify global state
|
// Set hashlinks and temporarily modify global state
|
||||||
$rewrite = $this->getRewriteHashLinks();
|
$rewrite = $this->getRewriteHashLinks();
|
||||||
$origRewriteDefault = static::getRewriteHashLinksDefault();
|
$origRewriteDefault = static::getRewriteHashLinksDefault();
|
||||||
@ -682,9 +724,11 @@ PHP;
|
|||||||
* @param string $subtemplate Sub-template to use
|
* @param string $subtemplate Sub-template to use
|
||||||
*
|
*
|
||||||
* @return array|null
|
* @return array|null
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::getSubtemplateFor()
|
||||||
*/
|
*/
|
||||||
protected function getSubtemplateFor($subtemplate)
|
protected function getSubtemplateFor($subtemplate)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::getSubtemplateFor()');
|
||||||
// Get explicit subtemplate name
|
// Get explicit subtemplate name
|
||||||
if (isset($this->subTemplates[$subtemplate])) {
|
if (isset($this->subTemplates[$subtemplate])) {
|
||||||
return $this->subTemplates[$subtemplate];
|
return $this->subTemplates[$subtemplate];
|
||||||
@ -722,9 +766,14 @@ PHP;
|
|||||||
* @param bool $globalRequirements
|
* @param bool $globalRequirements
|
||||||
*
|
*
|
||||||
* @return string Evaluated result
|
* @return string Evaluated result
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::execute_template()
|
||||||
*/
|
*/
|
||||||
public static function execute_template($template, $data, $arguments = null, $scope = null, $globalRequirements = false)
|
public static function execute_template($template, $data, $arguments = null, $scope = null, $globalRequirements = false)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment(
|
||||||
|
'5.4.0',
|
||||||
|
'Will be replaced with SilverStripe\View\SSTemplateEngine::execute_template()'
|
||||||
|
);
|
||||||
$v = SSViewer::create($template);
|
$v = SSViewer::create($template);
|
||||||
|
|
||||||
if ($globalRequirements) {
|
if ($globalRequirements) {
|
||||||
@ -754,9 +803,11 @@ PHP;
|
|||||||
* @param bool $globalRequirements
|
* @param bool $globalRequirements
|
||||||
*
|
*
|
||||||
* @return string Evaluated result
|
* @return string Evaluated result
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::renderString()
|
||||||
*/
|
*/
|
||||||
public static function execute_string($content, $data, $arguments = null, $globalRequirements = false)
|
public static function execute_string($content, $data, $arguments = null, $globalRequirements = false)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::renderString()');
|
||||||
$v = SSViewer::fromString($content);
|
$v = SSViewer::fromString($content);
|
||||||
|
|
||||||
if ($globalRequirements) {
|
if ($globalRequirements) {
|
||||||
@ -781,9 +832,11 @@ PHP;
|
|||||||
* @param string $content The template contents
|
* @param string $content The template contents
|
||||||
* @param string $template The template file name
|
* @param string $template The template file name
|
||||||
* @return string
|
* @return string
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::parseTemplateContent()
|
||||||
*/
|
*/
|
||||||
public function parseTemplateContent($content, $template = "")
|
public function parseTemplateContent($content, $template = "")
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be replaced with SilverStripe\View\SSTemplateEngine::parseTemplateContent()');
|
||||||
return $this->getParser()->compileString(
|
return $this->getParser()->compileString(
|
||||||
$content,
|
$content,
|
||||||
$template,
|
$template,
|
||||||
@ -796,18 +849,22 @@ PHP;
|
|||||||
* 'Content' & 'Layout', and will have to contain 'main'
|
* 'Content' & 'Layout', and will have to contain 'main'
|
||||||
*
|
*
|
||||||
* @return array
|
* @return array
|
||||||
|
* @deprecated 5.4.0 Will be removed without equivalent functionality to replace it
|
||||||
*/
|
*/
|
||||||
public function templates()
|
public function templates()
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be removed without equivalent functionality to replace it');
|
||||||
return array_merge(['main' => $this->chosen], $this->subTemplates);
|
return array_merge(['main' => $this->chosen], $this->subTemplates);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @param string $type "Layout" or "main"
|
* @param string $type "Layout" or "main"
|
||||||
* @param string $file Full system path to the template file
|
* @param string $file Full system path to the template file
|
||||||
|
* @deprecated 5.4.0 Will be removed without equivalent functionality to replace it
|
||||||
*/
|
*/
|
||||||
public function setTemplateFile($type, $file)
|
public function setTemplateFile($type, $file)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be removed without equivalent functionality to replace it');
|
||||||
if (!$type || $type == 'main') {
|
if (!$type || $type == 'main') {
|
||||||
$this->chosen = $file;
|
$this->chosen = $file;
|
||||||
} else {
|
} else {
|
||||||
@ -822,17 +879,29 @@ PHP;
|
|||||||
* @param string $contentGeneratedSoFar The content of the template generated so far; it should contain
|
* @param string $contentGeneratedSoFar The content of the template generated so far; it should contain
|
||||||
* the DOCTYPE declaration.
|
* the DOCTYPE declaration.
|
||||||
* @return string
|
* @return string
|
||||||
|
* @deprecated 5.4.0 Use getBaseTag() instead
|
||||||
*/
|
*/
|
||||||
public static function get_base_tag($contentGeneratedSoFar)
|
public static function get_base_tag($contentGeneratedSoFar)
|
||||||
|
{
|
||||||
|
Deprecation::notice('5.4.0', 'Use getBaseTag() instead');
|
||||||
|
// Is the document XHTML?
|
||||||
|
$isXhtml = preg_match('/<!DOCTYPE[^>]+xhtml/i', $contentGeneratedSoFar ?? '');
|
||||||
|
return static::getBaseTag($isXhtml);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return an appropriate base tag for the given template.
|
||||||
|
* It will be closed on an XHTML document, and unclosed on an HTML document.
|
||||||
|
*
|
||||||
|
* @param bool $isXhtml Whether the DOCTYPE is xhtml or not.
|
||||||
|
*/
|
||||||
|
public static function getBaseTag(bool $isXhtml = false): string
|
||||||
{
|
{
|
||||||
// Base href should always have a trailing slash
|
// Base href should always have a trailing slash
|
||||||
$base = rtrim(Director::absoluteBaseURL(), '/') . '/';
|
$base = rtrim(Director::absoluteBaseURL(), '/') . '/';
|
||||||
|
if ($isXhtml) {
|
||||||
// Is the document XHTML?
|
|
||||||
if (preg_match('/<!DOCTYPE[^>]+xhtml/i', $contentGeneratedSoFar ?? '')) {
|
|
||||||
return "<base href=\"$base\" />";
|
return "<base href=\"$base\" />";
|
||||||
} else {
|
}
|
||||||
return "<base href=\"$base\"><!--[if lte IE 6]></base><![endif]-->";
|
return "<base href=\"$base\"><!--[if lte IE 6]></base><![endif]-->";
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
|
||||||
|
@ -4,6 +4,7 @@ namespace SilverStripe\View;
|
|||||||
|
|
||||||
use InvalidArgumentException;
|
use InvalidArgumentException;
|
||||||
use SilverStripe\Core\ClassInfo;
|
use SilverStripe\Core\ClassInfo;
|
||||||
|
use SilverStripe\Dev\Deprecation;
|
||||||
use SilverStripe\ORM\FieldType\DBField;
|
use SilverStripe\ORM\FieldType\DBField;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -11,7 +12,7 @@ use SilverStripe\ORM\FieldType\DBField;
|
|||||||
* data that is scope-independant (like BaseURL), or type-specific data that is layered on top cross-cut like
|
* data that is scope-independant (like BaseURL), or type-specific data that is layered on top cross-cut like
|
||||||
* (like $FirstLast etc).
|
* (like $FirstLast etc).
|
||||||
*
|
*
|
||||||
* It's separate from SSViewer_Scope to keep that fairly complex code as clean as possible.
|
* @deprecated 5.4.0 Will be merged into SilverStripe\View\SSViewer_Scope
|
||||||
*/
|
*/
|
||||||
class SSViewer_DataPresenter extends SSViewer_Scope
|
class SSViewer_DataPresenter extends SSViewer_Scope
|
||||||
{
|
{
|
||||||
@ -65,6 +66,7 @@ class SSViewer_DataPresenter extends SSViewer_Scope
|
|||||||
array $underlay = null,
|
array $underlay = null,
|
||||||
SSViewer_Scope $inheritedScope = null
|
SSViewer_Scope $inheritedScope = null
|
||||||
) {
|
) {
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be merged into ' . SSViewer_Scope::class, Deprecation::SCOPE_CLASS);
|
||||||
parent::__construct($item, $inheritedScope);
|
parent::__construct($item, $inheritedScope);
|
||||||
|
|
||||||
$this->overlay = $overlay ?: [];
|
$this->overlay = $overlay ?: [];
|
||||||
|
@ -3,9 +3,11 @@
|
|||||||
namespace SilverStripe\View;
|
namespace SilverStripe\View;
|
||||||
|
|
||||||
use SilverStripe\Core\Config\Config;
|
use SilverStripe\Core\Config\Config;
|
||||||
|
use SilverStripe\Dev\Deprecation;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Special SSViewer that will process a template passed as a string, rather than a filename.
|
* Special SSViewer that will process a template passed as a string, rather than a filename.
|
||||||
|
* @deprecated 5.4.0 Will be replaced with SilverStripe\View\SSTemplateEngine::renderString()
|
||||||
*/
|
*/
|
||||||
class SSViewer_FromString extends SSViewer
|
class SSViewer_FromString extends SSViewer
|
||||||
{
|
{
|
||||||
@ -37,6 +39,11 @@ class SSViewer_FromString extends SSViewer
|
|||||||
*/
|
*/
|
||||||
public function __construct($content, TemplateParser $parser = null)
|
public function __construct($content, TemplateParser $parser = null)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment(
|
||||||
|
'5.4.0',
|
||||||
|
'Will be replaced with SilverStripe\View\SSTemplateEngine::renderString()',
|
||||||
|
Deprecation::SCOPE_CLASS
|
||||||
|
);
|
||||||
if ($parser) {
|
if ($parser) {
|
||||||
$this->setParser($parser);
|
$this->setParser($parser);
|
||||||
}
|
}
|
||||||
|
@ -5,6 +5,7 @@ namespace SilverStripe\View;
|
|||||||
use ArrayIterator;
|
use ArrayIterator;
|
||||||
use Countable;
|
use Countable;
|
||||||
use Iterator;
|
use Iterator;
|
||||||
|
use SilverStripe\Dev\Deprecation;
|
||||||
use SilverStripe\ORM\FieldType\DBBoolean;
|
use SilverStripe\ORM\FieldType\DBBoolean;
|
||||||
use SilverStripe\ORM\FieldType\DBText;
|
use SilverStripe\ORM\FieldType\DBText;
|
||||||
use SilverStripe\ORM\FieldType\DBFloat;
|
use SilverStripe\ORM\FieldType\DBFloat;
|
||||||
@ -123,9 +124,11 @@ class SSViewer_Scope
|
|||||||
* Returns the current "active" item
|
* Returns the current "active" item
|
||||||
*
|
*
|
||||||
* @return object
|
* @return object
|
||||||
|
* @deprecated 5.4.0 use getCurrentItem() instead.
|
||||||
*/
|
*/
|
||||||
public function getItem()
|
public function getItem()
|
||||||
{
|
{
|
||||||
|
Deprecation::notice('5.4.0', 'use getCurrentItem() instead.');
|
||||||
$item = $this->itemIterator ? $this->itemIterator->current() : $this->item;
|
$item = $this->itemIterator ? $this->itemIterator->current() : $this->item;
|
||||||
if (is_scalar($item)) {
|
if (is_scalar($item)) {
|
||||||
$item = $this->convertScalarToDBField($item);
|
$item = $this->convertScalarToDBField($item);
|
||||||
@ -133,6 +136,11 @@ class SSViewer_Scope
|
|||||||
return $item;
|
return $item;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
public function getCurrentItem()
|
||||||
|
{
|
||||||
|
return $this->getItem();
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Called at the start of every lookup chain by SSTemplateParser to indicate a new lookup from local scope
|
* Called at the start of every lookup chain by SSTemplateParser to indicate a new lookup from local scope
|
||||||
*
|
*
|
||||||
@ -185,7 +193,7 @@ class SSViewer_Scope
|
|||||||
*/
|
*/
|
||||||
public function getObj($name, $arguments = [], $cache = false, $cacheName = null)
|
public function getObj($name, $arguments = [], $cache = false, $cacheName = null)
|
||||||
{
|
{
|
||||||
$on = $this->getItem();
|
$on = $this->getCurrentItem();
|
||||||
if ($on === null) {
|
if ($on === null) {
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
@ -198,9 +206,11 @@ class SSViewer_Scope
|
|||||||
* @param bool $cache
|
* @param bool $cache
|
||||||
* @param string $cacheName
|
* @param string $cacheName
|
||||||
* @return $this
|
* @return $this
|
||||||
|
* @deprecated 5.4.0 Will be renamed scopeToIntermediateValue()
|
||||||
*/
|
*/
|
||||||
public function obj($name, $arguments = [], $cache = false, $cacheName = null)
|
public function obj($name, $arguments = [], $cache = false, $cacheName = null)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be renamed scopeToIntermediateValue()');
|
||||||
switch ($name) {
|
switch ($name) {
|
||||||
case 'Up':
|
case 'Up':
|
||||||
if ($this->upIndex === null) {
|
if ($this->upIndex === null) {
|
||||||
@ -252,7 +262,7 @@ class SSViewer_Scope
|
|||||||
*/
|
*/
|
||||||
public function self()
|
public function self()
|
||||||
{
|
{
|
||||||
$result = $this->getItem();
|
$result = $this->getCurrentItem();
|
||||||
$this->resetLocalScope();
|
$this->resetLocalScope();
|
||||||
|
|
||||||
return $result;
|
return $result;
|
||||||
@ -350,8 +360,12 @@ class SSViewer_Scope
|
|||||||
*/
|
*/
|
||||||
public function __call($name, $arguments)
|
public function __call($name, $arguments)
|
||||||
{
|
{
|
||||||
$on = $this->getItem();
|
$on = $this->getCurrentItem();
|
||||||
|
if ($on instanceof ViewableData && $name === 'XML_val') {
|
||||||
|
$retval = $on->XML_val(...$arguments);
|
||||||
|
} else {
|
||||||
$retval = $on ? $on->$name(...$arguments) : null;
|
$retval = $on ? $on->$name(...$arguments) : null;
|
||||||
|
}
|
||||||
|
|
||||||
$this->resetLocalScope();
|
$this->resetLocalScope();
|
||||||
return $retval;
|
return $retval;
|
||||||
|
@ -9,6 +9,7 @@ use SilverStripe\Core\Injector\Injector;
|
|||||||
use SilverStripe\Core\Manifest\ModuleLoader;
|
use SilverStripe\Core\Manifest\ModuleLoader;
|
||||||
use SilverStripe\Core\Manifest\ModuleResourceLoader;
|
use SilverStripe\Core\Manifest\ModuleResourceLoader;
|
||||||
use SilverStripe\Core\Path;
|
use SilverStripe\Core\Path;
|
||||||
|
use SilverStripe\Dev\Deprecation;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Handles finding templates from a stack of template manifest objects.
|
* Handles finding templates from a stack of template manifest objects.
|
||||||
@ -182,9 +183,11 @@ class ThemeResourceLoader implements Flushable, TemplateGlobalProvider
|
|||||||
* @return string Absolute path to resolved template file, or null if not resolved.
|
* @return string Absolute path to resolved template file, or null if not resolved.
|
||||||
* File location will be in the format themes/<theme>/templates/<directories>/<type>/<basename>.ss
|
* File location will be in the format themes/<theme>/templates/<directories>/<type>/<basename>.ss
|
||||||
* Note that type (e.g. 'Layout') is not the root level directory under 'templates'.
|
* Note that type (e.g. 'Layout') is not the root level directory under 'templates'.
|
||||||
|
* @deprecated 5.4.0 Will be removed without equivalent functionality to replace it.
|
||||||
*/
|
*/
|
||||||
public function findTemplate($template, $themes = null)
|
public function findTemplate($template, $themes = null)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be removed without equivalent functionality to replace it.');
|
||||||
if ($themes === null) {
|
if ($themes === null) {
|
||||||
$themes = SSViewer::get_themes();
|
$themes = SSViewer::get_themes();
|
||||||
}
|
}
|
||||||
|
@ -426,9 +426,11 @@ class ViewableData implements IteratorAggregate
|
|||||||
*
|
*
|
||||||
* @param string $field
|
* @param string $field
|
||||||
* @return string
|
* @return string
|
||||||
|
* @deprecated 5.4.0 Will be removed without equivalent functionality to replace it.
|
||||||
*/
|
*/
|
||||||
public function castingClass($field)
|
public function castingClass($field)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be removed without equivalent functionality to replace it.');
|
||||||
// Strip arguments
|
// Strip arguments
|
||||||
$spec = $this->castingHelper($field);
|
$spec = $this->castingHelper($field);
|
||||||
return trim(strtok($spec ?? '', '(') ?? '');
|
return trim(strtok($spec ?? '', '(') ?? '');
|
||||||
@ -439,9 +441,11 @@ class ViewableData implements IteratorAggregate
|
|||||||
*
|
*
|
||||||
* @param string $field
|
* @param string $field
|
||||||
* @return string 'xml'|'raw'
|
* @return string 'xml'|'raw'
|
||||||
|
* @deprecated 5.4.0 Will be removed without equivalent functionality to replace it.
|
||||||
*/
|
*/
|
||||||
public function escapeTypeForField($field)
|
public function escapeTypeForField($field)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be removed without equivalent functionality to replace it.');
|
||||||
$class = $this->castingClass($field) ?: $this->config()->get('default_cast');
|
$class = $this->castingClass($field) ?: $this->config()->get('default_cast');
|
||||||
|
|
||||||
/** @var DBField $type */
|
/** @var DBField $type */
|
||||||
@ -488,9 +492,11 @@ class ViewableData implements IteratorAggregate
|
|||||||
* @param string $fieldName Name of field
|
* @param string $fieldName Name of field
|
||||||
* @param array $arguments List of optional arguments given
|
* @param array $arguments List of optional arguments given
|
||||||
* @return string
|
* @return string
|
||||||
|
* @deprecated 5.4.0 Will be made private
|
||||||
*/
|
*/
|
||||||
protected function objCacheName($fieldName, $arguments)
|
protected function objCacheName($fieldName, $arguments)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be made private');
|
||||||
return $arguments
|
return $arguments
|
||||||
? $fieldName . ":" . var_export($arguments, true)
|
? $fieldName . ":" . var_export($arguments, true)
|
||||||
: $fieldName;
|
: $fieldName;
|
||||||
@ -546,6 +552,9 @@ class ViewableData implements IteratorAggregate
|
|||||||
*/
|
*/
|
||||||
public function obj($fieldName, $arguments = [], $cache = false, $cacheName = null)
|
public function obj($fieldName, $arguments = [], $cache = false, $cacheName = null)
|
||||||
{
|
{
|
||||||
|
if ($cacheName !== null) {
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'The $cacheName parameter has been deprecated and will be removed');
|
||||||
|
}
|
||||||
if (!$cacheName && $cache) {
|
if (!$cacheName && $cache) {
|
||||||
$cacheName = $this->objCacheName($fieldName, $arguments);
|
$cacheName = $this->objCacheName($fieldName, $arguments);
|
||||||
}
|
}
|
||||||
@ -588,9 +597,11 @@ class ViewableData implements IteratorAggregate
|
|||||||
* @param array $arguments
|
* @param array $arguments
|
||||||
* @param string $identifier an optional custom cache identifier
|
* @param string $identifier an optional custom cache identifier
|
||||||
* @return Object|DBField
|
* @return Object|DBField
|
||||||
|
* @deprecated 5.4.0 use obj() instead
|
||||||
*/
|
*/
|
||||||
public function cachedCall($fieldName, $arguments = [], $identifier = null)
|
public function cachedCall($fieldName, $arguments = [], $identifier = null)
|
||||||
{
|
{
|
||||||
|
Deprecation::notice('5.4.0', 'Use obj() instead');
|
||||||
return $this->obj($fieldName, $arguments, true, $identifier);
|
return $this->obj($fieldName, $arguments, true, $identifier);
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -617,9 +628,11 @@ class ViewableData implements IteratorAggregate
|
|||||||
* @param array $arguments
|
* @param array $arguments
|
||||||
* @param bool $cache
|
* @param bool $cache
|
||||||
* @return string
|
* @return string
|
||||||
|
* @deprecated 5.4.0 Will be removed without equivalent functionality to replace it
|
||||||
*/
|
*/
|
||||||
public function XML_val($field, $arguments = [], $cache = false)
|
public function XML_val($field, $arguments = [], $cache = false)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be removed without equivalent functionality to replace it');
|
||||||
$result = $this->obj($field, $arguments, $cache);
|
$result = $this->obj($field, $arguments, $cache);
|
||||||
// Might contain additional formatting over ->XML(). E.g. parse shortcodes, nl2br()
|
// Might contain additional formatting over ->XML(). E.g. parse shortcodes, nl2br()
|
||||||
return $result->forTemplate();
|
return $result->forTemplate();
|
||||||
@ -630,9 +643,11 @@ class ViewableData implements IteratorAggregate
|
|||||||
*
|
*
|
||||||
* @param array $fields an array of field names
|
* @param array $fields an array of field names
|
||||||
* @return array
|
* @return array
|
||||||
|
* @deprecated 5.4.0 Will be removed without equivalent functionality to replace it
|
||||||
*/
|
*/
|
||||||
public function getXMLValues($fields)
|
public function getXMLValues($fields)
|
||||||
{
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('5.4.0', 'Will be removed without equivalent functionality to replace it');
|
||||||
$result = [];
|
$result = [];
|
||||||
|
|
||||||
foreach ($fields as $field) {
|
foreach ($fields as $field) {
|
||||||
|
@ -23,6 +23,8 @@ class DeprecationTest extends SapphireTest
|
|||||||
|
|
||||||
private bool $noticesWereEnabled = false;
|
private bool $noticesWereEnabled = false;
|
||||||
|
|
||||||
|
private bool $showSupportedNoticesWasEnabled = false;
|
||||||
|
|
||||||
protected function setup(): void
|
protected function setup(): void
|
||||||
{
|
{
|
||||||
// Use custom error handler for two reasons:
|
// Use custom error handler for two reasons:
|
||||||
@ -31,6 +33,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
// https://github.com/laminas/laminas-di/pull/30#issuecomment-927585210
|
// https://github.com/laminas/laminas-di/pull/30#issuecomment-927585210
|
||||||
parent::setup();
|
parent::setup();
|
||||||
$this->noticesWereEnabled = Deprecation::isEnabled();
|
$this->noticesWereEnabled = Deprecation::isEnabled();
|
||||||
|
$this->showSupportedNoticesWasEnabled = Deprecation::getShowNoticesCalledFromSupportedCode();
|
||||||
$this->oldHandler = set_error_handler(function (int $errno, string $errstr, string $errfile, int $errline) {
|
$this->oldHandler = set_error_handler(function (int $errno, string $errstr, string $errfile, int $errline) {
|
||||||
if ($errno === E_USER_DEPRECATED) {
|
if ($errno === E_USER_DEPRECATED) {
|
||||||
if (str_contains($errstr, 'SilverStripe\\Dev\\Tests\\DeprecationTest')) {
|
if (str_contains($errstr, 'SilverStripe\\Dev\\Tests\\DeprecationTest')) {
|
||||||
@ -46,6 +49,8 @@ class DeprecationTest extends SapphireTest
|
|||||||
// Fallback to default PHP error handler
|
// Fallback to default PHP error handler
|
||||||
return false;
|
return false;
|
||||||
});
|
});
|
||||||
|
// This is required to clear out the notice from instantiating DeprecationTestObject in TableBuilder::buildTables().
|
||||||
|
Deprecation::outputNotices();
|
||||||
}
|
}
|
||||||
|
|
||||||
protected function tearDown(): void
|
protected function tearDown(): void
|
||||||
@ -55,6 +60,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
} else {
|
} else {
|
||||||
Deprecation::disable();
|
Deprecation::disable();
|
||||||
}
|
}
|
||||||
|
Deprecation::setShowNoticesCalledFromSupportedCode($this->showSupportedNoticesWasEnabled);
|
||||||
restore_error_handler();
|
restore_error_handler();
|
||||||
$this->oldHandler = null;
|
$this->oldHandler = null;
|
||||||
parent::tearDown();
|
parent::tearDown();
|
||||||
@ -66,6 +72,18 @@ class DeprecationTest extends SapphireTest
|
|||||||
return 'abc';
|
return 'abc';
|
||||||
}
|
}
|
||||||
|
|
||||||
|
private function myDeprecatedMethodNoReplacement(): string
|
||||||
|
{
|
||||||
|
Deprecation::noticeWithNoReplacment('1.2.3');
|
||||||
|
return 'abc';
|
||||||
|
}
|
||||||
|
|
||||||
|
private function enableDeprecationNotices(bool $showNoReplacementNotices = false): void
|
||||||
|
{
|
||||||
|
Deprecation::enable($showNoReplacementNotices);
|
||||||
|
Deprecation::setShowNoticesCalledFromSupportedCode(true);
|
||||||
|
}
|
||||||
|
|
||||||
public function testNotice()
|
public function testNotice()
|
||||||
{
|
{
|
||||||
$message = implode(' ', [
|
$message = implode(' ', [
|
||||||
@ -75,7 +93,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
]);
|
]);
|
||||||
$this->expectDeprecation();
|
$this->expectDeprecation();
|
||||||
$this->expectDeprecationMessage($message);
|
$this->expectDeprecationMessage($message);
|
||||||
Deprecation::enable();
|
$this->enableDeprecationNotices();
|
||||||
$ret = $this->myDeprecatedMethod();
|
$ret = $this->myDeprecatedMethod();
|
||||||
$this->assertSame('abc', $ret);
|
$this->assertSame('abc', $ret);
|
||||||
// call outputNotices() directly because the regular shutdown function that emits
|
// call outputNotices() directly because the regular shutdown function that emits
|
||||||
@ -83,6 +101,29 @@ class DeprecationTest extends SapphireTest
|
|||||||
Deprecation::outputNotices();
|
Deprecation::outputNotices();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
public function testNoticeNoReplacement()
|
||||||
|
{
|
||||||
|
$message = implode(' ', [
|
||||||
|
'SilverStripe\Dev\Tests\DeprecationTest->myDeprecatedMethodNoReplacement is deprecated.',
|
||||||
|
'Will be removed without equivalent functionality to replace it.',
|
||||||
|
'Called from SilverStripe\Dev\Tests\DeprecationTest->testNoticeNoReplacement.'
|
||||||
|
]);
|
||||||
|
$this->expectDeprecation();
|
||||||
|
$this->expectDeprecationMessage($message);
|
||||||
|
$this->enableDeprecationNotices(true);
|
||||||
|
$ret = $this->myDeprecatedMethodNoReplacement();
|
||||||
|
$this->assertSame('abc', $ret);
|
||||||
|
Deprecation::outputNotices();
|
||||||
|
}
|
||||||
|
|
||||||
|
public function testNoticeNoReplacementNoSupressed()
|
||||||
|
{
|
||||||
|
$this->enableDeprecationNotices();
|
||||||
|
$ret = $this->myDeprecatedMethodNoReplacement();
|
||||||
|
$this->assertSame('abc', $ret);
|
||||||
|
Deprecation::outputNotices();
|
||||||
|
}
|
||||||
|
|
||||||
public function testCallUserFunc()
|
public function testCallUserFunc()
|
||||||
{
|
{
|
||||||
$message = implode(' ', [
|
$message = implode(' ', [
|
||||||
@ -92,7 +133,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
]);
|
]);
|
||||||
$this->expectDeprecation();
|
$this->expectDeprecation();
|
||||||
$this->expectDeprecationMessage($message);
|
$this->expectDeprecationMessage($message);
|
||||||
Deprecation::enable();
|
$this->enableDeprecationNotices();
|
||||||
$ret = call_user_func([$this, 'myDeprecatedMethod']);
|
$ret = call_user_func([$this, 'myDeprecatedMethod']);
|
||||||
$this->assertSame('abc', $ret);
|
$this->assertSame('abc', $ret);
|
||||||
Deprecation::outputNotices();
|
Deprecation::outputNotices();
|
||||||
@ -107,7 +148,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
]);
|
]);
|
||||||
$this->expectDeprecation();
|
$this->expectDeprecation();
|
||||||
$this->expectDeprecationMessage($message);
|
$this->expectDeprecationMessage($message);
|
||||||
Deprecation::enable();
|
$this->enableDeprecationNotices();
|
||||||
$ret = call_user_func_array([$this, 'myDeprecatedMethod'], []);
|
$ret = call_user_func_array([$this, 'myDeprecatedMethod'], []);
|
||||||
$this->assertSame('abc', $ret);
|
$this->assertSame('abc', $ret);
|
||||||
Deprecation::outputNotices();
|
Deprecation::outputNotices();
|
||||||
@ -115,7 +156,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
|
|
||||||
public function testwithSuppressedNoticeDefault()
|
public function testwithSuppressedNoticeDefault()
|
||||||
{
|
{
|
||||||
Deprecation::enable();
|
$this->enableDeprecationNotices();
|
||||||
$ret = Deprecation::withSuppressedNotice(function () {
|
$ret = Deprecation::withSuppressedNotice(function () {
|
||||||
return $this->myDeprecatedMethod();
|
return $this->myDeprecatedMethod();
|
||||||
});
|
});
|
||||||
@ -132,7 +173,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
]);
|
]);
|
||||||
$this->expectDeprecation();
|
$this->expectDeprecation();
|
||||||
$this->expectDeprecationMessage($message);
|
$this->expectDeprecationMessage($message);
|
||||||
Deprecation::enable(true);
|
$this->enableDeprecationNotices(true);
|
||||||
$ret = Deprecation::withSuppressedNotice(function () {
|
$ret = Deprecation::withSuppressedNotice(function () {
|
||||||
return $this->myDeprecatedMethod();
|
return $this->myDeprecatedMethod();
|
||||||
});
|
});
|
||||||
@ -149,7 +190,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
]);
|
]);
|
||||||
$this->expectDeprecation();
|
$this->expectDeprecation();
|
||||||
$this->expectDeprecationMessage($message);
|
$this->expectDeprecationMessage($message);
|
||||||
Deprecation::enable(true);
|
$this->enableDeprecationNotices(true);
|
||||||
$ret = Deprecation::withSuppressedNotice(function () {
|
$ret = Deprecation::withSuppressedNotice(function () {
|
||||||
return call_user_func([$this, 'myDeprecatedMethod']);
|
return call_user_func([$this, 'myDeprecatedMethod']);
|
||||||
});
|
});
|
||||||
@ -166,7 +207,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
]);
|
]);
|
||||||
$this->expectDeprecation();
|
$this->expectDeprecation();
|
||||||
$this->expectDeprecationMessage($message);
|
$this->expectDeprecationMessage($message);
|
||||||
Deprecation::enable(true);
|
$this->enableDeprecationNotices(true);
|
||||||
Deprecation::withSuppressedNotice(function () {
|
Deprecation::withSuppressedNotice(function () {
|
||||||
Deprecation::notice('123', 'My message.');
|
Deprecation::notice('123', 'My message.');
|
||||||
});
|
});
|
||||||
@ -182,7 +223,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
]);
|
]);
|
||||||
$this->expectDeprecation();
|
$this->expectDeprecation();
|
||||||
$this->expectDeprecationMessage($message);
|
$this->expectDeprecationMessage($message);
|
||||||
Deprecation::enable(true);
|
$this->enableDeprecationNotices(true);
|
||||||
// using this syntax because my IDE was complaining about DeprecationTestObject not existing
|
// using this syntax because my IDE was complaining about DeprecationTestObject not existing
|
||||||
// when trying to use `new DeprecationTestObject();`
|
// when trying to use `new DeprecationTestObject();`
|
||||||
$class = DeprecationTestObject::class;
|
$class = DeprecationTestObject::class;
|
||||||
@ -199,7 +240,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
]);
|
]);
|
||||||
$this->expectDeprecation();
|
$this->expectDeprecation();
|
||||||
$this->expectDeprecationMessage($message);
|
$this->expectDeprecationMessage($message);
|
||||||
Deprecation::enable(true);
|
$this->enableDeprecationNotices(true);
|
||||||
Injector::inst()->get(DeprecationTestObject::class);
|
Injector::inst()->get(DeprecationTestObject::class);
|
||||||
Deprecation::outputNotices();
|
Deprecation::outputNotices();
|
||||||
}
|
}
|
||||||
@ -217,6 +258,50 @@ class DeprecationTest extends SapphireTest
|
|||||||
Deprecation::outputNotices();
|
Deprecation::outputNotices();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
public function testshowNoticesCalledFromSupportedCode()
|
||||||
|
{
|
||||||
|
$this->expectNotToPerformAssertions();
|
||||||
|
$this->enableDeprecationNotices(true);
|
||||||
|
// showNoticesCalledFromSupportedCode is set to true by default for these unit tests
|
||||||
|
// as it is testing code within vendor/silverstripe
|
||||||
|
// This test is to ensure that the method works as expected when we disable this
|
||||||
|
// and we should expect no exceptions to be thrown
|
||||||
|
//
|
||||||
|
// Note specifically NOT testing the following because it's counted as being called
|
||||||
|
// from phpunit itself, which is not considered supported code
|
||||||
|
// Deprecation::withSuppressedNotice(function () {
|
||||||
|
// Deprecation::notice('123', 'My message.');
|
||||||
|
// });
|
||||||
|
Deprecation::setShowNoticesCalledFromSupportedCode(false);
|
||||||
|
// notice()
|
||||||
|
$this->myDeprecatedMethod();
|
||||||
|
// noticeNoReplacement()
|
||||||
|
$this->myDeprecatedMethodNoReplacement();
|
||||||
|
// callUserFunc()
|
||||||
|
call_user_func([$this, 'myDeprecatedMethod']);
|
||||||
|
// callUserFuncArray()
|
||||||
|
call_user_func_array([$this, 'myDeprecatedMethod'], []);
|
||||||
|
// withSuppressedNotice()
|
||||||
|
Deprecation::withSuppressedNotice(
|
||||||
|
fn() => $this->myDeprecatedMethod()
|
||||||
|
);
|
||||||
|
// withSuppressedNoticeTrue()
|
||||||
|
Deprecation::withSuppressedNotice(function () {
|
||||||
|
$this->myDeprecatedMethod();
|
||||||
|
});
|
||||||
|
// withSuppressedNoticeTrueCallUserFunc()
|
||||||
|
Deprecation::withSuppressedNotice(function () {
|
||||||
|
call_user_func([$this, 'myDeprecatedMethod']);
|
||||||
|
});
|
||||||
|
// classWithSuppressedNotice()
|
||||||
|
$class = DeprecationTestObject::class;
|
||||||
|
new $class();
|
||||||
|
// classWithInjectorwithSuppressedNotice()
|
||||||
|
Injector::inst()->get(DeprecationTestObject::class);
|
||||||
|
// Output notices - there should be none
|
||||||
|
Deprecation::outputNotices();
|
||||||
|
}
|
||||||
|
|
||||||
// The following tests would be better to put in the silverstripe/config module, however this is not
|
// The following tests would be better to put in the silverstripe/config module, however this is not
|
||||||
// possible to do in a clean way as the config for the DeprecationTestObject will not load if it
|
// possible to do in a clean way as the config for the DeprecationTestObject will not load if it
|
||||||
// is inside the silverstripe/config directory, as there is no _config.php file or _config folder.
|
// is inside the silverstripe/config directory, as there is no _config.php file or _config folder.
|
||||||
@ -231,7 +316,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
]);
|
]);
|
||||||
$this->expectDeprecation();
|
$this->expectDeprecation();
|
||||||
$this->expectDeprecationMessage($message);
|
$this->expectDeprecationMessage($message);
|
||||||
Deprecation::enable();
|
$this->enableDeprecationNotices();
|
||||||
Config::inst()->get(DeprecationTestObject::class, 'first_config');
|
Config::inst()->get(DeprecationTestObject::class, 'first_config');
|
||||||
Deprecation::outputNotices();
|
Deprecation::outputNotices();
|
||||||
}
|
}
|
||||||
@ -244,7 +329,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
]);
|
]);
|
||||||
$this->expectDeprecation();
|
$this->expectDeprecation();
|
||||||
$this->expectDeprecationMessage($message);
|
$this->expectDeprecationMessage($message);
|
||||||
Deprecation::enable();
|
$this->enableDeprecationNotices();
|
||||||
Config::inst()->get(DeprecationTestObject::class, 'second_config');
|
Config::inst()->get(DeprecationTestObject::class, 'second_config');
|
||||||
Deprecation::outputNotices();
|
Deprecation::outputNotices();
|
||||||
}
|
}
|
||||||
@ -254,7 +339,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
$message = 'Config SilverStripe\Dev\Tests\DeprecationTest\DeprecationTestObject.third_config is deprecated.';
|
$message = 'Config SilverStripe\Dev\Tests\DeprecationTest\DeprecationTestObject.third_config is deprecated.';
|
||||||
$this->expectDeprecation();
|
$this->expectDeprecation();
|
||||||
$this->expectDeprecationMessage($message);
|
$this->expectDeprecationMessage($message);
|
||||||
Deprecation::enable();
|
$this->enableDeprecationNotices();
|
||||||
Config::inst()->get(DeprecationTestObject::class, 'third_config');
|
Config::inst()->get(DeprecationTestObject::class, 'third_config');
|
||||||
Deprecation::outputNotices();
|
Deprecation::outputNotices();
|
||||||
}
|
}
|
||||||
@ -267,7 +352,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
]);
|
]);
|
||||||
$this->expectDeprecation();
|
$this->expectDeprecation();
|
||||||
$this->expectDeprecationMessage($message);
|
$this->expectDeprecationMessage($message);
|
||||||
Deprecation::enable();
|
$this->enableDeprecationNotices();
|
||||||
Config::modify()->set(DeprecationTestObject::class, 'first_config', 'abc');
|
Config::modify()->set(DeprecationTestObject::class, 'first_config', 'abc');
|
||||||
Deprecation::outputNotices();
|
Deprecation::outputNotices();
|
||||||
}
|
}
|
||||||
@ -280,7 +365,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
]);
|
]);
|
||||||
$this->expectDeprecation();
|
$this->expectDeprecation();
|
||||||
$this->expectDeprecationMessage($message);
|
$this->expectDeprecationMessage($message);
|
||||||
Deprecation::enable();
|
$this->enableDeprecationNotices();
|
||||||
Config::modify()->merge(DeprecationTestObject::class, 'array_config', ['abc']);
|
Config::modify()->merge(DeprecationTestObject::class, 'array_config', ['abc']);
|
||||||
Deprecation::outputNotices();
|
Deprecation::outputNotices();
|
||||||
}
|
}
|
||||||
@ -366,7 +451,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
switch ($varName) {
|
switch ($varName) {
|
||||||
case 'SS_DEPRECATION_ENABLED':
|
case 'SS_DEPRECATION_ENABLED':
|
||||||
if ($configVal) {
|
if ($configVal) {
|
||||||
Deprecation::enable();
|
$this->enableDeprecationNotices();
|
||||||
} else {
|
} else {
|
||||||
Deprecation::disable();
|
Deprecation::disable();
|
||||||
}
|
}
|
||||||
@ -542,7 +627,7 @@ class DeprecationTest extends SapphireTest
|
|||||||
private function setEnabledViaStatic(bool $enabled): void
|
private function setEnabledViaStatic(bool $enabled): void
|
||||||
{
|
{
|
||||||
if ($enabled) {
|
if ($enabled) {
|
||||||
Deprecation::enable();
|
$this->enableDeprecationNotices();
|
||||||
} else {
|
} else {
|
||||||
Deprecation::disable();
|
Deprecation::disable();
|
||||||
}
|
}
|
||||||
|
Loading…
Reference in New Issue
Block a user