<h2>File Contents: /home/planet5/www/wp-content/plugins/wordpress-seo-premium/inc/class-wpseo-endpoint-factory.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-content/plugins/wordpress-seo-premium/inc/class-wpseo-endpoint-factory.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * WPSEO plugin file.
 *
 * @package WPSEO\Internals
 */

/**
 * Class WPSEO_Endpoint_Factory.
 */
class WPSEO_Endpoint_Factory {

	/**
	 * The valid HTTP methods.
	 *
	 * @var array
	 */
	private $valid_http_methods = [
		&#039;GET&#039;,
		&#039;PATCH&#039;,
		&#039;POST&#039;,
		&#039;PUT&#039;,
		&#039;DELETE&#039;,
	];

	/**
	 * The arguments.
	 *
	 * @var array
	 */
	protected $args = [];

	/**
	 * The namespace.
	 *
	 * @var string
	 */
	private $namespace;

	/**
	 * The endpoint URL.
	 *
	 * @var string
	 */
	private $endpoint;

	/**
	 * The callback to execute if the endpoint is called.
	 *
	 * @var callable
	 */
	private $callback;

	/**
	 * The permission callback to execute to determine permissions.
	 *
	 * @var callable
	 */
	private $permission_callback;

	/**
	 * The HTTP method to use.
	 *
	 * @var string
	 */
	private $method;

	/**
	 * WPSEO_Endpoint_Factory constructor.
	 *
	 * @param string   $namespace           The endpoint&#039;s namespace.
	 * @param string   $endpoint            The endpoint&#039;s URL.
	 * @param callable $callback            The callback function to execute.
	 * @param callable $permission_callback The permission callback to execute to determine permissions.
	 * @param string   $method              The HTTP method to use. Defaults to GET.
	 *
	 * @throws WPSEO_Invalid_Argument_Exception The invalid argument exception.
	 */
	public function __construct( $namespace, $endpoint, $callback, $permission_callback, $method = WP_REST_Server::READABLE ) {
		if ( ! WPSEO_Validator::is_string( $namespace ) ) {
			throw WPSEO_Invalid_Argument_Exception::invalid_string_parameter( $namespace, &#039;namespace&#039; );
		}

		$this-&gt;namespace = $namespace;

		if ( ! WPSEO_Validator::is_string( $endpoint ) ) {
			throw WPSEO_Invalid_Argument_Exception::invalid_string_parameter( $endpoint, &#039;endpoint&#039; );
		}

		$this-&gt;endpoint = $endpoint;

		if ( ! is_callable( $callback ) ) {
			throw WPSEO_Invalid_Argument_Exception::invalid_callable_parameter( $callback, &#039;callback&#039; );
		}

		$this-&gt;callback = $callback;

		if ( ! is_callable( $permission_callback ) ) {
			throw WPSEO_Invalid_Argument_Exception::invalid_callable_parameter( $permission_callback, &#039;callback&#039; );
		}

		$this-&gt;permission_callback = $permission_callback;

		$this-&gt;method = $this-&gt;validate_method( $method );
	}

	/**
	 * Gets the associated arguments.
	 *
	 * @return array The arguments.
	 */
	public function get_arguments() {
		return $this-&gt;args;
	}

	/**
	 * Determines whether or not there are any arguments present.
	 *
	 * @return bool Whether or not any arguments are present.
	 */
	public function has_arguments() {
		return count( $this-&gt;args ) &gt; 0;
	}

	/**
	 * Registers the endpoint with WordPress.
	 *
	 * @return void
	 */
	public function register() {
		$config = [
			&#039;methods&#039;             =&gt; $this-&gt;method,
			&#039;callback&#039;            =&gt; $this-&gt;callback,
			&#039;permission_callback&#039; =&gt; $this-&gt;permission_callback,
		];

		if ( $this-&gt;has_arguments() ) {
			$config[&#039;args&#039;] = $this-&gt;args;
		}

		register_rest_route( $this-&gt;namespace, $this-&gt;endpoint, $config );
	}

	/**
	 * Validates the method parameter.
	 *
	 * @param string $method The set method parameter.
	 *
	 * @return string The validated method.
	 *
	 * @throws WPSEO_Invalid_Argument_Exception The invalid argument exception.
	 * @throws InvalidArgumentException         The invalid argument exception.
	 */
	protected function validate_method( $method ) {
		if ( ! WPSEO_Validator::is_string( $method ) ) {
			throw WPSEO_Invalid_Argument_Exception::invalid_string_parameter( $method, &#039;method&#039; );
		}

		if ( ! in_array( $method, $this-&gt;valid_http_methods, true ) ) {
			throw new InvalidArgumentException( sprintf( &#039;%s is not a valid HTTP method&#039;, $method ) );
		}

		return $method;
	}

	/**
	 * Adds an argument to the endpoint.
	 *
	 * @param string $name        The name of the argument.
	 * @param string $description The description associated with the argument.
	 * @param string $type        The type of value that can be assigned to the argument.
	 * @param bool   $required    Whether or not it&#039;s a required argument. Defaults to true.
	 *
	 * @return void
	 */
	protected function add_argument( $name, $description, $type, $required = true ) {
		if ( in_array( $name, array_keys( $this-&gt;args ), true ) ) {
			return;
		}

		$this-&gt;args[ $name ] = [
			&#039;description&#039; =&gt; $description,
			&#039;type&#039;        =&gt; $type,
			&#039;required&#039;    =&gt; $required,
		];
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-content%2Fplugins%2Fwordpress-seo-premium%2Finc'>⬅ Back to Directory</a>