mirror of
https://github.com/WordPress/WordPress.git
synced 2024-11-07 19:31:54 +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
76 lines
1.5 KiB
PHP
76 lines
1.5 KiB
PHP
<?php
|
|
/**
|
|
* Port utilities for Requests
|
|
*
|
|
* @package Requests\Utilities
|
|
* @since 2.0.0
|
|
*/
|
|
|
|
namespace WpOrg\Requests;
|
|
|
|
use WpOrg\Requests\Exception;
|
|
use WpOrg\Requests\Exception\InvalidArgument;
|
|
|
|
/**
|
|
* Find the correct port depending on the Request type.
|
|
*
|
|
* @package Requests\Utilities
|
|
* @since 2.0.0
|
|
*/
|
|
final class Port {
|
|
|
|
/**
|
|
* Port to use with Acap requests.
|
|
*
|
|
* @var int
|
|
*/
|
|
const ACAP = 674;
|
|
|
|
/**
|
|
* Port to use with Dictionary requests.
|
|
*
|
|
* @var int
|
|
*/
|
|
const DICT = 2628;
|
|
|
|
/**
|
|
* Port to use with HTTP requests.
|
|
*
|
|
* @var int
|
|
*/
|
|
const HTTP = 80;
|
|
|
|
/**
|
|
* Port to use with HTTP over SSL requests.
|
|
*
|
|
* @var int
|
|
*/
|
|
const HTTPS = 443;
|
|
|
|
/**
|
|
* Retrieve the port number to use.
|
|
*
|
|
* @param string $type Request type.
|
|
* The following requests types are supported:
|
|
* 'acap', 'dict', 'http' and 'https'.
|
|
*
|
|
* @return int
|
|
*
|
|
* @throws \WpOrg\Requests\Exception\InvalidArgument When a non-string input has been passed.
|
|
* @throws \WpOrg\Requests\Exception When a non-supported port is requested ('portnotsupported').
|
|
*/
|
|
public static function get($type) {
|
|
if (!is_string($type)) {
|
|
throw InvalidArgument::create(1, '$type', 'string', gettype($type));
|
|
}
|
|
|
|
$type = strtoupper($type);
|
|
if (!defined("self::{$type}")) {
|
|
$message = sprintf('Invalid port type (%s) passed', $type);
|
|
throw new Exception($message, 'portnotsupported');
|
|
}
|
|
|
|
return constant("self::{$type}");
|
|
}
|
|
}
|