mirror of
https://github.com/WordPress/WordPress.git
synced 2024-10-30 07:20:01 +01:00
95f823d933
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 Follow-up to [50842], [51078]. Props jrf, schlessera, datagutten, wojsmol, dd32, dustinrue, soulseekah, costdev, szepeviktor. Fixes #54504. Built from https://develop.svn.wordpress.org/trunk@52244 git-svn-id: http://core.svn.wordpress.org/trunk@51836 1a063a9b-81f0-0310-95a4-ce76da25c4cd
188 lines
9.1 KiB
PHP
188 lines
9.1 KiB
PHP
<?php
|
|
/**
|
|
* Autoloader for Requests for PHP.
|
|
*
|
|
* Include this file if you'd like to avoid having to create your own autoloader.
|
|
*
|
|
* @package Requests
|
|
* @since 2.0.0
|
|
*
|
|
* @codeCoverageIgnore
|
|
*/
|
|
|
|
namespace WpOrg\Requests;
|
|
|
|
/*
|
|
* Ensure the autoloader is only declared once.
|
|
* This safeguard is in place as this is the typical entry point for this library
|
|
* and this file being required unconditionally could easily cause
|
|
* fatal "Class already declared" errors.
|
|
*/
|
|
if (class_exists('WpOrg\Requests\Autoload') === false) {
|
|
|
|
/**
|
|
* Autoloader for Requests for PHP.
|
|
*
|
|
* This autoloader supports the PSR-4 based Requests 2.0.0 classes in a case-sensitive manner
|
|
* as the most common server OS-es are case-sensitive and the file names are in mixed case.
|
|
*
|
|
* For the PSR-0 Requests 1.x BC-layer, requested classes will be treated case-insensitively.
|
|
*
|
|
* @package Requests
|
|
*/
|
|
final class Autoload {
|
|
|
|
/**
|
|
* List of the old PSR-0 class names in lowercase as keys with their PSR-4 case-sensitive name as a value.
|
|
*
|
|
* @var array
|
|
*/
|
|
private static $deprecated_classes = [
|
|
// Interfaces.
|
|
'requests_auth' => '\WpOrg\Requests\Auth',
|
|
'requests_hooker' => '\WpOrg\Requests\HookManager',
|
|
'requests_proxy' => '\WpOrg\Requests\Proxy',
|
|
'requests_transport' => '\WpOrg\Requests\Transport',
|
|
|
|
// Classes.
|
|
'requests_cookie' => '\WpOrg\Requests\Cookie',
|
|
'requests_exception' => '\WpOrg\Requests\Exception',
|
|
'requests_hooks' => '\WpOrg\Requests\Hooks',
|
|
'requests_idnaencoder' => '\WpOrg\Requests\IdnaEncoder',
|
|
'requests_ipv6' => '\WpOrg\Requests\Ipv6',
|
|
'requests_iri' => '\WpOrg\Requests\Iri',
|
|
'requests_response' => '\WpOrg\Requests\Response',
|
|
'requests_session' => '\WpOrg\Requests\Session',
|
|
'requests_ssl' => '\WpOrg\Requests\Ssl',
|
|
'requests_auth_basic' => '\WpOrg\Requests\Auth\Basic',
|
|
'requests_cookie_jar' => '\WpOrg\Requests\Cookie\Jar',
|
|
'requests_proxy_http' => '\WpOrg\Requests\Proxy\Http',
|
|
'requests_response_headers' => '\WpOrg\Requests\Response\Headers',
|
|
'requests_transport_curl' => '\WpOrg\Requests\Transport\Curl',
|
|
'requests_transport_fsockopen' => '\WpOrg\Requests\Transport\Fsockopen',
|
|
'requests_utility_caseinsensitivedictionary' => '\WpOrg\Requests\Utility\CaseInsensitiveDictionary',
|
|
'requests_utility_filterediterator' => '\WpOrg\Requests\Utility\FilteredIterator',
|
|
'requests_exception_http' => '\WpOrg\Requests\Exception\Http',
|
|
'requests_exception_transport' => '\WpOrg\Requests\Exception\Transport',
|
|
'requests_exception_transport_curl' => '\WpOrg\Requests\Exception\Transport\Curl',
|
|
'requests_exception_http_304' => '\WpOrg\Requests\Exception\Http\Status304',
|
|
'requests_exception_http_305' => '\WpOrg\Requests\Exception\Http\Status305',
|
|
'requests_exception_http_306' => '\WpOrg\Requests\Exception\Http\Status306',
|
|
'requests_exception_http_400' => '\WpOrg\Requests\Exception\Http\Status400',
|
|
'requests_exception_http_401' => '\WpOrg\Requests\Exception\Http\Status401',
|
|
'requests_exception_http_402' => '\WpOrg\Requests\Exception\Http\Status402',
|
|
'requests_exception_http_403' => '\WpOrg\Requests\Exception\Http\Status403',
|
|
'requests_exception_http_404' => '\WpOrg\Requests\Exception\Http\Status404',
|
|
'requests_exception_http_405' => '\WpOrg\Requests\Exception\Http\Status405',
|
|
'requests_exception_http_406' => '\WpOrg\Requests\Exception\Http\Status406',
|
|
'requests_exception_http_407' => '\WpOrg\Requests\Exception\Http\Status407',
|
|
'requests_exception_http_408' => '\WpOrg\Requests\Exception\Http\Status408',
|
|
'requests_exception_http_409' => '\WpOrg\Requests\Exception\Http\Status409',
|
|
'requests_exception_http_410' => '\WpOrg\Requests\Exception\Http\Status410',
|
|
'requests_exception_http_411' => '\WpOrg\Requests\Exception\Http\Status411',
|
|
'requests_exception_http_412' => '\WpOrg\Requests\Exception\Http\Status412',
|
|
'requests_exception_http_413' => '\WpOrg\Requests\Exception\Http\Status413',
|
|
'requests_exception_http_414' => '\WpOrg\Requests\Exception\Http\Status414',
|
|
'requests_exception_http_415' => '\WpOrg\Requests\Exception\Http\Status415',
|
|
'requests_exception_http_416' => '\WpOrg\Requests\Exception\Http\Status416',
|
|
'requests_exception_http_417' => '\WpOrg\Requests\Exception\Http\Status417',
|
|
'requests_exception_http_418' => '\WpOrg\Requests\Exception\Http\Status418',
|
|
'requests_exception_http_428' => '\WpOrg\Requests\Exception\Http\Status428',
|
|
'requests_exception_http_429' => '\WpOrg\Requests\Exception\Http\Status429',
|
|
'requests_exception_http_431' => '\WpOrg\Requests\Exception\Http\Status431',
|
|
'requests_exception_http_500' => '\WpOrg\Requests\Exception\Http\Status500',
|
|
'requests_exception_http_501' => '\WpOrg\Requests\Exception\Http\Status501',
|
|
'requests_exception_http_502' => '\WpOrg\Requests\Exception\Http\Status502',
|
|
'requests_exception_http_503' => '\WpOrg\Requests\Exception\Http\Status503',
|
|
'requests_exception_http_504' => '\WpOrg\Requests\Exception\Http\Status504',
|
|
'requests_exception_http_505' => '\WpOrg\Requests\Exception\Http\Status505',
|
|
'requests_exception_http_511' => '\WpOrg\Requests\Exception\Http\Status511',
|
|
'requests_exception_http_unknown' => '\WpOrg\Requests\Exception\Http\StatusUnknown',
|
|
];
|
|
|
|
/**
|
|
* Register the autoloader.
|
|
*
|
|
* Note: the autoloader is *prepended* in the autoload queue.
|
|
* This is done to ensure that the Requests 2.0 autoloader takes precedence
|
|
* over a potentially (dependency-registered) Requests 1.x autoloader.
|
|
*
|
|
* @internal This method contains a safeguard against the autoloader being
|
|
* registered multiple times. This safeguard uses a global constant to
|
|
* (hopefully/in most cases) still function correctly, even if the
|
|
* class would be renamed.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function register() {
|
|
if (defined('REQUESTS_AUTOLOAD_REGISTERED') === false) {
|
|
spl_autoload_register([self::class, 'load'], true);
|
|
define('REQUESTS_AUTOLOAD_REGISTERED', true);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Autoloader.
|
|
*
|
|
* @param string $class_name Name of the class name to load.
|
|
*
|
|
* @return bool Whether a class was loaded or not.
|
|
*/
|
|
public static function load($class_name) {
|
|
// Check that the class starts with "Requests" (PSR-0) or "WpOrg\Requests" (PSR-4).
|
|
$psr_4_prefix_pos = strpos($class_name, 'WpOrg\\Requests\\');
|
|
|
|
if (stripos($class_name, 'Requests') !== 0 && $psr_4_prefix_pos !== 0) {
|
|
return false;
|
|
}
|
|
|
|
$class_lower = strtolower($class_name);
|
|
|
|
if ($class_lower === 'requests') {
|
|
// Reference to the original PSR-0 Requests class.
|
|
$file = dirname(__DIR__) . '/library/Requests.php';
|
|
} elseif ($psr_4_prefix_pos === 0) {
|
|
// PSR-4 classname.
|
|
$file = __DIR__ . '/' . strtr(substr($class_name, 15), '\\', '/') . '.php';
|
|
}
|
|
|
|
if (isset($file) && file_exists($file)) {
|
|
include $file;
|
|
return true;
|
|
}
|
|
|
|
/*
|
|
* Okay, so the class starts with "Requests", but we couldn't find the file.
|
|
* If this is one of the deprecated/renamed PSR-0 classes being requested,
|
|
* let's alias it to the new name and throw a deprecation notice.
|
|
*/
|
|
if (isset(self::$deprecated_classes[$class_lower])) {
|
|
/*
|
|
* Integrators who cannot yet upgrade to the PSR-4 class names can silence deprecations
|
|
* by defining a `REQUESTS_SILENCE_PSR0_DEPRECATIONS` constant and setting it to `true`.
|
|
* The constant needs to be defined before the first deprecated class is requested
|
|
* via this autoloader.
|
|
*/
|
|
if (!defined('REQUESTS_SILENCE_PSR0_DEPRECATIONS') || REQUESTS_SILENCE_PSR0_DEPRECATIONS !== true) {
|
|
// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_trigger_error
|
|
trigger_error(
|
|
'The PSR-0 `Requests_...` class names in the Request library are deprecated.'
|
|
. ' Switch to the PSR-4 `WpOrg\Requests\...` class names at your earliest convenience.',
|
|
E_USER_DEPRECATED
|
|
);
|
|
|
|
// Prevent the deprecation notice from being thrown twice.
|
|
if (!defined('REQUESTS_SILENCE_PSR0_DEPRECATIONS')) {
|
|
define('REQUESTS_SILENCE_PSR0_DEPRECATIONS', true);
|
|
}
|
|
}
|
|
|
|
// Create an alias and let the autoloader recursively kick in to load the PSR-4 class.
|
|
return class_alias(self::$deprecated_classes[$class_lower], $class_name, true);
|
|
}
|
|
|
|
return false;
|
|
}
|
|
}
|
|
}
|