Verification: a143cc29221c9be0

Php call static method by class name

Содержание

◆ __construct()

__construct ( Request  $request = null )

Constructor Controller.

Аргументы

Переопределяется в Tracking.

См. определение в файле main/lib/engine/controller.php строка 80

81  {

83  $this->errorCollection = new ErrorCollection;

85  $this->configurator = new Configurator();

87 

88  $this->init();

89  }

static getCurrent()

Static method returns current instance of context.

init()

Initializes controller.

◆ addError()

addError ( Error  $error )
protected

Adds error to error collection.

Аргументы
Возвращает
$this

См. определение в файле main/lib/engine/controller.php строка 928

929  {

930  $this->errorCollection[] = $error;

931 

932  return $this;

933  }

◆ addErrors()

addErrors ( array  $errors )
protected

Adds list of errors to error collection.

Аргументы
Возвращает
$this

См. определение в файле main/lib/engine/controller.php строка 941

942  {

943  $this->errorCollection->add($errors);

944 

945  return $this;

946  }

◆ appendFilters()

appendFilters ( array  $filters,
array  $filtersToAppend 
)
finalprotected

◆ attachFilters()

attachFilters ( Action  $action )
finalprotected

См. определение в файле main/lib/engine/controller.php строка 787

788  {

791  );

792 

794  foreach ($modifiedConfig['prefilters'] as $filter)

795  {

796 

797  if (!in_array($this->getScope(), $filter->listAllowedScopes(), true))

798  {

799  continue;

800  }

801 

802  $filter->bindAction($action);

803 

804  $eventManager->addEventHandler(

805  'main',

806  static::getFullEventName(static::EVENT_ON_BEFORE_ACTION),

807  array($filter, 'onBeforeAction')

808  );

809 

810  }

811 

812  foreach ($modifiedConfig['postfilters'] as $filter)

813  {

814 

815  if (!in_array($this->getScope(), $filter->listAllowedScopes(), true))

816  {

817  continue;

818  }

819 

820 

821  $filter->bindAction($action);

822 

823  $eventManager->addEventHandler(

824  'main',

825  static::getFullEventName(static::EVENT_ON_AFTER_ACTION),

826  array($filter, 'onAfterAction')

827  );

828  }

829  }

buildFilters(array $config=null)

Builds filter by config.

getActionConfig($actionName)

◆ buildActionInstance()

buildActionInstance (   $actionName,
array  $config 
)
finalprotected

См. определение в файле main/lib/engine/controller.php строка 620

621  {

622  if (isset($config['callable']))

623  {

624  $callable = $config['callable'];

625  if (!is_callable($callable))

626  {

627  throw new ArgumentTypeException('callable', 'callable');

628  }

629 

630  return new ClosureAction($actionName, $this, $callable);

631  }

632  elseif (empty($config['class']))

633  {

634  throw new SystemException(

635  "Could not find class in description of {$actionName} in {$this::className()} to create instance",

636  self::EXCEPTION_UNKNOWN_ACTION

637  );

638  }

639 

640 

641  $action = new $config['class']($actionName, $this, $config);

642 

643  return $action;

644  }

◆ buildErrorFromException()

buildErrorFromException ( \Exception  $e )
protected

См. определение в файле main/lib/engine/controller.php строка 880

881  {

882  if ($e instanceof ArgumentNullException)

883  {

884  return new Error($e->getMessage(), self::ERROR_REQUIRED_PARAMETER);

885  }

886 

887  return new Error($e->getMessage(), $e->getCode());

888  }

◆ buildErrorFromPhpError()

buildErrorFromPhpError ( \Error  $error )
protected

◆ buildFilters()

buildFilters ( array  $config = null )
finalprotected

Builds filter by config.

If there is no config, then we use default filters

См. также
\Bitrix\Main\Engine\Controller::getDefaultPreFilters() and
\Bitrix\Main\Engine\Controller::getDefaultPostFilters(). If now is POST query and there is no csrf check in config, then we add it.
Аргументы
Возвращает
array|null

См. определение в файле main/lib/engine/controller.php строка 697

698  {

699  if ($config === null)

700  {

701  $config = array();

702  }

703 

704  if (!isset($config['prefilters']))

705  {

706  $config['prefilters'] = $this->configurator->wrapFiltersClosure(

708  );

709  }

710  if (!isset($config['postfilters']))

711  {

712  $config['postfilters'] = $this->configurator->wrapFiltersClosure(

714  );

715  }

716 

717  $hasPostMethod = $hasCsrfCheck = false;

718  foreach ($config['prefilters'] as $filter)

719  {

720  if ($filter instanceof ActionFilter\HttpMethod && $filter->containsPostMethod())

721  {

722  $hasPostMethod = true;

723  }

724  if ($filter instanceof ActionFilter\Csrf)

725  {

726  $hasCsrfCheck = true;

727  }

728  }

729 

730  if ($hasPostMethod && !$hasCsrfCheck && $this->request->isPost())

731  {

732  $config['prefilters'][] = new ActionFilter\Csrf;

733  }

734 

735  if (!empty($config['-prefilters']))

736  {

737  $config['prefilters'] = $this->removeFilters($config['prefilters'], $config['-prefilters']);

738  }

739 

740  if (!empty($config['-postfilters']))

741  {

742  $config['postfilters'] = $this->removeFilters($config['postfilters'], $config['-postfilters']);

743  }

744 

745  if (!empty($config['+prefilters']))

746  {

747  $config['prefilters'] = $this->appendFilters($config['prefilters'], $config['+prefilters']);

748  }

749 

750  if (!empty($config['+postfilters']))

751  {

752  $config['postfilters'] = $this->appendFilters($config['postfilters'], $config['+postfilters']);

753  }

754 

755  return $config;

756  }

getDefaultPostFilters()

Returns default post-filters for action.

getDefaultPreFilters()

Returns default pre-filters for action.

appendFilters(array $filters, array $filtersToAppend)

removeFilters(array $filters, array $filtersToRemove)

◆ className()

Returns the fully qualified name of this class.

Возвращает
string

См. определение в файле main/lib/engine/controller.php строка 71

72  {

73  return get_called_class();

74  }

◆ collectDebugInfo()

◆ configureActions()

Возвращает
array

Замещает Controllerable.

Переопределяется в Collector, Csv, Csv, File, Grabber, AuthFlow, ContentView, ControllerBase, Base, Widget, DefaultController, ComponentController, PhoneNumber, PhoneAuth, LoadExt, Export, AuthCode, Disk, Call, HtmlEditorAjax, Product, ResourceBookingAjax, CalendarAjax и File.

См. определение в файле main/lib/engine/controller.php строка 283

284  {

285  return [];

286  }

◆ convertKeysToCamelCase()

convertKeysToCamelCase (   $data )

Converts keys of array to camel case notation.

См. также
\Bitrix\Main\Engine\Response\Converter::OUTPUT_JSON_FORMAT
Аргументы
Возвращает
array|mixed|string

См. определение в файле main/lib/engine/controller.php строка 253

254  {

255  return $this->converter->process($data);

256  }

◆ create()

Переопределяется в ControllerBase, Base и ComponentController.

См. определение в файле main/lib/engine/controller.php строка 587

588  {

591 

592  if (method_exists($this, $methodName))

593  {

594  $method = new \ReflectionMethod($this, $methodName);

595  if ($method->isPublic() && mb_strtolower($method->getName()) === mb_strtolower($methodName))

596  {

597  return new InlineAction($actionName, $this, $config);

598  }

599  }

600  else

601  {

602  if (!$config && ($this instanceof Contract\FallbackActionInterface))

603  {

604  return new FallbackAction($actionName, $this, []);

605  }

606  if (!$config)

607  {

608  throw new SystemException(

609  "Could not find description of {$actionName} in {$this::className()}",

610  self::EXCEPTION_UNKNOWN_ACTION

611  );

612  }

613 

615  }

616 

617  return null;

618  }

buildActionInstance($actionName, array $config)

generateActionMethodName($action)

◆ decodePostData()

См. определение в файле main/lib/engine/controller.php строка 498

498  : void

499  {

500  \CUtil::jSPostUnescape();

501  $this->request->addFilter(new PostDecodeFilter);

502  }

◆ existsAction()

existsAction (   $actionName )
finalprotected

См. определение в файле main/lib/engine/controller.php строка 646

647  {

648  try

649  {

650  $action = $this->create($actionName);

651  }

652  catch (SystemException $e)

653  {

655  {

656  throw $e;

657  }

658  }

659 

660  return isset($action);

661  }

const EXCEPTION_UNKNOWN_ACTION

◆ finalizeResponse()

◆ forward()

forward (   $controller,
string  $actionName,
array  $parameters = null 
)
Аргументы
Controller $controller
string $actionName
array $parameters
Возвращает
HttpResponse|mixed
Исключения

См. определение в файле main/lib/engine/controller.php строка 99

100  {

101  if (is_string($controller))

102  {

103  $controller = new $controller;

104  }

105 

106 

107  $controller->request = $this->getRequest();

108  $controller->setScope($this->getScope());

109  $controller->setCurrentUser($this->getCurrentUser());

110 

111 

112  $result = $controller->run(

113  $actionName,

115  );

116 

117  $this->addErrors($controller->getErrors());

118 

119  return $result;

120  }

addErrors(array $errors)

Adds list of errors to error collection.

getSourceParametersList()

◆ generateActionMethodName()

generateActionMethodName (   $action )
final

◆ getActionConfig()

getActionConfig (   $actionName )
finalprotected

См. определение в файле main/lib/engine/controller.php строка 831

832  {

833  $listOfActions = array_change_key_case($this->configurationOfActions, CASE_LOWER);

834  $actionName = mb_strtolower($actionName);

835 

836  if (!isset($listOfActions[$actionName]))

837  {

838  return null;

839  }

840 

841  return $listOfActions[$actionName];

842  }

◆ getActionUri()

getActionUri (   $actionName,
array  $params = array(),
  $absolute = false 
)
final

Returns uri for ajax end point for the action name.

It's a helper, which uses relative action name without controller name.

Аргументы
string $actionName Action name. It's a relative action name without controller name.
array $params Parameters for creating uri.
bool $absolute
Возвращает
\Bitrix\Main\Web\Uri

См. определение в файле main/lib/engine/controller.php строка 172

173  {

174  if (mb_strpos($this->getFilePath(), '/components/') === false)

175  {

176  return UrlManager::getInstance()->createByController($this, $actionName, $params, $absolute);

177  }

178 

179  return UrlManager::getInstance()->createByComponentController($this, $actionName, $params, $absolute);

180  }

◆ getAutoWiredParameters()

getAutoWiredParameters ( )

◆ getConfigurationOfActions()

getConfigurationOfActions ( )
final

◆ getCurrentUser()

◆ getDefaultAutoWiredParameters()

getDefaultAutoWiredParameters ( )
final

◆ getDefaultPostFilters()

getDefaultPostFilters ( )
protected

◆ getDefaultPreFilters()

Returns default pre-filters for action.

Возвращает
array

Переопределяется в EntitySelector, Base, File, Configuration, BaseReceiver, JsonController, Note, Cookies, Disk и DefaultElement.

См. определение в файле main/lib/engine/controller.php строка 667

668  {

669  return array(

670  new ActionFilter\Authentication(),

671  new ActionFilter\HttpMethod(

672  array(ActionFilter\HttpMethod::METHOD_GET, ActionFilter\HttpMethod::METHOD_POST)

673  ),

674  new ActionFilter\Csrf(),

675  );

676  }

◆ getErrorByCode()

getErrorByCode (   $code )
final

Getting once error with the necessary code.

Аргументы
string $code Code of error.
Возвращает
Error

Замещает Errorable.

См. определение в файле main/lib/engine/controller.php строка 962

963  {

964  return $this->errorCollection->getErrorByCode($code);

965  }

◆ getErrors()

◆ getFilePath()

См. определение в файле main/lib/engine/controller.php строка 151

152  {

153  if (!$this->filePath)

154  {

155  $reflector = new \ReflectionClass($this);

156  $this->filePath = preg_replace('#[\\\/]+#', '/', $reflector->getFileName());

157  }

158 

159  return $this->filePath;

160  }

◆ getFullEventName()

static getFullEventName (   $eventName )
staticfinal

◆ getModuleId()

◆ getPrimaryAutoWiredParameter()

getPrimaryAutoWiredParameter ( )

◆ getRequest()

◆ getSaltToUnsign()

Tries to find salt from request.

It's "c" (component name) in general.

Возвращает
string|null

См. определение в файле main/lib/engine/controller.php строка 217

218  {

220  {

221  if (isset($source['c']) && is_string($source['c']))

222  {

223  return $source['c'];

224  }

225  }

226 

227  return null;

228  }

◆ getScope()

◆ getSourceParametersList()

getSourceParametersList ( )
final

◆ getUnsignedParameters()

getUnsignedParameters ( )
final

◆ init()

◆ listNameActions()

Returns list of all.

Возвращает
array

См. определение в файле main/lib/engine/controller.php строка 262

263  {

265  $lengthSuffix = mb_strlen(self::METHOD_ACTION_SUFFIX);

266 

267  $class = new \ReflectionClass($this);

268  foreach ($class->getMethods(\ReflectionMethod::IS_PUBLIC) as $method)

269  {

270  $probablySuffix = mb_substr($method->getName(), -$lengthSuffix);

271  if ($probablySuffix === self::METHOD_ACTION_SUFFIX)

272  {

273  $actions[] = mb_strtolower(mb_substr($method->getName(), 0, -$lengthSuffix));

274  }

275  }

276 

277  return array_unique($actions);

278  }

getConfigurationOfActions()

◆ logDebugInfo()

◆ prepareParams()

◆ processAfterAction()

processAfterAction ( Action  $action,
  $result 
)
protected

Common operations after process action.

If the method returns void or null it means that we don't want to modify $result.

Аргументы
Возвращает
HttpResponse|mixed|void

Переопределяется в UserFieldConfig.

См. определение в файле main/lib/engine/controller.php строка 552

◆ processBeforeAction()

processBeforeAction ( Action  $action )
protected

Common operations before process action.

Аргументы
Возвращает
bool If method will return false, then action will not execute.

Переопределяется в UserFieldConfig.

См. определение в файле main/lib/engine/controller.php строка 488

489  {

490  return true;

491  }

◆ processUnsignedParameters()

processUnsignedParameters ( )
finalprotected

См. определение в файле main/lib/engine/controller.php строка 190

191  {

193  {

194  if (isset($source['signedParameters']) && is_string($source['signedParameters']))

195  {

196  try

197  {

200  $source['signedParameters']

201  );

202  }

203  catch (BadSignatureException $exception)

204  {}

205 

206 

207  return;

208  }

209  }

210  }

static unsignParameters($componentName, $signedParameters)

getSaltToUnsign()

Tries to find salt from request.

◆ redirectTo()

◆ removeFilters()

removeFilters ( array  $filters,
array  $filtersToRemove 
)
finalprotected

См. определение в файле main/lib/engine/controller.php строка 763

764  {

765  $cleanedFilters = [];

766  foreach ($filters as $filter)

767  {

768  $found = false;

769  foreach ($filtersToRemove as $filterToRemove)

770  {

771  if (is_a($filter, $filterToRemove))

772  {

773  $found = true;

774  break;

775  }

776  }

777 

778  if (!$found)

779  {

780  $cleanedFilters[] = $filter;

781  }

782  }

783 

784  return $cleanedFilters;

785  }

◆ run()

run (   $actionName,
array  $sourceParametersList 
)
final
Аргументы
$actionName
array $sourceParametersList
Возвращает
HttpResponse|mixed
Исключения

См. определение в файле main/lib/engine/controller.php строка 372

373  {

375 

376  $e = null;

377  $result = null;

378 

379  try

380  {

383 

384  $action = $this->create($actionName);

385  if (!$action)

386  {

387  throw new SystemException("Could not create action by name {$actionName}");

388  }

389 

392  {

394  }

395 

399  {

400  $result = $action->runWithSourceParametersList();

401 

402  if ($action instanceof Errorable)

403  {

404  $this->errorCollection->add($action->getErrors());

405  }

406  }

407 

410  if ($probablyResult !== null)

411  {

412  $result = $probablyResult;

413  }

414  }

415  catch (\Throwable $e)

416  {

417  $this->processExceptionInDebug($e);

419  }

420 

422 

423  return $result;

424  }

runProcessingThrowable(\Throwable $throwable)

shouldDecodePostData(Action $action)

processAfterAction(Action $action, $result)

Common operations after process action.

logDebugInfo()

Logs debug info by Diag.

processUnsignedParameters()

collectDebugInfo()

Collects debug info by Diag.

setSourceParametersList($sourceParametersList)

processBeforeAction(Action $action)

Common operations before process action.

triggerOnBeforeAction(Action $action)

Triggers the event {{static::EVENT_ON_BEFORE_ACTION}}.

attachFilters(Action $action)

prepareParams()

Prepare params before process action.

triggerOnAfterAction(Action $action, $result)

◆ runProcessingError()

runProcessingError ( \Error  $error )
protected

◆ runProcessingException()

runProcessingException ( \Exception  $e )
protected

Runs processing exception.

Аргументы
Возвращает
void

Переопределяется в Base.

См. определение в файле main/lib/engine/controller.php строка 868

869  {

870 

872  }

buildErrorFromException(\Exception $e)

◆ runProcessingIfInvalidCsrfToken()

runProcessingIfInvalidCsrfToken ( )
protected

Runs processing if csrf token is invalid.

Возвращает
void

См. определение в файле main/lib/engine/controller.php строка 910

911  {

912  $this->errorCollection[] = new Error('Invalid csrf token');

913 

914  throw new SystemException('Invalid csrf token');

915  }

◆ runProcessingIfUserNotAuthorized()

runProcessingIfUserNotAuthorized ( )
protected

Runs processing if user is not authorized.

Возвращает
void

См. определение в файле main/lib/engine/controller.php строка 899

900  {

901  $this->errorCollection[] = new Error('User is not authorized');

902 

903  throw new SystemException('User is not authorized');

904  }

◆ runProcessingThrowable()

runProcessingThrowable ( \Throwable  $throwable )
protected

См. определение в файле main/lib/engine/controller.php строка 851

852  {

853  if ($throwable instanceof \Exception)

854  {

856  }

857  elseif ($throwable instanceof \Error)

858  {

860  }

861  }

runProcessingException(\Exception $e)

Runs processing exception.

runProcessingError(\Error $error)

◆ setActionConfig()

setActionConfig (   $actionName,
array  $config = null 
)
finalprotected

◆ setCurrentUser()

◆ setScope()

◆ setSourceParametersList()

setSourceParametersList (   $sourceParametersList )
final
Аргументы
array $sourceParametersList
Возвращает
Controller

См. определение в файле main/lib/engine/controller.php строка 358

359  {

360  $this->sourceParametersList = $sourceParametersList;

361 

362  return $this;

363  }

◆ shouldDecodePostData()

shouldDecodePostData ( Action  $action )
protected

◆ triggerOnAfterAction()

triggerOnAfterAction ( Action  $action,
  $result 
)
finalprotected

См. определение в файле main/lib/engine/controller.php строка 566

567  {

568  $event = new Event(

569  'main',

570  static::getFullEventName(static::EVENT_ON_AFTER_ACTION),

571  array(

572  'result' => $result,

573  'action' => $action,

574  'controller' => $this,

575  )

576  );

577  $event->send($this);

578 

579  return $event->getParameter('result');

580  }

◆ triggerOnBeforeAction()

triggerOnBeforeAction ( Action  $action )
finalprotected

Triggers the event {{static::EVENT_ON_BEFORE_ACTION}}.

См. также
\Bitrix\Main\Engine\Controller::getFullEventName. This method is invoked right before an action is executed. In case the action should not run, event handler have to return EvenResult with type EventResult::ERROR.
Аргументы
Возвращает
bool

См. определение в файле main/lib/engine/controller.php строка 513

514  {

515  $event = new Event(

516  'main',

517  static::getFullEventName(static::EVENT_ON_BEFORE_ACTION),

518  array(

519  'action' => $action,

520  'controller' => $this,

521  )

522  );

523  $event->send($this);

524 

525  $allow = true;

526  foreach ($event->getResults() as $eventResult)

527  {

529  {

530  $handler = $eventResult->getHandler();

531  if ($handler && $handler instanceof Errorable)

532  {

533  $this->errorCollection->add($handler->getErrors());

534  }

535 

536  $allow = false;

537  }

538  }

539 

540  return $allow;

541  }

◆ writeToLogException()

writeToLogException ( \Throwable  $e )
protected

См. определение в файле main/lib/engine/controller.php строка 426

427  {

429  $exceptionHandler->writeToLog($e);

430  }

static getInstance()

Returns current instance of the Application.

◆ $configurator

◆ $errorCollection

◆ $request

◆ ERROR_REQUIRED_PARAMETER

const ERROR_REQUIRED_PARAMETER = 'MAIN_CONTROLLER_22001'

◆ ERROR_UNKNOWN_ACTION

const ERROR_UNKNOWN_ACTION = 'MAIN_CONTROLLER_22002'

◆ EVENT_ON_AFTER_ACTION

const EVENT_ON_AFTER_ACTION = 'onAfterAction'

◆ EVENT_ON_BEFORE_ACTION

const EVENT_ON_BEFORE_ACTION = 'onBeforeAction'

◆ EXCEPTION_UNKNOWN_ACTION

const EXCEPTION_UNKNOWN_ACTION = 22002

◆ SCOPE_AJAX

const SCOPE_AJAX = 'ajax'

◆ SCOPE_CLI

JIT

Появление JIT как раз во время. Компилятор обещает значительные улучшения производительности, хотя и не всегда это будет в контексте веба. На данный момент не было сделано никаких точных ориентиров, но они обязательно появятся. Что такое JIT  и для чего он будет нужен, можно почитать здесь

Union Types 2.0 (Объединенные типы)

«Объединенные типы» принимают значения нескольких разных типов, а не одного. PHP уже поддерживает два специальных типа объединения:

Type или null, используя специальный синтаксис "?Type"

array или Traversable, используя специальный тип iterable.

Однако произвольные объединенные типы в настоящее время не поддерживаются языком. Вместо этого необходимо использовать аннотации phpdoc, например, в следующем примере:

class Number {
/**
* @var int|float $number
*/
private $number;

/**
* @param int|float $number
*/
public function setNumber($number) {
$this->number = $number;
}

/**
* @return int|float
*/
public function getNumber() {
return $this->number;
}
}

Объединенные типы указываются с использованием синтаксиса T1|T2|… и могут использоваться во всех позициях, где типы в настоящее время принимаются:

class Number {
private int|float $number;

public function setNumber(int|float $number): void {
$this->number = $number;
}

public function getNumber(): int|float {
return $this->number;
}
}

Обратите внимание, что тип void не может быть частью типа объединения, так как он означает «вообще ничего-возвращаемого значения». Кроме того, nullable союзы могут быть написаны с использованием |null или с использованием существующей ? записи:

public function foo(Foo|null $foo): void;

public function bar(?Bar $bar): void;

Оператор nullsafe rfc

Если вы знакомы с оператором объединения c нулевым значением ( ?? ), думаю, что вы уже знакомы с его недостатками: он не работает с вызовами методов. Вместо этого вам нужны будут промежуточные проверки или надо будет полагаться на опциональных помощников, предоставляемых некоторыми фреймворками:

$startDate = $dateAsString = $booking->getStartDate();

$dateAsString = $startDate ? $startDate->asDateTimeString() : null;

С добавлением оператора nullsafe мы теперь можем иметь поведение методов, подобное слиянию null!

$dateAsString = $booking->getStartDate()?->asDateTimeString();

Именованные аргументы rfc

Именованные аргументы позволяют передавать значения в функцию, указывая имя значения, так что вам не нужно учитывать их порядок, а также вы можете пропустить необязательные параметры:

// Использование позиции аргументов:
array_fill(0, 100, 50);

// Использование наименований аргументов:
array_fill(start_index: 0, num: 100, value: 50);

Можно комбинировать именованные аргументы с обычными позиционными аргументами, а также можно указать только некоторые из необязательных аргументов функции, независимо от их порядка:

htmlspecialchars($string, double_encode: false);
//то же самое что и
htmlspecialchars($string, ENT_COMPAT | ENT_HTML401, 'UTF-8', false);

Аттрибуты

Атрибуты, обычно известные в других языках, как аннотации или декораторы, предлагают способ добавлять метаданные в классы, без распарсивания докблоков. Широкое использование парсинга комментариев к документам пользователя показывает, что это очень востребованная функция сообщества. Атрибуты представляют собой специально отформатированный текст, заключенный в «>» путем повторного использования существующих токенов T_SL и T_SR.

Атрибуты могут применяться ко многим вещам в языке:

  • функции (включая замыкания и короткие замыкания)
  • классы (включая анонимные классы), интерфейсы, трейты
  • константы класса
  • свойства класса
  • методы класса
  • параметры функции/метода

Вот пока примерный взгляд из RFC:

use App\Attributes\ExampleAttribute;

>
class Foo
{
>
public const FOO = 'foo';

>
public $x;

>
public function foo(> $bar) { }
}

>
class ExampleAttribute
{
public $value;

public function __construct($value)
{
$this->value = $value;
}
}

Обратите внимание, что эта база Attribute вызывалась PhpAttributeв исходном RFC, но впоследствии была заменена другим RFC . Если вы хотите больше узнать как работают атрибуты, и как вы можете создать свой собственный, то можете прочитать об атрибутах в этом посте Атрибуты в PHP 8. 

Выражение соответствия v2

Это можно было бы назвать старшим братом switch выражения: match может возвращать значения, не требует break операторов, может комбинировать условия, использует строгие сравнения типов и не выполняет никаких типов принуждения.

Вместо этого

switch (1) {
case 0:
$result = 'Foo';
break;
case 1:
$result = 'Bar';
break;
case 2:
$result = 'Baz';
break;
}

echo $result;

Можно писать так:

echo match (1) {
0 => 'Foo',
1 => 'Bar',
2 => 'Baz',
};

Несколько условий могут быть разделены запятыми для выполнения одного и того же блока кода.

$result = match($input) {
0 => "Какой-то Вывод",
'1', '2', '3' => "Вывод условий 1,2,3",
};

Объявление свойств в конструкторе RFC

В настоящее время определение простых объектов значений требует большого количества шаблонов, поскольку все свойства должны повторяться как минимум четыре раза. Рассмотрим следующий простой класс:

class Point {
public float $x;
public float $y;
public float $z;

public function __construct(
float $x = 0.0,
float $y = 0.0,
float $z = 0.0,
) {
$this->x = $x;
$this->y = $y;
$this->z = $z;
}
}

Свойства повторяются 1) в объявлении свойства, 2) в параметрах конструктора и 3) два раза в назначении свойства. Кроме того, тип свойств так же повторяется дважды.

Этот RFC добавляет синтаксический сахар для создания объектов значений или объектов передачи данных. Вместо указания свойств класса и конструктора для них PHP теперь может объединять их в одно. В результате код сокращается до:

class Point { 
публичная функция __construct (
публичный список $ x = 0.0 ,
публичный список $ y = 0.0 ,
публичный список $ z = 0.0 ,
) { }
}

Или еще пример, вместо этого:

class Money 
{
public Currency $currency;

public int $amount;

public function __construct(
Currency $currency,
int $amount,
) {
$this->currency = $currency;
$this->amount = $amount;
}
}

Теперь вы можете сделать это:

class Money 
{
public function __construct(
public Currency $currency,
public int $amount,
) {}
}

Этот сокращенный код строго эквивалентен предыдущему примеру, но более лаконичен. Выбор синтаксиса взят из родственного языка Hack. Более подробно можно почитать в посте объявление свойств в конструкторе.

Новый тип возврата static

Хотя возвращение уже было возможно self, но до PHP 8 он не был допустимым типом возврата static . Учитывая динамически типизированный характер PHP, эта функция будет полезна для многих разработчиков.

class Foo
{
public function method(): static
{
return new static();
}
}

Новый тип mixed v2

С добавлением скалярных типов в PHP 7, обнуляемых в 7.1, объектов в 7.2 и, наконец, типов объединения в 8.0, люди, пишущие код PHP, могут явно объявлять информацию о типах для большинства параметров функции, возвращаемых функций, а также свойств класса. Однако в PHP не всегда поддерживаются типы, и, скорее всего, он всегда будет позволять опускать информацию о типах. Но это приводит к проблеме того, что ее значение неоднозначно, когда отсутствует информация о типе:

  • Функция не возвращает ничего или null
  • Мы ожидаем один из нескольких типов
  • Мы ожидаем, тип, который не может быть подсказан в PHP

Из-за причин, приведенных выше, хорошо, что тип  mixed был наконец добавлен, Сам по себе mixed означает один из этих типов:

  • array
  • bool
  • callable
  • int
  • float
  • null
  • object
  • resource
  • string

Обратите внимание, что mixed также может использоваться как параметр или тип свойства, а не только как тип возвращаемого значения. Также обратите внимание, что, поскольку mixed уже включает в себя null, это не может сделать его обнуляемым. Следующее вызовет ошибку:

// Fatal error: Mixed types cannot be nullable, null is already part of the mixed type.
function bar(): ?mixed {}

Throw выражения

Поскольку в PHP оператор throw не может создавать исключения в тех местах, где разрешены только выражения, такие как функции стрелок, оператор объединения и тернарный оператор. Этот RFC предлагает преобразовать утверждение throw в выражение, чтобы эти случаи стали возможными.

// This was previously not possible since arrow functions only accept a single expression while throw was a statement.
$callable = fn() => throw new Exception();

// $value is non-nullable.
$value = $nullableValue ?? throw new InvalidArgumentException();

// $value is truthy.
$value = $falsableValue ?: throw new InvalidArgumentException();

// $value is only set if the array is not empty.
$value = !empty($array)
? reset($array)
: throw new InvalidArgumentException();

Есть и другие места, где он может быть использован, которые являются более спорными. Эти случаи разрешены в данном RFC

$condition && throw new Exception();
$condition || throw new Exception();
$condition and throw new Exception();
$condition or throw new Exception();

Наследование приватных методов

Раньше PHP применял одинаковые проверки наследования для публичных, защищенных и приватных методов. Другими словами: private методы должны следовать тем же правилам подписи метода, что и protected и public методы. Это не имеет смысла, так как private методы не будут доступны дочерним классам.

Этот RFC изменил данное поведение, так что эти проверки наследования больше не выполняются для приватных методов. Кроме того, использование final private function также не имело смысла, поэтому теперь это вызовет предупреждение:

Warning: Private methods cannot be final as they are never overridden by other classes

Weak maps (Слабые карты)

Построенный на RFC слабых ссылок, который был добавлен в PHP 7.4, В PHP 8 WeakMap  добавляет ​​реализацию, в которой хранятся ссылки на объекты, которые не препятствуют сборке мусора этими объектами.

Возьмем для примера ORM, они часто реализуют кэши, которые содержат ссылки на классы сущностей, чтобы улучшить производительность отношений между сущностями. Эти объекты сущности нельзя собирать, пока кеш имеет ссылку на них, даже если кеш является единственной ссылкой на них.

Если этот слой кэширования использует слабые ссылки и карты вместо этого, PHP будет собирать эти объекты мусором, когда ничто больше не ссылается на них. Особенно в случае ORM, которые могут управлять несколькими сотнями, если не тысячами объектов в запросе; слабые карты могут предложить лучший, более дружественный к ресурсам способ работы с этими объектами.

Вот как выглядят слабые карты, пример из RFC:

class Foo 
{
private WeakMap $cache;

public function getSomethingWithCaching(object $obj): object
{
return $this->cache[$obj]
??= $this->computeSomethingExpensive($obj);
}
}

Использование ::class на объектах

Небольшая, но полезная новая функция: теперь можно использовать ::class на объектах, результат будет идентичен get_class():

//раньше
$bar = new Foo();
echo Foo::class;
//или
echo get_class($bar);
//'Foo'

//теперь можно будет так
$foo = new Foo();
echo $foo::class;
//'Foo'

Неподхваченные уловы

Всякий раз, когда вы хотели перехватить исключение до PHP 8, вы должны были сохранить его в переменной независимо от того, использовали ли вы эту переменную или нет. При отсутствии захвата вы можете пропустить переменную, поэтому вместо этого:

try {
//Что-то идет не так
} catch (MySpecialException $exception) {
Log::error("Что-то пошло не так");
}

Теперь вы можете сделать это:

try {
// Что-то идет не так
} catch (MySpecialException) {
Log::error("Что-то пошло не так");
}

Обратите внимание, что необходимо всегда указывать тип, вы не можете иметь пустой catch. Если вы хотите перехватить все исключения и ошибки, вы можете использовать их Throwable как тип перехвата .

Завершающая запятая в списках параметров

При вызове функции, в списках параметров все еще отсутствовала поддержка запятой. Теперь это разрешено в PHP 8, что означает, что вы можете делать следующее:

public function(
string $parameterA,
int $parameterB,
Foo $objectfoo,
) {
// …
}

Создать DateTime объекты из интерфейса

Вы уже можете создать DateTime объект из DateTimeImmutable объекта, используя DateTime::createFromImmutable($immutableDateTime), но наоборот было сложно. Добавление DateTime::createFromInterface() и DatetimeImmutable::createFromInterface() теперь позволяет получить обобщенный способ конвертировать DateTime и DateTimeImmutable объекты друг в друга.

DateTime::createFromInterface(DateTimeInterface $other);

DateTimeImmutable::createFromInterface(DateTimeInterface $other);

Новый Stringable интерфейс

Появится новый интерфейс Stringable, который автоматически добавляется в классы, которые реализуют магический метод __toString(), и нет необходимости реализовывать его вручную. 

У данного RFC две цели:

  • разрешить использовать, string|Stringable чтобы выразить string|object-with-__toString()
  • предоставить прямой путь обновления с PHP 7 до 8
class Foo
{
public function __toString(): string
{
return 'foo';
}
}

function bar(Stringable $stringable) { /* … */ }

bar(new Foo());
bar('abc');

Новая функция str_contains()

str_contains проверяет, содержится ли строка в другой строке, и возвращает логическое значение (true/false), независимо от того, была ли найдена строка. Некоторые могут сказать, что это давно пора, и нам, наконец, больше не нужно полагаться на strpos, чтобы узнать, содержит ли строка другую строку.

Вместо этого:

if (strpos('string with lots of words', 'words') !== false) { /* … */ }

Теперь вы можете сделать это

if (str_contains('string with lots of words', 'words')) { /* … */ }

Новые функции str_starts_with() и str_ends_with()

Две другие давно ожидаемые функции так же добавлены в ядро. str_starts_with() проверяет, начинается ли строка с другой строки, и возвращает логическое значение (true/false).

str_ends_with() логично проверяет, заканчивается ли строка другой строкой, и возвращает логическое значение (true/false). 

str_starts_with('haystack', 'hay'); // true
str_ends_with('haystack', 'stack'); // true

Как правило, эта функциональность достигается за счет использования существующих строковых функций, таких как substr, strpos/strrpos, strncmp или substr_compare(часто в сочетании с strlen), которые имеют различные недостатки. Что интересно,функциональность str_starts_with и str_ends_with настолько необходима, что ее поддерживают многие основные PHP-фреймворки, включая Symfony, Laravel, Yii, FuelPHP и Phalcon.

Новая функция fdiv

Новая функция  fdiv делает что-то подобное типа функций fmod и intdiv, что позволяет произвести деление на 0. Но вместо ошибок вы получите INF, -INF или NAN, в зависимости от случая.

Новая функция get_debug_type()

get_debug_type() возвращает тип переменной. Что-то похоже выдает gettype(), но get_debug_type() возвращает более полезный вывод для массивов, строк, анонимных классов и объектов. Например, вызов gettype() класса \Foo\Bar вернется object. Использование get_debug_type() вернет имя класса.

Полный список различий между get_debug_type()и gettype() можно найти в RFC.

Новая функцияp get_resource_id()

Ресурсы - это специальные переменные в PHP, ссылающиеся на внешние ресурсы. Например, соединение MySQL, или дескриптор файла.

Каждому из этих ресурсов присваивается идентификатор, хотя ранее единственным способом узнать, что это идентификатор, было преобразование ресурса в int:

$resourceId = (int) $resource;

PHP 8 добавляет функцию get_resource_id(), делая эту операцию более очевидной и безопасной для типов:

$resourceId = get_resource_id($resource);

Улучшение абстрактных методов трейтов 

Трейты - это «механизм повторного использования кода в языках с единичным наследованием, таких как PHP». Обычно они используются для объявления методов, которые можно использовать в нескольких классах. Трейты так же могут содержать абстрактные методы, которые должны быть реализованы классами, использующими их. Однако есть предостережение: до PHP 8 сигнатура этих реализаций методов не проверялась. Следующее было действительным:

trait Test {
abstract public function test(int $input): int;
}

class UsesTrait
{
use Test;

public function test($input)
{
return $input;
}
}

PHP 8 будет выполнять правильную проверку подписи метода при использовании свйоства и реализации его абстрактных методов. Это также означает, что подписи методов должны совпадать. Другими словами, тип и количество требуемых аргументов должны быть одинаковыми:

class UsesTrait
{
use Test;

public function test(int $input): int
{
return $input;
}
}

Как бы то ни было, по словам автора RFC Никиты Попова , проверка подписи в настоящее время применяется только точечно:

  • Это не применяется в наиболее распространенном случае, когда реализация метода обеспечивается в используемом классом
  • Это принудительно, если реализация исходит из родительского класса
  • Это принудительно, если реализация исходит от дочернего класса

Объектно-ориентированная альтернатива token_get_all()

Функция token_get_all() возвращает массив значений. Этот RFC добавляет класс PhpToken с методом PhpToken::getAll(). Эта реализация работает с объектами вместо простых значений, его легче читать, и потребляет меньше памяти.


Изменения синтаксиса переменных RFC

Унифицированный синтаксис переменной RFC устранил ряд несоответствий в синтаксисе переменной PHP. Этот RFC намеревается решить небольшую горстку пропущенных дел.

Тип аннотации для внутренних функций

Много людей хотят добавить соответствующие аннотации типов для всех внутренних функций. Это означает, что внутренние функции и методы будут иметь полную информацию о типе в отражении.

Расширение ext-json всегда доступен

Ранее можно было скомпилировать PHP без включенного расширения JSON, теперь это больше невозможно. Поскольку JSON так широко используется, то разработчики теперь всегда могут рассчитывать на его наличие, вместо того, чтобы лишний раз убеждаться, что расширение существует.


"Сломанные изменения"

PHP 8 - серьезное обновление и, следовательно, будут серьезные изменения. Лучшее, что можно сделать, это взглянуть на полный список критических изменений в документе ОБНОВЛЕНИЕ . Однако многие из этих критических изменений устарели в предыдущих версиях 7. *, поэтому, если вы были в курсе последних лет, не так уж сложно перейти на PHP 8.

Согласованные постоянные ошибки типов

Пользовательские функции в PHP уже генерируют TypeErrors, но внутренние функции этого не делали, они скорее пропускали предупреждения и возвращали null. Начиная с PHP 8 поведение внутренних функций стало более согласованным.

Переклассифицированы предупреждения

Множество ошибок, которые ранее вызывали только предупреждения или уведомления, были преобразованы в правильные ошибки:

  • Undefined variable (Неопределенная переменная): Error исключение вместо уведомления
  • Undefined array index (Неопределенный индекс массива): предупреждение вместо уведомления
  • Division by zero (Деление на ноль): DivisionByZeroError исключение вместо предупреждения
  • Attempt to increment/decrement property '%s' of non-object (Попытка увеличить/уменьшить свойство "%s" необъекта): Error исключение вместо предупреждения
  • Attempt to modify property '%s' of non-object (Попытка изменить свойство "%s" необъекта): Error исключение вместо предупреждения
  • Attempt to assign property '%s' of non-object (Попытка назначить свойство "%s" необъекта): Error исключение вместо предупреждения
  • Creating default object from empty value (Создание объекта по умолчанию из пустого значения): Error исключение вместо предупреждения
  • Trying to get property '%s' of non-object (Попытка получить свойство "%s" необъекта): предупреждение вместо уведомления
  • Undefined property (Неопределенное свойство): %s::$%s: предупреждение вместо уведомления
  • Cannot add element to the array as the next element is already occupied (Невозможно добавить элемент в массив, так как следующий элемент уже занят): Error исключение вместо предупреждения
  • Cannot unset offset in a non-array variable (Невозможно сбросить смещение в переменной, не являющейся массивом): Error исключение вместо предупреждения
  • Cannot use a scalar value as an array (Нельзя использовать скалярное значение в качестве массива): Error исключение вместо предупреждения
  • Only arrays and Traversables can be unpacked (Только массивы и Traversables могут быть распакованы): TypeError исключение вместо предупреждения
  • Invalid argument supplied for foreach() (Указан неверный аргумент для foreach ()): TypeError исключение вместо предупреждения
  • Illegal offset type (Недопустимый тип смещения): TypeError исключение вместо предупреждения
  • Illegal offset type in isset or empty (Недопустимый тип смещения в isset или empty): TypeError исключение вместо предупреждения
  • Illegal offset type in unset (Недопустимый тип смещения в unset): TypeError исключение вместо предупреждения
  • Array to string conversion (Преобразование массива в строку): предупреждение вместо уведомления
  • Resource ID#%d used as offset, casting to integer (%d) (Идентификатор ресурса #%d, используемый в качестве смещения, приведение к целому числу (%d)): предупреждение вместо уведомления
  • String offset cast occurred (Произошло приведение смещения строки): предупреждение вместо уведомления
  • Uninitialized string offset: %d (Смещение неинициализированной строки: %d): предупреждение вместо уведомления
  • Cannot assign an empty string to a string offset (Невозможно назначить пустую строку для смещения строки): Error исключение вместо предупреждения

Оператор @ больше не "глушит" фатальные ошибки

Вполне возможно, что это изменение может выявить ошибки, которые снова были скрыты до PHP 8. Обязательно установите display_errors=Off на своих производственных серверах!

Стандартный режим ошибки PDO

Из RFC: текущий режим ошибок по умолчанию для PDO - бесшумный. Это означает, что при возникновении ошибки SQL никакие ошибки или предупреждения не могут выдаваться и не генерируются исключения, если разработчик не реализует свою собственную явную обработку ошибок.

Этот RFC изменяет ошибку по умолчанию, которая изменится на PDO::ERRMODE_EXCEPTION.

Уровень сообщений об ошибках по умолчанию

Теперь по умолчанию в error_reporting уровень ошибок будет установлен в E_ALL вместо текущего  E_ALL & ~ E_NOTICE & ~ E_STRICT & ~ E_DEPRECATED. Это означает, что могут появиться много ошибок, которые ранее незаметно игнорировались, хотя, возможно, уже существовали до PHP 8.

Приоритет при конкатенации

Хотя это изменение уже устарело в PHP 7.4, теперь это изменение вступает в силу. Если бы вы написали что-то вроде этого:

echo "sum: " . $a + $b;

PHP ранее интерпретировал бы это так:

echo ("sum: " . $a) + $b;

PHP 8 сделает так, чтобы он интерпретировался так:

echo "sum: " . ($a + $b);

Более строгие проверки типов для арифметических и побитовых операторов

До PHP 8 можно было применять арифметические или побитовые операторы к массивам, ресурсам или объектам. Это больше не возможно и выдаст TypeError:

[] % [42];
$object + 4;

Имена в пространствах имен являются одним токеном rfc

PHP используется для интерпретации каждой части пространства имен (разделенной обратной косой чертой \) как последовательности токенов. Этот RFC изменил это поведение, что означает, что теперь в пространствах имен можно использовать зарезервированные имена.

// In the library:
namespace iter\fn;

function operator($operator, $operand = null) { ... }

// In the using code:
use iter\fn;

iter\map(fn\operator('*', 2), $nums);

Более разумные числовые строки rfc

Система типов PHP пытается делать много умных вещей, когда встречает числа в строках. Этот RFC делает такое поведение более последовательным и понятным.

Более разумное сравнение чисел и строк rfc

Этот RFC исправляет очень странный случай в PHP, когда 0 == "foo" возвращает результат как true. Есть и другие крайние случаи, подобные этому, и этот RFC исправляет их.

Изменения подписи метода отражения

Три сигнатуры методов классов отражения были изменены:

ReflectionClass::newInstance($args);
ReflectionFunction::invoke($args);
ReflectionMethod::invoke($object, $args);

Теперь стали:

ReflectionClass::newInstance(...$args);
ReflectionFunction::invoke(...$args);
ReflectionMethod::invoke($object, ...$args);

В руководстве по обновлению указано, что если вы расширяете эти классы и по-прежнему хотите поддерживать как PHP 7, так и PHP 8, допускаются следующие подписи:

ReflectionClass::newInstance($arg = null, ...$args);
ReflectionFunction::invoke($arg = null, ...$args);
ReflectionMethod::invoke($object, $arg = null, ...$args);

Стабильная сортировка rfc

До PHP 8 алгоритмы сортировки были нестабильны. Это означает, что порядок равных элементов не был гарантирован. PHP 8 изменяет поведение всех функций сортировки на стабильную сортировку. 

Стабильные сортировки полезны, прежде всего, при сортировке сложных данных только по некоторой части этих данных. Рассмотрим этот пример:

usort($users, function($user1, $user2) {
return $user1->age $user2->age;
});

Этот код сортирует пользователей по возрасту. В настоящее время порядок пользователей в одной возрастной группе будет произвольным. При стабильной сортировке исходный порядок объектов будет сохранен. Например, если $users уже был отсортирован по имени, то $users теперь будут отсортированы по возрасту первым и по имени вторым. Конечно, в этом случае можно было бы явно отсортировать по двум критериям:

usort($users, function($user1, $user2) {
return $user1->age $user2->age
?: $user1->name $user2->name;
});

Однако это не всегда возможно, поскольку критерий, по которому данные были первоначально отсортированы, явно не сохраняется. Недавним случаем, с которым я столкнулся, был список git коммитов с метаданными, которые хранились в порядке push (но порядок push не был явно сохранен при каждом коммите).

Помимо предоставленных пользователем функций сравнения, другой случай, когда стабильная сортировка часто желательна, - это функция asort(), которая сортирует по значению, но сохраняет ключи.

$array  =  [ 
'c' => 1 ,
'd' => 1 ,
'a' => 0 ,
'b' => 0 ,
];
asort($array) ;

// При стабильной сортировке результат всегда:
[ 'a' => 0 , 'b' => 0 , 'c' => 1 , 'd' => 1 ]

// При нестабильной сортировке возможны также следующие результаты:
[ 'b' => 0 , 'a' => 0 , 'c' => 1 , 'd' => 1 ]
[ 'a' => 0 , 'b' => 0 , 'd' => 1 , 'c' => 1 ]
[ 'b' => 0 , 'a' => 0 , 'd' => 1 , 'c' => 1 ]

Можно эмулировать стабильную сортировку поверх нестабильной, явно сохраняя исходный порядок элементов и используя его в качестве критерия сравнения, но дополнительное косвенное обращение делает сортировку намного медленнее, а также резко увеличивает использование памяти во время сортировки.

Этот RFC предлагает сделать все функции сортировки PHP стабильными. Сюда входят rsort, usort, asort, arsort, uasort, ksort, krsort, uksort, array_multisort, а также соответствующие методы ArrayObject.