mirror of
https://github.com/WordPress/WordPress.git
synced 2025-03-13 15:20:06 +01:00
645e753a51
This is a major release and contains breaking changes. Most important changes to be aware of for this release: * All code is now namespaced. Though there is a full backward compatibility layer available and the old class names are still supported, using them will generate a deprecation notice (which can be silenced by plugins if they'd need to support multiple WP versions). See the [https://requests.ryanmccue.info/docs/upgrading.html upgrade guide] for more details. * A lot of classes have been marked `final`. This should generally not affect userland code as care has been taken to not apply the `final` keyword to classes which are known to be extended in userland code. * Extensive input validation has been added to Requests. When Requests is used as documented though, this will be unnoticable. * A new `WpOrg\Requests\Requests::has_capabilities()` method has been introduced which can be used to address #37708. * A new `WpOrg\Requests\Response::decode_body()` method has been introduced which may be usable to simplify some of the WP native wrapper code. * Remaining PHP 8.0 compatibility fixed (support for named parameters). * PHP 8.1 compatibility. Release notes: https://github.com/WordPress/Requests/releases/tag/v2.0.0 For a full list of changes in this update, see the Requests GitHub: https://github.com/WordPress/Requests/compare/v1.8.1...v2.0.0 This commit also resolves 2 blocking issues which previously caused the revert of [52244]: * New Requests files are loaded into `wp-includes/Requests/src/`, matching the location of the library. In doing so, filesystems that are case-insensitive are not impacted (see #54582). * Preload: During a Core update, the old Requests files are preloaded into memory before the update deletes the files. Preloading avoids fatal errors noted in #54562. Follow-up to [50842], [51078], [52244], [52315], [52327], [52328]. Props jrf, schlessera, datagutten, wojsmol, dustinrue, soulseekah, szepeviktor. costdev, sergeybiryukov, peterwilsoncc, ironprogrammer, antonvlasenko, hellofromTonya, swissspidy, dd32, azaozz, TobiasBg, audrasjb. Fixes #54504. See #54582, #54562. Built from https://develop.svn.wordpress.org/trunk@54997 git-svn-id: http://core.svn.wordpress.org/trunk@54530 1a063a9b-81f0-0310-95a4-ce76da25c4cd
67 lines
1.1 KiB
PHP
67 lines
1.1 KiB
PHP
<?php
|
|
/**
|
|
* Exception for HTTP requests
|
|
*
|
|
* @package Requests\Exceptions
|
|
*/
|
|
|
|
namespace WpOrg\Requests;
|
|
|
|
use Exception as PHPException;
|
|
|
|
/**
|
|
* Exception for HTTP requests
|
|
*
|
|
* @package Requests\Exceptions
|
|
*/
|
|
class Exception extends PHPException {
|
|
/**
|
|
* Type of exception
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $type;
|
|
|
|
/**
|
|
* Data associated with the exception
|
|
*
|
|
* @var mixed
|
|
*/
|
|
protected $data;
|
|
|
|
/**
|
|
* Create a new exception
|
|
*
|
|
* @param string $message Exception message
|
|
* @param string $type Exception type
|
|
* @param mixed $data Associated data
|
|
* @param integer $code Exception numerical code, if applicable
|
|
*/
|
|
public function __construct($message, $type, $data = null, $code = 0) {
|
|
parent::__construct($message, $code);
|
|
|
|
$this->type = $type;
|
|
$this->data = $data;
|
|
}
|
|
|
|
/**
|
|
* Like {@see \Exception::getCode()}, but a string code.
|
|
*
|
|
* @codeCoverageIgnore
|
|
* @return string
|
|
*/
|
|
public function getType() {
|
|
return $this->type;
|
|
}
|
|
|
|
/**
|
|
* Gives any relevant data
|
|
*
|
|
* @codeCoverageIgnore
|
|
* @return mixed
|
|
*/
|
|
public function getData() {
|
|
return $this->data;
|
|
}
|
|
}
|