] * : Set a custom title for the menu item. * * [--link=<link>] * : Set a custom url for the menu item. * * [--description=<description>] * : Set a custom description for the menu item. * * [--attr-title=<attr-title>] * : Set a custom title attribute for the menu item. * * [--target=<target>] * : Set a custom link target for the menu item. * * [--classes=<classes>] * : Set a custom link classes for the menu item. * * [--position=<position>] * : Specify the position of this menu item. * * [--parent-id=<parent-id>] * : Make this menu item a child of another menu item. * * [--porcelain] * : Output just the new menu item id. * * ## EXAMPLES * * $ wp menu item add-post sidebar-menu 33 --title="Custom Test Post" * Success: Menu item added. * * @subcommand add-post */ public function add_post( $args, $assoc_args ) { $assoc_args['object-id'] = $args[1]; unset( $args[1] ); $post = get_post( $assoc_args['object-id'] ); if ( ! $post ) { WP_CLI::error( 'Invalid post.' ); } $assoc_args['object'] = $post->post_type; $this->add_or_update_item( 'add', 'post_type', $args, $assoc_args ); } /** * Adds a taxonomy term as a menu item. * * ## OPTIONS * * <menu> * : The name, slug, or term ID for the menu. * * <taxonomy> * : Taxonomy of the term to be added. * * <term-id> * : Term ID of the term to be added. * * [--title=<title>] * : Set a custom title for the menu item. * * [--link=<link>] * : Set a custom url for the menu item. * * [--description=<description>] * : Set a custom description for the menu item. * * [--attr-title=<attr-title>] * : Set a custom title attribute for the menu item. * * [--target=<target>] * : Set a custom link target for the menu item. * * [--classes=<classes>] * : Set a custom link classes for the menu item. * * [--position=<position>] * : Specify the position of this menu item. * * [--parent-id=<parent-id>] * : Make this menu item a child of another menu item. * * [--porcelain] * : Output just the new menu item id. * * ## EXAMPLES * * $ wp menu item add-term sidebar-menu post_tag 24 * Success: Menu item added. * * @subcommand add-term */ public function add_term( $args, $assoc_args ) { $assoc_args['object'] = $args[1]; unset( $args[1] ); $assoc_args['object-id'] = $args[2]; unset( $args[2] ); if ( ! get_term_by( 'id', $assoc_args['object-id'], $assoc_args['object'] ) ) { WP_CLI::error( 'Invalid term.' ); } $this->add_or_update_item( 'add', 'taxonomy', $args, $assoc_args ); } /** * Adds a custom menu item. * * ## OPTIONS * * <menu> * : The name, slug, or term ID for the menu. * * <title> * : Title for the link. * * <link> * : Target URL for the link. * * [--description=<description>] * : Set a custom description for the menu item. * * [--attr-title=<attr-title>] * : Set a custom title attribute for the menu item. * * [--target=<target>] * : Set a custom link target for the menu item. * * [--classes=<classes>] * : Set a custom link classes for the menu item. * * [--position=<position>] * : Specify the position of this menu item. * * [--parent-id=<parent-id>] * : Make this menu item a child of another menu item. * * [--porcelain] * : Output just the new menu item id. * * ## EXAMPLES * * $ wp menu item add-custom sidebar-menu Apple http://apple.com * Success: Menu item added. * * @subcommand add-custom */ public function add_custom( $args, $assoc_args ) { $assoc_args['title'] = $args[1]; unset( $args[1] ); $assoc_args['link'] = $args[2]; unset( $args[2] ); $this->add_or_update_item( 'add', 'custom', $args, $assoc_args ); } /** * Updates a menu item. * * ## OPTIONS * * <db-id> * : Database ID for the menu item. * * [--title=<title>] * : Set a custom title for the menu item. * * [--link=<link>] * : Set a custom url for the menu item. * * [--description=<description>] * : Set a custom description for the menu item. * * [--attr-title=<attr-title>] * : Set a custom title attribute for the menu item. * * [--target=<target>] * : Set a custom link target for the menu item. * * [--classes=<classes>] * : Set a custom link classes for the menu item. * * [--position=<position>] * : Specify the position of this menu item. * * [--parent-id=<parent-id>] * : Make this menu item a child of another menu item. * * ## EXAMPLES * * $ wp menu item update 45 --title=WordPress --link='http://wordpress.org' --target=_blank --position=2 * Success: Menu item updated. * * @subcommand update */ public function update( $args, $assoc_args ) { // Shuffle the position of these. $args[1] = $args[0]; $terms = get_the_terms( $args[1], 'nav_menu' ); if ( $terms && ! is_wp_error( $terms ) ) { $args[0] = (int) $terms[0]->term_id; } else { $args[0] = 0; } $type = get_post_meta( $args[1], '_menu_item_type', true ); $this->add_or_update_item( 'update', $type, $args, $assoc_args ); } /** * Deletes one or more items from a menu. * * ## OPTIONS * * <db-id>... * : Database ID for the menu item(s). * * ## EXAMPLES * * $ wp menu item delete 45 * Success: Deleted 1 of 1 menu items. * * @subcommand delete */ public function delete( $args, $assoc_args ) { global $wpdb; $count = 0; $errors = 0; foreach ( $args as $arg ) { $post = get_post( $arg ); $menu_term = get_the_terms( $arg, 'nav_menu' ); $parent_menu_id = (int) get_post_meta( $arg, '_menu_item_menu_item_parent', true ); $result = wp_delete_post( $arg, true ); if ( ! $result ) { WP_CLI::warning( "Couldn't delete menu item {$arg}." ); ++$errors; } else { if ( is_array( $menu_term ) && ! empty( $menu_term ) && $post ) { $this->reorder_menu_items( $menu_term[0]->term_id, $post->menu_order, -1, 0 ); } if ( $parent_menu_id ) { $children = $wpdb->get_results( $wpdb->prepare( "SELECT post_id FROM $wpdb->postmeta WHERE meta_key='_menu_item_menu_item_parent' AND meta_value=%s", (int) $arg ) ); if ( $children ) { $children_query = $wpdb->prepare( "UPDATE $wpdb->postmeta SET meta_value = %d WHERE meta_key = '_menu_item_menu_item_parent' AND meta_value=%s", $parent_menu_id, (int) $arg ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- $children_query is already prepared above. $wpdb->query( $children_query ); foreach ( $children as $child ) { clean_post_cache( $child ); } } } } // phpcs:ignore Universal.Operators.StrictComparisons.LooseNotEqual -- Will increase count for non existent menu. if ( false != $result ) { ++$count; } } Utils\report_batch_operation_results( 'menu item', 'delete', count( $args ), $count, $errors ); } /** * Worker method to create new items or update existing ones. */ private function add_or_update_item( $method, $type, $args, $assoc_args ) { $menu = $args[0]; $menu_item_db_id = Utils\get_flag_value( $args, 1, 0 ); $menu = wp_get_nav_menu_object( $menu ); if ( ! $menu || is_wp_error( $menu ) ) { WP_CLI::error( 'Invalid menu.' ); } // `url` is protected in WP-CLI, so we use `link` instead $assoc_args['url'] = Utils\get_flag_value( $assoc_args, 'link' ); // Need to persist the menu item data. See https://core.trac.wordpress.org/ticket/28138 if ( 'update' === $method ) { $menu_item_obj = get_post( $menu_item_db_id ); $menu_item_obj = wp_setup_nav_menu_item( $menu_item_obj ); // Correct the menu position if this was the first item. See https://core.trac.wordpress.org/ticket/28140 $position = ( 0 === $menu_item_obj->menu_order ) ? 1 : $menu_item_obj->menu_order; $default_args = [ 'position' => $position, 'title' => $menu_item_obj->title, 'url' => $menu_item_obj->url, 'description' => $menu_item_obj->description, 'object' => $menu_item_obj->object, 'object-id' => $menu_item_obj->object_id, 'parent-id' => $menu_item_obj->menu_item_parent, 'attr-title' => $menu_item_obj->attr_title, 'target' => $menu_item_obj->target, 'classes' => implode( ' ', $menu_item_obj->classes ), // stored in the database as array 'xfn' => $menu_item_obj->xfn, 'status' => $menu_item_obj->post_status, ]; } else { $default_args = [ 'position' => 0, 'title' => '', 'url' => '', 'description' => '', 'object' => '', 'object-id' => 0, 'parent-id' => 0, 'attr-title' => '', 'target' => '', 'classes' => '', 'xfn' => '', // Core oddly defaults to 'draft' for create, // and 'publish' for update // Easiest to always work with publish 'status' => 'publish', ]; } $menu_item_args = []; foreach ( $default_args as $key => $default_value ) { // wp_update_nav_menu_item() has a weird argument prefix $new_key = 'menu-item-' . $key; $menu_item_args[ $new_key ] = Utils\get_flag_value( $assoc_args, $key, $default_value ); } $menu_item_args['menu-item-type'] = $type; $result = wp_update_nav_menu_item( $menu->term_id, $menu_item_db_id, $menu_item_args ); if ( is_wp_error( $result ) ) { WP_CLI::error( $result->get_error_message() ); } elseif ( ! $result ) { if ( 'add' === $method ) { WP_CLI::error( "Couldn't add menu item." ); } elseif ( 'update' === $method ) { WP_CLI::error( "Couldn't update menu item." ); } } else { if ( ( 'add' === $method ) && $menu_item_args['menu-item-position'] ) { $this->reorder_menu_items( $menu->term_id, $menu_item_args['menu-item-position'], +1, $result ); } /** * Set the menu * * wp_update_nav_menu_item() *should* take care of this, but * depends on wp_insert_post()'s "tax_input" argument, which * is ignored if the user can't edit the taxonomy * * @see https://core.trac.wordpress.org/ticket/27113 */ if ( ! is_object_in_term( $result, 'nav_menu', (int) $menu->term_id ) ) { wp_set_object_terms( $result, [ (int) $menu->term_id ], 'nav_menu' ); } if ( 'add' === $method && ! empty( $assoc_args['porcelain'] ) ) { WP_CLI::line( $result ); } elseif ( 'add' === $method ) { WP_CLI::success( 'Menu item added.' ); } elseif ( 'update' === $method ) { WP_CLI::success( 'Menu item updated.' ); } } } /** * Move block of items in one nav_menu up or down by incrementing/decrementing their menu_order field. * Expects the menu items to have proper menu_orders (i.e. doesn't fix errors from previous incorrect operations). * * @param int $menu_id ID of the nav_menu * @param int $min_position minimal menu_order to touch * @param int $increment how much to change menu_order: +1 to move down, -1 to move up * @param int $ignore_item_id menu item that should be ignored by the change (e.g. newly created menu item) * @return int number of rows affected */ private function reorder_menu_items( $menu_id, $min_position, $increment, $ignore_item_id = 0 ) { global $wpdb; return $wpdb->query( $wpdb->prepare( "UPDATE $wpdb->posts SET `menu_order`=`menu_order`+(%d) WHERE `menu_order`>=%d AND ID IN (SELECT object_id FROM $wpdb->term_relationships WHERE term_taxonomy_id=%d) AND ID<>%d", (int) $increment, (int) $min_position, (int) $menu_id, (int) $ignore_item_id ) ); } protected function get_formatter( &$assoc_args ) { return new Formatter( $assoc_args, $this->obj_fields ); } } <?php use WP_CLI\CommandWithMeta; use WP_CLI\Fetchers\User as UserFetcher; /** * Adds, updates, deletes, and lists user custom fields. * * ## EXAMPLES * * # Add user meta * $ wp user meta add 123 bio "Mary is an WordPress developer." * Success: Added custom field. * * # List user meta * $ wp user meta list 123 --keys=nickname,description,wp_capabilities * +---------+-----------------+--------------------------------+ * | user_id | meta_key | meta_value | * +---------+-----------------+--------------------------------+ * | 123 | nickname | supervisor | * | 123 | description | Mary is a WordPress developer. | * | 123 | wp_capabilities | {"administrator":true} | * +---------+-----------------+--------------------------------+ * * # Update user meta * $ wp user meta update 123 bio "Mary is an awesome WordPress developer." * Success: Updated custom field 'bio'. * * # Delete user meta * $ wp user meta delete 123 bio * Success: Deleted custom field. */ class User_Meta_Command extends CommandWithMeta { protected $meta_type = 'user'; private $fetcher; public function __construct() { $this->fetcher = new UserFetcher(); } /** * Lists all metadata associated with a user. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to get metadata for. * * [--keys=<keys>] * : Limit output to metadata of specific keys. * * [--fields=<fields>] * : Limit the output to specific row fields. Defaults to id,meta_key,meta_value. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - yaml * --- * * [--orderby=<fields>] * : Set orderby which field. * --- * default: id * options: * - id * - meta_key * - meta_value * --- * * [--order=<order>] * : Set ascending or descending order. * --- * default: asc * options: * - asc * - desc * --- * * [--unserialize] * : Unserialize meta_value output. * * ## EXAMPLES * * # List user meta * $ wp user meta list 123 --keys=nickname,description,wp_capabilities * +---------+-----------------+--------------------------------+ * | user_id | meta_key | meta_value | * +---------+-----------------+--------------------------------+ * | 123 | nickname | supervisor | * | 123 | description | Mary is a WordPress developer. | * | 123 | wp_capabilities | {"administrator":true} | * +---------+-----------------+--------------------------------+ * * @subcommand list */ public function list_( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); parent::list_( $args, $assoc_args ); } /** * Gets meta field value. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to get metadata for. * * <key> * : The metadata key. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## EXAMPLES * * # Get user meta * $ wp user meta get 123 bio * Mary is an WordPress developer. * * # Get the primary site of a user (for multisite) * $ wp user meta get 2 primary_blog * 3 */ public function get( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); parent::get( $args, $assoc_args ); } /** * Deletes a meta field. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to delete metadata from. * * <key> * : The metadata key. * * [<value>] * : The value to delete. If omitted, all rows with key will deleted. * * ## EXAMPLES * * # Delete user meta * $ wp user meta delete 123 bio * Success: Deleted custom field. */ public function delete( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); parent::delete( $args, $assoc_args ); } /** * Adds a meta field. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to add metadata for. * * <key> * : The metadata key. * * <value> * : The new metadata value. * * [--format=<format>] * : The serialization format for the value. * --- * default: plaintext * options: * - plaintext * - json * --- * * ## EXAMPLES * * # Add user meta * $ wp user meta add 123 bio "Mary is an WordPress developer." * Success: Added custom field. */ public function add( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); parent::add( $args, $assoc_args ); } /** * Updates a meta field. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to update metadata for. * * <key> * : The metadata key. * * <value> * : The new metadata value. * * [--format=<format>] * : The serialization format for the value. * --- * default: plaintext * options: * - plaintext * - json * --- * * ## EXAMPLES * * # Update user meta * $ wp user meta update 123 bio "Mary is an awesome WordPress developer." * Success: Updated custom field 'bio'. * * @alias set */ public function update( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); parent::update( $args, $assoc_args ); } /** * Wrapper method for add_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param bool $unique Optional, default is false. Whether the * specified metadata key should be unique for the * object. If true, and the object already has a * value for the specified metadata key, no change * will be made. * * @return int|false The meta ID on success, false on failure. */ protected function add_metadata( $object_id, $meta_key, $meta_value, $unique = false ) { return add_user_meta( $object_id, $meta_key, $meta_value, $unique ); } /** * Wrapper method for update_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param mixed $prev_value Optional. If specified, only update existing * metadata entries with the specified value. * Otherwise, update all entries. * * @return int|bool Meta ID if the key didn't exist, true on successful * update, false on failure. */ protected function update_metadata( $object_id, $meta_key, $meta_value, $prev_value = '' ) { return update_user_meta( $object_id, $meta_key, $meta_value, $prev_value ); } /** * Wrapper method for get_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Optional. Metadata key. If not specified, * retrieve all metadata for the specified object. * @param bool $single Optional, default is false. If true, return only * the first value of the specified meta_key. This * parameter has no effect if meta_key is not * specified. * * @return mixed Single metadata value, or array of values. */ protected function get_metadata( $object_id, $meta_key = '', $single = false ) { return get_user_meta( $object_id, $meta_key, $single ); } /** * Wrapper method for delete_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object metadata is for * @param string $meta_key Metadata key * @param mixed $meta_value Optional. Metadata value. Must be serializable * if non-scalar. If specified, only delete * metadata entries with this value. Otherwise, * delete all entries with the specified meta_key. * Pass `null, `false`, or an empty string to skip * this check. For backward compatibility, it is * not possible to pass an empty string to delete * those entries with an empty string for a value. * * @return bool True on successful delete, false on failure. */ protected function delete_metadata( $object_id, $meta_key, $meta_value = '' ) { return delete_user_meta( $object_id, $meta_key, $meta_value ); } /** * Replaces user_login value with user ID * user meta is a special case that also supports user_login * * @param array * @return array */ private function replace_login_with_user_id( $args ) { $user = $this->fetcher->get_check( $args[0] ); $args[0] = $user->ID; return $args; } } <?php use WP_CLI\CommandWithTerms; use WP_CLI\Fetchers\Post as PostFetcher; /** * Adds, updates, removes, and lists post terms. * * ## EXAMPLES * * # Set category post term `test` to the post ID 123 * $ wp post term set 123 test category * Success: Set term. * * # Set category post terms `test` and `apple` to the post ID 123 * $ wp post term set 123 test apple category * Success: Set terms. * * # List category post terms for the post ID 123 * $ wp post term list 123 category --fields=term_id,slug * +---------+-------+ * | term_id | slug | * +---------+-------+ * | 2 | apple | * | 3 | test | * +----------+------+ * * # Remove category post terms `test` and `apple` for the post ID 123 * $ wp post term remove 123 category test apple * Success: Removed terms. * */ class Post_Term_Command extends CommandWithTerms { protected $obj_type = 'post'; private $fetcher; public function __construct() { $this->fetcher = new PostFetcher(); } protected function get_object_type() { $post = $this->fetcher->get_check( $this->get_obj_id() ); return $post->post_type; } } <?php use WP_CLI\CommandWithMeta; use WP_CLI\Fetchers\Post as PostFetcher; /** * Adds, updates, deletes, and lists post custom fields. * * ## EXAMPLES * * # Set post meta * $ wp post meta set 123 _wp_page_template about.php * Success: Updated custom field '_wp_page_template'. * * # Get post meta * $ wp post meta get 123 _wp_page_template * about.php * * # Update post meta * $ wp post meta update 123 _wp_page_template contact.php * Success: Updated custom field '_wp_page_template'. * * # Delete post meta * $ wp post meta delete 123 _wp_page_template * Success: Deleted custom field. */ class Post_Meta_Command extends CommandWithMeta { protected $meta_type = 'post'; /** * Check that the post ID exists * * @param int */ protected function check_object_id( $object_id ) { $fetcher = new PostFetcher(); $post = $fetcher->get_check( $object_id ); return $post->ID; } /** * Wrapper method for add_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param bool $unique Optional, default is false. Whether the * specified metadata key should be unique for the * object. If true, and the object already has a * value for the specified metadata key, no change * will be made. * * @return int|false The meta ID on success, false on failure. */ protected function add_metadata( $object_id, $meta_key, $meta_value, $unique = false ) { return add_post_meta( $object_id, $meta_key, $meta_value, $unique ); } /** * Wrapper method for update_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param mixed $prev_value Optional. If specified, only update existing * metadata entries with the specified value. * Otherwise, update all entries. * * @return int|bool Meta ID if the key didn't exist, true on successful * update, false on failure. */ protected function update_metadata( $object_id, $meta_key, $meta_value, $prev_value = '' ) { return update_post_meta( $object_id, $meta_key, $meta_value, $prev_value ); } /** * Wrapper method for get_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Optional. Metadata key. If not specified, * retrieve all metadata for the specified object. * @param bool $single Optional, default is false. If true, return only * the first value of the specified meta_key. This * parameter has no effect if meta_key is not * specified. * * @return mixed Single metadata value, or array of values. */ protected function get_metadata( $object_id, $meta_key = '', $single = false ) { return get_post_meta( $object_id, $meta_key, $single ); } /** * Wrapper method for delete_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object metadata is for * @param string $meta_key Metadata key * @param mixed $meta_value Optional. Metadata value. Must be serializable * if non-scalar. If specified, only delete * metadata entries with this value. Otherwise, * delete all entries with the specified meta_key. * Pass `null, `false`, or an empty string to skip * this check. For backward compatibility, it is * not possible to pass an empty string to delete * those entries with an empty string for a value. * * @return bool True on successful delete, false on failure. */ protected function delete_metadata( $object_id, $meta_key, $meta_value = '' ) { return delete_post_meta( $object_id, $meta_key, $meta_value ); } /** * Cleans up duplicate post meta values on a post. * * ## OPTIONS * * <id> * : ID of the post to clean. * * <key> * : Meta key to clean up. * * ## EXAMPLES * * # Delete duplicate post meta. * wp post meta clean-duplicates 1234 enclosure * Success: Cleaned up duplicate 'enclosure' meta values. * * @subcommand clean-duplicates */ public function clean_duplicates( $args, $assoc_args ) { global $wpdb; list( $post_id, $key ) = $args; $metas = $wpdb->get_results( $wpdb->prepare( "SELECT * FROM {$wpdb->postmeta} WHERE meta_key=%s AND post_id=%d", $key, $post_id ) ); if ( empty( $metas ) ) { WP_CLI::error( sprintf( 'No meta values found for \'%s\'.', $key ) ); } $uniq_metas = array(); $dupe_metas = array(); foreach ( $metas as $meta ) { if ( ! isset( $uniq_metas[ $meta->meta_value ] ) ) { $uniq_metas[ $meta->meta_value ] = (int) $meta->meta_id; } else { $dupe_metas[] = (int) $meta->meta_id; } } if ( count( $dupe_metas ) ) { WP_CLI::confirm( sprintf( 'Are you sure you want to delete %d duplicate meta values and keep %d valid meta value?', count( $dupe_metas ), count( $uniq_metas ) ) ); foreach ( $dupe_metas as $meta_id ) { delete_metadata_by_mid( 'post', $meta_id ); WP_CLI::log( sprintf( 'Deleted meta id %d.', $meta_id ) ); } WP_CLI::success( sprintf( 'Cleaned up duplicate \'%s\' meta values.', $key ) ); } else { WP_CLI::success( sprintf( 'Nothing to clean up: found %d valid meta value and %d duplicates.', count( $uniq_metas ), count( $dupe_metas ) ) ); } } } <?php use WP_CLI\CommandWithTerms; /** * Adds, updates, removes, and lists user terms. * * ## EXAMPLES * * # Set user terms * $ wp user term set 123 test category * Success: Set terms. */ class User_Term_Command extends CommandWithTerms { protected $obj_type = 'user'; } <?php use WP_CLI\Formatter; use WP_CLI\Traverser\RecursiveDataStructureTraverser; use WP_CLI\Utils; /** * Retrieves and sets site options, including plugin and WordPress settings. * * See the [Plugin Settings API](https://developer.wordpress.org/plugins/settings/settings-api/) and the [Theme Options](https://developer.wordpress.org/themes/customize-api/) for more information on adding customized options. * * ## EXAMPLES * * # Get site URL. * $ wp option get siteurl * http://example.com * * # Add option. * $ wp option add my_option foobar * Success: Added 'my_option' option. * * # Update option. * $ wp option update my_option '{"foo": "bar"}' --format=json * Success: Updated 'my_option' option. * * # Delete option. * $ wp option delete my_option * Success: Deleted 'my_option' option. * * @package wp-cli */ class Option_Command extends WP_CLI_Command { /** * Gets the value for an option. * * ## OPTIONS * * <key> * : Key for the option. * * [--format=<format>] * : Get value in a particular format. * --- * default: var_export * options: * - var_export * - json * - yaml * --- * * ## EXAMPLES * * # Get option. * $ wp option get home * http://example.com * * # Get blog description. * $ wp option get blogdescription * A random blog description * * # Get blog name * $ wp option get blogname * A random blog name * * # Get admin email. * $ wp option get admin_email * someone@example.com * * # Get option in JSON format. * $ wp option get active_plugins --format=json * {"0":"dynamically-dynamic-sidebar\/dynamically-dynamic-sidebar.php","1":"monster-widget\/monster-widget.php","2":"show-current-template\/show-current-template.php","3":"theme-check\/theme-check.php","5":"wordpress-importer\/wordpress-importer.php"} */ public function get( $args, $assoc_args ) { list( $key ) = $args; $value = get_option( $key ); if ( false === $value ) { WP_CLI::error( "Could not get '{$key}' option. Does it exist?" ); } WP_CLI::print_value( $value, $assoc_args ); } /** * Adds a new option value. * * Errors if the option already exists. * * ## OPTIONS * * <key> * : The name of the option to add. * * [<value>] * : The value of the option to add. If omitted, the value is read from STDIN. * * [--format=<format>] * : The serialization format for the value. * --- * default: plaintext * options: * - plaintext * - json * --- * * [--autoload=<autoload>] * : Should this option be automatically loaded. * --- * options: * - 'on' * - 'off' * - 'yes' * - 'no' * --- * * ## EXAMPLES * * # Create an option by reading a JSON file. * $ wp option add my_option --format=json < config.json * Success: Added 'my_option' option. */ public function add( $args, $assoc_args ) { $key = $args[0]; $value = WP_CLI::get_value_from_arg_or_stdin( $args, 1 ); $value = WP_CLI::read_value( $value, $assoc_args ); if ( in_array( Utils\get_flag_value( $assoc_args, 'autoload' ), [ 'no', 'off' ], true ) ) { $autoload = 'no'; } else { $autoload = 'yes'; } if ( ! add_option( $key, $value, '', $autoload ) ) { WP_CLI::error( "Could not add option '{$key}'. Does it already exist?" ); } else { WP_CLI::success( "Added '{$key}' option." ); } } /** * Lists options and their values. * * ## OPTIONS * * [--search=<pattern>] * : Use wildcards ( * and ? ) to match option name. * * [--exclude=<pattern>] * : Pattern to exclude. Use wildcards ( * and ? ) to match option name. * * [--autoload=<value>] * : Match only autoload options when value is on, and only not-autoload option when off. * * [--transients] * : List only transients. Use `--no-transients` to ignore all transients. * * [--unserialize] * : Unserialize option values in output. * * [--field=<field>] * : Prints the value of a single field. * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : The serialization format for the value. total_bytes displays the total size of matching options in bytes. * --- * default: table * options: * - table * - json * - csv * - count * - yaml * - total_bytes * --- * * [--orderby=<fields>] * : Set orderby which field. * --- * default: option_id * options: * - option_id * - option_name * - option_value * --- * * [--order=<order>] * : Set ascending or descending order. * --- * default: asc * options: * - asc * - desc * --- * * ## AVAILABLE FIELDS * * This field will be displayed by default for each matching option: * * * option_name * * option_value * * These fields are optionally available: * * * autoload * * size_bytes * * ## EXAMPLES * * # Get the total size of all autoload options. * $ wp option list --autoload=on --format=total_bytes * 33198 * * # Find biggest transients. * $ wp option list --search="*_transient_*" --fields=option_name,size_bytes | sort -n -k 2 | tail * option_name size_bytes * _site_transient_timeout_theme_roots 10 * _site_transient_theme_roots 76 * _site_transient_update_themes 181 * _site_transient_update_core 808 * _site_transient_update_plugins 6645 * * # List all options beginning with "i2f_". * $ wp option list --search="i2f_*" * +-------------+--------------+ * | option_name | option_value | * +-------------+--------------+ * | i2f_version | 0.1.0 | * +-------------+--------------+ * * # Delete all options beginning with "theme_mods_". * $ wp option list --search="theme_mods_*" --field=option_name | xargs -I % wp option delete % * Success: Deleted 'theme_mods_twentysixteen' option. * Success: Deleted 'theme_mods_twentyfifteen' option. * Success: Deleted 'theme_mods_twentyfourteen' option. * * @subcommand list */ public function list_( $args, $assoc_args ) { global $wpdb; $pattern = '%'; $exclude = ''; $fields = array( 'option_name', 'option_value' ); $size_query = ',LENGTH(option_value) AS `size_bytes`'; $autoload_query = ''; if ( isset( $assoc_args['search'] ) ) { $pattern = self::esc_like( $assoc_args['search'] ); // substitute wildcards $pattern = str_replace( '*', '%', $pattern ); $pattern = str_replace( '?', '_', $pattern ); } if ( isset( $assoc_args['exclude'] ) ) { $exclude = self::esc_like( $assoc_args['exclude'] ); $exclude = str_replace( '*', '%', $exclude ); $exclude = str_replace( '?', '_', $exclude ); } if ( isset( $assoc_args['fields'] ) ) { $fields = explode( ',', $assoc_args['fields'] ); } if ( Utils\get_flag_value( $assoc_args, 'format' ) === 'total_bytes' ) { $fields = array( 'size_bytes' ); $size_query = ',SUM(LENGTH(option_value)) AS `size_bytes`'; } if ( isset( $assoc_args['autoload'] ) ) { $autoload = $assoc_args['autoload']; if ( 'on' === $autoload || 'yes' === $autoload ) { $autoload_query = " AND (autoload='on') OR (autoload='yes')"; } elseif ( 'off' === $autoload || 'no' === $autoload ) { $autoload_query = " AND (autoload='off') OR (autoload='no')"; } else { WP_CLI::error( "Value of '--autoload' should be 'on', 'off', 'yes', or 'no'." ); } } // By default we don't want to display transients. $show_transients = Utils\get_flag_value( $assoc_args, 'transients', false ); if ( $show_transients ) { $transients_query = " AND option_name LIKE '\_transient\_%' OR option_name LIKE '\_site\_transient\_%'"; } else { $transients_query = " AND option_name NOT LIKE '\_transient\_%' AND option_name NOT LIKE '\_site\_transient\_%'"; } $where = ''; if ( $pattern ) { $where .= $wpdb->prepare( 'WHERE `option_name` LIKE %s', $pattern ); } if ( $exclude ) { $where .= $wpdb->prepare( ' AND `option_name` NOT LIKE %s', $exclude ); } $where .= $autoload_query . $transients_query; // phpcs:disable WordPress.DB.PreparedSQL -- Hardcoded query parts without user input. $results = $wpdb->get_results( 'SELECT `option_name`,`option_value`,`autoload`' . $size_query . " FROM `$wpdb->options` {$where}" ); // phpcs:enable $orderby = Utils\get_flag_value( $assoc_args, 'orderby' ); $order = Utils\get_flag_value( $assoc_args, 'order' ); // Sort result. if ( 'option_id' !== $orderby ) { usort( $results, function ( $a, $b ) use ( $orderby, $order ) { // Sort array. return 'asc' === $order ? $a->$orderby > $b->$orderby : $a->$orderby < $b->$orderby; } ); } elseif ( 'option_id' === $orderby && 'desc' === $order ) { // Sort by default descending. krsort( $results ); } if ( true === Utils\get_flag_value( $assoc_args, 'unserialize', null ) ) { foreach ( $results as $k => &$v ) { if ( ! empty( $v->option_value ) ) { $v->option_value = maybe_unserialize( $v->option_value ); } } } if ( Utils\get_flag_value( $assoc_args, 'format' ) === 'total_bytes' ) { WP_CLI::line( $results[0]->size_bytes ); } else { $formatter = new Formatter( $assoc_args, $fields ); $formatter->display_items( $results ); } } /** * Updates an option value. * * ## OPTIONS * * <key> * : The name of the option to update. * * [<value>] * : The new value. If omitted, the value is read from STDIN. * * [--autoload=<autoload>] * : Requires WP 4.2. Should this option be automatically loaded. * --- * options: * - 'on' * - 'off' * - 'yes' * - 'no' * --- * * [--format=<format>] * : The serialization format for the value. * --- * default: plaintext * options: * - plaintext * - json * --- * * ## EXAMPLES * * # Update an option by reading from a file. * $ wp option update my_option < value.txt * Success: Updated 'my_option' option. * * # Update one option on multiple sites using xargs. * $ wp site list --field=url | xargs -n1 -I {} sh -c 'wp --url={} option update my_option my_value' * Success: Updated 'my_option' option. * Success: Updated 'my_option' option. * * # Update site blog name. * $ wp option update blogname "Random blog name" * Success: Updated 'blogname' option. * * # Update site blog description. * $ wp option update blogdescription "Some random blog description" * Success: Updated 'blogdescription' option. * * # Update admin email address. * $ wp option update admin_email someone@example.com * Success: Updated 'admin_email' option. * * # Set the default role. * $ wp option update default_role author * Success: Updated 'default_role' option. * * # Set the timezone string. * $ wp option update timezone_string "America/New_York" * Success: Updated 'timezone_string' option. * * @alias set */ public function update( $args, $assoc_args ) { $key = $args[0]; $value = WP_CLI::get_value_from_arg_or_stdin( $args, 1 ); $value = WP_CLI::read_value( $value, $assoc_args ); $autoload = Utils\get_flag_value( $assoc_args, 'autoload' ); if ( ! in_array( $autoload, [ 'on', 'off', 'yes', 'no' ], true ) ) { $autoload = null; } $value = sanitize_option( $key, $value ); // Sanitization WordPress normally performs when getting an option if ( in_array( $key, [ 'siteurl', 'home', 'category_base', 'tag_base' ], true ) ) { $value = untrailingslashit( $value ); } $old_value = sanitize_option( $key, get_option( $key ) ); if ( $value === $old_value && null === $autoload ) { WP_CLI::success( "Value passed for '{$key}' option is unchanged." ); } elseif ( update_option( $key, $value, $autoload ) ) { WP_CLI::success( "Updated '{$key}' option." ); } else { WP_CLI::error( "Could not update option '{$key}'." ); } } /** * Gets the 'autoload' value for an option. * * ## OPTIONS * * <key> * : The name of the option to get 'autoload' of. * * ## EXAMPLES * * # Get the 'autoload' value for an option. * $ wp option get-autoload blogname * yes * * @subcommand get-autoload */ public function get_autoload( $args ) { global $wpdb; list( $option ) = $args; $existing = $wpdb->get_row( $wpdb->prepare( "SELECT autoload FROM $wpdb->options WHERE option_name=%s", $option ) ); if ( ! $existing ) { WP_CLI::error( "Could not get '{$option}' option. Does it exist?" ); } WP_CLI::log( $existing->autoload ); } /** * Sets the 'autoload' value for an option. * * ## OPTIONS * * <key> * : The name of the option to set 'autoload' for. * * <autoload> * : Should this option be automatically loaded. * --- * options: * - 'on' * - 'off' * - 'yes' * - 'no' * --- * * ## EXAMPLES * * # Set the 'autoload' value for an option. * $ wp option set-autoload abc_options no * Success: Updated autoload value for 'abc_options' option. * * @subcommand set-autoload */ public function set_autoload( $args ) { global $wpdb; list( $option, $autoload ) = $args; $previous = $wpdb->get_row( $wpdb->prepare( "SELECT autoload, option_value FROM $wpdb->options WHERE option_name=%s", $option ) ); if ( ! $previous ) { WP_CLI::error( "Could not get '{$option}' option. Does it exist?" ); } if ( $previous->autoload === $autoload ) { WP_CLI::success( "Autoload value passed for '{$option}' option is unchanged." ); return; } $wpdb->update( $wpdb->options, array( 'autoload' => $autoload ), array( 'option_name' => $option ) ); // Recreate cache refreshing from update_option(). $notoptions = wp_cache_get( 'notoptions', 'options' ); if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) { unset( $notoptions[ $option ] ); wp_cache_set( 'notoptions', $notoptions, 'options' ); } if ( ! defined( 'WP_INSTALLING' ) ) { $alloptions = wp_load_alloptions( true ); if ( isset( $alloptions[ $option ] ) ) { $alloptions[ $option ] = $previous->option_value; wp_cache_set( 'alloptions', $alloptions, 'options' ); } else { wp_cache_set( $option, $previous->option_value, 'options' ); } } WP_CLI::success( "Updated autoload value for '{$option}' option." ); } /** * Deletes an option. * * ## OPTIONS * * <key>... * : Key for the option. * * ## EXAMPLES * * # Delete an option. * $ wp option delete my_option * Success: Deleted 'my_option' option. * * # Delete multiple options. * $ wp option delete option_one option_two option_three * Success: Deleted 'option_one' option. * Success: Deleted 'option_two' option. * Warning: Could not delete 'option_three' option. Does it exist? */ public function delete( $args ) { foreach ( $args as $arg ) { if ( ! delete_option( $arg ) ) { WP_CLI::warning( "Could not delete '{$arg}' option. Does it exist?" ); } else { WP_CLI::success( "Deleted '{$arg}' option." ); } } } /** * Gets a nested value from an option. * * ## OPTIONS * * <key> * : The option name. * * <key-path>... * : The name(s) of the keys within the value to locate the value to pluck. * * [--format=<format>] * : The output format of the value. * --- * default: plaintext * options: * - plaintext * - json * - yaml * --- */ public function pluck( $args, $assoc_args ) { list( $key ) = $args; $value = get_option( $key ); if ( false === $value ) { WP_CLI::halt( 1 ); } $key_path = array_map( function ( $key ) { if ( is_numeric( $key ) && ( (string) intval( $key ) === $key ) ) { return (int) $key; } return $key; }, array_slice( $args, 1 ) ); $traverser = new RecursiveDataStructureTraverser( $value ); try { $value = $traverser->get( $key_path ); } catch ( Exception $exception ) { die( 1 ); } WP_CLI::print_value( $value, $assoc_args ); } /** * Updates a nested value in an option. * * ## OPTIONS * * <action> * : Patch action to perform. * --- * options: * - insert * - update * - delete * --- * * <key> * : The option name. * * <key-path>... * : The name(s) of the keys within the value to locate the value to patch. * * [<value>] * : The new value. If omitted, the value is read from STDIN. * * [--format=<format>] * : The serialization format for the value. * --- * default: plaintext * options: * - plaintext * - json * --- * * ## EXAMPLES * * # Add 'bar' to the 'foo' key on an option with name 'option_name' * $ wp option patch insert option_name foo bar * Success: Updated 'option_name' option. * * # Update the value of 'foo' key to 'new' on an option with name 'option_name' * $ wp option patch update option_name foo new * Success: Updated 'option_name' option. * * # Set nested value of 'bar' key to value we have in the patch file on an option with name 'option_name'. * $ wp option patch update option_name foo bar < patch * Success: Updated 'option_name' option. * * # Update the value for the key 'not-a-key' which is not exist on an option with name 'option_name'. * $ wp option patch update option_name foo not-a-key new-value * Error: No data exists for key "not-a-key" * * # Update the value for the key 'foo' without passing value on an option with name 'option_name'. * $ wp option patch update option_name foo * Error: Please provide value to update. * * # Delete the nested key 'bar' under 'foo' key on an option with name 'option_name'. * $ wp option patch delete option_name foo bar * Success: Updated 'option_name' option. */ public function patch( $args, $assoc_args ) { list( $action, $key ) = $args; $key_path = array_map( function ( $key ) { if ( is_numeric( $key ) && ( (string) intval( $key ) === $key ) ) { return (int) $key; } return $key; }, array_slice( $args, 2 ) ); if ( 'delete' === $action ) { $patch_value = null; } else { $stdin_value = Utils\has_stdin() ? trim( WP_CLI::get_value_from_arg_or_stdin( $args, -1 ) ) : null; if ( ! empty( $stdin_value ) ) { $patch_value = WP_CLI::read_value( $stdin_value, $assoc_args ); } elseif ( count( $key_path ) > 1 ) { $patch_value = WP_CLI::read_value( array_pop( $key_path ), $assoc_args ); } else { $patch_value = null; } if ( null === $patch_value ) { WP_CLI::error( 'Please provide value to update.' ); } } /* Need to make a copy of $current_value here as it is modified by reference */ $old_value = sanitize_option( $key, get_option( $key ) ); $current_value = $old_value; if ( is_object( $current_value ) ) { $old_value = clone $current_value; } $traverser = new RecursiveDataStructureTraverser( $current_value ); try { $traverser->$action( $key_path, $patch_value ); } catch ( Exception $exception ) { WP_CLI::error( $exception->getMessage() ); } $patched_value = sanitize_option( $key, $traverser->value() ); if ( $patched_value === $old_value ) { WP_CLI::success( "Value passed for '{$key}' option is unchanged." ); } elseif ( update_option( $key, $patched_value ) ) { WP_CLI::success( "Updated '{$key}' option." ); } else { WP_CLI::error( "Could not update option '{$key}'." ); } } private static function esc_like( $old ) { global $wpdb; // Remove notices in 4.0 and support backwards compatibility if ( method_exists( $wpdb, 'esc_like' ) ) { // 4.0 $old = $wpdb->esc_like( $old ); } else { // phpcs:ignore WordPress.WP.DeprecatedFunctions.like_escapeFound -- called in WordPress 3.9 or less. $old = like_escape( esc_sql( $old ) ); } return $old; } } <?php use WP_CLI\ExitException; use WP_CLI\Fetchers\User as UserFetcher; use WP_CLI\Formatter; use WP_CLI\Utils; /** * Creates, updates, deletes, lists and retrieves application passwords. * * ## EXAMPLES * * # List user application passwords and only show app name and password hash * $ wp user application-password list 123 --fields=name,password * +--------+------------------------------------+ * | name | password | * +--------+------------------------------------+ * | myapp | $P$BVGeou1CUot114YohIemgpwxQCzb8O/ | * +--------+------------------------------------+ * * # Get a specific application password and only show app name and created timestamp * $ wp user application-password get 123 6633824d-c1d7-4f79-9dd5-4586f734d69e --fields=name,created * +--------+------------+ * | name | created | * +--------+------------+ * | myapp | 1638395611 | * +--------+------------+ * * # Create user application password * $ wp user application-password create 123 myapp * Success: Created application password. * Password: ZG1bxdxdzjTwhsY8vK8l1C65 * * # Only print the password without any chrome * $ wp user application-password create 123 myapp --porcelain * ZG1bxdxdzjTwhsY8vK8l1C65 * * # Update an existing application password * $ wp user application-password update 123 6633824d-c1d7-4f79-9dd5-4586f734d69e --name=newappname * Success: Updated application password. * * # Delete an existing application password * $ wp user application-password delete 123 6633824d-c1d7-4f79-9dd5-4586f734d69e * Success: Deleted 1 of 1 application password. * * # Check if an application password for a given application exists * $ wp user application-password exists 123 myapp * $ echo $? * 1 * * # Bash script for checking whether an application password exists and creating one if not * if ! wp user application-password exists 123 myapp; then * PASSWORD=$(wp user application-password create 123 myapp --porcelain) * fi */ final class User_Application_Password_Command { /** * List of application password fields. * * @var array<string> */ const APPLICATION_PASSWORD_FIELDS = [ 'uuid', 'app_id', 'name', 'password', 'created', 'last_used', 'last_ip', ]; /** * Lists all application passwords associated with a user. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to get application passwords for. * * [--<field>=<value>] * : Filter the list by a specific field. * * [--field=<field>] * : Prints the value of a single field for each application password. * * [--fields=<fields>] * : Limit the output to specific fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - yaml * - ids * --- * * [--orderby=<fields>] * : Set orderby which field. * --- * default: created * options: * - uuid * - app_id * - name * - password * - created * - last_used * - last_ip * --- * * [--order=<order>] * : Set ascending or descending order. * --- * default: desc * options: * - asc * - desc * --- * * ## EXAMPLES * * # List user application passwords and only show app name and password hash * $ wp user application-password list 123 --fields=name,password * +--------+------------------------------------+ * | name | password | * +--------+------------------------------------+ * | myapp | $P$BVGeou1CUot114YohIemgpwxQCzb8O/ | * +--------+------------------------------------+ * * @subcommand list * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the user could not be found/parsed. * @throws ExitException If the application passwords could not be retrieved. */ public function list_( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); list( $user_id ) = $args; $application_passwords = WP_Application_Passwords::get_user_application_passwords( $user_id ); if ( $application_passwords instanceof WP_Error ) { WP_CLI::error( $application_passwords ); } if ( empty( $application_passwords ) ) { $application_passwords = []; } $order = Utils\get_flag_value( $assoc_args, 'order' ); $orderby = Utils\get_flag_value( $assoc_args, 'orderby' ); usort( $application_passwords, static function ( $a, $b ) use ( $orderby, $order ) { // Sort array. return 'asc' === $order ? $a[ $orderby ] > $b[ $orderby ] : $a[ $orderby ] < $b[ $orderby ]; } ); $fields = self::APPLICATION_PASSWORD_FIELDS; // Avoid confusion regarding the dash/underscore usage. foreach ( [ 'app-id', 'last-used', 'last-ip' ] as $flag ) { if ( array_key_exists( $flag, $assoc_args ) ) { $underscored_flag = str_replace( '-', '_', $flag ); $assoc_args[ $underscored_flag ] = $assoc_args[ $flag ]; unset( $assoc_args[ $flag ] ); } } foreach ( $fields as $field ) { if ( ! array_key_exists( $field, $assoc_args ) ) { continue; } $value = Utils\get_flag_value( $assoc_args, $field ); $application_passwords = array_filter( $application_passwords, static function ( $application_password ) use ( $field, $value ) { return $application_password[ $field ] === $value; } ); } if ( ! empty( $assoc_args['fields'] ) ) { $fields = explode( ',', $assoc_args['fields'] ); } $format = Utils\get_flag_value( $assoc_args, 'format', 'table' ); $formatter = new Formatter( $assoc_args, $fields ); if ( 'ids' === $format ) { $formatter->display_items( wp_list_pluck( $application_passwords, 'uuid' ) ); } else { $formatter->display_items( $application_passwords ); } } /** * Gets a specific application password. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to get the application password for. * * <uuid> * : The universally unique ID of the application password. * * [--field=<field>] * : Prints the value of a single field for the application password. * * [--fields=<fields>] * : Limit the output to specific fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## EXAMPLES * * # Get a specific application password and only show app name and created timestamp * $ wp user application-password get 123 6633824d-c1d7-4f79-9dd5-4586f734d69e --fields=name,created * +--------+------------+ * | name | created | * +--------+------------+ * | myapp | 1638395611 | * +--------+------------+ * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the application passwords could not be retrieved. */ public function get( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); list( $user_id, $uuid ) = $args; $application_password = WP_Application_Passwords::get_user_application_password( $user_id, $uuid ); if ( $application_password instanceof WP_Error ) { WP_CLI::error( $application_password ); } if ( null === $application_password ) { WP_CLI::error( 'No application password found for this user ID and UUID.' ); } $fields = self::APPLICATION_PASSWORD_FIELDS; if ( ! empty( $assoc_args['fields'] ) ) { $fields = explode( ',', $assoc_args['fields'] ); } $formatter = new Formatter( $assoc_args, $fields ); $formatter->display_items( [ $application_password ] ); } /** * Creates a new application password. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to create a new application password for. * * <app-name> * : Unique name of the application to create an application password for. * * [--app-id=<app-id>] * : Application ID to attribute to the application password. * * [--porcelain] * : Output just the new password. * * ## EXAMPLES * * # Create user application password * $ wp user application-password create 123 myapp * Success: Created application password. * Password: ZG1bxdxdzjTwhsY8vK8l1C65 * * # Only print the password without any chrome * $ wp user application-password create 123 myapp --porcelain * ZG1bxdxdzjTwhsY8vK8l1C65 * * # Create user application with a custom application ID for internal tracking * $ wp user application-password create 123 myapp --app-id=42 --porcelain * ZG1bxdxdzjTwhsY8vK8l1C65 * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the application password could not be created. */ public function create( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); list( $user_id, $app_name ) = $args; $app_id = Utils\get_flag_value( $assoc_args, 'app-id', '' ); $arguments = [ 'name' => $app_name, 'app_id' => $app_id, ]; $result = WP_Application_Passwords::create_new_application_password( $user_id, $arguments ); if ( $result instanceof WP_Error ) { WP_CLI::error( $result ); } if ( Utils\get_flag_value( $assoc_args, 'porcelain', false ) ) { WP_CLI::line( $result[0] ); WP_CLI::halt( 0 ); } WP_CLI::success( 'Created application password.' ); WP_CLI::line( "Password: {$result[0]}" ); } /** * Updates an existing application password. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to update the application password for. * * <uuid> * : The universally unique ID of the application password. * * [--<field>=<value>] * : Update the <field> with a new <value>. Currently supported fields: name. * * ## EXAMPLES * * # Update an existing application password * $ wp user application-password update 123 6633824d-c1d7-4f79-9dd5-4586f734d69e --name=newappname * Success: Updated application password. * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the application password could not be created. */ public function update( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); list( $user_id, $uuid ) = $args; $result = WP_Application_Passwords::update_application_password( $user_id, $uuid, $assoc_args ); if ( $result instanceof WP_Error ) { WP_CLI::error( $result ); } WP_CLI::success( 'Updated application password.' ); } /** * Record usage of an application password. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to update the application password for. * * <uuid> * : The universally unique ID of the application password. * * ## EXAMPLES * * # Record usage of an application password * $ wp user application-password record-usage 123 6633824d-c1d7-4f79-9dd5-4586f734d69e * Success: Recorded application password usage. * * @subcommand record-usage * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the application password could not be created. */ public function record_usage( $args, $assoc_args ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed $args = $this->replace_login_with_user_id( $args ); list( $user_id, $uuid ) = $args; $result = WP_Application_Passwords::record_application_password_usage( $user_id, $uuid ); if ( $result instanceof WP_Error ) { WP_CLI::error( $result ); } WP_CLI::success( 'Recorded application password usage.' ); } /** * Delete an existing application password. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to delete the application password for. * * [<uuid>...] * : Comma-separated list of UUIDs of the application passwords to delete. * * [--all] * : Delete all of the user's application password. * * ## EXAMPLES * * # Delete an existing application password * $ wp user application-password delete 123 6633824d-c1d7-4f79-9dd5-4586f734d69e * Success: Deleted 1 of 1 application password. * * # Delete all of the user's application passwords * $ wp user application-password delete 123 --all * Success: Deleted all application passwords. * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the application password could not be created. */ public function delete( $args, $assoc_args ) { $args = $this->replace_login_with_user_id( $args ); $user_id = array_shift( $args ); $all = Utils\get_flag_value( $assoc_args, 'all', false ); $count = count( $args ); if ( ( 0 < $count && true === $all ) || ( 0 === $count && true !== $all ) ) { WP_CLI::error( 'You need to specify either one or more UUIDS or provide the --all flag' ); } if ( true === $all ) { $result = WP_Application_Passwords::delete_all_application_passwords( $user_id ); if ( $result instanceof WP_Error ) { WP_CLI::error( $result ); } WP_CLI::success( 'Deleted all application passwords.' ); WP_CLI::halt( 0 ); } $errors = 0; foreach ( $args as $uuid ) { $result = WP_Application_Passwords::delete_application_password( $user_id, $uuid ); if ( $result instanceof WP_Error ) { WP_CLI::warning( "Failed to delete UUID {$uuid}: " . $result->get_error_message() ); ++$errors; } } WP_CLI::success( sprintf( 'Deleted %d of %d application %s.', $count - $errors, $count, Utils\pluralize( 'password', $count ) ) ); WP_CLI::halt( 0 === $errors ? 0 : 1 ); } /** * Checks whether an application password for a given application exists. * * ## OPTIONS * * <user> * : The user login, user email, or user ID of the user to check the existence of an application password for. * * <app-name> * : Name of the application to check the existence of an application password for. * * ## EXAMPLES * * # Check if an application password for a given application exists * $ wp user application-password exists 123 myapp * $ echo $? * 1 * * # Bash script for checking whether an application password exists and creating one if not * if ! wp user application-password exists 123 myapp; then * PASSWORD=$(wp user application-password create 123 myapp --porcelain) * fi * * @param array $args Indexed array of positional arguments. * @param array $assoc_args Associative array of associative arguments. * @throws ExitException If the application password could not be created. */ public function exists( $args, $assoc_args ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed $args = $this->replace_login_with_user_id( $args ); list( $user_id, $app_name ) = $args; $result = $this->application_name_exists_for_user( $user_id, $app_name ); if ( $result instanceof WP_Error ) { WP_CLI::error( $result ); } WP_CLI::halt( $result ? 0 : 1 ); } /** * Replaces user_login value with user ID. * * @param array $args Associative array of arguments. * @return array Associative array of arguments with the user login replaced with an ID. * @throws ExitException If the user is not found. */ private function replace_login_with_user_id( $args ) { $user = ( new UserFetcher() )->get_check( $args[0] ); $args[0] = $user->ID; return $args; } /** * Checks if application name exists for the given user. * * This is a polyfill for WP_Application_Passwords::get_user_application_passwords(), which was only added for * WordPress 5.7+, but we're already supporting application passwords for WordPress 5.6+. * * @param int $user_id User ID to check the application passwords for. * @param string $app_name Application name to look for. * @return bool */ private function application_name_exists_for_user( $user_id, $app_name ) { if ( Utils\wp_version_compare( '5.7', '<' ) ) { $passwords = WP_Application_Passwords::get_user_application_passwords( $user_id ); foreach ( $passwords as $password ) { if ( strtolower( $password['name'] ) === strtolower( $app_name ) ) { return true; } } return false; } return WP_Application_Passwords::application_name_exists_for_user( $user_id, $app_name ); } } <?php use WP_CLI\CommandWithDBObject; use WP_CLI\ExitException; use WP_CLI\Fetchers\Site as SiteFetcher; use WP_CLI\Iterators\Query as QueryIterator; use WP_CLI\Iterators\Table as TableIterator; use WP_CLI\Utils; use WP_CLI\Formatter; use WP_CLI\Fetchers\User as UserFetcher; /** * Creates, deletes, empties, moderates, and lists one or more sites on a multisite installation. * * ## EXAMPLES * * # Create site * $ wp site create --slug=example * Success: Site 3 created: www.example.com/example/ * * # Output a simple list of site URLs * $ wp site list --field=url * http://www.example.com/ * http://www.example.com/subdir/ * * # Delete site * $ wp site delete 123 * Are you sure you want to delete the 'http://www.example.com/example' site? [y/n] y * Success: The site at 'http://www.example.com/example' was deleted. * * @package wp-cli */ class Site_Command extends CommandWithDBObject { protected $obj_type = 'site'; protected $obj_id_key = 'blog_id'; private $fetcher; public function __construct() { $this->fetcher = new SiteFetcher(); } /** * Delete comments. */ private function empty_comments() { global $wpdb; // Empty comments and comment cache $comment_ids = $wpdb->get_col( "SELECT comment_ID FROM $wpdb->comments" ); foreach ( $comment_ids as $comment_id ) { wp_cache_delete( $comment_id, 'comment' ); wp_cache_delete( $comment_id, 'comment_meta' ); } $wpdb->query( "TRUNCATE TABLE $wpdb->comments" ); $wpdb->query( "TRUNCATE TABLE $wpdb->commentmeta" ); } /** * Delete all posts. */ private function empty_posts() { global $wpdb; // Empty posts and post cache $posts_query = "SELECT ID FROM $wpdb->posts"; $posts = new QueryIterator( $posts_query, 10000 ); $taxonomies = get_taxonomies(); while ( $posts->valid() ) { $post_id = $posts->current()->ID; wp_cache_delete( $post_id, 'posts' ); wp_cache_delete( $post_id, 'post_meta' ); foreach ( $taxonomies as $taxonomy ) { wp_cache_delete( $post_id, "{$taxonomy}_relationships" ); } wp_cache_delete( $wpdb->blogid . '-' . $post_id, 'global-posts' ); $posts->next(); } $wpdb->query( "TRUNCATE TABLE $wpdb->posts" ); $wpdb->query( "TRUNCATE TABLE $wpdb->postmeta" ); } /** * Delete terms, taxonomies, and tax relationships. */ private function empty_taxonomies() { global $wpdb; // Empty taxonomies and terms $terms = $wpdb->get_results( "SELECT term_id, taxonomy FROM $wpdb->term_taxonomy" ); $taxonomies = []; foreach ( (array) $terms as $term ) { $taxonomies[] = $term->taxonomy; wp_cache_delete( $term->term_id, $term->taxonomy ); } $taxonomies = array_unique( $taxonomies ); $cleaned = []; foreach ( $taxonomies as $taxonomy ) { if ( isset( $cleaned[ $taxonomy ] ) ) { continue; } $cleaned[ $taxonomy ] = true; wp_cache_delete( 'all_ids', $taxonomy ); wp_cache_delete( 'get', $taxonomy ); delete_option( "{$taxonomy}_children" ); } $wpdb->query( "TRUNCATE TABLE $wpdb->terms" ); $wpdb->query( "TRUNCATE TABLE $wpdb->term_taxonomy" ); $wpdb->query( "TRUNCATE TABLE $wpdb->term_relationships" ); if ( ! empty( $wpdb->termmeta ) ) { $wpdb->query( "TRUNCATE TABLE $wpdb->termmeta" ); } } /** * Delete all links, link_category terms, and related cache. */ private function empty_links() { global $wpdb; // Remove links and related cached data. $links_query = "SELECT link_id FROM {$wpdb->links}"; $links = new QueryIterator( $links_query, 10000 ); // Remove bookmarks cache group. wp_cache_delete( 'get_bookmarks', 'bookmark' ); while ( $links->valid() ) { $link_id = $links->current()->link_id; // Remove cache for the link. wp_delete_object_term_relationships( $link_id, 'link_category' ); wp_cache_delete( $link_id, 'bookmark' ); clean_object_term_cache( $link_id, 'link' ); $links->next(); } // Empty the table once link related cache and term is removed. $wpdb->query( "TRUNCATE TABLE {$wpdb->links}" ); } /** * Insert default terms. */ private function insert_default_terms() { global $wpdb; // Default category $cat_name = __( 'Uncategorized' ); /* translators: Default category slug */ $cat_slug = sanitize_title( _x( 'Uncategorized', 'Default category slug' ) ); // phpcs:ignore WordPress.WP.DeprecatedFunctions.global_terms_enabledFound -- Required for backwards compatibility. if ( global_terms_enabled() ) { $cat_id = $wpdb->get_var( $wpdb->prepare( "SELECT cat_ID FROM {$wpdb->sitecategories} WHERE category_nicename = %s", $cat_slug ) ); if ( null === $cat_id ) { $wpdb->insert( $wpdb->sitecategories, [ 'cat_ID' => 0, 'cat_name' => $cat_name, 'category_nicename' => $cat_slug, 'last_updated' => current_time( 'mysql', true ), ] ); $cat_id = $wpdb->insert_id; } update_option( 'default_category', $cat_id ); } else { $cat_id = 1; } $wpdb->insert( $wpdb->terms, [ 'term_id' => $cat_id, 'name' => $cat_name, 'slug' => $cat_slug, 'term_group' => 0, ] ); $wpdb->insert( $wpdb->term_taxonomy, [ 'term_id' => $cat_id, 'taxonomy' => 'category', 'description' => '', 'parent' => 0, 'count' => 0, ] ); } /** * Reset option values to default. */ private function reset_options() { // Reset Privacy Policy value to prevent error. update_option( 'wp_page_for_privacy_policy', 0 ); // Reset sticky posts option. update_option( 'sticky_posts', [] ); } /** * Empties a site of its content (posts, comments, terms, and meta). * * Truncates posts, comments, and terms tables to empty a site of its * content. Doesn't affect site configuration (options) or users. * * If running a persistent object cache, make sure to flush the cache * after emptying the site, as the cache values will be invalid otherwise. * * To also empty custom database tables, you'll need to hook into command * execution: * * ``` * WP_CLI::add_hook( 'after_invoke:site empty', function(){ * global $wpdb; * foreach( array( 'p2p', 'p2pmeta' ) as $table ) { * $table = $wpdb->$table; * $wpdb->query( "TRUNCATE $table" ); * } * }); * ``` * * ## OPTIONS * * [--uploads] * : Also delete *all* files in the site's uploads directory. * * [--yes] * : Proceed to empty the site without a confirmation prompt. * * ## EXAMPLES * * $ wp site empty * Are you sure you want to empty the site at http://www.example.com of all posts, links, comments, and terms? [y/n] y * Success: The site at 'http://www.example.com' was emptied. * * @subcommand empty */ public function empty_( $args, $assoc_args ) { $upload_message = ''; if ( Utils\get_flag_value( $assoc_args, 'uploads' ) ) { $upload_message = ', and delete its uploads directory'; } WP_CLI::confirm( "Are you sure you want to empty the site at '" . site_url() . "' of all posts, links, comments, and terms" . $upload_message . '?', $assoc_args ); $this->empty_posts(); $this->empty_links(); $this->empty_comments(); $this->empty_taxonomies(); $this->insert_default_terms(); $this->reset_options(); if ( ! empty( $upload_message ) ) { $upload_dir = wp_upload_dir(); $files = new RecursiveIteratorIterator( new RecursiveDirectoryIterator( $upload_dir['basedir'], RecursiveDirectoryIterator::SKIP_DOTS ), RecursiveIteratorIterator::CHILD_FIRST ); $files_to_unlink = []; $directories_to_delete = []; $is_main_site = is_main_site(); foreach ( $files as $fileinfo ) { $realpath = $fileinfo->getRealPath(); // Don't clobber subsites when operating on the main site if ( $is_main_site && false !== stripos( $realpath, '/sites/' ) ) { continue; } if ( $fileinfo->isDir() ) { $directories_to_delete[] = $realpath; } else { $files_to_unlink[] = $realpath; } } foreach ( $files_to_unlink as $file ) { unlink( $file ); } foreach ( $directories_to_delete as $directory ) { // Directory could be main sites directory '/sites' which may be non-empty. @rmdir( $directory ); } // May be non-empty if '/sites' still around. @rmdir( $upload_dir['basedir'] ); } WP_CLI::success( "The site at '" . site_url() . "' was emptied." ); } /** * Deletes a site in a multisite installation. * * ## OPTIONS * * [<site-id>] * : The id of the site to delete. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be deleted. Subdomain on subdomain installs, directory on subdirectory installs. * * [--yes] * : Answer yes to the confirmation message. * * [--keep-tables] * : Delete the blog from the list, but don't drop its tables. * * ## EXAMPLES * * $ wp site delete 123 * Are you sure you want to delete the http://www.example.com/example site? [y/n] y * Success: The site at 'http://www.example.com/example' was deleted. */ public function delete( $args, $assoc_args ) { if ( ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } if ( isset( $assoc_args['slug'] ) ) { $blog_id = get_id_from_blogname( $assoc_args['slug'] ); if ( null === $blog_id ) { WP_CLI::error( sprintf( 'Could not find site with slug \'%s\'.', $assoc_args['slug'] ) ); } $blog = get_blog_details( $blog_id ); } else { if ( empty( $args ) ) { WP_CLI::error( 'Need to specify a blog id.' ); } $blog_id = $args[0]; if ( is_main_site( $blog_id ) ) { WP_CLI::error( 'You cannot delete the root site.' ); } $blog = get_blog_details( $blog_id ); } if ( ! $blog ) { WP_CLI::error( 'Site not found.' ); } $site_url = trailingslashit( $blog->siteurl ); WP_CLI::confirm( "Are you sure you want to delete the '{$site_url}' site?", $assoc_args ); wpmu_delete_blog( $blog->blog_id, ! Utils\get_flag_value( $assoc_args, 'keep-tables' ) ); WP_CLI::success( "The site at '{$site_url}' was deleted." ); } /** * Creates a site in a multisite installation. * * ## OPTIONS * * --slug=<slug> * : Path for the new site. Subdomain on subdomain installs, directory on subdirectory installs. * * [--title=<title>] * : Title of the new site. Default: prettified slug. * * [--email=<email>] * : Email for admin user. User will be created if none exists. Assignment to super admin if not included. * * [--network_id=<network-id>] * : Network to associate new site with. Defaults to current network (typically 1). * * [--private] * : If set, the new site will be non-public (not indexed) * * [--porcelain] * : If set, only the site id will be output on success. * * ## EXAMPLES * * $ wp site create --slug=example * Success: Site 3 created: http://www.example.com/example/ */ public function create( $args, $assoc_args ) { if ( ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } global $wpdb, $current_site; $base = $assoc_args['slug']; $title = Utils\get_flag_value( $assoc_args, 'title', ucfirst( $base ) ); $email = empty( $assoc_args['email'] ) ? '' : $assoc_args['email']; // Network if ( ! empty( $assoc_args['network_id'] ) ) { $network = $this->get_network( $assoc_args['network_id'] ); if ( false === $network ) { WP_CLI::error( "Network with id {$assoc_args['network_id']} does not exist." ); } } else { $network = $current_site; } $public = ! Utils\get_flag_value( $assoc_args, 'private' ); // Sanitize if ( preg_match( '|^([a-zA-Z0-9-])+$|', $base ) ) { $base = strtolower( $base ); } // If not a subdomain install, make sure the domain isn't a reserved word if ( ! is_subdomain_install() ) { $subdirectory_reserved_names = $this->get_subdirectory_reserved_names(); if ( in_array( $base, $subdirectory_reserved_names, true ) ) { WP_CLI::error( 'The following words are reserved and cannot be used as blog names: ' . implode( ', ', $subdirectory_reserved_names ) ); } } // Check for valid email, if not, use the first super admin found // Probably a more efficient way to do this so we dont query for the // User twice if super admin $email = sanitize_email( $email ); if ( empty( $email ) || ! is_email( $email ) ) { $super_admins = get_super_admins(); $email = ''; if ( ! empty( $super_admins ) && is_array( $super_admins ) ) { // Just get the first one $super_login = reset( $super_admins ); $super_user = get_user_by( 'login', $super_login ); if ( $super_user ) { $email = $super_user->user_email; } } } if ( is_subdomain_install() ) { $newdomain = $base . '.' . preg_replace( '|^www\.|', '', $current_site->domain ); $path = $current_site->path; } else { $newdomain = $current_site->domain; $path = $current_site->path . $base . '/'; } $user_id = email_exists( $email ); if ( ! $user_id ) { // Create a new user with a random password $password = wp_generate_password( 24, false ); $user_id = wpmu_create_user( $base, $password, $email ); if ( false === $user_id ) { WP_CLI::error( "Can't create user." ); } else { User_Command::wp_new_user_notification( $user_id, $password ); } } $wpdb->hide_errors(); $title = wp_slash( $title ); $id = wpmu_create_blog( $newdomain, $path, $title, $user_id, [ 'public' => $public ], $network->id ); $wpdb->show_errors(); if ( ! is_wp_error( $id ) ) { if ( ! is_super_admin( $user_id ) && ! get_user_option( 'primary_blog', $user_id ) ) { update_user_option( $user_id, 'primary_blog', $id, true ); } } else { WP_CLI::error( $id->get_error_message() ); } if ( Utils\get_flag_value( $assoc_args, 'porcelain' ) ) { WP_CLI::line( $id ); } else { $site_url = trailingslashit( get_site_url( $id ) ); WP_CLI::success( "Site {$id} created: {$site_url}" ); } } /** * Generate some sites. * * Creates a specified number of new sites. * * ## OPTIONS * * [--count=<number>] * : How many sites to generates? * --- * default: 100 * --- * * [--slug=<slug>] * : Path for the new site. Subdomain on subdomain installs, directory on subdirectory installs. * * [--email=<email>] * : Email for admin user. User will be created if none exists. Assignment to super admin if not included. * * [--network_id=<network-id>] * : Network to associate new site with. Defaults to current network (typically 1). * * [--private] * : If set, the new site will be non-public (not indexed) * * [--format=<format>] * : Render output in a particular format. * --- * default: progress * options: * - progress * - ids * --- * * ## EXAMPLES * * # Generate 10 sites. * $ wp site generate --count=10 * Generating sites 100% [================================================] 0:01 / 0:04 */ public function generate( $args, $assoc_args ) { if ( ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } global $wpdb, $current_site; $defaults = [ 'count' => 100, 'email' => '', 'network_id' => 1, 'slug' => 'site', ]; $assoc_args = array_merge( $defaults, $assoc_args ); // Base. $base = $assoc_args['slug']; if ( preg_match( '|^([a-zA-Z0-9-])+$|', $base ) ) { $base = strtolower( $base ); } $is_subdomain_install = is_subdomain_install(); // If not a subdomain install, make sure the domain isn't a reserved word if ( ! $is_subdomain_install ) { $subdirectory_reserved_names = $this->get_subdirectory_reserved_names(); if ( in_array( $base, $subdirectory_reserved_names, true ) ) { WP_CLI::error( 'The following words are reserved and cannot be used as blog names: ' . implode( ', ', $subdirectory_reserved_names ) ); } } // Network. if ( ! empty( $assoc_args['network_id'] ) ) { $network = $this->get_network( $assoc_args['network_id'] ); if ( false === $network ) { WP_CLI::error( "Network with id {$assoc_args['network_id']} does not exist." ); } } else { $network = $current_site; } // Public. $public = ! Utils\get_flag_value( $assoc_args, 'private' ); // Limit. $limit = $assoc_args['count']; // Email. $email = sanitize_email( $assoc_args['email'] ); if ( empty( $email ) || ! is_email( $email ) ) { $super_admins = get_super_admins(); $email = ''; if ( ! empty( $super_admins ) && is_array( $super_admins ) ) { $super_login = reset( $super_admins ); $super_user = get_user_by( 'login', $super_login ); if ( $super_user ) { $email = $super_user->user_email; } } } $user_id = email_exists( $email ); if ( ! $user_id ) { $password = wp_generate_password( 24, false ); $user_id = wpmu_create_user( $base . '-admin', $password, $email ); if ( false === $user_id ) { WP_CLI::error( "Can't create user." ); } else { User_Command::wp_new_user_notification( $user_id, $password ); } } $format = Utils\get_flag_value( $assoc_args, 'format', 'progress' ); $notify = false; if ( 'progress' === $format ) { $notify = Utils\make_progress_bar( 'Generating sites', $limit ); } for ( $index = 1; $index <= $limit; $index++ ) { $current_base = $base . $index; $title = ucfirst( $base ) . ' ' . $index; if ( $is_subdomain_install ) { $new_domain = $current_base . '.' . preg_replace( '|^www\.|', '', $network->domain ); $path = $network->path; } else { $new_domain = $network->domain; $path = $network->path . $current_base . '/'; } $wpdb->hide_errors(); $title = wp_slash( $title ); $id = wpmu_create_blog( $new_domain, $path, $title, $user_id, [ 'public' => $public ], $network->id ); $wpdb->show_errors(); if ( ! is_wp_error( $id ) ) { if ( ! is_super_admin( $user_id ) && ! get_user_option( 'primary_blog', $user_id ) ) { update_user_option( $user_id, 'primary_blog', $id, true ); } } else { WP_CLI::error( $id->get_error_message() ); } if ( 'progress' === $format ) { $notify->tick(); } else { echo $id; if ( $index < $limit - 1 ) { echo ' '; } } } if ( 'progress' === $format ) { $notify->finish(); } } /** * Retrieves a list of reserved site on a sub-directory Multisite installation. * * Works on older WordPress versions where get_subdirectory_reserved_names() does not exist. * * @return string[] Array of reserved names. */ private function get_subdirectory_reserved_names() { if ( function_exists( 'get_subdirectory_reserved_names' ) ) { return get_subdirectory_reserved_names(); } $names = array( 'page', 'comments', 'blog', 'files', 'feed', 'wp-admin', 'wp-content', 'wp-includes', 'wp-json', 'embed', ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling WordPress native hook. return apply_filters( 'subdirectory_reserved_names', $names ); } /** * Gets network data for a given id. * * @param int $network_id * @return bool|array False if no network found with given id, array otherwise */ private function get_network( $network_id ) { global $wpdb; // Load network data $networks = $wpdb->get_results( $wpdb->prepare( "SELECT * FROM $wpdb->site WHERE id = %d", $network_id ) ); if ( ! empty( $networks ) ) { // Only care about domain and path which are set here return $networks[0]; } return false; } /** * Lists all sites in a multisite installation. * * ## OPTIONS * * [--network=<id>] * : The network to which the sites belong. * * [--<field>=<value>] * : Filter by one or more fields (see "Available Fields" section). However, * 'url' isn't an available filter, as it comes from 'home' in wp_options. * * [--site__in=<value>] * : Only list the sites with these blog_id values (comma-separated). * * [--site_user=<value>] * : Only list the sites with this user. * * [--field=<field>] * : Prints the value of a single field for each site. * * [--fields=<fields>] * : Comma-separated list of fields to show. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - count * - ids * - json * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each site: * * * blog_id * * url * * last_updated * * registered * * These fields are optionally available: * * * site_id * * domain * * path * * public * * archived * * mature * * spam * * deleted * * lang_id * * ## EXAMPLES * * # Output a simple list of site URLs * $ wp site list --field=url * http://www.example.com/ * http://www.example.com/subdir/ * * @subcommand list */ public function list_( $args, $assoc_args ) { if ( ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } global $wpdb; if ( isset( $assoc_args['fields'] ) ) { $assoc_args['fields'] = preg_split( '/,[ \t]*/', $assoc_args['fields'] ); } $defaults = [ 'format' => 'table', 'fields' => [ 'blog_id', 'url', 'last_updated', 'registered' ], ]; $assoc_args = array_merge( $defaults, $assoc_args ); $where = []; $append = ''; $site_cols = [ 'blog_id', 'last_updated', 'registered', 'site_id', 'domain', 'path', 'public', 'archived', 'mature', 'spam', 'deleted', 'lang_id' ]; foreach ( $site_cols as $col ) { if ( isset( $assoc_args[ $col ] ) ) { $where[ $col ] = $assoc_args[ $col ]; } } if ( isset( $assoc_args['site__in'] ) ) { $where['blog_id'] = explode( ',', $assoc_args['site__in'] ); $append = 'ORDER BY FIELD( blog_id, ' . implode( ',', array_map( 'intval', $where['blog_id'] ) ) . ' )'; } if ( isset( $assoc_args['network'] ) ) { $where['site_id'] = $assoc_args['network']; } if ( isset( $assoc_args['site_user'] ) ) { $user = ( new UserFetcher() )->get_check( $assoc_args['site_user'] ); if ( $user ) { $blogs = get_blogs_of_user( $user->ID ); foreach ( $blogs as $blog ) { $where['blog_id'][] = $blog->userblog_id; } } if ( ! isset( $where['blog_id'] ) || empty( $where['blog_id'] ) ) { $formatter = new Formatter( $assoc_args, [], 'site' ); $formatter->display_items( [] ); return; } $append = 'ORDER BY FIELD( blog_id, ' . implode( ',', array_map( 'intval', $where['blog_id'] ) ) . ' )'; } $iterator_args = [ 'table' => $wpdb->blogs, 'where' => $where, 'append' => $append, ]; $iterator = new TableIterator( $iterator_args ); $iterator = Utils\iterator_map( $iterator, function ( $blog ) { $blog->url = trailingslashit( get_home_url( $blog->blog_id ) ); return $blog; } ); if ( ! empty( $assoc_args['format'] ) && 'ids' === $assoc_args['format'] ) { $sites = iterator_to_array( $iterator ); $ids = wp_list_pluck( $sites, 'blog_id' ); $formatter = new Formatter( $assoc_args, null, 'site' ); $formatter->display_items( $ids ); } else { $formatter = new Formatter( $assoc_args, null, 'site' ); $formatter->display_items( $iterator ); } } /** * Archives one or more sites. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to archive. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to archive. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site archive 123 * Success: Site 123 archived. * * $ wp site archive --slug=demo * Success: Site 123 archived. */ public function archive( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'archived', 1 ); } /** * Unarchives one or more sites. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to unarchive. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to unarchive. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site unarchive 123 * Success: Site 123 unarchived. * * $ wp site unarchive --slug=demo * Success: Site 123 unarchived. */ public function unarchive( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'archived', 0 ); } /** * Activates one or more sites. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to activate. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be activated. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site activate 123 * Success: Site 123 activated. * * $ wp site activate --slug=demo * Success: Site 123 marked as activated. */ public function activate( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'deleted', 0 ); } /** * Deactivates one or more sites. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to deactivate. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be deactivated. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site deactivate 123 * Success: Site 123 deactivated. * * $ wp site deactivate --slug=demo * Success: Site 123 deactivated. */ public function deactivate( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'deleted', 1 ); } /** * Marks one or more sites as spam. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to be marked as spam. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be marked as spam. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site spam 123 * Success: Site 123 marked as spam. */ public function spam( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'spam', 1 ); } /** * Removes one or more sites from spam. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to remove from spam. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be removed from spam. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site unspam 123 * Success: Site 123 removed from spam. * * @subcommand unspam */ public function unspam( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'spam', 0 ); } /** * Sets one or more sites as mature. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to set as mature. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be set as mature. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site mature 123 * Success: Site 123 marked as mature. * * $ wp site mature --slug=demo * Success: Site 123 marked as mature. */ public function mature( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'mature', 1 ); } /** * Sets one or more sites as immature. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to set as unmature. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be set as unmature. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site unmature 123 * Success: Site 123 marked as unmature. * * $ wp site unmature --slug=demo * Success: Site 123 marked as unmature. */ public function unmature( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'mature', 0 ); } /** * Sets one or more sites as public. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to set as public. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be set as public. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site public 123 * Success: Site 123 marked as public. * * $ wp site public --slug=demo * Success: Site 123 marked as public. * * @subcommand public */ public function set_public( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'public', 1 ); } /** * Sets one or more sites as private. * * ## OPTIONS * * [<id>...] * : One or more IDs of sites to set as private. If not provided, you must set the --slug parameter. * * [--slug=<slug>] * : Path of the site to be set as private. Subdomain on subdomain installs, directory on subdirectory installs. * * ## EXAMPLES * * $ wp site private 123 * Success: Site 123 marked as private. * * $ wp site private --slug=demo * Success: Site 123 marked as private. * * @subcommand private */ public function set_private( $args, $assoc_args ) { if ( ! $this->check_site_ids_and_slug( $args, $assoc_args ) ) { return; } $ids = $this->get_sites_ids( $args, $assoc_args ); $this->update_site_status( $ids, 'public', 0 ); } private function update_site_status( $ids, $pref, $value ) { $value = (int) $value; switch ( $pref ) { case 'archived': $action = $value ? 'archived' : 'unarchived'; break; case 'deleted': $action = $value ? 'deactivated' : 'activated'; break; case 'mature': $action = $value ? 'marked as mature' : 'marked as unmature'; break; case 'public': $action = $value ? 'marked as public' : 'marked as private'; break; case 'spam': $action = $value ? 'marked as spam' : 'removed from spam'; break; } foreach ( $ids as $site_id ) { $site = $this->fetcher->get_check( $site_id ); if ( is_main_site( $site->blog_id ) ) { WP_CLI::warning( 'You are not allowed to change the main site.' ); continue; } $old_value = (int) get_blog_status( $site->blog_id, $pref ); if ( $value === $old_value ) { WP_CLI::warning( "Site {$site->blog_id} already {$action}." ); continue; } update_blog_status( $site->blog_id, $pref, $value ); WP_CLI::success( "Site {$site->blog_id} {$action}." ); } } /** * Get an array of site IDs from the passed-in arguments or slug parameter. * * @param array $args Passed-in arguments. * @param array $assoc_args Passed-in parameters. * * @return array Site IDs. * @throws ExitException */ private function get_sites_ids( $args, $assoc_args ) { $slug = Utils\get_flag_value( $assoc_args, 'slug', false ); if ( $slug ) { $blog_id = get_id_from_blogname( trim( $slug, '/' ) ); if ( null === $blog_id ) { WP_CLI::error( sprintf( 'Could not find site with slug \'%s\'.', $slug ) ); } return [ $blog_id ]; } return $args; } /** * Check that the site IDs or slug are provided. * * @param array $args Passed-in arguments. * @param array $assoc_args Passed-in parameters. * * @return bool * @throws ExitException If neither site ids nor site slug using --slug were provided. */ private function check_site_ids_and_slug( $args, $assoc_args ) { if ( ( empty( $args ) && empty( $assoc_args['slug'] ) ) || ( ! empty( $args ) && ! empty( $assoc_args['slug'] ) ) ) { WP_CLI::error( 'Please specify one or more IDs of sites, or pass the slug for a single site using --slug.' ); } return true; } } <?php use WP_CLI\CommandWithMeta; /** * Adds, updates, deletes, and lists term custom fields. * * ## EXAMPLES * * # Set term meta * $ wp term meta set 123 bio "Mary is a WordPress developer." * Success: Updated custom field 'bio'. * * # Get term meta * $ wp term meta get 123 bio * Mary is a WordPress developer. * * # Update term meta * $ wp term meta update 123 bio "Mary is an awesome WordPress developer." * Success: Updated custom field 'bio'. * * # Delete term meta * $ wp term meta delete 123 bio * Success: Deleted custom field. */ class Term_Meta_Command extends CommandWithMeta { protected $meta_type = 'term'; /** * Check that the term ID exists * * @param int */ protected function check_object_id( $object_id ) { $term = get_term( $object_id ); if ( ! $term ) { WP_CLI::error( "Could not find the term with ID {$object_id}." ); } return $term->term_id; } /** * Wrapper method for add_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param bool $unique Optional, default is false. Whether the * specified metadata key should be unique for the * object. If true, and the object already has a * value for the specified metadata key, no change * will be made. * * @return int|false The meta ID on success, false on failure. */ protected function add_metadata( $object_id, $meta_key, $meta_value, $unique = false ) { return add_term_meta( $object_id, $meta_key, $meta_value, $unique ); } /** * Wrapper method for update_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Metadata key to use. * @param mixed $meta_value Metadata value. Must be serializable if * non-scalar. * @param mixed $prev_value Optional. If specified, only update existing * metadata entries with the specified value. * Otherwise, update all entries. * * @return int|bool Meta ID if the key didn't exist, true on successful * update, false on failure. */ protected function update_metadata( $object_id, $meta_key, $meta_value, $prev_value = '' ) { return update_term_meta( $object_id, $meta_key, $meta_value, $prev_value ); } /** * Wrapper method for get_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object the metadata is for. * @param string $meta_key Optional. Metadata key. If not specified, * retrieve all metadata for the specified object. * @param bool $single Optional, default is false. If true, return only * the first value of the specified meta_key. This * parameter has no effect if meta_key is not * specified. * * @return mixed Single metadata value, or array of values. */ protected function get_metadata( $object_id, $meta_key = '', $single = false ) { return get_term_meta( $object_id, $meta_key, $single ); } /** * Wrapper method for delete_metadata that can be overridden in sub classes. * * @param int $object_id ID of the object metadata is for * @param string $meta_key Metadata key * @param mixed $meta_value Optional. Metadata value. Must be serializable * if non-scalar. If specified, only delete * metadata entries with this value. Otherwise, * delete all entries with the specified meta_key. * Pass `null, `false`, or an empty string to skip * this check. For backward compatibility, it is * not possible to pass an empty string to delete * those entries with an empty string for a value. * * @return bool True on successful delete, false on failure. */ protected function delete_metadata( $object_id, $meta_key, $meta_value = '' ) { return delete_term_meta( $object_id, $meta_key, $meta_value ); } } <?php use WP_CLI\Formatter; /** * Retrieves details on the site's registered post types. * * Get information on WordPress' built-in and the site's [custom post types](https://developer.wordpress.org/plugins/post-types/). * * ## EXAMPLES * * # Get details about a post type * $ wp post-type get page --fields=name,label,hierarchical --format=json * {"name":"page","label":"Pages","hierarchical":true} * * # List post types with 'post' capability type * $ wp post-type list --capability_type=post --fields=name,public * +---------------+--------+ * | name | public | * +---------------+--------+ * | post | 1 | * | attachment | 1 | * | revision | | * | nav_menu_item | | * +---------------+--------+ * * @package wp-cli */ class Post_Type_Command extends WP_CLI_Command { private $fields = array( 'name', 'label', 'description', 'hierarchical', 'public', 'capability_type', ); /** * Gets the post counts for each supplied post type. * * @param array $post_types Post types to fetch counts for. * @return array Associative array of post counts keyed by post type. */ protected function get_counts( $post_types ) { global $wpdb; if ( count( $post_types ) <= 0 ) { return []; } $query = $wpdb->prepare( "SELECT `post_type`, COUNT(*) AS `count` FROM $wpdb->posts WHERE `post_type` IN (" . implode( ',', array_fill( 0, count( $post_types ), '%s' ) ) . ') GROUP BY `post_type`', $post_types ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- $query is already prepared above. $counts = $wpdb->get_results( $query ); // Make sure there's a count for every item. $counts = array_merge( array_fill_keys( $post_types, 0 ), wp_list_pluck( $counts, 'count', 'post_type' ) ); return $counts; } /** * Lists registered post types. * * ## OPTIONS * * [--<field>=<value>] * : Filter by one or more fields (see get_post_types() first parameter for a list of available fields). * * [--field=<field>] * : Prints the value of a single field for each post type. * * [--fields=<fields>] * : Limit the output to specific post type fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each post type: * * * name * * label * * description * * hierarchical * * public * * capability_type * * These fields are optionally available: * * * count * * ## EXAMPLES * * # List registered post types * $ wp post-type list --format=csv * name,label,description,hierarchical,public,capability_type * post,Posts,,,1,post * page,Pages,,1,1,page * attachment,Media,,,1,post * revision,Revisions,,,,post * nav_menu_item,"Navigation Menu Items",,,,post * * # List post types with 'post' capability type * $ wp post-type list --capability_type=post --fields=name,public * +---------------+--------+ * | name | public | * +---------------+--------+ * | post | 1 | * | attachment | 1 | * | revision | | * | nav_menu_item | | * +---------------+--------+ * * @subcommand list */ public function list_( $args, $assoc_args ) { $formatter = $this->get_formatter( $assoc_args ); $fields = $formatter->fields; $types = get_post_types( $assoc_args, 'objects' ); $counts = []; if ( count( $types ) > 0 && in_array( 'count', $fields, true ) ) { $counts = $this->get_counts( wp_list_pluck( $types, 'name' ) ); } $types = array_map( function ( $type ) use ( $counts ) { $type->count = isset( $counts[ $type->name ] ) ? $counts[ $type->name ] : 0; return $type; }, $types ); $formatter->display_items( $types ); } /** * Gets details about a registered post type. * * ## OPTIONS * * <post-type> * : Post type slug * * [--field=<field>] * : Instead of returning the whole taxonomy, returns the value of a single field. * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for the specified post type: * * * name * * label * * description * * hierarchical * * public * * capability_type * * labels * * cap * * supports * * These fields are optionally available: * * * count * * ## EXAMPLES * * # Get details about the 'page' post type. * $ wp post-type get page --fields=name,label,hierarchical --format=json * {"name":"page","label":"Pages","hierarchical":true} */ public function get( $args, $assoc_args ) { $post_type = get_post_type_object( $args[0] ); if ( ! $post_type ) { WP_CLI::error( "Post type {$args[0]} doesn't exist." ); } if ( empty( $assoc_args['fields'] ) ) { $default_fields = array_merge( $this->fields, array( 'labels', 'cap', 'supports', ) ); $assoc_args['fields'] = $default_fields; } $formatter = $this->get_formatter( $assoc_args ); $fields = $formatter->fields; $count = 0; if ( in_array( 'count', $fields, true ) ) { $count = $this->get_counts( [ $post_type->name ] ); $count = $count[ $post_type->name ]; } $data = array( 'name' => $post_type->name, 'label' => $post_type->label, 'description' => $post_type->description, 'hierarchical' => $post_type->hierarchical, 'public' => $post_type->public, 'capability_type' => $post_type->capability_type, 'labels' => $post_type->labels, 'cap' => $post_type->cap, 'supports' => get_all_post_type_supports( $post_type->name ), 'count' => $count, ); $formatter->display_item( $data ); } private function get_formatter( &$assoc_args ) { return new Formatter( $assoc_args, $this->fields, 'post-type' ); } } <?php use WP_CLI\CommandWithDBObject; use WP_CLI\Fetchers\Comment as CommentFetcher; use WP_CLI\Utils; /** * Creates, updates, deletes, and moderates comments. * * ## EXAMPLES * * # Create a new comment. * $ wp comment create --comment_post_ID=15 --comment_content="hello blog" --comment_author="wp-cli" * Success: Created comment 932. * * # Update an existing comment. * $ wp comment update 123 --comment_author='That Guy' * Success: Updated comment 123. * * # Delete an existing comment. * $ wp comment delete 1337 --force * Success: Deleted comment 1337. * * # Trash all spam comments. * $ wp comment delete $(wp comment list --status=spam --format=ids) * Success: Trashed comment 264. * Success: Trashed comment 262. * * @package wp-cli */ class Comment_Command extends CommandWithDBObject { protected $obj_type = 'comment'; protected $obj_id_key = 'comment_ID'; protected $obj_fields = [ 'comment_ID', 'comment_post_ID', 'comment_date', 'comment_approved', 'comment_author', 'comment_author_email', ]; private $fetcher; public function __construct() { $this->fetcher = new CommentFetcher(); } /** * Creates a new comment. * * ## OPTIONS * * [--<field>=<value>] * : Associative args for the new comment. See wp_insert_comment(). * * [--porcelain] * : Output just the new comment id. * * ## EXAMPLES * * # Create comment. * $ wp comment create --comment_post_ID=15 --comment_content="hello blog" --comment_author="wp-cli" * Success: Created comment 932. */ public function create( $args, $assoc_args ) { $assoc_args = wp_slash( $assoc_args ); parent::_create( $args, $assoc_args, function ( $params ) { if ( isset( $params['comment_post_ID'] ) ) { $post_id = $params['comment_post_ID']; $post = get_post( $post_id ); if ( ! $post ) { return new WP_Error( 'no_post', "Can't find post {$post_id}." ); } } else { // Make sure it's set for older WP versions else get undefined PHP notice. $params['comment_post_ID'] = 0; } // We use wp_insert_comment() instead of wp_new_comment() to stay at a low level and // avoid wp_die() formatted messages or notifications $comment_id = wp_insert_comment( $params ); if ( ! $comment_id ) { return new WP_Error( 'db_error', 'Could not create comment.' ); } return $comment_id; } ); } /** * Updates one or more comments. * * ## OPTIONS * * <id>... * : One or more IDs of comments to update. * * --<field>=<value> * : One or more fields to update. See wp_update_comment(). * * ## EXAMPLES * * # Update comment. * $ wp comment update 123 --comment_author='That Guy' * Success: Updated comment 123. */ public function update( $args, $assoc_args ) { $assoc_args = wp_slash( $assoc_args ); parent::_update( $args, $assoc_args, function ( $params ) { if ( ! wp_update_comment( $params ) ) { return new WP_Error( 'db_error', 'Could not update comment.' ); } return true; } ); } /** * Generates some number of new dummy comments. * * Creates a specified number of new comments with dummy data. * * ## OPTIONS * * [--count=<number>] * : How many comments to generate? * --- * default: 100 * --- * * [--post_id=<post-id>] * : Assign comments to a specific post. * * [--format=<format>] * : Render output in a particular format. * --- * default: progress * options: * - progress * - ids * --- * * ## EXAMPLES * * # Generate comments for the given post. * $ wp comment generate --format=ids --count=3 --post_id=123 * 138 139 140 * * # Add meta to every generated comment. * $ wp comment generate --format=ids --count=3 | xargs -d ' ' -I % wp comment meta add % foo bar * Success: Added custom field. * Success: Added custom field. * Success: Added custom field. */ public function generate( $args, $assoc_args ) { $defaults = [ 'count' => 100, 'post_id' => 0, ]; $assoc_args = array_merge( $defaults, $assoc_args ); $format = Utils\get_flag_value( $assoc_args, 'format', 'progress' ); $notify = false; if ( 'progress' === $format ) { $notify = Utils\make_progress_bar( 'Generating comments', $assoc_args['count'] ); } $comment_count = wp_count_comments(); $total = (int) $comment_count->total_comments; $limit = $total + $assoc_args['count']; for ( $index = $total; $index < $limit; $index++ ) { $comment_id = wp_insert_comment( [ 'comment_content' => "Comment {$index}", 'comment_post_ID' => $assoc_args['post_id'], ] ); if ( 'progress' === $format ) { $notify->tick(); } elseif ( 'ids' === $format ) { echo $comment_id; if ( $index < $limit - 1 ) { echo ' '; } } } if ( 'progress' === $format ) { $notify->finish(); } } /** * Gets the data of a single comment. * * ## OPTIONS * * <id> * : The comment to get. * * [--field=<field>] * : Instead of returning the whole comment, returns the value of a single field. * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## EXAMPLES * * # Get comment. * $ wp comment get 21 --field=content * Thanks for all the comments, everyone! */ public function get( $args, $assoc_args ) { $comment_id = (int) $args[0]; $comment = get_comment( $comment_id ); if ( empty( $comment ) ) { WP_CLI::error( 'Invalid comment ID.' ); } if ( ! isset( $comment->url ) ) { $comment->url = get_comment_link( $comment ); } if ( empty( $assoc_args['fields'] ) ) { $comment_array = get_object_vars( $comment ); $assoc_args['fields'] = array_keys( $comment_array ); } $formatter = $this->get_formatter( $assoc_args ); $formatter->display_item( $comment ); } /** * Gets a list of comments. * * Display comments based on all arguments supported by * [WP_Comment_Query()](https://developer.wordpress.org/reference/classes/WP_Comment_Query/__construct/). * * ## OPTIONS * * [--<field>=<value>] * : One or more args to pass to WP_Comment_Query. * * [--field=<field>] * : Prints the value of a single field for each comment. * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - ids * - csv * - json * - count * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each comment: * * * comment_ID * * comment_post_ID * * comment_date * * comment_approved * * comment_author * * comment_author_email * * These fields are optionally available: * * * comment_author_url * * comment_author_IP * * comment_date_gmt * * comment_content * * comment_karma * * comment_agent * * comment_type * * comment_parent * * user_id * * url * * ## EXAMPLES * * # List comment IDs. * $ wp comment list --field=ID * 22 * 23 * 24 * * # List comments of a post. * $ wp comment list --post_id=1 --fields=ID,comment_date,comment_author * +------------+---------------------+----------------+ * | comment_ID | comment_date | comment_author | * +------------+---------------------+----------------+ * | 1 | 2015-06-20 09:00:10 | Mr WordPress | * +------------+---------------------+----------------+ * * # List approved comments. * $ wp comment list --number=3 --status=approve --fields=ID,comment_date,comment_author * +------------+---------------------+----------------+ * | comment_ID | comment_date | comment_author | * +------------+---------------------+----------------+ * | 1 | 2015-06-20 09:00:10 | Mr WordPress | * | 30 | 2013-03-14 12:35:07 | John Doe | * | 29 | 2013-03-14 11:56:08 | Jane Doe | * +------------+---------------------+----------------+ * * # List unapproved comments. * $ wp comment list --number=3 --status=hold --fields=ID,comment_date,comment_author * +------------+---------------------+----------------+ * | comment_ID | comment_date | comment_author | * +------------+---------------------+----------------+ * | 8 | 2023-11-10 13:13:06 | John Doe | * | 7 | 2023-11-10 13:09:55 | Mr WordPress | * | 9 | 2023-11-10 11:22:31 | Jane Doe | * +------------+---------------------+----------------+ * * # List comments marked as spam. * $ wp comment list --status=spam --fields=ID,comment_date,comment_author * +------------+---------------------+----------------+ * | comment_ID | comment_date | comment_author | * +------------+---------------------+----------------+ * | 2 | 2023-11-10 11:22:31 | Jane Doe | * +------------+---------------------+----------------+ * * # List comments in trash. * $ wp comment list --status=trash --fields=ID,comment_date,comment_author * +------------+---------------------+----------------+ * | comment_ID | comment_date | comment_author | * +------------+---------------------+----------------+ * | 3 | 2023-11-10 11:22:31 | John Doe | * +------------+---------------------+----------------+ * * @subcommand list */ public function list_( $args, $assoc_args ) { $formatter = $this->get_formatter( $assoc_args ); if ( 'ids' === $formatter->format ) { $assoc_args['fields'] = 'comment_ID'; } $assoc_args = self::process_csv_arguments_to_arrays( $assoc_args ); if ( 'count' === $formatter->format ) { $assoc_args['count'] = true; } if ( ! empty( $assoc_args['comment__in'] ) && ! empty( $assoc_args['orderby'] ) && 'comment__in' === $assoc_args['orderby'] && Utils\wp_version_compare( '4.4', '<' ) ) { $comments = []; foreach ( $assoc_args['comment__in'] as $comment_id ) { $comment = get_comment( $comment_id ); if ( $comment ) { $comments[] = $comment; } else { WP_CLI::warning( "Invalid comment {$comment_id}." ); } } } else { $query = new WP_Comment_Query(); $comments = $query->query( $assoc_args ); } if ( 'count' === $formatter->format ) { echo $comments; } else { if ( 'ids' === $formatter->format ) { $comments = wp_list_pluck( $comments, 'comment_ID' ); } elseif ( is_array( $comments ) ) { $comments = array_map( function ( $comment ) { $comment->url = get_comment_link( $comment->comment_ID ); return $comment; }, $comments ); } $formatter->display_items( $comments ); } } /** * Deletes a comment. * * ## OPTIONS * * <id>... * : One or more IDs of comments to delete. * * [--force] * : Skip the trash bin. * * ## EXAMPLES * * # Delete comment. * $ wp comment delete 1337 --force * Success: Deleted comment 1337. * * # Delete multiple comments. * $ wp comment delete 1337 2341 --force * Success: Deleted comment 1337. * Success: Deleted comment 2341. */ public function delete( $args, $assoc_args ) { parent::_delete( $args, $assoc_args, function ( $comment_id, $assoc_args ) { $force = Utils\get_flag_value( $assoc_args, 'force' ); $status = wp_get_comment_status( $comment_id ); $result = wp_delete_comment( $comment_id, $force ); if ( ! $result ) { return [ 'error', "Failed deleting comment {$comment_id}." ]; } $verb = ( $force || 'trash' === $status ) ? 'Deleted' : 'Trashed'; return [ 'success', "{$verb} comment {$comment_id}." ]; } ); } private function call( $args, $status, $success, $failure ) { $comment_id = absint( $args ); $func = "wp_{$status}_comment"; if ( ! $func( $comment_id ) ) { WP_CLI::error( sprintf( $failure, "comment {$comment_id}" ) ); } WP_CLI::success( sprintf( $success, "comment {$comment_id}" ) ); } private function set_status( $args, $status, $success ) { $comment = $this->fetcher->get_check( $args ); $result = wp_set_comment_status( $comment->comment_ID, $status, true ); if ( is_wp_error( $result ) ) { WP_CLI::error( $result ); } WP_CLI::success( "{$success} comment {$comment->comment_ID}." ); } /** * Warns if `$_SERVER['SERVER_NAME']` not set as used in email from-address sent to post author in `wp_notify_postauthor()`. */ private function check_server_name() { if ( empty( $_SERVER['SERVER_NAME'] ) ) { WP_CLI::warning( 'Site url not set - defaulting to \'example.com\'. Any notification emails sent to post author may appear to come from \'example.com\'.' ); $_SERVER['SERVER_NAME'] = 'example.com'; } } /** * Trashes a comment. * * ## OPTIONS * * <id>... * : The IDs of the comments to trash. * * ## EXAMPLES * * # Trash comment. * $ wp comment trash 1337 * Success: Trashed comment 1337. */ public function trash( $args, $assoc_args ) { foreach ( $args as $id ) { $this->call( $id, __FUNCTION__, 'Trashed %s.', 'Failed trashing %s.' ); } } /** * Untrashes a comment. * * ## OPTIONS * * <id>... * : The IDs of the comments to untrash. * * ## EXAMPLES * * # Untrash comment. * $ wp comment untrash 1337 * Success: Untrashed comment 1337. */ public function untrash( $args, $assoc_args ) { $this->check_server_name(); foreach ( $args as $id ) { $this->call( $id, __FUNCTION__, 'Untrashed %s.', 'Failed untrashing %s.' ); } } /** * Marks a comment as spam. * * ## OPTIONS * * <id>... * : The IDs of the comments to mark as spam. * * ## EXAMPLES * * # Spam comment. * $ wp comment spam 1337 * Success: Marked as spam comment 1337. */ public function spam( $args, $assoc_args ) { foreach ( $args as $id ) { $this->call( $id, __FUNCTION__, 'Marked %s as spam.', 'Failed marking %s as spam.' ); } } /** * Unmarks a comment as spam. * * ## OPTIONS * * <id>... * : The IDs of the comments to unmark as spam. * * ## EXAMPLES * * # Unspam comment. * $ wp comment unspam 1337 * Success: Unspammed comment 1337. */ public function unspam( $args, $assoc_args ) { $this->check_server_name(); foreach ( $args as $id ) { $this->call( $id, __FUNCTION__, 'Unspammed %s.', 'Failed unspamming %s.' ); } } /** * Approves a comment. * * ## OPTIONS * * <id>... * : The IDs of the comments to approve. * * ## EXAMPLES * * # Approve comment. * $ wp comment approve 1337 * Success: Approved comment 1337. */ public function approve( $args, $assoc_args ) { $this->check_server_name(); foreach ( $args as $id ) { $this->set_status( $id, 'approve', 'Approved' ); } } /** * Unapproves a comment. * * ## OPTIONS * * <id>... * : The IDs of the comments to unapprove. * * ## EXAMPLES * * # Unapprove comment. * $ wp comment unapprove 1337 * Success: Unapproved comment 1337. */ public function unapprove( $args, $assoc_args ) { $this->check_server_name(); foreach ( $args as $id ) { $this->set_status( $id, 'hold', 'Unapproved' ); } } /** * Counts comments, on whole blog or on a given post. * * ## OPTIONS * * [<post-id>] * : The ID of the post to count comments in. * * ## EXAMPLES * * # Count comments on whole blog. * $ wp comment count * approved: 33 * spam: 3 * trash: 1 * post-trashed: 0 * all: 34 * moderated: 1 * total_comments: 37 * * # Count comments in a post. * $ wp comment count 42 * approved: 19 * spam: 0 * trash: 0 * post-trashed: 0 * all: 19 * moderated: 0 * total_comments: 19 */ public function count( $args, $assoc_args ) { $post_id = Utils\get_flag_value( $args, 0, 0 ); $count = wp_count_comments( $post_id ); // Move total_comments to the end of the object $total = $count->total_comments; unset( $count->total_comments ); $count->total_comments = $total; foreach ( $count as $status => $count ) { WP_CLI::line( str_pad( "$status:", 17 ) . $count ); } } /** * Recalculates the comment_count value for one or more posts. * * ## OPTIONS * * <id>... * : IDs for one or more posts to update. * * ## EXAMPLES * * # Recount comment for the post. * $ wp comment recount 123 * Updated post 123 comment count to 67. */ public function recount( $args ) { foreach ( $args as $id ) { if ( wp_update_comment_count( $id ) ) { $post = get_post( $id ); WP_CLI::log( "Updated post {$post->ID} comment count to {$post->comment_count}." ); } else { WP_CLI::warning( "Post {$id} doesn't exist." ); } } } /** * Gets the status of a comment. * * ## OPTIONS * * <id> * : The ID of the comment to check. * * ## EXAMPLES * * # Get status of comment. * $ wp comment status 1337 * approved */ public function status( $args, $assoc_args ) { list( $comment_id ) = $args; $status = wp_get_comment_status( $comment_id ); if ( false === $status ) { WP_CLI::error( "Could not check status of comment {$comment_id}." ); } else { WP_CLI::line( $status ); } } /** * Verifies whether a comment exists. * * Displays a success message if the comment does exist. * * ## OPTIONS * * <id> * : The ID of the comment to check. * * ## EXAMPLES * * # Check whether comment exists. * $ wp comment exists 1337 * Success: Comment with ID 1337 exists. */ public function exists( $args ) { if ( $this->fetcher->get( $args[0] ) ) { WP_CLI::success( "Comment with ID {$args[0]} exists." ); } } } <?php use WP_CLI\Utils; use WP_CLI\Formatter; /** * Lists registered sidebars. * * A [sidebar](https://developer.wordpress.org/themes/functionality/sidebars/) is any widgetized area of your theme. * * ## EXAMPLES * * # List sidebars * $ wp sidebar list --fields=name,id --format=csv * name,id * "Widget Area",sidebar-1 * "Inactive Widgets",wp_inactive_widgets */ class Sidebar_Command extends WP_CLI_Command { private $fields = [ 'name', 'id', 'description', ]; /** * Lists registered sidebars. * * ## OPTIONS * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - ids * - count * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each sidebar: * * * name * * id * * description * * These fields are optionally available: * * * class * * before_widget * * after_widget * * before_title * * after_title * * ## EXAMPLES * * $ wp sidebar list --fields=name,id --format=csv * name,id * "Widget Area",sidebar-1 * "Inactive Widgets",wp_inactive_widgets * * @subcommand list */ public function list_( $args, $assoc_args ) { global $wp_registered_sidebars; Utils\wp_register_unused_sidebar(); if ( ! empty( $assoc_args['format'] ) && 'ids' === $assoc_args['format'] ) { $sidebars = wp_list_pluck( $wp_registered_sidebars, 'id' ); } else { $sidebars = $wp_registered_sidebars; } $formatter = new Formatter( $assoc_args, $this->fields ); $formatter->display_items( $sidebars ); } } <?php use WP_CLI\Utils; use WP_CLI\Formatter; /** * Manages widgets, including adding and moving them within sidebars. * * A [widget](https://developer.wordpress.org/themes/functionality/widgets/) adds content and features to a widget area (also called a [sidebar](https://developer.wordpress.org/themes/functionality/sidebars/)). * * ## EXAMPLES * * # List widgets on a given sidebar * $ wp widget list sidebar-1 * +----------+------------+----------+----------------------+ * | name | id | position | options | * +----------+------------+----------+----------------------+ * | meta | meta-6 | 1 | {"title":"Meta"} | * | calendar | calendar-2 | 2 | {"title":"Calendar"} | * +----------+------------+----------+----------------------+ * * # Add a calendar widget to the second position on the sidebar * $ wp widget add calendar sidebar-1 2 * Success: Added widget to sidebar. * * # Update option(s) associated with a given widget * $ wp widget update calendar-1 --title="Calendar" * Success: Widget updated. * * # Delete one or more widgets entirely * $ wp widget delete calendar-2 archive-1 * Success: 2 widgets removed from sidebar. */ class Widget_Command extends WP_CLI_Command { private $fields = [ 'name', 'id', 'position', 'options', ]; /** * Lists widgets associated with a sidebar. * * ## OPTIONS * * <sidebar-id> * : ID for the corresponding sidebar. * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - ids * - json * - count * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each widget: * * * name * * id * * position * * options * * There are no optionally available fields. * * ## EXAMPLES * * $ wp widget list sidebar-1 --fields=name,id --format=csv * name,id * meta,meta-5 * search,search-3 * * @subcommand list */ public function list_( $args, $assoc_args ) { list( $sidebar_id ) = $args; $this->validate_sidebar( $sidebar_id ); $output_widgets = $this->get_sidebar_widgets( $sidebar_id ); if ( ! empty( $assoc_args['format'] ) && 'ids' === $assoc_args['format'] ) { $output_widgets = wp_list_pluck( $output_widgets, 'id' ); } $formatter = new Formatter( $assoc_args, $this->fields ); $formatter->display_items( $output_widgets ); } /** * Adds a widget to a sidebar. * * Creates a new widget entry in the database, and associates it with the * sidebar. * * ## OPTIONS * * <name> * : Widget name. * * <sidebar-id> * : ID for the corresponding sidebar. * * [<position>] * : Widget's current position within the sidebar. Defaults to last * * [--<field>=<value>] * : Widget option to add, with its new value * * ## EXAMPLES * * # Add a new calendar widget to sidebar-1 with title "Calendar" * $ wp widget add calendar sidebar-1 2 --title="Calendar" * Success: Added widget to sidebar. * * @subcommand add */ public function add( $args, $assoc_args ) { list( $name, $sidebar_id ) = $args; $this->validate_sidebar( $sidebar_id ); $position = count( $args ) > 2 ? $args[2] - 1 : count( $this->get_sidebar_widgets( $sidebar_id ) ); $widget = $this->get_widget_obj( $name ); if ( false === $widget ) { WP_CLI::error( 'Invalid widget type.' ); } /* * Adding a widget is as easy as: * 1. Creating a new widget option * 2. Adding the widget to the sidebar * 3. Positioning appropriately */ $widget_options = $this->get_widget_options( $name ); $option_keys = $widget_options; if ( ! isset( $widget_options['_multiwidget'] ) ) { $widget_options['_multiwidget'] = 1; } unset( $option_keys['_multiwidget'] ); $option_keys = array_keys( $option_keys ); $last_key = array_pop( $option_keys ); $option_index = $last_key + 1; $widget_options[ $option_index ] = $this->sanitize_widget_options( $name, $assoc_args, array() ); $this->update_widget_options( $name, $widget_options ); $widget_id = $name . '-' . $option_index; $this->move_sidebar_widget( $widget_id, null, $sidebar_id, null, $position ); WP_CLI::success( 'Added widget to sidebar.' ); } /** * Updates options for an existing widget. * * ## OPTIONS * * <widget-id> * : Unique ID for the widget * * [--<field>=<value>] * : Field to update, with its new value * * ## EXAMPLES * * # Change calendar-1 widget title to "Our Calendar" * $ wp widget update calendar-1 --title="Our Calendar" * Success: Widget updated. * * @subcommand update */ public function update( $args, $assoc_args ) { list( $widget_id ) = $args; if ( ! $this->validate_sidebar_widget( $widget_id ) ) { WP_CLI::error( "Widget doesn't exist." ); } if ( empty( $assoc_args ) ) { WP_CLI::error( 'No options specified to update.' ); } list( $name, $option_index ) = $this->get_widget_data( $widget_id ); $widget_options = $this->get_widget_options( $name ); $clean_options = $this->sanitize_widget_options( $name, $assoc_args, $widget_options[ $option_index ] ); $widget_options[ $option_index ] = array_merge( (array) $widget_options[ $option_index ], $clean_options ); $this->update_widget_options( $name, $widget_options ); WP_CLI::success( 'Widget updated.' ); } /** * Moves the position of a widget. * * Changes the order of a widget in its existing sidebar, or moves it to a * new sidebar. * * ## OPTIONS * * <widget-id> * : Unique ID for the widget * * [--position=<position>] * : Assign the widget to a new position. * * [--sidebar-id=<sidebar-id>] * : Assign the widget to a new sidebar * * ## EXAMPLES * * # Change position of widget * $ wp widget move recent-comments-2 --position=2 * Success: Widget moved. * * # Move widget to Inactive Widgets * $ wp widget move recent-comments-2 --sidebar-id=wp_inactive_widgets * Success: Widget moved. * * @subcommand move */ public function move( $args, $assoc_args ) { list( $widget_id ) = $args; if ( ! $this->validate_sidebar_widget( $widget_id ) ) { WP_CLI::error( "Widget doesn't exist." ); } if ( empty( $assoc_args['position'] ) && empty( $assoc_args['sidebar-id'] ) ) { WP_CLI::error( 'A new position or new sidebar must be specified.' ); } list( $name, $option_index, $current_sidebar_id, $current_sidebar_index ) = $this->get_widget_data( $widget_id ); $new_sidebar_id = ! empty( $assoc_args['sidebar-id'] ) ? $assoc_args['sidebar-id'] : $current_sidebar_id; $this->validate_sidebar( $new_sidebar_id ); $new_sidebar_index = ! empty( $assoc_args['position'] ) ? $assoc_args['position'] - 1 : $current_sidebar_index; // Moving between sidebars adds to the top. if ( $new_sidebar_id !== $current_sidebar_id && $new_sidebar_index === $current_sidebar_index ) { // Human-readable positions are different than numerically indexed array. $new_sidebar_index = 0; } $this->move_sidebar_widget( $widget_id, $current_sidebar_id, $new_sidebar_id, $current_sidebar_index, $new_sidebar_index ); WP_CLI::success( 'Widget moved.' ); } /** * Deactivates one or more widgets from an active sidebar. * * Moves widgets to Inactive Widgets. * * ## OPTIONS * * <widget-id>... * : Unique ID for the widget(s) * * ## EXAMPLES * * # Deactivate the recent-comments-2 widget. * $ wp widget deactivate recent-comments-2 * Success: 1 widget deactivated. * * @subcommand deactivate */ public function deactivate( $args, $assoc_args ) { $count = 0; $errors = 0; foreach ( $args as $widget_id ) { if ( ! $this->validate_sidebar_widget( $widget_id ) ) { WP_CLI::warning( "Widget '{$widget_id}' doesn't exist." ); ++$errors; continue; } list( $name, $option_index, $sidebar_id, $sidebar_index ) = $this->get_widget_data( $widget_id ); if ( 'wp_inactive_widgets' === $sidebar_id ) { WP_CLI::warning( sprintf( "'%s' is already deactivated.", $widget_id ) ); continue; } $this->move_sidebar_widget( $widget_id, $sidebar_id, 'wp_inactive_widgets', $sidebar_index, count( $this->get_sidebar_widgets( 'wp_inactive_widgets' ) ) ); ++$count; } Utils\report_batch_operation_results( 'widget', 'deactivate', count( $args ), $count, $errors ); } /** * Deletes one or more widgets from a sidebar. * * ## OPTIONS * * <widget-id>... * : Unique ID for the widget(s) * * ## EXAMPLES * * # Delete the recent-comments-2 widget from its sidebar. * $ wp widget delete recent-comments-2 * Success: Deleted 1 of 1 widgets. * * @subcommand delete */ public function delete( $args, $assoc_args ) { $count = 0; $errors = 0; foreach ( $args as $widget_id ) { if ( ! $this->validate_sidebar_widget( $widget_id ) ) { WP_CLI::warning( "Widget '{$widget_id}' doesn't exist." ); ++$errors; continue; } // Remove the widget's settings. list( $name, $option_index, $sidebar_id, $sidebar_index ) = $this->get_widget_data( $widget_id ); $widget_options = $this->get_widget_options( $name ); unset( $widget_options[ $option_index ] ); $this->update_widget_options( $name, $widget_options ); // Remove the widget from the sidebar. $all_widgets = $this->wp_get_sidebars_widgets(); unset( $all_widgets[ $sidebar_id ][ $sidebar_index ] ); $all_widgets[ $sidebar_id ] = array_values( $all_widgets[ $sidebar_id ] ); update_option( 'sidebars_widgets', $all_widgets ); ++$count; } Utils\report_batch_operation_results( 'widget', 'delete', count( $args ), $count, $errors ); } /** * Resets sidebar. * * Removes all widgets from the sidebar and places them in Inactive Widgets. * * ## OPTIONS * * [<sidebar-id>...] * : One or more sidebars to reset. * * [--all] * : If set, all sidebars will be reset. * * ## EXAMPLES * * # Reset a sidebar * $ wp widget reset sidebar-1 * Success: Sidebar 'sidebar-1' reset. * * # Reset multiple sidebars * $ wp widget reset sidebar-1 sidebar-2 * Success: Sidebar 'sidebar-1' reset. * Success: Sidebar 'sidebar-2' reset. * * # Reset all sidebars * $ wp widget reset --all * Success: Sidebar 'sidebar-1' reset. * Success: Sidebar 'sidebar-2' reset. * Success: Sidebar 'sidebar-3' reset. */ public function reset( $args, $assoc_args ) { global $wp_registered_sidebars; $all = Utils\get_flag_value( $assoc_args, 'all', false ); // Bail if no arguments and no all flag. if ( ! $all && empty( $args ) ) { WP_CLI::error( 'Please specify one or more sidebars, or use --all.' ); } // Fetch all sidebars if all flag is set. if ( $all ) { $args = array_keys( $wp_registered_sidebars ); } // Sidebar ID wp_inactive_widgets is reserved by WP core for inactive widgets. if ( isset( $args['wp_inactive_widgets'] ) ) { unset( $args['wp_inactive_widgets'] ); } // Check if no registered sidebar. if ( empty( $args ) ) { WP_CLI::error( 'No sidebar registered.' ); } $count = 0; $errors = 0; foreach ( $args as $sidebar_id ) { if ( ! array_key_exists( $sidebar_id, $wp_registered_sidebars ) ) { WP_CLI::warning( sprintf( 'Invalid sidebar: %s', $sidebar_id ) ); ++$errors; continue; } $widgets = $this->get_sidebar_widgets( $sidebar_id ); if ( empty( $widgets ) ) { WP_CLI::warning( sprintf( "Sidebar '%s' is already empty.", $sidebar_id ) ); } else { foreach ( $widgets as $widget ) { $widget_id = $widget->id; list( $name, $option_index, $new_sidebar_id, $sidebar_index ) = $this->get_widget_data( $widget_id ); $this->move_sidebar_widget( $widget_id, $new_sidebar_id, 'wp_inactive_widgets', $sidebar_index, count( $this->get_sidebar_widgets( 'wp_inactive_widgets' ) ) ); } WP_CLI::log( sprintf( "Sidebar '%s' reset.", $sidebar_id ) ); ++$count; } } Utils\report_batch_operation_results( 'sidebar', 'reset', count( $args ), $count, $errors ); } /** * Checks whether a sidebar is a valid sidebar * * @param string $sidebar_id */ private function validate_sidebar( $sidebar_id ) { global $wp_registered_sidebars; Utils\wp_register_unused_sidebar(); if ( ! array_key_exists( $sidebar_id, $wp_registered_sidebars ) ) { WP_CLI::error( 'Invalid sidebar.' ); } } /** * Checks whether the specified widget is on the sidebar * * @param string $widget_id */ private function validate_sidebar_widget( $widget_id ) { $sidebars_widgets = $this->wp_get_sidebars_widgets(); $widget_exists = false; foreach ( $sidebars_widgets as $sidebar_id => $widgets ) { if ( in_array( $widget_id, $widgets, true ) ) { $widget_exists = true; break; } } return $widget_exists; } /** * Gets the widgets (and their associated data) for a given sidebar * * @param string $sidebar_id * @return array */ private function get_sidebar_widgets( $sidebar_id ) { $all_widgets = $this->wp_get_sidebars_widgets(); if ( empty( $all_widgets[ $sidebar_id ] ) ) { return array(); } $prepared_widgets = array(); foreach ( $all_widgets[ $sidebar_id ] as $key => $widget_id ) { $prepared_widget = new stdClass(); $parts = explode( '-', $widget_id ); $option_index = array_pop( $parts ); $widget_name = implode( '-', $parts ); $prepared_widget->name = $widget_name; $prepared_widget->id = $widget_id; $prepared_widget->position = $key + 1; $widget_options = get_option( 'widget_' . $widget_name ); $prepared_widget->options = $widget_options[ $option_index ]; $prepared_widgets[] = $prepared_widget; } return $prepared_widgets; } /** * Re-implementation of wp_get_sidebars_widgets() * because the original has a nasty global component */ private function wp_get_sidebars_widgets() { $sidebars_widgets = get_option( 'sidebars_widgets', array() ); if ( is_array( $sidebars_widgets ) && isset( $sidebars_widgets['array_version'] ) ) { unset( $sidebars_widgets['array_version'] ); } return $sidebars_widgets; } /** * Gets the widget's name, option index, sidebar, and sidebar index from its ID * * @param string $widget_id * @return array */ private function get_widget_data( $widget_id ) { $parts = explode( '-', $widget_id ); $option_index = array_pop( $parts ); $name = implode( '-', $parts ); $sidebar_id = false; $sidebar_index = false; $all_widgets = $this->wp_get_sidebars_widgets(); foreach ( $all_widgets as $s_id => &$widgets ) { $key = array_search( $widget_id, $widgets, true ); if ( false !== $key ) { $sidebar_id = $s_id; $sidebar_index = $key; break; } } return array( $name, $option_index, $sidebar_id, $sidebar_index ); } /** * Gets the options for a given widget * * @param string $name * @return array */ private function get_widget_options( $name ) { return get_option( 'widget_' . $name, array() ); } /** * Updates the options for a given widget * * @param string $name * @param mixed */ private function update_widget_options( $name, $value ) { update_option( 'widget_' . $name, $value ); } /** * Repositions a widget within a sidebar or move to another sidebar. * * @param string $widget_id * @param string|null $current_sidebar_id * @param string $new_sidebar_id * @param int|null $current_index * @param int $new_index */ private function move_sidebar_widget( $widget_id, $current_sidebar_id, $new_sidebar_id, $current_index, $new_index ) { $all_widgets = $this->wp_get_sidebars_widgets(); $needs_placement = true; // Existing widget if ( $current_sidebar_id && ! is_null( $current_index ) ) { $widgets = $all_widgets[ $current_sidebar_id ]; if ( $current_sidebar_id !== $new_sidebar_id ) { unset( $widgets[ $current_index ] ); } else { $part = array_splice( $widgets, $current_index, 1 ); array_splice( $widgets, $new_index, 0, $part ); $needs_placement = false; } $all_widgets[ $current_sidebar_id ] = array_values( $widgets ); } if ( $needs_placement ) { $widgets = ! empty( $all_widgets[ $new_sidebar_id ] ) ? $all_widgets[ $new_sidebar_id ] : array(); $before = array_slice( $widgets, 0, $new_index, true ); $after = array_slice( $widgets, $new_index, count( $widgets ), true ); $widgets = array_merge( $before, array( $widget_id ), $after ); $all_widgets[ $new_sidebar_id ] = array_values( $widgets ); } update_option( 'sidebars_widgets', $all_widgets ); } /** * Gets a widget's instantiated object based on its name * * @param string $id_base Name of the widget * @return WP_Widget|false */ private function get_widget_obj( $id_base ) { global $wp_widget_factory; $widget = wp_filter_object_list( $wp_widget_factory->widgets, array( 'id_base' => $id_base ) ); if ( empty( $widget ) ) { return false; } return array_pop( $widget ); } /** * Cleans up a widget's options based on its update callback * * @param string $id_base Name of the widget * @param mixed $dirty_options * @param mixed $old_options * @return mixed */ private function sanitize_widget_options( $id_base, $dirty_options, $old_options ) { $widget = $this->get_widget_obj( $id_base ); if ( empty( $widget ) ) { return array(); } // No easy way to determine expected array keys for $dirty_options // because Widget API dependent on the form fields // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged -- Whitelisting due to above reason. return @$widget->update( $dirty_options, $old_options ); } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_widget_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_widget_autoloader ) ) { require_once $wpcli_widget_autoloader; } WP_CLI::add_command( 'widget', 'Widget_Command' ); WP_CLI::add_command( 'sidebar', 'Sidebar_Command' ); <?php namespace WP_CLI; use ArrayObject; use Exception; class SearchReplacer { private $from; private $to; private $recurse_objects; private $regex; private $regex_flags; private $regex_delimiter; private $regex_limit; private $logging; private $log_data; private $max_recursion; /** * @param string $from String we're looking to replace. * @param string $to What we want it to be replaced with. * @param bool $recurse_objects Should objects be recursively replaced? * @param bool $regex Whether `$from` is a regular expression. * @param string $regex_flags Flags for regular expression. * @param string $regex_delimiter Delimiter for regular expression. * @param bool $logging Whether logging. * @param integer $regex_limit The maximum possible replacements for each pattern in each subject string. */ public function __construct( $from, $to, $recurse_objects = false, $regex = false, $regex_flags = '', $regex_delimiter = '/', $logging = false, $regex_limit = -1 ) { $this->from = $from; $this->to = $to; $this->recurse_objects = $recurse_objects; $this->regex = $regex; $this->regex_flags = $regex_flags; $this->regex_delimiter = $regex_delimiter; $this->regex_limit = $regex_limit; $this->logging = $logging; $this->clear_log_data(); // Get the XDebug nesting level. Will be zero (no limit) if no value is set $this->max_recursion = intval( ini_get( 'xdebug.max_nesting_level' ) ); } /** * Take a serialised array and unserialise it replacing elements as needed and * unserialising any subordinate arrays and performing the replace on those too. * Ignores any serialized objects unless $recurse_objects is set to true. * * @param array|string $data The data to operate on. * @param bool $serialised Does the value of $data need to be unserialized? * * @return array The original array with all elements replaced as needed. */ public function run( $data, $serialised = false ) { return $this->run_recursively( $data, $serialised ); } /** * @param int $recursion_level Current recursion depth within the original data. * @param array $visited_data Data that has been seen in previous recursion iterations. */ private function run_recursively( $data, $serialised, $recursion_level = 0, $visited_data = array() ) { // some unseriliased data cannot be re-serialised eg. SimpleXMLElements try { if ( $this->recurse_objects ) { // If we've reached the maximum recursion level, short circuit if ( 0 !== $this->max_recursion && $recursion_level >= $this->max_recursion ) { return $data; } if ( is_array( $data ) || is_object( $data ) ) { // If we've seen this exact object or array before, short circuit if ( in_array( $data, $visited_data, true ) ) { return $data; // Avoid infinite loops when there's a cycle } // Add this data to the list of $visited_data[] = $data; } } try { // The error suppression operator is not enough in some cases, so we disable // reporting of notices and warnings as well. $error_reporting = error_reporting(); error_reporting( $error_reporting & ~E_NOTICE & ~E_WARNING ); $unserialized = is_string( $data ) ? @unserialize( $data ) : false; error_reporting( $error_reporting ); } catch ( \TypeError $exception ) { // phpcs:ignore PHPCompatibility.Classes.NewClasses.typeerrorFound // This type error is thrown when trying to unserialize a string that does not fit the // type declarations of the properties it is supposed to fill. // This type checking was introduced with PHP 8.1. // See https://github.com/wp-cli/search-replace-command/issues/191 \WP_CLI::warning( sprintf( 'Skipping an inconvertible serialized object: "%s", replacements might not be complete. Reason: %s.', $data, $exception->getMessage() ) ); throw new Exception( $exception->getMessage(), $exception->getCode(), $exception ); } if ( false !== $unserialized ) { $data = $this->run_recursively( $unserialized, true, $recursion_level + 1 ); } elseif ( is_array( $data ) ) { $keys = array_keys( $data ); foreach ( $keys as $key ) { $data[ $key ] = $this->run_recursively( $data[ $key ], false, $recursion_level + 1, $visited_data ); } } elseif ( $this->recurse_objects && ( is_object( $data ) || $data instanceof \__PHP_Incomplete_Class ) ) { if ( $data instanceof \__PHP_Incomplete_Class ) { $array = new ArrayObject( $data ); \WP_CLI::warning( sprintf( 'Skipping an uninitialized class "%s", replacements might not be complete.', $array['__PHP_Incomplete_Class_Name'] ) ); } else { try { foreach ( $data as $key => $value ) { $data->$key = $this->run_recursively( $value, false, $recursion_level + 1, $visited_data ); } } catch ( \Error $exception ) { // phpcs:ignore PHPCompatibility.Classes.NewClasses.errorFound // This error is thrown when the object that was unserialized cannot be iterated upon. // The most notable reason is an empty `mysqli_result` object which is then considered to be "already closed". // See https://github.com/wp-cli/search-replace-command/pull/192#discussion_r1412310179 \WP_CLI::warning( sprintf( 'Skipping an inconvertible serialized object of type "%s", replacements might not be complete. Reason: %s.', is_object( $data ) ? get_class( $data ) : gettype( $data ), $exception->getMessage() ) ); throw new Exception( $exception->getMessage(), $exception->getCode(), $exception ); } } } elseif ( is_string( $data ) ) { if ( $this->logging ) { $old_data = $data; } if ( $this->regex ) { $search_regex = $this->regex_delimiter; $search_regex .= $this->from; $search_regex .= $this->regex_delimiter; $search_regex .= $this->regex_flags; $result = preg_replace( $search_regex, $this->to, $data, $this->regex_limit ); if ( null === $result || PREG_NO_ERROR !== preg_last_error() ) { \WP_CLI::warning( sprintf( 'The provided regular expression threw a PCRE error - %s', $this->preg_error_message( $result ) ) ); } $data = $result; } else { $data = str_replace( $this->from, $this->to, $data ); } if ( $this->logging && $old_data !== $data ) { $this->log_data[] = $old_data; } } if ( $serialised ) { return serialize( $data ); } } catch ( Exception $exception ) { // phpcs:ignore Generic.CodeAnalysis.EmptyStatement.DetectedCatch -- Intentionally empty. } return $data; } /** * Gets existing data saved for this run when logging. * @return array Array of data strings, prior to replacements. */ public function get_log_data() { return $this->log_data; } /** * Clears data stored for logging. */ public function clear_log_data() { $this->log_data = array(); } /** * Get the PCRE error constant name from an error value. * * @param integer $error Error code. * @return string Error constant name. */ private function preg_error_message( $error ) { static $error_names = null; if ( null === $error_names ) { $definitions = get_defined_constants( true ); $pcre_constants = array_key_exists( 'pcre', $definitions ) ? $definitions['pcre'] : array(); $error_names = array_flip( $pcre_constants ); } return isset( $error_names[ $error ] ) ? $error_names[ $error ] : '<unknown error>'; } } <?php use cli\Colors; use cli\Table; use WP_CLI\Iterators; use WP_CLI\SearchReplacer; use WP_CLI\Utils; use function cli\safe_substr; class Search_Replace_Command extends WP_CLI_Command { private $dry_run; private $export_handle = false; private $export_insert_size; private $recurse_objects; private $regex; private $regex_flags; private $regex_delimiter; private $regex_limit = -1; private $skip_tables; private $skip_columns; private $include_columns; private $format; private $report; private $verbose; private $report_changed_only; private $log_handle = null; private $log_before_context = 40; private $log_after_context = 40; private $log_prefixes = array( '< ', '> ' ); private $log_colors; private $log_encoding; private $start_time; /** * Searches/replaces strings in the database. * * Searches through all rows in a selection of tables and replaces * appearances of the first string with the second string. * * By default, the command uses tables registered to the `$wpdb` object. On * multisite, this will just be the tables for the current site unless * `--network` is specified. * * Search/replace intelligently handles PHP serialized data, and does not * change primary key values. * * ## OPTIONS * * <old> * : A string to search for within the database. * * <new> * : Replace instances of the first string with this new string. * * [<table>...] * : List of database tables to restrict the replacement to. Wildcards are * supported, e.g. `'wp_*options'` or `'wp_post*'`. * * [--dry-run] * : Run the entire search/replace operation and show report, but don't save * changes to the database. * * [--network] * : Search/replace through all the tables registered to $wpdb in a * multisite install. * * [--all-tables-with-prefix] * : Enable replacement on any tables that match the table prefix even if * not registered on $wpdb. * * [--all-tables] * : Enable replacement on ALL tables in the database, regardless of the * prefix, and even if not registered on $wpdb. Overrides --network * and --all-tables-with-prefix. * * [--export[=<file>]] * : Write transformed data as SQL file instead of saving replacements to * the database. If <file> is not supplied, will output to STDOUT. * * [--export_insert_size=<rows>] * : Define number of rows in single INSERT statement when doing SQL export. * You might want to change this depending on your database configuration * (e.g. if you need to do fewer queries). Default: 50 * * [--skip-tables=<tables>] * : Do not perform the replacement on specific tables. Use commas to * specify multiple tables. Wildcards are supported, e.g. `'wp_*options'` or `'wp_post*'`. * * [--skip-columns=<columns>] * : Do not perform the replacement on specific columns. Use commas to * specify multiple columns. * * [--include-columns=<columns>] * : Perform the replacement on specific columns. Use commas to * specify multiple columns. * * [--precise] * : Force the use of PHP (instead of SQL) which is more thorough, * but slower. * * [--recurse-objects] * : Enable recursing into objects to replace strings. Defaults to true; * pass --no-recurse-objects to disable. * * [--verbose] * : Prints rows to the console as they're updated. * * [--regex] * : Runs the search using a regular expression (without delimiters). * Warning: search-replace will take about 15-20x longer when using --regex. * * [--regex-flags=<regex-flags>] * : Pass PCRE modifiers to regex search-replace (e.g. 'i' for case-insensitivity). * * [--regex-delimiter=<regex-delimiter>] * : The delimiter to use for the regex. It must be escaped if it appears in the search string. The default value is the result of `chr(1)`. * * [--regex-limit=<regex-limit>] * : The maximum possible replacements for the regex per row (or per unserialized data bit per row). Defaults to -1 (no limit). * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - count * --- * * [--report] * : Produce report. Defaults to true. * * [--report-changed-only] * : Report changed fields only. Defaults to false, unless logging, when it defaults to true. * * [--log[=<file>]] * : Log the items changed. If <file> is not supplied or is "-", will output to STDOUT. * Warning: causes a significant slow down, similar or worse to enabling --precise or --regex. * * [--before_context=<num>] * : For logging, number of characters to display before the old match and the new replacement. Default 40. Ignored if not logging. * * [--after_context=<num>] * : For logging, number of characters to display after the old match and the new replacement. Default 40. Ignored if not logging. * * ## EXAMPLES * * # Search and replace but skip one column * $ wp search-replace 'http://example.test' 'http://example.com' --skip-columns=guid * * # Run search/replace operation but dont save in database * $ wp search-replace 'foo' 'bar' wp_posts wp_postmeta wp_terms --dry-run * * # Run case-insensitive regex search/replace operation (slow) * $ wp search-replace '\[foo id="([0-9]+)"' '[bar id="\1"' --regex --regex-flags='i' * * # Turn your production multisite database into a local dev database * $ wp search-replace --url=example.com example.com example.test 'wp_*options' wp_blogs wp_site --network * * # Search/replace to a SQL file without transforming the database * $ wp search-replace foo bar --export=database.sql * * # Bash script: Search/replace production to development url (multisite compatible) * #!/bin/bash * if $(wp --url=http://example.com core is-installed --network); then * wp search-replace --url=http://example.com 'http://example.com' 'http://example.test' --recurse-objects --network --skip-columns=guid --skip-tables=wp_users * else * wp search-replace 'http://example.com' 'http://example.test' --recurse-objects --skip-columns=guid --skip-tables=wp_users * fi */ public function __invoke( $args, $assoc_args ) { global $wpdb; $old = array_shift( $args ); $new = array_shift( $args ); $total = 0; $report = array(); $this->dry_run = Utils\get_flag_value( $assoc_args, 'dry-run' ); $php_only = Utils\get_flag_value( $assoc_args, 'precise' ); $this->recurse_objects = Utils\get_flag_value( $assoc_args, 'recurse-objects', true ); $this->verbose = Utils\get_flag_value( $assoc_args, 'verbose' ); $this->format = Utils\get_flag_value( $assoc_args, 'format' ); $this->regex = Utils\get_flag_value( $assoc_args, 'regex', false ); if ( null !== $this->regex ) { $default_regex_delimiter = false; $this->regex_flags = Utils\get_flag_value( $assoc_args, 'regex-flags', false ); $this->regex_delimiter = Utils\get_flag_value( $assoc_args, 'regex-delimiter', '' ); if ( '' === $this->regex_delimiter ) { $this->regex_delimiter = chr( 1 ); $default_regex_delimiter = true; } } $regex_limit = Utils\get_flag_value( $assoc_args, 'regex-limit' ); if ( null !== $regex_limit ) { if ( ! preg_match( '/^(?:[0-9]+|-1)$/', $regex_limit ) || 0 === (int) $regex_limit ) { WP_CLI::error( '`--regex-limit` expects a non-zero positive integer or -1.' ); } $this->regex_limit = (int) $regex_limit; } if ( ! empty( $this->regex ) ) { if ( '' === $this->regex_delimiter ) { $this->regex_delimiter = chr( 1 ); } $search_regex = $this->regex_delimiter; $search_regex .= $old; $search_regex .= $this->regex_delimiter; $search_regex .= $this->regex_flags; // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged -- Preventing a warning when testing the regex. if ( false === @preg_match( $search_regex, '' ) ) { $error = error_get_last(); $preg_error_message = ( ! empty( $error ) && array_key_exists( 'message', $error ) ) ? "\n{$error['message']}." : ''; if ( $default_regex_delimiter ) { $flags_msg = $this->regex_flags ? "flags '$this->regex_flags'" : 'no flags'; $msg = "The regex pattern '$old' with default delimiter 'chr(1)' and {$flags_msg} fails."; } else { $msg = "The regex '$search_regex' fails."; } WP_CLI::error( $msg . $preg_error_message ); } } $this->skip_columns = explode( ',', Utils\get_flag_value( $assoc_args, 'skip-columns', '' ) ); $this->skip_tables = explode( ',', Utils\get_flag_value( $assoc_args, 'skip-tables', '' ) ); $this->include_columns = array_filter( explode( ',', Utils\get_flag_value( $assoc_args, 'include-columns', '' ) ) ); if ( $old === $new && ! $this->regex ) { WP_CLI::warning( "Replacement value '{$old}' is identical to search value '{$new}'. Skipping operation." ); exit; } $export = Utils\get_flag_value( $assoc_args, 'export' ); if ( null !== $export ) { if ( $this->dry_run ) { WP_CLI::error( 'You cannot supply --dry-run and --export at the same time.' ); } if ( true === $export ) { $this->export_handle = STDOUT; $this->verbose = false; } else { $this->export_handle = @fopen( $assoc_args['export'], 'w' ); if ( false === $this->export_handle ) { $error = error_get_last(); WP_CLI::error( sprintf( 'Unable to open export file "%s" for writing: %s.', $assoc_args['export'], $error['message'] ) ); } } $export_insert_size = Utils\get_flag_value( $assoc_args, 'export_insert_size', 50 ); // phpcs:ignore Universal.Operators.StrictComparisons.LooseEqual -- See the code, this is deliberate. if ( (int) $export_insert_size == $export_insert_size && $export_insert_size > 0 ) { $this->export_insert_size = $export_insert_size; } $php_only = true; } $log = Utils\get_flag_value( $assoc_args, 'log' ); if ( null !== $log ) { if ( true === $log || '-' === $log ) { $this->log_handle = STDOUT; } else { $this->log_handle = @fopen( $assoc_args['log'], 'w' ); if ( false === $this->log_handle ) { $error = error_get_last(); WP_CLI::error( sprintf( 'Unable to open log file "%s" for writing: %s.', $assoc_args['log'], $error['message'] ) ); } } if ( $this->log_handle ) { $before_context = Utils\get_flag_value( $assoc_args, 'before_context' ); if ( null !== $before_context && preg_match( '/^[0-9]+$/', $before_context ) ) { $this->log_before_context = (int) $before_context; } $after_context = Utils\get_flag_value( $assoc_args, 'after_context' ); if ( null !== $after_context && preg_match( '/^[0-9]+$/', $after_context ) ) { $this->log_after_context = (int) $after_context; } $log_prefixes = getenv( 'WP_CLI_SEARCH_REPLACE_LOG_PREFIXES' ); if ( false !== $log_prefixes && preg_match( '/^([^,]*),([^,]*)$/', $log_prefixes, $matches ) ) { $this->log_prefixes = array( $matches[1], $matches[2] ); } if ( STDOUT === $this->log_handle ) { $default_log_colors = array( 'log_table_column_id' => '%B', 'log_old' => '%R', 'log_new' => '%G', ); } else { $default_log_colors = array( 'log_table_column_id' => '', 'log_old' => '', 'log_new' => '', ); } $log_colors = getenv( 'WP_CLI_SEARCH_REPLACE_LOG_COLORS' ); if ( false !== $log_colors && preg_match( '/^([^,]*),([^,]*),([^,]*)$/', $log_colors, $matches ) ) { $default_log_colors = array( 'log_table_column_id' => $matches[1], 'log_old' => $matches[2], 'log_new' => $matches[3], ); } $this->log_colors = $this->get_colors( $assoc_args, $default_log_colors ); $this->log_encoding = 0 === strpos( $wpdb->charset, 'utf8' ) ? 'UTF-8' : false; } } $this->report = Utils\get_flag_value( $assoc_args, 'report', true ); // Defaults to true if logging, else defaults to false. $this->report_changed_only = Utils\get_flag_value( $assoc_args, 'report-changed-only', null !== $this->log_handle ); if ( $this->regex_flags ) { $php_only = true; } // never mess with hashed passwords $this->skip_columns[] = 'user_pass'; // Get table names based on leftover $args or supplied $assoc_args $tables = Utils\wp_get_table_names( $args, $assoc_args ); foreach ( $tables as $table ) { foreach ( $this->skip_tables as $skip_table ) { if ( fnmatch( $skip_table, $table ) ) { continue 2; } } $table_sql = self::esc_sql_ident( $table ); if ( $this->export_handle ) { fwrite( $this->export_handle, "\nDROP TABLE IF EXISTS $table_sql;\n" ); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- escaped through self::esc_sql_ident $row = $wpdb->get_row( "SHOW CREATE TABLE $table_sql", ARRAY_N ); fwrite( $this->export_handle, $row[1] . ";\n" ); list( $table_report, $total_rows ) = $this->php_export_table( $table, $old, $new ); if ( $this->report ) { $report = array_merge( $report, $table_report ); } $total += $total_rows; // Don't perform replacements on the actual database continue; } list( $primary_keys, $columns, $all_columns ) = self::get_columns( $table ); // since we'll be updating one row at a time, // we need a primary key to identify the row if ( empty( $primary_keys ) ) { // wasn't updated, so skip to the next table if ( $this->report_changed_only ) { continue; } if ( $this->report ) { $report[] = array( $table, '', 'skipped', '' ); } else { WP_CLI::warning( $all_columns ? "No primary keys for table '$table'." : "No such table '$table'." ); } continue; } foreach ( $columns as $col ) { if ( ! empty( $this->include_columns ) && ! in_array( $col, $this->include_columns, true ) ) { continue; } if ( in_array( $col, $this->skip_columns, true ) ) { continue; } if ( $this->verbose && 'count' !== $this->format ) { $this->start_time = microtime( true ); WP_CLI::log( sprintf( 'Checking: %s.%s', $table, $col ) ); } if ( ! $php_only && ! $this->regex ) { $col_sql = self::esc_sql_ident( $col ); $wpdb->last_error = ''; // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- escaped through self::esc_sql_ident $serial_row = $wpdb->get_row( "SELECT * FROM $table_sql WHERE $col_sql REGEXP '^[aiO]:[1-9]' LIMIT 1" ); // When the regex triggers an error, we should fall back to PHP if ( false !== strpos( $wpdb->last_error, 'ERROR 1139' ) ) { $serial_row = true; } } if ( $php_only || $this->regex || null !== $serial_row ) { $type = 'PHP'; $count = $this->php_handle_col( $col, $primary_keys, $table, $old, $new ); } else { $type = 'SQL'; $count = $this->sql_handle_col( $col, $primary_keys, $table, $old, $new ); } if ( $this->report && ( $count || ! $this->report_changed_only ) ) { $report[] = array( $table, $col, $count, $type ); } $total += $count; } } if ( $this->export_handle && STDOUT !== $this->export_handle ) { fclose( $this->export_handle ); } // Only informational output after this point if ( WP_CLI::get_config( 'quiet' ) || STDOUT === $this->export_handle ) { return; } if ( 'count' === $this->format ) { WP_CLI::line( $total ); return; } if ( $this->report && ! empty( $report ) ) { $table = new Table(); $table->setHeaders( array( 'Table', 'Column', 'Replacements', 'Type' ) ); $table->setRows( $report ); $table->display(); } if ( ! $this->dry_run ) { if ( ! empty( $assoc_args['export'] ) ) { $success_message = 1 === $total ? "Made 1 replacement and exported to {$assoc_args['export']}." : "Made {$total} replacements and exported to {$assoc_args['export']}."; } else { $success_message = 1 === $total ? 'Made 1 replacement.' : "Made $total replacements."; if ( $total && 'Default' !== Utils\wp_get_cache_type() ) { $success_message .= ' Please remember to flush your persistent object cache with `wp cache flush`.'; } } WP_CLI::success( $success_message ); } else { $success_message = ( 1 === $total ) ? '%d replacement to be made.' : '%d replacements to be made.'; WP_CLI::success( sprintf( $success_message, $total ) ); } } private function php_export_table( $table, $old, $new ) { list( $primary_keys, $columns, $all_columns ) = self::get_columns( $table ); $chunk_size = getenv( 'BEHAT_RUN' ) ? 10 : 1000; $args = array( 'table' => $table, 'fields' => $all_columns, 'chunk_size' => $chunk_size, ); $replacer = new SearchReplacer( $old, $new, $this->recurse_objects, $this->regex, $this->regex_flags, $this->regex_delimiter, false, $this->regex_limit ); $col_counts = array_fill_keys( $all_columns, 0 ); if ( $this->verbose && 'table' === $this->format ) { $this->start_time = microtime( true ); WP_CLI::log( sprintf( 'Checking: %s', $table ) ); } $rows = array(); foreach ( new Iterators\Table( $args ) as $i => $row ) { $row_fields = array(); foreach ( $all_columns as $col ) { $value = $row->$col; if ( $value && ! in_array( $col, $primary_keys, true ) && ! in_array( $col, $this->skip_columns, true ) ) { $new_value = $replacer->run( $value ); if ( $new_value !== $value ) { ++$col_counts[ $col ]; $value = $new_value; } } $row_fields[ $col ] = $value; } $rows[] = $row_fields; } $this->write_sql_row_fields( $table, $rows ); $table_report = array(); $total_rows = 0; $total_cols = 0; foreach ( $col_counts as $col => $col_count ) { if ( $this->report && ( $col_count || ! $this->report_changed_only ) ) { $table_report[] = array( $table, $col, $col_count, 'PHP' ); } if ( $col_count ) { ++$total_cols; $total_rows += $col_count; } } if ( $this->verbose && 'table' === $this->format ) { $time = round( microtime( true ) - $this->start_time, 3 ); WP_CLI::log( sprintf( '%d columns and %d total rows affected using PHP (in %ss).', $total_cols, $total_rows, $time ) ); } return array( $table_report, $total_rows ); } private function sql_handle_col( $col, $primary_keys, $table, $old, $new ) { global $wpdb; $table_sql = self::esc_sql_ident( $table ); $col_sql = self::esc_sql_ident( $col ); if ( $this->dry_run ) { if ( $this->log_handle ) { $count = $this->log_sql_diff( $col, $primary_keys, $table, $old, $new ); } else { // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- escaped through self::esc_sql_ident $count = $wpdb->get_var( $wpdb->prepare( "SELECT COUNT($col_sql) FROM $table_sql WHERE $col_sql LIKE BINARY %s;", '%' . self::esc_like( $old ) . '%' ) ); } } else { if ( $this->log_handle ) { $this->log_sql_diff( $col, $primary_keys, $table, $old, $new ); } // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- escaped through self::esc_sql_ident $count = $wpdb->query( $wpdb->prepare( "UPDATE $table_sql SET $col_sql = REPLACE($col_sql, %s, %s);", $old, $new ) ); } if ( $this->verbose && 'table' === $this->format ) { $time = round( microtime( true ) - $this->start_time, 3 ); WP_CLI::log( sprintf( '%d rows affected using SQL (in %ss).', $count, $time ) ); } return $count; } private function php_handle_col( $col, $primary_keys, $table, $old, $new ) { global $wpdb; $count = 0; $replacer = new SearchReplacer( $old, $new, $this->recurse_objects, $this->regex, $this->regex_flags, $this->regex_delimiter, null !== $this->log_handle, $this->regex_limit ); $table_sql = self::esc_sql_ident( $table ); $col_sql = self::esc_sql_ident( $col ); $base_key_condition = ''; $where_key = ''; if ( ! $this->regex ) { $base_key_condition = "$col_sql" . $wpdb->prepare( ' LIKE BINARY %s', '%' . self::esc_like( $old ) . '%' ); $where_key = "WHERE $base_key_condition"; } $escaped_primary_keys = self::esc_sql_ident( $primary_keys ); $primary_keys_sql = implode( ',', $escaped_primary_keys ); $order_by_keys = array_map( static function ( $key ) { return "{$key} ASC"; }, $escaped_primary_keys ); $order_by_sql = 'ORDER BY ' . implode( ',', $order_by_keys ); $limit = 1000; // 2 errors: // - WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- escaped through self::esc_sql_ident // - WordPress.CodeAnalysis.AssignmentInCondition -- no reason to do copy-paste for a single valid assignment in while // phpcs:ignore while ( $rows = $wpdb->get_results( "SELECT {$primary_keys_sql} FROM {$table_sql} {$where_key} {$order_by_sql} LIMIT {$limit}" ) ) { foreach ( $rows as $keys ) { $where_sql = ''; foreach ( (array) $keys as $k => $v ) { if ( '' !== $where_sql ) { $where_sql .= ' AND '; } $where_sql .= self::esc_sql_ident( $k ) . ' = ' . self::esc_sql_value( $v ); } // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- escaped through self::esc_sql_ident $col_value = $wpdb->get_var( "SELECT {$col_sql} FROM {$table_sql} WHERE {$where_sql}" ); if ( '' === $col_value ) { continue; } $value = $replacer->run( $col_value ); if ( $value === $col_value ) { continue; } // In case a needed re-serialization was unsuccessful, we should not update the value, // as this implies we hit an exception while processing. if ( gettype( $value ) !== gettype( $col_value ) ) { continue; } if ( $this->log_handle ) { $this->log_php_diff( $col, $keys, $table, $old, $new, $replacer->get_log_data() ); $replacer->clear_log_data(); } ++$count; if ( ! $this->dry_run ) { $update_where = array(); foreach ( (array) $keys as $k => $v ) { $update_where[ $k ] = $v; } $wpdb->update( $table, [ $col => $value ], $update_where ); } } // Because we are ordering by primary keys from least to greatest, // we can exclude previous chunks from consideration by adding greater-than conditions // to insist the next chunk's keys must be greater than the last of this chunk's keys. $last_row = end( $rows ); $next_key_conditions = array(); // NOTE: For a composite key (X, Y, Z), selecting the next rows requires the following conditions: // ( X = lastX AND Y = lastY AND Z > lastZ ) OR // ( X = lastX AND Y > lastY ) OR // ( X > lastX ) for ( $last_key_index = count( $primary_keys ) - 1; $last_key_index >= 0; $last_key_index-- ) { $next_key_subconditions = array(); for ( $i = 0; $i <= $last_key_index; $i++ ) { $k = $primary_keys[ $i ]; $v = $last_row->{ $k }; if ( $i < $last_key_index ) { $next_key_subconditions[] = self::esc_sql_ident( $k ) . ' = ' . self::esc_sql_value( $v ); } else { $next_key_subconditions[] = self::esc_sql_ident( $k ) . ' > ' . self::esc_sql_value( $v ); } } $next_key_conditions[] = '( ' . implode( ' AND ', $next_key_subconditions ) . ' )'; } $where_key_conditions = array(); if ( $base_key_condition ) { $where_key_conditions[] = $base_key_condition; } $where_key_conditions[] = '( ' . implode( ' OR ', $next_key_conditions ) . ' )'; $where_key = 'WHERE ' . implode( ' AND ', $where_key_conditions ); } if ( $this->verbose && 'table' === $this->format ) { $time = round( microtime( true ) - $this->start_time, 3 ); WP_CLI::log( sprintf( '%d rows affected using PHP (in %ss).', $count, $time ) ); } return $count; } private function write_sql_row_fields( $table, $rows ) { global $wpdb; if ( empty( $rows ) ) { return; } $table_sql = self::esc_sql_ident( $table ); $insert = "INSERT INTO $table_sql ("; $insert .= join( ', ', self::esc_sql_ident( array_keys( $rows[0] ) ) ); $insert .= ') VALUES '; $insert .= "\n"; $sql = $insert; $values = array(); $index = 1; $count = count( $rows ); $export_insert_size = $this->export_insert_size; foreach ( $rows as $row_fields ) { $subs = array(); foreach ( $row_fields as $field_value ) { if ( null === $field_value ) { $subs[] = 'NULL'; } else { $subs[] = '%s'; $values[] = $field_value; } } $sql .= '(' . join( ', ', $subs ) . ')'; // Add new insert statement if needed. Before this we close the previous with semicolon and write statement to sql-file. // "Statement break" is needed: // 1. When the loop is running every nth time (where n is insert statement size, $export_index_size). Remainder is zero also on first round, so it have to be excluded. // $index % $export_insert_size == 0 && $index > 0 // 2. Or when the loop is running last time // $index == $count if ( ( 0 === $index % $export_insert_size && $index > 0 ) || $index === $count ) { $sql .= ";\n"; if ( method_exists( $wpdb, 'remove_placeholder_escape' ) ) { // since 4.8.3 // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- verified inputs above $sql = $wpdb->remove_placeholder_escape( $wpdb->prepare( $sql, array_values( $values ) ) ); } else { // 4.8.2 or less // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- verified inputs above $sql = $wpdb->prepare( $sql, array_values( $values ) ); } fwrite( $this->export_handle, $sql ); // If there is still rows to loop, reset $sql and $values variables. if ( $count > $index ) { $sql = $insert; $values = array(); } } else { // Otherwise just add comma and new line $sql .= ",\n"; } ++$index; } } private static function get_columns( $table ) { global $wpdb; $table_sql = self::esc_sql_ident( $table ); $primary_keys = array(); $text_columns = array(); $all_columns = array(); $suppress_errors = $wpdb->suppress_errors(); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- escaped through self::esc_sql_ident $results = $wpdb->get_results( "DESCRIBE $table_sql" ); if ( ! empty( $results ) ) { foreach ( $results as $col ) { if ( 'PRI' === $col->Key ) { $primary_keys[] = $col->Field; } if ( self::is_text_col( $col->Type ) ) { $text_columns[] = $col->Field; } $all_columns[] = $col->Field; } } $wpdb->suppress_errors( $suppress_errors ); return array( $primary_keys, $text_columns, $all_columns ); } private static function is_text_col( $type ) { foreach ( array( 'text', 'varchar' ) as $token ) { if ( false !== stripos( $type, $token ) ) { return true; } } return false; } private static function esc_like( $old ) { global $wpdb; // Remove notices in 4.0 and support backwards compatibility if ( method_exists( $wpdb, 'esc_like' ) ) { // 4.0 $old = $wpdb->esc_like( $old ); } else { // phpcs:ignore WordPress.WP.DeprecatedFunctions.like_escapeFound -- BC-layer for WP 3.9 or less. $old = like_escape( esc_sql( $old ) ); // Note: this double escaping is actually necessary, even though `esc_like()` will be used in a `prepare()`. } return $old; } /** * Escapes (backticks) MySQL identifiers (aka schema object names) - i.e. column names, table names, and database/index/alias/view etc names. * See https://dev.mysql.com/doc/refman/5.5/en/identifiers.html * * @param string|array $idents A single identifier or an array of identifiers. * @return string|array An escaped string if given a string, or an array of escaped strings if given an array of strings. */ private static function esc_sql_ident( $idents ) { $backtick = static function ( $v ) { // Escape any backticks in the identifier by doubling. return '`' . str_replace( '`', '``', $v ) . '`'; }; if ( is_string( $idents ) ) { return $backtick( $idents ); } return array_map( $backtick, $idents ); } /** * Puts MySQL string values in single quotes, to avoid them being interpreted as column names. * * @param string|array $values A single value or an array of values. * @return string|array A quoted string if given a string, or an array of quoted strings if given an array of strings. */ private static function esc_sql_value( $values ) { $quote = static function ( $v ) { // Don't quote integer values to avoid MySQL's implicit type conversion. if ( preg_match( '/^[+-]?[0-9]{1,20}$/', $v ) ) { // MySQL BIGINT UNSIGNED max 18446744073709551615 (20 digits). return esc_sql( $v ); } // Put any string values between single quotes. return "'" . esc_sql( $v ) . "'"; }; if ( is_array( $values ) ) { return array_map( $quote, $values ); } return $quote( $values ); } /** * Gets the color codes from the options if any, and returns the passed in array colorized with 2 elements per entry, a color code (or '') and a reset (or ''). * * @param array $assoc_args The associative argument array passed to the command. * @param array $colors Array of default percent color code strings keyed by the color contexts. * @return array Array containing 2-element arrays keyed to the input $colors array. */ private function get_colors( $assoc_args, $colors ) { $color_reset = WP_CLI::colorize( '%n' ); $color_code_callback = static function ( $v ) { return substr( $v, 1 ); }; $color_codes = array_keys( Colors::getColors() ); $color_codes = array_map( $color_code_callback, $color_codes ); $color_codes = implode( '', $color_codes ); $color_codes_regex = '/^(?:%[' . $color_codes . '])*$/'; foreach ( array_keys( $colors ) as $color_col ) { $col_color_flag = Utils\get_flag_value( $assoc_args, $color_col . '_color' ); if ( null !== $col_color_flag ) { if ( ! preg_match( $color_codes_regex, $col_color_flag, $matches ) ) { WP_CLI::warning( "Unrecognized percent color code '$col_color_flag' for '{$color_col}_color'." ); } else { $colors[ $color_col ] = $matches[0]; } } $colors[ $color_col ] = $colors[ $color_col ] ? array( WP_CLI::colorize( $colors[ $color_col ] ), $color_reset ) : array( '', '' ); } return $colors; } /* * Logs the difference between old match and new replacement for SQL replacement. * * @param string $col Column being processed. * @param array $primary_keys Primary keys for table. * @param string $table Table being processed. * @param string $old Old value to match. * @param string $new New value to replace the old value with. * @return int Count of changed rows. */ private function log_sql_diff( $col, $primary_keys, $table, $old, $new ) { global $wpdb; if ( $primary_keys ) { $esc_primary_keys = implode( ', ', self::esc_sql_ident( $primary_keys ) ); $primary_keys_sql = count( $primary_keys ) > 1 ? "CONCAT_WS(',', {$esc_primary_keys}), " : "{$esc_primary_keys}, "; } else { $primary_keys_sql = ''; } $table_sql = self::esc_sql_ident( $table ); $col_sql = self::esc_sql_ident( $col ); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- escaped through self::esc_sql_ident $results = $wpdb->get_results( $wpdb->prepare( "SELECT {$primary_keys_sql}{$col_sql} FROM {$table_sql} WHERE {$col_sql} LIKE BINARY %s", '%' . self::esc_like( $old ) . '%' ), ARRAY_N ); if ( empty( $results ) ) { return 0; } $search_regex = '/' . preg_quote( $old, '/' ) . '/'; foreach ( $results as $result ) { list( $keys, $data ) = $primary_keys ? array( $result[0], $result[1] ) : array( null, $result[0] ); if ( preg_match_all( $search_regex, $data, $matches, PREG_OFFSET_CAPTURE ) ) { list( $old_bits, $new_bits ) = $this->log_bits( $search_regex, $data, $matches, $new ); $this->log_write( $col, $keys, $table, $old_bits, $new_bits ); } } return count( $results ); } /* * Logs the difference between old matches and new replacements at the end of a PHP (regex) replacement of a database row. * * @param string $col Column being processed. * @param array $keys Associative array (or object) of primary key names and their values for the row being processed. * @param string $table Table being processed. * @param string $old Old value to match. * @param string $new New value to replace the old value with. * @param array $log_data Array of data strings before replacements. */ private function log_php_diff( $col, $keys, $table, $old, $new, $log_data ) { if ( $this->regex ) { $search_regex = $this->regex_delimiter . $old . $this->regex_delimiter . $this->regex_flags; } else { $search_regex = '/' . preg_quote( $old, '/' ) . '/'; } $old_bits = array(); $new_bits = array(); foreach ( $log_data as $data ) { if ( preg_match_all( $search_regex, $data, $matches, PREG_OFFSET_CAPTURE ) ) { $bits = $this->log_bits( $search_regex, $data, $matches, $new ); $old_bits = array_merge( $old_bits, $bits[0] ); $new_bits = array_merge( $new_bits, $bits[1] ); } } if ( $old_bits ) { $this->log_write( $col, $keys, $table, $old_bits, $new_bits ); } } /** * Returns the arrays of old matches and new replacements based on the passed-in matches, with context. * * @param string $search_regex The search regular expression. * @param string $old_data Existing data being processed. * @param array $old_matches Old matches array returned by `preg_match_all()`. * @param string $new New value to replace the old value with. * @return array Two element array containing the array of old match log strings and the array of new replacement log strings with before/after contexts. */ private function log_bits( $search_regex, $old_data, $old_matches, $new ) { $encoding = $this->log_encoding; if ( ! $encoding && ( $this->log_before_context || $this->log_after_context ) && function_exists( 'mb_detect_encoding' ) ) { $encoding = mb_detect_encoding( $old_data, null, true /*strict*/ ); } // Generate a new data matches analog of the old data matches by simulating a `preg_replace()`. $is_regex = $this->regex; $i = 0; $diff = 0; $new_matches = array(); $new_data = preg_replace_callback( $search_regex, static function ( $matches ) use ( $old_matches, $new, $is_regex, &$new_matches, &$i, &$diff ) { if ( $is_regex ) { // Sub in any back references, "$1", "\2" etc, in the replacement string. $new = preg_replace_callback( '/(?<!\\\\)(?:\\\\\\\\)*((?:\\\\|\\$)[0-9]{1,2}|\\${[0-9]{1,2}\\})/', static function ( $m ) use ( $matches ) { $idx = (int) str_replace( array( '\\', '$', '{', '}' ), '', $m[0] ); return isset( $matches[ $idx ] ) ? $matches[ $idx ] : ''; }, $new ); $new = str_replace( '\\\\', '\\', $new ); // Unescape any backslashed backslashes. } $new_matches[0][ $i ][0] = $new; $new_matches[0][ $i ][1] = $old_matches[0][ $i ][1] + $diff; $diff += strlen( $new ) - strlen( $old_matches[0][ $i ][0] ); $i++; return $new; }, $old_data, $this->regex_limit, $match_cnt ); $old_bits = array(); $new_bits = array(); $append_next = false; $last_old_offset = 0; $last_new_offset = 0; for ( $i = 0; $i < $match_cnt; $i++ ) { $old_match = $old_matches[0][ $i ][0]; $old_offset = $old_matches[0][ $i ][1]; $new_match = $new_matches[0][ $i ][0]; $new_offset = $new_matches[0][ $i ][1]; $old_log = $this->log_colors['log_old'][0] . $old_match . $this->log_colors['log_old'][1]; $new_log = $this->log_colors['log_new'][0] . $new_match . $this->log_colors['log_new'][1]; $old_before = ''; $old_after = ''; $new_before = ''; $new_after = ''; $after_shortened = false; // Offsets are in bytes, so need to use `strlen()` and `substr()` before using `safe_substr()`. if ( $this->log_before_context && $old_offset && ! $append_next ) { $old_before = safe_substr( substr( $old_data, $last_old_offset, $old_offset - $last_old_offset ), -$this->log_before_context, null /*length*/, false /*is_width*/, $encoding ); $new_before = safe_substr( substr( $new_data, $last_new_offset, $new_offset - $last_new_offset ), -$this->log_before_context, null /*length*/, false /*is_width*/, $encoding ); } if ( $this->log_after_context ) { $old_end_offset = $old_offset + strlen( $old_match ); $new_end_offset = $new_offset + strlen( $new_match ); $old_after = safe_substr( substr( $old_data, $old_end_offset ), 0, $this->log_after_context, false /*is_width*/, $encoding ); $new_after = safe_substr( substr( $new_data, $new_end_offset ), 0, $this->log_after_context, false /*is_width*/, $encoding ); // To lessen context duplication in output, shorten the after context if it overlaps with the next match. if ( $i + 1 < $match_cnt && $old_end_offset + strlen( $old_after ) > $old_matches[0][ $i + 1 ][1] ) { $old_after = substr( $old_after, 0, $old_matches[0][ $i + 1 ][1] - $old_end_offset ); $new_after = substr( $new_after, 0, $new_matches[0][ $i + 1 ][1] - $new_end_offset ); $after_shortened = true; // On the next iteration, will append with no before context. } } if ( $append_next ) { $cnt = count( $old_bits ); $old_bits[ $cnt - 1 ] .= $old_log . $old_after; $new_bits[ $cnt - 1 ] .= $new_log . $new_after; } else { $old_bits[] = $old_before . $old_log . $old_after; $new_bits[] = $new_before . $new_log . $new_after; } $append_next = $after_shortened; $last_old_offset = $old_offset; $last_new_offset = $new_offset; } return array( $old_bits, $new_bits ); } /* * Outputs the log strings. * * @param string $col Column being processed. * @param array $keys Associative array (or object) of primary key names and their values for the row being processed. * @param string $table Table being processed. * @param array $old_bits Array of old match log strings. * @param array $new_bits Array of new replacement log strings. */ private function log_write( $col, $keys, $table, $old_bits, $new_bits ) { $id_log = $keys ? ( ':' . implode( ',', (array) $keys ) ) : ''; $table_column_id_log = $this->log_colors['log_table_column_id'][0] . $table . '.' . $col . $id_log . $this->log_colors['log_table_column_id'][1]; $old_log = str_replace( array( "\r\n", "\n" ), ' ', implode( ' [...] ', $old_bits ) ); $new_log = str_replace( array( "\r\n", "\n" ), ' ', implode( ' [...] ', $new_bits ) ); if ( $this->log_prefixes[0] ) { $old_log = $this->log_colors['log_old'][0] . $this->log_prefixes[0] . $this->log_colors['log_old'][1] . $old_log; } if ( $this->log_prefixes[1] ) { $new_log = $this->log_colors['log_new'][0] . $this->log_prefixes[1] . $this->log_colors['log_new'][1] . $new_log; } fwrite( $this->log_handle, "{$table_column_id_log}\n{$old_log}\n{$new_log}\n" ); } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_search_replace_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_search_replace_autoloader ) ) { require_once $wpcli_search_replace_autoloader; } WP_CLI::add_command( 'search-replace', 'Search_Replace_Command' ); <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_language_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_language_autoloader ) ) { require_once $wpcli_language_autoloader; } $wpcli_language_check_requirements = function () { if ( \WP_CLI\Utils\wp_version_compare( '4.0', '<' ) ) { WP_CLI::error( 'Requires WordPress 4.0 or greater.' ); } }; WP_CLI::add_command( 'language core', 'Core_Language_Command', array( 'before_invoke' => $wpcli_language_check_requirements ) ); WP_CLI::add_command( 'language plugin', 'Plugin_Language_Command', array( 'before_invoke' => $wpcli_language_check_requirements ) ); WP_CLI::add_command( 'language theme', 'Theme_Language_Command', array( 'before_invoke' => $wpcli_language_check_requirements ) ); WP_CLI::add_hook( 'after_add_command:site', function () { WP_CLI::add_command( 'site switch-language', 'Site_Switch_Language_Command' ); } ); if ( class_exists( 'WP_CLI\Dispatcher\CommandNamespace' ) ) { WP_CLI::add_command( 'language', 'Language_Namespace' ); } <?php /** * Installs, activates, and manages theme language packs. * * ## EXAMPLES * * # Install the Dutch theme language pack for Twenty Ten. * $ wp language theme install twentyten nl_NL * Downloading translation from https://downloads.wordpress.org/translation/theme/twentyten/4.0/nl_NL.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the translation... * Translation updated successfully. * Language 'nl_NL' installed. * Success: Installed 1 of 1 languages. * * # Uninstall the Dutch theme language pack for Twenty Ten. * $ wp language theme uninstall twentyten nl_NL * Language 'nl_NL' for 'twentyten' uninstalled. * +-----------+--------+-------------+ * | name | locale | status | * +-----------+--------+-------------+ * | twentyten | nl_NL | uninstalled | * +-----------+--------+-------------+ * Success: Uninstalled 1 of 1 languages. * * # List installed theme language packs for Twenty Ten. * $ wp language theme list twentyten --status=installed * +-----------+----------+--------------+-------------+-----------+--------+---------------------+ * | theme | language | english_name | native_name | status | update | updated | * +-----------+----------+--------------+-------------+-----------+--------+---------------------+ * | twentyten | nl_NL | Dutch | Nederlands | installed | none | 2023-12-29 21:21:39 | * +-----------+----------+--------------+-------------+-----------+--------+---------------------+ * * @package wp-cli */ class Theme_Language_Command extends WP_CLI\CommandWithTranslation { protected $obj_type = 'themes'; protected $obj_fields = array( 'theme', 'language', 'english_name', 'native_name', 'status', 'update', 'updated', ); /** * Lists all available languages for one or more themes. * * ## OPTIONS * * [<theme>...] * : One or more themes to list languages for. * * [--all] * : If set, available languages for all themes will be listed. * * [--field=<field>] * : Display the value of a single field. * * [--<field>=<value>] * : Filter results by key=value pairs. * * [--fields=<fields>] * : Limit the output to specific fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each translation: * * * theme * * language * * english_name * * native_name * * status * * update * * updated * * ## EXAMPLES * * # List available language packs for the theme. * $ wp language theme list twentyten --fields=language,english_name,status * +----------------+-------------------------+-------------+ * | language | english_name | status | * +----------------+-------------------------+-------------+ * | ar | Arabic | uninstalled | * | ary | Moroccan Arabic | uninstalled | * | az | Azerbaijani | uninstalled | * * @subcommand list */ public function list_( $args, $assoc_args ) { $all = \WP_CLI\Utils\get_flag_value( $assoc_args, 'all', false ); if ( ! $all && empty( $args ) ) { WP_CLI::error( 'Please specify one or more themes, or use --all.' ); } if ( $all ) { $args = array_map( function ( $file ) { return \WP_CLI\Utils\get_theme_name( $file ); }, array_keys( wp_get_themes() ) ); if ( empty( $args ) ) { WP_CLI::success( 'No themes installed.' ); return; } } $updates = $this->get_translation_updates(); $current_locale = get_locale(); $translations = array(); $themes = new \WP_CLI\Fetchers\Theme(); foreach ( $args as $theme ) { if ( ! $themes->get( $theme ) ) { WP_CLI::warning( "Theme '{$theme}' not found." ); continue; } $installed_translations = $this->get_installed_languages( $theme ); $available_translations = $this->get_all_languages( $theme ); foreach ( $available_translations as $translation ) { $translation['theme'] = $theme; $translation['status'] = in_array( $translation['language'], $installed_translations, true ) ? 'installed' : 'uninstalled'; if ( $current_locale === $translation['language'] ) { $translation['status'] = 'active'; } $filter_args = array( 'language' => $translation['language'], 'type' => 'theme', 'slug' => $theme, ); $update = wp_list_filter( $updates, $filter_args ); $translation['update'] = $update ? 'available' : 'none'; // Support features like --status=active. foreach ( array_keys( $translation ) as $field ) { if ( isset( $assoc_args[ $field ] ) && ! in_array( $translation[ $field ], array_map( 'trim', explode( ',', $assoc_args[ $field ] ) ), true ) ) { continue 2; } } $translations[] = $translation; } } $formatter = $this->get_formatter( $assoc_args ); $formatter->display_items( $translations ); } /** * Checks if a given language is installed. * * Returns exit code 0 when installed, 1 when uninstalled. * * ## OPTIONS * * <theme> * : Theme to check for. * * <language>... * : The language code to check. * * ## EXAMPLES * * # Check whether the German language is installed for Twenty Seventeen; exit status 0 if installed, otherwise 1. * $ wp language theme is-installed twentyseventeen de_DE * $ echo $? * 1 * * @subcommand is-installed */ public function is_installed( $args, $assoc_args = array() ) { $theme = array_shift( $args ); $language_codes = (array) $args; $available = $this->get_installed_languages( $theme ); foreach ( $language_codes as $language_code ) { if ( ! in_array( $language_code, $available, true ) ) { \WP_CLI::halt( 1 ); } } \WP_CLI::halt( 0 ); } /** * Installs a given language for a theme. * * Downloads the language pack from WordPress.org. * * ## OPTIONS * * [<theme>] * : Theme to install language for. * * [--all] * : If set, languages for all themes will be installed. * * <language>... * : Language code to install. * * [--format=<format>] * : Render output in a particular format. Used when installing languages for all themes. * --- * default: table * options: * - table * - csv * - json * - summary * --- * * ## EXAMPLES * * # Install the Japanese language for Twenty Seventeen. * $ wp language theme install twentyseventeen ja * Downloading translation from https://downloads.wordpress.org/translation/theme/twentyseventeen/1.3/ja.zip... * Unpacking the update... * Installing the latest version... * Translation updated successfully. * Language 'ja' installed. * Success: Installed 1 of 1 languages. * * @subcommand install */ public function install( $args, $assoc_args ) { $all = \WP_CLI\Utils\get_flag_value( $assoc_args, 'all', false ); if ( ! $all && count( $args ) < 2 ) { \WP_CLI::error( 'Please specify a theme, or use --all.' ); } if ( $all ) { $this->install_many( $args, $assoc_args ); } else { $this->install_one( $args, $assoc_args ); } } /** * Installs translations for a theme. * * @param array $args Runtime arguments. * @param array $assoc_args Runtime arguments. */ private function install_one( $args, $assoc_args ) { $theme = array_shift( $args ); $language_codes = (array) $args; $count = count( $language_codes ); $available = $this->get_installed_languages( $theme ); $successes = 0; $errors = 0; $skips = 0; foreach ( $language_codes as $language_code ) { if ( in_array( $language_code, $available, true ) ) { \WP_CLI::log( "Language '{$language_code}' already installed." ); ++$skips; } else { $response = $this->download_language_pack( $language_code, $theme ); if ( is_wp_error( $response ) ) { \WP_CLI::warning( $response ); \WP_CLI::log( "Language '{$language_code}' not installed." ); // Skip if translation is not yet available. if ( 'not_found' === $response->get_error_code() ) { ++$skips; } else { ++$errors; } } else { \WP_CLI::log( "Language '{$language_code}' installed." ); ++$successes; } } } \WP_CLI\Utils\report_batch_operation_results( 'language', 'install', $count, $successes, $errors, $skips ); } /** * Installs translations for all installed themes. * * @param array $args Runtime arguments. * @param array $assoc_args Runtime arguments. */ private function install_many( $args, $assoc_args ) { $language_codes = (array) $args; $themes = wp_get_themes(); if ( empty( $assoc_args['format'] ) ) { $assoc_args['format'] = 'table'; } if ( in_array( $assoc_args['format'], array( 'json', 'csv' ), true ) ) { $logger = new \WP_CLI\Loggers\Quiet(); \WP_CLI::set_logger( $logger ); } if ( empty( $themes ) ) { \WP_CLI::success( 'No themes installed.' ); return; } $count = count( $themes ) * count( $language_codes ); $results = array(); $successes = 0; $errors = 0; $skips = 0; foreach ( $themes as $theme_path => $theme_details ) { $theme_name = \WP_CLI\Utils\get_theme_name( $theme_path ); $available = $this->get_installed_languages( $theme_name ); foreach ( $language_codes as $language_code ) { $result = [ 'name' => $theme_name, 'locale' => $language_code, ]; if ( in_array( $language_code, $available, true ) ) { \WP_CLI::log( "Language '{$language_code}' for '{$theme_details['Name']}' already installed." ); $result['status'] = 'already installed'; ++$skips; } else { $response = $this->download_language_pack( $language_code, $theme_name ); if ( is_wp_error( $response ) ) { \WP_CLI::warning( $response ); \WP_CLI::log( "Language '{$language_code}' for '{$theme_details['Name']}' not installed." ); if ( 'not_found' === $response->get_error_code() ) { $result['status'] = 'not available'; ++$skips; } else { $result['status'] = 'not installed'; ++$errors; } } else { \WP_CLI::log( "Language '{$language_code}' for '{$theme_details['Name']}' installed." ); $result['status'] = 'installed'; ++$successes; } } $results[] = (object) $result; } } if ( 'summary' !== $assoc_args['format'] ) { \WP_CLI\Utils\format_items( $assoc_args['format'], $results, array( 'name', 'locale', 'status' ) ); } \WP_CLI\Utils\report_batch_operation_results( 'language', 'install', $count, $successes, $errors, $skips ); } /** * Uninstalls a given language for a theme. * * ## OPTIONS * * [<theme>] * : Theme to uninstall language for. * * [--all] * : If set, languages for all themes will be uninstalled. * * <language>... * : Language code to uninstall. * * [--format=<format>] * : Render output in a particular format. Used when installing languages for all themes. * --- * default: table * options: * - table * - csv * - json * - summary * --- * * ## EXAMPLES * * # Uninstall the Japanese theme language pack for Twenty Ten. * $ wp language theme uninstall twentyten ja * Language 'ja' for 'twentyten' uninstalled. * +-----------+--------+-------------+ * | name | locale | status | * +-----------+--------+-------------+ * | twentyten | ja | uninstalled | * +-----------+--------+-------------+ * Success: Uninstalled 1 of 1 languages. * * @subcommand uninstall */ public function uninstall( $args, $assoc_args ) { /** @var WP_Filesystem_Base $wp_filesystem */ global $wp_filesystem; if ( empty( $assoc_args['format'] ) ) { $assoc_args['format'] = 'table'; } if ( in_array( $assoc_args['format'], array( 'json', 'csv' ), true ) ) { $logger = new \WP_CLI\Loggers\Quiet(); \WP_CLI::set_logger( $logger ); } $all = \WP_CLI\Utils\get_flag_value( $assoc_args, 'all', false ); if ( ! $all && count( $args ) < 2 ) { \WP_CLI::error( 'Please specify one or more themes, or use --all.' ); } if ( $all ) { $themes = wp_get_themes(); if ( empty( $themes ) ) { \WP_CLI::success( 'No themes installed.' ); return; } $process_themes = array(); foreach ( $themes as $theme_path => $theme_details ) { $theme_name = \WP_CLI\Utils\get_theme_name( $theme_path ); array_push( $process_themes, $theme_name ); } } else { $process_themes = array( array_shift( $args ) ); } $language_codes = (array) $args; $current_locale = get_locale(); $dir = WP_LANG_DIR . "/$this->obj_type"; $files = scandir( $dir ); if ( ! $files ) { \WP_CLI::error( 'No files found in language directory.' ); } $count = count( $process_themes ) * count( $language_codes ); $results = array(); $successes = 0; $errors = 0; $skips = 0; // As of WP 4.0, no API for deleting a language pack WP_Filesystem(); foreach ( $process_themes as $theme ) { $available_languages = $this->get_installed_languages( $theme ); foreach ( $language_codes as $language_code ) { $result = [ 'name' => $theme, 'locale' => $language_code, 'status' => 'not available', ]; if ( ! in_array( $language_code, $available_languages, true ) ) { $result['status'] = 'not installed'; \WP_CLI::warning( "Language '{$language_code}' not installed." ); if ( $all ) { ++$skips; } else { ++$errors; } $results[] = (object) $result; continue; } if ( $language_code === $current_locale ) { \WP_CLI::warning( "The '{$language_code}' language is active." ); exit; } $files_to_remove = array( "$theme-$language_code.po", "$theme-$language_code.mo", "$theme-$language_code.l10n.php", ); $count_files_to_remove = 0; $count_files_removed = 0; $had_one_file = false; foreach ( $files as $file ) { if ( '.' === $file[0] || is_dir( $file ) ) { continue; } if ( ! in_array( $file, $files_to_remove, true ) && ! preg_match( "/$theme-$language_code-\w{32}\.json/", $file ) ) { continue; } $had_one_file = true; ++$count_files_to_remove; if ( $wp_filesystem->delete( $dir . '/' . $file ) ) { ++$count_files_removed; } else { \WP_CLI::error( "Couldn't uninstall language: $language_code from theme $theme." ); } } if ( $count_files_to_remove === $count_files_removed ) { $result['status'] = 'uninstalled'; ++$successes; \WP_CLI::log( "Language '{$language_code}' for '{$theme}' uninstalled." ); } elseif ( $count_files_removed ) { \WP_CLI::log( "Language '{$language_code}' for '{$theme}' partially uninstalled." ); $result['status'] = 'partial uninstall'; ++$errors; } elseif ( $had_one_file ) { /* $count_files_removed == 0 */ \WP_CLI::log( "Couldn't uninstall language '{$language_code}' from theme {$theme}." ); $result['status'] = 'failed to uninstall'; ++$errors; } else { \WP_CLI::log( "Language '{$language_code}' for '{$theme}' already uninstalled." ); $result['status'] = 'already uninstalled'; ++$skips; } $results[] = (object) $result; } } if ( 'summary' !== $assoc_args['format'] ) { \WP_CLI\Utils\format_items( $assoc_args['format'], $results, array( 'name', 'locale', 'status' ) ); } \WP_CLI\Utils\report_batch_operation_results( 'language', 'uninstall', $count, $successes, $errors, $skips ); } /** * Updates installed languages for one or more themes. * * ## OPTIONS * * [<theme>...] * : One or more themes to update languages for. * * [--all] * : If set, languages for all themes will be updated. * * [--dry-run] * : Preview which translations would be updated. * * ## EXAMPLES * * # Update all installed language packs for all themes. * $ wp language theme update --all * Updating 'Japanese' translation for Twenty Fifteen 1.5... * Downloading translation from https://downloads.wordpress.org/translation/theme/twentyfifteen/1.5/ja.zip... * Translation updated successfully. * Success: Updated 1/1 translation. * * @subcommand update */ public function update( $args, $assoc_args ) { $all = \WP_CLI\Utils\get_flag_value( $assoc_args, 'all', false ); if ( ! $all && empty( $args ) ) { WP_CLI::error( 'Please specify one or more themes, or use --all.' ); } if ( $all ) { $args = array_map( '\WP_CLI\Utils\get_theme_name', array_keys( wp_get_themes() ) ); if ( empty( $args ) ) { WP_CLI::success( 'No themes installed.' ); return; } } parent::update( $args, $assoc_args ); } } <?php namespace WP_CLI; use WP_CLI; /** * A Language Pack Upgrader class that caches the download, and uses cached if available * * @package wp-cli */ class LanguagePackUpgrader extends \Language_Pack_Upgrader { /** * Initialize the upgrade strings. * * Makes sure that the strings are always in English. */ public function upgrade_strings() { $switched_locale = function_exists( 'switch_to_locale' ) && switch_to_locale( 'en_US' ); parent::upgrade_strings(); if ( $switched_locale ) { restore_previous_locale(); } } /** * Initialize the generic strings. * * Makes sure that the strings are always in English. */ public function generic_strings() { $switched_locale = function_exists( 'switch_to_locale' ) && switch_to_locale( 'en_US' ); parent::generic_strings(); if ( $switched_locale ) { restore_previous_locale(); } } /** * Caches the download, and uses cached if available. * * @param string $package The URI of the package. If this is the full path to an * existing local file, it will be returned untouched. * @param bool $check_signatures Whether to validate file signatures. Default false. * @param array $hook_extra Extra arguments to pass to the filter hooks. Default empty array. * @return string|\WP_Error The full path to the downloaded package file, or a WP_Error object. */ public function download_package( $package, $check_signatures = false, $hook_extra = [] ) { /** * Filter whether to return the package. * * @since 3.7.0 * @since 5.5.0 Added the `$hook_extra` parameter. * * @param bool $reply Whether to bail without returning the package. Default is false. * @param string $package The package file name. * @param \WP_Upgrader $this The WP_Upgrader instance. * @param array $hook_extra Extra arguments passed to hooked filters. * * @phpcs:disable WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Using WP native hook. */ $reply = apply_filters( 'upgrader_pre_download', false, $package, $this, $hook_extra ); // phpcs:enable if ( false !== $reply ) { return $reply; } // Check if package is a local or remote file. Bail if it's local. if ( ! preg_match( '!^(http|https|ftp)://!i', $package ) && file_exists( $package ) ) { return $package; } if ( empty( $package ) ) { return new \WP_Error( 'no_package', $this->strings['no_package'] ); } $language_update = $this->skin->language_update; $type = $language_update->type; $slug = empty( $language_update->slug ) ? 'default' : $language_update->slug; $updated = strtotime( $language_update->updated ); $version = $language_update->version; $language = $language_update->language; $ext = pathinfo( $package, PATHINFO_EXTENSION ); $temp = \WP_CLI\Utils\get_temp_dir() . uniqid( 'wp_' ) . '.' . $ext; $cache = WP_CLI::get_cache(); $cache_key = "translation/{$type}-{$slug}-{$version}-{$language}-{$updated}.{$ext}"; $cache_file = $cache->has( $cache_key ); if ( $cache_file ) { WP_CLI::log( "Using cached file '$cache_file'..." ); copy( $cache_file, $temp ); return $temp; } $this->skin->feedback( 'downloading_package', $package ); $temp = download_url( $package, 600 ); // 10 minutes ought to be enough for everybody. if ( is_wp_error( $temp ) ) { return $temp; } $cache->import( $cache_key, $temp ); return $temp; } } <?php namespace WP_CLI; use WP_CLI; use WP_CLI_Command; /** * Base class for WP-CLI commands that deal with translations * * @package wp-cli */ abstract class CommandWithTranslation extends WP_CLI_Command { protected $obj_type; protected $obj_fields; /** * Callback to sort array by a 'language' key. */ protected function sort_translations_callback( $a, $b ) { return strnatcasecmp( $a['language'], $b['language'] ); } /** * Updates installed languages for the current object type. */ public function update( $args, $assoc_args ) { $updates = $this->get_translation_updates(); if ( empty( $updates ) ) { WP_CLI::success( 'Translations are up to date.' ); return; } if ( empty( $args ) ) { $args = array( null ); // Used for core. } $upgrader = 'WP_CLI\\LanguagePackUpgrader'; $results = array(); $num_to_update = 0; foreach ( $args as $slug ) { // Gets a list of all languages. $all_languages = $this->get_all_languages( $slug ); $updates_per_type = array(); // Formats the updates list. foreach ( $updates as $update ) { if ( null !== $slug && $update->slug !== $slug ) { continue; } $name = 'WordPress'; // Core. if ( 'plugin' === $update->type ) { $plugins = get_plugins( '/' . $update->slug ); $plugin_data = array_shift( $plugins ); $name = $plugin_data['Name']; } elseif ( 'theme' === $update->type ) { $theme_data = wp_get_theme( $update->slug ); $name = $theme_data['Name']; } // Gets the translation data. $translation = wp_list_filter( $all_languages, array( 'language' => $update->language ) ); $translation = (object) reset( $translation ); $update->Type = ucfirst( $update->type ); $update->Name = $name; $update->Version = $update->version; if ( isset( $translation->english_name ) ) { $update->Language = $translation->english_name; } if ( ! isset( $updates_per_type[ $update->type ] ) ) { $updates_per_type[ $update->type ] = array(); } $updates_per_type[ $update->type ][] = $update; } $obj_type = rtrim( $this->obj_type, 's' ); $available_updates = isset( $updates_per_type[ $obj_type ] ) ? $updates_per_type[ $obj_type ] : null; if ( ! is_array( $available_updates ) ) { continue; } $num_to_update += count( $available_updates ); if ( ! Utils\get_flag_value( $assoc_args, 'dry-run' ) ) { // Update translations. foreach ( $available_updates as $update ) { WP_CLI::line( "Updating '{$update->Language}' translation for {$update->Name} {$update->Version}..." ); $result = Utils\get_upgrader( $upgrader )->upgrade( $update ); $results[] = $result; } } } // Only preview which translations would be updated. if ( Utils\get_flag_value( $assoc_args, 'dry-run' ) ) { $update_count = count( $updates ); WP_CLI::line( sprintf( 'Found %d translation %s that would be processed:', $update_count, WP_CLI\Utils\pluralize( 'update', $update_count ) ) ); Utils\format_items( 'table', $updates, array( 'Type', 'Name', 'Version', 'Language' ) ); return; } $num_updated = count( array_filter( $results ) ); $line = sprintf( "Updated $num_updated/$num_to_update %s.", WP_CLI\Utils\pluralize( 'translation', $num_updated ) ); if ( $num_to_update === $num_updated ) { WP_CLI::success( $line ); } elseif ( $num_updated > 0 ) { WP_CLI::warning( $line ); } else { WP_CLI::error( $line ); } } /** * Get all updates available for all translations. * * @see wp_get_translation_updates() * * @return array */ protected function get_translation_updates() { $available = $this->get_installed_languages(); $func = function () use ( $available ) { return $available; }; switch ( $this->obj_type ) { case 'plugins': add_filter( 'plugins_update_check_locales', $func ); wp_clean_plugins_cache(); // Check for Plugin translation updates. wp_update_plugins(); remove_filter( 'plugins_update_check_locales', $func ); $transient = 'update_plugins'; break; case 'themes': add_filter( 'themes_update_check_locales', $func ); wp_clean_themes_cache(); // Check for Theme translation updates. wp_update_themes(); remove_filter( 'themes_update_check_locales', $func ); $transient = 'update_themes'; break; default: delete_site_transient( 'update_core' ); // Check for Core translation updates. wp_version_check(); $transient = 'update_core'; break; } $updates = array(); $transient = get_site_transient( $transient ); if ( empty( $transient->translations ) ) { return $updates; } foreach ( $transient->translations as $translation ) { $updates[] = (object) $translation; } return $updates; } /** * Download a language pack. * * @see wp_download_language_pack() * * @param string $download Language code to download. * @param string $slug Plugin or theme slug. Not used for core. * @return string|\WP_Error Returns the language code if successfully downloaded, or a WP_Error object on failure. */ protected function download_language_pack( $download, $slug = null ) { $translations = $this->get_all_languages( $slug ); $translation_to_load = null; foreach ( $translations as $translation ) { if ( $translation['language'] === $download ) { $translation_to_load = $translation; break; } } if ( ! $translation_to_load ) { return new \WP_Error( 'not_found', $slug ? "Language '{$download}' for '{$slug}' not available." : "Language '{$download}' not available." ); } $translation = (object) $translation; $translation->type = rtrim( $this->obj_type, 's' ); // Make sure caching in LanguagePackUpgrader works. if ( ! isset( $translation->slug ) ) { $translation->slug = $slug; } $upgrader = 'WP_CLI\\LanguagePackUpgrader'; $result = Utils\get_upgrader( $upgrader )->upgrade( $translation, array( 'clear_update_cache' => false ) ); if ( is_wp_error( $result ) ) { return $result; } if ( ! $result ) { return new \WP_Error( 'not_installed', $slug ? "Could not install language '{$download}' for '{$slug}'." : "Could not install language '{$download}'." ); } return $translation->language; } /** * Return a list of installed languages. * * @param string $slug Optional. Plugin or theme slug. Defaults to 'default' for core. * * @return array */ protected function get_installed_languages( $slug = 'default' ) { $available = wp_get_installed_translations( $this->obj_type ); $available = ! empty( $available[ $slug ] ) ? array_keys( $available[ $slug ] ) : array(); $available[] = 'en_US'; return $available; } /** * Return a list of all languages. * * @param string $slug Optional. Plugin or theme slug. Not used for core. * * @return array */ protected function get_all_languages( $slug = null ) { require_once ABSPATH . '/wp-admin/includes/translation-install.php'; require ABSPATH . WPINC . '/version.php'; // Include an unmodified $wp_version $args = array( 'version' => $wp_version, ); if ( $slug ) { $args['slug'] = $slug; if ( 'plugins' === $this->obj_type ) { $plugins = get_plugins( '/' . $slug ); $plugin_data = array_shift( $plugins ); if ( isset( $plugin_data['Version'] ) ) { $args['version'] = $plugin_data['Version']; } } elseif ( 'themes' === $this->obj_type ) { $theme_data = wp_get_theme( $slug ); if ( isset( $theme_data['Version'] ) ) { $args['version'] = $theme_data['Version']; } } } $response = translations_api( $this->obj_type, $args ); if ( is_wp_error( $response ) ) { WP_CLI::error( $response ); } $translations = ! empty( $response['translations'] ) ? $response['translations'] : array(); $en_us = array( 'language' => 'en_US', 'english_name' => 'English (United States)', 'native_name' => 'English (United States)', 'updated' => '', ); $translations[] = $en_us; uasort( $translations, array( $this, 'sort_translations_callback' ) ); return $translations; } /** * Get Formatter object based on supplied parameters. * * @param array $assoc_args Parameters passed to command. Determines formatting. * @return Formatter */ protected function get_formatter( &$assoc_args ) { return new Formatter( $assoc_args, $this->obj_fields, $this->obj_type ); } } <?php class Site_Switch_Language_Command extends WP_CLI\CommandWithTranslation { protected $obj_type = 'core'; /** * Activates a given language. * * ## OPTIONS * * <language> * : Language code to activate. * * ## EXAMPLES * * $ wp site switch-language ja * Success: Language activated. * * @throws WP_CLI\ExitException */ public function __invoke( $args, $assoc_args ) { list( $language_code ) = $args; $available = $this->get_installed_languages(); if ( ! in_array( $language_code, $available, true ) ) { WP_CLI::error( 'Language not installed.' ); } if ( 'en_US' === $language_code ) { $language_code = ''; } if ( get_locale() === $language_code ) { WP_CLI::warning( "Language '{$language_code}' already active." ); return; } update_option( 'WPLANG', $language_code ); WP_CLI::success( 'Language activated.' ); } } <?php /** * Installs, activates, and manages core language packs. * * ## EXAMPLES * * # Install the Dutch core language pack. * $ wp language core install nl_NL * Downloading translation from https://downloads.wordpress.org/translation/core/6.4.3/nl_NL.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the translation... * Translation updated successfully. * Language 'nl_NL' installed. * Success: Installed 1 of 1 languages. * * # Activate the Dutch core language pack. * $ wp site switch-language nl_NL * Success: Language activated. * * # Uninstall the Dutch core language pack. * $ wp language core uninstall nl_NL * Success: Language uninstalled. * * # List installed core language packs. * $ wp language core list --status=installed * +----------+--------------+-------------+-----------+-----------+---------------------+ * | language | english_name | native_name | status | update | updated | * +----------+--------------+-------------+-----------+-----------+---------------------+ * | nl_NL | Dutch | Nederlands | installed | available | 2024-01-31 10:24:06 | * +----------+--------------+-------------+-----------+-----------+---------------------+ * * @package wp-cli */ class Core_Language_Command extends WP_CLI\CommandWithTranslation { protected $obj_type = 'core'; protected $obj_fields = array( 'language', 'english_name', 'native_name', 'status', 'update', 'updated', ); /** * Lists all available languages. * * ## OPTIONS * * [--field=<field>] * : Display the value of a single field * * [--<field>=<value>] * : Filter results by key=value pairs. * * [--fields=<fields>] * : Limit the output to specific fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each translation: * * * language * * english_name * * native_name * * status * * update * * updated * * ## EXAMPLES * * # List language,english_name,status fields of available languages. * $ wp language core list --fields=language,english_name,status * +----------------+-------------------------+-------------+ * | language | english_name | status | * +----------------+-------------------------+-------------+ * | ar | Arabic | uninstalled | * | ary | Moroccan Arabic | uninstalled | * | az | Azerbaijani | uninstalled | * * @subcommand list */ public function list_( $args, $assoc_args ) { $translations = $this->get_all_languages(); $available = $this->get_installed_languages(); $updates = $this->get_translation_updates(); $current_locale = get_locale(); $translations = array_map( function ( $translation ) use ( $available, $current_locale, $updates ) { $translation['status'] = 'uninstalled'; if ( in_array( $translation['language'], $available, true ) ) { $translation['status'] = 'installed'; } if ( $current_locale === $translation['language'] ) { $translation['status'] = 'active'; } $update = wp_list_filter( $updates, array( 'language' => $translation['language'] ) ); if ( $update ) { $translation['update'] = 'available'; } else { $translation['update'] = 'none'; } return $translation; }, $translations ); foreach ( $translations as $key => $translation ) { foreach ( array_keys( $translation ) as $field ) { if ( isset( $assoc_args[ $field ] ) && ! in_array( $translation[ $field ], array_map( 'trim', explode( ',', $assoc_args[ $field ] ) ), true ) ) { unset( $translations[ $key ] ); } } } $formatter = $this->get_formatter( $assoc_args ); $formatter->display_items( $translations ); } /** * Checks if a given language is installed. * * Returns exit code 0 when installed, 1 when uninstalled. * * ## OPTIONS * * <language> * : The language code to check. * * ## EXAMPLES * * # Check whether the German language is installed; exit status 0 if installed, otherwise 1. * $ wp language core is-installed de_DE * $ echo $? * 1 * * @subcommand is-installed */ public function is_installed( $args, $assoc_args = array() ) { list( $language_code ) = $args; $available = $this->get_installed_languages(); if ( in_array( $language_code, $available, true ) ) { \WP_CLI::halt( 0 ); } else { \WP_CLI::halt( 1 ); } } /** * Installs a given language. * * Downloads the language pack from WordPress.org. Find your language code at: https://translate.wordpress.org/ * * ## OPTIONS * * <language>... * : Language code to install. * * [--activate] * : If set, the language will be activated immediately after install. * * ## EXAMPLES * * # Install the Brazilian Portuguese language. * $ wp language core install pt_BR * Downloading translation from https://downloads.wordpress.org/translation/core/6.5/pt_BR.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the translation... * Translation updated successfully. * Language 'pt_BR' installed. * Success: Installed 1 of 1 languages. * * @subcommand install */ public function install( $args, $assoc_args ) { $language_codes = (array) $args; $count = count( $language_codes ); if ( $count > 1 && in_array( true, $assoc_args, true ) ) { WP_CLI::error( 'Only a single language can be active.' ); } $available = $this->get_installed_languages(); $successes = 0; $errors = 0; $skips = 0; foreach ( $language_codes as $language_code ) { if ( in_array( $language_code, $available, true ) ) { \WP_CLI::log( "Language '{$language_code}' already installed." ); ++$skips; } else { $response = $this->download_language_pack( $language_code ); if ( is_wp_error( $response ) ) { \WP_CLI::warning( $response ); \WP_CLI::log( "Language '{$language_code}' not installed." ); // Skip if translation is not yet available. if ( 'not_found' === $response->get_error_code() ) { ++$skips; } else { ++$errors; } } else { \WP_CLI::log( "Language '{$language_code}' installed." ); ++$successes; } } if ( WP_CLI\Utils\get_flag_value( $assoc_args, 'activate' ) ) { $this->activate_language( $language_code ); } } \WP_CLI\Utils\report_batch_operation_results( 'language', 'install', $count, $successes, $errors, $skips ); } /** * Uninstalls a given language. * * ## OPTIONS * * <language>... * : Language code to uninstall. * * ## EXAMPLES * * # Uninstall the Japanese core language pack. * $ wp language core uninstall ja * Success: Language uninstalled. * * @subcommand uninstall * @throws WP_CLI\ExitException */ public function uninstall( $args, $assoc_args ) { global $wp_filesystem; $dir = 'core' === $this->obj_type ? '' : "/$this->obj_type"; $files = scandir( WP_LANG_DIR . $dir ); if ( ! $files ) { WP_CLI::error( 'No files found in language directory.' ); } $language_codes = (array) $args; $available = $this->get_installed_languages(); $current_locale = get_locale(); foreach ( $language_codes as $language_code ) { if ( ! in_array( $language_code, $available, true ) ) { WP_CLI::error( 'Language not installed.' ); } if ( $language_code === $current_locale ) { WP_CLI::warning( "The '{$language_code}' language is active." ); exit; } $files_to_remove = array( "$language_code.po", "$language_code.mo", "$language_code.l10n.php", "admin-$language_code.po", "admin-$language_code.mo", "admin-$language_code.l10n.php", "admin-network-$language_code.po", "admin-network-$language_code.mo", "admin-network-$language_code.l10n.php", "continents-cities-$language_code.po", "continents-cities-$language_code.mo", "continents-cities-$language_code.l10n.php", ); // As of WP 4.0, no API for deleting a language pack WP_Filesystem(); $deleted = false; foreach ( $files as $file ) { if ( '.' === $file[0] || is_dir( $file ) ) { continue; } if ( ! in_array( $file, $files_to_remove, true ) && ! preg_match( "/$language_code-\w{32}\.json/", $file ) ) { continue; } /** @var WP_Filesystem_Base $wp_filesystem */ $deleted = $wp_filesystem->delete( WP_LANG_DIR . $dir . '/' . $file ); } if ( $deleted ) { WP_CLI::success( 'Language uninstalled.' ); } else { WP_CLI::error( "Couldn't uninstall language." ); } } } /** * Updates installed languages for core. * * ## OPTIONS * * [--dry-run] * : Preview which translations would be updated. * * ## EXAMPLES * * # Update installed core languages packs. * $ wp language core update * Updating 'Japanese' translation for WordPress 6.4.3... * Downloading translation from https://downloads.wordpress.org/translation/core/6.4.3/ja.zip... * Translation updated successfully. * Success: Updated 1/1 translation. * * @subcommand update */ public function update( $args, $assoc_args ) { // phpcs:ignore Generic.CodeAnalysis.UselessOverridingMethod.Found -- Overruling the documentation, so not useless ;-). parent::update( $args, $assoc_args ); } /** * Activates a given language. * * **Warning: `wp language core activate` is deprecated. Use `wp site switch-language` instead.** * * ## OPTIONS * * <language> * : Language code to activate. * * ## EXAMPLES * * # Activate the given language. * $ wp language core activate ja * Success: Language activated. * * @subcommand activate * @throws WP_CLI\ExitException */ public function activate( $args, $assoc_args ) { \WP_CLI::warning( 'This command is deprecated. use wp site switch-language instead' ); list( $language_code ) = $args; $this->activate_language( $language_code ); } private function activate_language( $language_code ) { $available = $this->get_installed_languages(); if ( ! in_array( $language_code, $available, true ) ) { WP_CLI::error( 'Language not installed.' ); } if ( 'en_US' === $language_code ) { $language_code = ''; } if ( get_locale() === $language_code ) { WP_CLI::warning( "Language '{$language_code}' already active." ); return; } update_option( 'WPLANG', $language_code ); WP_CLI::success( 'Language activated.' ); } } <?php use WP_CLI\Dispatcher\CommandNamespace; /** * Installs, activates, and manages language packs. * * ## EXAMPLES * * # Install the Dutch core language pack. * $ wp language core install nl_NL * Downloading translation from https://downloads.wordpress.org/translation/core/6.4.3/nl_NL.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the translation... * Translation updated successfully. * Language 'nl_NL' installed. * Success: Installed 1 of 1 languages. * * # Activate the Dutch core language pack. * $ wp site switch-language nl_NL * Success: Language activated. * * # Install the Dutch theme language pack for Twenty Ten. * $ wp language theme install twentyten nl_NL * Downloading translation from https://downloads.wordpress.org/translation/theme/twentyten/4.0/nl_NL.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the translation... * Translation updated successfully. * Language 'nl_NL' installed. * Success: Installed 1 of 1 languages. * * # Install the Dutch plugin language pack for Hello Dolly. * $ wp language plugin install hello-dolly nl_NL * Downloading translation from https://downloads.wordpress.org/translation/plugin/hello-dolly/1.7.2/nl_NL.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the translation... * Translation updated successfully. * Language 'nl_NL' installed. * Success: Installed 1 of 1 languages. * * @package wp-cli */ class Language_Namespace extends CommandNamespace { } <?php /** * Installs, activates, and manages plugin language packs. * * ## EXAMPLES * * # Install the Dutch plugin language pack for Hello Dolly. * $ wp language plugin install hello-dolly nl_NL * Downloading translation from https://downloads.wordpress.org/translation/plugin/hello-dolly/1.7.2/nl_NL.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the translation... * Translation updated successfully. * Language 'nl_NL' installed. * Success: Installed 1 of 1 languages. * * # Uninstall the Dutch plugin language pack for Hello Dolly. * $ wp language plugin uninstall hello-dolly nl_NL * Language 'nl_NL' for 'hello-dolly' uninstalled. * +-------------+--------+-------------+ * | name | locale | status | * +-------------+--------+-------------+ * | hello-dolly | nl_NL | uninstalled | * +-------------+--------+-------------+ * Success: Uninstalled 1 of 1 languages. * * # List installed plugin language packs for Hello Dolly. * $ wp language plugin list hello-dolly --status=installed * +-------------+----------+--------------+-------------+-----------+--------+---------------------+ * | plugin | language | english_name | native_name | status | update | updated | * +-------------+----------+--------------+-------------+-----------+--------+---------------------+ * | hello-dolly | nl_NL | Dutch | Nederlands | installed | none | 2023-11-13 12:34:15 | * +-------------+----------+--------------+-------------+-----------+--------+---------------------+ * * @package wp-cli */ class Plugin_Language_Command extends WP_CLI\CommandWithTranslation { protected $obj_type = 'plugins'; protected $obj_fields = array( 'plugin', 'language', 'english_name', 'native_name', 'status', 'update', 'updated', ); /** * Lists all available languages for one or more plugins. * * ## OPTIONS * * [<plugin>...] * : One or more plugins to list languages for. * * [--all] * : If set, available languages for all plugins will be listed. * * [--field=<field>] * : Display the value of a single field. * * [--<field>=<value>] * : Filter results by key=value pairs. * * [--fields=<fields>] * : Limit the output to specific fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each translation: * * * plugin * * language * * english_name * * native_name * * status * * update * * updated * * ## EXAMPLES * * # List available language packs for the plugin. * $ wp language plugin list hello-dolly --fields=language,english_name,status * +----------------+-------------------------+-------------+ * | language | english_name | status | * +----------------+-------------------------+-------------+ * | ar | Arabic | uninstalled | * | ary | Moroccan Arabic | uninstalled | * | az | Azerbaijani | uninstalled | * * @subcommand list */ public function list_( $args, $assoc_args ) { $all = \WP_CLI\Utils\get_flag_value( $assoc_args, 'all', false ); if ( ! $all && empty( $args ) ) { WP_CLI::error( 'Please specify one or more plugins, or use --all.' ); } if ( $all ) { $args = array_map( '\WP_CLI\Utils\get_plugin_name', array_keys( $this->get_all_plugins() ) ); if ( empty( $args ) ) { WP_CLI::success( 'No plugins installed.' ); return; } } $updates = $this->get_translation_updates(); $current_locale = get_locale(); $translations = array(); $plugins = new \WP_CLI\Fetchers\Plugin(); foreach ( $args as $plugin ) { if ( ! $plugins->get( $plugin ) ) { WP_CLI::warning( "Plugin '{$plugin}' not found." ); continue; } $installed_translations = $this->get_installed_languages( $plugin ); $available_translations = $this->get_all_languages( $plugin ); foreach ( $available_translations as $translation ) { $translation['plugin'] = $plugin; $translation['status'] = in_array( $translation['language'], $installed_translations, true ) ? 'installed' : 'uninstalled'; if ( $current_locale === $translation['language'] ) { $translation['status'] = 'active'; } $filter_args = array( 'language' => $translation['language'], 'type' => 'plugin', 'slug' => $plugin, ); $update = wp_list_filter( $updates, $filter_args ); $translation['update'] = $update ? 'available' : 'none'; // Support features like --status=active. foreach ( array_keys( $translation ) as $field ) { if ( isset( $assoc_args[ $field ] ) && ! in_array( $translation[ $field ], array_map( 'trim', explode( ',', $assoc_args[ $field ] ) ), true ) ) { continue 2; } } $translations[] = $translation; } } $formatter = $this->get_formatter( $assoc_args ); $formatter->display_items( $translations ); } /** * Checks if a given language is installed. * * Returns exit code 0 when installed, 1 when uninstalled. * * ## OPTIONS * * <plugin> * : Plugin to check for. * * <language>... * : The language code to check. * * ## EXAMPLES * * # Check whether the German language is installed for Akismet; exit status 0 if installed, otherwise 1. * $ wp language plugin is-installed akismet de_DE * $ echo $? * 1 * * @subcommand is-installed */ public function is_installed( $args, $assoc_args = array() ) { $plugin = array_shift( $args ); $language_codes = (array) $args; $available = $this->get_installed_languages( $plugin ); foreach ( $language_codes as $language_code ) { if ( ! in_array( $language_code, $available, true ) ) { \WP_CLI::halt( 1 ); } } \WP_CLI::halt( 0 ); } /** * Installs a given language for a plugin. * * Downloads the language pack from WordPress.org. * * ## OPTIONS * * [<plugin>] * : Plugin to install language for. * * [--all] * : If set, languages for all plugins will be installed. * * <language>... * : Language code to install. * * [--format=<format>] * : Render output in a particular format. Used when installing languages for all plugins. * --- * default: table * options: * - table * - csv * - json * - summary * --- * * ## EXAMPLES * * # Install the Japanese language for Akismet. * $ wp language plugin install akismet ja * Downloading translation from https://downloads.wordpress.org/translation/plugin/akismet/4.0.3/ja.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the translation... * Translation updated successfully. * Language 'ja' installed. * Success: Installed 1 of 1 languages. * * @subcommand install */ public function install( $args, $assoc_args ) { $all = \WP_CLI\Utils\get_flag_value( $assoc_args, 'all', false ); if ( ! $all && count( $args ) < 2 ) { \WP_CLI::error( 'Please specify a plugin, or use --all.' ); } if ( $all ) { $this->install_many( $args, $assoc_args ); } else { $this->install_one( $args, $assoc_args ); } } /** * Installs translations for a plugin. * * @param array $args Runtime arguments. * @param array $assoc_args Runtime arguments. */ private function install_one( $args, $assoc_args ) { $plugin = array_shift( $args ); $language_codes = (array) $args; $count = count( $language_codes ); $available = $this->get_installed_languages( $plugin ); $successes = 0; $errors = 0; $skips = 0; foreach ( $language_codes as $language_code ) { if ( in_array( $language_code, $available, true ) ) { \WP_CLI::log( "Language '{$language_code}' already installed." ); ++$skips; } else { $response = $this->download_language_pack( $language_code, $plugin ); if ( is_wp_error( $response ) ) { \WP_CLI::warning( $response ); \WP_CLI::log( "Language '{$language_code}' not installed." ); // Skip if translation is not yet available. if ( 'not_found' === $response->get_error_code() ) { ++$skips; } else { ++$errors; } } else { \WP_CLI::log( "Language '{$language_code}' installed." ); ++$successes; } } } \WP_CLI\Utils\report_batch_operation_results( 'language', 'install', $count, $successes, $errors, $skips ); } /** * Installs translations for all installed plugins. * * @param array $args Runtime arguments. * @param array $assoc_args Runtime arguments. */ private function install_many( $args, $assoc_args ) { $language_codes = (array) $args; $plugins = $this->get_all_plugins(); if ( empty( $assoc_args['format'] ) ) { $assoc_args['format'] = 'table'; } if ( in_array( $assoc_args['format'], array( 'json', 'csv' ), true ) ) { $logger = new \WP_CLI\Loggers\Quiet(); \WP_CLI::set_logger( $logger ); } if ( empty( $plugins ) ) { \WP_CLI::success( 'No plugins installed.' ); return; } $count = count( $plugins ) * count( $language_codes ); $results = array(); $successes = 0; $errors = 0; $skips = 0; foreach ( $plugins as $plugin_path => $plugin_details ) { $plugin_name = \WP_CLI\Utils\get_plugin_name( $plugin_path ); $available = $this->get_installed_languages( $plugin_name ); foreach ( $language_codes as $language_code ) { $result = [ 'name' => $plugin_name, 'locale' => $language_code, ]; if ( in_array( $language_code, $available, true ) ) { \WP_CLI::log( "Language '{$language_code}' for '{$plugin_details['Name']}' already installed." ); $result['status'] = 'already installed'; ++$skips; } else { $response = $this->download_language_pack( $language_code, $plugin_name ); if ( is_wp_error( $response ) ) { \WP_CLI::warning( $response ); \WP_CLI::log( "Language '{$language_code}' for '{$plugin_details['Name']}' not installed." ); if ( 'not_found' === $response->get_error_code() ) { $result['status'] = 'not available'; ++$skips; } else { $result['status'] = 'not installed'; ++$errors; } } else { \WP_CLI::log( "Language '{$language_code}' for '{$plugin_details['Name']}' installed." ); $result['status'] = 'installed'; ++$successes; } } $results[] = (object) $result; } } if ( 'summary' !== $assoc_args['format'] ) { \WP_CLI\Utils\format_items( $assoc_args['format'], $results, array( 'name', 'locale', 'status' ) ); } \WP_CLI\Utils\report_batch_operation_results( 'language', 'install', $count, $successes, $errors, $skips ); } /** * Uninstalls a given language for a plugin. * * ## OPTIONS * * [<plugin>] * : Plugin to uninstall language for. * * [--all] * : If set, languages for all plugins will be uninstalled. * * <language>... * : Language code to uninstall. * * [--format=<format>] * : Render output in a particular format. Used when installing languages for all plugins. * --- * default: table * options: * - table * - csv * - json * - summary * --- * * ## EXAMPLES * * # Uninstall the Japanese plugin language pack for Hello Dolly. * $ wp language plugin uninstall hello-dolly ja * Language 'ja' for 'hello-dolly' uninstalled. * +-------------+--------+-------------+ * | name | locale | status | * +-------------+--------+-------------+ * | hello-dolly | ja | uninstalled | * +-------------+--------+-------------+ * Success: Uninstalled 1 of 1 languages. * * @subcommand uninstall */ public function uninstall( $args, $assoc_args ) { /** @var WP_Filesystem_Base $wp_filesystem */ global $wp_filesystem; if ( empty( $assoc_args['format'] ) ) { $assoc_args['format'] = 'table'; } if ( in_array( $assoc_args['format'], array( 'json', 'csv' ), true ) ) { $logger = new \WP_CLI\Loggers\Quiet(); \WP_CLI::set_logger( $logger ); } $all = \WP_CLI\Utils\get_flag_value( $assoc_args, 'all', false ); if ( ! $all && count( $args ) < 2 ) { \WP_CLI::error( 'Please specify one or more plugins, or use --all.' ); } if ( $all ) { $plugins = array_map( '\WP_CLI\Utils\get_plugin_name', array_keys( $this->get_all_plugins() ) ); if ( empty( $plugins ) ) { WP_CLI::success( 'No plugins installed.' ); return; } } else { $plugins = array( array_shift( $args ) ); } $language_codes = (array) $args; $current_locale = get_locale(); $dir = WP_LANG_DIR . "/$this->obj_type"; $files = scandir( $dir ); if ( ! $files ) { \WP_CLI::error( 'No files found in language directory.' ); } // As of WP 4.0, no API for deleting a language pack WP_Filesystem(); $count = count( $plugins ) * count( $language_codes ); $results = array(); $successes = 0; $errors = 0; $skips = 0; foreach ( $plugins as $plugin ) { $available = $this->get_installed_languages( $plugin ); foreach ( $language_codes as $language_code ) { $result = [ 'name' => $plugin, 'locale' => $language_code, 'status' => 'not available', ]; if ( ! in_array( $language_code, $available, true ) ) { $result['status'] = 'not installed'; \WP_CLI::warning( "Language '{$language_code}' not installed." ); if ( $all ) { ++$skips; } else { ++$errors; } $results[] = (object) $result; continue; } if ( $language_code === $current_locale ) { \WP_CLI::warning( "The '{$language_code}' language is active." ); exit; } $files_to_remove = array( "$plugin-$language_code.po", "$plugin-$language_code.mo", "$plugin-$language_code.l10n.php", ); $count_files_to_remove = 0; $count_files_removed = 0; $had_one_file = false; foreach ( $files as $file ) { if ( '.' === $file[0] || is_dir( $file ) ) { continue; } if ( ! in_array( $file, $files_to_remove, true ) && ! preg_match( "/$plugin-$language_code-\w{32}\.json/", $file ) ) { continue; } $had_one_file = true; ++$count_files_to_remove; if ( $wp_filesystem->delete( $dir . '/' . $file ) ) { ++$count_files_removed; } else { \WP_CLI::error( "Couldn't uninstall language: $language_code from plugin $plugin." ); } } if ( $count_files_to_remove === $count_files_removed ) { $result['status'] = 'uninstalled'; ++$successes; \WP_CLI::log( "Language '{$language_code}' for '{$plugin}' uninstalled." ); } elseif ( $count_files_removed ) { \WP_CLI::log( "Language '{$language_code}' for '{$plugin}' partially uninstalled." ); $result['status'] = 'partial uninstall'; ++$errors; } elseif ( $had_one_file ) { /* $count_files_removed == 0 */ \WP_CLI::log( "Couldn't uninstall language '{$language_code}' from plugin {$plugin}." ); $result['status'] = 'failed to uninstall'; ++$errors; } else { \WP_CLI::log( "Language '{$language_code}' for '{$plugin}' already uninstalled." ); $result['status'] = 'already uninstalled'; ++$skips; } $results[] = (object) $result; } } if ( 'summary' !== $assoc_args['format'] ) { \WP_CLI\Utils\format_items( $assoc_args['format'], $results, array( 'name', 'locale', 'status' ) ); } \WP_CLI\Utils\report_batch_operation_results( 'language', 'uninstall', $count, $successes, $errors, $skips ); } /** * Updates installed languages for one or more plugins. * * ## OPTIONS * * [<plugin>...] * : One or more plugins to update languages for. * * [--all] * : If set, languages for all plugins will be updated. * * [--dry-run] * : Preview which translations would be updated. * * ## EXAMPLES * * # Update all installed language packs for all plugins. * $ wp language plugin update --all * Updating 'Japanese' translation for Akismet 3.1.11... * Downloading translation from https://downloads.wordpress.org/translation/plugin/akismet/3.1.11/ja.zip... * Translation updated successfully. * Success: Updated 1/1 translation. * * @subcommand update */ public function update( $args, $assoc_args ) { $all = \WP_CLI\Utils\get_flag_value( $assoc_args, 'all', false ); if ( ! $all && empty( $args ) ) { WP_CLI::error( 'Please specify one or more plugins, or use --all.' ); } if ( $all ) { $args = array_map( '\WP_CLI\Utils\get_plugin_name', array_keys( $this->get_all_plugins() ) ); if ( empty( $args ) ) { WP_CLI::success( 'No plugins installed.' ); return; } } parent::update( $args, $assoc_args ); } /** * Gets all available plugins. * * Uses the same filter core uses in plugins.php to determine which plugins * should be available to manage through the WP_Plugins_List_Table class. * * @return array */ private function get_all_plugins() { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Using WP native hook. return apply_filters( 'all_plugins', get_plugins() ); } } <?php namespace WP_CLI\I18n; use Exception; use Gettext\Extractors\PhpCode; use Gettext\Translations; use WP_CLI; final class PhpCodeExtractor extends PhpCode { use IterableCodeExtractor; public static $options = [ 'extractComments' => [ 'translators', 'Translators' ], 'constants' => [], 'functions' => [ '__' => 'text_domain', 'esc_attr__' => 'text_domain', 'esc_html__' => 'text_domain', 'esc_xml__' => 'text_domain', '_e' => 'text_domain', 'esc_attr_e' => 'text_domain', 'esc_html_e' => 'text_domain', 'esc_xml_e' => 'text_domain', '_x' => 'text_context_domain', '_ex' => 'text_context_domain', 'esc_attr_x' => 'text_context_domain', 'esc_html_x' => 'text_context_domain', 'esc_xml_x' => 'text_context_domain', '_n' => 'single_plural_number_domain', '_nx' => 'single_plural_number_context_domain', '_n_noop' => 'single_plural_domain', '_nx_noop' => 'single_plural_context_domain', // Compat. '_' => 'gettext', // Same as 'text_domain'. // Deprecated. '_c' => 'text_domain', '_nc' => 'single_plural_number_domain', '__ngettext' => 'single_plural_number_domain', '__ngettext_noop' => 'single_plural_domain', ], ]; protected static $functionsScannerClass = 'WP_CLI\I18n\PhpFunctionsScanner'; /** * {@inheritdoc} */ public static function fromString( $text, Translations $translations, array $options = [] ) { WP_CLI::debug( "Parsing file {$options['file']}", 'make-pot' ); try { self::fromStringMultiple( $text, [ $translations ], $options ); } catch ( Exception $exception ) { WP_CLI::debug( sprintf( 'Could not parse file %1$s: %2$s', $options['file'], $exception->getMessage() ), 'make-pot' ); } } } <?php namespace WP_CLI\I18n; use Gettext\Translation; use Gettext\Translations; use RecursiveCallbackFilterIterator; use RecursiveDirectoryIterator; use RecursiveIteratorIterator; use SplFileInfo; use WP_CLI; use WP_CLI\Utils; trait IterableCodeExtractor { protected static $dir = ''; /** * Extract the translations from a file. * * @param array|string $file_or_files A path of a file or files * @param Translations $translations The translations instance to append the new translations. * @param array $options { * Optional. An array of options passed down to static::fromString() * * @type bool $wpExtractTemplates Extract 'Template Name' headers in theme files. Default 'false'. * @type bool $wpExtractPatterns Extract 'Title' and 'Description' headers in pattern files. Default 'false'. * @type array $restrictFileNames Skip all files which are not included in this array. * @type array $restrictDirectories Skip all directories which are not included in this array. * } * @return null */ public static function fromFile( $file_or_files, Translations $translations, array $options = [] ) { foreach ( static::getFiles( $file_or_files ) as $file ) { if ( ! empty( $options['restrictFileNames'] ) ) { $basename = Utils\basename( $file ); if ( ! in_array( $basename, $options['restrictFileNames'], true ) ) { continue; } } $relative_file_path = ltrim( str_replace( static::$dir, '', Utils\normalize_path( $file ) ), '/' ); // Make sure a relative file path is added as a comment. $options['file'] = $relative_file_path; if ( ! empty( $options['restrictDirectories'] ) ) { $top_level_dirname = explode( '/', $relative_file_path )[0]; if ( ! in_array( $top_level_dirname, $options['restrictDirectories'], true ) ) { continue; } } $text = file_get_contents( $file ); if ( ! $text ) { WP_CLI::debug( sprintf( 'Could not load file %1s', $file ), 'make-pot' ); continue; } if ( ! empty( $options['wpExtractTemplates'] ) ) { $headers = FileDataExtractor::get_file_data_from_string( $text, [ 'Template Name' => 'Template Name' ] ); if ( ! empty( $headers['Template Name'] ) ) { $translation = new Translation( '', $headers['Template Name'] ); $translation->addExtractedComment( 'Template Name of the theme' ); $translations[] = $translation; } } // Patterns are only supported when in a top-level patterns/ folder. if ( ! empty( $options['wpExtractPatterns'] ) && 0 === strpos( $options['file'], 'patterns/' ) ) { $headers = FileDataExtractor::get_file_data_from_string( $text, [ 'Title' => 'Title', 'Description' => 'Description', ] ); if ( ! empty( $headers['Title'] ) ) { $translation = new Translation( 'Pattern title', $headers['Title'] ); $translation->addReference( $options['file'] ); $translations[] = $translation; } if ( ! empty( $headers['Description'] ) ) { $translation = new Translation( 'Pattern description', $headers['Description'] ); $translation->addReference( $options['file'] ); $translations[] = $translation; } } static::fromString( $text, $translations, $options ); } } /** * Extract the translations from a file. * * @param string $dir Root path to start the recursive traversal in. * @param Translations $translations The translations instance to append the new translations. * @param array $options { * Optional. An array of options passed down to static::fromString() * * @type bool $wpExtractTemplates Extract 'Template Name' headers in theme files. Default 'false'. * @type array $exclude A list of path to exclude. Default []. * @type array $extensions A list of extensions to process. Default []. * } * @return void */ public static function fromDirectory( $dir, Translations $translations, array $options = [] ) { $dir = Utils\normalize_path( $dir ); static::$dir = $dir; $include = isset( $options['include'] ) ? $options['include'] : []; $exclude = isset( $options['exclude'] ) ? $options['exclude'] : []; $files = static::getFilesFromDirectory( $dir, $include, $exclude, $options['extensions'] ); if ( ! empty( $files ) ) { static::fromFile( $files, $translations, $options ); } static::$dir = ''; } /** * Determines whether a file is valid based on given matchers. * * @param SplFileInfo $file File or directory. * @param array $matchers List of files and directories to match. * @return int How strongly the file is matched. */ protected static function calculateMatchScore( SplFileInfo $file, array $matchers = [] ) { if ( empty( $matchers ) ) { return 0; } if ( in_array( $file->getBasename(), $matchers, true ) ) { return 10; } // Check for more complex paths, e.g. /some/sub/folder. $root_relative_path = str_replace( static::$dir, '', $file->getPathname() ); foreach ( $matchers as $path_or_file ) { $pattern = preg_quote( str_replace( '*', '__wildcard__', $path_or_file ), '#' ); $pattern = '(^|/)' . str_replace( '__wildcard__', '(.+)', $pattern ); // Base score is the amount of nested directories, discounting wildcards. $base_score = count( array_filter( explode( '/', $path_or_file ), static function ( $component ) { return '*' !== $component; } ) ); if ( 0 === $base_score ) { // If the matcher is simply * it gets a score above the implicit score but below 1. $base_score = 0.2; } // If the matcher contains no wildcards and matches the end of the path. if ( false === strpos( $path_or_file, '*' ) && preg_match( '#' . $pattern . '$#', $root_relative_path ) ) { return $base_score * 10; } // If the matcher matches the end of the path or a full directory contained. if ( preg_match( '#' . $pattern . '(/|$)#', $root_relative_path ) ) { return $base_score; } } return 0; } /** * Determines whether or not a directory has children that may be matched. * * @param SplFileInfo $dir Directory. * @param array $matchers List of files and directories to match. * @return bool Whether or not there are any matchers for children of this directory. */ protected static function containsMatchingChildren( SplFileInfo $dir, array $matchers = [] ) { if ( empty( $matchers ) ) { return false; } /** @var string $root_relative_path */ $root_relative_path = str_replace( static::$dir, '', $dir->getPathname() ); $root_relative_path = static::trim_leading_slash( $root_relative_path ); foreach ( $matchers as $path_or_file ) { // If the matcher contains no wildcards and the path matches the start of the matcher. if ( '' !== $root_relative_path && false === strpos( $path_or_file, '*' ) && 0 === strpos( $path_or_file . '/', $root_relative_path ) ) { return true; } $base = current( explode( '*', $path_or_file ) ); // If start of the path matches the start of the matcher until the first wildcard. // Or the start of the matcher until the first wildcard matches the start of the path. if ( ( '' !== $root_relative_path && 0 === strpos( $base, $root_relative_path ) ) || ( '' !== $base && 0 === strpos( $root_relative_path, $base ) ) ) { return true; } } return false; } /** * Recursively gets all PHP files within a directory. * * @param string $dir A path of a directory. * @param array $includes List of files and directories to include. * @param array $excludes List of files and directories to skip. * @param array $extensions List of filename extensions to process. * * @return array File list. */ public static function getFilesFromDirectory( $dir, array $includes = [], array $excludes = [], $extensions = [] ) { $filtered_files = []; $files = new RecursiveIteratorIterator( new RecursiveCallbackFilterIterator( new RecursiveDirectoryIterator( $dir, RecursiveDirectoryIterator::SKIP_DOTS | RecursiveDirectoryIterator::UNIX_PATHS | RecursiveDirectoryIterator::FOLLOW_SYMLINKS ), static function ( $file, $key, $iterator ) use ( $includes, $excludes, $extensions ) { /** @var RecursiveCallbackFilterIterator $iterator */ /** @var SplFileInfo $file */ // Normalize include and exclude paths. $includes = array_map( self::class . '::trim_leading_slash', $includes ); $excludes = array_map( self::class . '::trim_leading_slash', $excludes ); // If no $includes is passed everything gets the weakest possible matching score. $inclusion_score = empty( $includes ) ? 0.1 : static::calculateMatchScore( $file, $includes ); $exclusion_score = static::calculateMatchScore( $file, $excludes ); // Always include directories that aren't excluded. if ( 0 === $exclusion_score && $iterator->hasChildren() ) { return true; } if ( ( 0 === $inclusion_score || $exclusion_score > $inclusion_score ) && $iterator->hasChildren() ) { // Always include directories that may have matching children even if they are excluded. return static::containsMatchingChildren( $file, $includes ); } // Include directories that are excluded but include score is higher. if ( $exclusion_score > 0 && $inclusion_score >= $exclusion_score && $iterator->hasChildren() ) { return true; } if ( ! $file->isFile() || ! static::file_has_file_extension( $file, $extensions ) ) { return false; } return $inclusion_score > $exclusion_score; } ), RecursiveIteratorIterator::CHILD_FIRST ); foreach ( $files as $file ) { /** @var SplFileInfo $file */ if ( ! $file->isFile() || ! static::file_has_file_extension( $file, $extensions ) ) { continue; } $filtered_files[] = Utils\normalize_path( $file->getPathname() ); } sort( $filtered_files, SORT_NATURAL | SORT_FLAG_CASE ); return $filtered_files; } /** * Determines whether the file extension of a file matches any of the given file extensions. * The end/last part of a multi file extension must also match (`js` of `min.js`). * * @param SplFileInfo $file File or directory. * @param array $extensions List of file extensions to match. * @return bool Whether the file has a file extension that matches any of the ones in the list. */ protected static function file_has_file_extension( $file, $extensions ) { return in_array( $file->getExtension(), $extensions, true ) || in_array( static::file_get_extension_multi( $file ), $extensions, true ); } /** * Gets the single- (e.g. `php`) or multi-file extension (e.g. `blade.php`) of a file. * * @param SplFileInfo $file File or directory. * @return string The single- or multi-file extension of the file. */ protected static function file_get_extension_multi( $file ) { $file_extension_separator = '.'; $filename = $file->getFilename(); $parts = explode( $file_extension_separator, $filename, 2 ); if ( count( $parts ) <= 1 ) { // if ever something goes wrong, fall back to SPL return $file->getExtension(); } return $parts[1]; } /** * Trim leading slash from a path. * * @param string $path Path to trim. * @return string Trimmed path. */ protected static function trim_leading_slash( $path ) { return ltrim( $path, '/' ); } } <?php namespace WP_CLI\I18n; use Gettext\Utils\PhpFunctionsScanner as GettextPhpFunctionsScanner; class PhpFunctionsScanner extends GettextPhpFunctionsScanner { /** * {@inheritdoc} */ public function saveGettextFunctions( $translations, array $options ) { // Ignore multiple translations for now. // @todo Add proper support for multiple translations. if ( is_array( $translations ) ) { $translations = $translations[0]; } $functions = $options['functions']; $file = $options['file']; $add_reference = ! empty( $options['addReferences'] ); foreach ( $this->getFunctions( $options['constants'] ) as $function ) { list( $name, $line, $args ) = $function; if ( ! isset( $functions[ $name ] ) ) { continue; } $original = null; $domain = null; $context = null; $plural = null; switch ( $functions[ $name ] ) { case 'text_domain': case 'gettext': list( $original, $domain ) = array_pad( $args, 2, null ); break; case 'text_context_domain': list( $original, $context, $domain ) = array_pad( $args, 3, null ); break; case 'single_plural_number_domain': list( $original, $plural, $number, $domain ) = array_pad( $args, 4, null ); break; case 'single_plural_number_context_domain': list( $original, $plural, $number, $context, $domain ) = array_pad( $args, 5, null ); break; case 'single_plural_domain': list( $original, $plural, $domain ) = array_pad( $args, 3, null ); break; case 'single_plural_context_domain': list( $original, $plural, $context, $domain ) = array_pad( $args, 4, null ); break; default: // Should never happen. \WP_CLI::error( sprintf( "Internal error: unknown function map '%s' for '%s'.", $functions[ $name ], $name ) ); } if ( '' === (string) $original ) { continue; } if ( $domain !== $translations->getDomain() && null !== $translations->getDomain() ) { continue; } $translation = $translations->insert( $context, $original, $plural ); if ( $add_reference ) { $translation = $translation->addReference( $file, $line ); } if ( 1 === preg_match( MakePotCommand::SPRINTF_PLACEHOLDER_REGEX, $original ) || 1 === preg_match( MakePotCommand::UNORDERED_SPRINTF_PLACEHOLDER_REGEX, $original ) ) { $translation->addFlag( 'php-format' ); } if ( isset( $function[3] ) ) { foreach ( $function[3] as $extracted_comment ) { $translation = $translation->addExtractedComment( $extracted_comment ); } } } } } <?php namespace WP_CLI\I18n; use Gettext\Extractors\Po; use Gettext\Merge; use Gettext\Translation; use Gettext\Translations; use Gettext\Utils\ParsedComment; use WP_CLI; use WP_CLI_Command; use WP_CLI\Utils; use DirectoryIterator; use IteratorIterator; class MakePotCommand extends WP_CLI_Command { /** * @var string */ protected $source; /** * @var string */ protected $destination; /** * @var array */ protected $merge = []; /** * @var Translations[] */ protected $exceptions = []; /** * @var bool */ protected $subtract_and_merge; /** * @var array */ protected $include = []; /** * @var array */ protected $exclude = [ 'node_modules', '.*', 'vendor', 'Gruntfile.js', 'webpack.config.js', '*.min.js', 'test', 'tests' ]; /** * @var string */ protected $slug; /** * @var array */ protected $main_file_data = []; /** * @var string */ protected $main_file_path; /** * @var bool */ protected $skip_js = false; /** * @var bool */ protected $skip_php = false; /** * @var bool */ protected $skip_blade = false; /** * @var bool */ protected $skip_block_json = false; /** * @var bool */ protected $skip_theme_json = false; /** * @var bool */ protected $skip_audit = false; /** * @var bool */ protected $location = true; /** * @var array */ protected $headers = []; /** * @var string */ protected $domain; /** * @var string */ protected $package_name; /** * @var string */ protected $file_comment; /** * @var string */ protected $project_type = 'generic'; /** * These Regexes copied from http://php.net/manual/en/function.sprintf.php#93552 * and adjusted for better precision and updated specs. */ const SPRINTF_PLACEHOLDER_REGEX = '/(?: (?<!%) # Don\'t match a literal % (%%). ( % # Start of placeholder. (?:[0-9]+\$)? # Optional ordering of the placeholders. [+-]? # Optional sign specifier. (?: (?:0|\'.)? # Optional padding specifier - excluding the space. -? # Optional alignment specifier. [0-9]* # Optional width specifier. (?:\.(?:[ 0]|\'.)?[0-9]+)? # Optional precision specifier with optional padding character. | # Only recognize the space as padding in combination with a width specifier. (?:[ ])? # Optional space padding specifier. -? # Optional alignment specifier. [0-9]+ # Width specifier. (?:\.(?:[ 0]|\'.)?[0-9]+)? # Optional precision specifier with optional padding character. ) [bcdeEfFgGosuxX] # Type specifier. ) )/x'; /** * "Unordered" means there's no position specifier: '%s', not '%2$s'. */ const UNORDERED_SPRINTF_PLACEHOLDER_REGEX = '/(?: (?<!%) # Don\'t match a literal % (%%). % # Start of placeholder. [+-]? # Optional sign specifier. (?: (?:0|\'.)? # Optional padding specifier - excluding the space. -? # Optional alignment specifier. [0-9]* # Optional width specifier. (?:\.(?:[ 0]|\'.)?[0-9]+)? # Optional precision specifier with optional padding character. | # Only recognize the space as padding in combination with a width specifier. (?:[ ])? # Optional space padding specifier. -? # Optional alignment specifier. [0-9]+ # Width specifier. (?:\.(?:[ 0]|\'.)?[0-9]+)? # Optional precision specifier with optional padding character. ) [bcdeEfFgGosuxX] # Type specifier. )/x'; /** * Create a POT file for a WordPress project. * * Scans PHP, Blade-PHP and JavaScript files for translatable strings, as well as theme stylesheets and plugin files * if the source directory is detected as either a plugin or theme. * * ## OPTIONS * * <source> * : Directory to scan for string extraction. * * [<destination>] * : Name of the resulting POT file. * * [--slug=<slug>] * : Plugin or theme slug. Defaults to the source directory's basename. * * [--domain=<domain>] * : Text domain to look for in the source code, unless the `--ignore-domain` option is used. * By default, the "Text Domain" header of the plugin or theme is used. * If none is provided, it falls back to the project slug. * * [--ignore-domain] * : Ignore the text domain completely and extract strings with any text domain. * * [--merge[=<paths>]] * : Comma-separated list of POT files whose contents should be merged with the extracted strings. * If left empty, defaults to the destination POT file. POT file headers will be ignored. * * [--subtract=<paths>] * : Comma-separated list of POT files whose contents should act as some sort of denylist for string extraction. * Any string which is found on that denylist will not be extracted. * This can be useful when you want to create multiple POT files from the same source directory with slightly * different content and no duplicate strings between them. * * [--subtract-and-merge] * : Whether source code references and comments from the generated POT file should be instead added to the POT file * used for subtraction. Warning: this modifies the files passed to `--subtract`! * * [--include=<paths>] * : Comma-separated list of files and paths that should be used for string extraction. * If provided, only these files and folders will be taken into account for string extraction. * For example, `--include="src,my-file.php` will ignore anything besides `my-file.php` and files in the `src` * directory. Simple glob patterns can be used, i.e. `--include=foo-*.php` includes any PHP file with the `foo-` * prefix. Leading and trailing slashes are ignored, i.e. `/my/directory/` is the same as `my/directory`. * * [--exclude=<paths>] * : Comma-separated list of files and paths that should be skipped for string extraction. * For example, `--exclude=.github,myfile.php` would ignore any strings found within `myfile.php` or the `.github` * folder. Simple glob patterns can be used, i.e. `--exclude=foo-*.php` excludes any PHP file with the `foo-` * prefix. Leading and trailing slashes are ignored, i.e. `/my/directory/` is the same as `my/directory`. The * following files and folders are always excluded: node_modules, .git, .svn, .CVS, .hg, vendor, *.min.js. * * [--headers=<headers>] * : Array in JSON format of custom headers which will be added to the POT file. Defaults to empty array. * * [--location] * : Whether to write `#: filename:line` lines. * Defaults to true, use `--no-location` to skip the removal. * Note that disabling this option makes it harder for technically skilled translators to understand each messageâ€™s context. * * [--skip-js] * : Skips JavaScript string extraction. Useful when this is done in another build step, e.g. through Babel. * * [--skip-php] * : Skips PHP string extraction. * * [--skip-blade] * : Skips Blade-PHP string extraction. * * [--skip-block-json] * : Skips string extraction from block.json files. * * [--skip-theme-json] * : Skips string extraction from theme.json files. * * [--skip-audit] * : Skips string audit where it tries to find possible mistakes in translatable strings. Useful when running in an * automated environment. * * [--file-comment=<file-comment>] * : String that should be added as a comment to the top of the resulting POT file. * By default, a copyright comment is added for WordPress plugins and themes in the following manner: * * ``` * Copyright (C) 2018 Example Plugin Author * This file is distributed under the same license as the Example Plugin package. * ``` * * If a plugin or theme specifies a license in their main plugin file or stylesheet, the comment looks like * this: * * ``` * Copyright (C) 2018 Example Plugin Author * This file is distributed under the GPLv2. * ``` * * [--package-name=<name>] * : Name to use for package name in the resulting POT file's `Project-Id-Version` header. * Overrides plugin or theme name, if applicable. * * ## EXAMPLES * * # Create a POT file for the WordPress plugin/theme in the current directory. * $ wp i18n make-pot . languages/my-plugin.pot * * # Create a POT file for the continents and cities list in WordPress core. * $ wp i18n make-pot . continents-and-cities.pot --include="wp-admin/includes/continents-cities.php" --ignore-domain * * # Create a POT file for the WordPress theme in the current directory with custom headers. * $ wp i18n make-pot . languages/my-theme.pot --headers='{"Report-Msgid-Bugs-To":"https://github.com/theme-author/my-theme/","POT-Creation-Date":""}' * * @when before_wp_load * * @throws WP_CLI\ExitException */ public function __invoke( $args, $assoc_args ) { $this->handle_arguments( $args, $assoc_args ); $translations = $this->extract_strings(); if ( ! $translations ) { WP_CLI::warning( 'No strings found' ); } $translations_count = count( $translations ); if ( 1 === $translations_count ) { WP_CLI::debug( sprintf( 'Extracted %d string', $translations_count ), 'make-pot' ); } else { WP_CLI::debug( sprintf( 'Extracted %d strings', $translations_count ), 'make-pot' ); } if ( ! PotGenerator::toFile( $translations, $this->destination ) ) { WP_CLI::error( 'Could not generate a POT file.' ); } WP_CLI::success( 'POT file successfully generated.' ); } /** * Process arguments from command-line in a reusable way. * * @throws WP_CLI\ExitException * * @param array $args Command arguments. * @param array $assoc_args Associative arguments. */ public function handle_arguments( $args, $assoc_args ) { $array_arguments = array( 'headers' ); $assoc_args = Utils\parse_shell_arrays( $assoc_args, $array_arguments ); $this->source = realpath( $args[0] ); $this->slug = Utils\get_flag_value( $assoc_args, 'slug', Utils\basename( $this->source ) ); $this->skip_js = Utils\get_flag_value( $assoc_args, 'skip-js', $this->skip_js ); $this->skip_php = Utils\get_flag_value( $assoc_args, 'skip-php', $this->skip_php ); $this->skip_blade = Utils\get_flag_value( $assoc_args, 'skip-blade', $this->skip_blade ); $this->skip_block_json = Utils\get_flag_value( $assoc_args, 'skip-block-json', $this->skip_block_json ); $this->skip_theme_json = Utils\get_flag_value( $assoc_args, 'skip-theme-json', $this->skip_theme_json ); $this->skip_audit = Utils\get_flag_value( $assoc_args, 'skip-audit', $this->skip_audit ); $this->headers = Utils\get_flag_value( $assoc_args, 'headers', $this->headers ); $this->file_comment = Utils\get_flag_value( $assoc_args, 'file-comment' ); $this->package_name = Utils\get_flag_value( $assoc_args, 'package-name' ); $this->location = Utils\get_flag_value( $assoc_args, 'location', true ); $ignore_domain = Utils\get_flag_value( $assoc_args, 'ignore-domain', false ); if ( ! $this->source || ! is_dir( $this->source ) ) { WP_CLI::error( 'Not a valid source directory.' ); } $this->main_file_data = $this->get_main_file_data(); if ( $ignore_domain ) { WP_CLI::debug( 'Extracting all strings regardless of text domain', 'make-pot' ); } if ( ! $ignore_domain ) { $this->domain = $this->slug; if ( ! empty( $this->main_file_data['Text Domain'] ) ) { $this->domain = $this->main_file_data['Text Domain']; } $this->domain = Utils\get_flag_value( $assoc_args, 'domain', $this->domain ); WP_CLI::debug( sprintf( 'Extracting all strings with text domain "%s"', $this->domain ), 'make-pot' ); } // Determine destination. $this->destination = "{$this->source}/{$this->slug}.pot"; if ( ! empty( $this->main_file_data['Domain Path'] ) ) { // Domain Path inside source folder. $this->destination = sprintf( '%s/%s/%s.pot', $this->source, $this->unslashit( $this->main_file_data['Domain Path'] ), $this->slug ); } if ( isset( $args[1] ) ) { $this->destination = $args[1]; } WP_CLI::debug( sprintf( 'Destination: %s', $this->destination ), 'make-pot' ); if ( ! is_dir( dirname( $this->destination ) ) && ! mkdir( dirname( $this->destination ), 0777, true ) ) { WP_CLI::error( 'Could not create destination directory.' ); } if ( isset( $assoc_args['merge'] ) ) { if ( true === $assoc_args['merge'] ) { $this->merge = [ $this->destination ]; } elseif ( ! empty( $assoc_args['merge'] ) ) { $this->merge = explode( ',', $assoc_args['merge'] ); } $this->merge = array_filter( $this->merge, function ( $file ) { if ( ! file_exists( $file ) ) { WP_CLI::warning( sprintf( 'Invalid file provided to --merge: %s', $file ) ); return false; } return true; } ); if ( ! empty( $this->merge ) ) { WP_CLI::debug( sprintf( 'Merging with existing POT %s: %s', WP_CLI\Utils\pluralize( 'file', count( $this->merge ) ), implode( ',', $this->merge ) ), 'make-pot' ); } } if ( isset( $assoc_args['subtract'] ) ) { $this->subtract_and_merge = Utils\get_flag_value( $assoc_args, 'subtract-and-merge', false ); $files = explode( ',', $assoc_args['subtract'] ); foreach ( $files as $file ) { if ( ! file_exists( $file ) ) { WP_CLI::warning( sprintf( 'Invalid file provided to --subtract: %s', $file ) ); continue; } WP_CLI::debug( sprintf( 'Ignoring any string already existing in: %s', $file ), 'make-pot' ); $this->exceptions[ $file ] = new Translations(); Po::fromFile( $file, $this->exceptions[ $file ] ); } } if ( isset( $assoc_args['include'] ) ) { $this->include = array_filter( explode( ',', $assoc_args['include'] ) ); $this->include = array_map( [ $this, 'unslashit' ], $this->include ); $this->include = array_unique( $this->include ); WP_CLI::debug( sprintf( 'Only including the following files: %s', implode( ',', $this->include ) ), 'make-pot' ); } if ( isset( $assoc_args['exclude'] ) ) { $this->exclude = array_filter( array_merge( $this->exclude, explode( ',', $assoc_args['exclude'] ) ) ); $this->exclude = array_map( [ $this, 'unslashit' ], $this->exclude ); $this->exclude = array_unique( $this->exclude ); } WP_CLI::debug( sprintf( 'Excluding the following files: %s', implode( ',', $this->exclude ) ), 'make-pot' ); } /** * Removes leading and trailing slashes of a string. * * @param string $text What to add and remove slashes from. * @return string String without leading and trailing slashes. */ protected function unslashit( $text ) { return ltrim( rtrim( trim( $text ), '/\\' ), '/\\' ); } /** * Retrieves the main file data of the plugin or theme. * * @return array */ protected function get_main_file_data() { $files = new IteratorIterator( new DirectoryIterator( $this->source ) ); /** @var DirectoryIterator $file */ foreach ( $files as $file ) { // wp-content/themes/my-theme/style.css if ( $file->isFile() && 'style' === $file->getBasename( '.css' ) && $file->isReadable() ) { $theme_data = FileDataExtractor::get_file_data( $file->getRealPath(), array_combine( $this->get_file_headers( 'theme' ), $this->get_file_headers( 'theme' ) ) ); // Stop when it contains a valid Theme Name header. if ( ! empty( $theme_data['Theme Name'] ) ) { WP_CLI::log( 'Theme stylesheet detected.' ); WP_CLI::debug( sprintf( 'Theme stylesheet: %s', $file->getRealPath() ), 'make-pot' ); $this->project_type = 'theme'; $this->main_file_path = $file->getRealPath(); return $theme_data; } } // wp-content/themes/my-themes/theme-a/style.css if ( $file->isDir() && ! $file->isDot() && is_readable( $file->getRealPath() . '/style.css' ) ) { $theme_data = FileDataExtractor::get_file_data( $file->getRealPath() . '/style.css', array_combine( $this->get_file_headers( 'theme' ), $this->get_file_headers( 'theme' ) ) ); // Stop when it contains a valid Theme Name header. if ( ! empty( $theme_data['Theme Name'] ) ) { WP_CLI::log( 'Theme stylesheet detected.' ); WP_CLI::debug( sprintf( 'Theme stylesheet: %s', $file->getRealPath() . '/style.css' ), 'make-pot' ); $this->project_type = 'theme'; $this->main_file_path = $file->getRealPath(); return $theme_data; } } // wp-content/plugins/my-plugin/my-plugin.php if ( $file->isFile() && $file->isReadable() && 'php' === $file->getExtension() ) { $plugin_data = FileDataExtractor::get_file_data( $file->getRealPath(), array_combine( $this->get_file_headers( 'plugin' ), $this->get_file_headers( 'plugin' ) ) ); // Stop when we find a file with a valid Plugin Name header. if ( ! empty( $plugin_data['Plugin Name'] ) ) { WP_CLI::log( 'Plugin file detected.' ); WP_CLI::debug( sprintf( 'Plugin file: %s', $file->getRealPath() ), 'make-pot' ); $this->project_type = 'plugin'; $this->main_file_path = $file->getRealPath(); return $plugin_data; } } } WP_CLI::debug( 'No valid theme stylesheet or plugin file found, treating as a regular project.', 'make-pot' ); return []; } /** * Returns the file headers for themes and plugins. * * @param string $type Source type, either theme or plugin. * * @return array List of file headers. */ protected function get_file_headers( $type ) { switch ( $type ) { case 'plugin': return [ 'Plugin Name', 'Plugin URI', 'Description', 'Author', 'Author URI', 'Version', 'License', 'Domain Path', 'Text Domain', ]; case 'theme': return [ 'Theme Name', 'Theme URI', 'Description', 'Author', 'Author URI', 'Version', 'License', 'Domain Path', 'Text Domain', ]; default: return []; } } /** * Creates a POT file and stores it on disk. * * @throws WP_CLI\ExitException * * @return Translations A Translation set. */ protected function extract_strings() { $translations = new Translations(); // Add existing strings first but don't keep headers. if ( ! empty( $this->merge ) ) { $existing_translations = new Translations(); Po::fromFile( $this->merge, $existing_translations ); $translations->mergeWith( $existing_translations, Merge::ADD | Merge::REMOVE ); } PotGenerator::setCommentBeforeHeaders( $this->get_file_comment() ); $this->set_default_headers( $translations ); // POT files have no Language header. $translations->deleteHeader( Translations::HEADER_LANGUAGE ); // Only relevant for PO files, not POT files. $translations->setHeader( 'PO-Revision-Date', 'YEAR-MO-DA HO:MI+ZONE' ); if ( $this->domain ) { $translations->setDomain( $this->domain ); } unset( $this->main_file_data['Version'], $this->main_file_data['License'], $this->main_file_data['Domain Path'], $this->main_file_data['Text Domain'] ); $is_theme = isset( $this->main_file_data['Theme Name'] ); // Set entries from main file data. foreach ( $this->main_file_data as $header => $data ) { if ( empty( $data ) ) { continue; } $translation = new Translation( '', $data ); if ( $is_theme ) { $translation->addExtractedComment( sprintf( '%s of the theme', $header ) ); } else { $translation->addExtractedComment( sprintf( '%s of the plugin', $header ) ); } if ( $this->main_file_path && $this->location ) { $translation->addReference( ltrim( str_replace( Utils\normalize_path( "$this->source/" ), '', Utils\normalize_path( $this->main_file_path ) ), '/' ) ); } $translations[] = $translation; } try { if ( ! $this->skip_php ) { $options = [ // Extract 'Template Name' headers in theme files. 'wpExtractTemplates' => $is_theme, // Extract 'Title' and 'Description' headers from pattern files. 'wpExtractPatterns' => $is_theme, 'include' => $this->include, 'exclude' => $this->exclude, 'extensions' => [ 'php' ], 'addReferences' => $this->location, ]; PhpCodeExtractor::fromDirectory( $this->source, $translations, $options ); } if ( ! $this->skip_blade ) { $options = [ 'include' => $this->include, 'exclude' => $this->exclude, 'extensions' => [ 'blade.php' ], 'addReferences' => $this->location, ]; BladeCodeExtractor::fromDirectory( $this->source, $translations, $options ); } if ( ! $this->skip_js ) { JsCodeExtractor::fromDirectory( $this->source, $translations, [ 'include' => $this->include, 'exclude' => $this->exclude, 'extensions' => [ 'js', 'jsx' ], 'addReferences' => $this->location, ] ); MapCodeExtractor::fromDirectory( $this->source, $translations, [ 'include' => $this->include, 'exclude' => $this->exclude, 'extensions' => [ 'map' ], 'addReferences' => $this->location, ] ); } if ( ! $this->skip_block_json ) { BlockExtractor::fromDirectory( $this->source, $translations, [ 'schema' => JsonSchemaExtractor::BLOCK_JSON_SOURCE, 'schemaFallback' => JsonSchemaExtractor::BLOCK_JSON_FALLBACK, // Only look for block.json files in any folder, nothing else. 'restrictFileNames' => [ 'block.json' ], 'include' => $this->include, 'exclude' => $this->exclude, 'extensions' => [ 'json' ], 'addReferences' => $this->location, ] ); } if ( ! $this->skip_theme_json ) { JsonSchemaExtractor::fromDirectory( $this->source, $translations, [ // Only look for theme.json files in any folder, nothing else. 'restrictFileNames' => [ 'theme.json' ], 'schema' => JsonSchemaExtractor::THEME_JSON_SOURCE, 'schemaFallback' => JsonSchemaExtractor::THEME_JSON_FALLBACK, 'include' => $this->include, 'exclude' => $this->exclude, 'extensions' => [ 'json' ], 'addReferences' => $this->location, ] ); // Themes can have style variations in the top-level "styles" folder. // They're like theme.json but can have any name. if ( $is_theme ) { JsonSchemaExtractor::fromDirectory( $this->source, $translations, [ 'restrictDirectories' => [ 'styles' ], 'schema' => JsonSchemaExtractor::THEME_JSON_SOURCE, 'schemaFallback' => JsonSchemaExtractor::THEME_JSON_FALLBACK, 'include' => $this->include, 'exclude' => $this->exclude, 'extensions' => [ 'json' ], 'addReferences' => $this->location, ] ); } } } catch ( \Exception $e ) { WP_CLI::error( $e->getMessage() ); } foreach ( $this->exceptions as $file => $exception_translations ) { /** @var Translation $exception_translation */ foreach ( $exception_translations as $exception_translation ) { if ( ! $translations->find( $exception_translation ) ) { continue; } if ( $this->subtract_and_merge ) { $translation = $translations[ $exception_translation->getId() ]; $exception_translation->mergeWith( $translation ); } unset( $translations[ $exception_translation->getId() ] ); } if ( $this->subtract_and_merge ) { PotGenerator::toFile( $exception_translations, $file ); } } if ( ! $this->skip_audit ) { $this->audit_strings( $translations ); } return $translations; } /** * Audits strings. * * Goes through all extracted strings to find possible mistakes. * * @param Translations $translations Translations object. */ protected function audit_strings( $translations ) { foreach ( $translations as $translation ) { /** @var Translation $translation */ $references = $translation->getReferences(); // File headers don't have any file references. $location = $translation->hasReferences() ? '(' . implode( ':', $references[0] ) . ')' : ''; // Check 1: Flag strings with placeholders that should have translator comments. if ( ! $translation->hasExtractedComments() && preg_match( self::SPRINTF_PLACEHOLDER_REGEX, $translation->getOriginal(), $placeholders ) >= 1 ) { $message = sprintf( 'The string "%1$s" contains placeholders but has no "translators:" comment to clarify their meaning. %2$s', $translation->getOriginal(), $location ); WP_CLI::warning( $message ); } // Check 2: Flag strings with different translator comments. if ( $translation->hasExtractedComments() ) { $comments = $translation->getExtractedComments(); // Remove plugin header information from comments. $comments = array_filter( $comments, function ( $comment ) { /** @var ParsedComment|string $comment */ /** @var string $file_header */ foreach ( $this->get_file_headers( $this->project_type ) as $file_header ) { if ( 0 === strpos( ( $comment instanceof ParsedComment ? $comment->getComment() : $comment ), $file_header ) ) { return null; } } return $comment; } ); $unique_comments = array(); // Remove duplicate comments. $comments = array_filter( $comments, function ( $comment ) use ( &$unique_comments ) { /** @var ParsedComment|string $comment */ if ( in_array( ( $comment instanceof ParsedComment ? $comment->getComment() : $comment ), $unique_comments, true ) ) { return null; } $unique_comments[] = ( $comment instanceof ParsedComment ? $comment->getComment() : $comment ); return $comment; } ); $comments_count = count( $comments ); if ( $comments_count > 1 ) { $message = sprintf( "The string \"%1\$s\" has %2\$d different translator comments. %3\$s\n%4\$s", $translation->getOriginal(), $comments_count, $location, implode( "\n", $unique_comments ) ); WP_CLI::warning( $message ); } } $non_placeholder_content = trim( preg_replace( '`^([\'"])(.*)\1$`Ds', '$2', $translation->getOriginal() ) ); $non_placeholder_content = preg_replace( self::SPRINTF_PLACEHOLDER_REGEX, '', $non_placeholder_content ); // Check 3: Flag empty strings without any translatable content. if ( '' === $non_placeholder_content ) { $message = sprintf( 'Found string without translatable content. %s', $location ); WP_CLI::warning( $message ); } // Check 4: Flag strings with multiple unordered placeholders (%s %s %s vs. %1$s %2$s %3$s). $unordered_matches_count = preg_match_all( self::UNORDERED_SPRINTF_PLACEHOLDER_REGEX, $translation->getOriginal(), $unordered_matches ); $unordered_matches = $unordered_matches[0]; if ( $unordered_matches_count >= 2 ) { $message = sprintf( 'Multiple placeholders should be ordered. %s', $location ); WP_CLI::warning( $message ); } if ( $translation->hasPlural() ) { preg_match_all( self::SPRINTF_PLACEHOLDER_REGEX, $translation->getOriginal(), $single_placeholders ); $single_placeholders = $single_placeholders[0]; preg_match_all( self::SPRINTF_PLACEHOLDER_REGEX, $translation->getPlural(), $plural_placeholders ); $plural_placeholders = $plural_placeholders[0]; // see https://developer.wordpress.org/plugins/internationalization/how-to-internationalize-your-plugin/#plurals if ( count( $single_placeholders ) < count( $plural_placeholders ) ) { // Check 5: Flag things like _n( 'One comment', '%s Comments' ) $message = sprintf( 'Missing singular placeholder, needed for some languages. See https://developer.wordpress.org/plugins/internationalization/how-to-internationalize-your-plugin/#plurals %s', $location ); WP_CLI::warning( $message ); } else { // Reordering is fine, but mismatched placeholders is probably wrong. sort( $single_placeholders ); sort( $plural_placeholders ); // Check 6: Flag things like _n( '%s Comment (%d)', '%s Comments (%s)' ) if ( $single_placeholders !== $plural_placeholders ) { $message = sprintf( 'Mismatched placeholders for singular and plural string. %s', $location ); WP_CLI::warning( $message ); } } } } } /** * Returns the copyright comment for the given package. * * @return string File comment. */ protected function get_file_comment() { if ( '' === $this->file_comment ) { return ''; } if ( isset( $this->file_comment ) ) { return implode( "\n", explode( '\n', $this->file_comment ) ); } if ( isset( $this->main_file_data['Theme Name'] ) ) { if ( ! empty( $this->main_file_data['License'] ) ) { return sprintf( "Copyright (C) %1\$s %2\$s\nThis file is distributed under the %3\$s.", date( 'Y' ), // phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date $this->main_file_data['Author'], $this->main_file_data['License'] ); } return sprintf( "Copyright (C) %1\$s %2\$s\nThis file is distributed under the same license as the %3\$s theme.", date( 'Y' ), // phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date $this->main_file_data['Author'], $this->main_file_data['Theme Name'] ); } if ( isset( $this->main_file_data['Plugin Name'] ) ) { if ( ! empty( $this->main_file_data['License'] ) ) { return sprintf( "Copyright (C) %1\$s %2\$s\nThis file is distributed under the %3\$s.", date( 'Y' ), // phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date $this->main_file_data['Author'], $this->main_file_data['License'] ); } return sprintf( "Copyright (C) %1\$s %2\$s\nThis file is distributed under the same license as the %3\$s plugin.", date( 'Y' ), // phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date $this->main_file_data['Author'], $this->main_file_data['Plugin Name'] ); } return ''; } /** * Sets default POT file headers for the project. * * @param Translations $translations Translations object. */ protected function set_default_headers( $translations ) { $name = null; $version = $this->get_wp_version(); $bugs_address = null; if ( ! $version && isset( $this->main_file_data['Version'] ) ) { $version = $this->main_file_data['Version']; } if ( isset( $this->main_file_data['Theme Name'] ) ) { $name = $this->main_file_data['Theme Name']; $bugs_address = sprintf( 'https://wordpress.org/support/theme/%s', $this->slug ); } elseif ( isset( $this->main_file_data['Plugin Name'] ) ) { $name = $this->main_file_data['Plugin Name']; $bugs_address = sprintf( 'https://wordpress.org/support/plugin/%s', $this->slug ); } if ( null !== $this->package_name ) { $name = $this->package_name; } if ( null !== $name ) { $translations->setHeader( 'Project-Id-Version', $name . ( $version ? ' ' . $version : '' ) ); } if ( null !== $bugs_address ) { $translations->setHeader( 'Report-Msgid-Bugs-To', $bugs_address ); } $translations->setHeader( 'Last-Translator', 'FULL NAME <EMAIL@ADDRESS>' ); $translations->setHeader( 'Language-Team', 'LANGUAGE <LL@li.org>' ); $translations->setHeader( 'X-Generator', 'WP-CLI ' . WP_CLI_VERSION ); foreach ( $this->headers as $key => $value ) { $translations->setHeader( $key, $value ); } } /** * Extracts the WordPress version number from wp-includes/version.php. * * @return string|false Version number on success, false otherwise. */ protected function get_wp_version() { $version_php = $this->source . '/wp-includes/version.php'; if ( ! file_exists( $version_php ) || ! is_readable( $version_php ) ) { return false; } return preg_match( '/\$wp_version\s*=\s*\'(.*?)\';/', file_get_contents( $version_php ), $matches ) ? $matches[1] : false; } } <?php namespace WP_CLI\I18n; use Gettext\Extractors\Po as PoExtractor; use Gettext\Generators\Po as PoGenerator; use Gettext\Translation; use Gettext\Translations; use WP_CLI; use WP_CLI_Command; use WP_CLI\Utils; use DirectoryIterator; use IteratorIterator; use SplFileInfo; class MakeJsonCommand extends WP_CLI_Command { /** * Options passed to json_encode(). * * @var int JSON options. */ protected $json_options = 0; /** * Extract JavaScript strings from PO files and add them to individual JSON files. * * For JavaScript internationalization purposes, WordPress requires translations to be split up into * one Jed-formatted JSON file per JavaScript source file. * * See https://make.wordpress.org/core/2018/11/09/new-javascript-i18n-support-in-wordpress/ to learn more * about WordPress JavaScript internationalization. * * ## OPTIONS * * <source> * : Path to an existing PO file or a directory containing multiple PO files. * * [<destination>] * : Path to the destination directory for the resulting JSON files. Defaults to the source directory. * * [--domain=<domain>] * : Text domain to use for the JSON file name. Overrides the default one extracted from the PO file. * * [--extensions=<extensions>] * : Additional custom JS extensions, comma separated list. By default searches for .min.js and .js extensions. * * [--purge] * : Whether to purge the strings that were extracted from the original source file. Defaults to true, use `--no-purge` to skip the removal. * * [--update-mo-files] * : Whether MO files should be updated as well after updating PO files. * Only has an effect when used in combination with `--purge`. * * [--pretty-print] * : Pretty-print resulting JSON files. * * [--use-map=<paths_or_maps>] * : Whether to use a mapping file for the strings, as a JSON value, array to specify multiple. * Each element can either be a string (file path) or object (map). * * ## EXAMPLES * * # Create JSON files for all PO files in the languages directory * $ wp i18n make-json languages * * # Create JSON files for my-plugin-de_DE.po and leave the PO file untouched. * $ wp i18n make-json my-plugin-de_DE.po /tmp --no-purge * * # Create JSON files with mapping * $ wp i18n make-json languages --use-map=build/map.json * * # Create JSON files with multiple mappings * $ wp i18n make-json languages '--use-map=["build/map.json","build/map2.json"]' * * # Create JSON files with object mapping * $ wp i18n make-json languages '--use-map={"source/index.js":"build/index.js"}' * * @when before_wp_load * * @throws WP_CLI\ExitException */ public function __invoke( $args, $assoc_args ) { $assoc_args = Utils\parse_shell_arrays( $assoc_args, array( 'use-map' ) ); $purge = Utils\get_flag_value( $assoc_args, 'purge', true ); $update_mo_files = Utils\get_flag_value( $assoc_args, 'update-mo-files', true ); $map_paths = Utils\get_flag_value( $assoc_args, 'use-map', false ); $domain = Utils\get_flag_value( $assoc_args, 'domain', '' ); $extensions = array_map( function ( $extension ) { return trim( $extension, ' .' ); }, explode( ',', Utils\get_flag_value( $assoc_args, 'extensions', '' ) ) ); if ( Utils\get_flag_value( $assoc_args, 'pretty-print', false ) ) { $this->json_options |= JSON_PRETTY_PRINT; } $source = realpath( $args[0] ); if ( ! $source || ( ! is_file( $source ) && ! is_dir( $source ) ) ) { WP_CLI::error( 'Source file or directory does not exist.' ); } $destination = is_file( $source ) ? dirname( $source ) : $source; if ( isset( $args[1] ) ) { $destination = $args[1]; } $map = $this->build_map( $map_paths ); if ( is_array( $map ) && empty( $map ) ) { WP_CLI::error( 'No valid keys found. No file was created.' ); } if ( ! is_dir( $destination ) && ! mkdir( $destination, 0777, true ) ) { WP_CLI::error( 'Could not create destination directory.' ); } $result_count = 0; if ( is_file( $source ) ) { $files = [ new SplFileInfo( $source ) ]; } else { $files = new IteratorIterator( new DirectoryIterator( $source ) ); } /** @var DirectoryIterator $file */ foreach ( $files as $file ) { if ( $file->isFile() && $file->isReadable() && 'po' === $file->getExtension() ) { $result = $this->make_json( $file->getRealPath(), $destination, $map, $domain, $extensions ); $result_count += count( $result ); if ( $purge ) { $removed = $this->remove_js_strings_from_po_file( $file->getRealPath() ); if ( ! $removed ) { WP_CLI::warning( sprintf( 'Could not update file %s', basename( $source ) ) ); continue; } if ( $update_mo_files ) { $file_basename = basename( $file->getFilename(), '.po' ); $destination_file = "{$destination}/{$file_basename}.mo"; $translations = Translations::fromPoFile( $file->getPathname() ); if ( ! $translations->toMoFile( $destination_file ) ) { WP_CLI::warning( "Could not create file {$destination_file}" ); } } } } } WP_CLI::success( sprintf( 'Created %d %s.', $result_count, Utils\pluralize( 'file', $result_count ) ) ); } /** * Collect maps from paths, normalize and merge * * @param string|array|bool $paths_or_maps argument. False to do nothing. * @return array|null Mapping array. Null if no maps specified. */ protected function build_map( $paths_or_maps ) { if ( false === $paths_or_maps ) { return null; } $map = []; // not an array: single value could also be object (associative array) if ( ! is_array( $paths_or_maps ) || empty( array_filter( array_keys( $paths_or_maps ), 'is_int' ) ) ) { $paths_or_maps = [ $paths_or_maps ]; } $paths = array_filter( $paths_or_maps, 'is_string' ); WP_CLI::debug( sprintf( 'Using %d map files: %s', count( $paths ), implode( ', ', $paths ) ), 'make-json' ); $maps = array_filter( $paths_or_maps, 'is_array' ); WP_CLI::debug( sprintf( 'Using %d inline map objects', count( $maps ) ), 'make-json' ); WP_CLI::debug( sprintf( 'Dropping %d invalid values from map argument', count( $paths_or_maps ) - count( $paths ) - count( $maps ) ), 'make-json' ); $to_transform = array_map( static function ( $value, $index ) { return [ $value, sprintf( 'inline object %d', $index ) ]; }, $maps, array_keys( $maps ) ); foreach ( $paths as $path ) { if ( ! file_exists( $path ) || is_dir( $path ) ) { WP_CLI::warning( sprintf( 'Map file %s does not exist', $path ) ); continue; } $json = json_decode( file_get_contents( $path ), true ); if ( ! is_array( $json ) ) { WP_CLI::warning( sprintf( 'Map file %s invalid', $path ) ); continue; } $to_transform[] = [ $json, $path ]; } foreach ( $to_transform as $transform ) { list( $json, $file ) = $transform; $key_num = count( $json ); // normalize contents to string[] $json = array_map( static function ( $value ) { if ( is_array( $value ) ) { $value = array_values( array_filter( $value, 'is_string' ) ); if ( ! empty( $value ) ) { return $value; } } if ( is_string( $value ) ) { return [ $value ]; } return null; }, $json ); WP_CLI::debug( sprintf( 'Dropped %d keys from %s', count( $json ) - $key_num, $file ), 'make-json' ); $map = array_merge_recursive( $map, $json ); } return $map; } /** * Splits a single PO file into multiple JSON files. * * @param string $source_file Path to the source file. * @param string $destination Path to the destination directory. * @param array|null $map Source to build file mapping. * @param string $domain Override text domain to use. * @param array $extensions Additional extensions. * @return array List of created JSON files. */ protected function make_json( $source_file, $destination, $map, $domain, $extensions ) { /** @var Translations[] $mapping */ $mapping = []; $translations = new Translations(); $result = []; $extensions = array_merge( [ 'js' ], $extensions ); PoExtractor::fromFile( $source_file, $translations ); $base_file_name = basename( $source_file, '.po' ); $domain = ( ! empty( $domain ) ) ? $domain : $translations->getDomain(); if ( $domain && 0 !== strpos( $base_file_name, $domain ) ) { $base_file_name = "{$domain}-{$base_file_name}"; } foreach ( $translations as $translation ) { /** @var Translation $translation */ // Find all unique sources this translation originates from. $sources = array_map( static function ( $reference ) use ( $extensions ) { $file = $reference[0]; $extension = pathinfo( $file, PATHINFO_EXTENSION ); return in_array( $extension, $extensions, true ) ? preg_replace( "/.min.{$extension}$/", ".{$extension}", $file ) : null; }, $this->reference_map( $translation->getReferences(), $map ) ); $sources = array_unique( array_filter( $sources ) ); foreach ( $sources as $source ) { if ( ! isset( $mapping[ $source ] ) ) { $mapping[ $source ] = new Translations(); // phpcs:ignore Squiz.PHP.CommentedOutCode.Found -- Provide code that is meant to be used once the bug is fixed. // See https://core.trac.wordpress.org/ticket/45441 // $mapping[ $source ]->setDomain( $translations->getDomain() ); $mapping[ $source ]->setHeader( 'Language', $translations->getLanguage() ); $mapping[ $source ]->setHeader( 'PO-Revision-Date', $translations->getHeader( 'PO-Revision-Date' ) ); $plural_forms = $translations->getPluralForms(); if ( $plural_forms ) { list( $count, $rule ) = $plural_forms; $mapping[ $source ]->setPluralForms( $count, $rule ); } } $mapping[ $source ][] = $translation; } } $result += $this->build_json_files( $mapping, $base_file_name, $destination ); return $result; } /** * Takes the references and applies map, if given * * @param array $references translation references * @param array|null $map file mapping * @return array mapped references */ protected function reference_map( $references, $map ) { if ( is_null( $map ) ) { return $references; } // translate using map $temp = array_map( static function ( $reference ) use ( &$map ) { $file = $reference[0]; if ( array_key_exists( $file, $map ) ) { return $map[ $file ]; } return null; }, $references ); // this is now an array of arrays of sources, translate to array of sources $references = []; foreach ( $temp as $sources ) { if ( is_null( $sources ) ) { continue; } array_push( $references, ...$sources ); } // and wrap to array return array_map( static function ( $value ) { return [ $value ]; }, $references ); } /** * Builds a mapping of JS file names to translation entries. * * Exports translations for each JS file to a separate translation file. * * @param array $mapping A mapping of files to translation entries. * @param string $base_file_name Base file name for JSON files. * @param string $destination Path to the destination directory. * * @return array List of created JSON files. */ protected function build_json_files( $mapping, $base_file_name, $destination ) { $result = []; foreach ( $mapping as $file => $translations ) { /** @var Translations $translations */ $hash = md5( $file ); $destination_file = "{$destination}/{$base_file_name}-{$hash}.json"; $success = JedGenerator::toFile( $translations, $destination_file, [ 'json' => $this->json_options, 'source' => $file, ] ); if ( ! $success ) { WP_CLI::warning( sprintf( 'Could not create file %s', basename( $destination_file, '.json' ) ) ); continue; } $result[] = $destination_file; } return $result; } /** * Removes strings from PO file that only occur in JavaScript file. * * @param string $source_file Path to the PO file. * @return bool True on success, false otherwise. */ protected function remove_js_strings_from_po_file( $source_file ) { /** @var Translations[] $mapping */ $translations = new Translations(); PoExtractor::fromFile( $source_file, $translations ); foreach ( $translations->getArrayCopy() as $translation ) { /** @var Translation $translation */ if ( ! $translation->hasReferences() ) { continue; } foreach ( $translation->getReferences() as $reference ) { $file = $reference[0]; if ( substr( $file, - 3 ) !== '.js' ) { continue 2; } } unset( $translations[ $translation->getId() ] ); } return PoGenerator::toFile( $translations, $source_file ); } } <?php namespace WP_CLI\I18n; use Gettext\Extractors\JsCode; use Gettext\Translations; use Peast\Syntax\Exception as PeastException; use WP_CLI; final class MapCodeExtractor extends JsCode { use IterableCodeExtractor; public static $options = [ 'extractComments' => [ 'translators', 'Translators' ], 'constants' => [], 'functions' => [ '__' => 'text_domain', '_x' => 'text_context_domain', '_n' => 'single_plural_number_domain', '_nx' => 'single_plural_number_context_domain', ], ]; /** * {@inheritdoc} */ public static function fromString( $text, Translations $translations, array $options = [] ) { if ( ! array_key_exists( 'file', $options ) || substr( $options['file'], -7 ) !== '.js.map' ) { return; } $options['file'] = substr( $options['file'], 0, -7 ) . '.js'; try { $options += self::$options; $map_object = json_decode( $text ); if ( ! isset( $map_object->sourcesContent ) || ! is_array( $map_object->sourcesContent ) ) { return; } $text = implode( "\n", $map_object->sourcesContent ); WP_CLI::debug( "Parsing file {$options['file']}", 'make-pot' ); $functions = new JsFunctionsScanner( $text ); $functions->enableCommentsExtraction( $options['extractComments'] ); $functions->saveGettextFunctions( $translations, $options ); } catch ( PeastException $e ) { WP_CLI::debug( sprintf( 'Could not parse file %1$s.map: %2$s (line %3$d, column %4$d in the concatenated sourcesContent)', $options['file'], $e->getMessage(), $e->getPosition()->getLine(), $e->getPosition()->getColumn() ), 'make-pot' ); } } } <?php namespace WP_CLI\I18n; use DirectoryIterator; use Gettext\Translations; use IteratorIterator; use SplFileInfo; use WP_CLI; use WP_CLI\Utils; use WP_CLI_Command; class MakePhpCommand extends WP_CLI_Command { /** * Create PHP files from PO files. * * ## OPTIONS * * <source> * : Path to an existing PO file or a directory containing multiple PO files. * * [<destination>] * : Path to the destination directory for the resulting PHP files. Defaults to the source directory. * * ## EXAMPLES * * # Create PHP files for all PO files in the current directory. * $ wp i18n make-php . * Success: Created 3 files. * * # Create a PHP file from a single PO file in a specific directory. * $ wp i18n make-php example-plugin-de_DE.po languages * Success: Created 1 file. * * @when before_wp_load * * @throws WP_CLI\ExitException */ public function __invoke( $args, $assoc_args ) { $source = realpath( $args[0] ); if ( ! $source || ( ! is_file( $source ) && ! is_dir( $source ) ) ) { WP_CLI::error( 'Source file or directory does not exist.' ); } $destination = is_file( $source ) ? dirname( $source ) : $source; if ( isset( $args[1] ) ) { $destination = $args[1]; } if ( ! is_dir( $destination ) && ! mkdir( $destination, 0777, true ) ) { WP_CLI::error( 'Could not create destination directory.' ); } if ( is_file( $source ) ) { $files = [ new SplFileInfo( $source ) ]; } else { $files = new IteratorIterator( new DirectoryIterator( $source ) ); } $result_count = 0; /** @var DirectoryIterator $file */ foreach ( $files as $file ) { if ( 'po' !== $file->getExtension() ) { continue; } if ( ! $file->isFile() || ! $file->isReadable() ) { WP_CLI::warning( sprintf( 'Could not read file %s', $file->getFilename() ) ); continue; } $file_basename = basename( $file->getFilename(), '.po' ); $destination_file = "{$destination}/{$file_basename}.l10n.php"; $translations = Translations::fromPoFile( $file->getPathname() ); if ( ! PhpArrayGenerator::toFile( $translations, $destination_file ) ) { WP_CLI::warning( sprintf( 'Could not create file %s', $destination_file ) ); continue; } ++$result_count; } WP_CLI::success( sprintf( 'Created %d %s.', $result_count, Utils\pluralize( 'file', $result_count ) ) ); } } <?php namespace WP_CLI\I18n; use Gettext\Translations; use WP_CLI; final class BlockExtractor extends JsonSchemaExtractor { /** * @inheritdoc */ public static function fromString( $text, Translations $translations, array $options = [] ) { $file = $options['file']; WP_CLI::debug( "Parsing file $file", 'make-pot' ); $json = json_decode( $text, true ); if ( null === $json ) { WP_CLI::debug( sprintf( 'Could not parse file %1$s: error code %2$s', $file, json_last_error() ), 'make-pot' ); return; } $domain = isset( $json['textdomain'] ) ? $json['textdomain'] : null; // Always allow missing domain or when --ignore-domain is used, but skip if domains don't match. if ( null !== $translations->getDomain() && null !== $domain && $domain !== $translations->getDomain() ) { return; } parent::fromString( $text, $translations, $options ); } } <?php namespace WP_CLI\I18n; use Exception; use Gettext\Translations; use WP_CLI; final class BladeCodeExtractor extends BladeGettextExtractor { use IterableCodeExtractor; public static $options = [ 'extractComments' => [ 'translators', 'Translators' ], 'constants' => [], 'functions' => [ '__' => 'text_domain', 'esc_attr__' => 'text_domain', 'esc_html__' => 'text_domain', 'esc_xml__' => 'text_domain', '_e' => 'text_domain', 'esc_attr_e' => 'text_domain', 'esc_html_e' => 'text_domain', 'esc_xml_e' => 'text_domain', '_x' => 'text_context_domain', '_ex' => 'text_context_domain', 'esc_attr_x' => 'text_context_domain', 'esc_html_x' => 'text_context_domain', 'esc_xml_x' => 'text_context_domain', '_n' => 'single_plural_number_domain', '_nx' => 'single_plural_number_context_domain', '_n_noop' => 'single_plural_domain', '_nx_noop' => 'single_plural_context_domain', // Compat. '_' => 'gettext', // Same as 'text_domain'. // Deprecated. '_c' => 'text_domain', '_nc' => 'single_plural_number_domain', '__ngettext' => 'single_plural_number_domain', '__ngettext_noop' => 'single_plural_domain', ], ]; protected static $functionsScannerClass = 'WP_CLI\I18n\PhpFunctionsScanner'; /** * {@inheritdoc} */ public static function fromString( $text, Translations $translations, array $options = [] ) { WP_CLI::debug( "Parsing file {$options['file']}", 'make-pot' ); try { self::fromStringMultiple( $text, [ $translations ], $options ); } catch ( Exception $exception ) { WP_CLI::debug( sprintf( 'Could not parse file %1$s: %2$s', $options['file'], $exception->getMessage() ), 'make-pot' ); } } } <?php namespace WP_CLI\I18n; use Gettext\Utils\JsFunctionsScanner as GettextJsFunctionsScanner; use Gettext\Utils\ParsedComment; use Peast\Peast; use Peast\Syntax\Node; use Peast\Traverser; final class JsFunctionsScanner extends GettextJsFunctionsScanner { /** * If not false, comments will be extracted. * * @var string|false|array */ private $extract_comments = false; /** * Holds a list of source code comments already added to a string. * * Prevents associating the same comment to multiple strings. * * @var Node\Comment[] $comments_cache */ private $comments_cache = []; /** * Enable extracting comments that start with a tag (if $tag is empty all the comments will be extracted). * * @param mixed $tag */ public function enableCommentsExtraction( $tag = '' ) { $this->extract_comments = $tag; } /** * Disable comments extraction. */ public function disableCommentsExtraction() { $this->extract_comments = false; } /** * {@inheritdoc} */ public function saveGettextFunctions( $translations, array $options ) { // Ignore multiple translations for now. // @todo Add proper support for multiple translations. if ( is_array( $translations ) ) { $translations = $translations[0]; } $peast_options = [ 'sourceType' => Peast::SOURCE_TYPE_MODULE, 'comments' => false !== $this->extract_comments, 'jsx' => true, ]; $ast = Peast::latest( $this->code, $peast_options )->parse(); $traverser = new Traverser(); $all_comments = []; /** * Traverse through JS code to find and extract gettext functions. * * Make sure translator comments in front of variable declarations * and inside nested call expressions are available when parsing the function call. */ $traverser->addFunction( function ( $node ) use ( &$translations, $options, &$all_comments ) { $functions = $options['functions']; $file = $options['file']; $add_reference = ! empty( $options['addReferences'] ); /** @var Node\Node $node */ foreach ( $node->getLeadingComments() as $comment ) { $all_comments[] = $comment; } /** @var Node\CallExpression $node */ if ( 'CallExpression' !== $node->getType() ) { return; } $callee = $this->resolveExpressionCallee( $node ); if ( ! $callee || ! isset( $functions[ $callee['name'] ] ) ) { return; } /** @var Node\CallExpression $node */ foreach ( $node->getArguments() as $argument ) { // Support nested function calls. $argument->setLeadingComments( $argument->getLeadingComments() + $node->getLeadingComments() ); } foreach ( $callee['comments'] as $comment ) { $all_comments[] = $comment; } $domain = null; $original = null; $context = null; $plural = null; $args = []; /** @var Node\Node $argument */ foreach ( $node->getArguments() as $argument ) { foreach ( $argument->getLeadingComments() as $comment ) { $all_comments[] = $comment; } if ( 'Identifier' === $argument->getType() || 'Expression' === substr( $argument->getType(), -strlen( 'Expression' ) ) ) { $args[] = ''; // The value doesn't matter as it's unused. continue; } if ( 'Literal' === $argument->getType() ) { /** @var Node\Literal $argument */ $args[] = $argument->getValue(); continue; } if ( 'TemplateLiteral' === $argument->getType() && 0 === count( $argument->getExpressions() ) ) { /** @var Node\TemplateLiteral $argument */ /** @var Node\TemplateElement[] $parts */ // Since there are no expressions within the TemplateLiteral, there is only one TemplateElement. $parts = $argument->getParts(); $args[] = $parts[0]->getValue(); continue; } // If we reach this, an unsupported argument type has been encountered. // Do not try to parse this function call at all. return; } switch ( $functions[ $callee['name'] ] ) { case 'text_domain': case 'gettext': list( $original, $domain ) = array_pad( $args, 2, null ); break; case 'text_context_domain': list( $original, $context, $domain ) = array_pad( $args, 3, null ); break; case 'single_plural_number_domain': list( $original, $plural, $number, $domain ) = array_pad( $args, 4, null ); break; case 'single_plural_number_context_domain': list( $original, $plural, $number, $context, $domain ) = array_pad( $args, 5, null ); break; } if ( '' === (string) $original ) { return; } if ( $domain !== $translations->getDomain() && null !== $translations->getDomain() ) { return; } if ( isset( $options['line'] ) ) { $line = $options['line']; } else { $line = $node->getLocation()->getStart()->getLine(); } $translation = $translations->insert( $context, $original, $plural ); if ( $add_reference ) { $translation->addReference( $file, $line ); } if ( 1 === preg_match( MakePotCommand::SPRINTF_PLACEHOLDER_REGEX, $original ) || 1 === preg_match( MakePotCommand::UNORDERED_SPRINTF_PLACEHOLDER_REGEX, $original ) ) { $translation->addFlag( 'js-format' ); } /** @var Node\Comment $comment */ foreach ( $all_comments as $comment ) { // Comments should be before the translation. if ( ! $this->commentPrecedesNode( $comment, $node ) ) { continue; } if ( in_array( $comment, $this->comments_cache, true ) ) { continue; } $parsed_comment = ParsedComment::create( $comment->getRawText(), $comment->getLocation()->getStart()->getLine() ); $prefixes = array_filter( (array) $this->extract_comments ); if ( $parsed_comment->checkPrefixes( $prefixes ) ) { $translation->addExtractedComment( $parsed_comment->getComment() ); $this->comments_cache[] = $comment; } } if ( isset( $parsed_comment ) ) { $all_comments = []; } } ); /** * Traverse through JS code contained within eval() to find and extract gettext functions. */ $scanner = $this; $traverser->addFunction( function ( $node ) use ( &$translations, $options, $scanner ) { /** @var Node\CallExpression $node */ if ( 'CallExpression' !== $node->getType() ) { return; } $callee = $this->resolveExpressionCallee( $node ); if ( ! $callee || 'eval' !== $callee['name'] ) { return; } $eval_contents = ''; /** @var Node\Node $argument */ foreach ( $node->getArguments() as $argument ) { if ( 'Literal' === $argument->getType() ) { /** @var Node\Literal $argument */ $eval_contents = $argument->getValue(); break; } } if ( ! $eval_contents ) { return; } // Override the line location to be that of the eval(). $options['line'] = $node->getLocation()->getStart()->getLine(); $class = get_class( $scanner ); $evals = new $class( $eval_contents ); $evals->enableCommentsExtraction( $options['extractComments'] ); $evals->saveGettextFunctions( $translations, $options ); } ); $traverser->traverse( $ast ); } /** * Resolve the callee of a call expression using known formats. * * @param Node\CallExpression $node The call expression whose callee to resolve. * * @return array|bool Array containing the name and comments of the identifier if resolved. False if not. */ private function resolveExpressionCallee( Node\CallExpression $node ) { $callee = $node->getCallee(); // If the callee is a simple identifier it can simply be returned. // For example: __( "translation" ). if ( 'Identifier' === $callee->getType() ) { return [ 'name' => $callee->getName(), 'comments' => $callee->getLeadingComments(), ]; } // If the callee is a member expression resolve it to the property. // For example: wp.i18n.__( "translation" ) or u.__( "translation" ). if ( 'MemberExpression' === $callee->getType() && 'Identifier' === $callee->getProperty()->getType() ) { // Make sure to unpack wp.i18n which is a nested MemberExpression. $comments = 'MemberExpression' === $callee->getObject()->getType() ? $callee->getObject()->getObject()->getLeadingComments() : $callee->getObject()->getLeadingComments(); return [ 'name' => $callee->getProperty()->getName(), 'comments' => $comments, ]; } // If the callee is a call expression as created by Webpack resolve it. // For example: Object(u.__)( "translation" ). if ( 'CallExpression' === $callee->getType() && 'Identifier' === $callee->getCallee()->getType() && 'Object' === $callee->getCallee()->getName() && [] !== $callee->getArguments() && 'MemberExpression' === $callee->getArguments()[0]->getType() ) { $property = $callee->getArguments()[0]->getProperty(); // Matches minified webpack statements: Object(u.__)( "translation" ). if ( 'Identifier' === $property->getType() ) { return [ 'name' => $property->getName(), 'comments' => $callee->getCallee()->getLeadingComments(), ]; } // Matches unminified webpack statements: // Object(_wordpress_i18n__WEBPACK_IMPORTED_MODULE_7__["__"])( "translation" ); if ( 'Literal' === $property->getType() ) { $name = $property->getValue(); // Matches mangled webpack statement: // Object(_wordpress_i18n__WEBPACK_IMPORTED_MODULE_7__[/* __ */ "a"])( "translation" ); $leading_property_comments = $property->getLeadingComments(); if ( count( $leading_property_comments ) === 1 && $leading_property_comments[0]->getKind() === 'multiline' ) { $name = trim( $leading_property_comments[0]->getText() ); } return [ 'name' => $name, 'comments' => $callee->getCallee()->getLeadingComments(), ]; } } // If the callee is an indirect function call as created by babel, resolve it. // For example: `(0, u.__)( "translation" )`. if ( 'ParenthesizedExpression' === $callee->getType() && 'SequenceExpression' === $callee->getExpression()->getType() && 2 === count( $callee->getExpression()->getExpressions() ) && 'Literal' === $callee->getExpression()->getExpressions()[0]->getType() && [] !== $node->getArguments() ) { // Matches any general indirect function call: `(0, __)( "translation" )`. if ( 'Identifier' === $callee->getExpression()->getExpressions()[1]->getType() ) { return [ 'name' => $callee->getExpression()->getExpressions()[1]->getName(), 'comments' => $callee->getLeadingComments(), ]; } // Matches indirect function calls used by babel for module imports: `(0, _i18n.__)( "translation" )`. if ( 'MemberExpression' === $callee->getExpression()->getExpressions()[1]->getType() ) { $property = $callee->getExpression()->getExpressions()[1]->getProperty(); if ( 'Identifier' === $property->getType() ) { return [ 'name' => $property->getName(), 'comments' => $callee->getLeadingComments(), ]; } } } // Unknown format. return false; } /** * Returns wether or not a comment precedes a node. * The comment must be before the node and on the same line or the one before. * * @param Node\Comment $comment The comment. * @param Node\Node $node The node. * * @return bool Whether or not the comment precedes the node. */ private function commentPrecedesNode( Node\Comment $comment, Node\Node $node ) { // Comments should be on the same or an earlier line than the translation. if ( $node->getLocation()->getStart()->getLine() - $comment->getLocation()->getEnd()->getLine() > 1 ) { return false; } // Comments on the same line should be before the translation. if ( $node->getLocation()->getStart()->getLine() === $comment->getLocation()->getEnd()->getLine() && $node->getLocation()->getStart()->getColumn() < $comment->getLocation()->getStart()->getColumn() ) { return false; } return true; } } <?php namespace WP_CLI\I18n; use Gettext\Generators\PhpArray; use Gettext\Translation; use Gettext\Translations; /** * PHP array file generator. * * Returns output in the form WordPress uses. */ class PhpArrayGenerator extends PhpArray { public static $options = [ 'includeHeaders' => false, ]; /** * {@inheritdoc} */ public static function toString( Translations $translations, array $options = [] ) { $array = static::generate( $translations, $options ); return '<?php' . PHP_EOL . 'return ' . static::var_export( $array ) . ';'; } /** * Generates an array with the translations. * * @param Translations $translations * @param array $options * * @return array */ public static function generate( Translations $translations, array $options = [] ) { $options += static::$options; return static::toArray( $translations, $options['includeHeaders'] ); } /** * Returns an array containing headers and translations. * * @param Translations $translations * @param bool $include_headers * @param bool $force_array Unused. * * @return array */ protected static function toArray( Translations $translations, $include_headers, $force_array = false ) { $messages = []; $result = [ 'domain' => $translations->getDomain(), 'plural-forms' => $translations->getHeader( 'Plural-Forms' ), ]; $language = $translations->getLanguage(); if ( null !== $language ) { $result['language'] = $language; } $headers_allowlist = [ 'POT-Creation-Date' => 'pot-creation-date', 'PO-Revision-Date' => 'po-revision-date', 'Project-Id-Version' => 'project-id-version', 'X-Generator' => 'x-generator', ]; foreach ( $translations->getHeaders() as $name => $value ) { if ( isset( $headers_allowlist[ $name ] ) ) { $result[ $headers_allowlist[ $name ] ] = $value; } } /** * @var Translation $translation */ foreach ( $translations as $translation ) { if ( $translation->isDisabled() || ! $translation->hasTranslation() ) { continue; } $context = $translation->getContext(); $original = $translation->getOriginal(); $key = $context ? $context . "\4" . $original : $original; if ( $translation->hasPluralTranslations() ) { $msg_translations = $translation->getPluralTranslations(); array_unshift( $msg_translations, $translation->getTranslation() ); $messages[ $key ] = implode( "\0", $msg_translations ); } else { $messages[ $key ] = $translation->getTranslation(); } } $result['messages'] = $messages; return $result; } /** * Determines if the given array is a list. * * An array is considered a list if its keys consist of consecutive numbers from 0 to count($array)-1. * * Polyfill for array_is_list() in PHP 8.1. * * @see https://github.com/symfony/polyfill-php81/tree/main * * @since 4.0.0 * * @codeCoverageIgnore * * @param array<mixed> $arr The array being evaluated. * @return bool True if array is a list, false otherwise. */ private static function array_is_list( array $arr ) { if ( function_exists( 'array_is_list' ) ) { // phpcs:ignore PHPCompatibility.FunctionUse.NewFunctions.array_is_listFound return array_is_list( $arr ); } if ( ( array() === $arr ) || ( array_values( $arr ) === $arr ) ) { return true; } $next_key = -1; foreach ( $arr as $k => $v ) { if ( ++$next_key !== $k ) { return false; } } return true; } /** * Outputs or returns a parsable string representation of a variable. * * Like {@see var_export()} but "minified", using short array syntax * and no newlines. * * @since 4.0.0 * * @param mixed $value The variable you want to export. * @return string The variable representation. */ private static function var_export( $value ) { if ( ! is_array( $value ) ) { return var_export( $value, true ); } $entries = array(); $is_list = self::array_is_list( $value ); foreach ( $value as $key => $val ) { $entries[] = $is_list ? self::var_export( $val ) : var_export( $key, true ) . '=>' . self::var_export( $val ); } return '[' . implode( ',', $entries ) . ']'; } } <?php namespace WP_CLI\I18n; use Gettext\Generators\Jed; use Gettext\Translation; use Gettext\Translations; /** * Jed file generator. * * Adds some more meta data to JED translation files than the default generator. */ class JedGenerator extends Jed { /** * {@parentDoc}. */ public static function toString( Translations $translations, array $options = [] ) { $options += static::$options; $domain = $translations->getDomain() ?: 'messages'; $messages = static::buildMessages( $translations ); $configuration = [ '' => [ 'domain' => $domain, 'lang' => $translations->getLanguage() ?: 'en', 'plural-forms' => $translations->getHeader( 'Plural-Forms' ) ?: 'nplurals=2; plural=(n != 1);', ], ]; $data = [ 'translation-revision-date' => $translations->getHeader( 'PO-Revision-Date' ), 'generator' => 'WP-CLI/' . WP_CLI_VERSION, 'source' => $options['source'], 'domain' => $domain, 'locale_data' => [ $domain => $configuration + $messages, ], ]; return json_encode( $data, $options['json'] ); } /** * Generates an array with all translations. * * @param Translations $translations * * @return array */ public static function buildMessages( Translations $translations ) { $plural_forms = $translations->getPluralForms(); $number_of_plurals = is_array( $plural_forms ) ? ( $plural_forms[0] - 1 ) : null; $messages = []; $context_glue = chr( 4 ); foreach ( $translations as $translation ) { /** @var Translation $translation */ if ( $translation->isDisabled() ) { continue; } $key = $translation->getOriginal(); if ( $translation->hasContext() ) { $key = $translation->getContext() . $context_glue . $key; } if ( $translation->hasPluralTranslations( true ) ) { $message = $translation->getPluralTranslations( $number_of_plurals ); array_unshift( $message, $translation->getTranslation() ); } else { $message = [ $translation->getTranslation() ]; } $messages[ $key ] = $message; } return $messages; } } <?php namespace WP_CLI\I18n; use Gettext\Extractors\Extractor; use Gettext\Translations; use WP_CLI; use WP_CLI\Utils; class JsonSchemaExtractor extends Extractor { use IterableCodeExtractor; /** * Source URL from which to download the latest theme-i18n.json file. * * @var string */ const THEME_JSON_SOURCE = 'https://develop.svn.wordpress.org/trunk/src/wp-includes/theme-i18n.json'; /** * Fallback theme-18n.json file path. * * @var string */ const THEME_JSON_FALLBACK = __DIR__ . '/../assets/theme-i18n.json'; /** * Source URL from which to download the latest block-i18n.json file. * * @var string */ const BLOCK_JSON_SOURCE = 'https://develop.svn.wordpress.org/trunk/src/wp-includes/block-i18n.json'; /** * Fallback block-18n.json file path. * * @var string */ const BLOCK_JSON_FALLBACK = __DIR__ . '/../assets/block-i18n.json'; /** * Static cache for the remote schema files. * * @var array<string, string> */ protected static $schema_cache = []; /** * Load the i18n from a remote URL or fall back to a local schema in case of an error. * @param string $schema i18n schema URL. * @param string $fallback Fallback i18n schema JSON file. * @return array|mixed */ protected static function load_schema( $schema, $fallback ) { if ( ! empty( self::$schema_cache[ $schema ] ) ) { return self::$schema_cache[ $schema ]; } $json = self::remote_get( $schema ); if ( empty( $json ) ) { WP_CLI::debug( 'Remote file could not be accessed, will use local file as fallback', 'make-pot' ); $json = file_get_contents( $fallback ); } $file_structure = json_decode( $json, false ); if ( JSON_ERROR_NONE !== json_last_error() ) { WP_CLI::debug( 'Error when decoding theme-i18n.json file', 'make-pot' ); return []; } if ( ! is_object( $file_structure ) ) { return []; } self::$schema_cache[ $schema ] = $file_structure; return $file_structure; } /** * @inheritdoc */ public static function fromString( $text, Translations $translations, array $options = [] ) { $file = $options['file']; WP_CLI::debug( "Parsing file {$file}", 'make-pot' ); $schema = self::load_schema( $options['schema'], $options['schemaFallback'] ); $json = json_decode( $text, true ); if ( null === $json ) { WP_CLI::debug( sprintf( 'Could not parse file %1$s: error code %2$s', $file, json_last_error() ), 'make-pot' ); return; } self::extract_strings_using_i18n_schema( $translations, $options['addReferences'] ? $file : null, $schema, $json ); } /** * Extract strings from a JSON file using its i18n schema. * * @param Translations $translations The translations instance to append the new translations. * @param string|null $file JSON file name or null if no reference should be added. * @param string|string[]|array[]|object $i18n_schema I18n schema for the setting. * @param string|string[]|array[] $settings Value for the settings. * * @return void */ private static function extract_strings_using_i18n_schema( Translations $translations, $file, $i18n_schema, $settings ) { if ( empty( $i18n_schema ) || empty( $settings ) ) { return; } if ( is_string( $i18n_schema ) && is_string( $settings ) ) { $translation = $translations->insert( $i18n_schema, $settings ); if ( $file ) { $translation->addReference( $file ); } return; } if ( is_array( $i18n_schema ) && is_array( $settings ) ) { foreach ( $settings as $value ) { self::extract_strings_using_i18n_schema( $translations, $file, $i18n_schema[0], $value ); } } if ( is_object( $i18n_schema ) && is_array( $settings ) ) { $group_key = '*'; foreach ( $settings as $key => $value ) { if ( isset( $i18n_schema->$key ) ) { self::extract_strings_using_i18n_schema( $translations, $file, $i18n_schema->$key, $value ); } elseif ( isset( $i18n_schema->$group_key ) ) { self::extract_strings_using_i18n_schema( $translations, $file, $i18n_schema->$group_key, $value ); } } } } /** * Given a remote URL, fetches it remotely and returns its content. * * Returns an empty string in case of error. * * @param string $url URL of the file to fetch. * * @return string Contents of the file. */ private static function remote_get( $url ) { if ( ! $url ) { return ''; } $headers = [ 'Content-type: application/json' ]; $options = [ 'halt_on_error' => false ]; $response = Utils\http_request( 'GET', $url, null, $headers, $options ); if ( ! $response->success || 200 > (int) $response->status_code || 300 <= (int) $response->status_code ) { WP_CLI::debug( "Failed to download from URL {$url}", 'make-pot' ); return ''; } return trim( $response->body ); } } <?php namespace WP_CLI\I18n; use Exception; use Gettext\Extractors\JsCode; use Gettext\Translations; use Peast\Syntax\Exception as PeastException; use WP_CLI; final class JsCodeExtractor extends JsCode { use IterableCodeExtractor; public static $options = [ 'extractComments' => [ 'translators', 'Translators' ], 'constants' => [], 'functions' => [ '__' => 'text_domain', '_x' => 'text_context_domain', '_n' => 'single_plural_number_domain', '_nx' => 'single_plural_number_context_domain', ], ]; protected static $functionsScannerClass = 'WP_CLI\I18n\JsFunctionsScanner'; /** * @inheritdoc */ public static function fromString( $text, Translations $translations, array $options = [] ) { WP_CLI::debug( "Parsing file {$options['file']}", 'make-pot' ); try { self::fromStringMultiple( $text, [ $translations ], $options ); } catch ( PeastException $exception ) { WP_CLI::debug( sprintf( 'Could not parse file %1$s: %2$s (line %3$d, column %4$d)', $options['file'], $exception->getMessage(), $exception->getPosition()->getLine(), $exception->getPosition()->getColumn() ), 'make-pot' ); } catch ( Exception $exception ) { WP_CLI::debug( sprintf( 'Could not parse file %1$s: %2$s', $options['file'], $exception->getMessage() ), 'make-pot' ); } } /** * @inheritDoc */ public static function fromStringMultiple( $text, array $translations, array $options = [] ) { $options += self::$options; /** @var JsFunctionsScanner $functions */ $functions = new self::$functionsScannerClass( $text ); $functions->enableCommentsExtraction( $options['extractComments'] ); $functions->saveGettextFunctions( $translations, $options ); } } <?php namespace WP_CLI\I18n; class FileDataExtractor { /** * Retrieves metadata from a file. * * Searches for metadata in the first 8kiB of a file, such as a plugin or theme. * Each piece of metadata must be on its own line. Fields can not span multiple * lines, the value will get cut at the end of the first line. * * If the file data is not within that first 8kiB, then the author should correct * their plugin file and move the data headers to the top. * * @see get_file_data() * * @param string $file Path to the file. * @param array $headers List of headers, in the format array('HeaderKey' => 'Header Name'). * * @return array Array of file headers in `HeaderKey => Header Value` format. */ public static function get_file_data( $file, $headers ) { // We don't need to write to the file, so just open for reading. $fp = fopen( $file, 'rb' ); // Pull only the first 8kiB of the file in. $file_data = fread( $fp, 8192 ); // PHP will close file handle, but we are good citizens. fclose( $fp ); // Make sure we catch CR-only line endings. $file_data = str_replace( "\r", "\n", $file_data ); return static::get_file_data_from_string( $file_data, $headers ); } /** * Retrieves metadata from a string. * * @param string $text String to look for metadata in. * @param array $headers List of headers. * * @return array Array of file headers in `HeaderKey => Header Value` format. */ public static function get_file_data_from_string( $text, $headers ) { foreach ( $headers as $field => $regex ) { if ( preg_match( '/^[ \t\/*#@]*' . preg_quote( $regex, '/' ) . ':(.*)$/mi', $text, $match ) && $match[1] ) { $headers[ $field ] = static::_cleanup_header_comment( $match[1] ); } else { $headers[ $field ] = ''; } } return $headers; } /** * Strip close comment and close php tags from file headers used by WP. * * @see _cleanup_header_comment() * * @param string $str Header comment to clean up. * * @return string */ protected static function _cleanup_header_comment( $str ) { // phpcs:ignore PSR2.Methods.MethodDeclaration.Underscore -- Not changing because third-party commands might use/extend. return trim( preg_replace( '/\s*(?:\*\/|\?>).*/', '', $str ) ); } } <?php namespace WP_CLI\I18n; use eftec\bladeone\BladeOne; // Modified Gettext Blade extractor that // uses the up-to-date BladeOne standalone Blade engine, // correctly supports fromStringMultiple. /** * Class to get gettext strings from blade.php files returning arrays. */ class BladeGettextExtractor extends \Gettext\Extractors\PhpCode { /** * Prepares a Blade compiler/engine and returns it. * * @return BladeOne */ protected static function getBladeCompiler() { $cache_path = empty( $options['cachePath'] ) ? sys_get_temp_dir() : $options['cachePath']; $blade_compiler = new BladeOne( null, $cache_path ); if ( method_exists( $blade_compiler, 'withoutComponentTags' ) ) { $blade_compiler->withoutComponentTags(); } return $blade_compiler; } /** * Compiles the Blade template string into a PHP string in one step. * * @param string $text Blade string to be compiled to a PHP string * @return string */ protected static function compileBladeToPhp( $text ) { return static::getBladeCompiler()->compileString( $text ); } /** * {@inheritdoc} * * Note: In the parent PhpCode class fromString() uses fromStringMultiple() (overriden here) */ public static function fromStringMultiple( $text, array $translations, array $options = [] ) { $php_string = static::compileBladeToPhp( $text ); return parent::fromStringMultiple( $php_string, $translations, $options ); } } <?php namespace WP_CLI\I18n; use DirectoryIterator; use Gettext\Extractors\Po; use Gettext\Merge; use Gettext\Translations; use IteratorIterator; use SplFileInfo; use WP_CLI; use WP_CLI\Utils; use WP_CLI_Command; class UpdatePoCommand extends WP_CLI_Command { /** * Update PO files from a POT file. * * This behaves similarly to the [msgmerge](https://www.gnu.org/software/gettext/manual/html_node/msgmerge-Invocation.html) command. * * ## OPTIONS * * <source> * : Path to an existing POT file to use for updating. * * [<destination>] * : PO file to update or a directory containing multiple PO files. * Defaults to all PO files in the source directory. * * ## EXAMPLES * * # Update all PO files from a POT file in the current directory. * $ wp i18n update-po example-plugin.pot * Success: Updated 3 files. * * # Update a PO file from a POT file. * $ wp i18n update-po example-plugin.pot example-plugin-de_DE.po * Success: Updated 1 file. * * # Update all PO files in a given directory from a POT file. * $ wp i18n update-po example-plugin.pot languages * Success: Updated 2 files. * * @when before_wp_load * * @throws WP_CLI\ExitException */ public function __invoke( $args, $assoc_args ) { $source = realpath( $args[0] ); if ( ! $source || ! is_file( $source ) ) { WP_CLI::error( 'Source file does not exist.' ); } $destination = dirname( $source ); if ( isset( $args[1] ) ) { $destination = $args[1]; } if ( ! file_exists( $destination ) ) { WP_CLI::error( 'Destination file/folder does not exist.' ); } if ( is_file( $destination ) ) { $files = [ new SplFileInfo( $destination ) ]; } else { $files = new IteratorIterator( new DirectoryIterator( $destination ) ); } $pot_translations = Translations::fromPoFile( $source ); $result_count = 0; /** @var DirectoryIterator $file */ foreach ( $files as $file ) { if ( 'po' !== $file->getExtension() ) { continue; } if ( ! $file->isFile() || ! $file->isReadable() ) { WP_CLI::warning( sprintf( 'Could not read file %s', $file->getFilename() ) ); continue; } $po_translations = Translations::fromPoFile( $file->getPathname() ); $po_translations->mergeWith( $pot_translations, Merge::ADD | Merge::REMOVE | Merge::COMMENTS_THEIRS | Merge::EXTRACTED_COMMENTS_THEIRS | Merge::REFERENCES_THEIRS | Merge::DOMAIN_OVERRIDE ); if ( ! $po_translations->toPoFile( $file->getPathname() ) ) { WP_CLI::warning( sprintf( 'Could not update file %s', $file->getPathname() ) ); continue; } ++$result_count; } WP_CLI::success( sprintf( 'Updated %d %s.', $result_count, Utils\pluralize( 'file', $result_count ) ) ); } } <?php namespace WP_CLI\I18n; use DirectoryIterator; use Gettext\Translations; use IteratorIterator; use SplFileInfo; use WP_CLI; use WP_CLI\Utils; use WP_CLI_Command; class MakeMoCommand extends WP_CLI_Command { /** * Create MO files from PO files. * * ## OPTIONS * * <source> * : Path to an existing PO file or a directory containing multiple PO files. * * [<destination>] * : Path to the destination file or directory for the resulting MO files. Defaults to the source directory. * * ## EXAMPLES * * # Create MO files for all PO files in the current directory. * $ wp i18n make-mo . * * # Create a MO file from a single PO file in a specific directory. * $ wp i18n make-mo example-plugin-de_DE.po languages * * # Create a MO file from a single PO file to a specific file destination * $ wp i18n make-mo example-plugin-de_DE.po languages/bar.mo * * @when before_wp_load * * @throws WP_CLI\ExitException */ public function __invoke( $args, $assoc_args ) { $source = realpath( $args[0] ); if ( ! $source || ( ! is_file( $source ) && ! is_dir( $source ) ) ) { WP_CLI::error( 'Source file or directory does not exist.' ); } $destination = is_file( $source ) ? dirname( $source ) : $source; $custom_file_name = null; if ( isset( $args[1] ) ) { $destination = $args[1]; $destination_pathinfo = pathinfo( $destination ); // Destination is a file, make sure source is also a file if ( ! empty( $destination_pathinfo['filename'] ) && ! empty( $destination_pathinfo['extension'] ) ) { if ( ! is_file( $source ) ) { WP_CLI::error( 'Destination file not supported when source is a directory.' ); } $destination = $destination_pathinfo['dirname']; $custom_file_name = $destination_pathinfo['filename'] . '.' . $destination_pathinfo['extension']; } } if ( ! is_dir( $destination ) && ! mkdir( $destination, 0777, true ) ) { WP_CLI::error( 'Could not create destination directory.' ); } if ( is_file( $source ) ) { $files = [ new SplFileInfo( $source ) ]; } else { $files = new IteratorIterator( new DirectoryIterator( $source ) ); } $result_count = 0; /** @var DirectoryIterator $file */ foreach ( $files as $file ) { if ( 'po' !== $file->getExtension() ) { continue; } if ( ! $file->isFile() || ! $file->isReadable() ) { WP_CLI::warning( sprintf( 'Could not read file %s', $file->getFilename() ) ); continue; } $file_basename = basename( $file->getFilename(), '.po' ); $file_name = $file_basename . '.mo'; if ( $custom_file_name ) { $file_name = $custom_file_name; } $destination_file = "{$destination}/{$file_name}"; $translations = Translations::fromPoFile( $file->getPathname() ); if ( ! $translations->toMoFile( $destination_file ) ) { WP_CLI::warning( sprintf( 'Could not create file %s', $destination_file ) ); continue; } ++$result_count; } WP_CLI::success( sprintf( 'Created %d %s.', $result_count, Utils\pluralize( 'file', $result_count ) ) ); } } <?php namespace WP_CLI\I18n; use WP_CLI\Dispatcher\CommandNamespace as BaseCommandNamespace; /** * Provides internationalization tools for WordPress projects. * * ## EXAMPLES * * # Create a POT file for the WordPress plugin/theme in the current directory * $ wp i18n make-pot . languages/my-plugin.pot * * @when before_wp_load */ class CommandNamespace extends BaseCommandNamespace { } <?php namespace WP_CLI\I18n; use Gettext\Generators\Po as PoGenerator; use Gettext\Translations; use Gettext\Utils\ParsedComment; /** * POT file generator. * * The only difference to the existing PO file generator is that this * adds some comments at the very beginning of the file. */ class PotGenerator extends PoGenerator { protected static $comments_before_headers = []; /** * Text to include as a comment before the start of the PO contents * * Doesn't need to include # in the beginning of lines, these are added automatically. * * @param string $comment File comment. */ public static function setCommentBeforeHeaders( $comment ) { $comments = explode( "\n", $comment ); foreach ( $comments as $line ) { if ( '' !== trim( $line ) ) { static::$comments_before_headers[] = '# ' . $line; } } } /** * {@parentDoc}. */ public static function toString( Translations $translations, array $options = [] ) { $lines = static::$comments_before_headers; $lines[] = 'msgid ""'; $lines[] = 'msgstr ""'; $plural_form = $translations->getPluralForms(); $plural_size = is_array( $plural_form ) ? ( $plural_form[0] - 1 ) : 1; foreach ( $translations->getHeaders() as $name => $value ) { $lines[] = sprintf( '"%s: %s\\n"', $name, $value ); } $lines[] = ''; foreach ( $translations as $translation ) { /** @var \Gettext\Translation $translation */ if ( $translation->hasComments() ) { foreach ( $translation->getComments() as $comment ) { $lines[] = '# ' . $comment; } } if ( $translation->hasExtractedComments() ) { $unique_comments = array(); /** @var ParsedComment|string $comment */ foreach ( $translation->getExtractedComments() as $comment ) { $comment = ( $comment instanceof ParsedComment ? $comment->getComment() : $comment ); if ( ! in_array( $comment, $unique_comments, true ) ) { $lines[] = '#. ' . $comment; $unique_comments[] = $comment; } } } foreach ( $translation->getReferences() as $reference ) { $lines[] = '#: ' . $reference[0] . ( null !== $reference[1] ? ':' . $reference[1] : '' ); } if ( $translation->hasFlags() ) { $lines[] = '#, ' . implode( ',', $translation->getFlags() ); } $prefix = $translation->isDisabled() ? '#~ ' : ''; if ( $translation->hasContext() ) { $lines[] = $prefix . 'msgctxt ' . self::convertString( $translation->getContext() ); } self::addLines( $lines, $prefix . 'msgid', $translation->getOriginal() ); if ( $translation->hasPlural() ) { self::addLines( $lines, $prefix . 'msgid_plural', $translation->getPlural() ); for ( $i = 0; $i <= $plural_size; $i++ ) { self::addLines( $lines, $prefix . 'msgstr[' . $i . ']', '' ); } } else { self::addLines( $lines, $prefix . 'msgstr', $translation->getTranslation() ); } $lines[] = ''; } return implode( "\n", $lines ); } /** * Escapes and adds double quotes to a string. * * @param string $text Multiline string. * * @return string[] */ protected static function multilineQuote( $text ) { $lines = explode( "\n", $text ); $last = count( $lines ) - 1; foreach ( $lines as $k => $line ) { if ( $k === $last ) { $lines[ $k ] = self::convertString( $line ); } else { $lines[ $k ] = self::convertString( $line . "\n" ); } } return $lines; } /** * Add one or more lines depending whether the string is multiline or not. * * @param array &$lines Array lines should be added to. * @param string $name Name of the line, e.g. msgstr or msgid_plural. * @param string $value The line to add. */ protected static function addLines( array &$lines, $name, $value ) { $newlines = self::multilineQuote( $value ); if ( count( $newlines ) === 1 ) { $lines[] = $name . ' ' . $newlines[0]; } else { $lines[] = $name . ' ""'; foreach ( $newlines as $line ) { $lines[] = $line; } } } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_i18n_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_i18n_autoloader ) ) { require_once $wpcli_i18n_autoloader; } if ( class_exists( 'WP_CLI\Dispatcher\CommandNamespace' ) ) { WP_CLI::add_command( 'i18n', '\WP_CLI\I18n\CommandNamespace' ); } WP_CLI::add_command( 'i18n make-pot', '\WP_CLI\I18n\MakePotCommand', array( 'before_invoke' => static function () { if ( ! function_exists( 'mb_ereg' ) ) { WP_CLI::error( 'The mbstring extension is required for string extraction to work reliably.' ); } }, ) ); WP_CLI::add_command( 'i18n make-json', '\WP_CLI\I18n\MakeJsonCommand' ); WP_CLI::add_command( 'i18n make-mo', '\WP_CLI\I18n\MakeMoCommand' ); WP_CLI::add_command( 'i18n make-php', '\WP_CLI\I18n\MakePhpCommand' ); WP_CLI::add_command( 'i18n update-po', '\WP_CLI\I18n\UpdatePoCommand' ); <?php use WP_CLI\Utils; /** * Lists or flushes the site's rewrite rules, updates the permalink structure. * * See the WordPress [Rewrite API](https://codex.wordpress.org/Rewrite_API) and * [WP Rewrite](https://codex.wordpress.org/Class_Reference/WP_Rewrite) class reference. * * ## EXAMPLES * * # Flush rewrite rules * $ wp rewrite flush * Success: Rewrite rules flushed. * * # Update permalink structure * $ wp rewrite structure '/%year%/%monthnum%/%postname%' * Success: Rewrite structure set. * * # List rewrite rules * $ wp rewrite list --format=csv * match,query,source * ^wp-json/?$,index.php?rest_route=/,other * ^wp-json/(.*)?,index.php?rest_route=/$matches[1],other * category/(.+?)/feed/(feed|rdf|rss|rss2|atom)/?$,index.php?category_name=$matches[1]&feed=$matches[2],category * category/(.+?)/(feed|rdf|rss|rss2|atom)/?$,index.php?category_name=$matches[1]&feed=$matches[2],category * category/(.+?)/embed/?$,index.php?category_name=$matches[1]&embed=true,category * * @package wp-cli */ class Rewrite_Command extends WP_CLI_Command { /** * Flushes rewrite rules. * * Resets WordPress' rewrite rules based on registered post types, etc. * * To regenerate a .htaccess file with WP-CLI, you'll need to add the mod_rewrite module * to your wp-cli.yml or config.yml. For example: * * ``` * apache_modules: * - mod_rewrite * ``` * * ## OPTIONS * * [--hard] * : Perform a hard flush - update `.htaccess` rules as well as rewrite rules in database. Works only on single site installs. * * ## EXAMPLES * * $ wp rewrite flush * Success: Rewrite rules flushed. */ public function flush( $args, $assoc_args ) { // make sure we detect mod_rewrite if configured in apache_modules in config self::apache_modules(); if ( Utils\get_flag_value( $assoc_args, 'hard' ) && ! in_array( 'mod_rewrite', (array) WP_CLI::get_config( 'apache_modules' ), true ) ) { WP_CLI::warning( 'Regenerating a .htaccess file requires special configuration. See usage docs.' ); } if ( Utils\get_flag_value( $assoc_args, 'hard' ) && is_multisite() ) { WP_CLI::warning( "WordPress can't generate .htaccess file for a multisite install." ); } self::check_skip_plugins_themes(); flush_rewrite_rules( Utils\get_flag_value( $assoc_args, 'hard' ) ); if ( ! get_option( 'rewrite_rules' ) ) { WP_CLI::warning( "Rewrite rules are empty, possibly because of a missing permalink_structure option. Use 'wp rewrite list' to verify, or 'wp rewrite structure' to update permalink_structure." ); } else { WP_CLI::success( 'Rewrite rules flushed.' ); } } /** * Updates the permalink structure. * * Sets the post permalink structure to the specified pattern. * * To regenerate a .htaccess file with WP-CLI, you'll need to add * the mod_rewrite module to your [WP-CLI config](https://make.wordpress.org/cli/handbook/config/#config-files). * For example: * * ``` * apache_modules: * - mod_rewrite * ``` * * ## OPTIONS * * <permastruct> * : The new permalink structure to apply. * * [--category-base=<base>] * : Set the base for category permalinks, i.e. '/category/'. * * [--tag-base=<base>] * : Set the base for tag permalinks, i.e. '/tag/'. * * [--hard] * : Perform a hard flush - update `.htaccess` rules as well as rewrite rules in database. * * ## EXAMPLES * * $ wp rewrite structure '/%year%/%monthnum%/%postname%/' * Success: Rewrite structure set. */ public function structure( $args, $assoc_args ) { global $wp_rewrite; // copypasta from /wp-admin/options-permalink.php $blog_prefix = ''; $prefix = $blog_prefix; if ( is_multisite() && ! is_subdomain_install() && is_main_site() ) { $blog_prefix = '/blog'; } $permalink_structure = ( 'default' === $args[0] ) ? '' : $args[0]; if ( ! empty( $permalink_structure ) ) { $permalink_structure = preg_replace( '#/+#', '/', '/' . str_replace( '#', '', $permalink_structure ) ); if ( $prefix && $blog_prefix ) { $permalink_structure = $prefix . preg_replace( '#^/?index\.php#', '', $permalink_structure ); } else { $permalink_structure = $blog_prefix . $permalink_structure; } } $wp_rewrite->set_permalink_structure( $permalink_structure ); // Update category or tag bases if ( isset( $assoc_args['category-base'] ) ) { $category_base = $assoc_args['category-base']; if ( ! empty( $category_base ) ) { $category_base = $blog_prefix . preg_replace( '#/+#', '/', '/' . str_replace( '#', '', $category_base ) ); } $wp_rewrite->set_category_base( $category_base ); } if ( isset( $assoc_args['tag-base'] ) ) { $tag_base = $assoc_args['tag-base']; if ( ! empty( $tag_base ) ) { $tag_base = $blog_prefix . preg_replace( '#/+#', '/', '/' . str_replace( '#', '', $tag_base ) ); } $wp_rewrite->set_tag_base( $tag_base ); } // make sure we detect mod_rewrite if configured in apache_modules in config self::apache_modules(); WP_CLI::success( 'Rewrite structure set.' ); // Launch a new process to flush rewrites because core expects flush // to happen after rewrites are set $new_assoc_args = []; $cmd = 'rewrite flush'; if ( Utils\get_flag_value( $assoc_args, 'hard' ) ) { $cmd .= ' --hard'; $new_assoc_args['hard'] = true; if ( ! in_array( 'mod_rewrite', (array) WP_CLI::get_config( 'apache_modules' ), true ) ) { WP_CLI::warning( 'Regenerating a .htaccess file requires special configuration. See usage docs.' ); } } $process_run = WP_CLI::runcommand( $cmd ); if ( ! empty( $process_run->stderr ) ) { // Strip "Warning: " WP_CLI::warning( substr( $process_run->stderr, 9 ) ); } } /** * Gets a list of the current rewrite rules. * * ## OPTIONS * * [--match=<url>] * : Show rewrite rules matching a particular URL. * * [--source=<source>] * : Show rewrite rules from a particular source. * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to match,query,source. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - yaml * --- * * ## EXAMPLES * * $ wp rewrite list --format=csv * match,query,source * ^wp-json/?$,index.php?rest_route=/,other * ^wp-json/(.*)?,index.php?rest_route=/$matches[1],other * category/(.+?)/feed/(feed|rdf|rss|rss2|atom)/?$,index.php?category_name=$matches[1]&feed=$matches[2],category * category/(.+?)/(feed|rdf|rss|rss2|atom)/?$,index.php?category_name=$matches[1]&feed=$matches[2],category * category/(.+?)/embed/?$,index.php?category_name=$matches[1]&embed=true,category * * @subcommand list */ public function list_( $args, $assoc_args ) { global $wp_rewrite; $rules = get_option( 'rewrite_rules' ); if ( ! $rules ) { $rules = []; WP_CLI::warning( 'No rewrite rules.' ); } self::check_skip_plugins_themes(); $defaults = [ 'source' => '', 'match' => '', 'format' => 'table', 'fields' => 'match,query,source', ]; $assoc_args = array_merge( $defaults, $assoc_args ); if ( ! empty( $assoc_args['match'] ) ) { if ( 0 === stripos( $assoc_args['match'], 'http://' ) || 0 === stripos( $assoc_args['match'], 'https://' ) ) { $bits = WP_CLI\Utils\parse_url( $assoc_args['match'] ); $assoc_args['match'] = ( isset( $bits['path'] ) ? $bits['path'] : '' ) . ( isset( $bits['query'] ) ? '?' . $bits['query'] : '' ); } } $rewrite_rules_by_source = []; $rewrite_rules_by_source['post'] = $wp_rewrite->generate_rewrite_rules( $wp_rewrite->permalink_structure, EP_PERMALINK ); $rewrite_rules_by_source['date'] = $wp_rewrite->generate_rewrite_rules( $wp_rewrite->get_date_permastruct(), EP_DATE ); $rewrite_rules_by_source['root'] = $wp_rewrite->generate_rewrite_rules( $wp_rewrite->root . '/', EP_ROOT ); $rewrite_rules_by_source['comments'] = $wp_rewrite->generate_rewrite_rules( $wp_rewrite->root . $wp_rewrite->comments_base, EP_COMMENTS, true, true, true, false ); $rewrite_rules_by_source['search'] = $wp_rewrite->generate_rewrite_rules( $wp_rewrite->get_search_permastruct(), EP_SEARCH ); $rewrite_rules_by_source['author'] = $wp_rewrite->generate_rewrite_rules( $wp_rewrite->get_author_permastruct(), EP_AUTHORS ); $rewrite_rules_by_source['page'] = $wp_rewrite->page_rewrite_rules(); // Extra permastructs including tags, categories, etc. foreach ( $wp_rewrite->extra_permastructs as $permastructname => $permastruct ) { if ( is_array( $permastruct ) ) { $rewrite_rules_by_source[ $permastructname ] = $wp_rewrite->generate_rewrite_rules( $permastruct['struct'], $permastruct['ep_mask'], $permastruct['paged'], $permastruct['feed'], $permastruct['forcomments'], $permastruct['walk_dirs'], $permastruct['endpoints'] ); } else { $rewrite_rules_by_source[ $permastructname ] = $wp_rewrite->generate_rewrite_rules( $permastruct, EP_NONE ); } } // Apply the filters used in core just in case foreach ( $rewrite_rules_by_source as $source => $source_rules ) { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.DynamicHooknameFound -- Can't prefix dynamic hooks here, calling hooks for custom permastructs. $rewrite_rules_by_source[ $source ] = apply_filters( $source . '_rewrite_rules', $source_rules ); if ( 'post_tag' === $source ) { if ( Utils\wp_version_compare( '3.1.0', '>=' ) ) { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. $rewrite_rules_by_source[ $source ] = apply_filters( 'post_tag_rewrite_rules', $source_rules ); } else { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. $rewrite_rules_by_source[ $source ] = apply_filters( 'tag_rewrite_rules', $source_rules ); } } } $rule_list = []; foreach ( $rules as $match => $query ) { if ( ! empty( $assoc_args['match'] ) && ! preg_match( "!^$match!", trim( $assoc_args['match'], '/' ) ) ) { continue; } $source = 'other'; foreach ( $rewrite_rules_by_source as $rules_source => $source_rules ) { if ( array_key_exists( $match, $source_rules ) ) { $source = $rules_source; } } if ( ! empty( $assoc_args['source'] ) && $source !== $assoc_args['source'] ) { continue; } $rule_list[] = compact( 'match', 'query', 'source' ); } Utils\format_items( $assoc_args['format'], $rule_list, explode( ',', $assoc_args['fields'] ) ); } /** * Exposes apache modules if present in config * * Implementation Notes: This function exposes a global function * apache_get_modules and also sets the $is_apache global variable. * * This is so that flush_rewrite_rules will actually write out the * .htaccess file for apache WordPress installations. There is a check * to see: * * 1. if the $is_apache variable is set. * 2. if the mod_rewrite module is returned from the apache_get_modules * function. * * To get this to work with wp-cli you'll need to add the mod_rewrite module * to your config.yml. For example * * ``` * apache_modules: * - mod_rewrite * ``` * * If this isn't done then the .htaccess rewrite rules won't be flushed out * to disk. */ private static function apache_modules() { $mods = WP_CLI::get_config( 'apache_modules' ); if ( ! empty( $mods ) && ! function_exists( 'apache_get_modules' ) ) { global $is_apache; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited $is_apache = true; // needed for get_home_path() and .htaccess location $_SERVER['SCRIPT_FILENAME'] = ABSPATH; function apache_get_modules() { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals return WP_CLI::get_config( 'apache_modules' ); } } } /** * Displays a warning if --skip-plugins or --skip-themes are in use. * * Skipping the loading of plugins or themes can mean some rewrite rules * are unregistered, which may cause erroneous behavior. */ private static function check_skip_plugins_themes() { $skipped = []; if ( WP_CLI::get_config( 'skip-plugins' ) ) { $skipped[] = 'plugins'; } if ( WP_CLI::get_config( 'skip-themes' ) ) { $skipped[] = 'themes'; } if ( empty( $skipped ) ) { return; } $skipped = implode( ' and ', $skipped ); WP_CLI::warning( sprintf( "Some rewrite rules may be missing because %s weren't loaded by WP-CLI.", $skipped ) ); } } WP_CLI::add_command( 'rewrite', 'Rewrite_Command' ); <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_rewrite_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_rewrite_autoloader ) ) { require_once $wpcli_rewrite_autoloader; } WP_CLI::add_command( 'rewrite', 'Rewrite_Command' ); #!/usr/bin/env sh # Special case for *AMP installers, since they normally don't set themselves # as the default cli php out of the box. for amp_php in $(cat $(dirname $0)/amp-paths.txt); do if [ -x $amp_php ]; then echo $amp_php exit fi done which php || which php-cli if [ $? -eq 0 ]; then exit fi echo "no PHP binary found" >&2 exit 1 <?php $file = $argv[1]; if ( ! file_exists( $file ) ) { echo 'File does not exist.'; exit( 1 ); } $contents = file_get_contents( $file ); $composer = json_decode( $contents ); if ( empty( $composer ) || ! is_object( $composer ) ) { echo 'Invalid composer.json for package.'; exit( 1 ); } if ( empty( $composer->autoload->files ) ) { echo 'composer.json must specify valid "autoload" => "files"'; exit( 1 ); } echo implode( PHP_EOL, $composer->autoload->files ); exit( 0 ); <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_role_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_role_autoloader ) ) { require_once $wpcli_role_autoloader; } WP_CLI::add_command( 'cap', 'Capabilities_Command' ); WP_CLI::add_command( 'role', 'Role_Command' ); <?php use WP_CLI\Utils; use WP_CLI\Formatter; /** * Manages user roles, including creating new roles and resetting to defaults. * * See references for [Roles and Capabilities](https://codex.wordpress.org/Roles_and_Capabilities) and [WP User class](https://codex.wordpress.org/Class_Reference/WP_User). * * ## EXAMPLES * * # List roles. * $ wp role list --fields=role --format=csv * role * administrator * editor * author * contributor * subscriber * * # Check to see if a role exists. * $ wp role exists editor * Success: Role with ID 'editor' exists. * * # Create a new role. * $ wp role create approver Approver * Success: Role with key 'approver' created. * * # Delete an existing role. * $ wp role delete approver * Success: Role with key 'approver' deleted. * * # Reset existing roles to their default capabilities. * $ wp role reset administrator author contributor * Success: Reset 3/3 roles. * * @package wp-cli */ class Role_Command extends WP_CLI_Command { /** * List of available fields. * * @var array */ private $fields = [ 'name', 'role' ]; /** * Default roles as provided by WordPress Core. * * @var array */ private $roles = [ 'administrator', 'editor', 'author', 'contributor', 'subscriber' ]; /** * Lists all roles. * * ## OPTIONS * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--field=<field>] * : Prints the value of a single field. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each role: * * * name * * role * * There are no optional fields. * * ## EXAMPLES * * # List roles. * $ wp role list --fields=role --format=csv * role * administrator * editor * author * contributor * subscriber * * @subcommand list */ public function list_( $args, $assoc_args ) { global $wp_roles; $output_roles = array(); foreach ( $wp_roles->roles as $key => $role ) { $output_role = new stdClass(); $output_role->name = $role['name']; $output_role->role = $key; $output_roles[] = $output_role; } $formatter = new Formatter( $assoc_args, $this->fields ); $formatter->display_items( $output_roles ); } /** * Checks if a role exists. * * Exits with return code 0 if the role exists, 1 if it does not. * * ## OPTIONS * * <role-key> * : The internal name of the role. * * ## EXAMPLES * * # Check if a role exists. * $ wp role exists editor * Success: Role with ID 'editor' exists. */ public function exists( $args ) { global $wp_roles; if ( ! in_array( $args[0], array_keys( $wp_roles->roles ), true ) ) { WP_CLI::error( "Role with ID '{$args[0]}' does not exist." ); } WP_CLI::success( "Role with ID '{$args[0]}' exists." ); } /** * Creates a new role. * * ## OPTIONS * * <role-key> * : The internal name of the role. * * <role-name> * : The publicly visible name of the role. * * [--clone=<role>] * : Clone capabilities from an existing role. * * ## EXAMPLES * * # Create role for Approver. * $ wp role create approver Approver * Success: Role with key 'approver' created. * * # Create role for Product Administrator. * $ wp role create productadmin "Product Administrator" * Success: Role with key 'productadmin' created. */ public function create( $args, $assoc_args ) { global $wp_roles; self::persistence_check(); $role_key = array_shift( $args ); $role_name = array_shift( $args ); if ( empty( $role_key ) || empty( $role_name ) ) { WP_CLI::error( "Can't create role, insufficient information provided." ); } $capabilities = false; if ( ! empty( $assoc_args['clone'] ) ) { $role_obj = $wp_roles->get_role( $assoc_args['clone'] ); if ( ! $role_obj ) { WP_CLI::error( "'{$assoc_args['clone']}' role not found." ); } $capabilities = array_keys( $role_obj->capabilities ); } if ( add_role( $role_key, $role_name ) ) { if ( ! empty( $capabilities ) ) { $role_obj = $wp_roles->get_role( $role_key ); foreach ( $capabilities as $cap ) { $role_obj->add_cap( $cap ); } WP_CLI::success( "Role with key '{$role_key}' created. Cloned capabilities from '{$assoc_args['clone']}'." ); } else { WP_CLI::success( "Role with key '{$role_key}' created." ); } } else { WP_CLI::error( "Role couldn't be created." ); } } /** * Deletes an existing role. * * ## OPTIONS * * <role-key> * : The internal name of the role. * * ## EXAMPLES * * # Delete approver role. * $ wp role delete approver * Success: Role with key 'approver' deleted. * * # Delete productadmin role. * $ wp role delete productadmin * Success: Role with key 'productadmin' deleted. */ public function delete( $args ) { global $wp_roles; self::persistence_check(); $role_key = array_shift( $args ); if ( empty( $role_key ) || ! isset( $wp_roles->roles[ $role_key ] ) ) { WP_CLI::error( 'Role key not provided, or is invalid.' ); } remove_role( $role_key ); // Note: remove_role() doesn't indicate success or otherwise, so we have to // check ourselves if ( ! isset( $wp_roles->roles[ $role_key ] ) ) { WP_CLI::success( "Role with key '{$role_key}' deleted." ); } else { WP_CLI::error( "Role with key '{$role_key}' could not be deleted." ); } } /** * Resets any default role to default capabilities. * * Uses WordPress' `populate_roles()` function to put one or more * roles back into the state they were at in the a fresh * WordPress install. Removes any capabilities that were added, * and restores any capabilities that were removed. Custom roles * are not affected. * * ## OPTIONS * * [<role-key>...] * : The internal name of one or more roles to reset. * * [--all] * : If set, all default roles will be reset. * * ## EXAMPLES * * # Reset three roles. * $ wp role reset administrator author contributor * Restored 1 capability to and removed 0 capabilities from 'administrator' role. * No changes necessary for 'author' role. * No changes necessary for 'contributor' role. * Success: 1 of 3 roles reset. * * # Reset a custom role. * $ wp role reset custom_role * Custom role 'custom_role' not affected. * Error: Must specify a default role to reset. * * # Reset all default roles. * $ wp role reset --all * Success: All default roles reset. */ public function reset( $args, $assoc_args ) { self::persistence_check(); if ( ! Utils\get_flag_value( $assoc_args, 'all' ) && empty( $args ) ) { WP_CLI::error( 'Role key not provided, or is invalid.' ); } if ( ! function_exists( 'populate_roles' ) ) { require_once ABSPATH . 'wp-admin/includes/schema.php'; } global $wp_roles; $all_roles = array_keys( $wp_roles->roles ); $preserve_args = $args; // Get our default roles. $default_roles = $this->roles; $preserve = $this->roles; $before = []; if ( Utils\get_flag_value( $assoc_args, 'all' ) ) { foreach ( $default_roles as $role ) { $before[ $role ] = get_role( $role ); remove_role( $role ); $args[] = $role; } populate_roles(); $not_affected_roles = array_diff( $all_roles, $default_roles ); if ( ! empty( $not_affected_roles ) ) { foreach ( $not_affected_roles as $not_affected_role ) { WP_CLI::log( "Custom role '{$not_affected_role}' not affected." ); } } } else { foreach ( $args as $k => $role_key ) { $key = array_search( $role_key, $default_roles, true ); if ( false !== $key ) { unset( $preserve[ $key ] ); $before[ $role_key ] = get_role( $role_key ); remove_role( $role_key ); } else { unset( $args[ $k ] ); } } $not_affected_roles = array_diff( $preserve_args, $default_roles ); if ( ! empty( $not_affected_roles ) ) { foreach ( $not_affected_roles as $not_affected_role ) { WP_CLI::log( "Custom role '{$not_affected_role}' not affected." ); } } // No roles were unset, bail. if ( count( $default_roles ) === count( $preserve ) ) { WP_CLI::error( 'Must specify a default role to reset.' ); } // For the roles we're not resetting. foreach ( $preserve as $k => $role ) { /* save roles * if get_role is null * save role name for re-removal */ $roleobj = get_role( $role ); $preserve[ $k ] = is_null( $roleobj ) ? $role : $roleobj; remove_role( $role ); } // Put back all default roles and capabilities. populate_roles(); // Restore the preserved roles. foreach ( $preserve as $k => $roleobj ) { // Re-remove after populating. if ( is_a( $roleobj, 'WP_Role' ) ) { remove_role( $roleobj->name ); add_role( $roleobj->name, ucwords( $roleobj->name ), $roleobj->capabilities ); } else { // When not an object, that means the role didn't exist before. remove_role( $roleobj ); } } } $num_reset = 0; $args = array_unique( $args ); $num_to_reset = count( $args ); foreach ( $args as $role_key ) { $after[ $role_key ] = get_role( $role_key ); // phpcs:ignore Universal.Operators.StrictComparisons -- Object instances won't be same, strict check will fail here. if ( $after[ $role_key ] != $before[ $role_key ] ) { ++$num_reset; $before_capabilities = isset( $before[ $role_key ] ) ? $before[ $role_key ]->capabilities : []; $restored_cap = array_diff_key( $after[ $role_key ]->capabilities, $before_capabilities ); $removed_cap = array_diff_key( $before_capabilities, $after[ $role_key ]->capabilities ); $restored_cap_count = count( $restored_cap ); $removed_cap_count = count( $removed_cap ); $restored_text = ( 1 === $restored_cap_count ) ? '%d capability' : '%d capabilities'; $removed_text = ( 1 === $removed_cap_count ) ? '%d capability' : '%d capabilities'; $message = "Restored {$restored_text} to and removed {$removed_text} from '%s' role."; WP_CLI::log( sprintf( $message, $restored_cap_count, $removed_cap_count, $role_key ) ); } else { WP_CLI::log( "No changes necessary for '{$role_key}' role." ); } } if ( $num_reset ) { if ( 1 === count( $args ) ) { WP_CLI::success( 'Role reset.' ); } else { WP_CLI::success( "{$num_reset} of {$num_to_reset} roles reset." ); } } elseif ( 1 === count( $args ) ) { WP_CLI::success( 'Role didn\'t need resetting.' ); } else { WP_CLI::success( 'No roles needed resetting.' ); } } /** * Assert that the roles are persisted to the database. * * @throws \WP_CLI\ExitException If the roles are not persisted to the * database. */ private static function persistence_check() { global $wp_roles; if ( ! $wp_roles->use_db ) { WP_CLI::error( 'Role definitions are not persistent.' ); } } } <?php use WP_CLI\Formatter; /** * Adds, removes, and lists capabilities of a user role. * * See references for [Roles and Capabilities](https://codex.wordpress.org/Roles_and_Capabilities) and [WP User class](https://codex.wordpress.org/Class_Reference/WP_User). * * ## EXAMPLES * * # Add 'spectate' capability to 'author' role. * $ wp cap add 'author' 'spectate' * Success: Added 1 capability to 'author' role. * * # Add all caps from 'editor' role to 'author' role. * $ wp cap list 'editor' | xargs wp cap add 'author' * Success: Added 24 capabilities to 'author' role. * * # Remove all caps from 'editor' role that also appear in 'author' role. * $ wp cap list 'author' | xargs wp cap remove 'editor' * Success: Removed 34 capabilities from 'editor' role. */ class Capabilities_Command extends WP_CLI_Command { /** * List of available fields. * * @var array */ private $fields = [ 'name' ]; /** * Lists capabilities for a given role. * * ## OPTIONS * * <role> * : Key for the role. * * [--format=<format>] * : Render output in a particular format. * --- * default: list * options: * - list * - table * - csv * - json * - count * - yaml * --- * * [--show-grant] * : Display all capabilities defined for a role including grant. * --- * default: false * --- * * ## EXAMPLES * * # Display alphabetical list of Contributor capabilities. * $ wp cap list 'contributor' | sort * delete_posts * edit_posts * level_0 * level_1 * read * * @subcommand list */ public function list_( $args, $assoc_args ) { $role_obj = self::get_role( $args[0] ); $show_grant = ! empty( $assoc_args['show-grant'] ); if ( $show_grant ) { array_push( $this->fields, 'grant' ); $capabilities = $role_obj->capabilities; } else { $capabilities = array_filter( $role_obj->capabilities ); } $output_caps = array(); foreach ( $capabilities as $cap => $grant ) { $output_cap = new stdClass(); $output_cap->name = $cap; $output_cap->grant = $grant ? 'true' : 'false'; $output_caps[] = $output_cap; } if ( 'list' === $assoc_args['format'] ) { foreach ( $output_caps as $cap ) { if ( $show_grant ) { WP_CLI::line( implode( ',', array( $cap->name, $cap->grant ) ) ); } else { WP_CLI::line( $cap->name ); } } } else { $formatter = new Formatter( $assoc_args, $this->fields ); $formatter->display_items( $output_caps ); } } /** * Adds capabilities to a given role. * * ## OPTIONS * * <role> * : Key for the role. * * <cap>... * : One or more capabilities to add. * * [--grant] * : Adds the capability as an explicit boolean value, instead of implicitly defaulting to `true`. * --- * default: true * options: * - true * - false * --- * * ## EXAMPLES * * # Add 'spectate' capability to 'author' role. * $ wp cap add author spectate * Success: Added 1 capability to 'author' role. */ public function add( $args, $assoc_args ) { self::persistence_check(); $role = array_shift( $args ); $role_obj = self::get_role( $role ); $grant = true; if ( isset( $assoc_args['grant'] ) ) { $grant = ! $assoc_args['grant'] || 'false' === $assoc_args['grant'] ? false : true; } $count = 0; foreach ( $args as $cap ) { if ( true === $grant && $role_obj->has_cap( $cap ) ) { continue; } if ( false === $grant && isset( $role_obj->capabilities[ $cap ] ) && false === $role_obj->capabilities[ $cap ] ) { continue; } $role_obj->add_cap( $cap, $grant ); ++$count; } $capability = WP_CLI\Utils\pluralize( 'capability', $count ); $grant_qualification = $grant ? '' : ' as false'; WP_CLI::success( "Added {$count} {$capability} to '{$role}' role{$grant_qualification}." ); } /** * Removes capabilities from a given role. * * ## OPTIONS * * <role> * : Key for the role. * * <cap>... * : One or more capabilities to remove. * * ## EXAMPLES * * # Remove 'spectate' capability from 'author' role. * $ wp cap remove author spectate * Success: Removed 1 capability from 'author' role. */ public function remove( $args ) { self::persistence_check(); $role = array_shift( $args ); $role_obj = self::get_role( $role ); $count = 0; foreach ( $args as $cap ) { if ( ! isset( $role_obj->capabilities[ $cap ] ) ) { continue; } $role_obj->remove_cap( $cap ); ++$count; } $capability = WP_CLI\Utils\pluralize( 'capability', $count ); WP_CLI::success( "Removed {$count} {$capability} from '{$role}' role." ); } /** * Retrieve a specific role from the system. * * @param string $role Role to retrieve. * @return WP_Role Requested role. * @throws \WP_CLI\ExitException If the role could not be found. */ private static function get_role( $role ) { global $wp_roles; $role_obj = $wp_roles->get_role( $role ); if ( ! $role_obj ) { WP_CLI::error( "'{$role}' role not found." ); } return $role_obj; } /** * Assert that the roles are persisted to the database. * * @throws \WP_CLI\ExitException If the roles are not persisted to the * database. */ private static function persistence_check() { global $wp_roles; if ( ! $wp_roles->use_db ) { WP_CLI::error( 'Role definitions are not persistent.' ); } } } <?php // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedFunctionFound -- Renaming breaks Phar compat. function wp_export( $args = array() ) { $defaults = array( 'filters' => array(), 'format' => 'WP_Export_WXR_Formatter', 'writer' => 'WP_Export_Returner', 'writer_args' => null, ); $args = wp_parse_args( $args, $defaults ); $export_query = new WP_Export_Query( $args['filters'] ); $formatter = new $args['format']( $export_query ); $writer = new $args['writer']( $formatter, $args['writer_args'] ); try { return $writer->export(); } catch ( WP_Export_Exception $e ) { return new WP_Error( 'wp-export-error', $e->getMessage() ); } } // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedFunctionFound,WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid -- Renaming breaks Phar compat. function _wp_export_build_IN_condition( $column_name, $values, $format = '%s' ) { global $wpdb; if ( ! is_array( $values ) || empty( $values ) ) { return ''; } $formats = implode( ', ', array_fill( 0, count( $values ), $format ) ); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared,WordPress.DB.PreparedSQLPlaceholders.UnfinishedPrepare -- $column_name_sql escaped as ident, $formats hardcoded value. return $wpdb->prepare( "{$column_name} IN ({$formats})", $values ); } <?php class WP_Iterator_Exception extends Exception { } <?php /** * Version number for the export format. * * Bump this when something changes that might affect compatibility. * * @since 2.5.0 */ define( 'WXR_VERSION', '1.2' ); //phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedConstantFound -- WordPress constant. /** * Responsible for formatting the data in WP_Export_Query to WXR */ class WP_Export_WXR_Formatter { public function __construct( $export ) { $this->export = $export; $this->wxr_version = WXR_VERSION; } public function before_posts( $requested_sections = [] ) { $available_sections = [ 'header', 'site_metadata', 'authors', 'categories', 'tags', 'nav_menu_terms', 'custom_taxonomies_terms', 'rss2_head_action', ]; $before_posts_xml = ''; foreach ( $available_sections as $section ) { if ( ! $requested_sections || in_array( $section, $requested_sections, true ) ) { $before_posts_xml .= $this->$section(); } } return $before_posts_xml; } public function posts() { return new WP_Map_Iterator( $this->export->posts(), [ $this, 'post' ] ); } public function after_posts() { return $this->footer(); } public function header() { $oxymel = new Oxymel(); $wp_generator_tag = $this->export->wp_generator_tag(); $comment = <<<COMMENT This is a WordPress eXtended RSS file generated by WordPress as an export of your site. It contains information about your site's posts, pages, comments, categories, and other content. You may use this file to transfer that content from one site to another. This file is not intended to serve as a complete backup of your site. To import this information into a WordPress site follow these steps: 1. Log in to that site as an administrator. 2. Go to Tools: Import in the WordPress admin panel. 3. Install the "WordPress" importer from the list. 4. Activate & Run Importer. 5. Upload this file using the form provided on that page. 6. You will first be asked to map the authors in this export file to users on the site. For each author, you may choose to map to an existing user on the site or to create a new user. 7. WordPress will then import each of the posts, pages, comments, categories, etc. contained in this file into your site. COMMENT; return $oxymel ->xml ->comment( $comment ) ->raw( $wp_generator_tag ) ->open_rss( [ 'version' => '2.0', 'xmlns:excerpt' => "http://wordpress.org/export/{$this->wxr_version}/excerpt/", 'xmlns:content' => 'http://purl.org/rss/1.0/modules/content/', 'xmlns:wfw' => 'http://wellformedweb.org/CommentAPI/', 'xmlns:dc' => 'http://purl.org/dc/elements/1.1/', 'xmlns:wp' => "http://wordpress.org/export/{$this->wxr_version}/", ] ) ->open_channel ->to_string(); } public function site_metadata() { $oxymel = new Oxymel(); $metadata = $this->export->site_metadata(); return $oxymel ->title( $metadata['name'] ) ->link( $metadata['url'] ) ->description( $metadata['description'] ) ->pubDate( $metadata['pubDate'] ) ->language( $metadata['language'] ) ->tag( 'wp:wxr_version', $this->wxr_version ) ->tag( 'wp:base_site_url', $metadata['site_url'] ) ->tag( 'wp:base_blog_url', $metadata['blog_url'] ) ->to_string(); } public function authors() { $oxymel = new Oxymel(); $authors = $this->export->authors(); foreach ( $authors as $author ) { $oxymel ->tag( 'wp:author' )->contains ->tag( 'wp:author_id', $author->ID ) ->tag( 'wp:author_login', $author->user_login ) ->tag( 'wp:author_email', $author->user_email ) ->tag( 'wp:author_display_name' )->contains->cdata( $author->display_name )->end ->tag( 'wp:author_first_name' )->contains->cdata( $author->user_firstname )->end ->tag( 'wp:author_last_name' )->contains->cdata( $author->user_lastname )->end ->end; } return $oxymel->to_string(); } public function categories() { $oxymel = new WP_Export_Oxymel(); $categories = $this->export->categories(); foreach ( $categories as $category ) { $category->parent_slug = $category->parent ? $categories[ $category->parent ]->slug : ''; $oxymel->tag( 'wp:category' )->contains ->tag( 'wp:term_id', $category->term_id ) ->tag( 'wp:category_nicename', $category->slug ) ->tag( 'wp:category_parent', $category->parent_slug ) ->optional_cdata( 'wp:cat_name', $category->name ) ->optional_cdata( 'wp:category_description', $category->description ) ->end; } return $oxymel->to_string(); } public function tags() { $oxymel = new WP_Export_Oxymel(); $tags = $this->export->tags(); foreach ( $tags as $tag ) { $oxymel->tag( 'wp:tag' )->contains ->tag( 'wp:term_id', $tag->term_id ) ->tag( 'wp:tag_slug', $tag->slug ) ->optional_cdata( 'wp:tag_name', $tag->name ) ->optional_cdata( 'wp:tag_description', $tag->description ) ->end; } return $oxymel->to_string(); } public function nav_menu_terms() { return $this->terms( $this->export->nav_menu_terms() ); } public function custom_taxonomies_terms() { return $this->terms( $this->export->custom_taxonomies_terms() ); } public function rss2_head_action() { ob_start(); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- WordPress native hook. do_action( 'rss2_head' ); return ob_get_clean(); } public function post( $post ) { $oxymel = new WP_Export_Oxymel(); $GLOBALS['wp_query']->in_the_loop = true; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- Intentional. $GLOBALS['post'] = $post; setup_postdata( $post ); $oxymel->item->contains ->tag( 'title' )->contains->cdata( apply_filters( 'the_title_export', $post->post_title ) )->end // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- WordPress native hook. ->link( esc_url( apply_filters( 'the_permalink_rss', get_permalink() ) ) ) // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- WordPress native hook. ->pubDate( mysql2date( 'D, d M Y H:i:s +0000', get_post_time( 'Y-m-d H:i:s', true ), false ) ) ->tag( 'dc:creator', get_the_author_meta( 'login' ) ) ->guid( esc_url( get_the_guid() ), [ 'isPermaLink' => 'false' ] ) ->description( '' ) ->tag( 'content:encoded' )->contains->cdata( $post->post_content )->end ->tag( 'excerpt:encoded' )->contains->cdata( $post->post_excerpt )->end ->tag( 'wp:post_id', $post->ID ) ->tag( 'wp:post_date', $post->post_date ) ->tag( 'wp:post_date_gmt', $post->post_date_gmt ) ->tag( 'wp:post_modified', $post->post_modified ) ->tag( 'wp:post_modified_gmt', $post->post_modified_gmt ) ->tag( 'wp:comment_status', $post->comment_status ) ->tag( 'wp:ping_status', $post->ping_status ) ->tag( 'wp:post_name', $post->post_name ) ->tag( 'wp:status', $post->post_status ) ->tag( 'wp:post_parent', $post->post_parent ) ->tag( 'wp:menu_order', $post->menu_order ) ->tag( 'wp:post_type', $post->post_type ) ->tag( 'wp:post_password', $post->post_password ) ->tag( 'wp:is_sticky', $post->is_sticky ) ->optional( 'wp:attachment_url', wp_get_attachment_url( $post->ID ) ); foreach ( $post->terms as $term ) { $oxymel ->category( [ 'domain' => $term->taxonomy, 'nicename' => $term->slug, ] )->contains->cdata( $term->name )->end; } foreach ( $post->meta as $meta ) { $oxymel ->tag( 'wp:postmeta' )->contains ->tag( 'wp:meta_key', $meta->meta_key ) ->tag( 'wp:meta_value' )->contains->cdata( $meta->meta_value )->end ->end; } foreach ( $post->comments as $comment ) { $oxymel ->tag( 'wp:comment' )->contains ->tag( 'wp:comment_id', $comment->comment_ID ) ->tag( 'wp:comment_author' )->contains->cdata( $comment->comment_author )->end ->tag( 'wp:comment_author_email', $comment->comment_author_email ) ->tag( 'wp:comment_author_url', esc_url( $comment->comment_author_url ) ) ->tag( 'wp:comment_author_IP', $comment->comment_author_IP ) ->tag( 'wp:comment_date', $comment->comment_date ) ->tag( 'wp:comment_date_gmt', $comment->comment_date_gmt ) ->tag( 'wp:comment_content' )->contains->cdata( $comment->comment_content )->end ->tag( 'wp:comment_approved', $comment->comment_approved ) ->tag( 'wp:comment_type', $comment->comment_type ) ->tag( 'wp:comment_parent', $comment->comment_parent ) ->tag( 'wp:comment_user_id', $comment->user_id ) ->oxymel( $this->comment_meta( $comment ) ) ->end; } $oxymel ->end; return $oxymel->to_string(); } public function footer() { $oxymel = new Oxymel(); return $oxymel->close_channel->close_rss->to_string(); } protected function terms( $terms ) { $oxymel = new WP_Export_Oxymel(); foreach ( $terms as $term ) { $term->parent_slug = $term->parent ? $terms[ $term->parent ]->slug : ''; $oxymel->tag( 'wp:term' )->contains ->tag( 'wp:term_id', $term->term_id ) ->tag( 'wp:term_taxonomy', $term->taxonomy ) ->tag( 'wp:term_slug', $term->slug ); if ( 'nav_menu' !== $term->taxonomy ) { $oxymel ->tag( 'wp:term_parent', $term->parent_slug ); } $oxymel ->optional_cdata( 'wp:term_name', $term->name ) ->optional_cdata( 'wp:term_description', $term->description ) ->end; } return $oxymel->to_string(); } protected function comment_meta( $comment ) { global $wpdb; $metas = $wpdb->get_results( $wpdb->prepare( "SELECT * FROM $wpdb->commentmeta WHERE comment_id = %d", $comment->comment_ID ) ); if ( ! $metas ) { return new Oxymel(); } $oxymel = new WP_Export_Oxymel(); foreach ( $metas as $meta ) { $oxymel->tag( 'wp:commentmeta' )->contains ->tag( 'wp:meta_key', $meta->meta_key ) ->tag( 'wp:meta_value' )->contains->cdata( $meta->meta_value )->end ->end; } return $oxymel; } } <?php abstract class WP_Export_Base_Writer { protected $formatter; public function __construct( $formatter ) { $this->formatter = $formatter; } public function export() { $this->write( $this->formatter->before_posts() ); foreach ( $this->formatter->posts() as $post_in_wxr ) { $this->write( $post_in_wxr ); } $this->write( $this->formatter->after_posts() ); } abstract protected function write( $xml ); } <?php class WP_Map_Iterator extends IteratorIterator { public function __construct( $iterator, $callback ) { $this->callback = $callback; parent::__construct( $iterator ); } #[\ReturnTypeWillChange] public function current() { $original_current = parent::current(); return call_user_func( $this->callback, $original_current ); } } <?php class WP_Post_IDs_Iterator implements Iterator { private $limit = 100; private $post_ids; private $ids_left; private $results = array(); public function __construct( $post_ids, $limit = null ) { $this->db = $GLOBALS['wpdb']; $this->post_ids = $post_ids; $this->ids_left = $post_ids; if ( ! is_null( $limit ) ) { $this->limit = $limit; } } public function current() { return $this->results[ $this->index_in_results ]; } public function key() { return $this->global_index; } public function next() { ++$this->index_in_results; ++$this->global_index; } public function rewind() { $this->results = array(); $this->global_index = 0; $this->index_in_results = 0; $this->ids_left = $this->post_ids; } public function valid() { if ( isset( $this->results[ $this->index_in_results ] ) ) { return true; } if ( empty( $this->ids_left ) ) { return false; } $has_posts = $this->load_next_posts_from_db(); if ( ! $has_posts ) { return false; } $this->index_in_results = 0; return true; } private function load_next_posts_from_db() { $next_batch_post_ids = array_splice( $this->ids_left, 0, $this->limit ); $in_post_ids_sql = _wp_export_build_IN_condition( 'ID', $next_batch_post_ids ); $this->results = $this->db->get_results( "SELECT * FROM {$this->db->posts} WHERE {$in_post_ids_sql}" ); if ( ! $this->results ) { if ( $this->db->last_error ) { throw new WP_Iterator_Exception( "Database error: {$this->db->last_error}" ); } else { return false; } } return true; } } <?php class WP_Export_Exception extends RuntimeException { } <?php class WP_Export_Split_Files_Writer extends WP_Export_Base_Writer { private $max_file_size; private $destination_directory; private $filename_template; private $before_posts_xml; private $after_posts_xml; private $f; private $next_file_number = 0; private $current_file_size = 0; private $available_sections = array( 'header', 'site_metadata', 'authors', 'categories', 'tags', 'nav_menu_terms', 'custom_taxonomies_terms', 'rss2_head_action', ); private $subsequent_sections = array(); public function __construct( $formatter, $writer_args = [] ) { parent::__construct( $formatter ); if ( ! defined( 'MB_IN_BYTES' ) ) { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedConstantFound -- WordPress native constants. define( 'MB_IN_BYTES', 1024 * 1024 ); } //TODO: check if args are not missing if ( is_null( $writer_args['max_file_size'] ) ) { $this->max_file_size = 15 * MB_IN_BYTES; } elseif ( WP_CLI_EXPORT_COMMAND_NO_SPLIT === (string) $writer_args['max_file_size'] ) { $this->max_file_size = WP_CLI_EXPORT_COMMAND_NO_SPLIT; } else { $this->max_file_size = $writer_args['max_file_size'] * MB_IN_BYTES; } // Filter and handle condition where subsequent export files should not contain // all of the export sections if ( is_array( $writer_args['include_once'] ) && ! empty( $writer_args['include_once'] ) ) { $this->subsequent_sections = array_diff( $this->available_sections, $writer_args['include_once'] ); } $this->destination_directory = $writer_args['destination_directory']; $this->filename_template = $writer_args['filename_template']; $this->before_posts_xml = $this->formatter->before_posts(); $this->after_posts_xml = $this->formatter->after_posts(); } public function export() { $this->start_new_file(); foreach ( $this->formatter->posts() as $post_xml ) { if ( WP_CLI_EXPORT_COMMAND_NO_SPLIT !== $this->max_file_size && $this->current_file_size + strlen( $post_xml ) > $this->max_file_size ) { $this->start_new_file(); } $this->write( $post_xml ); } $this->close_current_file(); } protected function write( $xml ) { $res = fwrite( $this->f, $xml ); if ( false === $res ) { throw new WP_Export_Exception( 'WP Export: error writing to export file.' ); } $this->current_file_size += strlen( $xml ); } private function start_new_file() { if ( $this->f ) { $this->close_current_file(); } $file_path = $this->next_file_path(); $this->f = fopen( $file_path, 'w' ); if ( ! $this->f ) { throw new WP_Export_Exception( "WP Export: error opening {$file_path} for writing." ); } // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Possibly used by third party extension. do_action( 'wp_export_new_file', $file_path ); $this->current_file_size = 0; $this->write( $this->before_posts_xml ); if ( 1 === $this->next_file_number && ! empty( $this->subsequent_sections ) ) { $this->before_posts_xml = $this->formatter->before_posts( $this->subsequent_sections ); } } private function close_current_file() { if ( ! $this->f ) { return; } $this->write( $this->after_posts_xml ); fclose( $this->f ); } private function next_file_name() { $next_file_name = sprintf( $this->filename_template, $this->next_file_number ); ++$this->next_file_number; return $next_file_name; } private function next_file_path() { return untrailingslashit( $this->destination_directory ) . DIRECTORY_SEPARATOR . $this->next_file_name(); } } <?php use WP_CLI\Utils; // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedConstantFound -- Changing breaks Phar compat. define( 'WP_CLI_EXPORT_COMMAND_NO_SPLIT', '-1' ); /** * Exports WordPress content to a WXR file. * * ## EXAMPLES * * # Export posts published by the user between given start and end date * $ wp export --dir=/tmp/ --user=admin --post_type=post --start_date=2011-01-01 --end_date=2011-12-31 * Starting export process... * Writing to file /tmp/staging.wordpress.2016-05-24.000.xml * Success: All done with export. * * @package wp-cli */ class Export_Command extends WP_CLI_Command { /** * Initialize the array of arguments that will be eventually be passed to export_wp. * * @var array */ public $export_args = []; private $stdout; private $max_file_size; private $include_once; private $wxr_path; /** * Exports WordPress content to a WXR file. * * Generates one or more WXR files containing authors, terms, posts, * comments, and attachments. WXR files do not include site configuration * (options) or the attachment files themselves. * * ## OPTIONS * * [--dir=<dirname>] * : Full path to directory where WXR export files should be stored. Defaults * to current working directory. * * [--stdout] * : Output the whole XML using standard output (incompatible with --dir=) * * [--skip_comments] * : Don't include comments in the WXR export file. * * [--max_file_size=<MB>] * : A single export file should have this many megabytes. -1 for unlimited. * --- * default: 15 * --- * * [--filename_format=<format>] * : Use a custom format for export filenames. Defaults to '{site}.wordpress.{date}.{n}.xml'. * * [--include_once=<before_posts>] * : Include specified export section only in the first export file. Valid options * are categories, tags, nav_menu_items, custom_taxonomies_terms. Separate multiple * sections with a comma. Defaults to none. * * [--allow_orphan_terms] * : Export orphaned terms with `parent=0`, instead of throwing an exception. * * ## FILTERS * * [--start_date=<date>] * : Export only posts published after this date, in format YYYY-MM-DD. * * [--end_date=<date>] * : Export only posts published before this date, in format YYYY-MM-DD. * * [--post_type=<post-type>] * : Export only posts with this post_type. Separate multiple post types with a * comma. * --- * default: any * --- * * [--post_type__not_in=<post-type>] * : Export all post types except those identified. Separate multiple post types * with a comma. Defaults to none. * * [--post__in=<pid>] * : Export all posts specified as a comma-separated or space-separated list of IDs. * Post's attachments won't be exported unless --with_attachments is specified. * * [--with_attachments] * : Force including attachments in case --post__in has been specified. * * [--start_id=<pid>] * : Export only posts with IDs greater than or equal to this post ID. * * [--max_num_posts=<num>] * : Export no more than <num> posts (excluding attachments). * * [--author=<author>] * : Export only posts by this author. Can be either user login or user ID. * * [--category=<name|id>] * : Export only posts in this category. * * [--post_status=<status>] * : Export only posts with this status. * * ## EXAMPLES * * # Export posts published by the user between given start and end date * $ wp export --dir=/tmp/ --user=admin --post_type=post --start_date=2011-01-01 --end_date=2011-12-31 * Starting export process... * Writing to file /tmp/staging.wordpress.2016-05-24.000.xml * Success: All done with export. * * # Export posts by IDs * $ wp export --dir=/tmp/ --post__in=123,124,125 * Starting export process... * Writing to file /tmp/staging.wordpress.2016-05-24.000.xml * Success: All done with export. * * # Export a random subset of content * $ wp export --post__in="$(wp post list --post_type=post --orderby=rand --posts_per_page=8 --format=ids)" * Starting export process... * Writing to file /var/www/example.com/public_html/staging.wordpress.2016-05-24.000.xml * Success: All done with export. */ public function __invoke( $_, $assoc_args ) { $defaults = [ 'dir' => null, 'stdout' => false, 'start_date' => null, 'end_date' => null, 'post_type' => null, 'post_type__not_in' => null, 'max_num_posts' => null, 'author' => null, 'category' => null, 'post_status' => null, 'post__in' => null, 'with_attachments' => true, // or FALSE if user requested some post__in 'start_id' => null, 'skip_comments' => null, 'max_file_size' => 15, 'filename_format' => '{site}.wordpress.{date}.{n}.xml', 'include_once' => null, 'allow_orphan_terms' => null, ]; if ( ! empty( $assoc_args['stdout'] ) && ( ! empty( $assoc_args['dir'] ) || ! empty( $assoc_args['filename_format'] ) ) ) { WP_CLI::error( '--stdout and --dir cannot be used together.' ); } if ( ! empty( $assoc_args['post__in'] ) && empty( $assoc_args['with_attachments'] ) ) { $defaults['with_attachments'] = false; } $assoc_args = wp_parse_args( $assoc_args, $defaults ); $this->validate_args( $assoc_args ); $this->export_args['with_attachments'] = Utils\get_flag_value( $assoc_args, 'with_attachments', $defaults['with_attachments'] ); if ( ! function_exists( 'wp_export' ) ) { self::load_export_api(); } if ( ! $this->stdout ) { WP_CLI::log( 'Starting export process...' ); } add_action( 'wp_export_new_file', static function ( $file_path ) { WP_CLI::log( sprintf( 'Writing to file %s', $file_path ) ); Utils\wp_clear_object_cache(); } ); try { if ( $this->stdout ) { wp_export( [ 'filters' => $this->export_args, 'writer' => 'WP_Export_File_Writer', 'writer_args' => 'php://output', ] ); } else { wp_export( [ 'filters' => $this->export_args, 'writer' => 'WP_Export_Split_Files_Writer', 'writer_args' => [ 'max_file_size' => $this->max_file_size, 'destination_directory' => $this->wxr_path, 'filename_template' => self::get_filename_template( $assoc_args['filename_format'] ), 'include_once' => $this->include_once, ], ] ); } } catch ( Exception $e ) { WP_CLI::error( $e->getMessage() ); } if ( ! $this->stdout ) { WP_CLI::success( 'All done with export.' ); } } private static function get_filename_template( $filename_format ) { $sitename = sanitize_key( get_bloginfo( 'name' ) ); if ( empty( $sitename ) ) { $sitename = 'site'; } return str_replace( [ '{site}', '{date}', '{n}' ], [ $sitename, date( 'Y-m-d' ), '%03d' ], $filename_format ); // phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date } public static function load_export_api() { require dirname( __DIR__ ) . '/functions.php'; } private function validate_args( $args ) { $has_errors = false; foreach ( $args as $key => $value ) { if ( is_callable( [ $this, 'check_' . $key ] ) ) { $result = call_user_func( [ $this, 'check_' . $key ], $value ); if ( false === $result ) { $has_errors = true; } } } if ( $args['stdout'] ) { $this->wxr_path = null; $this->stdout = true; } if ( $has_errors ) { WP_CLI::halt( 1 ); } } private function check_dir( $path ) { if ( empty( $path ) ) { $path = getcwd(); } elseif ( ! is_dir( $path ) ) { WP_CLI::error( sprintf( "The directory '%s' does not exist.", $path ) ); } elseif ( ! is_writable( $path ) ) { WP_CLI::error( sprintf( "The directory '%s' is not writable.", $path ) ); } $this->wxr_path = trailingslashit( $path ); return true; } private function check_start_date( $date ) { if ( null === $date ) { return true; } $time = strtotime( $date ); if ( ! empty( $date ) && ! $time ) { WP_CLI::warning( sprintf( 'The start_date %s is invalid.', $date ) ); return false; } $this->export_args['start_date'] = date( 'Y-m-d', $time ); // phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date return true; } private function check_end_date( $date ) { if ( null === $date ) { return true; } $time = strtotime( $date ); if ( ! empty( $date ) && ! $time ) { WP_CLI::warning( sprintf( 'The end_date %s is invalid.', $date ) ); return false; } $this->export_args['end_date'] = date( 'Y-m-d', $time ); // phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date return true; } private function check_post_type( $post_type ) { if ( null === $post_type || 'any' === $post_type ) { return true; } $post_type = array_unique( array_filter( explode( ',', $post_type ) ) ); $post_types = get_post_types(); foreach ( $post_type as $type ) { if ( ! in_array( $type, $post_types, true ) ) { WP_CLI::warning( sprintf( 'The post type %s does not exist. Choose "any" or any of these existing post types instead: %s', $type, implode( ', ', $post_types ) ) ); return false; } } $this->export_args['post_type'] = $post_type; return true; } private function check_post_type__not_in( $post_type ) { if ( null === $post_type ) { return true; } $post_type = array_unique( array_filter( explode( ',', $post_type ) ) ); $post_types = get_post_types(); foreach ( $post_type as $type ) { if ( ! in_array( $type, $post_types, true ) ) { WP_CLI::warning( sprintf( 'The post type %s does not exist. Use any of these existing post types instead: %s', $type, implode( ', ', $post_types ) ) ); return false; } } $this->export_args['post_type'] = array_diff( $post_types, $post_type ); return true; } private function check_post__in( $post__in ) { if ( null === $post__in ) { return true; } $separator = false !== stripos( $post__in, ' ' ) ? ' ' : ','; $post__in = array_filter( array_unique( array_map( 'intval', explode( $separator, $post__in ) ) ) ); if ( empty( $post__in ) ) { WP_CLI::warning( 'post__in should be comma-separated or space-separated post IDs.' ); return false; } // New exporter uses a different argument. $this->export_args['post_ids'] = $post__in; return true; } private function check_start_id( $start_id ) { if ( null === $start_id ) { return true; } $start_id = (int) $start_id; // Post IDs must be greater than 0. if ( 0 >= $start_id ) { WP_CLI::warning( "Invalid start ID: {$start_id}" ); return false; } $this->export_args['start_id'] = $start_id; return true; } private function check_author( $author ) { if ( null === $author ) { return true; } // phpcs:ignore WordPress.WP.DeprecatedFunctions.get_users_of_blogFound -- Fallback. $authors = function_exists( 'get_users' ) ? get_users() : get_users_of_blog(); if ( empty( $authors ) || is_wp_error( $authors ) ) { WP_CLI::warning( 'Could not find any authors in this blog.' ); return false; } $hit = false; foreach ( $authors as $user ) { if ( $hit ) { break; } if ( (int) $author === $user->ID || $author === $user->user_login ) { $hit = $user->ID; } } if ( false === $hit ) { $authors_nice = []; foreach ( $authors as $_author ) { $authors_nice[] = sprintf( '%s (%s)', $_author->user_login, $_author->display_name ); } WP_CLI::warning( sprintf( 'Could not find a matching author for %s. The following authors exist: %s', $author, implode( ', ', $authors_nice ) ) ); return false; } $this->export_args['author'] = $hit; return true; } private function check_max_num_posts( $num ) { if ( null !== $num && ( ! is_numeric( $num ) || $num <= 0 ) ) { WP_CLI::warning( 'max_num_posts should be a positive integer.' ); return false; } $this->export_args['max_num_posts'] = (int) $num; return true; } private function check_category( $category ) { if ( null === $category ) { return true; } if ( is_numeric( $category ) ) { $category = (int) $category; } $term = category_exists( $category ); if ( empty( $term ) || is_wp_error( $term ) ) { WP_CLI::warning( sprintf( 'Could not find a category matching %s.', $category ) ); return false; } $this->export_args['category'] = $category; return true; } private function check_post_status( $status ) { if ( null === $status ) { return true; } $stati = get_post_stati(); if ( empty( $stati ) || is_wp_error( $stati ) ) { WP_CLI::warning( 'Could not find any post stati.' ); return false; } if ( ! isset( $stati[ $status ] ) ) { WP_CLI::warning( sprintf( 'Could not find a post_status matching %s. Here is a list of available stati: %s', $status, implode( ', ', array_keys( $stati ) ) ) ); return false; } $this->export_args['status'] = $status; return true; } private function check_skip_comments( $skip ) { if ( null === $skip ) { return true; } if ( 0 !== (int) $skip && 1 !== (int) $skip ) { WP_CLI::warning( 'skip_comments needs to be 0 (no) or 1 (yes).' ); return false; } $this->export_args['skip_comments'] = $skip; return true; } private function check_max_file_size( $size ) { if ( ! is_numeric( $size ) ) { WP_CLI::warning( 'max_file_size should be numeric.' ); return false; } $this->max_file_size = $size; return true; } private function check_include_once( $once ) { if ( null === $once ) { return true; } $separator = false !== stripos( $once, ' ' ) ? ' ' : ','; $once = array_filter( array_unique( array_map( 'strtolower', explode( $separator, $once ) ) ) ); $once = array_intersect( $once, array( 'categories', 'tags', 'nav_menu_terms', 'custom_taxonomies_terms' ) ); if ( empty( $once ) ) { WP_CLI::warning( 'include_once should be comma-separated values for optional before_posts sections.' ); return false; } $this->include_once = $once; return true; } private function check_allow_orphan_terms( $allow_orphan_terms ) { if ( null === $allow_orphan_terms ) { return true; } if ( 0 !== (int) $allow_orphan_terms && 1 !== (int) $allow_orphan_terms ) { WP_CLI::warning( 'allow_orphan_terms needs to be 0 (no) or 1 (yes).' ); return false; } $this->export_args['allow_orphan_terms'] = $allow_orphan_terms; return true; } } <?php class WP_Export_Returner extends WP_Export_Base_Writer { private $result = ''; public function export() { $this->private = ''; try { parent::export(); } catch ( WP_Export_Exception $e ) { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Possibly used by third party extension. $message = apply_filters( 'export_error_message', $e->getMessage() ); return new WP_Error( 'wp-export-error', $message ); } catch ( WP_Export_Term_Exception $e ) { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Possibly used by third party extensions. do_action( 'export_term_orphaned', $this->formatter->export->missing_parents ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Possibly used by third party extension. $message = apply_filters( 'export_term_error_message', $e->getMessage() ); return new WP_Error( 'wp-export-error', $message ); } return $this->result; } protected function write( $xml ) { $this->result .= $xml; } } <?php class WP_Export_XML_Over_HTTP extends WP_Export_Base_Writer { private $file_name; public function __construct( $formatter, $file_name ) { parent::__construct( $formatter ); $this->file_name = $file_name; } public function export() { try { $export = $this->get_export(); $this->send_headers(); echo $export; } catch ( WP_Export_Exception $e ) { // phpcs:disable WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Possibly used by third party extension. $message = apply_filters( 'export_error_message', $e->getMessage() ); wp_die( $message, __( 'Export Error' ), [ 'back_link' => true ] ); } catch ( WP_Export_Term_Exception $e ) { do_action( 'export_term_orphaned', $this->formatter->export->missing_parents ); $message = apply_filters( 'export_term_error_message', $e->getMessage() ); // phpcs:enable wp_die( $message, __( 'Export Error' ), [ 'back_link' => true ] ); } } protected function write( $xml ) { $this->result .= $xml; } protected function get_export() { $this->result = ''; parent::export(); return $this->result; } protected function send_headers() { header( 'Content-Description: File Transfer' ); header( 'Content-Disposition: attachment; filename=' . $this->file_name ); header( 'Content-Type: text/xml; charset=' . get_option( 'blog_charset' ), true ); } } <?php class WP_Export_Term_Exception extends RuntimeException { } <?php class WP_Export_File_Writer extends WP_Export_Base_Writer { private $f; private $file_name; public function __construct( $formatter, $file_name ) { parent::__construct( $formatter ); $this->file_name = $file_name; } public function export() { $this->f = fopen( $this->file_name, 'w' ); if ( ! $this->f ) { throw new WP_Export_Exception( "WP Export: error opening {$this->file_name} for writing." ); } try { parent::export(); } catch ( WP_Export_Exception $e ) { fclose( $this->f ); throw $e; } catch ( WP_Export_Term_Exception $e ) { fclose( $this->f ); throw $e; } fclose( $this->f ); } protected function write( $xml ) { $res = fwrite( $this->f, $xml ); if ( false === $res ) { throw new WP_Export_Exception( 'WP Export: error writing to export file.' ); } } } <?php use WP_CLI\Utils; /** * Represents a set of posts and other site data to be exported. * * An immutable object, which gathers all data needed for the export. */ class WP_Export_Query { const QUERY_CHUNK = 100; private static $defaults = [ 'post_ids' => null, 'post_type' => null, 'status' => null, 'author' => null, 'start_date' => null, 'end_date' => null, 'start_id' => null, 'max_num_posts' => null, 'category' => null, 'allow_orphan_terms' => null, ]; private $post_ids; private $filters; private $wheres = []; private $joins = []; private $author; private $category; public $missing_parents = false; public function __construct( $filters = [] ) { $this->filters = wp_parse_args( $filters, self::$defaults ); $user = $this->find_user_from_any_object( $this->filters['author'] ); if ( $user && ! is_wp_error( $user ) ) { $this->author = $user; } $this->post_ids = $this->calculate_post_ids(); } public function post_ids() { return $this->post_ids; } public function charset() { return get_bloginfo( 'charset' ); } public function site_metadata() { $metadata = [ 'name' => $this->bloginfo_rss( 'name' ), 'url' => $this->bloginfo_rss( 'url' ), 'language' => $this->bloginfo_rss( 'language' ), 'description' => $this->bloginfo_rss( 'description' ), 'pubDate' => date( 'D, d M Y H:i:s +0000' ), // phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date 'site_url' => is_multisite() ? network_home_url() : $this->bloginfo_rss( 'url' ), 'blog_url' => $this->bloginfo_rss( 'url' ), ]; return $metadata; } public function wp_generator_tag() { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. return apply_filters( 'the_generator', get_the_generator( 'export' ), 'export' ); } public function authors() { global $wpdb; // If we're filtering by a specific author, we only need to include that // author's user object, and no other users. if ( is_object( $this->author ) && property_exists( $this->author, 'ID' ) ) { return [ $this->author ]; } $authors = []; $author_ids = (array) $wpdb->get_col( "SELECT DISTINCT post_author FROM $wpdb->posts WHERE post_status != 'auto-draft' AND post_type != 'oembed_cache'" ); foreach ( $author_ids as $author_id ) { $authors[] = get_userdata( $author_id ); } $authors = array_filter( $authors ); return $authors; } public function categories() { if ( $this->category ) { return [ $this->category ]; } if ( $this->filters['post_type'] ) { return []; } $categories = (array) get_categories( [ 'get' => 'all' ] ); $categories = $this->process_orphaned_terms( $categories ); $categories = self::topologically_sort_terms( $categories ); return $categories; } public function tags() { if ( $this->filters['post_type'] ) { return []; } $tags = (array) get_tags( [ 'get' => 'all' ] ); $tags = $this->process_orphaned_terms( $tags ); return $tags; } public function custom_taxonomies_terms() { if ( $this->filters['post_type'] ) { return []; } $custom_taxonomies = get_taxonomies( [ '_builtin' => false ] ); // phpcs:ignore WordPress.WP.DeprecatedParameters.Get_termsParam2Found -- Deprecated, but we need to support older versions of WordPress. $custom_terms = (array) get_terms( $custom_taxonomies, [ 'get' => 'all' ] ); $custom_terms = $this->process_orphaned_terms( $custom_terms ); $custom_terms = self::topologically_sort_terms( $custom_terms ); return $custom_terms; } public function nav_menu_terms() { $nav_menus = wp_get_nav_menus(); foreach ( $nav_menus as $term ) { $term->description = ''; } return $nav_menus; } public function exportify_post( $post ) { $GLOBALS['wp_query']->in_the_loop = true; $previous_global_post = Utils\get_flag_value( $GLOBALS, 'post' ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- Temporary override. $GLOBALS['post'] = $post; setup_postdata( $post ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. $post->post_content = apply_filters( 'the_content_export', $post->post_content ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. $post->post_excerpt = apply_filters( 'the_excerpt_export', $post->post_excerpt ); $post->is_sticky = is_sticky( $post->ID ) ? 1 : 0; $post->terms = self::get_terms_for_post( $post ); $post->meta = self::get_meta_for_post( $post ); $post->comments = $this->get_comments_for_post( $post ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- Revert back to original. $GLOBALS['post'] = $previous_global_post; return $post; } public function posts() { $posts_iterator = new WP_Post_IDs_Iterator( $this->post_ids, self::QUERY_CHUNK ); return new WP_Map_Iterator( $posts_iterator, [ $this, 'exportify_post' ] ); } private function calculate_post_ids() { global $wpdb; if ( is_array( $this->filters['post_ids'] ) ) { if ( $this->filters['with_attachments'] ) { $attachment_post_ids = $this->include_attachment_ids( $this->filters['post_ids'] ); $this->filters['post_ids'] = array_merge( $this->filters['post_ids'], $attachment_post_ids ); } return $this->filters['post_ids']; } $this->post_type_where(); $this->status_where(); $this->author_where(); $this->start_date_where(); $this->end_date_where(); $this->start_id_where(); $this->category_where(); $where = implode( ' AND ', array_filter( $this->wheres ) ); if ( $where ) { $where = "WHERE $where"; } $join = implode( ' ', array_filter( $this->joins ) ); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Individual where clauses run through $wpdb->prepare(). $post_ids = $wpdb->get_col( "SELECT ID FROM {$wpdb->posts} AS p {$join} {$where} {$this->max_num_posts()}" ); if ( $this->filters['post_type'] ) { $post_ids = array_merge( $post_ids, $this->include_attachment_ids( $post_ids ) ); } return $post_ids; } private function post_type_where() { $post_types_filters = [ 'can_export' => true ]; if ( $this->filters['post_type'] ) { $post_types = $this->filters['post_type']; // Flatten single post types if ( is_array( $post_types ) && 1 === count( $post_types ) ) { $post_types = array_shift( $post_types ); } $post_types_filters = array_merge( $post_types_filters, [ 'name' => $post_types ] ); } // Multiple post types if ( isset( $post_types_filters['name'] ) && is_array( $post_types_filters['name'] ) ) { $post_types = []; foreach ( $post_types_filters['name'] as $post_type ) { if ( post_type_exists( $post_type ) ) { $post_types[] = $post_type; } } } else { $post_types = get_post_types( $post_types_filters ); } if ( ! $post_types ) { $this->wheres[] = 'p.post_type IS NULL'; return; } if ( false === $this->filters['with_attachments'] && ( ! $this->filters['post_type'] || ! in_array( 'attachment', $this->filters['post_type'], true ) ) ) { unset( $post_types['attachment'] ); } $this->wheres[] = _wp_export_build_IN_condition( 'p.post_type', $post_types ); } private function status_where() { global $wpdb; if ( ! $this->filters['status'] ) { $this->wheres[] = "p.post_status != 'auto-draft'"; return; } $this->wheres[] = $wpdb->prepare( 'p.post_status = %s', $this->filters['status'] ); } private function author_where() { global $wpdb; if ( is_object( $this->author ) && property_exists( $this->author, 'ID' ) ) { $this->wheres[] = $wpdb->prepare( 'p.post_author = %d', $this->author->ID ); } } private function start_date_where() { global $wpdb; $timestamp = strtotime( $this->filters['start_date'] ); if ( ! $timestamp ) { return; } $this->wheres[] = $wpdb->prepare( 'p.post_date >= %s', date( 'Y-m-d 00:00:00', $timestamp ) ); // phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date } private function end_date_where() { global $wpdb; if ( preg_match( '/^\d{4}-\d{2}$/', $this->filters['end_date'] ) ) { $timestamp = $this->get_timestamp_for_the_last_day_of_a_month( $this->filters['end_date'] ); } else { $timestamp = strtotime( $this->filters['end_date'] ); } if ( ! $timestamp ) { return; } $this->wheres[] = $wpdb->prepare( 'p.post_date <= %s', date( 'Y-m-d 23:59:59', $timestamp ) ); // phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date } private function start_id_where() { global $wpdb; $start_id = absint( $this->filters['start_id'] ); if ( 0 === $start_id ) { return; } $this->wheres[] = $wpdb->prepare( 'p.ID >= %d', $start_id ); } private function get_timestamp_for_the_last_day_of_a_month( $yyyy_mm ) { return strtotime( "$yyyy_mm +1month -1day" ); } private function category_where() { global $wpdb; if ( 'post' !== $this->filters['post_type'] && ! in_array( 'post', (array) $this->filters['post_type'], true ) ) { return; } $category = $this->find_category_from_any_object( $this->filters['category'] ); if ( ! $category ) { return; } $this->category = $category; $this->joins[] = "INNER JOIN {$wpdb->term_relationships} AS tr ON (p.ID = tr.object_id)"; $this->wheres[] = $wpdb->prepare( 'tr.term_taxonomy_id = %d', $category->term_taxonomy_id ); } private function max_num_posts() { if ( $this->filters['max_num_posts'] > 0 ) { return "LIMIT {$this->filters['max_num_posts']}"; } else { return ''; } } private function include_attachment_ids( $post_ids ) { global $wpdb; if ( ! $post_ids ) { return []; } $attachment_ids = []; // phpcs:ignore Generic.CodeAnalysis.AssignmentInCondition.FoundInWhileCondition -- Assigment is part of the break condition. while ( $batch_of_post_ids = array_splice( $post_ids, 0, self::QUERY_CHUNK ) ) { $post_parent_condition = _wp_export_build_IN_condition( 'post_parent', $batch_of_post_ids ); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Escaped in wpcli_export_build_in_condition() function. $attachment_ids = array_merge( $attachment_ids, (array) $wpdb->get_col( "SELECT ID FROM {$wpdb->posts} WHERE post_type = 'attachment' AND {$post_parent_condition}" ) ); } return array_map( 'intval', $attachment_ids ); } private function bloginfo_rss( $section ) { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. return apply_filters( 'bloginfo_rss', get_bloginfo_rss( $section ), $section ); } private function find_user_from_any_object( $user ) { if ( is_numeric( $user ) ) { return get_user_by( 'id', $user ); } elseif ( is_string( $user ) ) { return get_user_by( 'login', $user ); } elseif ( isset( $user->ID ) ) { return get_user_by( 'id', $user->ID ); } return false; } private function find_category_from_any_object( $category ) { if ( is_numeric( $category ) ) { return get_term( $category, 'category' ); } elseif ( is_string( $category ) ) { $term = term_exists( $category, 'category' ); return isset( $term['term_id'] ) ? get_term( $term['term_id'], 'category' ) : false; } elseif ( isset( $category->term_id ) ) { return get_term( $category->term_id, 'category' ); } return false; } private static function topologically_sort_terms( $terms ) { $sorted = []; // phpcs:ignore Generic.CodeAnalysis.AssignmentInCondition.FoundInWhileCondition -- assignment is used as break condition. while ( $term = array_shift( $terms ) ) { if ( 0 === (int) $term->parent || isset( $sorted[ $term->parent ] ) ) { $sorted[ $term->term_id ] = $term; } else { $terms[] = $term; } } return $sorted; } private function process_orphaned_terms( $terms ) { $term_ids = []; $have_parent = []; $orphans = []; foreach ( $terms as $term ) { $term_ids[ $term->term_id ] = true; if ( 0 !== (int) $term->parent ) { $have_parent[] = $term; } } foreach ( $have_parent as $has_parent ) { if ( ! isset( $term_ids[ $has_parent->parent ] ) ) { if ( $this->filters['allow_orphan_terms'] ) { $orphans[ $has_parent->term_id ] = true; } else { $this->missing_parents = $has_parent; throw new WP_Export_Term_Exception( "Term is missing a parent: {$has_parent->slug} ({$has_parent->term_taxonomy_id})" ); } } } if ( ! $this->filters['allow_orphan_terms'] ) { return $terms; } if ( count( $orphans ) > 0 ) { $terms_return = []; foreach ( $terms as $term ) { if ( isset( $orphans[ $term->term_id ] ) ) { $term->parent = 0; } $terms_return[] = $term; } $terms = $terms_return; } return $terms; } private static function get_terms_for_post( $post ) { $taxonomies = get_object_taxonomies( $post->post_type ); if ( empty( $taxonomies ) ) { return []; } return wp_get_object_terms( $post->ID, $taxonomies ) ?: []; } private static function get_meta_for_post( $post ) { global $wpdb; $meta_for_export = []; $meta_from_db = $wpdb->get_results( $wpdb->prepare( "SELECT * FROM $wpdb->postmeta WHERE post_id = %d", $post->ID ) ); foreach ( $meta_from_db as $meta ) { if ( '_edit_lock' === $meta->meta_key ) { continue; } // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. if ( apply_filters( 'wxr_export_skip_postmeta', false, $meta->meta_key, $meta ) ) { continue; } $meta_for_export[] = $meta; } return $meta_for_export; } private function get_comments_for_post( $post ) { global $wpdb; if ( isset( $this->filters['skip_comments'] ) ) { return []; } $comments = $wpdb->get_results( $wpdb->prepare( "SELECT * FROM $wpdb->comments WHERE comment_post_ID = %d AND comment_approved <> 'spam'", $post->ID ) ); foreach ( $comments as $comment ) { $comment->meta = $wpdb->get_results( $wpdb->prepare( "SELECT * FROM $wpdb->commentmeta WHERE comment_id = %d", $comment->comment_ID ) ) ?: []; } return $comments; } } <?php class WP_Export_Oxymel extends Oxymel { public function optional( $tag_name, $contents ) { if ( $contents ) { $this->$tag_name( $contents ); } return $this; } public function optional_cdata( $tag_name, $contents ) { if ( $contents ) { $this->$tag_name->contains->cdata( $contents )->end; } return $this; } public function cdata( $text ) { if ( is_string( $text ) && ! seems_utf8( $text ) ) { $text = mb_convert_encoding( $text, 'UTF-8' ); } return parent::cdata( $text ); } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_export_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_export_autoloader ) ) { require_once $wpcli_export_autoloader; } WP_CLI::add_command( 'export', 'Export_Command' ); <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_cron_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_cron_autoloader ) ) { require_once $wpcli_cron_autoloader; } WP_CLI::add_command( 'cron', 'Cron_Command' ); WP_CLI::add_command( 'cron event', 'Cron_Event_Command' ); WP_CLI::add_command( 'cron schedule', 'Cron_Schedule_Command' ); <?php /** * Gets WP-Cron schedules. * * ## EXAMPLES * * # List available cron schedules * $ wp cron schedule list * +------------+-------------+----------+ * | name | display | interval | * +------------+-------------+----------+ * | hourly | Once Hourly | 3600 | * | twicedaily | Twice Daily | 43200 | * | daily | Once Daily | 86400 | * +------------+-------------+----------+ */ class Cron_Schedule_Command extends WP_CLI_Command { private $fields = array( 'name', 'display', 'interval', ); /** * List available cron schedules. * * ## OPTIONS * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--field=<field>] * : Prints the value of a single field for each schedule. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - ids * - json * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each cron schedule: * * * name * * display * * interval * * There are no additional fields. * * ## EXAMPLES * * # List available cron schedules * $ wp cron schedule list * +------------+-------------+----------+ * | name | display | interval | * +------------+-------------+----------+ * | hourly | Once Hourly | 3600 | * | twicedaily | Twice Daily | 43200 | * | daily | Once Daily | 86400 | * +------------+-------------+----------+ * * # List id of available cron schedule * $ wp cron schedule list --fields=name --format=ids * hourly twicedaily daily * * @subcommand list */ public function list_( $args, $assoc_args ) { $formatter = $this->get_formatter( $assoc_args ); $schedules = self::get_schedules(); if ( 'ids' === $formatter->format ) { echo implode( ' ', wp_list_pluck( $schedules, 'name' ) ); } else { $formatter->display_items( $schedules ); } } /** * Callback function to format a cron schedule. * * @param array $schedule The schedule. * @param string $name The schedule name. * @return array The formatted schedule. */ protected static function format_schedule( array $schedule, $name ) { $schedule['name'] = $name; return $schedule; } /** * Return a list of the cron schedules sorted according to interval. * * @return array The array of cron schedules. Each schedule is itself an array. */ protected static function get_schedules() { $schedules = wp_get_schedules(); if ( ! empty( $schedules ) ) { uasort( $schedules, 'Cron_Schedule_Command::sort' ); $schedules = array_map( 'Cron_Schedule_Command::format_schedule', $schedules, array_keys( $schedules ) ); } return $schedules; } /** * Callback function to sort the cron schedule array by interval. * */ protected static function sort( array $a, array $b ) { return $a['interval'] - $b['interval']; } private function get_formatter( &$assoc_args ) { return new \WP_CLI\Formatter( $assoc_args, $this->fields, 'schedule' ); } } <?php use WP_CLI\Utils; /** * Schedules, runs, and deletes WP-Cron events. * * ## EXAMPLES * * # Schedule a new cron event * $ wp cron event schedule cron_test * Success: Scheduled event with hook 'cron_test' for 2016-05-31 10:19:16 GMT. * * # Run all cron events due right now * $ wp cron event run --due-now * Executed the cron event 'cron_test_1' in 0.01s. * Executed the cron event 'cron_test_2' in 0.006s. * Success: Executed a total of 2 cron events. * * # Delete all scheduled cron events for the given hook * $ wp cron event delete cron_test * Success: Deleted a total of 2 cron events. * * # List scheduled cron events in JSON * $ wp cron event list --fields=hook,next_run --format=json * [{"hook":"wp_version_check","next_run":"2016-05-31 10:15:13"},{"hook":"wp_update_plugins","next_run":"2016-05-31 10:15:13"},{"hook":"wp_update_themes","next_run":"2016-05-31 10:15:14"}] * * @package wp-cli */ class Cron_Event_Command extends WP_CLI_Command { private $fields = array( 'hook', 'next_run_gmt', 'next_run_relative', 'recurrence', ); private static $time_format = 'Y-m-d H:i:s'; /** * Lists scheduled cron events. * * ## OPTIONS * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--<field>=<value>] * : Filter by one or more fields. * * [--field=<field>] * : Prints the value of a single field for each event. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - ids * - json * - count * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each cron event: * * hook * * next_run_gmt * * next_run_relative * * recurrence * * These fields are optionally available: * * time * * sig * * args * * schedule * * interval * * next_run * * ## EXAMPLES * * # List scheduled cron events * $ wp cron event list * +-------------------+---------------------+---------------------+------------+ * | hook | next_run_gmt | next_run_relative | recurrence | * +-------------------+---------------------+---------------------+------------+ * | wp_version_check | 2016-05-31 22:15:13 | 11 hours 57 minutes | 12 hours | * | wp_update_plugins | 2016-05-31 22:15:13 | 11 hours 57 minutes | 12 hours | * | wp_update_themes | 2016-05-31 22:15:14 | 11 hours 57 minutes | 12 hours | * +-------------------+---------------------+---------------------+------------+ * * # List scheduled cron events in JSON * $ wp cron event list --fields=hook,next_run --format=json * [{"hook":"wp_version_check","next_run":"2016-05-31 10:15:13"},{"hook":"wp_update_plugins","next_run":"2016-05-31 10:15:13"},{"hook":"wp_update_themes","next_run":"2016-05-31 10:15:14"}] * * @subcommand list */ public function list_( $args, $assoc_args ) { $formatter = $this->get_formatter( $assoc_args ); $events = self::get_cron_events(); if ( is_wp_error( $events ) ) { $events = array(); } foreach ( $events as $key => $event ) { foreach ( $this->fields as $field ) { if ( ! empty( $assoc_args[ $field ] ) && $event->{$field} !== $assoc_args[ $field ] ) { unset( $events[ $key ] ); break; } } } if ( 'ids' === $formatter->format ) { echo implode( ' ', wp_list_pluck( $events, 'hook' ) ); } else { $formatter->display_items( $events ); } } /** * Schedules a new cron event. * * ## OPTIONS * * <hook> * : The hook name. * * [<next-run>] * : A Unix timestamp or an English textual datetime description compatible with `strtotime()`. Defaults to now. * * [<recurrence>] * : How often the event should recur. See `wp cron schedule list` for available schedule names. Defaults to no recurrence. * * [--<field>=<value>] * : Arguments to pass to the hook for the event. <field> should be a numeric key, not a string. * * ## EXAMPLES * * # Schedule a new cron event * $ wp cron event schedule cron_test * Success: Scheduled event with hook 'cron_test' for 2016-05-31 10:19:16 GMT. * * # Schedule new cron event with hourly recurrence * $ wp cron event schedule cron_test now hourly * Success: Scheduled event with hook 'cron_test' for 2016-05-31 10:20:32 GMT. * * # Schedule new cron event and pass arguments * $ wp cron event schedule cron_test '+1 hour' --0=first-argument --1=second-argument * Success: Scheduled event with hook 'cron_test' for 2016-05-31 11:21:35 GMT. */ public function schedule( $args, $assoc_args ) { if ( count( $assoc_args ) && count( array_filter( array_keys( $assoc_args ), 'is_string' ) ) ) { WP_CLI::warning( 'Numeric keys should be used for the hook arguments.' ); } $hook = $args[0]; $next_run = Utils\get_flag_value( $args, 1, 'now' ); $recurrence = Utils\get_flag_value( $args, 2, false ); if ( empty( $next_run ) ) { $timestamp = time(); } elseif ( is_numeric( $next_run ) ) { $timestamp = absint( $next_run ); } else { $timestamp = strtotime( $next_run ); } if ( ! $timestamp ) { WP_CLI::error( sprintf( "'%s' is not a valid datetime.", $next_run ) ); } if ( ! empty( $recurrence ) ) { $schedules = wp_get_schedules(); if ( ! isset( $schedules[ $recurrence ] ) ) { WP_CLI::error( sprintf( "'%s' is not a valid schedule name for recurrence.", $recurrence ) ); } $event = wp_schedule_event( $timestamp, $recurrence, $hook, $assoc_args ); } else { $event = wp_schedule_single_event( $timestamp, $hook, $assoc_args ); } if ( false !== $event ) { WP_CLI::success( sprintf( "Scheduled event with hook '%s' for %s GMT.", $hook, date( self::$time_format, $timestamp ) ) ); //phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date } else { WP_CLI::error( 'Event not scheduled.' ); } } /** * Runs the next scheduled cron event for the given hook. * * ## OPTIONS * * [<hook>...] * : One or more hooks to run. * * [--due-now] * : Run all hooks due right now. * * [--exclude=<hooks>] * : Comma-separated list of hooks to exclude. * * [--all] * : Run all hooks. * * ## EXAMPLES * * # Run all cron events due right now * $ wp cron event run --due-now * Executed the cron event 'cron_test_1' in 0.01s. * Executed the cron event 'cron_test_2' in 0.006s. * Success: Executed a total of 2 cron events. */ public function run( $args, $assoc_args ) { $events = self::get_selected_cron_events( $args, $assoc_args ); if ( is_wp_error( $events ) ) { WP_CLI::error( $events ); } $executed = 0; foreach ( $events as $event ) { $start = microtime( true ); $result = self::run_event( $event ); $total = round( microtime( true ) - $start, 3 ); ++$executed; WP_CLI::log( sprintf( "Executed the cron event '%s' in %ss.", $event->hook, $total ) ); } $message = ( 1 === $executed ) ? 'Executed a total of %d cron event.' : 'Executed a total of %d cron events.'; WP_CLI::success( sprintf( $message, $executed ) ); } /** * Unschedules all cron events for a given hook. * * ## OPTIONS * * <hook> * : Name of the hook for which all events should be unscheduled. * * ## EXAMPLES * * # Unschedule a cron event on given hook. * $ wp cron event unschedule cron_test * Success: Unscheduled 2 events for hook 'cron_test'. */ public function unschedule( $args, $assoc_args ) { list( $hook ) = $args; if ( Utils\wp_version_compare( '4.9.0', '<' ) ) { WP_CLI::error( 'Unscheduling events is only supported from WordPress 4.9.0 onwards.' ); } $unscheduled = wp_unschedule_hook( $hook ); if ( empty( $unscheduled ) ) { $message = 'Failed to unschedule events for hook \'%1\$s.'; // If 0 event found on hook. if ( 0 === $unscheduled ) { $message = "No events found for hook '%1\$s'."; } WP_CLI::error( sprintf( $message, $hook ) ); } else { WP_CLI::success( sprintf( 'Unscheduled %1$d %2$s for hook \'%3$s\'.', $unscheduled, Utils\pluralize( 'event', $unscheduled ), $hook ) ); } } /** * Deletes all scheduled cron events for the given hook. * * ## OPTIONS * * [<hook>...] * : One or more hooks to delete. * * [--due-now] * : Delete all hooks due right now. * * [--exclude=<hooks>] * : Comma-separated list of hooks to exclude. * * [--all] * : Delete all hooks. * * ## EXAMPLES * * # Delete all scheduled cron events for the given hook * $ wp cron event delete cron_test * Success: Deleted a total of 2 cron events. */ public function delete( $args, $assoc_args ) { $events = self::get_selected_cron_events( $args, $assoc_args ); if ( is_wp_error( $events ) ) { WP_CLI::error( $events ); } $deleted = 0; foreach ( $events as $event ) { $result = self::delete_event( $event ); if ( $result ) { ++$deleted; } else { WP_CLI::warning( sprintf( "Failed to the delete the cron event '%s'.", $event->hook ) ); } } $message = sprintf( 'Deleted a total of %d %s.', $deleted, Utils\pluralize( 'cron event', $deleted ) ); WP_CLI::success( sprintf( $message, $deleted ) ); } /** * Executes an event immediately. * * @param stdClass $event The event * @return bool Whether the event was successfully executed or not. */ protected static function run_event( stdClass $event ) { if ( ! defined( 'DOING_CRON' ) ) { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedConstantFound -- Using native WordPress constant. define( 'DOING_CRON', true ); } if ( false !== $event->schedule ) { wp_reschedule_event( $event->time, $event->schedule, $event->hook, $event->args ); } wp_unschedule_event( $event->time, $event->hook, $event->args ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.DynamicHooknameFound -- Can't prefix dynamic hooks here, calling registered hooks. do_action_ref_array( $event->hook, $event->args ); return true; } /** * Deletes a cron event. * * @param stdClass $event The event * @return bool Whether the event was successfully deleted or not. */ protected static function delete_event( stdClass $event ) { $crons = _get_cron_array(); if ( ! isset( $crons[ $event->time ][ $event->hook ][ $event->sig ] ) ) { return false; } wp_unschedule_event( $event->time, $event->hook, $event->args ); return true; } /** * Callback function to format a cron event. * * @param stdClass $event The event. * @return stdClass The formatted event object. */ protected static function format_event( stdClass $event ) { $schedules = wp_get_schedules(); $event->recurrence = ( isset( $schedules[ $event->schedule ] ) ) ? self::interval( $event->interval ) : 'Non-repeating'; $event->next_run = get_date_from_gmt( date( 'Y-m-d H:i:s', $event->time ), self::$time_format ); //phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date $event->next_run_gmt = date( self::$time_format, $event->time ); //phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date $event->next_run_relative = self::interval( $event->time - time() ); return $event; } /** * Fetches an array of scheduled cron events. * * @return array|WP_Error An array of event objects, or a WP_Error object if there are no events scheduled. */ protected static function get_cron_events( $is_due_now = false ) { // wp_get_ready_cron_jobs since 5.1.0 if ( $is_due_now && function_exists( 'wp_get_ready_cron_jobs' ) ) { $crons = wp_get_ready_cron_jobs(); } else { $crons = _get_cron_array(); } $events = array(); if ( empty( $crons ) && ! $is_due_now ) { return new WP_Error( 'no_events', 'You currently have no scheduled cron events.' ); } foreach ( $crons as $time => $hooks ) { // Incorrectly registered cron events can produce a string key. if ( is_string( $time ) ) { WP_CLI::warning( sprintf( 'Ignoring incorrectly registered cron event "%s".', $time ) ); continue; } foreach ( $hooks as $hook => $hook_events ) { foreach ( $hook_events as $sig => $data ) { $events[] = (object) array( 'hook' => $hook, 'time' => $time, 'sig' => $sig, 'args' => $data['args'], 'schedule' => $data['schedule'], 'interval' => Utils\get_flag_value( $data, 'interval' ), ); } } } $events = array_map( 'Cron_Event_Command::format_event', $events ); return $events; } /** * Fetches an array of scheduled cron events selected by the user. * * @param array $args A list of event names * @param array $assoc_args An associative list of CLI parameters * * @return array|WP_Error An array of objects, or a WP_Error object is there are no events scheduled. */ protected static function get_selected_cron_events( $args, $assoc_args ) { $due_now = Utils\get_flag_value( $assoc_args, 'due-now' ); $all = Utils\get_flag_value( $assoc_args, 'all' ); $exclude = Utils\get_flag_value( $assoc_args, 'exclude' ); if ( empty( $args ) && ! $due_now && ! $all ) { WP_CLI::error( 'Please specify one or more cron events, or use --due-now/--all.' ); } if ( ! empty( $args ) && $all ) { WP_CLI::error( 'Please either specify cron events, or use --all.' ); } if ( $due_now && $all ) { WP_CLI::error( 'Please use either --due-now or --all.' ); } $events = self::get_cron_events(); if ( is_wp_error( $events ) ) { return $events; } $hooks = wp_list_pluck( $events, 'hook' ); foreach ( $args as $hook ) { if ( ! in_array( $hook, $hooks, true ) ) { WP_CLI::error( sprintf( "Invalid cron event '%s'", $hook ) ); } } // Remove all excluded hooks. if ( ! empty( $exclude ) ) { $exclude = explode( ',', $exclude ); $events = array_filter( $events, function ( $event ) use ( $exclude ) { return ! in_array( $event->hook, $exclude, true ); } ); } // If --due-now is specified, take only the events that have 'now' as // their next_run_relative time. if ( $due_now ) { $due_events = array(); foreach ( $events as $event ) { if ( ! empty( $args ) && ! in_array( $event->hook, $args, true ) ) { continue; } if ( 'now' === $event->next_run_relative ) { $due_events[] = $event; } } $events = $due_events; } elseif ( ! $all ) { // If --all is not specified, take only the events that have been // given as $args. $due_events = array(); foreach ( $events as $event ) { if ( in_array( $event->hook, $args, true ) ) { $due_events[] = $event; } } $events = $due_events; } return $events; } /** * Converts a time interval into human-readable format. * * Similar to WordPress' built-in `human_time_diff()` but returns two time period chunks instead of just one. * * @param int $since An interval of time in seconds * @return string The interval in human readable format */ private static function interval( $since ) { if ( $since <= 0 ) { return 'now'; } $since = absint( $since ); // Array of time period chunks. $chunks = array( array( 60 * 60 * 24 * 365, 'year' ), array( 60 * 60 * 24 * 30, 'month' ), array( 60 * 60 * 24 * 7, 'week' ), array( 60 * 60 * 24, 'day' ), array( 60 * 60, 'hour' ), array( 60, 'minute' ), array( 1, 'second' ), ); // we only want to output two chunks of time here, eg: // x years, xx months // x days, xx hours // so there's only two bits of calculation below: // step one: the first chunk for ( $i = 0, $j = count( $chunks ); $i < $j; $i++ ) { $seconds = $chunks[ $i ][0]; $name = $chunks[ $i ][1]; // Finding the biggest chunk (if the chunk fits, break). $count = floor( $since / $seconds ); if ( floatval( 0 ) !== $count ) { break; } } // Set output var. $output = sprintf( '%d %s', $count, Utils\pluralize( $name, absint( $count ) ) ); // Step two: the second chunk. if ( $i + 1 < $j ) { $seconds2 = $chunks[ $i + 1 ][0]; $name2 = $chunks[ $i + 1 ][1]; $count2 = floor( ( $since - ( $seconds * $count ) ) / $seconds2 ); if ( floatval( 0 ) !== $count2 ) { // Add to output var. $output .= ' ' . sprintf( '%d %s', $count2, Utils\pluralize( $name2, absint( $count2 ) ) ); } } return $output; } private function get_formatter( &$assoc_args ) { return new \WP_CLI\Formatter( $assoc_args, $this->fields, 'event' ); } } <?php /** * Tests, runs, and deletes WP-Cron events; manages WP-Cron schedules. * * ## EXAMPLES * * # Test WP Cron spawning system * $ wp cron test * Success: WP-Cron spawning is working as expected. */ class Cron_Command extends WP_CLI_Command { /** * Tests the WP Cron spawning system and reports back its status. * * This command tests the spawning system by performing the following steps: * * * Checks to see if the `DISABLE_WP_CRON` constant is set; errors if true * because WP-Cron is disabled. * * Checks to see if the `ALTERNATE_WP_CRON` constant is set; warns if true. * * Attempts to spawn WP-Cron over HTTP; warns if non 200 response code is * returned. * * ## EXAMPLES * * # Cron test runs successfully. * $ wp cron test * Success: WP-Cron spawning is working as expected. */ public function test() { if ( defined( 'DISABLE_WP_CRON' ) && DISABLE_WP_CRON ) { WP_CLI::error( 'The DISABLE_WP_CRON constant is set to true. WP-Cron spawning is disabled.' ); } if ( defined( 'ALTERNATE_WP_CRON' ) && ALTERNATE_WP_CRON ) { WP_CLI::warning( 'The ALTERNATE_WP_CRON constant is set to true. WP-Cron spawning is not asynchronous.' ); } $spawn = self::get_cron_spawn(); if ( is_wp_error( $spawn ) ) { WP_CLI::error( sprintf( 'WP-Cron spawn failed with error: %s', $spawn->get_error_message() ) ); } $code = wp_remote_retrieve_response_code( $spawn ); $message = wp_remote_retrieve_response_message( $spawn ); if ( 200 === $code ) { WP_CLI::success( 'WP-Cron spawning is working as expected.' ); } else { WP_CLI::error( sprintf( 'WP-Cron spawn returned HTTP status code: %1$s %2$s', $code, $message ) ); } } /** * Spawns a request to `wp-cron.php` and return the response. * * This function is designed to mimic the functionality in `spawn_cron()` * with the addition of returning the result of the `wp_remote_post()` * request. * * @return WP_Error|array The response or WP_Error on failure. */ protected static function get_cron_spawn() { $sslverify = \WP_CLI\Utils\wp_version_compare( 4.0, '<' ); $doing_wp_cron = sprintf( '%.22F', microtime( true ) ); $cron_request_array = array( 'url' => site_url( 'wp-cron.php?doing_wp_cron=' . $doing_wp_cron ), 'key' => $doing_wp_cron, 'args' => array( 'timeout' => 3, 'blocking' => true, // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. 'sslverify' => apply_filters( 'https_local_ssl_verify', $sslverify ), ), ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. $cron_request = apply_filters( 'cron_request', $cron_request_array ); # Enforce a blocking request in case something that's hooked onto the 'cron_request' filter sets it to false $cron_request['args']['blocking'] = true; $result = wp_remote_post( $cron_request['url'], $cron_request['args'] ); return $result; } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_maintenance_mode_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_maintenance_mode_autoloader ) ) { require_once $wpcli_maintenance_mode_autoloader; } WP_CLI::add_command( 'maintenance-mode', '\WP_CLI\MaintenanceMode\MaintenanceModeCommand' ); <?php namespace WP_CLI\MaintenanceMode; use WP_CLI; use WP_CLI_Command; use WP_Upgrader; use WP_Filesystem_Base; /** * Activates, deactivates or checks the status of the maintenance mode of a site. * * ## EXAMPLES * * # Activate Maintenance mode. * $ wp maintenance-mode activate * Enabling Maintenance mode... * Success: Activated Maintenance mode. * * # Deactivate Maintenance mode. * $ wp maintenance-mode deactivate * Disabling Maintenance mode... * Success: Deactivated Maintenance mode. * * # Display Maintenance mode status. * $ wp maintenance-mode status * Maintenance mode is active. * * # Get Maintenance mode status for scripting purpose. * $ wp maintenance-mode is-active * $ echo $? * 1 * * @when after_wp_load * @package wp-cli */ class MaintenanceModeCommand extends WP_CLI_Command { /** * Instance of WP_Upgrader. * * @var WP_Upgrader */ private $upgrader; /** * Instantiate a MaintenanceModeCommand object. */ public function __construct() { if ( ! class_exists( 'WP_Upgrader' ) ) { require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php'; } $this->upgrader = new WP_Upgrader( new WP_CLI\UpgraderSkin() ); $this->upgrader->init(); } /** * Activates maintenance mode. * * ## OPTIONS * * [--force] * : Force maintenance mode activation operation. * * ## EXAMPLES * * $ wp maintenance-mode activate * Enabling Maintenance mode... * Success: Activated Maintenance mode. */ public function activate( $_, $assoc_args ) { if ( $this->get_maintenance_mode_status() && ! WP_CLI\Utils\get_flag_value( $assoc_args, 'force' ) ) { WP_CLI::error( 'Maintenance mode already activated.' ); } $this->upgrader->maintenance_mode( true ); WP_CLI::success( 'Activated Maintenance mode.' ); } /** * Deactivates maintenance mode. * * ## EXAMPLES * * $ wp maintenance-mode deactivate * Disabling Maintenance mode... * Success: Deactivated Maintenance mode. */ public function deactivate() { if ( ! $this->get_maintenance_mode_status() ) { WP_CLI::error( 'Maintenance mode already deactivated.' ); } $this->upgrader->maintenance_mode( false ); WP_CLI::success( 'Deactivated Maintenance mode.' ); } /** * Displays maintenance mode status. * * ## EXAMPLES * * $ wp maintenance-mode status * Maintenance mode is active. */ public function status() { $status = $this->get_maintenance_mode_status() ? 'active' : 'not active'; WP_CLI::line( "Maintenance mode is {$status}." ); } /** * Detects maintenance mode status. * * ## EXAMPLES * * $ wp maintenance-mode is-active * $ echo $? * 1 * * @subcommand is-active */ public function is_active() { WP_CLI::halt( $this->get_maintenance_mode_status() ? 0 : 1 ); } /** * Returns status of maintenance mode. * * @return bool */ private function get_maintenance_mode_status() { $wp_filesystem = $this->init_wp_filesystem(); $maintenance_file = trailingslashit( $wp_filesystem->abspath() ) . '.maintenance'; if ( ! $wp_filesystem->exists( $maintenance_file ) ) { return false; } // We use the timestamp defined in the .maintenance file // to check if the maintenance is available. $upgrading = 0; $contents = $wp_filesystem->get_contents( $maintenance_file ); $matches = []; if ( preg_match( '/upgrading\s*=\s*(\d+)\s*;/i', $contents, $matches ) ) { $upgrading = (int) $matches[1]; } else { WP_CLI::warning( 'Unable to read the maintenance file timestamp, non-numeric value detected.' ); } // The logic here is based on the core WordPress `wp_is_maintenance_mode()` function. if ( ( time() - $upgrading ) >= 10 * MINUTE_IN_SECONDS ) { return false; } return true; } /** * Initializes WP_Filesystem. * * @return WP_Filesystem_Base */ protected function init_wp_filesystem() { global $wp_filesystem; WP_Filesystem(); return $wp_filesystem; } } <?php /** * Transforms a wp-config.php file. */ class WPConfigTransformer { /** * Append to end of file */ const ANCHOR_EOF = 'EOF'; /** * Path to the wp-config.php file. * * @var string */ protected $wp_config_path; /** * Original source of the wp-config.php file. * * @var string */ protected $wp_config_src; /** * Array of parsed configs. * * @var array */ protected $wp_configs = array(); /** * Instantiates the class with a valid wp-config.php. * * @throws Exception If the wp-config.php file is missing. * @throws Exception If the wp-config.php file is not writable. * * @param string $wp_config_path Path to a wp-config.php file. */ public function __construct( $wp_config_path, $read_only = false ) { $basename = basename( $wp_config_path ); if ( ! file_exists( $wp_config_path ) ) { throw new Exception( "{$basename} does not exist." ); } if ( ! $read_only && ! is_writable( $wp_config_path ) ) { throw new Exception( "{$basename} is not writable." ); } $this->wp_config_path = $wp_config_path; } /** * Checks if a config exists in the wp-config.php file. * * @throws Exception If the wp-config.php file is empty. * @throws Exception If the requested config type is invalid. * * @param string $type Config type (constant or variable). * @param string $name Config name. * * @return bool */ public function exists( $type, $name ) { $wp_config_src = file_get_contents( $this->wp_config_path ); if ( ! trim( $wp_config_src ) ) { throw new Exception( 'Config file is empty.' ); } // Normalize the newline to prevent an issue coming from OSX. $this->wp_config_src = str_replace( array( "\r\n", "\n\r", "\r" ), "\n", $wp_config_src ); $this->wp_configs = $this->parse_wp_config( $this->wp_config_src ); if ( ! isset( $this->wp_configs[ $type ] ) ) { throw new Exception( "Config type '{$type}' does not exist." ); } return isset( $this->wp_configs[ $type ][ $name ] ); } /** * Get the value of a config in the wp-config.php file. * * @throws Exception If the wp-config.php file is empty. * @throws Exception If the requested config type is invalid. * * @param string $type Config type (constant or variable). * @param string $name Config name. * * @return string|null */ public function get_value( $type, $name ) { $wp_config_src = file_get_contents( $this->wp_config_path ); if ( ! trim( $wp_config_src ) ) { throw new Exception( 'Config file is empty.' ); } $this->wp_config_src = $wp_config_src; $this->wp_configs = $this->parse_wp_config( $this->wp_config_src ); if ( ! isset( $this->wp_configs[ $type ] ) ) { throw new Exception( "Config type '{$type}' does not exist." ); } return $this->wp_configs[ $type ][ $name ]['value']; } /** * Adds a config to the wp-config.php file. * * @throws Exception If the config value provided is not a string. * @throws Exception If the config placement anchor could not be located. * * @param string $type Config type (constant or variable). * @param string $name Config name. * @param string $value Config value. * @param array $options (optional) Array of special behavior options. * * @return bool */ public function add( $type, $name, $value, array $options = array() ) { if ( ! is_string( $value ) ) { throw new Exception( 'Config value must be a string.' ); } if ( $this->exists( $type, $name ) ) { return false; } $defaults = array( 'raw' => false, // Display value in raw format without quotes. 'anchor' => "/* That's all, stop editing!", // Config placement anchor string. 'separator' => PHP_EOL, // Separator between config definition and anchor string. 'placement' => 'before', // Config placement direction (insert before or after). ); list( $raw, $anchor, $separator, $placement ) = array_values( array_merge( $defaults, $options ) ); $raw = (bool) $raw; $anchor = (string) $anchor; $separator = (string) $separator; $placement = (string) $placement; if ( self::ANCHOR_EOF === $anchor ) { $contents = $this->wp_config_src . $this->normalize( $type, $name, $this->format_value( $value, $raw ) ); } else { if ( false === strpos( $this->wp_config_src, $anchor ) ) { throw new Exception( 'Unable to locate placement anchor.' ); } $new_src = $this->normalize( $type, $name, $this->format_value( $value, $raw ) ); $new_src = ( 'after' === $placement ) ? $anchor . $separator . $new_src : $new_src . $separator . $anchor; $contents = str_replace( $anchor, $new_src, $this->wp_config_src ); } return $this->save( $contents ); } /** * Updates an existing config in the wp-config.php file. * * @throws Exception If the config value provided is not a string. * * @param string $type Config type (constant or variable). * @param string $name Config name. * @param string $value Config value. * @param array $options (optional) Array of special behavior options. * * @return bool */ public function update( $type, $name, $value, array $options = array() ) { if ( ! is_string( $value ) ) { throw new Exception( 'Config value must be a string.' ); } $defaults = array( 'add' => true, // Add the config if missing. 'raw' => false, // Display value in raw format without quotes. 'normalize' => false, // Normalize config output using WP Coding Standards. ); list( $add, $raw, $normalize ) = array_values( array_merge( $defaults, $options ) ); $add = (bool) $add; $raw = (bool) $raw; $normalize = (bool) $normalize; if ( ! $this->exists( $type, $name ) ) { return ( $add ) ? $this->add( $type, $name, $value, $options ) : false; } $old_src = $this->wp_configs[ $type ][ $name ]['src']; $old_value = $this->wp_configs[ $type ][ $name ]['value']; $new_value = $this->format_value( $value, $raw ); if ( $normalize ) { $new_src = $this->normalize( $type, $name, $new_value ); } else { $new_parts = $this->wp_configs[ $type ][ $name ]['parts']; $new_parts[1] = str_replace( $old_value, $new_value, $new_parts[1] ); // Only edit the value part. $new_src = implode( '', $new_parts ); } $contents = preg_replace( sprintf( '/(?<=^|;|<\?php\s|<\?\s)(\s*?)%s/m', preg_quote( trim( $old_src ), '/' ) ), '$1' . str_replace( '$', '\$', trim( $new_src ) ), $this->wp_config_src ); return $this->save( $contents ); } /** * Removes a config from the wp-config.php file. * * @param string $type Config type (constant or variable). * @param string $name Config name. * * @return bool */ public function remove( $type, $name ) { if ( ! $this->exists( $type, $name ) ) { return false; } if ( 'constant' === $type ) { $pattern = sprintf( "/\bdefine\s*$\s*['\"]%s['\"]\s*,\s*(('[^']*'|\"[^\"]*\")|\s*(?:[\s\S]*?))\s*$\s*;\s*/mi", preg_quote( $name, '/' ) ); } else { $pattern = sprintf( '/^\s*\$%s\s*=\s*[\s\S]*?;\s*$/mi', preg_quote( $name, '/' ) ); } $contents = preg_replace( $pattern, '', $this->wp_config_src ); return $this->save( $contents ); } /** * Applies formatting to a config value. * * @throws Exception When a raw value is requested for an empty string. * * @param string $value Config value. * @param bool $raw Display value in raw format without quotes. * * @return mixed */ protected function format_value( $value, $raw ) { if ( $raw && '' === trim( $value ) ) { throw new Exception( 'Raw value for empty string not supported.' ); } return ( $raw ) ? $value : var_export( $value, true ); } /** * Normalizes the source output for a name/value pair. * * @throws Exception If the requested config type does not support normalization. * * @param string $type Config type (constant or variable). * @param string $name Config name. * @param mixed $value Config value. * * @return string */ protected function normalize( $type, $name, $value ) { if ( 'constant' === $type ) { $placeholder = "define( '%s', %s );"; } elseif ( 'variable' === $type ) { $placeholder = '$%s = %s;'; } else { throw new Exception( "Unable to normalize config type '{$type}'." ); } return sprintf( $placeholder, $name, $value ); } /** * Parses the source of a wp-config.php file. * * @param string $src Config file source. * * @return array */ protected function parse_wp_config( $src ) { $configs = array(); $configs['constant'] = array(); $configs['variable'] = array(); // Strip comments. foreach ( token_get_all( $src ) as $token ) { if ( in_array( $token[0], array( T_COMMENT, T_DOC_COMMENT ), true ) ) { if ( '//' === $token[1] ) { // For empty line comments, actually remove empty line comments instead of all double-slashes. // See: https://github.com/wp-cli/wp-config-transformer/issues/47 $src = preg_replace( '/' . preg_quote( '//', '/' ) . '$/m', '', $src ); } else { $src = str_replace( $token[1], '', $src ); } } } preg_match_all( '/(?<=^|;|<\?php\s|<\?\s)(\h*define\s*$\s*[\'"](\w*?)[\'"]\s*)(,\s*(\'\'|""|\'.*?[^\\\\]\'|".*?[^\\\\]"|.*?)\s*)((?:,\s*(?:true|false)\s*)?$\s*;)/ims', $src, $constants ); preg_match_all( '/(?<=^|;|<\?php\s|<\?\s)(\h*\$(\w+)\s*=)(\s*(\'\'|""|\'.*?[^\\\\]\'|".*?[^\\\\]"|.*?)\s*;)/ims', $src, $variables ); if ( ! empty( $constants[0] ) && ! empty( $constants[1] ) && ! empty( $constants[2] ) && ! empty( $constants[3] ) && ! empty( $constants[4] ) && ! empty( $constants[5] ) ) { foreach ( $constants[2] as $index => $name ) { $configs['constant'][ $name ] = array( 'src' => $constants[0][ $index ], 'value' => $constants[4][ $index ], 'parts' => array( $constants[1][ $index ], $constants[3][ $index ], $constants[5][ $index ], ), ); } } if ( ! empty( $variables[0] ) && ! empty( $variables[1] ) && ! empty( $variables[2] ) && ! empty( $variables[3] ) && ! empty( $variables[4] ) ) { // Remove duplicate(s), last definition wins. $variables[2] = array_reverse( array_unique( array_reverse( $variables[2], true ) ), true ); foreach ( $variables[2] as $index => $name ) { $configs['variable'][ $name ] = array( 'src' => $variables[0][ $index ], 'value' => $variables[4][ $index ], 'parts' => array( $variables[1][ $index ], $variables[3][ $index ], ), ); } } return $configs; } /** * Saves new contents to the wp-config.php file. * * @throws Exception If the config file content provided is empty. * @throws Exception If there is a failure when saving the wp-config.php file. * * @param string $contents New config contents. * * @return bool */ protected function save( $contents ) { if ( ! trim( $contents ) ) { throw new Exception( 'Cannot save the config file with empty contents.' ); } if ( $contents === $this->wp_config_src ) { return false; } $result = file_put_contents( $this->wp_config_path, $contents, LOCK_EX ); if ( false === $result ) { throw new Exception( 'Failed to update the config file.' ); } return true; } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_extension_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_extension_autoloader ) ) { require_once $wpcli_extension_autoloader; } $wpcli_extension_requires_wp_5_5 = [ 'before_invoke' => static function () { if ( WP_CLI\Utils\wp_version_compare( '5.5', '<' ) ) { WP_CLI::error( 'Requires WordPress 5.5 or greater.' ); } }, ]; WP_CLI::add_command( 'plugin', 'Plugin_Command' ); WP_CLI::add_command( 'plugin auto-updates', 'Plugin_AutoUpdates_Command', $wpcli_extension_requires_wp_5_5 ); WP_CLI::add_command( 'theme', 'Theme_Command' ); WP_CLI::add_command( 'theme auto-updates', 'Theme_AutoUpdates_Command', $wpcli_extension_requires_wp_5_5 ); WP_CLI::add_command( 'theme mod', 'Theme_Mod_Command' ); <?php use WP_CLI\Fetchers\Theme; use WP_CLI\Formatter; use WP_CLI\ParseThemeNameInput; use WP_CLI\Utils; /** * Manages theme auto-updates. * * ## EXAMPLES * * # Enable the auto-updates for a theme * $ wp theme auto-updates enable twentysixteen * Theme auto-updates for 'twentysixteen' enabled. * Success: Enabled 1 of 1 theme auto-updates. * * # Disable the auto-updates for a theme * $ wp theme auto-updates disable twentysixteen * Theme auto-updates for 'twentysixteen' disabled. * Success: Disabled 1 of 1 theme auto-updates. * * # Get the status of theme auto-updates * $ wp theme auto-updates status twentysixteen * Auto-updates for theme 'twentysixteen' are disabled. * * @package wp-cli */ class Theme_AutoUpdates_Command { use ParseThemeNameInput; /** * Site option that stores the status of theme auto-updates. * * @var string */ const SITE_OPTION = 'auto_update_themes'; /** * Theme fetcher instance. * * @var Theme */ protected $fetcher; /** * Theme_AutoUpdates_Command constructor. */ public function __construct() { $this->fetcher = new Theme(); } /** * Enables the auto-updates for a theme. * * ## OPTIONS * * [<theme>...] * : One or more themes to enable auto-updates for. * * [--all] * : If set, auto-updates will be enabled for all themes. * * [--disabled-only] * : If set, filters list of themes to only include the ones that have * auto-updates disabled. * * ## EXAMPLES * * # Enable the auto-updates for a theme * $ wp theme auto-updates enable twentysixteen * Theme auto-updates for 'twentysixteen' enabled. * Success: Enabled 1 of 1 theme auto-updates. */ public function enable( $args, $assoc_args ) { $all = Utils\get_flag_value( $assoc_args, 'all', false ); $disabled_only = Utils\get_flag_value( $assoc_args, 'disabled-only', false ); $args = $this->check_optional_args_and_all( $args, $all ); if ( ! $args ) { return; } $themes = $this->fetcher->get_many( $args ); $auto_updates = get_site_option( static::SITE_OPTION ); if ( ! is_array( $auto_updates ) ) { $auto_updates = []; } $count = 0; $successes = 0; foreach ( $themes as $theme ) { $enabled = in_array( $theme->stylesheet, $auto_updates, true ); if ( $disabled_only && $enabled ) { continue; } ++$count; if ( $enabled ) { WP_CLI::warning( "Auto-updates already enabled for theme {$theme->stylesheet}." ); } else { $auto_updates[] = $theme->stylesheet; ++$successes; } } if ( 0 === $count ) { WP_CLI::error( 'No themes provided to enable auto-updates for.' ); } update_site_option( static::SITE_OPTION, $auto_updates ); Utils\report_batch_operation_results( 'theme auto-update', 'enable', $count, $successes, $count - $successes ); } /** * Disables the auto-updates for a theme. * * ## OPTIONS * * [<theme>...] * : One or more themes to disable auto-updates for. * * [--all] * : If set, auto-updates will be disabled for all themes. * * [--enabled-only] * : If set, filters list of themes to only include the ones that have * auto-updates enabled. * * ## EXAMPLES * * # Disable the auto-updates for a theme * $ wp theme auto-updates disable twentysixteen * Theme auto-updates for 'twentysixteen' disabled. * Success: Disabled 1 of 1 theme auto-updates. */ public function disable( $args, $assoc_args ) { $all = Utils\get_flag_value( $assoc_args, 'all', false ); $enabled_only = Utils\get_flag_value( $assoc_args, 'enabled-only', false ); $args = $this->check_optional_args_and_all( $args, $all ); if ( ! $args ) { return; } $themes = $this->fetcher->get_many( $args ); $auto_updates = get_site_option( static::SITE_OPTION ); if ( ! is_array( $auto_updates ) ) { $auto_updates = []; } $count = 0; $successes = 0; foreach ( $themes as $theme ) { $enabled = in_array( $theme->stylesheet, $auto_updates, true ); if ( $enabled_only && ! $enabled ) { continue; } ++$count; if ( ! $enabled ) { WP_CLI::warning( "Auto-updates already disabled for theme {$theme->stylesheet}." ); } else { $auto_updates = array_diff( $auto_updates, [ $theme->stylesheet ] ); ++$successes; } } if ( 0 === $count ) { WP_CLI::error( 'No themes provided to disable auto-updates for.' ); } if ( count( $auto_updates ) > 0 ) { update_site_option( static::SITE_OPTION, $auto_updates ); } else { delete_site_option( static::SITE_OPTION ); } Utils\report_batch_operation_results( 'theme auto-update', 'disable', $count, $successes, $count - $successes ); } /** * Shows the status of auto-updates for a theme. * * ## OPTIONS * * [<theme>...] * : One or more themes to show the status of the auto-updates of. * * [--all] * : If set, the status of auto-updates for all themes will be shown. * * [--enabled-only] * : If set, filters list of themes to only include the ones that have * auto-updates enabled. * * [--disabled-only] * : If set, filters list of themes to only include the ones that have * auto-updates disabled. * * [--field=<field>] * : Only show the provided field. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * - count * --- * * ## EXAMPLES * * # Get the status of theme auto-updates * $ wp theme auto-updates status twentysixteen * +---------------+----------+ * | name | status | * +---------------+----------+ * | twentysixteen | disabled | * +---------------+----------+ * * # Get the list of themes that have auto-updates enabled * $ wp theme auto-updates status --all --enabled-only --field=name * twentysixteen * twentyseventeen */ public function status( $args, $assoc_args ) { $all = Utils\get_flag_value( $assoc_args, 'all', false ); $enabled_only = Utils\get_flag_value( $assoc_args, 'enabled-only', false ); $disabled_only = Utils\get_flag_value( $assoc_args, 'disabled-only', false ); if ( $enabled_only && $disabled_only ) { WP_CLI::error( '--enabled-only and --disabled-only are mutually exclusive and ' . 'cannot be used at the same time.' ); } $args = $this->check_optional_args_and_all( $args, $all ); if ( ! $args ) { return; } $themes = $this->fetcher->get_many( $args ); $auto_updates = get_site_option( static::SITE_OPTION ); if ( ! is_array( $auto_updates ) ) { $auto_updates = []; } $results = []; foreach ( $themes as $theme ) { $enabled = in_array( $theme->stylesheet, $auto_updates, true ); if ( $enabled_only && ! $enabled ) { continue; } if ( $disabled_only && $enabled ) { continue; } $results[] = [ 'name' => $theme->stylesheet, 'status' => $enabled ? 'enabled' : 'disabled', ]; } $formatter = new Formatter( $assoc_args, [ 'name', 'status' ], 'theme' ); $formatter->display_items( $results ); } } <?php namespace WP_CLI; use WP_CLI; trait ParsePluginNameInput { /** * If have optional args ([<plugin>...]) and an all option, then check have something to do. * * @param array $args Passed-in arguments. * @param bool $all All flag. * @param string $verb Optional. Verb to use. Defaults to 'install'. * @return array Same as $args if not all, otherwise all slugs. * @param string $exclude Comma separated list of plugin slugs. * @throws ExitException If neither plugin name nor --all were provided. */ protected function check_optional_args_and_all( $args, $all, $verb = 'install', $exclude = null ) { if ( $all ) { $args = array_map( '\WP_CLI\Utils\get_plugin_name', array_keys( $this->get_all_plugins() ) ); } if ( $all && $exclude ) { $exclude_list = explode( ',', trim( $exclude, ',' ) ); $args = array_filter( $args, static function ( $slug ) use ( $exclude_list ) { return ! in_array( $slug, $exclude_list, true ); } ); } if ( empty( $args ) ) { if ( ! $all ) { WP_CLI::error( 'Please specify one or more plugins, or use --all.' ); } $past_tense_verb = Utils\past_tense_verb( $verb ); WP_CLI::success( "No plugins {$past_tense_verb}." ); // Don't error if --all given for BC. } return $args; } /** * Gets all available plugins. * * Uses the same filter core uses in plugins.php to determine which plugins * should be available to manage through the WP_Plugins_List_Table class. * * @return array */ private function get_all_plugins() { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. return apply_filters( 'all_plugins', get_plugins() ); } } <?php namespace WP_CLI; use WP_CLI; use Theme_AutoUpdates_Command; trait ParseThemeNameInput { /** * If have optional args ([<theme>...]) and an all option, then check have something to do. * * @param array $args Passed-in arguments. * @param bool $all All flag. * @param string $verb Optional. Verb to use. Defaults to 'install'. * @return array Same as $args if not all, otherwise all slugs. * @throws ExitException If neither plugin name nor --all were provided. */ protected function check_optional_args_and_all( $args, $all, $verb = 'install' ) { if ( $all ) { $args = array_map( '\WP_CLI\Utils\get_theme_name', array_keys( $this->get_all_themes() ) ); } if ( empty( $args ) ) { if ( ! $all ) { WP_CLI::error( 'Please specify one or more themes, or use --all.' ); } $past_tense_verb = Utils\past_tense_verb( $verb ); WP_CLI::success( "No themes {$past_tense_verb}." ); // Don't error if --all given for BC. } return $args; } /** * Gets all available themes. * * Uses the same filter core uses in themes.php to determine which themes * should be available to manage through the WP_Themes_List_Table class. * * @return array */ private function get_all_themes() { global $wp_version; // Extract the major WordPress version (e.g., "6.3") from the full version string list($wp_core_version) = explode( '-', $wp_version ); $wp_core_version = implode( '.', array_slice( explode( '.', $wp_core_version ), 0, 2 ) ); $items = array(); $theme_version_info = array(); if ( is_multisite() ) { $site_enabled = get_option( 'allowedthemes' ); if ( empty( $site_enabled ) ) { $site_enabled = array(); } $network_enabled = get_site_option( 'allowedthemes' ); if ( empty( $network_enabled ) ) { $network_enabled = array(); } } $all_update_info = $this->get_update_info(); $checked_themes = isset( $all_update_info->checked ) ? $all_update_info->checked : array(); if ( ! empty( $checked_themes ) ) { foreach ( $checked_themes as $slug => $version ) { $theme_version_info[ $slug ] = $this->is_theme_version_valid( $slug, $version ); } } $auto_updates = get_site_option( Theme_AutoUpdates_Command::SITE_OPTION ); if ( ! is_array( $auto_updates ) ) { $auto_updates = []; } foreach ( wp_get_themes() as $key => $theme ) { $stylesheet = $theme->get_stylesheet(); $update_info = ( isset( $all_update_info->response[ $stylesheet ] ) && null !== $all_update_info->response[ $theme->get_stylesheet() ] ) ? (array) $all_update_info->response[ $theme->get_stylesheet() ] : null; // Unlike plugin update responses, the wordpress.org API does not seem to check and filter themes that don't meet // WordPress version requirements into a separate no_updates array // Also unlike plugin update responses, the wordpress.org API seems to always include requires AND requires_php $requires = isset( $update_info ) && isset( $update_info['requires'] ) ? $update_info['requires'] : null; $requires_php = isset( $update_info ) && isset( $update_info['requires_php'] ) ? $update_info['requires_php'] : null; $compatible_php = empty( $requires_php ) || version_compare( PHP_VERSION, $requires_php, '>=' ); $compatible_wp = empty( $requires ) || version_compare( $wp_version, $requires, '>=' ); if ( ! $compatible_php ) { $update = 'unavailable'; $update_unavailable_reason = sprintf( 'This update requires PHP version %s, but the version installed is %s.', $requires_php, PHP_VERSION ); } elseif ( ! $compatible_wp ) { $update = 'unavailable'; $update_unavailable_reason = sprintf( 'This update requires WordPress version %s, but the version installed is %s.', $requires, $wp_version ); } else { $update = $update_info ? 'available' : 'none'; } // For display consistency, get these values from the current plugin file if they aren't in this response if ( null === $requires ) { $requires = ! empty( $theme->get( 'RequiresWP' ) ) ? $theme->get( 'RequiresWP' ) : ''; } if ( null === $requires_php ) { $requires_php = ! empty( $theme->get( 'RequiresPHP' ) ) ? $theme->get( 'RequiresPHP' ) : ''; } $items[ $stylesheet ] = [ 'name' => $key, 'status' => $this->get_status( $theme ), 'update' => $update, 'update_version' => isset( $update_info['new_version'] ) ? $update_info['new_version'] : null, 'update_package' => isset( $update_info['package'] ) ? $update_info['package'] : null, 'version' => $theme->get( 'Version' ), 'update_id' => $stylesheet, 'title' => $theme->get( 'Name' ), 'description' => wordwrap( $theme->get( 'Description' ) ), 'author' => $theme->get( 'Author' ), 'auto_update' => in_array( $stylesheet, $auto_updates, true ), 'requires' => $requires, 'requires_php' => $requires_php, 'update_unavailable_reason' => isset( $update_unavailable_reason ) ? $update_unavailable_reason : '', ]; // Compare version and update information in theme list. if ( isset( $theme_version_info[ $key ] ) && false === $theme_version_info[ $key ] ) { $items[ $stylesheet ]['update'] = 'version higher than expected'; } if ( is_multisite() ) { if ( ! empty( $site_enabled[ $key ] ) && ! empty( $network_enabled[ $key ] ) ) { $items[ $stylesheet ]['enabled'] = 'network,site'; } elseif ( ! empty( $network_enabled[ $key ] ) ) { $items[ $stylesheet ]['enabled'] = 'network'; } elseif ( ! empty( $site_enabled[ $key ] ) ) { $items[ $stylesheet ]['enabled'] = 'site'; } else { $items[ $stylesheet ]['enabled'] = 'no'; } } } return $items; } /** * Check if current version of the theme is higher than the one available at WP.org. * * @param string $slug Theme slug. * @param string $version Theme current version. * * @return bool|string */ protected function is_theme_version_valid( $slug, $version ) { // Get Theme Info. $theme_info = themes_api( 'theme_information', array( 'slug' => $slug ) ); // Return empty string for themes not on WP.org. if ( is_wp_error( $theme_info ) ) { return ''; } // Compare theme version info. return ! version_compare( $version, $theme_info->version, '>' ); } /** * Get the status for a given theme. * * @param WP_Theme $theme Theme to get the status for. * * @return string Status of the theme. */ protected function get_status( $theme ) { if ( $this->is_active_theme( $theme ) ) { return 'active'; } if ( $theme->get_stylesheet_directory() === get_template_directory() ) { return 'parent'; } return 'inactive'; } /** * Check whether a given theme is the active theme. * * @param WP_Theme $theme Theme to check. * * @return bool Whether the provided theme is the active theme. */ protected function is_active_theme( $theme ) { return $theme->get_stylesheet_directory() === get_stylesheet_directory(); } /** * Check whether a given theme is the active theme parent. * * @param WP_Theme $theme Theme to check. * * @return bool Whether the provided theme is the active theme. */ protected function is_active_parent_theme( $theme ) { return $theme->get_stylesheet_directory() === get_template_directory(); } /** * Get the available update info. * * @return mixed Available update info. */ protected function get_update_info() { return get_site_transient( 'update_themes' ); } } <?php namespace WP_CLI\Fetchers; use WP_CLI\Utils; /** * Fetch a WordPress theme based on one of its attributes. */ class Theme extends Base { /** * @var string $msg Error message to use when invalid data is provided */ protected $msg = "The '%s' theme could not be found."; /** * Get a theme object by name * * @param string $name * @return object|false */ public function get( $name ) { // Workaround to equalize folder naming conventions across Win/Mac/Linux. // Returns false if theme stylesheet doesn't exactly match existing themes. $existing_themes = wp_get_themes( array( 'errors' => null ) ); $existing_stylesheets = array_keys( $existing_themes ); if ( ! in_array( $name, $existing_stylesheets, true ) ) { $inexact_match = $this->find_inexact_match( $name, $existing_themes ); if ( false !== $inexact_match ) { $this->msg .= sprintf( " Did you mean '%s'?", $inexact_match ); } return false; } $theme = $existing_themes[ $name ]; return $theme; } /** * Find and return the key in $existing_themes that matches $name with * a case insensitive string comparison. * * @param string $name Name of theme received by command. * @param array $existing_themes Key/value pair of existing themes, key is * a case sensitive name. * @return string|boolean Case sensitive name if match found, otherwise false. */ private function find_inexact_match( $name, $existing_themes ) { $target = strtolower( $name ); $themes = array_map( 'strtolower', array_keys( $existing_themes ) ); if ( in_array( $target, $themes, true ) ) { return $target; } $suggestion = Utils\get_suggestion( $target, $themes ); if ( '' !== $suggestion ) { return $suggestion; } return false; } } <?php namespace WP_CLI\Fetchers; /** * Fetch a WordPress plugin based on one of its attributes. */ class Plugin extends Base { /** * @var string $msg Error message to use when invalid data is provided */ protected $msg = "The '%s' plugin could not be found."; /** * Get a plugin object by name * * @param string $name * @return object|false */ public function get( $name ) { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. foreach ( apply_filters( 'all_plugins', get_plugins() ) as $file => $_ ) { if ( "$name.php" === $file || ( $name && $file === $name ) || ( dirname( $file ) === $name && '.' !== $name ) ) { return (object) compact( 'name', 'file' ); } } return false; } } <?php namespace WP_CLI; /** * A theme upgrader class that clears the destination directory. */ class DestructiveThemeUpgrader extends \Theme_Upgrader { public function install_package( $args = array() ) { parent::upgrade_strings(); // Needed for the 'remove_old' string. $args['clear_destination'] = true; $args['abort_if_destination_exists'] = false; return parent::install_package( $args ); } } <?php namespace WP_CLI; /** * A plugin upgrader class that clears the destination directory. */ class DestructivePluginUpgrader extends \Plugin_Upgrader { public function install_package( $args = array() ) { parent::upgrade_strings(); // Needed for the 'remove_old' string. $args['clear_destination'] = true; $args['abort_if_destination_exists'] = false; return parent::install_package( $args ); } } <?php namespace WP_CLI; use Composer\Semver\VersionParser; use Composer\Semver\Comparator; use Exception; use WP_CLI; use WP_CLI\Fetchers; use WP_CLI\Loggers; use WP_CLI\Utils; use WP_Error; abstract class CommandWithUpgrade extends \WP_CLI_Command { protected $fetcher; protected $item_type; protected $obj_fields; protected $upgrade_refresh; protected $upgrade_transient; protected $chained_command = false; /** * The GitHub Releases public api endpoint. * * @var string */ private $github_releases_api_endpoint = 'https://api.github.com/repos/%s/releases'; /** * The GitHub latest release url format. * * @var string */ private $github_latest_release_url = '/^https:\/\/github\.com\/(.*)\/releases\/latest\/?$/'; // Invalid version message. const INVALID_VERSION_MESSAGE = 'version higher than expected'; public function __construct() { // Do not automatically check translations updates after updating plugins/themes. add_action( 'upgrader_process_complete', function () { remove_action( 'upgrader_process_complete', [ 'Language_Pack_Upgrader', 'async_upgrade' ], 20 ); }, 1 ); add_filter( 'http_request_timeout', function () { return 1 * MINUTE_IN_SECONDS; }, 999 ); $this->fetcher = new Fetchers\Plugin(); } abstract protected function get_upgrader_class( $force ); abstract protected function get_item_list(); /** * @param array List of update candidates * @param array List of item names * @return array List of update candidates */ abstract protected function filter_item_list( $items, $args ); abstract protected function get_all_items(); abstract protected function get_status( $file ); abstract protected function status_single( $args ); abstract protected function install_from_repo( $slug, $assoc_args ); public function status( $args ) { // Force WordPress to check for updates. call_user_func( $this->upgrade_refresh ); if ( empty( $args ) ) { $this->status_all(); } else { $this->status_single( $args ); } } private function status_all() { $items = $this->get_all_items(); $n = count( $items ); WP_CLI::log( sprintf( '%d installed %s:', $n, Utils\pluralize( $this->item_type, absint( $n ) ) ) ); $padding = $this->get_padding( $items ); foreach ( $items as $file => $details ) { if ( 'available' === $details['update'] ) { $line = ' %yU%n'; } else { $line = ' '; } $line .= $this->format_status( $details['status'], 'short' ); $line .= ' ' . str_pad( $details['name'], $padding ) . '%n'; if ( ! empty( $details['version'] ) ) { $line .= ' ' . $details['version']; } WP_CLI::line( WP_CLI::colorize( $line ) ); } WP_CLI::line(); $this->show_legend( $items ); } private function get_padding( $items ) { $max_len = 0; foreach ( $items as $details ) { $len = strlen( $details['name'] ); if ( $len > $max_len ) { $max_len = $len; } } return $max_len; } private function show_legend( $items ) { $statuses = array_unique( wp_list_pluck( $items, 'status' ) ); $legend_line = array(); foreach ( $statuses as $status ) { $legend_line[] = sprintf( '%s%s = %s%%n', $this->get_color( $status ), $this->map['short'][ $status ], $this->map['long'][ $status ] ); } if ( in_array( 'available', wp_list_pluck( $items, 'update' ), true ) ) { $legend_line[] = '%yU = Update Available%n'; } WP_CLI::line( 'Legend: ' . WP_CLI::colorize( implode( ', ', $legend_line ) ) ); } public function install( $args, $assoc_args ) { $successes = 0; $errors = 0; foreach ( $args as $slug ) { if ( empty( $slug ) ) { WP_CLI::warning( 'Ignoring ambiguous empty slug value.' ); continue; } $result = false; $is_remote = false !== strpos( $slug, '://' ); if ( $is_remote ) { $github_repo = $this->get_github_repo_from_releases_url( $slug ); if ( $github_repo ) { $version = $this->get_the_latest_github_version( $github_repo ); if ( is_wp_error( $version ) ) { WP_CLI::error( $version->get_error_message() ); } /** * Sets the $slug that will trigger the installation based on a zip file. */ $slug = $version['url']; WP_CLI::log( 'Latest release resolved to ' . $version['name'] ); } } // Check if a URL to a remote or local zip has been specified. if ( $is_remote || ( pathinfo( $slug, PATHINFO_EXTENSION ) === 'zip' && is_file( $slug ) ) ) { // Install from local or remote zip file. $file_upgrader = $this->get_upgrader( $assoc_args ); $filter = false; // If a GitHub URL, do some guessing as to the correct plugin/theme directory. if ( $is_remote && 'github.com' === $this->parse_url_host_component( $slug, PHP_URL_HOST ) // Don't attempt to rename ZIPs uploaded to the releases page or coming from a raw source. && ! preg_match( '#github\.com/[^/]+/[^/]+/(?:releases/download|raw)/#', $slug ) ) { $filter = function ( $source ) use ( $slug ) { $slug_dir = Utils\basename( $this->parse_url_host_component( $slug, PHP_URL_PATH ), '.zip' ); // Don't use the zip name if archive attached to release, as name likely to contain version tag/branch. if ( preg_match( '#github\.com/[^/]+/([^/]+)/archive/#', $slug, $matches ) ) { // Note this will be wrong if the project name isn't the same as the plugin/theme slug name. $slug_dir = $matches[1]; } $source_dir = Utils\basename( $source ); // `$source` is trailing-slashed path to the unzipped archive directory, so basename returns the unslashed directory. if ( $source_dir === $slug_dir ) { return $source; } $new_path = substr_replace( $source, $slug_dir, strrpos( $source, $source_dir ), strlen( $source_dir ) ); if ( $GLOBALS['wp_filesystem']->move( $source, $new_path ) ) { WP_CLI::log( sprintf( "Renamed Github-based project from '%s' to '%s'.", $source_dir, $slug_dir ) ); return $new_path; } return new WP_Error( 'wpcli_install_github', "Couldn't move Github-based project to appropriate directory." ); }; add_filter( 'upgrader_source_selection', $filter, 10 ); } // Add item to cache allowlist if it matches certain URL patterns. self::maybe_cache( $slug, $this->item_type ); if ( $file_upgrader->install( $slug ) ) { $slug = $file_upgrader->result['destination_name']; $result = true; if ( $filter ) { remove_filter( 'upgrader_source_selection', $filter, 10 ); } ++$successes; } else { ++$errors; } } else { // Assume a plugin/theme slug from the WordPress.org repository has been specified. $result = $this->install_from_repo( $slug, $assoc_args ); if ( is_null( $result ) ) { ++$errors; } elseif ( is_wp_error( $result ) ) { $key = $result->get_error_code(); if ( in_array( $key, [ 'plugins_api_failed', 'themes_api_failed' ], true ) && ! empty( $result->error_data[ $key ] ) && in_array( $result->error_data[ $key ], [ 'N;', 'b:0;' ], true ) ) { WP_CLI::warning( "Couldn't find '$slug' in the WordPress.org {$this->item_type} directory." ); ++$errors; } else { WP_CLI::warning( "$slug: " . $result->get_error_message() ); if ( 'already_installed' !== $key ) { ++$errors; } } } else { ++$successes; } } // Check extension is available or not. $extension = $this->fetcher->get_many( array( $slug ) ); // If installation goes well $result will be true. $allow_activation = $result; // Allow installation for installed extension. if ( is_wp_error( $result ) && 'already_installed' === $result->get_error_code() ) { $allow_activation = true; } if ( true === $allow_activation && count( $extension ) > 0 ) { $this->chained_command = true; if ( Utils\get_flag_value( $assoc_args, 'activate-network' ) ) { WP_CLI::log( "Network-activating '$slug'..." ); $this->activate( array( $slug ), array( 'network' => true ) ); } if ( Utils\get_flag_value( $assoc_args, 'activate' ) ) { WP_CLI::log( "Activating '$slug'..." ); $this->activate( array( $slug ) ); } $this->chained_command = false; } } Utils\report_batch_operation_results( $this->item_type, 'install', count( $args ), $successes, $errors ); } /** * Prepare an API response for downloading a particular version of an item. * * @param object $response wordpress.org API response * @param string $version The desired version of the package */ protected static function alter_api_response( $response, $version ) { if ( $response->version === $version ) { return; } // WordPress.org forces https, but still sometimes returns http // See https://twitter.com/nacin/status/512362694205140992 $response->download_link = str_replace( 'http://', 'https://', $response->download_link ); list( $link ) = explode( $response->slug, $response->download_link ); if ( false !== strpos( $response->download_link, '/theme/' ) ) { $download_type = 'theme'; } elseif ( false !== strpos( $response->download_link, '/plugin/' ) ) { $download_type = 'plugin'; } else { $download_type = 'plugin/theme'; } if ( 'dev' === $version ) { $response->download_link = $link . $response->slug . '.zip'; $response->version = 'Development Version'; } else { $response->download_link = $link . $response->slug . '.' . $version . '.zip'; $response->version = $version; // Check if the requested version exists. $response = wp_remote_head( $response->download_link ); $response_code = wp_remote_retrieve_response_code( $response ); if ( 200 !== (int) $response_code ) { if ( is_wp_error( $response ) ) { $error_msg = $response->get_error_message(); } else { $error_msg = sprintf( 'HTTP code %d', $response_code ); } WP_CLI::error( sprintf( "Can't find the requested %s's version %s in the WordPress.org %s repository (%s).", $download_type, $version, $download_type, $error_msg ) ); } } } protected function get_upgrader( $assoc_args ) { $force = (bool) Utils\get_flag_value( $assoc_args, 'force', false ); $insecure = (bool) Utils\get_flag_value( $assoc_args, 'insecure', false ); $upgrader_class = $this->get_upgrader_class( $force ); return Utils\get_upgrader( $upgrader_class, $insecure ); } protected function update_many( $args, $assoc_args ) { call_user_func( $this->upgrade_refresh ); if ( ! empty( $assoc_args['format'] ) && in_array( $assoc_args['format'], [ 'json', 'csv' ], true ) ) { $logger = new Loggers\Quiet( WP_CLI::get_runner()->in_color() ); WP_CLI::set_logger( $logger ); } if ( ! Utils\get_flag_value( $assoc_args, 'all' ) && empty( $args ) ) { WP_CLI::error( "Please specify one or more {$this->item_type}s, or use --all." ); } if ( Utils\get_flag_value( $assoc_args, 'minor' ) && Utils\get_flag_value( $assoc_args, 'patch' ) ) { WP_CLI::error( '--minor and --patch cannot be used together.' ); } $items = $this->get_item_list(); $errors = 0; $skipped = 0; if ( ! Utils\get_flag_value( $assoc_args, 'all' ) ) { $items = $this->filter_item_list( $items, $args ); $errors = count( $args ) - count( $items ); } $items_to_update = array_filter( $items, function ( $item ) { return isset( $item['update'] ) && 'none' !== $item['update']; } ); $minor = (bool) Utils\get_flag_value( $assoc_args, 'minor', false ); $patch = (bool) Utils\get_flag_value( $assoc_args, 'patch', false ); if ( in_array( $this->item_type, [ 'plugin', 'theme' ], true ) && ( $minor || $patch ) ) { $type = $minor ? 'minor' : 'patch'; $insecure = (bool) Utils\get_flag_value( $assoc_args, 'insecure', false ); $items_to_update = self::get_minor_or_patch_updates( $items_to_update, $type, $insecure, true, $this->item_type ); } $exclude = Utils\get_flag_value( $assoc_args, 'exclude' ); if ( isset( $exclude ) ) { $exclude_items = explode( ',', trim( $assoc_args['exclude'], ',' ) ); unset( $assoc_args['exclude'] ); foreach ( $exclude_items as $item ) { if ( 'plugin' === $this->item_type ) { $plugin = $this->fetcher->get( $item ); if ( ! $plugin ) { continue; } unset( $items_to_update[ $plugin->file ] ); } elseif ( 'theme' === $this->item_type ) { $theme = wp_get_theme( $item ); if ( $theme->exists() ) { unset( $items_to_update[ $theme->get_stylesheet() ] ); } } } } // Check for items to update and remove extensions that have version higher than expected. foreach ( $items_to_update as $item_key => $item_info ) { if ( static::INVALID_VERSION_MESSAGE === $item_info['update'] ) { WP_CLI::warning( "{$item_info['name']}: " . static::INVALID_VERSION_MESSAGE . '.' ); ++$skipped; unset( $items_to_update[ $item_key ] ); } if ( 'unavailable' === $item_info['update'] ) { WP_CLI::warning( "{$item_info['name']}: {$item_info['update_unavailable_reason']}" ); ++$skipped; unset( $items_to_update[ $item_key ] ); } } if ( Utils\get_flag_value( $assoc_args, 'dry-run' ) ) { if ( empty( $items_to_update ) ) { WP_CLI::log( "No {$this->item_type} updates available." ); if ( null !== $exclude ) { WP_CLI::log( "Skipped updates for: $exclude" ); } return; } if ( ! empty( $assoc_args['format'] ) && in_array( $assoc_args['format'], [ 'json', 'csv' ], true ) ) { Utils\format_items( $assoc_args['format'], $items_to_update, [ 'name', 'status', 'version', 'update_version' ] ); } elseif ( ! empty( $assoc_args['format'] ) && 'summary' === $assoc_args['format'] ) { WP_CLI::log( "Available {$this->item_type} updates:" ); foreach ( $items_to_update as $item_to_update => $info ) { WP_CLI::log( "{$info['title']} update from version {$info['version']} to version {$info['update_version']}" ); } } else { WP_CLI::log( "Available {$this->item_type} updates:" ); Utils\format_items( 'table', $items_to_update, [ 'name', 'status', 'version', 'update_version' ] ); } if ( null !== $exclude ) { WP_CLI::log( "Skipped updates for: $exclude" ); } return; } $result = array(); // Only attempt to update if there is something to update. if ( ! empty( $items_to_update ) ) { $cache_manager = WP_CLI::get_http_cache_manager(); foreach ( $items_to_update as $item ) { $cache_manager->whitelist_package( $item['update_package'], $this->item_type, $item['name'], $item['update_version'] ); } $upgrader = $this->get_upgrader( $assoc_args ); // Ensure the upgrader uses the download offer present in each item. $transient_filter = function ( $transient ) use ( $items_to_update ) { foreach ( $items_to_update as $name => $item_data ) { if ( isset( $transient->response[ $name ] ) ) { if ( is_object( $transient->response[ $name ] ) ) { $transient->response[ $name ]->new_version = $item_data['update_version']; $transient->response[ $name ]->package = $item_data['update_package']; } else { $transient->response[ $name ]['new_version'] = $item_data['update_version']; $transient->response[ $name ]['package'] = $item_data['update_package']; } } } return $transient; }; add_filter( 'site_transient_' . $this->upgrade_transient, $transient_filter, 999 ); $result = $upgrader->bulk_upgrade( wp_list_pluck( $items_to_update, 'update_id' ) ); remove_filter( 'site_transient_' . $this->upgrade_transient, $transient_filter, 999 ); } // Let the user know the results. $num_to_update = count( $items_to_update ); $num_updated = count( array_filter( $result, static function ( $result ) { return $result && ! is_wp_error( $result ); } ) ); if ( $num_to_update > 0 ) { if ( ! empty( $assoc_args['format'] ) && 'summary' === $assoc_args['format'] ) { foreach ( $items_to_update as $item_to_update => $info ) { $message = null !== $result[ $info['update_id'] ] ? 'updated successfully' : 'did not update'; WP_CLI::log( "{$info['title']} {$message} from version {$info['version']} to version {$info['update_version']}" ); } } else { $status = array(); foreach ( $items_to_update as $item_to_update => $info ) { $status[ $item_to_update ] = [ 'name' => $info['name'], 'old_version' => $info['version'], 'new_version' => $info['update_version'], 'status' => ( null !== $result[ $info['update_id'] ] && ! is_wp_error( $result[ $info['update_id'] ] ) ) ? 'Updated' : 'Error', ]; if ( null === $result[ $info['update_id'] ] || is_wp_error( $result[ $info['update_id'] ] ) ) { ++$errors; } } $format = 'table'; if ( ! empty( $assoc_args['format'] ) && in_array( $assoc_args['format'], [ 'json', 'csv' ], true ) ) { $format = $assoc_args['format']; } Utils\format_items( $format, $status, [ 'name', 'old_version', 'new_version', 'status' ] ); } } $total_updated = Utils\get_flag_value( $assoc_args, 'all' ) ? $num_to_update : count( $args ); if ( 0 === $num_updated && $skipped ) { $errors = $skipped; $skipped = null; } Utils\report_batch_operation_results( $this->item_type, 'update', $total_updated, $num_updated, $errors, $skipped ); if ( null !== $exclude ) { WP_CLI::log( "Skipped updates for: $exclude" ); } } // phpcs:ignore PSR2.Methods.MethodDeclaration.Underscore -- Whitelisting to provide backward compatibility to classes possibly extending this class. protected function _list( $_, $assoc_args ) { // Force WordPress to check for updates if `--skip-update-check` is not passed. if ( false === (bool) Utils\get_flag_value( $assoc_args, 'skip-update-check', false ) ) { delete_site_transient( $this->upgrade_transient ); call_user_func( $this->upgrade_refresh ); } $all_items = $this->get_all_items(); if ( false !== (bool) Utils\get_flag_value( $assoc_args, 'recently-active', false ) ) { $all_items = array_filter( $all_items, function ( $value ) { return isset( $value['recently_active'] ) && true === $value['recently_active']; } ); } if ( ! is_array( $all_items ) ) { WP_CLI::error( "No {$this->item_type}s found." ); } foreach ( $all_items as $key => &$item ) { if ( empty( $item['version'] ) ) { $item['version'] = ''; } if ( empty( $item['update_version'] ) ) { $item['update_version'] = ''; } foreach ( $item as $field => &$value ) { if ( 'update' === $field ) { // If an update is unavailable, make sure to also show these fields which will explain why if ( 'unavailable' === $value ) { if ( ! in_array( 'requires', $this->obj_fields, true ) ) { array_push( $this->obj_fields, 'requires' ); } if ( ! in_array( 'requires_php', $this->obj_fields, true ) ) { array_push( $this->obj_fields, 'requires_php' ); } } } elseif ( 'auto_update' === $field ) { if ( true === $value ) { $value = 'on'; } elseif ( false === $value ) { $value = 'off'; } } } foreach ( $this->obj_fields as $field ) { if ( ! array_key_exists( $field, $assoc_args ) ) { continue; } // This can be either a value to filter by or a comma-separated list of values. // Also, it is not forbidden for a value to contain a comma (in which case we can filter only by one). $field_filter = $assoc_args[ $field ]; if ( $item[ $field ] !== $field_filter && ! in_array( $item[ $field ], array_map( 'trim', explode( ',', $field_filter ) ), true ) ) { unset( $all_items[ $key ] ); } } } $formatter = $this->get_formatter( $assoc_args ); $formatter->display_items( $all_items ); } /** * Check whether an item has an update available or not. * * @param string $slug The plugin/theme slug * * @return bool */ protected function has_update( $slug ) { $update_list = get_site_transient( $this->upgrade_transient ); return isset( $update_list->response[ $slug ] ); } /** * Get the available update info * * @return mixed */ protected function get_update_info() { return get_site_transient( $this->upgrade_transient ); } private $map = [ 'short' => [ 'inactive' => 'I', 'active' => 'A', 'active-network' => 'N', 'must-use' => 'M', 'parent' => 'P', 'dropin' => 'D', ], 'long' => [ 'inactive' => 'Inactive', 'active' => 'Active', 'active-network' => 'Network Active', 'must-use' => 'Must Use', 'parent' => 'Parent', 'dropin' => 'Drop-In', ], ]; protected function format_status( $status, $format ) { return $this->get_color( $status ) . $this->map[ $format ][ $status ]; } private function get_color( $status ) { static $colors = [ 'inactive' => '', 'active' => '%g', 'active-network' => '%g', 'must-use' => '%c', 'parent' => '%p', 'dropin' => '%B', ]; return $colors[ $status ]; } /** * Get the minor or patch version for plugins and themes with available updates * * @param array $items Items with updates. * @param string $type Either 'minor' or 'patch'. * @param bool $insecure Whether to retry without certificate validation on TLS handshake failure. * @param bool $require_stable Whether to require stable version when comparing versions. * @param string $item_type Item type, either 'plugin' or 'theme'. * @return array */ private function get_minor_or_patch_updates( $items, $type, $insecure, $require_stable, $item_type ) { $wp_org_api = new WpOrgApi( [ 'insecure' => $insecure ] ); foreach ( $items as $i => $item ) { try { $data = call_user_func( [ $wp_org_api, "get_{$item_type}_info" ], $item['name'], // The default. 'en_US', // We are only interested in the versions field. [ 'versions' => true ] ); } catch ( Exception $exception ) { unset( $items[ $i ] ); continue; } // No minor or patch versions to access. if ( empty( $data['versions'] ) ) { unset( $items[ $i ] ); continue; } $update_version = false; $update_package = false; foreach ( $data['versions'] as $version => $download_link ) { try { $update_type = Utils\get_named_sem_ver( $version, $item['version'] ); } catch ( \Exception $e ) { continue; } // Compared version must be older. if ( ! $update_type ) { continue; } // Only permit 'patch' for 'patch'. if ( 'patch' === $type && 'patch' !== $update_type ) { continue; } // Permit 'minor' or 'patch' for 'minor' phpcs:ignore Squiz.PHP.CommentedOutCode.Found -- False positive. if ( 'minor' === $type && ! in_array( $update_type, array( 'minor', 'patch' ), true ) ) { continue; } if ( $require_stable && 'stable' !== VersionParser::parseStability( $version ) ) { continue; } if ( $update_version && ! Comparator::greaterThan( $version, $update_version ) ) { continue; } $update_version = $version; $update_package = $download_link; } // If there's not a matching version, bail on updates. if ( ! $update_version ) { unset( $items[ $i ] ); continue; } $items[ $i ]['update_version'] = $update_version; $items[ $i ]['update_package'] = $update_package; } return $items; } /** * Search wordpress.org repo. * * @param array $args A arguments array containing the search term in the first element. * @param array $assoc_args Data passed in from command. */ // phpcs:ignore PSR2.Methods.MethodDeclaration.Underscore -- Whitelisting to provide backward compatibility to classes possibly extending this class. protected function _search( $args, $assoc_args ) { $term = $args[0]; $defaults = [ 'per-page' => 10, 'page' => 1, 'fields' => implode( ',', [ 'name', 'slug', 'rating' ] ), ]; $assoc_args = array_merge( $defaults, $assoc_args ); $fields = array(); foreach ( explode( ',', $assoc_args['fields'] ) as $field ) { $fields[ $field ] = true; } $format = ! empty( $assoc_args['format'] ) ? $assoc_args['format'] : 'table'; $formatter = $this->get_formatter( $assoc_args ); $api_args = [ 'per_page' => (int) $assoc_args['per-page'], 'page' => (int) $assoc_args['page'], 'search' => $term, 'fields' => $fields, ]; if ( 'plugin' === $this->item_type ) { $api = plugins_api( 'query_plugins', $api_args ); } else { $api = themes_api( 'query_themes', $api_args ); } if ( is_wp_error( $api ) ) { WP_CLI::error( $api->get_error_message() . __( ' Try again' ) ); } $plural = $this->item_type . 's'; if ( ! isset( $api->$plural ) ) { WP_CLI::error( __( 'API error. Try Again.' ) ); } $items = $api->$plural; // Add `url` for plugin or theme on wordpress.org. foreach ( $items as $index => $item_object ) { if ( $item_object instanceof \stdClass ) { $item_object->url = "https://wordpress.org/{$plural}/{$item_object->slug}/"; } } if ( 'table' === $format ) { $count = Utils\get_flag_value( $api->info, 'results', 'unknown' ); WP_CLI::success( sprintf( 'Showing %s of %s %s.', count( $items ), $count, $plural ) ); } $formatter->display_items( $items ); } protected function get_formatter( &$assoc_args ) { return new \WP_CLI\Formatter( $assoc_args, $this->obj_fields, $this->item_type ); } /** * Error handler to ignore failures on accessing SSL "https://api.wordpress.org/themes/update-check/1.1/" in `wp_update_themes()` * and "https://api.wordpress.org/plugins/update-check/1.1/" in `wp_update_plugins()` which seem to occur intermittently. */ public static function error_handler( $errno, $errstr, $errfile, $errline, $errcontext = null ) { // If ignoring E_USER_WARNING | E_USER_NOTICE, default. if ( ! ( error_reporting() & $errno ) ) { return false; } // If not in "wp-includes/update.php", default. $update_php = 'wp-includes/update.php'; if ( 0 !== substr_compare( $errfile, $update_php, -strlen( $update_php ) ) ) { return false; } // Else assume it's in `wp_update_themes()` or `wp_update_plugins()` and just ignore it. return true; } /** * Retrieves PHP_URL_HOST component from URL. * * @param int $component The component to retrieve. * * @return string */ private function parse_url_host_component( $url, $component ) { // phpcs:ignore WordPress.WP.AlternativeFunctions.parse_url_parse_url -- parse_url will only be used in absence of wp_parse_url. return function_exists( 'wp_parse_url' ) ? wp_parse_url( $url, $component ) : parse_url( $url, $component ); } /** * Add versioned GitHub URLs to cache allowlist. * * @param string $url The URL to check. */ protected static function maybe_cache( $url, $item_type ) { $matches = []; // cache release URLs like `https://github.com/wp-cli-test/generic-example-plugin/releases/download/v0.1.0/generic-example-plugin.0.1.0.zip` if ( preg_match( '#github\.com/[^/]+/([^/]+)/releases/download/v?([^/]+)/.+\.zip#', $url, $matches ) ) { WP_CLI::get_http_cache_manager()->whitelist_package( $url, $item_type, $matches[1], $matches[2] ); // cache archive URLs like `https://github.com/wp-cli-test/generic-example-plugin/archive/v0.1.0.zip` } elseif ( preg_match( '#github\.com/[^/]+/([^/]+)/archive/(version/|)v?([^/]+)\.zip#', $url, $matches ) ) { WP_CLI::get_http_cache_manager()->whitelist_package( $url, $item_type, $matches[1], $matches[3] ); // cache release URLs like `https://api.github.com/repos/danielbachhuber/one-time-login/zipball/v0.4.0` } elseif ( preg_match( '#api\.github\.com/repos/[^/]+/([^/]+)/zipball/v?([^/]+)#', $url, $matches ) ) { WP_CLI::get_http_cache_manager()->whitelist_package( $url, $item_type, $matches[1], $matches[2] ); } } /** * Get the latest package version based on a given repo slug. * * @param string $repo_slug * * @return array{ name: string, url: string }|\WP_Error */ protected function get_the_latest_github_version( $repo_slug ) { $api_url = sprintf( $this->github_releases_api_endpoint, $repo_slug ); $token = getenv( 'GITHUB_TOKEN' ); $request_arguments = $token ? [ 'headers' => 'Authorization: Bearer ' . getenv( 'GITHUB_TOKEN' ) ] : []; $response = \wp_remote_get( $api_url, $request_arguments ); if ( \is_wp_error( $response ) ) { return $response; } $body = \wp_remote_retrieve_body( $response ); $decoded_body = json_decode( $body ); // WP_Http::FORBIDDEN doesn't exist in WordPress 3.7 if ( 403 === wp_remote_retrieve_response_code( $response ) ) { return new \WP_Error( 403, $this->build_rate_limiting_error_message( $decoded_body ) ); } if ( 404 === wp_remote_retrieve_response_code( $response ) ) { return new \WP_Error( $decoded_body->status, $decoded_body->message ); } if ( null === $decoded_body ) { return new \WP_Error( 500, 'Empty response received from GitHub.com API' ); } if ( ! isset( $decoded_body[0] ) ) { return new \WP_Error( '400', 'The given Github repository does not have any releases' ); } $latest_release = $decoded_body[0]; return [ 'name' => $latest_release->name, 'url' => $this->get_asset_url_from_release( $latest_release ), ]; } /** * Get the asset URL from the release array. When the asset is not present, we fallback to the zipball_url (source code) property. */ private function get_asset_url_from_release( $release ) { if ( isset( $release->assets[0]->browser_download_url ) ) { return $release->assets[0]->browser_download_url; } if ( isset( $release->zipball_url ) ) { return $release->zipball_url; } return null; } /** * Get the GitHub repo from the URL. * * @param string $url * * @return string|null */ protected function get_github_repo_from_releases_url( $url ) { preg_match( $this->github_latest_release_url, $url, $matches ); return isset( $matches[1] ) ? $matches[1] : null; } /** * Build the error message we display in WP-CLI for the API Rate limiting error response. * * @param $decoded_body * * @return string */ private function build_rate_limiting_error_message( $decoded_body ) { return $decoded_body->message . PHP_EOL . $decoded_body->documentation_url . PHP_EOL . 'In order to pass the token to WP-CLI, you need to use the GITHUB_TOKEN environment variable.'; } } <?php use WP_CLI\Fetchers\Plugin; use WP_CLI\Formatter; use WP_CLI\ParsePluginNameInput; use WP_CLI\Utils; /** * Manages plugin auto-updates. * * ## EXAMPLES * * # Enable the auto-updates for a plugin * $ wp plugin auto-updates enable hello * Plugin auto-updates for 'hello' enabled. * Success: Enabled 1 of 1 plugin auto-updates. * * # Disable the auto-updates for a plugin * $ wp plugin auto-updates disable hello * Plugin auto-updates for 'hello' disabled. * Success: Disabled 1 of 1 plugin auto-updates. * * # Get the status of plugin auto-updates * $ wp plugin auto-updates status hello * Auto-updates for plugin 'hello' are disabled. * * @package wp-cli */ class Plugin_AutoUpdates_Command { use ParsePluginNameInput; /** * Site option that stores the status of plugin auto-updates. * * @var string */ const SITE_OPTION = 'auto_update_plugins'; /** * Plugin fetcher instance. * * @var Plugin */ protected $fetcher; /** * Plugin_AutoUpdates_Command constructor. */ public function __construct() { $this->fetcher = new Plugin(); } /** * Enables the auto-updates for a plugin. * * ## OPTIONS * * [<plugin>...] * : One or more plugins to enable auto-updates for. * * [--all] * : If set, auto-updates will be enabled for all plugins. * * [--disabled-only] * : If set, filters list of plugins to only include the ones that have * auto-updates disabled. * * ## EXAMPLES * * # Enable the auto-updates for a plugin * $ wp plugin auto-updates enable hello * Plugin auto-updates for 'hello' enabled. * Success: Enabled 1 of 1 plugin auto-updates. */ public function enable( $args, $assoc_args ) { $all = Utils\get_flag_value( $assoc_args, 'all', false ); $disabled_only = Utils\get_flag_value( $assoc_args, 'disabled-only', false ); $args = $this->check_optional_args_and_all( $args, $all ); if ( ! $args ) { return; } $plugins = $this->fetcher->get_many( $args ); $auto_updates = get_site_option( static::SITE_OPTION ); if ( ! is_array( $auto_updates ) ) { $auto_updates = []; } $count = 0; $successes = 0; foreach ( $plugins as $plugin ) { $enabled = in_array( $plugin->file, $auto_updates, true ); if ( $disabled_only && $enabled ) { continue; } ++$count; if ( $enabled ) { WP_CLI::warning( "Auto-updates already enabled for plugin {$plugin->name}." ); } else { $auto_updates[] = $plugin->file; ++$successes; } } if ( 0 === $count ) { WP_CLI::error( 'No plugins provided to enable auto-updates for.' ); } update_site_option( static::SITE_OPTION, $auto_updates ); Utils\report_batch_operation_results( 'plugin auto-update', 'enable', $count, $successes, $count - $successes ); } /** * Disables the auto-updates for a plugin. * * ## OPTIONS * * [<plugin>...] * : One or more plugins to disable auto-updates for. * * [--all] * : If set, auto-updates will be disabled for all plugins. * * [--enabled-only] * : If set, filters list of plugins to only include the ones that have * auto-updates enabled. * * ## EXAMPLES * * # Disable the auto-updates for a plugin * $ wp plugin auto-updates disable hello * Plugin auto-updates for 'hello' disabled. * Success: Disabled 1 of 1 plugin auto-updates. */ public function disable( $args, $assoc_args ) { $all = Utils\get_flag_value( $assoc_args, 'all', false ); $enabled_only = Utils\get_flag_value( $assoc_args, 'enabled-only', false ); $args = $this->check_optional_args_and_all( $args, $all ); if ( ! $args ) { return; } $plugins = $this->fetcher->get_many( $args ); $auto_updates = get_site_option( static::SITE_OPTION ); if ( ! is_array( $auto_updates ) ) { $auto_updates = []; } $count = 0; $successes = 0; foreach ( $plugins as $plugin ) { $enabled = in_array( $plugin->file, $auto_updates, true ); if ( $enabled_only && ! $enabled ) { continue; } ++$count; if ( ! $enabled ) { WP_CLI::warning( "Auto-updates already disabled for plugin {$plugin->name}." ); } else { $auto_updates = array_diff( $auto_updates, [ $plugin->file ] ); ++$successes; } } if ( 0 === $count ) { WP_CLI::error( 'No plugins provided to disable auto-updates for.' ); } if ( count( $auto_updates ) > 0 ) { update_site_option( static::SITE_OPTION, $auto_updates ); } else { delete_site_option( static::SITE_OPTION ); } Utils\report_batch_operation_results( 'plugin auto-update', 'disable', $count, $successes, $count - $successes ); } /** * Shows the status of auto-updates for a plugin. * * ## OPTIONS * * [<plugin>...] * : One or more plugins to show the status of the auto-updates of. * * [--all] * : If set, the status of auto-updates for all plugins will be shown. * * [--enabled-only] * : If set, filters list of plugins to only include the ones that have * auto-updates enabled. * * [--disabled-only] * : If set, filters list of plugins to only include the ones that have * auto-updates disabled. * * [--field=<field>] * : Only show the provided field. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * - count * --- * * ## EXAMPLES * * # Get the status of plugin auto-updates * $ wp plugin auto-updates status hello * +-------+----------+ * | name | status | * +-------+----------+ * | hello | disabled | * +-------+----------+ * * # Get the list of plugins that have auto-updates enabled * $ wp plugin auto-updates status --all --enabled-only --field=name * akismet * duplicate-post */ public function status( $args, $assoc_args ) { $all = Utils\get_flag_value( $assoc_args, 'all', false ); $enabled_only = Utils\get_flag_value( $assoc_args, 'enabled-only', false ); $disabled_only = Utils\get_flag_value( $assoc_args, 'disabled-only', false ); if ( $enabled_only && $disabled_only ) { WP_CLI::error( '--enabled-only and --disabled-only are mutually exclusive and ' . 'cannot be used at the same time.' ); } $args = $this->check_optional_args_and_all( $args, $all ); if ( ! $args ) { return; } $plugins = $this->fetcher->get_many( $args ); $auto_updates = get_site_option( static::SITE_OPTION ); if ( ! is_array( $auto_updates ) ) { $auto_updates = []; } $results = []; foreach ( $plugins as $plugin ) { $enabled = in_array( $plugin->file, $auto_updates, true ); if ( $enabled_only && ! $enabled ) { continue; } if ( $disabled_only && $enabled ) { continue; } $results[] = [ 'name' => $plugin->name, 'file' => $plugin->file, 'status' => $enabled ? 'enabled' : 'disabled', ]; } $formatter = new Formatter( $assoc_args, [ 'name', 'status' ], 'plugin' ); $formatter->display_items( $results ); } } <?php /** * Sets, gets, and removes theme mods. * * ## EXAMPLES * * # Set the 'background_color' theme mod to '000000'. * $ wp theme mod set background_color 000000 * Success: Theme mod background_color set to 000000. * * # Get single theme mod in JSON format. * $ wp theme mod get background_color --format=json * [{"key":"background_color","value":"dd3333"}] * * # Remove all theme mods. * $ wp theme mod remove --all * Success: Theme mods removed. */ class Theme_Mod_Command extends WP_CLI_Command { private $fields = [ 'key', 'value' ]; /** * Gets one or more theme mods. * * ## OPTIONS * * [<mod>...] * : One or more mods to get. * * [--field=<field>] * : Returns the value of a single field. * * [--all] * : List all theme mods * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - json * - csv * - yaml * --- * * ## EXAMPLES * * # Get all theme mods. * $ wp theme mod get --all * +------------------+---------+ * | key | value | * +------------------+---------+ * | background_color | dd3333 | * | link_color | #dd9933 | * | main_text_color | #8224e3 | * +------------------+---------+ * * # Get single theme mod in JSON format. * $ wp theme mod get background_color --format=json * [{"key":"background_color","value":"dd3333"}] * * # Get value of a single theme mod. * $ wp theme mod get background_color --field=value * dd3333 * * # Get multiple theme mods. * $ wp theme mod get background_color header_textcolor * +------------------+--------+ * | key | value | * +------------------+--------+ * | background_color | dd3333 | * | header_textcolor | | * +------------------+--------+ */ public function get( $args = array(), $assoc_args = array() ) { if ( ! \WP_CLI\Utils\get_flag_value( $assoc_args, 'all' ) && empty( $args ) ) { WP_CLI::error( 'You must specify at least one mod or use --all.' ); } if ( \WP_CLI\Utils\get_flag_value( $assoc_args, 'all' ) ) { $args = array(); } $list = array(); $mods = get_theme_mods(); if ( ! is_array( $mods ) ) { // If no mods are set (perhaps new theme), make sure foreach still works. $mods = array(); } foreach ( $mods as $k => $v ) { // If mods were given, skip the others. if ( ! empty( $args ) && ! in_array( $k, $args, true ) ) { continue; } if ( is_array( $v ) ) { $list[] = [ 'key' => $k, 'value' => '=>', ]; foreach ( $v as $_k => $_v ) { $list[] = [ 'key' => " $_k", 'value' => $_v, ]; } } else { $list[] = [ 'key' => $k, 'value' => $v, ]; } } // For unset mods, show blank value. foreach ( $args as $mod ) { if ( ! isset( $mods[ $mod ] ) ) { $list[] = [ 'key' => $mod, 'value' => '', ]; } } $formatter = new \WP_CLI\Formatter( $assoc_args, $this->fields, 'thememods' ); $formatter->display_items( $list ); } /** * Gets a list of theme mods. * * ## OPTIONS * * [--field=<field>] * : Returns the value of a single field. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - json * - csv * - yaml * --- * * ## EXAMPLES * * # Gets a list of theme mods. * $ wp theme mod list * +------------------+---------+ * | key | value | * +------------------+---------+ * | background_color | dd3333 | * | link_color | #dd9933 | * | main_text_color | #8224e3 | * +------------------+---------+ * * @subcommand list */ public function list_( $args = array(), $assoc_args = array() ) { $assoc_args['all'] = 1; $this->get( $args, $assoc_args ); } /** * Removes one or more theme mods. * * ## OPTIONS * * [<mod>...] * : One or more mods to remove. * * [--all] * : Remove all theme mods. * * ## EXAMPLES * * # Remove all theme mods. * $ wp theme mod remove --all * Success: Theme mods removed. * * # Remove single theme mod. * $ wp theme mod remove background_color * Success: 1 mod removed. * * # Remove multiple theme mods. * $ wp theme mod remove background_color header_textcolor * Success: 2 mods removed. */ public function remove( $args = array(), $assoc_args = array() ) { if ( ! \WP_CLI\Utils\get_flag_value( $assoc_args, 'all' ) && empty( $args ) ) { WP_CLI::error( 'You must specify at least one mod or use --all.' ); } if ( \WP_CLI\Utils\get_flag_value( $assoc_args, 'all' ) ) { remove_theme_mods(); WP_CLI::success( 'Theme mods removed.' ); return; } foreach ( $args as $mod ) { remove_theme_mod( $mod ); } $count = count( $args ); $success_message = ( 1 === $count ) ? '%d mod removed.' : '%d mods removed.'; WP_CLI::success( sprintf( $success_message, $count ) ); } /** * Sets the value of a theme mod. * * ## OPTIONS * * <mod> * : The name of the theme mod to set or update. * * <value> * : The new value. * * ## EXAMPLES * * # Set theme mod * $ wp theme mod set background_color 000000 * Success: Theme mod background_color set to 000000. */ public function set( $args = array(), $assoc_args = array() ) { list( $mod, $value ) = $args; set_theme_mod( $mod, $value ); if ( get_theme_mod( $mod ) === $value ) { WP_CLI::success( "Theme mod {$mod} set to {$value}." ); } else { WP_CLI::success( "Could not update theme mod {$mod}." ); } } } <?php use WP_CLI\CommandWithUpgrade; use WP_CLI\ParseThemeNameInput; use WP_CLI\Utils; /** * Manages themes, including installs, activations, and updates. * * See the WordPress [Theme Handbook](https://developer.wordpress.org/themes/) developer resource for more information on themes. * * ## EXAMPLES * * # Install the latest version of a theme from wordpress.org and activate * $ wp theme install twentysixteen --activate * Installing Twenty Sixteen (1.2) * Downloading install package from http://downloads.wordpress.org/theme/twentysixteen.1.2.zip... * Unpacking the package... * Installing the theme... * Theme installed successfully. * Activating 'twentysixteen'... * Success: Switched to 'Twenty Sixteen' theme. * Success: Installed 1 of 1 themes. * * # Get details of an installed theme * $ wp theme get twentysixteen --fields=name,title,version * +---------+----------------+ * | Field | Value | * +---------+----------------+ * | name | Twenty Sixteen | * | title | Twenty Sixteen | * | version | 1.2 | * +---------+----------------+ * * # Get status of theme * $ wp theme status twentysixteen * Theme twentysixteen details: * Name: Twenty Sixteen * Status: Active * Version: 1.2 * Author: the WordPress team * * @package wp-cli */ class Theme_Command extends CommandWithUpgrade { use ParseThemeNameInput; protected $item_type = 'theme'; protected $upgrade_refresh = 'wp_update_themes'; protected $upgrade_transient = 'update_themes'; protected $obj_fields = [ 'name', 'status', 'update', 'version', 'update_version', 'auto_update', ]; public function __construct() { if ( is_multisite() ) { $this->obj_fields[] = 'enabled'; } parent::__construct(); $this->fetcher = new WP_CLI\Fetchers\Theme(); } protected function get_upgrader_class( $force ) { return $force ? '\\WP_CLI\\DestructiveThemeUpgrader' : 'Theme_Upgrader'; } /** * Reveals the status of one or all themes. * * ## OPTIONS * * [<theme>] * : A particular theme to show the status for. * * ## EXAMPLES * * $ wp theme status twentysixteen * Theme twentysixteen details: * Name: Twenty Sixteen * Status: Inactive * Version: 1.2 * Author: the WordPress team */ public function status( $args ) { if ( isset( $args[0] ) ) { $theme = $this->fetcher->get_check( $args[0] ); $errors = $theme->errors(); if ( is_wp_error( $errors ) ) { $message = $errors->get_error_message(); WP_CLI::error( $message ); } } parent::status( $args ); } /** * Searches the WordPress.org theme directory. * * Displays themes in the WordPress.org theme directory matching a given * search query. * * ## OPTIONS * * <search> * : The string to search for. * * [--page=<page>] * : Optional page to display. * --- * default: 1 * --- * * [--per-page=<per-page>] * : Optional number of results to display. Defaults to 10. * * [--field=<field>] * : Prints the value of a single field for each theme. * * [--fields=<fields>] * : Ask for specific fields from the API. Defaults to name,slug,author,rating. Acceptable values: * * **name**: Theme Name * **slug**: Theme Slug * **version**: Current Version Number * **author**: Theme Author * **preview_url**: Theme Preview URL * **screenshot_url**: Theme Screenshot URL * **rating**: Theme Rating * **num_ratings**: Number of Theme Ratings * **homepage**: Theme Author's Homepage * **description**: Theme Description * **url**: Theme's URL on wordpress.org * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - yaml * --- * * ## EXAMPLES * * $ wp theme search photo --per-page=6 * Success: Showing 6 of 203 themes. * +----------------------+----------------------+--------+ * | name | slug | rating | * +----------------------+----------------------+--------+ * | Photos | photos | 100 | * | Infinite Photography | infinite-photography | 100 | * | PhotoBook | photobook | 100 | * | BG Photo Frame | bg-photo-frame | 0 | * | fPhotography | fphotography | 0 | * | Photo Perfect | photo-perfect | 98 | * +----------------------+----------------------+--------+ */ public function search( $args, $assoc_args ) { parent::_search( $args, $assoc_args ); } protected function status_single( $args ) { $theme = $this->fetcher->get_check( $args[0] ); $status = $this->format_status( $this->get_status( $theme ), 'long' ); $version = $theme->get( 'Version' ); if ( $this->has_update( $theme->get_stylesheet() ) ) { $version .= ' (%gUpdate available%n)'; } echo WP_CLI::colorize( Utils\mustache_render( self::get_template_path( 'theme-status.mustache' ), [ 'slug' => $theme->get_stylesheet(), 'status' => $status, 'version' => $version, 'name' => $theme->get( 'Name' ), 'author' => $theme->get( 'Author' ), ] ) ); } protected function get_all_items() { return $this->get_item_list(); } /** * Activates a theme. * * ## OPTIONS * * <theme> * : The theme to activate. * * ## EXAMPLES * * $ wp theme activate twentysixteen * Success: Switched to 'Twenty Sixteen' theme. */ public function activate( $args = array() ) { $theme = $this->fetcher->get_check( $args[0] ); $errors = $theme->errors(); if ( is_wp_error( $errors ) ) { $message = $errors->get_error_message(); WP_CLI::error( $message ); } $name = $theme->get( 'Name' ); if ( 'active' === $this->get_status( $theme ) ) { WP_CLI::warning( "The '$name' theme is already active." ); return; } if ( $theme->get_stylesheet() !== $theme->get_template() && ! $this->fetcher->get( $theme->get_template() ) ) { WP_CLI::error( "The '{$theme->get_stylesheet()}' theme cannot be activated without its parent, '{$theme->get_template()}'." ); } switch_theme( $theme->get_template(), $theme->get_stylesheet() ); if ( $this->is_active_theme( $theme ) ) { WP_CLI::success( "Switched to '$name' theme." ); } else { WP_CLI::error( "Could not switch to '$name' theme." ); } } /** * Enables a theme on a WordPress multisite install. * * Permits theme to be activated from the dashboard of a site on a WordPress * multisite install. * * ## OPTIONS * * <theme> * : The theme to enable. * * [--network] * : If set, the theme is enabled for the entire network * * [--activate] * : If set, the theme is activated for the current site. Note that * the "network" flag has no influence on this. * * ## EXAMPLES * * # Enable theme * $ wp theme enable twentysixteen * Success: Enabled the 'Twenty Sixteen' theme. * * # Network enable theme * $ wp theme enable twentysixteen --network * Success: Network enabled the 'Twenty Sixteen' theme. * * # Network enable and activate theme for current site * $ wp theme enable twentysixteen --activate * Success: Enabled the 'Twenty Sixteen' theme. * Success: Switched to 'Twenty Sixteen' theme. */ public function enable( $args, $assoc_args ) { if ( ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } $theme = $this->fetcher->get_check( $args[0] ); $name = $theme->get( 'Name' ); # If the --network flag is set, we'll be calling the (get|update)_site_option functions $_site = ! empty( $assoc_args['network'] ) ? '_site' : ''; # Add the current theme to the allowed themes option or site option $allowed_themes = call_user_func( "get{$_site}_option", 'allowedthemes' ); if ( empty( $allowed_themes ) ) { $allowed_themes = array(); } $allowed_themes[ $theme->get_stylesheet() ] = true; call_user_func( "update{$_site}_option", 'allowedthemes', $allowed_themes ); if ( ! empty( $assoc_args['network'] ) ) { WP_CLI::success( "Network enabled the '$name' theme." ); } else { WP_CLI::success( "Enabled the '$name' theme." ); } # If the --activate flag is set, activate the theme for the current site if ( ! empty( $assoc_args['activate'] ) ) { $this->activate( $args ); } } /** * Disables a theme on a WordPress multisite install. * * Removes ability for a theme to be activated from the dashboard of a site * on a WordPress multisite install. * * ## OPTIONS * * <theme> * : The theme to disable. * * [--network] * : If set, the theme is disabled on the network level. Note that * individual sites may still have this theme enabled if it was * enabled for them independently. * * ## EXAMPLES * * # Disable theme * $ wp theme disable twentysixteen * Success: Disabled the 'Twenty Sixteen' theme. * * # Disable theme in network level * $ wp theme disable twentysixteen --network * Success: Network disabled the 'Twenty Sixteen' theme. */ public function disable( $args, $assoc_args ) { if ( ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } $theme = $this->fetcher->get_check( $args[0] ); $name = $theme->get( 'Name' ); # If the --network flag is set, we'll be calling the (get|update)_site_option functions $_site = ! empty( $assoc_args['network'] ) ? '_site' : ''; # Add the current theme to the allowed themes option or site option $allowed_themes = call_user_func( "get{$_site}_option", 'allowedthemes' ); if ( ! empty( $allowed_themes[ $theme->get_stylesheet() ] ) ) { unset( $allowed_themes[ $theme->get_stylesheet() ] ); } call_user_func( "update{$_site}_option", 'allowedthemes', $allowed_themes ); if ( ! empty( $assoc_args['network'] ) ) { WP_CLI::success( "Network disabled the '$name' theme." ); } else { WP_CLI::success( "Disabled the '$name' theme." ); } } /** * Gets the path to a theme or to the theme directory. * * ## OPTIONS * * [<theme>] * : The theme to get the path to. Path includes "style.css" file. * If not set, will return the path to the themes directory. * * [--dir] * : If set, get the path to the closest parent directory, instead of the * theme's "style.css" file. * * ## EXAMPLES * * # Get theme path * $ wp theme path * /var/www/example.com/public_html/wp-content/themes * * # Change directory to theme path * $ cd $(wp theme path) */ public function path( $args, $assoc_args ) { if ( empty( $args ) ) { $path = WP_CONTENT_DIR . '/themes'; } else { $theme = $this->fetcher->get_check( $args[0] ); $path = $theme->get_stylesheet_directory(); if ( ! Utils\get_flag_value( $assoc_args, 'dir' ) ) { $path .= '/style.css'; } } WP_CLI::line( $path ); } protected function install_from_repo( $slug, $assoc_args ) { global $wp_version; // Extract the major WordPress version (e.g., "6.3") from the full version string list($wp_core_version) = explode( '-', $wp_version ); $wp_core_version = implode( '.', array_slice( explode( '.', $wp_core_version ), 0, 2 ) ); $api = themes_api( 'theme_information', array( 'slug' => $slug ) ); if ( is_wp_error( $api ) ) { return $api; } if ( isset( $assoc_args['version'] ) ) { self::alter_api_response( $api, $assoc_args['version'] ); } elseif ( ! Utils\get_flag_value( $assoc_args, 'ignore-requirements', false ) ) { $requires_php = isset( $api->requires_php ) ? $api->requires_php : null; $requires_wp = isset( $api->requires ) ? $api->requires : null; $compatible_php = empty( $requires_php ) || version_compare( PHP_VERSION, $requires_php, '>=' ); $compatible_wp = empty( $requires_wp ) || version_compare( $wp_core_version, $requires_wp, '>=' ); if ( ! $compatible_wp ) { return new WP_Error( 'requirements_not_met', "This theme does not work with your version of WordPress. Minimum WordPress requirement is $requires_wp" ); } if ( ! $compatible_php ) { return new WP_Error( 'requirements_not_met', "This theme does not work with your version of PHP. Minimum PHP required is $requires_php" ); } } if ( ! Utils\get_flag_value( $assoc_args, 'force' ) ) { $theme = wp_get_theme( $slug ); if ( $theme->exists() ) { // We know this will fail, so avoid a needless download of the package. return new WP_Error( 'already_installed', 'Theme already installed.' ); } // Clear cache so WP_Theme doesn't create a "missing theme" object. $cache_hash = md5( $theme->theme_root . '/' . $theme->stylesheet ); foreach ( [ 'theme', 'screenshot', 'headers', 'page_templates' ] as $key ) { wp_cache_delete( $key . '-' . $cache_hash, 'themes' ); } } WP_CLI::log( sprintf( 'Installing %s (%s)', html_entity_decode( $api->name, ENT_QUOTES ), $api->version ) ); if ( Utils\get_flag_value( $assoc_args, 'version' ) !== 'dev' ) { WP_CLI::get_http_cache_manager()->whitelist_package( $api->download_link, $this->item_type, $api->slug, $api->version ); } // Ignore failures on accessing SSL "https://api.wordpress.org/themes/update-check/1.1/" in `wp_update_themes()` which seem to occur intermittently. set_error_handler( array( __CLASS__, 'error_handler' ), E_USER_WARNING | E_USER_NOTICE ); $result = $this->get_upgrader( $assoc_args )->install( $api->download_link ); restore_error_handler(); return $result; } protected function get_item_list() { return $this->get_all_themes(); } protected function filter_item_list( $items, $args ) { $theme_files = array(); foreach ( $args as $arg ) { $theme_files[] = $this->fetcher->get_check( $arg )->get_stylesheet(); } return Utils\pick_fields( $items, $theme_files ); } /** * Installs one or more themes. * * ## OPTIONS * * <theme|zip|url>... * : One or more themes to install. Accepts a theme slug, the path to a local zip file, or a URL to a remote zip file. * * [--version=<version>] * : If set, get that particular version from wordpress.org, instead of the * stable version. * * [--force] * : If set, the command will overwrite any installed version of the theme, without prompting * for confirmation. * * [--ignore-requirements] * : If set, the command will install the theme while ignoring any WordPress or PHP version requirements * specified by the theme authors. * * [--activate] * : If set, the theme will be activated immediately after install. * * [--insecure] * : Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack. * * ## EXAMPLES * * # Install the latest version from wordpress.org and activate * $ wp theme install twentysixteen --activate * Installing Twenty Sixteen (1.2) * Downloading install package from http://downloads.wordpress.org/theme/twentysixteen.1.2.zip... * Unpacking the package... * Installing the theme... * Theme installed successfully. * Activating 'twentysixteen'... * Success: Switched to 'Twenty Sixteen' theme. * Success: Installed 1 of 1 themes. * * # Install from a local zip file * $ wp theme install ../my-theme.zip * * # Install from a remote zip file * $ wp theme install http://s3.amazonaws.com/bucketname/my-theme.zip?AWSAccessKeyId=123&Expires=456&Signature=abcdef */ public function install( $args, $assoc_args ) { if ( count( $args ) > 1 && Utils\get_flag_value( $assoc_args, 'activate', false ) ) { WP_CLI::warning( sprintf( 'Only this single theme will be activated: %s', end( $args ) ) ); reset( $args ); } $theme_root = get_theme_root(); if ( $theme_root && ! is_dir( $theme_root ) ) { wp_mkdir_p( $theme_root ); register_theme_directory( $theme_root ); } parent::install( $args, $assoc_args ); } /** * Gets details about a theme. * * ## OPTIONS * * <theme> * : The theme to get. * * [--field=<field>] * : Instead of returning the whole theme, returns the value of a single field. * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## EXAMPLES * * $ wp theme get twentysixteen --fields=name,title,version * +---------+----------------+ * | Field | Value | * +---------+----------------+ * | name | Twenty Sixteen | * | title | Twenty Sixteen | * | version | 1.2 | * +---------+----------------+ */ public function get( $args, $assoc_args ) { $theme = $this->fetcher->get_check( $args[0] ); $errors = $theme->errors(); if ( is_wp_error( $errors ) ) { $message = $errors->get_error_message(); WP_CLI::error( $message ); } // WP_Theme object employs magic getter, unfortunately. $theme_vars = [ 'name', 'title', 'version', 'status', 'parent_theme', 'template_dir', 'stylesheet_dir', 'template', 'stylesheet', 'screenshot', 'description', 'author', 'tags', 'theme_root', 'theme_root_uri', ]; $theme_obj = new stdClass(); foreach ( $theme_vars as $var ) { $theme_obj->$var = $theme->$var; } $theme_obj->status = $this->get_status( $theme ); $theme_obj->description = wordwrap( $theme_obj->description ); if ( empty( $assoc_args['fields'] ) ) { $assoc_args['fields'] = $theme_vars; } $formatter = $this->get_formatter( $assoc_args ); $formatter->display_item( $theme_obj ); } /** * Updates one or more themes. * * ## OPTIONS * * [<theme>...] * : One or more themes to update. * * [--all] * : If set, all themes that have updates will be updated. * * [--exclude=<theme-names>] * : Comma separated list of theme names that should be excluded from updating. * * [--minor] * : Only perform updates for minor releases (e.g. from 1.3 to 1.4 instead of 2.0) * * [--patch] * : Only perform updates for patch releases (e.g. from 1.3 to 1.3.3 instead of 1.4) * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - summary * --- * * [--version=<version>] * : If set, the theme will be updated to the specified version. * * [--dry-run] * : Preview which themes would be updated. * * [--insecure] * : Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack. * * ## EXAMPLES * * # Update multiple themes * $ wp theme update twentyfifteen twentysixteen * Downloading update from https://downloads.wordpress.org/theme/twentyfifteen.1.5.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the theme... * Theme updated successfully. * Downloading update from https://downloads.wordpress.org/theme/twentysixteen.1.2.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the theme... * Theme updated successfully. * +---------------+-------------+-------------+---------+ * | name | old_version | new_version | status | * +---------------+-------------+-------------+---------+ * | twentyfifteen | 1.4 | 1.5 | Updated | * | twentysixteen | 1.1 | 1.2 | Updated | * +---------------+-------------+-------------+---------+ * Success: Updated 2 of 2 themes. * * # Exclude themes updates when bulk updating the themes * $ wp theme update --all --exclude=twentyfifteen * Downloading update from https://downloads.wordpress.org/theme/astra.1.0.5.1.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the theme... * Theme updated successfully. * Downloading update from https://downloads.wordpress.org/theme/twentyseventeen.1.2.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the theme... * Theme updated successfully. * +-----------------+----------+---------+----------------+ * | name | status | version | update_version | * +-----------------+----------+---------+----------------+ * | astra | inactive | 1.0.1 | 1.0.5.1 | * | twentyseventeen | inactive | 1.1 | 1.2 | * +-----------------+----------+---------+----------------+ * Success: Updated 2 of 2 themes. * * # Update all themes * $ wp theme update --all * * @alias upgrade */ public function update( $args, $assoc_args ) { $all = Utils\get_flag_value( $assoc_args, 'all', false ); $args = $this->check_optional_args_and_all( $args, $all ); if ( ! $args ) { return; } if ( isset( $assoc_args['version'] ) && isset( $assoc_args['dry-run'] ) ) { WP_CLI::error( '--dry-run cannot be used together with --version.' ); } if ( isset( $assoc_args['version'] ) ) { foreach ( $this->fetcher->get_many( $args ) as $theme ) { $assoc_args['force'] = true; $this->install( array( $theme->stylesheet ), $assoc_args ); } } else { parent::update_many( $args, $assoc_args ); } } /** * Checks if a given theme is installed. * * Returns exit code 0 when installed, 1 when uninstalled. * * ## OPTIONS * * <theme> * : The theme to check. * * ## EXAMPLES * * # Check whether theme is installed; exit status 0 if installed, otherwise 1 * $ wp theme is-installed hello * $ echo $? * 1 * * @subcommand is-installed */ public function is_installed( $args, $assoc_args = array() ) { $theme = wp_get_theme( $args[0] ); if ( $theme->exists() ) { WP_CLI::halt( 0 ); } else { WP_CLI::halt( 1 ); } } /** * Checks if a given theme is active. * * Returns exit code 0 when active, 1 when not active. * * ## OPTIONS * * <theme> * : The plugin to check. * * ## EXAMPLES * * # Check whether theme is Active; exit status 0 if active, otherwise 1 * $ wp theme is-active twentyfifteen * $ echo $? * 1 * * @subcommand is-active */ public function is_active( $args, $assoc_args = array() ) { $theme = wp_get_theme( $args[0] ); if ( ! $theme->exists() ) { WP_CLI::halt( 1 ); } $this->is_active_theme( $theme ) || $this->is_active_parent_theme( $theme ) ? WP_CLI::halt( 0 ) : WP_CLI::halt( 1 ); } /** * Deletes one or more themes. * * Removes the theme or themes from the filesystem. * * ## OPTIONS * * [<theme>...] * : One or more themes to delete. * * [--all] * : If set, all themes will be deleted except active theme. * * [--force] * : To delete active theme use this. * * ## EXAMPLES * * $ wp theme delete twentytwelve * Deleted 'twentytwelve' theme. * Success: Deleted 1 of 1 themes. * * @alias uninstall */ public function delete( $args, $assoc_args ) { $all = Utils\get_flag_value( $assoc_args, 'all', false ); $args = $this->check_optional_args_and_all( $args, $all, 'delete' ); if ( ! $args ) { return; } $force = Utils\get_flag_value( $assoc_args, 'force', false ); $successes = 0; $errors = 0; foreach ( $this->fetcher->get_many( $args ) as $theme ) { $theme_slug = $theme->get_stylesheet(); if ( $this->is_active_theme( $theme ) && ! $force ) { if ( ! $all ) { WP_CLI::warning( "Can't delete the currently active theme: $theme_slug" ); ++$errors; } continue; } if ( $this->is_active_parent_theme( $theme ) && ! $force ) { if ( ! $all ) { WP_CLI::warning( "Can't delete the parent of the currently active theme: $theme_slug" ); ++$errors; } continue; } $r = delete_theme( $theme_slug ); if ( is_wp_error( $r ) ) { WP_CLI::warning( $r ); ++$errors; } else { WP_CLI::log( "Deleted '$theme_slug' theme." ); ++$successes; } } if ( ! $this->chained_command ) { Utils\report_batch_operation_results( 'theme', 'delete', count( $args ), $successes, $errors ); } } /** * Gets a list of themes. * * ## OPTIONS * * [--<field>=<value>] * : Filter results based on the value of a field. * * [--field=<field>] * : Prints the value of a single field for each theme. * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - yaml * --- * * [--status=<status>] * : Filter the output by theme status. * --- * options: * - active * - parent * - inactive * --- * * [--skip-update-check] * : If set, the theme update check will be skipped. * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each theme: * * * name * * status * * update * * version * * update_version * * auto_update * * These fields are optionally available: * * * update_package * * update_id * * title * * description * * ## EXAMPLES * * # List inactive themes. * $ wp theme list --status=inactive --format=csv * name,status,update,version,update_version,auto_update * twentyfourteen,inactive,none,3.8,,off * twentysixteen,inactive,available,3.0,3.1,off * * @subcommand list */ public function list_( $_, $assoc_args ) { parent::_list( $_, $assoc_args ); } /** * Gets the template path based on installation type. */ private static function get_template_path( $template ) { $command_root = Utils\phar_safe_path( dirname( __DIR__ ) ); $template_path = "{$command_root}/templates/{$template}"; if ( ! file_exists( $template_path ) ) { WP_CLI::error( "Couldn't find {$template}" ); } return $template_path; } } <?php use WP_CLI\ParsePluginNameInput; use WP_CLI\Utils; use WP_CLI\WpOrgApi; use function WP_CLI\Utils\normalize_path; /** * Manages plugins, including installs, activations, and updates. * * See the WordPress [Plugin Handbook](https://developer.wordpress.org/plugins/) developer resource for more information on plugins. * * ## EXAMPLES * * # Activate plugin * $ wp plugin activate hello * Plugin 'hello' activated. * Success: Activated 1 of 1 plugins. * * # Deactivate plugin * $ wp plugin deactivate hello * Plugin 'hello' deactivated. * Success: Deactivated 1 of 1 plugins. * * # Delete plugin * $ wp plugin delete hello * Deleted 'hello' plugin. * Success: Deleted 1 of 1 plugins. * * # Install the latest version from wordpress.org and activate * $ wp plugin install bbpress --activate * Installing bbPress (2.5.9) * Downloading install package from https://downloads.wordpress.org/plugin/bbpress.2.5.9.zip... * Using cached file '/home/vagrant/.wp-cli/cache/plugin/bbpress-2.5.9.zip'... * Unpacking the package... * Installing the plugin... * Plugin installed successfully. * Activating 'bbpress'... * Plugin 'bbpress' activated. * Success: Installed 1 of 1 plugins. * * @package wp-cli */ class Plugin_Command extends \WP_CLI\CommandWithUpgrade { use ParsePluginNameInput; protected $item_type = 'plugin'; protected $upgrade_refresh = 'wp_update_plugins'; protected $upgrade_transient = 'update_plugins'; protected $check_wporg = [ 'status' => false, 'last_updated' => false, ]; protected $check_headers = [ 'tested_up_to' => false, ]; protected $obj_fields = array( 'name', 'status', 'update', 'version', 'update_version', 'auto_update', ); /** * Plugin fetcher instance. * * @var \WP_CLI\Fetchers\Plugin */ protected $fetcher; public function __construct() { require_once ABSPATH . 'wp-admin/includes/plugin.php'; require_once ABSPATH . 'wp-admin/includes/plugin-install.php'; parent::__construct(); $this->fetcher = new WP_CLI\Fetchers\Plugin(); } protected function get_upgrader_class( $force ) { return $force ? '\\WP_CLI\\DestructivePluginUpgrader' : 'Plugin_Upgrader'; } /** * Reveals the status of one or all plugins. * * ## OPTIONS * * [<plugin>] * : A particular plugin to show the status for. * * ## EXAMPLES * * # Displays status of all plugins * $ wp plugin status * 5 installed plugins: * I akismet 3.1.11 * I easy-digital-downloads 2.5.16 * A theme-check 20160523.1 * I wen-logo-slider 2.0.3 * M ns-pack 1.0.0 * Legend: I = Inactive, A = Active, M = Must Use * * # Displays status of a plugin * $ wp plugin status theme-check * Plugin theme-check details: * Name: Theme Check * Status: Active * Version: 20160523.1 * Author: Otto42, pross * Description: A simple and easy way to test your theme for all the latest WordPress standards and practices. A great theme development tool! */ public function status( $args ) { parent::status( $args ); } /** * Searches the WordPress.org plugin directory. * * Displays plugins in the WordPress.org plugin directory matching a given * search query. * * ## OPTIONS * * <search> * : The string to search for. * * [--page=<page>] * : Optional page to display. * --- * default: 1 * --- * * [--per-page=<per-page>] * : Optional number of results to display. * --- * default: 10 * --- * * [--field=<field>] * : Prints the value of a single field for each plugin. * * [--fields=<fields>] * : Ask for specific fields from the API. Defaults to name,slug,author_profile,rating. Acceptable values: * * **name**: Plugin Name * **slug**: Plugin Slug * **version**: Current Version Number * **author**: Plugin Author * **author_profile**: Plugin Author Profile * **contributors**: Plugin Contributors * **requires**: Plugin Minimum Requirements * **tested**: Plugin Tested Up To * **compatibility**: Plugin Compatible With * **rating**: Plugin Rating in Percent and Total Number * **ratings**: Plugin Ratings for each star (1-5) * **num_ratings**: Number of Plugin Ratings * **homepage**: Plugin Author's Homepage * **description**: Plugin's Description * **short_description**: Plugin's Short Description * **sections**: Plugin Readme Sections: description, installation, FAQ, screenshots, other notes, and changelog * **downloaded**: Plugin Download Count * **last_updated**: Plugin's Last Update * **added**: Plugin's Date Added to wordpress.org Repository * **tags**: Plugin's Tags * **versions**: Plugin's Available Versions with D/L Link * **donate_link**: Plugin's Donation Link * **banners**: Plugin's Banner Image Link * **icons**: Plugin's Icon Image Link * **active_installs**: Plugin's Number of Active Installs * **contributors**: Plugin's List of Contributors * **url**: Plugin's URL on wordpress.org * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - count * - json * - yaml * --- * * ## EXAMPLES * * $ wp plugin search dsgnwrks --per-page=20 --format=json * Success: Showing 3 of 3 plugins. * [{"name":"DsgnWrks Instagram Importer Debug","slug":"dsgnwrks-instagram-importer-debug","rating":0},{"name":"DsgnWrks Instagram Importer","slug":"dsgnwrks-instagram-importer","rating":84},{"name":"DsgnWrks Twitter Importer","slug":"dsgnwrks-twitter-importer","rating":80}] * * $ wp plugin search dsgnwrks --fields=name,version,slug,rating,num_ratings * Success: Showing 3 of 3 plugins. * +-----------------------------------+---------+-----------------------------------+--------+-------------+ * | name | version | slug | rating | num_ratings | * +-----------------------------------+---------+-----------------------------------+--------+-------------+ * | DsgnWrks Instagram Importer Debug | 0.1.6 | dsgnwrks-instagram-importer-debug | 0 | 0 | * | DsgnWrks Instagram Importer | 1.3.7 | dsgnwrks-instagram-importer | 84 | 23 | * | DsgnWrks Twitter Importer | 1.1.1 | dsgnwrks-twitter-importer | 80 | 1 | * +-----------------------------------+---------+-----------------------------------+--------+-------------+ */ public function search( $args, $assoc_args ) { parent::_search( $args, $assoc_args ); } protected function status_single( $args ) { $plugin = $this->fetcher->get_check( $args[0] ); $file = $plugin->file; $details = $this->get_details( $file ); $status = $this->format_status( $this->get_status( $file ), 'long' ); $version = $details['Version']; if ( $this->has_update( $file ) ) { $version .= ' (%gUpdate available%n)'; } echo WP_CLI::colorize( Utils\mustache_render( self::get_template_path( 'plugin-status.mustache' ), [ 'slug' => Utils\get_plugin_name( $file ), 'status' => $status, 'version' => $version, 'name' => $details['Name'], 'author' => $details['Author'], 'description' => $details['Description'], ] ) ); } protected function get_all_items() { $items = $this->get_item_list(); foreach ( get_mu_plugins() as $file => $mu_plugin ) { $mu_version = ''; if ( ! empty( $mu_plugin['Version'] ) ) { $mu_version = $mu_plugin['Version']; } $mu_title = ''; if ( ! empty( $mu_plugin['Name'] ) ) { $mu_title = $mu_plugin['Title']; } $mu_description = ''; if ( ! empty( $mu_plugin['Description'] ) ) { $mu_description = $mu_plugin['Description']; } $mu_name = Utils\get_plugin_name( $file ); $wporg_info = $this->get_wporg_data( $mu_name ); $items[ $file ] = array( 'name' => $mu_name, 'status' => 'must-use', 'update' => false, 'update_version' => null, 'update_package' => null, 'version' => $mu_version, 'update_id' => '', 'title' => $mu_title, 'description' => $mu_description, 'file' => $file, 'auto_update' => false, 'tested_up_to' => '', 'requires' => '', 'requires_php' => '', 'wporg_status' => $wporg_info['status'], 'wporg_last_updated' => $wporg_info['last_updated'], ); } $raw_items = get_dropins(); $raw_data = _get_dropins(); foreach ( $raw_items as $name => $item_data ) { $description = ! empty( $raw_data[ $name ][0] ) ? $raw_data[ $name ][0] : ''; $items[ $name ] = [ 'name' => $name, 'title' => $item_data['Title'], 'description' => $description, 'status' => 'dropin', 'update' => false, 'update_version' => null, 'update_package' => null, 'update_id' => '', 'file' => $name, 'auto_update' => false, 'author' => $item_data['Author'], 'tested_up_to' => '', 'requires' => '', 'requires_php' => '', 'wporg_status' => '', 'wporg_last_updated' => '', ]; } return $items; } /** * Activates one or more plugins. * * ## OPTIONS * * [<plugin>...] * : One or more plugins to activate. * * [--all] * : If set, all plugins will be activated. * * [--exclude=<name>] * : Comma separated list of plugin slugs to be excluded from activation. * * [--network] * : If set, the plugin will be activated for the entire multisite network. * * ## EXAMPLES * * # Activate plugin * $ wp plugin activate hello * Plugin 'hello' activated. * Success: Activated 1 of 1 plugins. * * # Activate plugin in entire multisite network * $ wp plugin activate hello --network * Plugin 'hello' network activated. * Success: Network activated 1 of 1 plugins. * * # Activate plugins that were recently active. * $ wp plugin activate $(wp plugin list --recently-active --field=name) * Plugin 'bbpress' activated. * Plugin 'buddypress' activated. * Success: Activated 2 of 2 plugins. * * # Activate plugins that were recently active on a multisite. * $ wp plugin activate $(wp plugin list --recently-active --field=name) --network * Plugin 'bbpress' network activated. * Plugin 'buddypress' network activated. * Success: Activated 2 of 2 plugins. */ public function activate( $args, $assoc_args = array() ) { $network_wide = Utils\get_flag_value( $assoc_args, 'network', false ); $all = Utils\get_flag_value( $assoc_args, 'all', false ); $all_exclude = Utils\get_flag_value( $assoc_args, 'exclude' ); $args = $this->check_optional_args_and_all( $args, $all, 'activate', $all_exclude ); if ( ! $args ) { return; } $successes = 0; $errors = 0; $plugins = $this->fetcher->get_many( $args ); if ( count( $plugins ) < count( $args ) ) { $errors = count( $args ) - count( $plugins ); } foreach ( $plugins as $plugin ) { $status = $this->get_status( $plugin->file ); if ( $all && in_array( $status, [ 'active', 'active-network' ], true ) ) { continue; } // Network-active is the highest level of activation status. if ( 'active-network' === $status ) { WP_CLI::warning( "Plugin '{$plugin->name}' is already network active." ); continue; } // Don't reactivate active plugins, but do let them become network-active. if ( ! $network_wide && 'active' === $status ) { WP_CLI::warning( "Plugin '{$plugin->name}' is already active." ); continue; } // Plugins need to be deactivated before being network activated. if ( $network_wide && 'active' === $status ) { deactivate_plugins( $plugin->file, false, false ); } $result = activate_plugin( $plugin->file, '', $network_wide ); if ( is_wp_error( $result ) ) { $message = $result->get_error_message(); $message = preg_replace( '/<a\s[^>]+>.*<\/a>/im', '', $message ); $message = wp_strip_all_tags( $message ); $message = str_replace( 'Error: ', '', $message ); WP_CLI::warning( "Failed to activate plugin. {$message}" ); ++$errors; } else { $this->active_output( $plugin->name, $plugin->file, $network_wide, 'activate' ); ++$successes; } } if ( ! $this->chained_command ) { $verb = $network_wide ? 'network activate' : 'activate'; Utils\report_batch_operation_results( 'plugin', $verb, count( $args ), $successes, $errors ); } } /** * Deactivates one or more plugins. * * ## OPTIONS * * [<plugin>...] * : One or more plugins to deactivate. * * [--uninstall] * : Uninstall the plugin after deactivation. * * [--all] * : If set, all plugins will be deactivated. * * [--exclude=<name>] * : Comma separated list of plugin slugs that should be excluded from deactivation. * * [--network] * : If set, the plugin will be deactivated for the entire multisite network. * * ## EXAMPLES * * # Deactivate plugin * $ wp plugin deactivate hello * Plugin 'hello' deactivated. * Success: Deactivated 1 of 1 plugins. * * # Deactivate all plugins with exclusion * $ wp plugin deactivate --all --exclude=hello,wordpress-seo * Plugin 'contact-form-7' deactivated. * Plugin 'ninja-forms' deactivated. * Success: Deactivated 2 of 2 plugins. */ public function deactivate( $args, $assoc_args = array() ) { $network_wide = Utils\get_flag_value( $assoc_args, 'network' ); $disable_all = Utils\get_flag_value( $assoc_args, 'all' ); $disable_all_exclude = Utils\get_flag_value( $assoc_args, 'exclude' ); $args = $this->check_optional_args_and_all( $args, $disable_all, 'deactivate', $disable_all_exclude ); if ( ! $args ) { return; } $successes = 0; $errors = 0; $plugins = $this->fetcher->get_many( $args ); if ( count( $plugins ) < count( $args ) ) { $errors = count( $args ) - count( $plugins ); } foreach ( $plugins as $plugin ) { $status = $this->get_status( $plugin->file ); if ( $disable_all && ! in_array( $status, [ 'active', 'active-network' ], true ) ) { continue; } // Network active plugins must be explicitly deactivated. if ( ! $network_wide && 'active-network' === $status ) { WP_CLI::warning( "Plugin '{$plugin->name}' is network active and must be deactivated with --network flag." ); ++$errors; continue; } if ( ! in_array( $status, [ 'active', 'active-network' ], true ) ) { WP_CLI::warning( "Plugin '{$plugin->name}' isn't active." ); continue; } deactivate_plugins( $plugin->file, false, $network_wide ); if ( ! is_network_admin() ) { update_option( 'recently_activated', array( $plugin->file => time() ) + (array) get_option( 'recently_activated' ) ); } else { update_site_option( 'recently_activated', array( $plugin->file => time() ) + (array) get_site_option( 'recently_activated' ) ); } $this->active_output( $plugin->name, $plugin->file, $network_wide, 'deactivate' ); ++$successes; if ( Utils\get_flag_value( $assoc_args, 'uninstall' ) ) { WP_CLI::log( "Uninstalling '{$plugin->name}'..." ); $this->chained_command = true; $this->uninstall( array( $plugin->name ) ); $this->chained_command = false; } } if ( ! $this->chained_command ) { $verb = $network_wide ? 'network deactivate' : 'deactivate'; Utils\report_batch_operation_results( 'plugin', $verb, count( $args ), $successes, $errors ); } } /** * Toggles a plugin's activation state. * * If the plugin is active, then it will be deactivated. If the plugin is * inactive, then it will be activated. * * ## OPTIONS * * <plugin>... * : One or more plugins to toggle. * * [--network] * : If set, the plugin will be toggled for the entire multisite network. * * ## EXAMPLES * * # Akismet is currently activated * $ wp plugin toggle akismet * Plugin 'akismet' deactivated. * Success: Toggled 1 of 1 plugins. * * # Akismet is currently deactivated * $ wp plugin toggle akismet * Plugin 'akismet' activated. * Success: Toggled 1 of 1 plugins. */ public function toggle( $args, $assoc_args = array() ) { $network_wide = Utils\get_flag_value( $assoc_args, 'network' ); $successes = 0; $errors = 0; $plugins = $this->fetcher->get_many( $args ); if ( count( $plugins ) < count( $args ) ) { $errors = count( $args ) - count( $plugins ); } $this->chained_command = true; foreach ( $plugins as $plugin ) { if ( $this->check_active( $plugin->file, $network_wide ) ) { $this->deactivate( array( $plugin->name ), $assoc_args ); } else { $this->activate( array( $plugin->name ), $assoc_args ); } ++$successes; } $this->chained_command = false; Utils\report_batch_operation_results( 'plugin', 'toggle', count( $args ), $successes, $errors ); } /** * Gets the path to a plugin or to the plugin directory. * * ## OPTIONS * * [<plugin>] * : The plugin to get the path to. If not set, will return the path to the * plugins directory. * * [--dir] * : If set, get the path to the closest parent directory, instead of the * plugin file. * * ## EXAMPLES * * $ cd $(wp plugin path) && pwd * /var/www/wordpress/wp-content/plugins */ public function path( $args, $assoc_args ) { $path = untrailingslashit( WP_PLUGIN_DIR ); if ( ! empty( $args ) ) { $plugin = $this->fetcher->get_check( $args[0] ); $path .= '/' . $plugin->file; if ( Utils\get_flag_value( $assoc_args, 'dir' ) ) { $path = dirname( $path ); } } WP_CLI::line( $path ); } protected function install_from_repo( $slug, $assoc_args ) { global $wp_version; // Extract the major WordPress version (e.g., "6.3") from the full version string list($wp_core_version) = explode( '-', $wp_version ); $wp_core_version = implode( '.', array_slice( explode( '.', $wp_core_version ), 0, 2 ) ); $api = plugins_api( 'plugin_information', array( 'slug' => $slug ) ); if ( is_wp_error( $api ) ) { return $api; } if ( isset( $assoc_args['version'] ) ) { self::alter_api_response( $api, $assoc_args['version'] ); } elseif ( ! Utils\get_flag_value( $assoc_args, 'ignore-requirements', false ) ) { $requires_php = isset( $api->requires_php ) ? $api->requires_php : null; $requires_wp = isset( $api->requires ) ? $api->requires : null; $compatible_php = empty( $requires_php ) || version_compare( PHP_VERSION, $requires_php, '>=' ); $compatible_wp = empty( $requires_wp ) || version_compare( $wp_core_version, $requires_wp, '>=' ); if ( ! $compatible_wp ) { return new WP_Error( 'requirements_not_met', "This plugin does not work with your version of WordPress. Minimum WordPress requirement is $requires_wp" ); } if ( ! $compatible_php ) { return new WP_Error( 'requirements_not_met', "This plugin does not work with your version of PHP. Minimum PHP required is $compatible_php" ); } } $status = install_plugin_install_status( $api ); if ( ! Utils\get_flag_value( $assoc_args, 'force' ) && 'install' !== $status['status'] ) { // We know this will fail, so avoid a needless download of the package. return new WP_Error( 'already_installed', 'Plugin already installed.' ); } WP_CLI::log( sprintf( 'Installing %s (%s)', html_entity_decode( $api->name, ENT_QUOTES ), $api->version ) ); if ( Utils\get_flag_value( $assoc_args, 'version' ) !== 'dev' ) { WP_CLI::get_http_cache_manager()->whitelist_package( $api->download_link, $this->item_type, $api->slug, $api->version ); } // Ignore failures on accessing SSL "https://api.wordpress.org/plugins/update-check/1.1/" in `wp_update_plugins()` which seem to occur intermittently. set_error_handler( array( __CLASS__, 'error_handler' ), E_USER_WARNING | E_USER_NOTICE ); $result = $this->get_upgrader( $assoc_args )->install( $api->download_link ); restore_error_handler(); return $result; } /** * Updates one or more plugins. * * ## OPTIONS * * [<plugin>...] * : One or more plugins to update. * * [--all] * : If set, all plugins that have updates will be updated. * * [--exclude=<name>] * : Comma separated list of plugin names that should be excluded from updating. * * [--minor] * : Only perform updates for minor releases (e.g. from 1.3 to 1.4 instead of 2.0) * * [--patch] * : Only perform updates for patch releases (e.g. from 1.3 to 1.3.3 instead of 1.4) * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - summary * --- * * [--version=<version>] * : If set, the plugin will be updated to the specified version. * * [--dry-run] * : Preview which plugins would be updated. * * [--insecure] * : Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack. * * ## EXAMPLES * * $ wp plugin update bbpress --version=dev * Installing bbPress (Development Version) * Downloading install package from https://downloads.wordpress.org/plugin/bbpress.zip... * Unpacking the package... * Installing the plugin... * Removing the old version of the plugin... * Plugin updated successfully. * Success: Updated 1 of 2 plugins. * * $ wp plugin update --all * Enabling Maintenance mode... * Downloading update from https://downloads.wordpress.org/plugin/akismet.3.1.11.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the plugin... * Plugin updated successfully. * Downloading update from https://downloads.wordpress.org/plugin/nginx-champuru.3.2.0.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the plugin... * Plugin updated successfully. * Disabling Maintenance mode... * +------------------------+-------------+-------------+---------+ * | name | old_version | new_version | status | * +------------------------+-------------+-------------+---------+ * | akismet | 3.1.3 | 3.1.11 | Updated | * | nginx-cache-controller | 3.1.1 | 3.2.0 | Updated | * +------------------------+-------------+-------------+---------+ * Success: Updated 2 of 2 plugins. * * $ wp plugin update --all --exclude=akismet * Enabling Maintenance mode... * Downloading update from https://downloads.wordpress.org/plugin/nginx-champuru.3.2.0.zip... * Unpacking the update... * Installing the latest version... * Removing the old version of the plugin... * Plugin updated successfully. * Disabling Maintenance mode... * +------------------------+-------------+-------------+---------+ * | name | old_version | new_version | status | * +------------------------+-------------+-------------+---------+ * | nginx-cache-controller | 3.1.1 | 3.2.0 | Updated | * +------------------------+-------------+-------------+---------+ * * @alias upgrade */ public function update( $args, $assoc_args ) { $all = Utils\get_flag_value( $assoc_args, 'all', false ); $args = $this->check_optional_args_and_all( $args, $all ); if ( ! $args ) { return; } if ( isset( $assoc_args['version'] ) ) { foreach ( $this->fetcher->get_many( $args ) as $plugin ) { $assoc_args['force'] = 1; $this->install( array( $plugin->name ), $assoc_args ); } } else { parent::update_many( $args, $assoc_args ); } } protected function get_item_list() { global $wp_version; $items = []; $duplicate_names = []; $auto_updates = get_site_option( Plugin_AutoUpdates_Command::SITE_OPTION ); if ( ! is_array( $auto_updates ) ) { $auto_updates = []; } $recently_active = is_network_admin() ? get_site_option( 'recently_activated' ) : get_option( 'recently_activated' ); if ( false === $recently_active ) { $recently_active = []; } foreach ( $this->get_all_plugins() as $file => $details ) { $all_update_info = $this->get_update_info(); $update_info = ( isset( $all_update_info->response[ $file ] ) && null !== $all_update_info->response[ $file ] ) ? (array) $all_update_info->response[ $file ] : null; $name = Utils\get_plugin_name( $file ); $wporg_info = $this->get_wporg_data( $name ); $plugin_data = get_plugin_data( WP_PLUGIN_DIR . '/' . $file, false, false ); if ( ! isset( $duplicate_names[ $name ] ) ) { $duplicate_names[ $name ] = array(); } $requires = isset( $update_info ) && isset( $update_info['requires'] ) ? $update_info['requires'] : null; $requires_php = isset( $update_info ) && isset( $update_info['requires_php'] ) ? $update_info['requires_php'] : null; // If an update has requires_php set, check to see if the local version of PHP meets that requirement // The plugins update API already filters out plugins that don't meet WordPress requirements, but does not // filter out plugins based on PHP requirements -- so we must do that here $compatible_php = empty( $requires_php ) || version_compare( PHP_VERSION, $requires_php, '>=' ); if ( ! $compatible_php ) { $update = 'unavailable'; $update_unavailable_reason = sprintf( 'This update requires PHP version %s, but the version installed is %s.', $requires_php, PHP_VERSION ); } else { $update = $update_info ? 'available' : 'none'; } // requires and requires_php are only provided by the plugins update API in the case of an update available. // For display consistency, get these values from the current plugin file if they aren't in this response if ( null === $requires ) { $requires = ! empty( $plugin_data['RequiresWP'] ) ? $plugin_data['RequiresWP'] : ''; } if ( null === $requires_php ) { $requires_php = ! empty( $plugin_data['RequiresPHP'] ) ? $plugin_data['RequiresPHP'] : ''; } $duplicate_names[ $name ][] = $file; $items[ $file ] = [ 'name' => $name, 'status' => $this->get_status( $file ), 'update' => $update, 'update_version' => isset( $update_info ) && isset( $update_info['new_version'] ) ? $update_info['new_version'] : null, 'update_package' => isset( $update_info ) && isset( $update_info['package'] ) ? $update_info['package'] : null, 'version' => $details['Version'], 'update_id' => $file, 'title' => $details['Name'], 'description' => wordwrap( $details['Description'] ), 'file' => $file, 'auto_update' => in_array( $file, $auto_updates, true ), 'author' => $details['Author'], 'tested_up_to' => '', 'requires' => $requires, 'requires_php' => $requires_php, 'wporg_status' => $wporg_info['status'], 'wporg_last_updated' => $wporg_info['last_updated'], 'recently_active' => in_array( $file, array_keys( $recently_active ), true ), 'update_unavailable_reason' => isset( $update_unavailable_reason ) ? $update_unavailable_reason : '', ]; if ( $this->check_headers['tested_up_to'] ) { $plugin_readme = normalize_path( dirname( WP_PLUGIN_DIR . '/' . $file ) . '/readme.txt' ); if ( file_exists( $plugin_readme ) && is_readable( $plugin_readme ) ) { $readme_obj = new SplFileObject( $plugin_readme ); $readme_obj->setFlags( SplFileObject::READ_AHEAD | SplFileObject::SKIP_EMPTY ); $readme_line = 0; // Reading the whole file can exhaust the memory, so only read the first 100 lines of the file, // as the "Tested up to" header should be near the top. while ( $readme_line < 100 && ! $readme_obj->eof() ) { $line = $readme_obj->fgets(); // Similar to WP.org, it matches for both "Tested up to" and "Tested" header in the readme file. preg_match( '/^tested(:| up to:) (.*)$/i', strtolower( $line ), $matches ); if ( isset( $matches[2] ) && ! empty( $matches[2] ) ) { $items[ $file ]['tested_up_to'] = $matches[2]; break; } ++$readme_line; } $file_obj = null; } } if ( null === $update_info ) { // Get info for all plugins that don't have an update. $plugin_update_info = isset( $all_update_info->no_update[ $file ] ) ? $all_update_info->no_update[ $file ] : null; // Check if local version is newer than what is listed upstream. if ( null !== $plugin_update_info && version_compare( $details['Version'], $plugin_update_info->new_version, '>' ) ) { $items[ $file ]['update'] = static::INVALID_VERSION_MESSAGE; $items[ $file ]['requires'] = isset( $plugin_update_info->requires ) ? $plugin_update_info->requires : null; $items[ $file ]['requires_php'] = isset( $plugin_update_info->requires_php ) ? $plugin_update_info->requires_php : null; } // If there is a plugin in no_update with a newer version than the local copy, it is because the plugins update api // has already filtered it because the local WordPress version is too low if ( null !== $plugin_update_info && version_compare( $details['Version'], $plugin_update_info->new_version, '<' ) ) { $items[ $file ]['update'] = 'unavailable'; $items[ $file ]['update_version'] = $plugin_update_info->new_version; $items[ $file ]['requires'] = isset( $plugin_update_info->requires ) ? $plugin_update_info->requires : null; $items[ $file ]['requires_php'] = isset( $plugin_update_info->requires_php ) ? $plugin_update_info->requires_php : null; $reason = "This update requires WordPress version $plugin_update_info->requires, but the version installed is $wp_version."; $items[ $file ]['update_unavailable_reason'] = $reason; } } } foreach ( $duplicate_names as $name => $files ) { if ( count( $files ) <= 1 ) { continue; } foreach ( $files as $file ) { $items[ $file ]['name'] = str_replace( '.' . pathinfo( $file, PATHINFO_EXTENSION ), '', $file ); } } return $items; } /** * Get the wordpress.org status of a plugin. * * @param string $plugin_name The plugin slug. * * @return string The status of the plugin, includes the last update date. */ protected function get_wporg_data( $plugin_name ) { $data = [ 'status' => '', 'last_updated' => '', ]; if ( ! $this->check_wporg['status'] && ! $this->check_wporg['last_updated'] ) { return $data; } if ( $this->check_wporg ) { try { $plugin_data = ( new WpOrgApi() )->get_plugin_info( $plugin_name ); } catch ( Exception $e ) { // Request failed. The plugin is not (active) on .org. $plugin_data = false; } if ( $plugin_data ) { $data['status'] = 'active'; if ( ! $this->check_wporg['last_updated'] ) { return $data; // The plugin is active on .org, but we don't need the date. } } // Just because the plugin is not in the api, does not mean it was never on .org. } $request = wp_remote_get( "https://plugins.trac.wordpress.org/log/{$plugin_name}/?limit=1&mode=stop_on_copy&format=rss" ); $response_code = wp_remote_retrieve_response_code( $request ); if ( 404 === $response_code ) { return $data; // This plugin was never on .org, there is no date to check. } if ( 'active' !== $data['status'] ) { $data['status'] = 'closed'; // This plugin was on .org at some point, but not anymore. } if ( ! class_exists( 'SimpleXMLElement' ) ) { WP_CLI::error( "The PHP extension 'SimpleXMLElement' is not available but is required for XML-formatted output." ); } // Check the last update date. $r_body = wp_remote_retrieve_body( $request ); if ( strpos( $r_body, 'pubDate' ) !== false ) { // Very raw check, not validating the format or anything else. $xml = simplexml_load_string( $r_body ); $xml_pub_date = $xml->xpath( '//pubDate' ); if ( $xml_pub_date ) { $data['last_updated'] = wp_date( 'Y-m-d', (string) strtotime( $xml_pub_date[0] ) ); } } return $data; } protected function filter_item_list( $items, $args ) { $basenames = wp_list_pluck( $this->fetcher->get_many( $args ), 'file' ); return Utils\pick_fields( $items, $basenames ); } /** * Installs one or more plugins. * * ## OPTIONS * * <plugin|zip|url>... * : One or more plugins to install. Accepts a plugin slug, the path to a local zip file, or a URL to a remote zip file. * * [--version=<version>] * : If set, get that particular version from wordpress.org, instead of the * stable version. * * [--force] * : If set, the command will overwrite any installed version of the plugin, without prompting * for confirmation. * * [--ignore-requirements] * :If set, the command will install the plugin while ignoring any WordPress or PHP version requirements * specified by the plugin authors. * * [--activate] * : If set, the plugin will be activated immediately after install. * * [--activate-network] * : If set, the plugin will be network activated immediately after install * * [--insecure] * : Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack. * * ## EXAMPLES * * # Install the latest version from wordpress.org and activate * $ wp plugin install bbpress --activate * Installing bbPress (2.5.9) * Downloading install package from https://downloads.wordpress.org/plugin/bbpress.2.5.9.zip... * Using cached file '/home/vagrant/.wp-cli/cache/plugin/bbpress-2.5.9.zip'... * Unpacking the package... * Installing the plugin... * Plugin installed successfully. * Activating 'bbpress'... * Plugin 'bbpress' activated. * Success: Installed 1 of 1 plugins. * * # Install the development version from wordpress.org * $ wp plugin install bbpress --version=dev * Installing bbPress (Development Version) * Downloading install package from https://downloads.wordpress.org/plugin/bbpress.zip... * Unpacking the package... * Installing the plugin... * Plugin installed successfully. * Success: Installed 1 of 1 plugins. * * # Install from a local zip file * $ wp plugin install ../my-plugin.zip * Unpacking the package... * Installing the plugin... * Plugin installed successfully. * Success: Installed 1 of 1 plugins. * * # Install from a remote zip file * $ wp plugin install http://s3.amazonaws.com/bucketname/my-plugin.zip?AWSAccessKeyId=123&Expires=456&Signature=abcdef * Downloading install package from http://s3.amazonaws.com/bucketname/my-plugin.zip?AWSAccessKeyId=123&Expires=456&Signature=abcdef * Unpacking the package... * Installing the plugin... * Plugin installed successfully. * Success: Installed 1 of 1 plugins. * * # Update from a remote zip file * $ wp plugin install https://github.com/envato/wp-envato-market/archive/master.zip --force * Downloading install package from https://github.com/envato/wp-envato-market/archive/master.zip * Unpacking the package... * Installing the plugin... * Renamed Github-based project from 'wp-envato-market-master' to 'wp-envato-market'. * Plugin updated successfully * Success: Installed 1 of 1 plugins. * * # Forcefully re-install all installed plugins * $ wp plugin install $(wp plugin list --field=name) --force * Installing Akismet (3.1.11) * Downloading install package from https://downloads.wordpress.org/plugin/akismet.3.1.11.zip... * Unpacking the package... * Installing the plugin... * Removing the old version of the plugin... * Plugin updated successfully * Success: Installed 1 of 1 plugins. */ public function install( $args, $assoc_args ) { if ( ! is_dir( WP_PLUGIN_DIR ) ) { wp_mkdir_p( WP_PLUGIN_DIR ); } parent::install( $args, $assoc_args ); } /** * Gets details about an installed plugin. * * ## OPTIONS * * <plugin> * : The plugin to get. * * [--field=<field>] * : Instead of returning the whole plugin, returns the value of a single field. * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for the plugin: * * * name * * title * * author * * version * * description * * status * * These fields are optionally available: * * * requires_wp * * requires_php * * requires_plugins * * ## EXAMPLES * * # Get plugin details. * $ wp plugin get bbpress --format=json * {"name":"bbpress","title":"bbPress","author":"The bbPress Contributors","version":"2.6.9","description":"bbPress is forum software with a twist from the creators of WordPress.","status":"active"} */ public function get( $args, $assoc_args ) { $default_fields = array( 'name', 'title', 'author', 'version', 'description', 'status', ); $plugin = $this->fetcher->get_check( $args[0] ); $file = $plugin->file; $plugin_data = get_plugin_data( WP_PLUGIN_DIR . '/' . $file, false, false ); $plugin_obj = (object) [ 'name' => Utils\get_plugin_name( $file ), 'title' => $plugin_data['Name'], 'author' => $plugin_data['Author'], 'version' => $plugin_data['Version'], 'description' => wordwrap( $plugin_data['Description'] ), 'status' => $this->get_status( $file ), 'requires_wp' => ! empty( $plugin_data['RequiresWP'] ) ? $plugin_data['RequiresWP'] : '', 'requires_php' => ! empty( $plugin_data['RequiresPHP'] ) ? $plugin_data['RequiresPHP'] : '', 'requires_plugins' => ! empty( $plugin_data['RequiresPlugins'] ) ? $plugin_data['RequiresPlugins'] : '', ]; if ( empty( $assoc_args['fields'] ) ) { $assoc_args['fields'] = $default_fields; } $formatter = $this->get_formatter( $assoc_args ); $formatter->display_item( $plugin_obj ); } /** * Uninstalls one or more plugins. * * ## OPTIONS * * [<plugin>...] * : One or more plugins to uninstall. * * [--deactivate] * : Deactivate the plugin before uninstalling. Default behavior is to warn and skip if the plugin is active. * * [--skip-delete] * : If set, the plugin files will not be deleted. Only the uninstall procedure * will be run. * * [--all] * : If set, all plugins will be uninstalled. * * [--exclude=<name>] * : Comma separated list of plugin slugs to be excluded from uninstall. * * ## EXAMPLES * * $ wp plugin uninstall hello * Uninstalled and deleted 'hello' plugin. * Success: Uninstalled 1 of 1 plugins. * * # Uninstall all plugins excluding specified ones * $ wp plugin uninstall --all --exclude=hello-dolly,jetpack * Uninstalled and deleted 'akismet' plugin. * Uninstalled and deleted 'tinymce-templates' plugin. * Success: Uninstalled 2 of 2 plugins. */ public function uninstall( $args, $assoc_args = array() ) { $all = Utils\get_flag_value( $assoc_args, 'all', false ); $all_exclude = Utils\get_flag_value( $assoc_args, 'exclude', false ); // Check if plugin names or --all is passed. $args = $this->check_optional_args_and_all( $args, $all, 'uninstall', $all_exclude ); if ( ! $args ) { return; } $successes = 0; $errors = 0; $delete_errors = array(); $deleted_plugin_files = array(); $plugins = $this->fetcher->get_many( $args ); if ( count( $plugins ) < count( $args ) ) { $errors = count( $args ) - count( $plugins ); } foreach ( $plugins as $plugin ) { if ( is_plugin_active( $plugin->file ) && ! WP_CLI\Utils\get_flag_value( $assoc_args, 'deactivate' ) ) { WP_CLI::warning( "The '{$plugin->name}' plugin is active." ); ++$errors; continue; } if ( Utils\get_flag_value( $assoc_args, 'deactivate' ) ) { WP_CLI::log( "Deactivating '{$plugin->name}'..." ); $this->chained_command = true; $this->deactivate( array( $plugin->name ) ); $this->chained_command = false; } uninstall_plugin( $plugin->file ); $plugin_translations = wp_get_installed_translations( 'plugins' ); $plugin_slug = dirname( $plugin->file ); if ( 'hello.php' === $plugin->file ) { $plugin_slug = 'hello-dolly'; } // Remove language files, silently. if ( '.' !== $plugin_slug && ! empty( $plugin_translations[ $plugin_slug ] ) ) { $translations = $plugin_translations[ $plugin_slug ]; global $wp_filesystem; require_once ABSPATH . '/wp-admin/includes/file.php'; WP_Filesystem(); foreach ( $translations as $translation => $data ) { $wp_filesystem->delete( WP_LANG_DIR . '/plugins/' . $plugin_slug . '-' . $translation . '.po' ); $wp_filesystem->delete( WP_LANG_DIR . '/plugins/' . $plugin_slug . '-' . $translation . '.mo' ); $wp_filesystem->delete( WP_LANG_DIR . '/plugins/' . $plugin_slug . '-' . $translation . '.l10n.php' ); $json_translation_files = glob( WP_LANG_DIR . '/plugins/' . $plugin_slug . '-' . $translation . '-*.json' ); if ( $json_translation_files ) { array_map( array( $wp_filesystem, 'delete' ), $json_translation_files ); } } } if ( ! Utils\get_flag_value( $assoc_args, 'skip-delete' ) ) { if ( $this->delete_plugin( $plugin ) ) { $deleted_plugin_files[] = $plugin->file; WP_CLI::log( "Uninstalled and deleted '$plugin->name' plugin." ); } else { $delete_errors[] = $plugin->file; WP_CLI::log( "Ran uninstall procedure for '$plugin->name' plugin. Deletion of plugin files failed" ); ++$errors; continue; } } else { WP_CLI::log( "Ran uninstall procedure for '$plugin->name' plugin without deleting." ); } ++$successes; } // Remove deleted plugins from the plugin updates list. $current = get_site_transient( $this->upgrade_transient ); if ( $current ) { // Don't remove the plugins that weren't deleted. $deleted = array_diff( $deleted_plugin_files, $delete_errors ); foreach ( $deleted as $plugin_file ) { unset( $current->response[ $plugin_file ] ); unset( $current->checked[ $plugin_file ] ); } set_site_transient( $this->upgrade_transient, $current ); } if ( ! $this->chained_command ) { Utils\report_batch_operation_results( 'plugin', 'uninstall', count( $args ), $successes, $errors ); } } /** * Checks if a given plugin is installed. * * Returns exit code 0 when installed, 1 when uninstalled. * * ## OPTIONS * * <plugin> * : The plugin to check. * * ## EXAMPLES * * # Check whether plugin is installed; exit status 0 if installed, otherwise 1 * $ wp plugin is-installed hello * $ echo $? * 1 * * @subcommand is-installed */ public function is_installed( $args, $assoc_args = array() ) { if ( $this->fetcher->get( $args[0] ) ) { WP_CLI::halt( 0 ); } else { WP_CLI::halt( 1 ); } } /** * Checks if a given plugin is active. * * Returns exit code 0 when active, 1 when not active. * * ## OPTIONS * * <plugin> * : The plugin to check. * * [--network] * : If set, check if plugin is network-activated. * * ## EXAMPLES * * # Check whether plugin is Active; exit status 0 if active, otherwise 1 * $ wp plugin is-active hello * $ echo $? * 1 * * @subcommand is-active */ public function is_active( $args, $assoc_args = array() ) { $network_wide = Utils\get_flag_value( $assoc_args, 'network' ); $plugin = $this->fetcher->get( $args[0] ); if ( ! $plugin ) { WP_CLI::halt( 1 ); } $this->check_active( $plugin->file, $network_wide ) ? WP_CLI::halt( 0 ) : WP_CLI::halt( 1 ); } /** * Deletes plugin files without deactivating or uninstalling. * * ## OPTIONS * * [<plugin>...] * : One or more plugins to delete. * * [--all] * : If set, all plugins will be deleted. * * [--exclude=<name>] * : Comma separated list of plugin slugs to be excluded from deletion. * * ## EXAMPLES * * # Delete plugin * $ wp plugin delete hello * Deleted 'hello' plugin. * Success: Deleted 1 of 1 plugins. * * # Delete inactive plugins * $ wp plugin delete $(wp plugin list --status=inactive --field=name) * Deleted 'tinymce-templates' plugin. * Success: Deleted 1 of 1 plugins. * * # Delete all plugins excluding specified ones * $ wp plugin delete --all --exclude=hello-dolly,jetpack * Deleted 'akismet' plugin. * Deleted 'tinymce-templates' plugin. * Success: Deleted 2 of 2 plugins. */ public function delete( $args, $assoc_args = array() ) { $all = Utils\get_flag_value( $assoc_args, 'all', false ); $all_exclude = Utils\get_flag_value( $assoc_args, 'exclude', false ); // Check if plugin names or --all is passed. $args = $this->check_optional_args_and_all( $args, $all, 'delete', $all_exclude ); if ( ! $args ) { return; } $successes = 0; $errors = 0; foreach ( $this->fetcher->get_many( $args ) as $plugin ) { if ( $this->delete_plugin( $plugin ) ) { WP_CLI::log( "Deleted '{$plugin->name}' plugin." ); ++$successes; } else { WP_CLI::warning( "The '{$plugin->name}' plugin could not be deleted." ); ++$errors; } } if ( ! $this->chained_command ) { Utils\report_batch_operation_results( 'plugin', 'delete', count( $args ), $successes, $errors ); } } /** * Gets a list of plugins. * * Displays a list of the plugins installed on the site with activation * status, whether or not there's an update available, etc. * * Use `--status=dropin` to list installed dropins (e.g. `object-cache.php`). * * ## OPTIONS * * [--<field>=<value>] * : Filter results based on the value of a field. * * [--field=<field>] * : Prints the value of a single field for each plugin. * * [--fields=<fields>] * : Limit the output to specific object fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - count * - json * - yaml * --- * * [--status=<status>] * : Filter the output by plugin status. * --- * options: * - active * - active-network * - dropin * - inactive * - must-use * --- * * [--skip-update-check] * : If set, the plugin update check will be skipped. * * [--recently-active] * : If set, only recently active plugins will be shown and the status filter will be ignored. * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each plugin: * * * name * * status * * update * * version * * update_version * * auto_update * * These fields are optionally available: * * * update_package * * update_id * * title * * description * * file * * author * * tested_up_to * * requires * * requires_php * * wporg_status * * wporg_last_updated * * ## EXAMPLES * * # List active plugins on the site. * $ wp plugin list --status=active --format=json * [{"name":"dynamic-hostname","status":"active","update":"none","version":"0.4.2","update_version":"","auto_update":"off"},{"name":"tinymce-templates","status":"active","update":"none","version":"4.8.1","update_version":"","auto_update":"off"},{"name":"wp-multibyte-patch","status":"active","update":"none","version":"2.9","update_version":"","auto_update":"off"},{"name":"wp-total-hacks","status":"active","update":"none","version":"4.7.2","update_version":"","auto_update":"off"}] * * # List plugins on each site in a network. * $ wp site list --field=url | xargs -I % wp plugin list --url=% * +---------+----------------+-----------+---------+-----------------+------------+ * | name | status | update | version | update_version | auto_update | * +---------+----------------+-----------+---------+----------------+-------------+ * | akismet | active-network | none | 5.3.1 | | on | * | hello | inactive | available | 1.6 | 1.7.2 | off | * +---------+----------------+-----------+---------+----------------+-------------+ * +---------+----------------+-----------+---------+----------------+-------------+ * | name | status | update | version | update_version | auto_update | * +---------+----------------+-----------+---------+----------------+-------------+ * | akismet | active-network | none | 5.3.1 | | on | * | hello | inactive | available | 1.6 | 1.7.2 | off | * +---------+----------------+-----------+---------+----------------+-------------+ * * # Check whether plugins are still active on WordPress.org * $ wp plugin list --fields=name,wporg_status,wporg_last_updated * +--------------------+--------------+--------------------+ * | name | wporg_status | wporg_last_updated | * +--------------------+--------------+--------------------+ * | akismet | active | 2023-12-11 | * | user-switching | active | 2023-11-17 | * | wordpress-importer | active | 2023-04-28 | * | local | | | * +--------------------+--------------+--------------------+ * * # List recently active plugins on the site. * $ wp plugin list --recently-active --field=name --format=json * ["akismet","bbpress","buddypress"] * * @subcommand list */ public function list_( $_, $assoc_args ) { $fields = Utils\get_flag_value( $assoc_args, 'fields' ); if ( ! empty( $fields ) ) { $fields = explode( ',', $fields ); $this->check_wporg['status'] = in_array( 'wporg_status', $fields, true ); $this->check_wporg['last_updated'] = in_array( 'wporg_last_updated', $fields, true ); $this->check_headers['tested_up_to'] = in_array( 'tested_up_to', $fields, true ); } $field = Utils\get_flag_value( $assoc_args, 'field' ); if ( 'wporg_status' === $field ) { $this->check_wporg['status'] = true; } elseif ( 'wporg_last_updated' === $field ) { $this->check_wporg['last_updated'] = true; } $this->check_headers['tested_up_to'] = 'tested_up_to' === $field || $this->check_headers['tested_up_to']; parent::_list( $_, $assoc_args ); } /* PRIVATES */ private function check_active( $file, $network_wide ) { $required = $network_wide ? 'active-network' : 'active'; return $required === $this->get_status( $file ); } private function active_output( $name, $file, $network_wide, $action ) { $network_wide = $network_wide || ( is_multisite() && is_network_only_plugin( $file ) ); $check = $this->check_active( $file, $network_wide ); if ( ( 'activate' === $action ) ? $check : ! $check ) { if ( $network_wide ) { WP_CLI::log( "Plugin '{$name}' network {$action}d." ); } else { WP_CLI::log( "Plugin '{$name}' {$action}d." ); } } else { WP_CLI::warning( "Could not {$action} the '{$name}' plugin." ); } } protected function get_status( $file ) { if ( is_plugin_active_for_network( $file ) ) { return 'active-network'; } if ( is_plugin_active( $file ) ) { return 'active'; } return 'inactive'; } /** * Gets the template path based on installation type. */ private static function get_template_path( $template ) { $command_root = Utils\phar_safe_path( dirname( __DIR__ ) ); $template_path = "{$command_root}/templates/{$template}"; if ( ! file_exists( $template_path ) ) { WP_CLI::error( "Couldn't find {$template}" ); } return $template_path; } /** * Gets the details of a plugin. * * @param object * @return array */ private function get_details( $file ) { $plugin_folder = get_plugins( '/' . plugin_basename( dirname( $file ) ) ); $plugin_file = Utils\basename( $file ); return $plugin_folder[ $plugin_file ]; } /** * Performs deletion of plugin files * * @param $plugin - Plugin fetcher object (name, file) * @return bool - If plugin was deleted */ private function delete_plugin( $plugin ) { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound do_action( 'delete_plugin', $plugin->file ); $plugin_dir = dirname( $plugin->file ); if ( '.' === $plugin_dir ) { $plugin_dir = $plugin->file; } $path = path_join( WP_PLUGIN_DIR, $plugin_dir ); if ( Utils\is_windows() ) { // Handles plugins that are not in own folders // e.g. Hello Dolly -> plugins/hello.php if ( is_file( $path ) ) { $command = 'del /f /q '; } else { $command = 'rd /s /q '; } $path = str_replace( '/', '\\', $path ); } else { $command = 'rm -rf '; } $result = ! WP_CLI::launch( $command . escapeshellarg( $path ), false ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound do_action( 'deleted_plugin', $plugin->file, $result ); return $result; } } <?php use WP_CLI\Dispatcher\CommandNamespace; /** * Downloads, installs, updates, and manages a WordPress installation. */ final class Core_Command_Namespace extends CommandNamespace { } <?php namespace WP_CLI\Fetchers; /** * Fetch a WordPress plugin based on one of its attributes. * * This is a special version of the plugin fetcher. It doesn't use the * `all_plugins` filter, so that plugins cannot hide themselves from the * checks. * */ class UnfilteredPlugin extends Base { /** * @var string $msg Error message to use when invalid data is provided */ protected $msg = "The '%s' plugin could not be found."; /** * Get a plugin object by name. * * @param string $name * * @return object|false */ public function get( $name ) { foreach ( get_plugins() as $file => $_ ) { if ( "{$name}.php" === $file || ( $name && $file === $name ) || ( dirname( $file ) === $name && '.' !== $name ) ) { return (object) compact( 'name', 'file' ); } } return false; } } <?php use WP_CLI\Utils; use WP_CLI\WpOrgApi; /** * Verifies core file integrity by comparing to published checksums. * * @package wp-cli */ class Checksum_Core_Command extends Checksum_Base_Command { /** * Whether or not to verify contents of the root directory. * * @var boolean */ private $include_root = false; /** * Files to exclude from the verification. * * @var array */ private $exclude_files = []; /** * Verifies WordPress files against WordPress.org's checksums. * * Downloads md5 checksums for the current version from WordPress.org, and * compares those checksums against the currently installed files. * * For security, avoids loading WordPress when verifying checksums. * * If you experience issues verifying from this command, ensure you are * passing the relevant `--locale` and `--version` arguments according to * the values from the `Dashboard->Updates` menu in the admin area of the * site. * * ## OPTIONS * * [--include-root] * : Verify all files and folders in the root directory, and warn if any non-WordPress items are found. * * [--version=<version>] * : Verify checksums against a specific version of WordPress. * * [--locale=<locale>] * : Verify checksums against a specific locale of WordPress. * * [--insecure] * : Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack. * * [--exclude=<files>] * : Exclude specific files from the checksum verification. Provide a comma-separated list of file paths. * * ## EXAMPLES * * # Verify checksums * $ wp core verify-checksums * Success: WordPress installation verifies against checksums. * * # Verify checksums for given WordPress version * $ wp core verify-checksums --version=4.0 * Success: WordPress installation verifies against checksums. * * # Verify checksums for given locale * $ wp core verify-checksums --locale=en_US * Success: WordPress installation verifies against checksums. * * # Verify checksums for given locale * $ wp core verify-checksums --locale=ja * Warning: File doesn't verify against checksum: wp-includes/version.php * Warning: File doesn't verify against checksum: readme.html * Warning: File doesn't verify against checksum: wp-config-sample.php * Error: WordPress installation doesn't verify against checksums. * * # Verify checksums and exclude files * $ wp core verify-checksums --exclude="readme.html" * Success: WordPress installation verifies against checksums. * * @when before_wp_load */ public function __invoke( $args, $assoc_args ) { $wp_version = ''; $locale = ''; if ( ! empty( $assoc_args['version'] ) ) { $wp_version = $assoc_args['version']; } if ( ! empty( $assoc_args['locale'] ) ) { $locale = $assoc_args['locale']; } if ( ! empty( $assoc_args['include-root'] ) ) { $this->include_root = true; } if ( ! empty( $assoc_args['exclude'] ) ) { $this->exclude_files = explode( ',', Utils\get_flag_value( $assoc_args, 'exclude', '' ) ); } if ( empty( $wp_version ) ) { $details = self::get_wp_details(); $wp_version = $details['wp_version']; if ( empty( $locale ) ) { $locale = $details['wp_local_package']; } } $insecure = (bool) Utils\get_flag_value( $assoc_args, 'insecure', false ); $wp_org_api = new WpOrgApi( [ 'insecure' => $insecure ] ); try { $checksums = $wp_org_api->get_core_checksums( $wp_version, empty( $locale ) ? 'en_US' : $locale ); } catch ( Exception $exception ) { WP_CLI::error( $exception ); } if ( ! is_array( $checksums ) ) { WP_CLI::error( "Couldn't get checksums from WordPress.org." ); } $has_errors = false; foreach ( $checksums as $file => $checksum ) { // Skip files which get updated if ( 'wp-content' === substr( $file, 0, 10 ) ) { continue; } if ( in_array( $file, $this->exclude_files, true ) ) { continue; } if ( ! file_exists( ABSPATH . $file ) ) { WP_CLI::warning( "File doesn't exist: {$file}" ); $has_errors = true; continue; } $md5_file = md5_file( ABSPATH . $file ); if ( $md5_file !== $checksum ) { WP_CLI::warning( "File doesn't verify against checksum: {$file}" ); $has_errors = true; } } $core_checksums_files = array_filter( array_keys( $checksums ), [ $this, 'filter_file' ] ); $core_files = $this->get_files( ABSPATH ); $additional_files = array_diff( $core_files, $core_checksums_files ); if ( ! empty( $additional_files ) ) { foreach ( $additional_files as $additional_file ) { if ( in_array( $additional_file, $this->exclude_files, true ) ) { continue; } WP_CLI::warning( "File should not exist: {$additional_file}" ); } } if ( ! $has_errors ) { WP_CLI::success( 'WordPress installation verifies against checksums.' ); } else { WP_CLI::error( "WordPress installation doesn't verify against checksums." ); } } /** * Whether to include the file in the verification or not. * * @param string $filepath Path to a file. * * @return bool */ protected function filter_file( $filepath ) { if ( true === $this->include_root ) { return ( 1 !== preg_match( '/^(\.htaccess$|\.maintenance$|wp-config\.php$|wp-content\/)/', $filepath ) ); } return ( 0 === strpos( $filepath, 'wp-admin/' ) || 0 === strpos( $filepath, 'wp-includes/' ) || 1 === preg_match( '/^wp-(?!config\.php)([^\/]*)$/', $filepath ) ); } /** * Gets version information from `wp-includes/version.php`. * * @return array { * @type string $wp_version The WordPress version. * @type int $wp_db_version The WordPress DB revision. * @type string $tinymce_version The TinyMCE version. * @type string $wp_local_package The TinyMCE version. * } */ private static function get_wp_details() { $versions_path = ABSPATH . 'wp-includes/version.php'; if ( ! is_readable( $versions_path ) ) { WP_CLI::error( "This does not seem to be a WordPress install.\n" . 'Pass --path=`path/to/wordpress` or run `wp core download`.' ); } $version_content = file_get_contents( $versions_path, false, null, 6, 2048 ); $vars = [ 'wp_version', 'wp_db_version', 'tinymce_version', 'wp_local_package' ]; $result = []; foreach ( $vars as $var_name ) { $result[ $var_name ] = self::find_var( $var_name, $version_content ); } return $result; } /** * Searches for the value assigned to variable `$var_name` in PHP code `$code`. * * This is equivalent to matching the `\$VAR_NAME = ([^;]+)` regular expression and returning * the first match either as a `string` or as an `integer` (depending if it's surrounded by * quotes or not). * * @param string $var_name Variable name to search for. * @param string $code PHP code to search in. * * @return int|string|null */ private static function find_var( $var_name, $code ) { $start = strpos( $code, '$' . $var_name . ' = ' ); if ( ! $start ) { return null; } $start = $start + strlen( $var_name ) + 3; $end = strpos( $code, ';', $start ); $value = substr( $code, $start, $end - $start ); return trim( $value, " '" ); } } <?php use WP_CLI\Dispatcher\CommandNamespace; /** * Manages plugins, including installs, activations, and updates. */ final class Plugin_Command_Namespace extends CommandNamespace { } <?php use WP_CLI\Fetchers; use WP_CLI\Formatter; use WP_CLI\Utils; use WP_CLI\WpOrgApi; /** * Verifies plugin file integrity by comparing to published checksums. * * @package wp-cli */ class Checksum_Plugin_Command extends Checksum_Base_Command { /** * Cached plugin data for all installed plugins. * * @var array|null */ private $plugins_data; /** * Array of detected errors. * * @var array */ private $errors = array(); /** * Verifies plugin files against WordPress.org's checksums. * * ## OPTIONS * * [<plugin>...] * : One or more plugins to verify. * * [--all] * : If set, all plugins will be verified. * * [--strict] * : If set, even "soft changes" like readme.txt changes will trigger * checksum errors. * * [--version=<version>] * : Verify checksums against a specific plugin version. * * [--format=<format>] * : Render output in a specific format. * --- * default: table * options: * - table * - json * - csv * - yaml * - count * --- * * [--insecure] * : Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack. * * [--exclude=<name>] * : Comma separated list of plugin names that should be excluded from verifying. * * ## EXAMPLES * * # Verify the checksums of all installed plugins * $ wp plugin verify-checksums --all * Success: Verified 8 of 8 plugins. * * # Verify the checksums of a single plugin, Akismet in this case * $ wp plugin verify-checksums akismet * Success: Verified 1 of 1 plugins. */ public function __invoke( $args, $assoc_args ) { $fetcher = new Fetchers\UnfilteredPlugin(); $all = (bool) Utils\get_flag_value( $assoc_args, 'all', false ); $strict = (bool) Utils\get_flag_value( $assoc_args, 'strict', false ); $insecure = (bool) Utils\get_flag_value( $assoc_args, 'insecure', false ); $plugins = $fetcher->get_many( $all ? $this->get_all_plugin_names() : $args ); $exclude = Utils\get_flag_value( $assoc_args, 'exclude', '' ); $version_arg = isset( $assoc_args['version'] ) ? $assoc_args['version'] : ''; if ( empty( $plugins ) && ! $all ) { WP_CLI::error( 'You need to specify either one or more plugin slugs to check or use the --all flag to check all plugins.' ); } $exclude_list = explode( ',', $exclude ); $skips = 0; foreach ( $plugins as $plugin ) { $version = empty( $version_arg ) ? $this->get_plugin_version( $plugin->file ) : $version_arg; if ( in_array( $plugin->name, $exclude_list, true ) ) { ++$skips; continue; } if ( 'hello' === $plugin->name ) { $this->verify_hello_dolly_from_core( $assoc_args ); continue; } if ( false === $version ) { WP_CLI::warning( "Could not retrieve the version for plugin {$plugin->name}, skipping." ); ++$skips; continue; } $wp_org_api = new WpOrgApi( [ 'insecure' => $insecure ] ); try { $checksums = $wp_org_api->get_plugin_checksums( $plugin->name, $version ); } catch ( Exception $exception ) { WP_CLI::warning( $exception->getMessage() ); $checksums = false; } if ( false === $checksums ) { WP_CLI::warning( "Could not retrieve the checksums for version {$version} of plugin {$plugin->name}, skipping." ); ++$skips; continue; } $files = $this->get_plugin_files( $plugin->file ); foreach ( $files as $file ) { if ( ! array_key_exists( $file, $checksums ) ) { $this->add_error( $plugin->name, $file, 'File was added' ); continue; } if ( ! $strict && $this->is_soft_change_file( $file ) ) { continue; } $result = $this->check_file_checksum( dirname( $plugin->file ) . '/' . $file, $checksums[ $file ] ); if ( true !== $result ) { $this->add_error( $plugin->name, $file, is_string( $result ) ? $result : 'Checksum does not match' ); } } } if ( ! empty( $this->errors ) ) { $formatter = new Formatter( $assoc_args, array( 'plugin_name', 'file', 'message' ) ); $formatter->display_items( $this->errors ); } $total = count( $plugins ); $failures = count( array_unique( array_column( $this->errors, 'plugin_name' ) ) ); $successes = $total - $failures - $skips; Utils\report_batch_operation_results( 'plugin', 'verify', $total, $successes, $failures, $skips ); } private function verify_hello_dolly_from_core( $assoc_args ) { $file = 'hello.php'; $wp_version = get_bloginfo( 'version', 'display' ); $insecure = (bool) Utils\get_flag_value( $assoc_args, 'insecure', false ); $wp_org_api = new WpOrgApi( [ 'insecure' => $insecure ] ); $locale = ''; try { $checksums = $wp_org_api->get_core_checksums( $wp_version, empty( $locale ) ? 'en_US' : $locale ); } catch ( Exception $exception ) { WP_CLI::error( $exception ); } if ( ! is_array( $checksums ) || ! isset( $checksums['wp-content/plugins/hello.php'] ) ) { WP_CLI::error( "Couldn't get hello.php checksum from WordPress.org." ); } $md5_file = md5_file( $this->get_absolute_path( '/' ) . $file ); if ( $md5_file !== $checksums['wp-content/plugins/hello.php'] ) { $this->add_error( 'hello', $file, 'Checksum does not match' ); } } /** * Adds a new error to the array of detected errors. * * @param string $plugin_name Name of the plugin that had the error. * @param string $file Relative path to the file that had the error. * @param string $message Message explaining the error. */ private function add_error( $plugin_name, $file, $message ) { $error['plugin_name'] = $plugin_name; $error['file'] = $file; $error['message'] = $message; $this->errors[] = $error; } /** * Gets the currently installed version for a given plugin. * * @param string $path Relative path to plugin file to get the version for. * * @return string|false Installed version of the plugin, or false if not * found. */ private function get_plugin_version( $path ) { if ( ! isset( $this->plugins_data ) ) { $this->plugins_data = get_plugins(); } if ( ! array_key_exists( $path, $this->plugins_data ) ) { return false; } return $this->plugins_data[ $path ]['Version']; } /** * Gets the names of all installed plugins. * * @return array<string> Names of all installed plugins. */ private function get_all_plugin_names() { $names = array(); foreach ( get_plugins() as $file => $details ) { $names[] = Utils\get_plugin_name( $file ); } return $names; } /** * Gets the list of files that are part of the given plugin. * * @param string $path Relative path to the main plugin file. * * @return array<string> Array of files with their relative paths. */ private function get_plugin_files( $path ) { $folder = dirname( $this->get_absolute_path( $path ) ); // Return single file plugins immediately, to avoid iterating over the // entire plugins folder. if ( WP_PLUGIN_DIR === $folder ) { return (array) $path; } return $this->get_files( trailingslashit( $folder ) ); } /** * Checks the integrity of a single plugin file by comparing it to the * officially provided checksum. * * @param string $path Relative path to the plugin file to check the * integrity of. * @param array $checksums Array of provided checksums to compare against. * * @return true|string */ private function check_file_checksum( $path, $checksums ) { if ( $this->supports_sha256() && array_key_exists( 'sha256', $checksums ) ) { $sha256 = $this->get_sha256( $this->get_absolute_path( $path ) ); return in_array( $sha256, (array) $checksums['sha256'], true ); } if ( ! array_key_exists( 'md5', $checksums ) ) { return 'No matching checksum algorithm found'; } $md5 = $this->get_md5( $this->get_absolute_path( $path ) ); return in_array( $md5, (array) $checksums['md5'], true ); } /** * Checks whether the current environment supports 256-bit SHA-2. * * Should be supported for PHP 5+, but we might find edge cases depending on * host. * * @return bool */ private function supports_sha256() { return true; } /** * Gets the 256-bit SHA-2 of a given file. * * @param string $filepath Absolute path to the file to calculate the SHA-2 * for. * * @return string */ private function get_sha256( $filepath ) { return hash_file( 'sha256', $filepath ); } /** * Gets the MD5 of a given file. * * @param string $filepath Absolute path to the file to calculate the MD5 * for. * * @return string */ private function get_md5( $filepath ) { return hash_file( 'md5', $filepath ); } /** * Gets the absolute path to a relative plugin file. * * @param string $path Relative path to get the absolute path for. * * @return string */ private function get_absolute_path( $path ) { return WP_PLUGIN_DIR . '/' . $path; } /** * Returns a list of files that only trigger checksum errors in strict mode. * * @return array<string> Array of file names. */ private function get_soft_change_files() { static $files = array( 'readme.txt', 'readme.md', ); return $files; } /** * Checks whether a given file will only trigger checksum errors in strict * mode. * * @param string $file File to check. * * @return bool Whether the file only triggers checksum errors in strict * mode. */ private function is_soft_change_file( $file ) { return in_array( strtolower( $file ), $this->get_soft_change_files(), true ); } } <?php use WP_CLI\Utils; /** * Base command that all checksum commands rely on. * * @package wp-cli */ class Checksum_Base_Command extends WP_CLI_Command { /** * Normalizes directory separators to slashes. * * @param string $path Path to convert. * * @return string Path with all backslashes replaced by slashes. */ public static function normalize_directory_separators( $path ) { return str_replace( '\\', '/', $path ); } /** * Read a remote file and return its contents. * * @param string $url URL of the remote file to read. * * @return mixed */ protected static function _read( $url ) { // phpcs:ignore PSR2.Methods.MethodDeclaration.Underscore -- Could be used in classes extending this class. $headers = array( 'Accept' => 'application/json' ); $response = Utils\http_request( 'GET', $url, null, $headers, array( 'timeout' => 30 ) ); if ( 200 === $response->status_code ) { return $response->body; } WP_CLI::error( "Couldn't fetch response from {$url} (HTTP code {$response->status_code})." ); } /** * Recursively get the list of files for a given path. * * @param string $path Root path to start the recursive traversal in. * * @return array<string> */ protected function get_files( $path ) { $filtered_files = array(); try { $files = new RecursiveIteratorIterator( new RecursiveCallbackFilterIterator( new RecursiveDirectoryIterator( $path, RecursiveDirectoryIterator::SKIP_DOTS ), function ( $current ) use ( $path ) { return $this->filter_file( self::normalize_directory_separators( substr( $current->getPathname(), strlen( $path ) ) ) ); } ), RecursiveIteratorIterator::CHILD_FIRST ); foreach ( $files as $file_info ) { if ( $file_info->isFile() ) { $filtered_files[] = self::normalize_directory_separators( substr( $file_info->getPathname(), strlen( $path ) ) ); } } } catch ( Exception $e ) { WP_CLI::error( $e->getMessage() ); } return $filtered_files; } /** * Whether to include the file in the verification or not. * * Can be overridden in subclasses. * * @param string $filepath Path to a file. * * @return bool */ protected function filter_file( $filepath ) { return true; } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_checksum_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_checksum_autoloader ) ) { require_once $wpcli_checksum_autoloader; } WP_CLI::add_command( 'core', 'Core_Command_Namespace' ); WP_CLI::add_command( 'core verify-checksums', 'Checksum_Core_Command' ); WP_CLI::add_command( 'plugin', 'Plugin_Command_Namespace' ); WP_CLI::add_command( 'plugin verify-checksums', 'Checksum_Plugin_Command' ); <?php namespace WP_CLI\Core; use Exception; use WP_CLI; use WP_CLI\Utils; use WP_Error; use Core_Upgrader as DefaultCoreUpgrader; use WP_Filesystem_Base; /** * A Core Upgrader class that caches the download, and uses cached if available. * * @package wp-cli */ class CoreUpgrader extends DefaultCoreUpgrader { /** * Whether to retry without certificate validation on TLS handshake failure. * * @var bool */ private $insecure; /** * CoreUpgrader constructor. * * @param \WP_Upgrader_Skin|null $skin * @param bool $insecure */ public function __construct( $skin = null, $insecure = false ) { $this->insecure = $insecure; parent::__construct( $skin ); } /** * Caches the download, and uses cached if available. * * @access public * * @param string $package The URI of the package. If this is the full path to an * existing local file, it will be returned untouched. * @param bool $check_signatures Whether to validate file signatures. Default false. * @param array $hook_extra Extra arguments to pass to the filter hooks. Default empty array. * @return string|WP_Error The full path to the downloaded package file, or a WP_Error object. */ public function download_package( $package, $check_signatures = false, $hook_extra = [] ) { /** * Filter whether to return the package. * * @since 3.7.0 * * @param bool $reply Whether to bail without returning the package. Default is false. * @param string $package The package file name. * @param object $this The WP_Upgrader instance. */ $reply = apply_filters( // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Override existing hook from Core. 'upgrader_pre_download', false, $package, $this, $hook_extra ); if ( false !== $reply ) { return $reply; } // Check if package is a local or remote file. Bail if it's local. if ( ! preg_match( '!^(http|https|ftp)://!i', $package ) && file_exists( $package ) ) { return $package; } if ( empty( $package ) ) { return new WP_Error( 'no_package', $this->strings['no_package'] ); } $filename = pathinfo( $package, PATHINFO_FILENAME ); $extension = pathinfo( $package, PATHINFO_EXTENSION ); $temp = Utils\get_temp_dir() . uniqid( 'wp_' ) . ".{$extension}"; register_shutdown_function( function () use ( $temp ) { if ( file_exists( $temp ) ) { unlink( $temp ); } } ); $cache = WP_CLI::get_cache(); $update = $GLOBALS['wpcli_core_update_obj']; $cache_key = "core/{$filename}-{$update->locale}.{$extension}"; $cache_file = $cache->has( $cache_key ); if ( $cache_file && false === stripos( $package, 'https://wordpress.org/nightly-builds/' ) && false === stripos( $package, 'http://wordpress.org/nightly-builds/' ) ) { WP_CLI::log( "Using cached file '{$cache_file}'..." ); copy( $cache_file, $temp ); return $temp; } /* * Download to a temporary file because piping from cURL to tar is flaky * on MinGW (and probably in other environments too). */ $headers = [ 'Accept' => 'application/json' ]; $options = [ 'timeout' => 600, // 10 minutes ought to be enough for everybody. 'filename' => $temp, 'halt_on_error' => false, 'insecure' => $this->insecure, ]; $this->skin->feedback( 'downloading_package', $package ); /** @var \Requests_Response|\WpOrg\Requests\Response null $req */ try { $response = Utils\http_request( 'GET', $package, null, $headers, $options ); } catch ( Exception $e ) { return new WP_Error( 'download_failed', $e->getMessage() ); } if ( ! is_null( $response ) && 200 !== (int) $response->status_code ) { return new WP_Error( 'download_failed', $this->strings['download_failed'] ); } if ( false === stripos( $package, 'https://wordpress.org/nightly-builds/' ) ) { $cache->import( $cache_key, $temp ); } return $temp; } /** * Upgrade WordPress core. * * @access public * * @global WP_Filesystem_Base $wp_filesystem Subclass * @global callable $_wp_filesystem_direct_method * * @param object $current Response object for whether WordPress is current. * @param array $args { * Optional. Arguments for upgrading WordPress core. Default empty array. * * @type bool $pre_check_md5 Whether to check the file checksums before * attempting the upgrade. Default true. * @type bool $attempt_rollback Whether to attempt to rollback the chances if * there is a problem. Default false. * @type bool $do_rollback Whether to perform this "upgrade" as a rollback. * Default false. * } * @return null|false|WP_Error False or WP_Error on failure, null on success. */ public function upgrade( $current, $args = [] ) { set_error_handler( [ __CLASS__, 'error_handler' ], E_USER_WARNING | E_USER_NOTICE ); $result = parent::upgrade( $current, $args ); restore_error_handler(); return $result; } /** * Error handler to ignore failures on accessing SSL "https://api.wordpress.org/core/checksums/1.0/" in `get_core_checksums()` which seem to occur intermittently. */ public static function error_handler( $errno, $errstr, $errfile, $errline, $errcontext = null ) { // If ignoring E_USER_WARNING | E_USER_NOTICE, default. if ( ! ( error_reporting() & $errno ) ) { return false; } // If not in "wp-admin/includes/update.php", default. $update_php = 'wp-admin/includes/update.php'; if ( 0 !== substr_compare( $errfile, $update_php, -strlen( $update_php ) ) ) { return false; } // Else assume it's in `get_core_checksums()` and just ignore it. return true; } } <?php namespace WP_CLI\Core; /** * A Core Upgrader class that leaves packages intact by default. * * @package wp-cli */ class NonDestructiveCoreUpgrader extends CoreUpgrader { // phpcs:ignore Generic.CodeAnalysis.UselessOverridingMethod.Found -- Provide default value. public function unpack_package( $package, $delete_package = false ) { return parent::unpack_package( $package, $delete_package ); } } <?php use Composer\Semver\Comparator; use WP_CLI\Extractor; use WP_CLI\Iterators\Table as TableIterator; use WP_CLI\Utils; use WP_CLI\Formatter; use WP_CLI\WpOrgApi; /** * Downloads, installs, updates, and manages a WordPress installation. * * ## EXAMPLES * * # Download WordPress core * $ wp core download --locale=nl_NL * Downloading WordPress 4.5.2 (nl_NL)... * md5 hash verified: c5366d05b521831dd0b29dfc386e56a5 * Success: WordPress downloaded. * * # Install WordPress * $ wp core install --url=example.com --title=Example --admin_user=supervisor --admin_password=strongpassword --admin_email=info@example.com * Success: WordPress installed successfully. * * # Display the WordPress version * $ wp core version * 4.5.2 * * @package wp-cli */ class Core_Command extends WP_CLI_Command { /** * Checks for WordPress updates via Version Check API. * * Lists the most recent versions when there are updates available, * or success message when up to date. * * ## OPTIONS * * [--minor] * : Compare only the first two parts of the version number. * * [--major] * : Compare only the first part of the version number. * * [--force-check] * : Bypass the transient cache and force a fresh update check. * * [--field=<field>] * : Prints the value of a single field for each update. * * [--fields=<fields>] * : Limit the output to specific object fields. Defaults to version,update_type,package_url. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - count * - json * - yaml * --- * * ## EXAMPLES * * $ wp core check-update * +---------+-------------+-------------------------------------------------------------+ * | version | update_type | package_url | * +---------+-------------+-------------------------------------------------------------+ * | 4.5.2 | major | https://downloads.wordpress.org/release/wordpress-4.5.2.zip | * +---------+-------------+-------------------------------------------------------------+ * * @subcommand check-update */ public function check_update( $_, $assoc_args ) { $format = Utils\get_flag_value( $assoc_args, 'format', 'table' ); $updates = $this->get_updates( $assoc_args ); if ( $updates || 'table' !== $format ) { $updates = array_reverse( $updates ); $formatter = new Formatter( $assoc_args, [ 'version', 'update_type', 'package_url' ] ); $formatter->display_items( $updates ); } else { WP_CLI::success( 'WordPress is at the latest version.' ); } } /** * Downloads core WordPress files. * * Downloads and extracts WordPress core files to the specified path. Uses * current directory when no path is specified. Downloaded build is verified * to have the correct md5 and then cached to the local filesystem. * Subsequent uses of command will use the local cache if it still exists. * * ## OPTIONS * * [<download-url>] * : Download directly from a provided URL instead of fetching the URL from the wordpress.org servers. * * [--path=<path>] * : Specify the path in which to install WordPress. Defaults to current * directory. * * [--locale=<locale>] * : Select which language you want to download. * * [--version=<version>] * : Select which version you want to download. Accepts a version number, 'latest' or 'nightly'. * * [--skip-content] * : Download WP without the default themes and plugins. * * [--force] * : Overwrites existing files, if present. * * [--insecure] * : Retry download without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack. * * [--extract] * : Whether to extract the downloaded file. Defaults to true. * * ## EXAMPLES * * $ wp core download --locale=nl_NL * Downloading WordPress 4.5.2 (nl_NL)... * md5 hash verified: c5366d05b521831dd0b29dfc386e56a5 * Success: WordPress downloaded. * * @when before_wp_load */ public function download( $args, $assoc_args ) { $download_dir = ! empty( $assoc_args['path'] ) ? ( rtrim( $assoc_args['path'], '/\\' ) . '/' ) : ABSPATH; // Check for files if WordPress already present or not. $wordpress_present = is_readable( $download_dir . 'wp-load.php' ) || is_readable( $download_dir . 'wp-mail.php' ) || is_readable( $download_dir . 'wp-cron.php' ) || is_readable( $download_dir . 'wp-links-opml.php' ); if ( $wordpress_present && ! Utils\get_flag_value( $assoc_args, 'force' ) ) { WP_CLI::error( 'WordPress files seem to already be present here.' ); } if ( ! is_dir( $download_dir ) ) { if ( ! is_writable( dirname( $download_dir ) ) ) { WP_CLI::error( "Insufficient permission to create directory '{$download_dir}'." ); } WP_CLI::log( "Creating directory '{$download_dir}'." ); if ( ! @mkdir( $download_dir, 0777, true /*recursive*/ ) ) { $error = error_get_last(); WP_CLI::error( "Failed to create directory '{$download_dir}': {$error['message']}." ); } } if ( ! is_writable( $download_dir ) ) { WP_CLI::error( "'{$download_dir}' is not writable by current user." ); } $locale = (string) Utils\get_flag_value( $assoc_args, 'locale', 'en_US' ); $skip_content = (bool) Utils\get_flag_value( $assoc_args, 'skip-content', false ); $insecure = (bool) Utils\get_flag_value( $assoc_args, 'insecure', false ); $extract = (bool) Utils\get_flag_value( $assoc_args, 'extract', true ); if ( $skip_content && ! $extract ) { WP_CLI::error( 'Cannot use both --skip-content and --no-extract at the same time.' ); } $download_url = array_shift( $args ); $from_url = ! empty( $download_url ); if ( $from_url ) { $version = null; if ( isset( $assoc_args['version'] ) ) { WP_CLI::error( 'Version option is not available for URL downloads.' ); } if ( $skip_content || 'en_US' !== $locale ) { WP_CLI::error( 'Skip content and locale options are not available for URL downloads.' ); } } elseif ( isset( $assoc_args['version'] ) && 'latest' !== $assoc_args['version'] ) { $version = $assoc_args['version']; if ( in_array( strtolower( $version ), [ 'trunk', 'nightly' ], true ) ) { $version = 'nightly'; } // Nightly builds and skip content are only available in .zip format. $extension = ( ( 'nightly' === $version ) || $skip_content ) ? 'zip' : 'tar.gz'; $download_url = $this->get_download_url( $version, $locale, $extension ); } else { try { $offer = ( new WpOrgApi( [ 'insecure' => $insecure ] ) ) ->get_core_download_offer( $locale ); } catch ( Exception $exception ) { WP_CLI::error( $exception ); } if ( ! $offer ) { WP_CLI::error( "The requested locale ({$locale}) was not found." ); } $version = $offer['current']; $download_url = $offer['download']; if ( ! $skip_content ) { $download_url = str_replace( '.zip', '.tar.gz', $download_url ); } } if ( 'nightly' === $version && 'en_US' !== $locale ) { WP_CLI::error( 'Nightly builds are only available for the en_US locale.' ); } $from_version = ''; if ( file_exists( $download_dir . 'wp-includes/version.php' ) ) { $wp_details = self::get_wp_details( $download_dir ); $from_version = $wp_details['wp_version']; } if ( $from_url ) { WP_CLI::log( "Downloading from {$download_url} ..." ); } else { WP_CLI::log( "Downloading WordPress {$version} ({$locale})..." ); } $path_parts = pathinfo( $download_url ); $extension = 'tar.gz'; if ( 'zip' === $path_parts['extension'] ) { $extension = 'zip'; if ( $extract && ! class_exists( 'ZipArchive' ) ) { WP_CLI::error( 'Extracting a zip file requires ZipArchive.' ); } } if ( $skip_content && 'zip' !== $extension ) { WP_CLI::error( 'Skip content is only available for ZIP files.' ); } $cache = WP_CLI::get_cache(); if ( $from_url ) { $cache_file = null; } else { $cache_key = "core/wordpress-{$version}-{$locale}.{$extension}"; $cache_file = $cache->has( $cache_key ); } $bad_cache = false; if ( $cache_file ) { WP_CLI::log( "Using cached file '{$cache_file}'..." ); $skip_content_cache_file = $skip_content ? self::strip_content_dir( $cache_file ) : null; if ( $extract ) { try { Extractor::extract( $skip_content_cache_file ?: $cache_file, $download_dir ); } catch ( Exception $exception ) { WP_CLI::warning( 'Extraction failed, downloading a new copy...' ); $bad_cache = true; } } else { copy( $cache_file, $download_dir . basename( $cache_file ) ); } } if ( ! $cache_file || $bad_cache ) { // We need to use a temporary file because piping from cURL to tar is flaky // on MinGW (and probably in other environments too). $temp = Utils\get_temp_dir() . uniqid( 'wp_' ) . ".{$extension}"; register_shutdown_function( function () use ( $temp ) { if ( file_exists( $temp ) ) { unlink( $temp ); } } ); $headers = [ 'Accept' => 'application/json' ]; $options = [ 'timeout' => 600, // 10 minutes ought to be enough for everybody 'filename' => $temp, 'insecure' => $insecure, ]; $response = Utils\http_request( 'GET', $download_url, null, $headers, $options ); if ( 404 === (int) $response->status_code ) { WP_CLI::error( 'Release not found. Double-check locale or version.' ); } elseif ( 20 !== (int) substr( $response->status_code, 0, 2 ) ) { WP_CLI::error( "Couldn't access download URL (HTTP code {$response->status_code})." ); } if ( 'nightly' !== $version ) { unset( $options['filename'] ); $md5_response = Utils\http_request( 'GET', $download_url . '.md5', null, [], $options ); if ( $md5_response->status_code >= 200 && $md5_response->status_code < 300 ) { $md5_file = md5_file( $temp ); if ( $md5_file === $md5_response->body ) { WP_CLI::log( 'md5 hash verified: ' . $md5_file ); } else { WP_CLI::error( "md5 hash for download ({$md5_file}) is different than the release hash ({$md5_response->body})." ); } } else { WP_CLI::warning( "Couldn't access md5 hash for release ({$download_url}.md5, HTTP code {$md5_response->status_code})." ); } } else { WP_CLI::warning( 'md5 hash checks are not available for nightly downloads.' ); } $skip_content_temp = $skip_content ? self::strip_content_dir( $temp ) : null; if ( $extract ) { try { Extractor::extract( $skip_content_temp ?: $temp, $download_dir ); } catch ( Exception $exception ) { WP_CLI::error( "Couldn't extract WordPress archive. {$exception->getMessage()}" ); } } else { copy( $temp, $download_dir . basename( $temp ) ); } // Do not use the cache for nightly builds or for downloaded URLs // (the URL could be something like "latest.zip" or "nightly.zip"). if ( ! $from_url && 'nightly' !== $version ) { $cache->import( $cache_key, $temp ); } } if ( $wordpress_present ) { $this->cleanup_extra_files( $from_version, $version, $locale, $insecure ); } WP_CLI::success( 'WordPress downloaded.' ); } /** * Checks if WordPress is installed. * * Determines whether WordPress is installed by checking if the standard * database tables are installed. Doesn't produce output; uses exit codes * to communicate whether WordPress is installed. * * ## OPTIONS * * [--network] * : Check if this is a multisite installation. * * ## EXAMPLES * * # Bash script for checking if WordPress is not installed. * * if ! wp core is-installed 2>/dev/null; then * # WP is not installed. Let's try installing it. * wp core install * fi * * # Bash script for checking if WordPress is installed, with fallback. * * if wp core is-installed 2>/dev/null; then * # WP is installed. Let's do some things we should only do in a confirmed WP environment. * wp core verify-checksums * else * # Fallback if WP is not installed. * echo 'Hey Friend, you are in the wrong spot. Move in to your WordPress directory and try again.' * fi * * @subcommand is-installed */ public function is_installed( $args, $assoc_args ) { if ( is_blog_installed() && ( ! Utils\get_flag_value( $assoc_args, 'network' ) || is_multisite() ) ) { WP_CLI::halt( 0 ); } WP_CLI::halt( 1 ); } /** * Runs the standard WordPress installation process. * * Creates the WordPress tables in the database using the URL, title, and * default admin user details provided. Performs the famous 5 minute install * in seconds or less. * * Note: if you've installed WordPress in a subdirectory, then you'll need * to `wp option update siteurl` after `wp core install`. For instance, if * WordPress is installed in the `/wp` directory and your domain is example.com, * then you'll need to run `wp option update siteurl http://example.com/wp` for * your WordPress installation to function properly. * * Note: When using custom user tables (e.g. `CUSTOM_USER_TABLE`), the admin * email and password are ignored if the user_login already exists. If the * user_login doesn't exist, a new user will be created. * * ## OPTIONS * * --url=<url> * : The address of the new site. * * --title=<site-title> * : The title of the new site. * * --admin_user=<username> * : The name of the admin user. * * [--admin_password=<password>] * : The password for the admin user. Defaults to randomly generated string. * * --admin_email=<email> * : The email address for the admin user. * * [--locale=<locale>] * : The locale/language for the installation (e.g. `de_DE`). Default is `en_US`. * * [--skip-email] * : Don't send an email notification to the new admin user. * * ## EXAMPLES * * # Install WordPress in 5 seconds * $ wp core install --url=example.com --title=Example --admin_user=supervisor --admin_password=strongpassword --admin_email=info@example.com * Success: WordPress installed successfully. * * # Install WordPress without disclosing admin_password to bash history * $ wp core install --url=example.com --title=Example --admin_user=supervisor --admin_email=info@example.com --prompt=admin_password < admin_password.txt */ public function install( $args, $assoc_args ) { if ( $this->do_install( $assoc_args ) ) { WP_CLI::success( 'WordPress installed successfully.' ); } else { WP_CLI::log( 'WordPress is already installed.' ); } } /** * Transforms an existing single-site installation into a multisite installation. * * Creates the multisite database tables, and adds the multisite constants * to wp-config.php. * * For those using WordPress with Apache, remember to update the `.htaccess` * file with the appropriate multisite rewrite rules. * * [Review the multisite documentation](https://wordpress.org/support/article/create-a-network/) * for more details about how multisite works. * * ## OPTIONS * * [--title=<network-title>] * : The title of the new network. * * [--base=<url-path>] * : Base path after the domain name that each site url will start with. * --- * default: / * --- * * [--subdomains] * : If passed, the network will use subdomains, instead of subdirectories. Doesn't work with 'localhost'. * * [--skip-config] * : Don't add multisite constants to wp-config.php. * * ## EXAMPLES * * $ wp core multisite-convert * Set up multisite database tables. * Added multisite constants to wp-config.php. * Success: Network installed. Don't forget to set up rewrite rules. * * @subcommand multisite-convert * @alias install-network */ public function multisite_convert( $args, $assoc_args ) { if ( is_multisite() ) { WP_CLI::error( 'This already is a multisite installation.' ); } $assoc_args = self::set_multisite_defaults( $assoc_args ); if ( ! isset( $assoc_args['title'] ) ) { // translators: placeholder is blog name $assoc_args['title'] = sprintf( _x( '%s Sites', 'Default network name' ), get_option( 'blogname' ) ); } if ( $this->multisite_convert_( $assoc_args ) ) { WP_CLI::success( "Network installed. Don't forget to set up rewrite rules (and a .htaccess file, if using Apache)." ); } } /** * Installs WordPress multisite from scratch. * * Creates the WordPress tables in the database using the URL, title, and * default admin user details provided. Then, creates the multisite tables * in the database and adds multisite constants to the wp-config.php. * * For those using WordPress with Apache, remember to update the `.htaccess` * file with the appropriate multisite rewrite rules. * * ## OPTIONS * * [--url=<url>] * : The address of the new site. * * [--base=<url-path>] * : Base path after the domain name that each site url in the network will start with. * --- * default: / * --- * * [--subdomains] * : If passed, the network will use subdomains, instead of subdirectories. Doesn't work with 'localhost'. * * --title=<site-title> * : The title of the new site. * * --admin_user=<username> * : The name of the admin user. * --- * default: admin * --- * * [--admin_password=<password>] * : The password for the admin user. Defaults to randomly generated string. * * --admin_email=<email> * : The email address for the admin user. * * [--skip-email] * : Don't send an email notification to the new admin user. * * [--skip-config] * : Don't add multisite constants to wp-config.php. * * ## EXAMPLES * * $ wp core multisite-install --title="Welcome to the WordPress" \ * > --admin_user="admin" --admin_password="password" \ * > --admin_email="user@example.com" * Single site database tables already present. * Set up multisite database tables. * Added multisite constants to wp-config.php. * Success: Network installed. Don't forget to set up rewrite rules. * * @subcommand multisite-install */ public function multisite_install( $args, $assoc_args ) { if ( $this->do_install( $assoc_args ) ) { WP_CLI::log( 'Created single site database tables.' ); } else { WP_CLI::log( 'Single site database tables already present.' ); } $assoc_args = self::set_multisite_defaults( $assoc_args ); // translators: placeholder is user supplied title $assoc_args['title'] = sprintf( _x( '%s Sites', 'Default network name' ), $assoc_args['title'] ); // Overwrite runtime args, to avoid mismatches. $consts_to_args = [ 'SUBDOMAIN_INSTALL' => 'subdomains', 'PATH_CURRENT_SITE' => 'base', 'SITE_ID_CURRENT_SITE' => 'site_id', 'BLOG_ID_CURRENT_SITE' => 'blog_id', ]; foreach ( $consts_to_args as $const => $arg ) { if ( defined( $const ) ) { $assoc_args[ $arg ] = constant( $const ); } } if ( ! $this->multisite_convert_( $assoc_args ) ) { return; } // Do the steps that were skipped by populate_network(), // which checks is_multisite(). if ( is_multisite() ) { $site_user = get_user_by( 'email', $assoc_args['admin_email'] ); self::add_site_admins( $site_user ); $domain = self::get_clean_basedomain(); self::create_initial_blog( $assoc_args['site_id'], $assoc_args['blog_id'], $domain, $assoc_args['base'], $assoc_args['subdomains'], $site_user ); } WP_CLI::success( "Network installed. Don't forget to set up rewrite rules (and a .htaccess file, if using Apache)." ); } private static function set_multisite_defaults( $assoc_args ) { $defaults = [ 'subdomains' => false, 'base' => '/', 'site_id' => 1, 'blog_id' => 1, ]; return array_merge( $defaults, $assoc_args ); } private function do_install( $assoc_args ) { if ( is_blog_installed() ) { return false; } if ( true === Utils\get_flag_value( $assoc_args, 'skip-email' ) ) { if ( ! function_exists( 'wp_new_blog_notification' ) ) { function wp_new_blog_notification() { // Silence is golden } } // WP 4.9.0 - skip "Notice of Admin Email Change" email as well (https://core.trac.wordpress.org/ticket/39117). add_filter( 'send_site_admin_email_change_email', '__return_false' ); } require_once ABSPATH . 'wp-admin/includes/upgrade.php'; $defaults = [ 'title' => '', 'admin_user' => '', 'admin_email' => '', 'admin_password' => '', ]; if ( Utils\wp_version_compare( '4.0', '<' ) ) { if ( array_key_exists( 'locale', $assoc_args ) ) { WP_CLI::warning( sprintf( 'The flag --locale=%s is being ignored as it requires WordPress 4.0+.', $assoc_args['locale'] ) ); } } else { $defaults['locale'] = ''; } $args = wp_parse_args( $assoc_args, $defaults ); // Support prompting for the `--url=<url>`, // which is normally a runtime argument if ( isset( $assoc_args['url'] ) ) { WP_CLI::set_url( $assoc_args['url'] ); } $public = true; $password = $args['admin_password']; if ( ! is_email( $args['admin_email'] ) ) { WP_CLI::error( "The '{$args['admin_email']}' email address is invalid." ); } if ( Utils\wp_version_compare( '4.0', '>=' ) ) { $result = wp_install( $args['title'], $args['admin_user'], $args['admin_email'], $public, '', $password, $args['locale'] ); } else { $result = wp_install( $args['title'], $args['admin_user'], $args['admin_email'], $public, '', $password ); } if ( is_wp_error( $result ) ) { $reason = WP_CLI::error_to_string( $result ); WP_CLI::error( "Installation failed ({$reason})." ); } if ( ! empty( $GLOBALS['wpdb']->last_error ) ) { WP_CLI::error( 'Installation produced database errors, and may have partially or completely failed.' ); } if ( empty( $args['admin_password'] ) ) { WP_CLI::log( "Admin password: {$result['password']}" ); } // Confirm the uploads directory exists $upload_dir = wp_upload_dir(); if ( ! empty( $upload_dir['error'] ) ) { WP_CLI::warning( $upload_dir['error'] ); } return true; } private function multisite_convert_( $assoc_args ) { global $wpdb; require_once ABSPATH . 'wp-admin/includes/upgrade.php'; $domain = self::get_clean_basedomain(); if ( 'localhost' === $domain && ! empty( $assoc_args['subdomains'] ) ) { WP_CLI::error( "Multisite with subdomains cannot be configured when domain is 'localhost'." ); } // need to register the multisite tables manually for some reason foreach ( $wpdb->tables( 'ms_global' ) as $table => $prefixed_table ) { $wpdb->$table = $prefixed_table; } install_network(); $result = populate_network( $assoc_args['site_id'], $domain, get_option( 'admin_email' ), $assoc_args['title'], $assoc_args['base'], $assoc_args['subdomains'] ); $site_id = $wpdb->get_var( "SELECT id FROM $wpdb->site" ); $site_id = ( null === $site_id ) ? 1 : (int) $site_id; if ( true === $result ) { WP_CLI::log( 'Set up multisite database tables.' ); } elseif ( is_wp_error( $result ) ) { switch ( $result->get_error_code() ) { case 'siteid_exists': WP_CLI::log( $result->get_error_message() ); return false; case 'no_wildcard_dns': WP_CLI::warning( __( 'Wildcard DNS may not be configured correctly.' ) ); break; default: WP_CLI::error( $result ); } } // delete_site_option() cleans the alloptions cache to prevent dupe option delete_site_option( 'upload_space_check_disabled' ); update_site_option( 'upload_space_check_disabled', 1 ); if ( ! is_multisite() ) { $subdomain_export = Utils\get_flag_value( $assoc_args, 'subdomains' ) ? 'true' : 'false'; $ms_config = <<<EOT define( 'WP_ALLOW_MULTISITE', true ); define( 'MULTISITE', true ); define( 'SUBDOMAIN_INSTALL', {$subdomain_export} ); \$base = '{$assoc_args['base']}'; define( 'DOMAIN_CURRENT_SITE', '{$domain}' ); define( 'PATH_CURRENT_SITE', '{$assoc_args['base']}' ); define( 'SITE_ID_CURRENT_SITE', {$site_id} ); define( 'BLOG_ID_CURRENT_SITE', 1 ); EOT; $wp_config_path = Utils\locate_wp_config(); if ( true === Utils\get_flag_value( $assoc_args, 'skip-config' ) ) { WP_CLI::log( "Addition of multisite constants to 'wp-config.php' skipped. You need to add them manually:\n{$ms_config}" ); } elseif ( is_writable( $wp_config_path ) && self::modify_wp_config( $ms_config ) ) { WP_CLI::log( "Added multisite constants to 'wp-config.php'." ); } else { WP_CLI::warning( "Multisite constants could not be written to 'wp-config.php'. You may need to add them manually:\n{$ms_config}" ); } } else { /* Multisite constants are defined, therefore we already have an empty site_admins site meta. * * Code based on parts of delete_network_option. */ $rows = $wpdb->get_results( "SELECT meta_id, site_id FROM {$wpdb->sitemeta} WHERE meta_key = 'site_admins' AND meta_value = ''" ); foreach ( $rows as $row ) { wp_cache_delete( "{$row->site_id}:site_admins", 'site-options' ); $wpdb->delete( $wpdb->sitemeta, [ 'meta_id' => $row->meta_id ] ); } } return true; } // copied from populate_network() private static function create_initial_blog( $network_id, $blog_id, $domain, $path, $subdomain_install, $site_user ) { global $wpdb, $current_site, $wp_rewrite; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- This is meant to replace Core functionality. $current_site = new stdClass(); $current_site->domain = $domain; $current_site->path = $path; $current_site->site_name = ucfirst( $domain ); $blog_data = [ 'site_id' => $network_id, 'domain' => $domain, 'path' => $path, 'registered' => current_time( 'mysql' ), ]; $wpdb->insert( $wpdb->blogs, $blog_data ); $current_site->blog_id = $wpdb->insert_id; $blog_id = $wpdb->insert_id; update_user_meta( $site_user->ID, 'source_domain', $domain ); update_user_meta( $site_user->ID, 'primary_blog', $blog_id ); if ( $subdomain_install ) { $wp_rewrite->set_permalink_structure( '/%year%/%monthnum%/%day%/%postname%/' ); } else { $wp_rewrite->set_permalink_structure( '/blog/%year%/%monthnum%/%day%/%postname%/' ); } flush_rewrite_rules(); } // copied from populate_network() private static function add_site_admins( $site_user ) { $site_admins = [ $site_user->user_login ]; $users = get_users( [ 'fields' => [ 'ID', 'user_login' ] ] ); if ( $users ) { foreach ( $users as $user ) { if ( is_super_admin( $user->ID ) && ! in_array( $user->user_login, $site_admins, true ) ) { $site_admins[] = $user->user_login; } } } update_site_option( 'site_admins', $site_admins ); } private static function modify_wp_config( $content ) { $wp_config_path = Utils\locate_wp_config(); $token = "/* That's all, stop editing!"; $config_contents = file_get_contents( $wp_config_path ); if ( false === strpos( $config_contents, $token ) ) { return false; } list( $before, $after ) = explode( $token, $config_contents ); $content = trim( $content ); file_put_contents( $wp_config_path, "{$before}\n\n{$content}\n\n{$token}{$after}" ); return true; } private static function get_clean_basedomain() { $domain = preg_replace( '|https?://|', '', get_option( 'siteurl' ) ); $slash = strpos( $domain, '/' ); if ( false !== $slash ) { $domain = substr( $domain, 0, $slash ); } return $domain; } /** * Displays the WordPress version. * * ## OPTIONS * * [--extra] * : Show extended version information. * * ## EXAMPLES * * # Display the WordPress version * $ wp core version * 4.5.2 * * # Display WordPress version along with other information * $ wp core version --extra * WordPress version: 4.5.2 * Database revision: 36686 * TinyMCE version: 4.310 (4310-20160418) * Package language: en_US * * @when before_wp_load */ public function version( $args = [], $assoc_args = [] ) { $details = self::get_wp_details(); if ( ! Utils\get_flag_value( $assoc_args, 'extra' ) ) { WP_CLI::line( $details['wp_version'] ); return; } $match = []; $found_version = preg_match( '/(\d)(\d+)-/', $details['tinymce_version'], $match ); $human_readable_tiny_mce = $found_version ? "{$match[1]}.{$match[2]}" : ''; echo Utils\mustache_render( self::get_template_path( 'versions.mustache' ), [ 'wp-version' => $details['wp_version'], 'db-version' => $details['wp_db_version'], 'local-package' => empty( $details['wp_local_package'] ) ? 'en_US' : $details['wp_local_package'], 'mce-version' => $human_readable_tiny_mce ? "{$human_readable_tiny_mce} ({$details['tinymce_version']})" : $details['tinymce_version'], ] ); } /** * Gets version information from `wp-includes/version.php`. * * @return array { * @type string $wp_version The WordPress version. * @type int $wp_db_version The WordPress DB revision. * @type string $tinymce_version The TinyMCE version. * @type string $wp_local_package The TinyMCE version. * } */ private static function get_wp_details( $abspath = ABSPATH ) { $versions_path = $abspath . 'wp-includes/version.php'; if ( ! is_readable( $versions_path ) ) { WP_CLI::error( "This does not seem to be a WordPress installation.\n" . 'Pass --path=`path/to/wordpress` or run `wp core download`.' ); } $version_content = file_get_contents( $versions_path, false, null, 6, 2048 ); $vars = [ 'wp_version', 'wp_db_version', 'tinymce_version', 'wp_local_package' ]; $result = []; foreach ( $vars as $var_name ) { $result[ $var_name ] = self::find_var( $var_name, $version_content ); } return $result; } /** * Gets the template path based on installation type. */ private static function get_template_path( $template ) { $command_root = Utils\phar_safe_path( dirname( __DIR__ ) ); $template_path = "{$command_root}/templates/{$template}"; if ( ! file_exists( $template_path ) ) { WP_CLI::error( "Couldn't find {$template}" ); } return $template_path; } /** * Searches for the value assigned to variable `$var_name` in PHP code `$code`. * * This is equivalent to matching the `\$VAR_NAME = ([^;]+)` regular expression and returning * the first match either as a `string` or as an `integer` (depending if it's surrounded by * quotes or not). * * @param string $var_name Variable name to search for. * @param string $code PHP code to search in. * * @return int|string|null */ private static function find_var( $var_name, $code ) { $start = strpos( $code, '$' . $var_name . ' = ' ); if ( ! $start ) { return null; } $start = $start + strlen( $var_name ) + 3; $end = strpos( $code, ';', $start ); $value = substr( $code, $start, $end - $start ); return trim( $value, " '" ); } /** * Security copy of the core function with Requests - Gets the checksums for the given version of WordPress. * * @param string $version Version string to query. * @param string $locale Locale to query. * @param bool $insecure Whether to retry without certificate validation on TLS handshake failure. * @return string|array String message on failure. An array of checksums on success. */ private static function get_core_checksums( $version, $locale, $insecure ) { $wp_org_api = new WpOrgApi( [ 'insecure' => $insecure ] ); try { $checksums = $wp_org_api->get_core_checksums( $version, $locale ); } catch ( Exception $exception ) { return $exception->getMessage(); } if ( false === $checksums ) { return "Checksums not available for WordPress {$version}/{$locale}."; } return $checksums; } /** * Updates WordPress to a newer version. * * Defaults to updating WordPress to the latest version. * * If you see "Error: Another update is currently in progress.", you may * need to run `wp option delete core_updater.lock` after verifying another * update isn't actually running. * * ## OPTIONS * * [<zip>] * : Path to zip file to use, instead of downloading from wordpress.org. * * [--minor] * : Only perform updates for minor releases (e.g. update from WP 4.3 to 4.3.3 instead of 4.4.2). * * [--version=<version>] * : Update to a specific version, instead of to the latest version. Alternatively accepts 'nightly'. * * [--force] * : Update even when installed WP version is greater than the requested version. * * [--locale=<locale>] * : Select which language you want to download. * * [--insecure] * : Retry download without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack. * * ## EXAMPLES * * # Update WordPress * $ wp core update * Updating to version 4.5.2 (en_US)... * Downloading update from https://downloads.wordpress.org/release/wordpress-4.5.2-no-content.zip... * Unpacking the update... * Cleaning up files... * No files found that need cleaning up * Success: WordPress updated successfully. * * # Update WordPress using zip file. * $ wp core update ../latest.zip * Starting update... * Unpacking the update... * Success: WordPress updated successfully. * * # Update WordPress to 3.1 forcefully * $ wp core update --version=3.1 --force * Updating to version 3.1 (en_US)... * Downloading update from https://wordpress.org/wordpress-3.1.zip... * Unpacking the update... * Warning: Checksums not available for WordPress 3.1/en_US. Please cleanup files manually. * Success: WordPress updated successfully. * * @alias upgrade */ public function update( $args, $assoc_args ) { global $wp_version; $update = null; $upgrader = 'WP_CLI\\Core\\CoreUpgrader'; if ( 'trunk' === Utils\get_flag_value( $assoc_args, 'version' ) ) { $assoc_args['version'] = 'nightly'; } if ( ! empty( $args[0] ) ) { // ZIP path or URL is given $upgrader = 'WP_CLI\\Core\\NonDestructiveCoreUpgrader'; $version = Utils\get_flag_value( $assoc_args, 'version' ); $update = (object) [ 'response' => 'upgrade', 'current' => $version, 'download' => $args[0], 'packages' => (object) [ 'partial' => null, 'new_bundled' => null, 'no_content' => null, 'full' => $args[0], ], 'version' => $version, 'locale' => null, ]; } elseif ( empty( $assoc_args['version'] ) ) { // Update to next release wp_version_check(); $from_api = get_site_transient( 'update_core' ); if ( Utils\get_flag_value( $assoc_args, 'minor' ) ) { foreach ( $from_api->updates as $offer ) { $sem_ver = Utils\get_named_sem_ver( $offer->version, $wp_version ); if ( ! $sem_ver || 'patch' !== $sem_ver ) { continue; } $update = $offer; break; } if ( empty( $update ) ) { WP_CLI::success( 'WordPress is at the latest minor release.' ); return; } } elseif ( ! empty( $from_api->updates ) ) { list( $update ) = $from_api->updates; } } elseif ( Utils\wp_version_compare( $assoc_args['version'], '<' ) || 'nightly' === $assoc_args['version'] || Utils\get_flag_value( $assoc_args, 'force' ) ) { // Specific version is given $version = $assoc_args['version']; $locale = Utils\get_flag_value( $assoc_args, 'locale', get_locale() ); $new_package = $this->get_download_url( $version, $locale ); $update = (object) [ 'response' => 'upgrade', 'current' => $assoc_args['version'], 'download' => $new_package, 'packages' => (object) [ 'partial' => null, 'new_bundled' => null, 'no_content' => null, 'full' => $new_package, ], 'version' => $version, 'locale' => $locale, ]; } if ( ! empty( $update ) && ( $update->version !== $wp_version || Utils\get_flag_value( $assoc_args, 'force' ) ) ) { require_once ABSPATH . 'wp-admin/includes/upgrade.php'; if ( $update->version ) { WP_CLI::log( "Updating to version {$update->version} ({$update->locale})..." ); } else { WP_CLI::log( 'Starting update...' ); } $from_version = $wp_version; $insecure = (bool) Utils\get_flag_value( $assoc_args, 'insecure', false ); $GLOBALS['wpcli_core_update_obj'] = $update; $result = Utils\get_upgrader( $upgrader, $insecure )->upgrade( $update ); unset( $GLOBALS['wpcli_core_update_obj'] ); if ( is_wp_error( $result ) ) { $message = WP_CLI::error_to_string( $result ); if ( 'up_to_date' !== $result->get_error_code() ) { WP_CLI::error( $message ); } else { WP_CLI::success( $message ); } } else { $to_version = ''; if ( file_exists( ABSPATH . 'wp-includes/version.php' ) ) { $wp_details = self::get_wp_details(); $to_version = $wp_details['wp_version']; } $locale = (string) Utils\get_flag_value( $assoc_args, 'locale', get_locale() ); $this->cleanup_extra_files( $from_version, $to_version, $locale, $insecure ); WP_CLI::success( 'WordPress updated successfully.' ); } } else { WP_CLI::success( 'WordPress is up to date.' ); } } /** * Runs the WordPress database update procedure. * * ## OPTIONS * * [--network] * : Update databases for all sites on a network * * [--dry-run] * : Compare database versions without performing the update. * * ## EXAMPLES * * # Update the WordPress database. * $ wp core update-db * Success: WordPress database upgraded successfully from db version 36686 to 35700. * * # Update databases for all sites on a network. * $ wp core update-db --network * WordPress database upgraded successfully from db version 35700 to 29630 on example.com/ * Success: WordPress database upgraded on 123/123 sites. * * @subcommand update-db */ public function update_db( $args, $assoc_args ) { global $wpdb, $wp_db_version, $wp_current_db_version; $network = Utils\get_flag_value( $assoc_args, 'network' ); if ( $network && ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } $dry_run = Utils\get_flag_value( $assoc_args, 'dry-run' ); if ( $dry_run ) { WP_CLI::log( 'Performing a dry run, with no database modification.' ); } if ( $network ) { $iterator_args = [ 'table' => $wpdb->blogs, 'where' => [ 'spam' => 0, 'deleted' => 0, 'archived' => 0, ], ]; $it = new TableIterator( $iterator_args ); $success = 0; $total = 0; $site_ids = []; foreach ( $it as $blog ) { ++$total; $site_ids[] = $blog->site_id; $url = $blog->domain . $blog->path; $cmd = "--url={$url} core update-db"; if ( $dry_run ) { $cmd .= ' --dry-run'; } $process = WP_CLI::runcommand( $cmd, [ 'return' => 'all', 'exit_error' => false, ] ); if ( 0 === (int) $process->return_code ) { // See if we can parse the stdout if ( preg_match( '#Success: (.+)#', $process->stdout, $matches ) ) { $message = rtrim( $matches[1], '.' ); $message = "{$message} on {$url}"; } else { $message = "Database upgraded successfully on {$url}"; } WP_CLI::log( $message ); ++$success; } else { WP_CLI::warning( "Database failed to upgrade on {$url}" ); } } if ( ! $dry_run && $total && $success === $total ) { foreach ( array_unique( $site_ids ) as $site_id ) { update_metadata( 'site', $site_id, 'wpmu_upgrade_site', $wp_db_version ); } } WP_CLI::success( "WordPress database upgraded on {$success}/{$total} sites." ); } else { require_once ABSPATH . 'wp-admin/includes/upgrade.php'; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- Replacing WP Core behavior is the goal here. $wp_current_db_version = (int) __get_option( 'db_version' ); if ( $wp_db_version !== $wp_current_db_version ) { if ( $dry_run ) { WP_CLI::success( "WordPress database will be upgraded from db version {$wp_current_db_version} to {$wp_db_version}." ); } else { // WP upgrade isn't too fussy about generating MySQL warnings such as "Duplicate key name" during an upgrade so suppress. $wpdb->suppress_errors(); // WP upgrade expects `$_SERVER['HTTP_HOST']` to be set in `wp_guess_url()`, otherwise get PHP notice. if ( ! isset( $_SERVER['HTTP_HOST'] ) ) { $_SERVER['HTTP_HOST'] = 'example.com'; } wp_upgrade(); WP_CLI::success( "WordPress database upgraded successfully from db version {$wp_current_db_version} to {$wp_db_version}." ); } } else { WP_CLI::success( "WordPress database already at latest db version {$wp_db_version}." ); } } } /** * Gets download url based on version, locale and desired file type. * * @param $version * @param string $locale * @param string $file_type * @return string */ private function get_download_url( $version, $locale = 'en_US', $file_type = 'zip' ) { if ( 'nightly' === $version ) { if ( 'zip' === $file_type ) { return 'https://wordpress.org/nightly-builds/wordpress-latest.zip'; } else { WP_CLI::error( 'Nightly builds are only available in .zip format.' ); } } $locale_subdomain = 'en_US' === $locale ? '' : substr( $locale, 0, 2 ) . '.'; $locale_suffix = 'en_US' === $locale ? '' : "-{$locale}"; // Match 6.7.0 but not 6.0 if ( substr_count( $version, '.' ) > 1 && substr( $version, -2 ) === '.0' ) { $version = substr( $version, 0, -2 ); } return "https://{$locale_subdomain}wordpress.org/wordpress-{$version}{$locale_suffix}.{$file_type}"; } /** * Returns update information. * * @param array $assoc_args Associative array of arguments. * @return array List of available updates , or an empty array if no updates are available. */ private function get_updates( $assoc_args ) { $force_check = Utils\get_flag_value( $assoc_args, 'force-check' ); wp_version_check( [], $force_check ); $from_api = get_site_transient( 'update_core' ); if ( ! $from_api ) { return []; } $compare_version = str_replace( '-src', '', $GLOBALS['wp_version'] ); $updates = [ 'major' => false, 'minor' => false, ]; foreach ( $from_api->updates as $offer ) { $update_type = Utils\get_named_sem_ver( $offer->version, $compare_version ); if ( ! $update_type ) { continue; } // WordPress follow its own versioning which is roughly equivalent to semver if ( 'minor' === $update_type ) { $update_type = 'major'; } elseif ( 'patch' === $update_type ) { $update_type = 'minor'; } if ( ! empty( $updates[ $update_type ] ) && ! Comparator::greaterThan( $offer->version, $updates[ $update_type ]['version'] ) ) { continue; } $updates[ $update_type ] = [ 'version' => $offer->version, 'update_type' => $update_type, 'package_url' => ! empty( $offer->packages->partial ) ? $offer->packages->partial : $offer->packages->full, ]; } foreach ( $updates as $type => $value ) { if ( empty( $value ) ) { unset( $updates[ $type ] ); } } foreach ( [ 'major', 'minor' ] as $type ) { if ( true === Utils\get_flag_value( $assoc_args, $type ) ) { return ! empty( $updates[ $type ] ) ? [ $updates[ $type ] ] : []; } } return array_values( $updates ); } /** * Clean up extra files. * * @param string $version_from Starting version that the installation was updated from. * @param string $version_to Target version that the installation is updated to. * @param string $locale Locale of the installation. * @param bool $insecure Whether to retry without certificate validation on TLS handshake failure. */ private function cleanup_extra_files( $version_from, $version_to, $locale, $insecure ) { if ( ! $version_from || ! $version_to ) { WP_CLI::warning( 'Failed to find WordPress version. Please cleanup files manually.' ); return; } $old_checksums = self::get_core_checksums( $version_from, $locale ?: 'en_US', $insecure ); if ( ! is_array( $old_checksums ) ) { WP_CLI::warning( "{$old_checksums} Please cleanup files manually." ); return; } $new_checksums = self::get_core_checksums( $version_to, $locale ?: 'en_US', $insecure ); if ( ! is_array( $new_checksums ) ) { WP_CLI::warning( "{$new_checksums} Please cleanup files manually." ); return; } // Compare the files from the old version and the new version in a case-insensitive manner, // to prevent files being incorrectly deleted on systems with case-insensitive filesystems // when core changes the case of filenames. // The main logic for this was taken from the Joomla project and adapted for WP. // See: https://github.com/joomla/joomla-cms/blob/bb5368c7ef9c20270e6e9fcc4b364cd0849082a5/administrator/components/com_admin/script.php#L8158 $old_filepaths = array_keys( $old_checksums ); $new_filepaths = array_keys( $new_checksums ); $new_filepaths = array_combine( array_map( 'strtolower', $new_filepaths ), $new_filepaths ); $old_filepaths_to_check = array_diff( $old_filepaths, $new_filepaths ); foreach ( $old_filepaths_to_check as $old_filepath_to_check ) { $old_realpath = realpath( ABSPATH . $old_filepath_to_check ); // On Unix without incorrectly cased file. if ( false === $old_realpath ) { continue; } $lowercase_old_filepath_to_check = strtolower( $old_filepath_to_check ); if ( ! array_key_exists( $lowercase_old_filepath_to_check, $new_filepaths ) ) { $files_to_remove[] = $old_filepath_to_check; continue; } // We are now left with only the files that are similar from old to new except for their case. $old_basename = basename( $old_realpath ); $new_filepath = $new_filepaths[ $lowercase_old_filepath_to_check ]; $expected_basename = basename( $new_filepath ); $new_realpath = realpath( ABSPATH . $new_filepath ); $new_basename = basename( $new_realpath ); // On Windows or Unix with only the incorrectly cased file. if ( $new_basename !== $expected_basename ) { WP_CLI::debug( "Renaming file '{$old_filepath_to_check}' => '{$new_filepath}'", 'core' ); rename( ABSPATH . $old_filepath_to_check, ABSPATH . $old_filepath_to_check . '.tmp' ); rename( ABSPATH . $old_filepath_to_check . '.tmp', ABSPATH . $new_filepath ); continue; } // There might still be an incorrectly cased file on other OS than Windows. if ( basename( $old_filepath_to_check ) === $old_basename ) { // Check if case-insensitive file system, eg on OSX. if ( fileinode( $old_realpath ) === fileinode( $new_realpath ) ) { // Check deeper because even realpath or glob might not return the actual case. if ( ! in_array( $expected_basename, scandir( dirname( $new_realpath ) ), true ) ) { WP_CLI::debug( "Renaming file '{$old_filepath_to_check}' => '{$new_filepath}'", 'core' ); rename( ABSPATH . $old_filepath_to_check, ABSPATH . $old_filepath_to_check . '.tmp' ); rename( ABSPATH . $old_filepath_to_check . '.tmp', ABSPATH . $new_filepath ); } } else { // On Unix with both files: Delete the incorrectly cased file. $files_to_remove[] = $old_filepath_to_check; } } } if ( ! empty( $files_to_remove ) ) { WP_CLI::log( 'Cleaning up files...' ); $count = 0; foreach ( $files_to_remove as $file ) { // wp-content should be considered user data if ( 0 === stripos( $file, 'wp-content' ) ) { continue; } if ( file_exists( ABSPATH . $file ) ) { unlink( ABSPATH . $file ); WP_CLI::log( "File removed: {$file}" ); ++$count; } } if ( $count ) { WP_CLI::log( number_format( $count ) . ' files cleaned up.' ); } else { WP_CLI::log( 'No files found that need cleaning up.' ); } } } private static function strip_content_dir( $zip_file ) { $new_zip_file = Utils\get_temp_dir() . uniqid( 'wp_' ) . '.zip'; register_shutdown_function( function () use ( $new_zip_file ) { if ( file_exists( $new_zip_file ) ) { unlink( $new_zip_file ); } } ); // Duplicate file to avoid modifying the original, which could be cache. if ( ! copy( $zip_file, $new_zip_file ) ) { WP_CLI::error( 'Failed to copy ZIP file.' ); } $zip = new ZipArchive(); $res = $zip->open( $new_zip_file ); if ( true === $res ) { // phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase for ( $i = 0; $i < $zip->numFiles; $i++ ) { $info = $zip->statIndex( $i ); // Strip all files in wp-content/themes and wp-content/plugins // but leave the directories and index.php files intact. if ( in_array( $info['name'], array( 'wordpress/wp-content/plugins/', 'wordpress/wp-content/plugins/index.php', 'wordpress/wp-content/themes/', 'wordpress/wp-content/themes/index.php', ), true ) ) { continue; } if ( 0 === stripos( $info['name'], 'wordpress/wp-content/themes/' ) || 0 === stripos( $info['name'], 'wordpress/wp-content/plugins/' ) ) { $zip->deleteIndex( $i ); } } $zip->close(); return $new_zip_file; } else { WP_CLI::error( 'ZipArchive failed to open ZIP file.' ); } } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_core_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_core_autoloader ) ) { require_once $wpcli_core_autoloader; } WP_CLI::add_command( 'core', 'Core_Command' ); <?php /* * WP_CLI: Copied and adapted from vendor/composer/composer/src/Composer/Json/JsonManipulator.php. Changes marked `WP_CLI`. * * This file is part of Composer. * * (c) Nils Adermann <naderman@naderman.de> * Jordi Boggiano <j.boggiano@seld.be> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace WP_CLI; // WP_CLI use Composer\Json\JsonFile; // WP_CLI use Composer\Repository\PlatformRepository; /** * @author Jordi Boggiano <j.boggiano@seld.be> */ class JsonManipulator { private static $DEFINES = '(?(DEFINE) (?<number> -? (?= [1-9]|0(?!\d) ) \d+ (\.\d+)? ([eE] [+-]? \d+)? ) (?<boolean> true | false | null ) (?<string> " ([^"\\\\]* | \\\\ ["\\\\bfnrt\/] | \\\\ u [0-9a-f]{4} )* " ) (?<array> \[ (?: (?&json) \s* (?: , (?&json) \s* )* )? \s* \] ) (?<pair> \s* (?&string) \s* : (?&json) \s* ) (?<object> \{ (?: (?&pair) (?: , (?&pair) )* )? \s* \} ) (?<json> \s* (?: (?&number) | (?&boolean) | (?&string) | (?&array) | (?&object) ) ) )'; private $contents; private $newline; private $indent; public function __construct($contents) { $contents = trim($contents); if ($contents === '') { $contents = '{}'; } if (!$this->pregMatch('#^\{(.*)\}$#s', $contents)) { throw new \InvalidArgumentException('The json file must be an object ({})'); } $this->newline = false !== strpos($contents, "\r\n") ? "\r\n" : "\n"; $this->contents = $contents === '{}' ? '{' . $this->newline . '}' : $contents; $this->detectIndenting(); } public function getContents() { return $this->contents . $this->newline; } public function addLink($type, $package, $constraint, $sortPackages = false, $caseInsensitive = false) // WP_CLI: caseInsensitive. { $decoded = JsonFile::parseJson($this->contents); // no link of that type yet if (!isset($decoded[$type])) { return $this->addMainKey($type, array($package => $constraint)); } $regex = '{'.self::$DEFINES.'^(?P<start>\s*\{\s*(?:(?&string)\s*:\s*(?&json)\s*,\s*)*?)'. '(?P<property>'.preg_quote(JsonFile::encode($type)).'\s*:\s*)(?P<value>(?&json))(?P<end>.*)}sx'; if (!$this->pregMatch($regex, $this->contents, $matches)) { return false; } // WP_CLI: begin caseInsensitive. if ($caseInsensitive) { // Just zap any existing packages first in a case insensitive manner. $this->removeSubNode($type, $package, $caseInsensitive); return $this->addLink($type, $package, $constraint, $sortPackages); } // WP_CLI: end caseInsensitive. $links = $matches['value']; // try to find existing link $packageRegex = str_replace('/', '\\\\?/', preg_quote($package)); $regex = '{'.self::$DEFINES.'"(?P<package>'.$packageRegex.')"(\s*:\s*)(?&string)}ix'; if ($this->pregMatch($regex, $links, $packageMatches)) { // update existing link $existingPackage = $packageMatches['package']; $packageRegex = str_replace('/', '\\\\?/', preg_quote($existingPackage)); $links = preg_replace_callback('{'.self::$DEFINES.'"'.$packageRegex.'"(?P<separator>\s*:\s*)(?&string)}ix', function ($m) use ($existingPackage, $constraint) { return JsonFile::encode(str_replace('\\/', '/', $existingPackage)) . $m['separator'] . '"' . $constraint . '"'; }, $links); } else { if ($this->pregMatch('#^\s*\{\s*\S+.*?(\s*\}\s*)$#s', $links, $match)) { // link missing but non empty links $links = preg_replace( '{'.preg_quote($match[1]).'$}', // addcslashes is used to double up backslashes/$ since preg_replace resolves them as back references otherwise, see #1588 addcslashes(',' . $this->newline . $this->indent . $this->indent . JsonFile::encode($package).': '.JsonFile::encode($constraint) . $match[1], '\\$'), $links ); } else { // links empty $links = '{' . $this->newline . $this->indent . $this->indent . JsonFile::encode($package).': '.JsonFile::encode($constraint) . $this->newline . $this->indent . '}'; } } if (true === $sortPackages) { $requirements = json_decode($links, true); $this->sortPackages($requirements); $links = $this->format($requirements); } $this->contents = $matches['start'] . $matches['property'] . $links . $matches['end']; return true; } /** * Sorts packages by importance (platform packages first, then PHP dependencies) and alphabetically. * * @link https://getcomposer.org/doc/02-libraries.md#platform-packages * * @param array $packages */ private function sortPackages(array &$packages = array()) { $prefix = function ($requirement) { if (preg_match(PlatformRepository::PLATFORM_PACKAGE_REGEX, $requirement)) { return preg_replace( array( '/^php/', '/^hhvm/', '/^ext/', '/^lib/', '/^\D/', ), array( '0-$0', '1-$0', '2-$0', '3-$0', '4-$0', ), $requirement ); } return '5-'.$requirement; }; uksort($packages, function ($a, $b) use ($prefix) { return strnatcmp($prefix($a), $prefix($b)); }); } public function addRepository($name, $config) { return $this->addSubNode('repositories', $name, $config); } public function removeRepository($name) { return $this->removeSubNode('repositories', $name); } public function addConfigSetting($name, $value) { return $this->addSubNode('config', $name, $value); } public function removeConfigSetting($name) { return $this->removeSubNode('config', $name); } public function addProperty($name, $value) { if (substr($name, 0, 6) === 'extra.') { return $this->addSubNode('extra', substr($name, 6), $value); } return $this->addMainKey($name, $value); } public function removeProperty($name) { if (substr($name, 0, 6) === 'extra.') { return $this->removeSubNode('extra', substr($name, 6)); } return $this->removeMainKey($name); } public function addSubNode($mainNode, $name, $value, $caseInsensitive = false) // WP_CLI: caseInsensitive. { $decoded = JsonFile::parseJson($this->contents); $subName = null; if (in_array($mainNode, array('config', 'extra')) && false !== strpos($name, '.')) { list($name, $subName) = explode('.', $name, 2); } // no main node yet if (!isset($decoded[$mainNode])) { if ($subName !== null) { $this->addMainKey($mainNode, array($name => array($subName => $value))); } else { $this->addMainKey($mainNode, array($name => $value)); } return true; } // main node content not match-able $nodeRegex = '{'.self::$DEFINES.'^(?P<start> \s* \{ \s* (?: (?&string) \s* : (?&json) \s* , \s* )*?'. preg_quote(JsonFile::encode($mainNode)).'\s*:\s*)(?P<content>(?&object))(?P<end>.*)}sx'; try { if (!$this->pregMatch($nodeRegex, $this->contents, $match)) { return false; } } catch (\RuntimeException $e) { if ($e->getCode() === PREG_BACKTRACK_LIMIT_ERROR) { return false; } throw $e; } // WP_CLI: begin caseInsensitive. if ($caseInsensitive) { // Just zap any existing names first in a case insensitive manner. $this->removeSubNode($mainNode, $name, $caseInsensitive); return $this->addSubNode($mainNode, $name, $value); } // WP_CLI: end caseInsensitive. $children = $match['content']; // invalid match due to un-regexable content, abort if (!@json_decode($children)) { return false; } $that = $this; // child exists $childRegex = '{'.self::$DEFINES.'(?P<start>"'.preg_quote($name).'"\s*:\s*)(?P<content>(?&json))(?P<end>,?)}x'; if ($this->pregMatch($childRegex, $children, $matches)) { $children = preg_replace_callback($childRegex, function ($matches) use ($name, $subName, $value, $that) { if ($subName !== null) { $curVal = json_decode($matches['content'], true); if (!is_array($curVal)) { $curVal = array(); } $curVal[$subName] = $value; $value = $curVal; } return $matches['start'] . $that->format($value, 1) . $matches['end']; }, $children); } else { $this->pregMatch('#^{ \s*? (?P<content>\S+.*?)? (?P<trailingspace>\s*) }$#sx', $children, $match); $whitespace = ''; if (!empty($match['trailingspace'])) { $whitespace = $match['trailingspace']; } if (!empty($match['content'])) { if ($subName !== null) { $value = array($subName => $value); } // child missing but non empty children $children = preg_replace( '#'.$whitespace.'}$#', addcslashes(',' . $this->newline . $this->indent . $this->indent . JsonFile::encode($name).': '.$this->format($value, 1) . $whitespace . '}', '\\$'), $children ); } else { if ($subName !== null) { $value = array($subName => $value); } // children present but empty $children = '{' . $this->newline . $this->indent . $this->indent . JsonFile::encode($name).': '.$this->format($value, 1) . $whitespace . '}'; } } $this->contents = preg_replace_callback($nodeRegex, function ($m) use ($children) { return $m['start'] . $children . $m['end']; }, $this->contents); return true; } public function removeSubNode($mainNode, $name, $caseInsensitive = false) // WP_CLI: caseInsensitive. { $decoded = JsonFile::parseJson($this->contents); // no node or empty node if (empty($decoded[$mainNode])) { return true; } // WP_CLI: begin caseInsensitive. if ( $caseInsensitive ) { // This is more or less a copy of the code at the start of `addLink()` above. $regex = '{'.self::$DEFINES.'^(?P<start>\s*\{\s*(?:(?&string)\s*:\s*(?&json)\s*,\s*)*?)'. '(?P<property>'.preg_quote(JsonFile::encode($mainNode)).'\s*:\s*)(?P<value>(?&json))(?P<end>.*)}sx'; if (!$this->pregMatch($regex, $this->contents, $matches)) { return true; } $value = $matches['value']; // Renamed from `$links` in `addLink()` case above. // try to find existing values $nameRegex = str_replace('/', '\\\\?/', preg_quote($name)); // Renamed from `$packageRegex` in `addLink()` case above. $regex = '{'.self::$DEFINES.'"(?P<name>'.$nameRegex.')"(\s*:\s*)(?&json)}ix'; // Need `(?&json)` PCRE subroutine here, as opposed to `(?&string)` in `addLink()` case. if (preg_match_all($regex, $value, $nameMatches)) { // Just zap them all individually in a case sensitive manner. foreach ( $nameMatches['name'] as $nameMatch ) { $this->removeSubNode($mainNode, $nameMatch); } } return true; } // WP_CLI: end caseInsensitive. // no node content match-able $nodeRegex = '{'.self::$DEFINES.'^(?P<start> \s* \{ \s* (?: (?&string) \s* : (?&json) \s* , \s* )*?'. preg_quote(JsonFile::encode($mainNode)).'\s*:\s*)(?P<content>(?&object))(?P<end>.*)}sx'; try { if (!$this->pregMatch($nodeRegex, $this->contents, $match)) { return false; } } catch (\RuntimeException $e) { if ($e->getCode() === PREG_BACKTRACK_LIMIT_ERROR) { return false; } throw $e; } $children = $match['content']; // invalid match due to un-regexable content, abort if (!@json_decode($children, true)) { return false; } $subName = null; if (in_array($mainNode, array('config', 'extra')) && false !== strpos($name, '.')) { list($name, $subName) = explode('.', $name, 2); } // no node to remove if (!isset($decoded[$mainNode][$name]) || ($subName && !isset($decoded[$mainNode][$name][$subName]))) { return true; } // try and find a match for the subkey if ($this->pregMatch('{"'.preg_quote($name).'"\s*:}i', $children)) { // find best match for the value of "name" if (preg_match_all('{'.self::$DEFINES.'"'.preg_quote($name).'"\s*:\s*(?:(?&json))}x', $children, $matches)) { $bestMatch = ''; foreach ($matches[0] as $match) { if (strlen($bestMatch) < strlen($match)) { $bestMatch = $match; } } $childrenClean = preg_replace('{,\s*'.preg_quote($bestMatch).'}', '', $children, -1, $count); // WP_CLI: As the preg_match_all() above is case-sensitive, so should this be. if (1 !== $count) { $childrenClean = preg_replace('{'.preg_quote($bestMatch).'\s*,?\s*}', '', $childrenClean, -1, $count); // WP_CLI: ditto. if (1 !== $count) { return false; } } } } else { $childrenClean = $children; } // no child data left, $name was the only key in $this->pregMatch('#^{ \s*? (?P<content>\S+.*?)? (?P<trailingspace>\s*) }$#sx', $childrenClean, $match); if (empty($match['content'])) { $newline = $this->newline; $indent = $this->indent; $this->contents = preg_replace_callback($nodeRegex, function ($matches) use ($indent, $newline) { return $matches['start'] . '{' . $newline . $indent . '}' . $matches['end']; }, $this->contents); // we have a subname, so we restore the rest of $name if ($subName !== null) { $curVal = json_decode($children, true); unset($curVal[$name][$subName]); $this->addSubNode($mainNode, $name, $curVal[$name]); } return true; } $that = $this; $this->contents = preg_replace_callback($nodeRegex, function ($matches) use ($that, $name, $subName, $childrenClean) { if ($subName !== null) { $curVal = json_decode($matches['content'], true); unset($curVal[$name][$subName]); $childrenClean = $that->format($curVal, 0); } return $matches['start'] . $childrenClean . $matches['end']; }, $this->contents); return true; } public function addMainKey($key, $content) { $decoded = JsonFile::parseJson($this->contents); $content = $this->format($content); // key exists already $regex = '{'.self::$DEFINES.'^(?P<start>\s*\{\s*(?:(?&string)\s*:\s*(?&json)\s*,\s*)*?)'. '(?P<key>'.preg_quote(JsonFile::encode($key)).'\s*:\s*(?&json))(?P<end>.*)}sx'; if (isset($decoded[$key]) && $this->pregMatch($regex, $this->contents, $matches)) { // invalid match due to un-regexable content, abort if (!@json_decode('{'.$matches['key'].'}')) { return false; } $this->contents = $matches['start'] . JsonFile::encode($key).': '.$content . $matches['end']; return true; } // append at the end of the file and keep whitespace if ($this->pregMatch('#[^{\s](\s*)\}$#', $this->contents, $match)) { $this->contents = preg_replace( '#'.$match[1].'\}$#', addcslashes(',' . $this->newline . $this->indent . JsonFile::encode($key). ': '. $content . $this->newline . '}', '\\$'), $this->contents ); return true; } // append at the end of the file $this->contents = preg_replace( '#\}$#', addcslashes($this->indent . JsonFile::encode($key). ': '.$content . $this->newline . '}', '\\$'), $this->contents ); return true; } public function removeMainKey($key) { $decoded = JsonFile::parseJson($this->contents); if (!isset($decoded[$key])) { return true; } // key exists already $regex = '{'.self::$DEFINES.'^(?P<start>\s*\{\s*(?:(?&string)\s*:\s*(?&json)\s*,\s*)*?)'. '(?P<removal>'.preg_quote(JsonFile::encode($key)).'\s*:\s*(?&json))\s*,?\s*(?P<end>.*)}sx'; if ($this->pregMatch($regex, $this->contents, $matches)) { // invalid match due to un-regexable content, abort if (!@json_decode('{'.$matches['removal'].'}')) { return false; } // check that we are not leaving a dangling comma on the previous line if the last line was removed if (preg_match('#,\s*$#', $matches['start']) && preg_match('#^\}$#', $matches['end'])) { $matches['start'] = rtrim(preg_replace('#,(\s*)$#', '$1', $matches['start']), $this->indent); } $this->contents = $matches['start'] . $matches['end']; if (preg_match('#^\{\s*\}\s*$#', $this->contents)) { $this->contents = "{\n}"; } return true; } return false; } public function format($data, $depth = 0) { if (is_array($data)) { reset($data); if (is_numeric(key($data))) { foreach ($data as $key => $val) { $data[$key] = $this->format($val, $depth + 1); } return '['.implode(', ', $data).']'; } $out = '{' . $this->newline; $elems = array(); foreach ($data as $key => $val) { $elems[] = str_repeat($this->indent, $depth + 2) . JsonFile::encode($key). ': '.$this->format($val, $depth + 1); } return $out . implode(','.$this->newline, $elems) . $this->newline . str_repeat($this->indent, $depth + 1) . '}'; } return JsonFile::encode($data); } protected function detectIndenting() { if ($this->pregMatch('{^([ \t]+)"}m', $this->contents, $match)) { $this->indent = $match[1]; } else { $this->indent = ' '; } } protected function pregMatch($re, $str, &$matches = array()) { $count = preg_match($re, $str, $matches); if ($count === false) { switch (preg_last_error()) { case PREG_NO_ERROR: throw new \RuntimeException('Failed to execute regex: PREG_NO_ERROR', PREG_NO_ERROR); case PREG_INTERNAL_ERROR: throw new \RuntimeException('Failed to execute regex: PREG_INTERNAL_ERROR', PREG_INTERNAL_ERROR); case PREG_BACKTRACK_LIMIT_ERROR: throw new \RuntimeException('Failed to execute regex: PREG_BACKTRACK_LIMIT_ERROR', PREG_BACKTRACK_LIMIT_ERROR); case PREG_RECURSION_LIMIT_ERROR: throw new \RuntimeException('Failed to execute regex: PREG_RECURSION_LIMIT_ERROR', PREG_RECURSION_LIMIT_ERROR); case PREG_BAD_UTF8_ERROR: throw new \RuntimeException('Failed to execute regex: PREG_BAD_UTF8_ERROR', PREG_BAD_UTF8_ERROR); case PREG_BAD_UTF8_OFFSET_ERROR: throw new \RuntimeException('Failed to execute regex: PREG_BAD_UTF8_OFFSET_ERROR', PREG_BAD_UTF8_OFFSET_ERROR); case 6: // PREG_JIT_STACKLIMIT_ERROR if (PHP_VERSION_ID > 70000) { throw new \RuntimeException('Failed to execute regex: PREG_JIT_STACKLIMIT_ERROR', 6); } // fallthrough default: throw new \RuntimeException('Failed to execute regex: Unknown error'); } } return $count; } } <?php /** * A Composer IO class so we can provide some level of interactivity from WP-CLI. * * Due to PHP 5.6 compatibility, we have two different implementations of this class. * This is implemented via traits to make static analysis easier. * * See https://github.com/wp-cli/package-command/issues/172. */ namespace WP_CLI\Package; use Composer\IO\NullIO; use WP_CLI\Package\Compat\NullIOMethodsTrait; class ComposerIO extends NullIO { use NullIOMethodsTrait; } <?php namespace WP_CLI\Package\Compat; use Composer\InstalledVersions; use Composer\Semver\VersionParser; // phpcs:disable Generic.Files.OneObjectStructurePerFile.MultipleFound,Generic.Classes.DuplicateClassName.Found if ( class_exists( InstalledVersions::class ) && InstalledVersions::satisfies( new VersionParser(), 'composer/composer', '^2.3' ) ) { require_once __DIR__ . '/Min_Composer_2_3/NullIOMethodsTrait.php'; trait NullIOMethodsTrait { use Min_Composer_2_3\NullIOMethodsTrait; } return; } require_once __DIR__ . '/Min_Composer_1_10/NullIOMethodsTrait.php'; trait NullIOMethodsTrait { use Min_Composer_1_10\NullIOMethodsTrait; } <?php namespace WP_CLI\Package\Compat\Min_Composer_2_3; use WP_CLI; trait NullIOMethodsTrait { /** * {@inheritDoc} */ public function isVerbose(): bool { return true; } /** * {@inheritDoc} */ public function write( $messages, bool $newline = true, int $verbosity = self::NORMAL ): void { self::output_clean_message( $messages ); } /** * {@inheritDoc} */ public function writeError( $messages, bool $newline = true, int $verbosity = self::NORMAL ): void { self::output_clean_message( $messages ); } private static function output_clean_message( $messages ) { $messages = (array) preg_replace( '#<(https?)([^>]+)>#', '$1$2', $messages ); foreach ( $messages as $message ) { // phpcs:ignore WordPress.WP.AlternativeFunctions.strip_tags_strip_tags WP_CLI::log( strip_tags( trim( $message ) ) ); } } } <?php namespace WP_CLI\Package\Compat\Min_Composer_1_10; use WP_CLI; trait NullIOMethodsTrait { /** * {@inheritDoc} */ public function isVerbose() { return true; } /** * {@inheritDoc} */ public function write( $messages, $newline = true, $verbosity = self::NORMAL ) { self::output_clean_message( $messages ); } /** * {@inheritDoc} */ public function writeError( $messages, $newline = true, $verbosity = self::NORMAL ) { self::output_clean_message( $messages ); } private static function output_clean_message( $messages ) { $messages = (array) preg_replace( '#<(https?)([^>]+)>#', '$1$2', $messages ); foreach ( $messages as $message ) { // phpcs:ignore WordPress.WP.AlternativeFunctions.strip_tags_strip_tags WP_CLI::log( strip_tags( trim( $message ) ) ); } } } <?php use Composer\Composer; use Composer\Config; use Composer\Config\JsonConfigSource; use Composer\DependencyResolver\Pool; use Composer\Factory; use Composer\IO\NullIO; use Composer\Installer; use Composer\Json\JsonFile; use Composer\Package\BasePackage; use Composer\Package\PackageInterface; use Composer\Package\Version\VersionSelector; use Composer\Repository; use Composer\Repository\CompositeRepository; use Composer\Repository\ComposerRepository; use Composer\Util\HttpDownloader; use WP_CLI\Package\ComposerIO; use WP_CLI\Extractor; use WP_CLI\Utils; use WP_CLI\JsonManipulator; use WP_CLI\PackageManagerEventSubscriber; use WP_CLI\RequestsLibrary; /** * Lists, installs, and removes WP-CLI packages. * * WP-CLI packages are community-maintained projects built on WP-CLI. They can * contain WP-CLI commands, but they can also just extend WP-CLI in some way. * * Learn how to create your own command from the * [Commands Cookbook](https://make.wordpress.org/cli/handbook/guides/commands-cookbook/) * * ## EXAMPLES * * # List installed packages. * $ wp package list * +-----------------------+------------------+----------+-----------+----------------+ * | name | authors | version | update | update_version | * +-----------------------+------------------+----------+-----------+----------------+ * | wp-cli/server-command | Daniel Bachhuber | dev-main | available | 2.x-dev | * +-----------------------+------------------+----------+-----------+----------------+ * * # Install the latest development version of the package. * $ wp package install wp-cli/server-command * Installing package wp-cli/server-command (dev-main) * Updating /home/person/.wp-cli/packages/composer.json to require the package... * Using Composer to install the package... * --- * Loading composer repositories with package information * Updating dependencies * Resolving dependencies through SAT * Dependency resolution completed in 0.005 seconds * Analyzed 732 packages to resolve dependencies * Analyzed 1034 rules to resolve dependencies * - Installing package * Writing lock file * Generating autoload files * --- * Success: Package installed. * * # Uninstall package. * $ wp package uninstall wp-cli/server-command * Removing require statement for package 'wp-cli/server-command' from /home/person/.wp-cli/packages/composer.json * Removing repository details from /home/person/.wp-cli/packages/composer.json * Removing package directories and regenerating autoloader... * Success: Uninstalled package. * * @package WP-CLI * * @when before_wp_load */ class Package_Command extends WP_CLI_Command { const PACKAGE_INDEX_URL = 'https://wp-cli.org/package-index/'; const DEFAULT_DEV_BRANCH_CONSTRAINTS = 'dev-main || dev-master || dev-trunk'; private $version_selector = false; /** * Default author data used while creating default WP-CLI packages composer.json. * * @var array */ private $author_data = [ 'name' => 'WP-CLI', 'email' => 'noreply@wpcli.org', ]; /** * Default repository data used while creating default WP-CLI packages composer.json. * @var array */ private $composer_type_package = [ 'type' => 'composer', 'url' => self::PACKAGE_INDEX_URL, ]; /** * Browses WP-CLI packages available for installation. * * Lists packages available for installation from the [Package Index](http://wp-cli.org/package-index/). * Although the package index will remain in place for backward compatibility reasons, it has been * deprecated and will not be updated further. Please refer to https://github.com/wp-cli/ideas/issues/51 * to read about its potential replacement. * * ## OPTIONS * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - ids * - json * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each package: * * * name * * description * * authors * * version * * There are no optionally available fields. * * ## EXAMPLES * * $ wp package browse --format=yaml * --- * 10up/mu-migration: * name: 10up/mu-migration * description: A set of WP-CLI commands to support the migration of single WordPress instances to multisite * authors: NÃcholas AndrÃ© * version: dev-main, dev-develop * aaemnnosttv/wp-cli-dotenv-command: * name: aaemnnosttv/wp-cli-dotenv-command * description: Dotenv commands for WP-CLI * authors: Evan Mattson * version: v0.1, v0.1-beta.1, v0.2, dev-main, dev-dev, dev-develop, dev-tests/behat * aaemnnosttv/wp-cli-http-command: * name: aaemnnosttv/wp-cli-http-command * description: WP-CLI command for using the WordPress HTTP API * authors: Evan Mattson * version: dev-main */ public function browse( $_, $assoc_args ) { $this->set_composer_auth_env_var(); if ( empty( $assoc_args['format'] ) || 'table' === $assoc_args['format'] ) { WP_CLI::line( WP_CLI::colorize( '%CAlthough the package index will remain in place for backward compatibility reasons, it has been deprecated and will not be updated further. Please refer to https://github.com/wp-cli/ideas/issues/51 to read about its potential replacement.%n' ) ); } $this->show_packages( 'browse', $this->get_community_packages(), $assoc_args ); } /** * Installs a WP-CLI package. * * Packages are required to be a valid Composer package, and can be * specified as: * * * Package name from WP-CLI's package index. * * Git URL accessible by the current shell user. * * Path to a directory on the local machine. * * Local or remote .zip file. * * Packages are installed to `~/.wp-cli/packages/` by default. Use the * `WP_CLI_PACKAGES_DIR` environment variable to provide a custom path. * * When installing a local directory, WP-CLI simply registers a * reference to the directory. If you move or delete the directory, WP-CLI's * reference breaks. * * When installing a .zip file, WP-CLI extracts the package to * `~/.wp-cli/packages/local/<package-name>`. * * If Github token authorization is required, a GitHub Personal Access Token * (https://github.com/settings/tokens) can be used. The following command * will add a GitHub Personal Access Token to Composer's global configuration: * composer config -g github-oauth.github.com <GITHUB_TOKEN> * Once this has been added, the value used for <GITHUB_TOKEN> will be used * for future authorization requests. * * ## OPTIONS * * <name|git|path|zip> * : Name, git URL, directory path, or .zip file for the package to install. * Names can optionally include a version constraint * (e.g. wp-cli/server-command:@stable). * * [--insecure] * : Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack. * * ## EXAMPLES * * # Install a package hosted at a git URL. * $ wp package install runcommand/hook * * # Install the latest stable version. * $ wp package install wp-cli/server-command:@stable * * # Install a package hosted at a GitLab.com URL. * $ wp package install https://gitlab.com/foo/wp-cli-bar-command.git * * # Install a package in a .zip file. * $ wp package install google-sitemap-generator-cli.zip */ public function install( $args, $assoc_args ) { list( $package_name ) = $args; $insecure = (bool) Utils\get_flag_value( $assoc_args, 'insecure', false ); $this->set_composer_auth_env_var(); $git_package = false; $dir_package = false; $version = ''; if ( $this->is_git_repository( $package_name ) ) { if ( '' === $version ) { $version = "dev-{$this->get_github_default_branch( $package_name, $insecure )}"; } $git_package = $package_name; $matches = []; if ( preg_match( '#([^:\/]+\/[^\/]+)\.git#', $package_name, $matches ) ) { $package_name = $this->check_git_package_name( $matches[1], $package_name, $version, $insecure ); } else { WP_CLI::error( "Couldn't parse package name from expected path '<name>/<package>'." ); } } elseif ( ( false !== strpos( $package_name, '://' ) && false !== stripos( $package_name, '.zip' ) ) || ( pathinfo( $package_name, PATHINFO_EXTENSION ) === 'zip' && is_file( $package_name ) ) ) { // Download the remote ZIP file to a temp directory $temp = false; if ( false !== strpos( $package_name, '://' ) ) { $temp = Utils\get_temp_dir() . uniqid( 'wp-cli-package_', true /*more_entropy*/ ) . '.zip'; $options = [ 'timeout' => 600, 'filename' => $temp, 'insecure' => $insecure, ]; $gitlab_token = getenv( 'GITLAB_TOKEN' ); // Use GITLAB_TOKEN if available to avoid authorization failures or rate-limiting. $headers = $gitlab_token && strpos( $package_name, '://gitlab.com/' ) !== false ? [ 'PRIVATE-TOKEN' => $gitlab_token ] : []; $response = Utils\http_request( 'GET', $package_name, null, $headers, $options ); if ( 20 !== (int) substr( $response->status_code, 0, 2 ) ) { @unlink( $temp ); // @codingStandardsIgnoreLine WP_CLI::error( sprintf( "Couldn't download package from '%s' (HTTP code %d).", $package_name, $response->status_code ) ); } $package_name = $temp; } $dir_package = Utils\get_temp_dir() . uniqid( 'wp-cli-package_', true /*more_entropy*/ ); try { // Extract the package to get the package name Extractor::extract( $package_name, $dir_package ); if ( $temp ) { unlink( $temp ); $temp = false; } list( $package_name, $version ) = self::get_package_name_and_version_from_dir_package( $dir_package ); // Move to a location based on the package name $local_dir = rtrim( WP_CLI::get_runner()->get_packages_dir_path(), '/' ) . '/local/'; $actual_dir_package = $local_dir . str_replace( '/', '-', $package_name ); Extractor::copy_overwrite_files( $dir_package, $actual_dir_package ); Extractor::rmdir( $dir_package ); // Behold, the extracted package $dir_package = $actual_dir_package; } catch ( Exception $e ) { if ( $temp ) { unlink( $temp ); } if ( file_exists( $dir_package ) ) { try { Extractor::rmdir( $dir_package ); } catch ( Exception $rmdir_e ) { WP_CLI::warning( $rmdir_e->getMessage() ); } } WP_CLI::error( $e->getMessage() ); } } elseif ( is_dir( $package_name ) && file_exists( $package_name . '/composer.json' ) ) { $dir_package = $package_name; if ( ! Utils\is_path_absolute( $dir_package ) ) { $dir_package = getcwd() . DIRECTORY_SEPARATOR . $dir_package; } list( $package_name, $version ) = self::get_package_name_and_version_from_dir_package( $dir_package ); } else { if ( false !== strpos( $package_name, ':' ) ) { list( $package_name, $version ) = explode( ':', $package_name ); } $package = $this->get_package_by_shortened_identifier( $package_name ); if ( ! $package ) { WP_CLI::error( sprintf( "Invalid package: shortened identifier '%s' not found.", $package_name ) ); } if ( is_string( $package ) ) { if ( $this->is_git_repository( $package ) ) { $git_package = $package; if ( '' === $version ) { $version = "dev-{$this->get_github_default_branch( $package_name, $insecure )}"; } if ( '@stable' === $version ) { $tag = $this->get_github_latest_release_tag( $package_name, $insecure ); $version = $this->guess_version_constraint_from_tag( $tag ); } $package_name = $this->check_github_package_name( $package_name, $version, $insecure ); } } elseif ( $package_name !== $package->getPrettyName() ) { // BC support for specifying lowercase names for mixed-case package index packages - don't bother warning. $package_name = $package->getPrettyName(); } } if ( $this->is_composer_v2() ) { $package_name = function_exists( 'mb_strtolower' ) ? mb_strtolower( $package_name ) : strtolower( $package_name ); } if ( '' === $version ) { $version = self::DEFAULT_DEV_BRANCH_CONSTRAINTS; } WP_CLI::log( sprintf( 'Installing package %s (%s)', $package_name, $version ) ); // Read the WP-CLI packages composer.json and do some initial error checking. list( $json_path, $composer_backup, $composer_backup_decoded ) = $this->get_composer_json_path_backup_decoded(); // Revert on shutdown if `$revert` is true (set to false on success). $revert = true; $this->register_revert_shutdown_function( $json_path, $composer_backup, $revert ); // Add the 'require' to composer.json WP_CLI::log( sprintf( 'Updating %s to require the package...', $json_path ) ); $json_manipulator = new JsonManipulator( $composer_backup ); $json_manipulator->addMainKey( 'name', 'wp-cli/wp-cli' ); $json_manipulator->addMainKey( 'version', self::get_wp_cli_version_composer() ); $json_manipulator->addLink( 'require', $package_name, $version, false /*sortPackages*/, true /*caseInsensitive*/ ); $json_manipulator->addConfigSetting( 'secure-http', true ); $package_args = []; if ( $git_package ) { WP_CLI::log( sprintf( 'Registering %s as a VCS repository...', $git_package ) ); $package_args = [ 'type' => 'vcs', 'url' => $git_package, ]; $json_manipulator->addSubNode( 'repositories', $package_name, $package_args, true /*caseInsensitive*/ ); } elseif ( $dir_package ) { WP_CLI::log( sprintf( 'Registering %s as a path repository...', $dir_package ) ); $package_args = [ 'type' => 'path', 'url' => $dir_package, ]; $json_manipulator->addSubNode( 'repositories', $package_name, $package_args, true /*caseInsensitive*/ ); } // If the composer file does not contain the current package index repository, refresh the repository definition. if ( empty( $composer_backup_decoded['repositories']['wp-cli']['url'] ) || self::PACKAGE_INDEX_URL !== $composer_backup_decoded['repositories']['wp-cli']['url'] ) { WP_CLI::log( 'Updating package index repository url...' ); $package_args = $this->composer_type_package; $json_manipulator->addRepository( 'wp-cli', $package_args ); } file_put_contents( $json_path, $json_manipulator->getContents() ); $composer = $this->get_composer(); // Set up the EventSubscriber $event_subscriber = new PackageManagerEventSubscriber(); $composer->getEventDispatcher()->addSubscriber( $event_subscriber ); // Set up the installer $install = Installer::create( new ComposerIO(), $composer ); $install->setUpdate( true ); // Installer class will only override composer.lock with this flag $install->setPreferSource( true ); // Use VCS when VCS for easier contributions. // Try running the installer, but revert composer.json if failed WP_CLI::log( 'Using Composer to install the package...' ); WP_CLI::log( '---' ); $res = false; try { $res = $install->run(); } catch ( Exception $e ) { WP_CLI::warning( $e->getMessage() ); } // TODO: The --insecure flag should cause another Composer run with verify disabled. WP_CLI::log( '---' ); if ( 0 === $res ) { $revert = false; WP_CLI::success( 'Package installed.' ); } else { $res_msg = $res ? " (Composer return code {$res})" : ''; // $res may be null apparently. WP_CLI::debug( "composer.json content:\n" . file_get_contents( $json_path ), 'packages' ); WP_CLI::error( "Package installation failed{$res_msg}." ); } } /** * Lists installed WP-CLI packages. * * ## OPTIONS * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - ids * - json * - yaml * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each package: * * * name * * authors * * version * * update * * update_version * * These fields are optionally available: * * * description * * ## EXAMPLES * * # List installed packages. * $ wp package list * +-----------------------+------------------+----------+-----------+----------------+ * | name | authors | version | update | update_version | * +-----------------------+------------------+----------+-----------+----------------+ * | wp-cli/server-command | Daniel Bachhuber | dev-main | available | 2.x-dev | * +-----------------------+------------------+----------+-----------+----------------+ * * @subcommand list */ public function list_( $args, $assoc_args ) { $this->set_composer_auth_env_var(); $this->show_packages( 'list', $this->get_installed_packages(), $assoc_args ); } /** * Gets the path to an installed WP-CLI package, or the package directory. * * If you want to contribute to a package, this is a great way to jump to it. * * ## OPTIONS * * [<name>] * : Name of the package to get the directory for. * * ## EXAMPLES * * # Get package path. * $ wp package path * /home/person/.wp-cli/packages/ * * # Get path to an installed package. * $ wp package path wp-cli/server-command * /home/person/.wp-cli/packages/vendor/wp-cli/server-command * * # Change directory to package path. * $ cd $(wp package path) && pwd * /home/vagrant/.wp-cli/packages */ public function path( $args ) { $packages_dir = WP_CLI::get_runner()->get_packages_dir_path(); if ( ! empty( $args ) ) { $packages_dir .= 'vendor/' . $args[0]; if ( ! is_dir( $packages_dir ) ) { WP_CLI::error( 'Invalid package name.' ); } } WP_CLI::line( $packages_dir ); } /** * Updates all installed WP-CLI packages to their latest version. * * ## EXAMPLES * * $ wp package update * Using Composer to update packages... * --- * Loading composer repositories with package information * Updating dependencies * Resolving dependencies through SAT * Dependency resolution completed in 0.074 seconds * Analyzed 1062 packages to resolve dependencies * Analyzed 22383 rules to resolve dependencies * Writing lock file * Generating autoload files * --- * Success: Packages updated. */ public function update() { $this->set_composer_auth_env_var(); $composer = $this->get_composer(); // Set up the EventSubscriber $event_subscriber = new PackageManagerEventSubscriber(); $composer->getEventDispatcher()->addSubscriber( $event_subscriber ); // Set up the installer $install = Installer::create( new ComposerIO(), $composer ); $install->setUpdate( true ); // Installer class will only override composer.lock with this flag $install->setPreferSource( true ); // Use VCS when VCS for easier contributions. WP_CLI::log( 'Using Composer to update packages...' ); WP_CLI::log( '---' ); $res = false; try { $res = $install->run(); } catch ( Exception $e ) { WP_CLI::warning( $e->getMessage() ); } WP_CLI::log( '---' ); // TODO: The --insecure (to be added here) flag should cause another Composer run with verify disabled. if ( 0 === $res ) { WP_CLI::success( 'Packages updated.' ); } else { $res_msg = $res ? " (Composer return code {$res})" : ''; // $res may be null apparently. WP_CLI::error( "Failed to update packages{$res_msg}." ); } } /** * Uninstalls a WP-CLI package. * * ## OPTIONS * * <name> * : Name of the package to uninstall. * * [--insecure] * : Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack. * * ## EXAMPLES * * # Uninstall package. * $ wp package uninstall wp-cli/server-command * Removing require statement for package 'wp-cli/server-command' from /home/person/.wp-cli/packages/composer.json * Removing repository details from /home/person/.wp-cli/packages/composer.json * Removing package directories and regenerating autoloader... * Success: Uninstalled package. */ public function uninstall( $args, $assoc_args ) { list( $package_name ) = $args; $insecure = (bool) Utils\get_flag_value( $assoc_args, 'insecure', false ); $this->set_composer_auth_env_var(); $package = $this->get_installed_package_by_name( $package_name ); if ( false === $package ) { $package_name = $this->get_package_by_shortened_identifier( $package_name ); if ( false === $package_name ) { WP_CLI::error( 'Package not installed.' ); } $version = "dev-{$this->get_github_default_branch( $package_name, $insecure )}"; $matches = []; if ( preg_match( '#^(?:https?://github\.com/|git@github\.com:)(?<repo_name>.*?).git$#', $package_name, $matches ) ) { $package_name = $this->check_git_package_name( $matches['repo_name'], $package_name, $version, $insecure ); } } else { $package_name = $package->getPrettyName(); // Make sure package name is what's in composer.json. } // Read the WP-CLI packages composer.json and do some initial error checking. list( $json_path, $composer_backup, $composer_backup_decoded ) = $this->get_composer_json_path_backup_decoded(); // Revert on shutdown if `$revert` is true (set to false on success). $revert = true; $this->register_revert_shutdown_function( $json_path, $composer_backup, $revert ); // Remove the 'require' from composer.json. WP_CLI::log( sprintf( 'Removing require statement for package \'%s\' from %s', $package_name, $json_path ) ); $manipulator = new JsonManipulator( $composer_backup ); $manipulator->removeSubNode( 'require', $package_name, true /*caseInsensitive*/ ); // Remove the 'repository' details from composer.json. WP_CLI::log( sprintf( 'Removing repository details from %s', $json_path ) ); $manipulator->removeSubNode( 'repositories', $package_name, true /*caseInsensitive*/ ); file_put_contents( $json_path, $manipulator->getContents() ); $composer = $this->get_composer(); // Set up the installer. $install = Installer::create( new NullIO(), $composer ); $install->setUpdate( true ); // Installer class will only override composer.lock with this flag $install->setPreferSource( true ); // Use VCS when VCS for easier contributions. WP_CLI::log( 'Removing package directories and regenerating autoloader...' ); $res = false; try { $res = $install->run(); } catch ( Exception $e ) { WP_CLI::warning( $e->getMessage() ); } if ( 0 === $res ) { $revert = false; WP_CLI::success( 'Uninstalled package.' ); } else { $res_msg = $res ? " (Composer return code {$res})" : ''; // $res may be null apparently. WP_CLI::error( "Package removal failed{$res_msg}." ); } } /** * Checks whether a package is a WP-CLI community package based * on membership in our package index. * * @param object $package A package object * @return bool */ private function is_community_package( $package ) { return $this->package_index()->hasPackage( $package ); } /** * Gets a Composer instance. */ private function get_composer() { $this->avoid_composer_ca_bundle(); try { $composer_path = $this->get_composer_json_path(); // Composer's auto-load generating code makes some assumptions about where // the 'vendor-dir' is, and where Composer is running from. // Best to just pretend we're installing a package from ~/.wp-cli or similar chdir( pathinfo( $composer_path, PATHINFO_DIRNAME ) ); // Prevent DateTime error/warning when no timezone set. // Note: The package is loaded before WordPress load, For environments that don't have set time in php.ini. // phpcs:ignore WordPress.DateTime.RestrictedFunctions.timezone_change_date_default_timezone_set,WordPress.PHP.NoSilencedErrors.Discouraged date_default_timezone_set( @date_default_timezone_get() ); $composer = Factory::create( new NullIO(), $composer_path ); } catch ( Exception $e ) { WP_CLI::error( sprintf( 'Failed to get composer instance: %s', $e->getMessage() ) ); } return $composer; } /** * Gets all of the community packages. * * @return array */ private function get_community_packages() { static $community_packages; if ( null === $community_packages ) { $this->avoid_composer_ca_bundle(); try { $community_packages = $this->package_index()->getPackages(); } catch ( Exception $e ) { WP_CLI::error( $e->getMessage() ); } } return $community_packages; } /** * Gets the package index instance * * We need to construct the instance manually, because there's no way to select * a particular instance using $composer->getRepositoryManager() * * @return ComposerRepository */ private function package_index() { static $package_index; if ( ! $package_index ) { $config_args = [ 'config' => [ 'secure-http' => true, 'home' => dirname( $this->get_composer_json_path() ), ], ]; $config = new Config(); $config->merge( $config_args ); $config->setConfigSource( new JsonConfigSource( $this->get_composer_json() ) ); $io = new NullIO(); try { if ( $this->is_composer_v2() ) { $http_downloader = new HttpDownloader( $io, $config ); $package_index = new ComposerRepository( [ 'url' => self::PACKAGE_INDEX_URL ], $io, $config, $http_downloader ); } else { $package_index = new ComposerRepository( [ 'url' => self::PACKAGE_INDEX_URL ], $io, $config ); } } catch ( Exception $e ) { WP_CLI::error( $e->getMessage() ); } } return $package_index; } /** * Displays a set of packages * * @param string $context * @param array * @param array */ private function show_packages( $context, $packages, $assoc_args ) { if ( 'list' === $context ) { $default_fields = [ 'name', 'authors', 'version', 'update', 'update_version', ]; } elseif ( 'browse' === $context ) { $default_fields = [ 'name', 'description', 'authors', 'version', ]; } $defaults = [ 'fields' => implode( ',', $default_fields ), 'format' => 'table', ]; $assoc_args = array_merge( $defaults, $assoc_args ); $composer = $this->get_composer(); $list = []; foreach ( $packages as $package ) { $name = $package->getPrettyName(); if ( isset( $list[ $name ] ) ) { $list[ $name ]['version'][] = $package->getPrettyVersion(); } else { $package_output = []; $package_output['name'] = $package->getPrettyName(); $package_output['description'] = $package->getDescription(); $package_output['authors'] = implode( ', ', array_column( (array) $package->getAuthors(), 'name' ) ); $package_output['version'] = [ $package->getPrettyVersion() ]; $update = 'none'; $update_version = ''; if ( 'list' === $context ) { try { $latest = $this->find_latest_package( $package, $composer, null ); if ( $latest && $latest->getFullPrettyVersion() !== $package->getFullPrettyVersion() ) { $update = 'available'; $update_version = $latest->getPrettyVersion(); } } catch ( Exception $e ) { WP_CLI::warning( $e->getMessage() ); $update = 'error'; $update_version = $update; } } $package_output['update'] = $update; $package_output['update_version'] = $update_version; $package_output['pretty_name'] = $package->getPrettyName(); // Deprecated but kept for BC with package-command 1.0.8. $list[ $package_output['name'] ] = $package_output; } } $list = array_map( function ( $package ) { $package['version'] = implode( ', ', $package['version'] ); return $package; }, $list ); ksort( $list ); if ( 'ids' === $assoc_args['format'] ) { $list = array_keys( $list ); } Utils\format_items( $assoc_args['format'], $list, $assoc_args['fields'] ); } /** * Gets a package by its shortened identifier. * * A shortened identifier has the form `<vendor>/<package>`. * * This method first checks the deprecated package index, for BC reasons, * and then falls back to the corresponding GitHub URL. * * @param string $package_name Name of the package to get. * @param bool $insecure Optional. Whether to insecurely retry downloads that failed TLS handshake. Defaults * to false. */ private function get_package_by_shortened_identifier( $package_name, $insecure = false ) { // Check the package index first, so we don't break existing behavior. $lc_package_name = strtolower( $package_name ); // For BC check. foreach ( $this->get_community_packages() as $package ) { if ( $package_name === $package->getPrettyName() ) { return $package; } // For BC allow getting by lowercase name. if ( $lc_package_name === $package->getName() ) { return $package; } } $options = [ 'insecure' => $insecure ]; // Check if the package exists on Packagist. $url = "https://repo.packagist.org/p/{$package_name}.json"; $response = Utils\http_request( 'GET', $url, null, [], $options ); if ( 20 === (int) substr( $response->status_code, 0, 2 ) ) { return $package_name; } // Fall back to GitHub URL if we had no match yet. $url = "https://github.com/{$package_name}.git"; $github_token = getenv( 'GITHUB_TOKEN' ); // Use GITHUB_TOKEN if available to avoid authorization failures or rate-limiting. $headers = $github_token ? [ 'Authorization' => 'token ' . $github_token ] : []; $response = Utils\http_request( 'GET', $url, null /*data*/, $headers, $options ); if ( 20 === (int) substr( $response->status_code, 0, 2 ) ) { return $url; } // Fall back to GitLab URL if we had no match yet. $url = "https://gitlab.com/{$package_name}.git"; $gitlab_token = getenv( 'GITLAB_TOKEN' ); // Use GITLAB_TOKEN if available to avoid authorization failures or rate-limiting. $headers = $github_token ? [ 'Authorization' => 'token ' . $github_token ] : []; $headers = $gitlab_token && strpos( $package_name, '://gitlab.com/' ) !== false ? [ 'PRIVATE-TOKEN' => $gitlab_token ] : []; $response = Utils\http_request( 'GET', $url, null /*data*/, $headers, $options ); if ( 20 === (int) substr( $response->status_code, 0, 2 ) ) { return $url; } return false; } /** * Gets the installed community packages. */ private function get_installed_packages() { $composer = $this->get_composer(); $repo = $composer->getRepositoryManager()->getLocalRepository(); $existing = json_decode( file_get_contents( $this->get_composer_json_path() ), true ); $installed_package_keys = ! empty( $existing['require'] ) ? array_keys( $existing['require'] ) : []; if ( empty( $installed_package_keys ) ) { return []; } // For use by legacy incorrect name check. $lc_installed_package_keys = array_map( 'strtolower', $installed_package_keys ); $installed_packages = []; foreach ( $repo->getCanonicalPackages() as $package ) { $idx = array_search( $package->getName(), $lc_installed_package_keys, true ); // Use pretty name as it's case sensitive and what's in composer.json (or at least should be). if ( in_array( $package->getPrettyName(), $installed_package_keys, true ) ) { $installed_packages[] = $package; } elseif ( false !== $idx ) { // Legacy incorrect name check. if ( ! $this->is_composer_v2() ) { WP_CLI::warning( sprintf( "Found package '%s' misnamed '%s' in '%s'.", $package->getPrettyName(), $installed_package_keys[ $idx ], $this->get_composer_json_path() ) ); } $installed_packages[] = $package; } } return $installed_packages; } /** * Gets an installed package by its name. */ private function get_installed_package_by_name( $package_name ) { foreach ( $this->get_installed_packages() as $package ) { if ( $package_name === $package->getPrettyName() ) { return $package; } // Also check non-pretty (lowercase) name in case of legacy incorrect name. if ( $package_name === $package->getName() ) { return $package; } } return false; } /** * Checks if the package name provided is already installed. */ private function is_package_installed( $package_name ) { if ( $this->get_installed_package_by_name( $package_name ) ) { return true; } else { return false; } } /** * Gets the name of the package from the composer.json in a directory path * * @param string $dir_package * @return array Two-element array containing package name and version. */ private static function get_package_name_and_version_from_dir_package( $dir_package ) { $composer_file = $dir_package . '/composer.json'; if ( ! file_exists( $composer_file ) ) { WP_CLI::error( sprintf( "Invalid package: composer.json file '%s' not found.", $composer_file ) ); } $composer_data = json_decode( file_get_contents( $composer_file ), true ); if ( null === $composer_data ) { WP_CLI::error( sprintf( "Invalid package: failed to parse composer.json file '%s' as json.", $composer_file ) ); } if ( empty( $composer_data['name'] ) ) { WP_CLI::error( sprintf( "Invalid package: no name in composer.json file '%s'.", $composer_file ) ); } $package_name = $composer_data['name']; $version = self::DEFAULT_DEV_BRANCH_CONSTRAINTS; if ( ! empty( $composer_data['version'] ) ) { $version = $composer_data['version']; } return [ $package_name, $version ]; } /** * Gets the WP-CLI packages composer.json object. */ private function get_composer_json() { return new JsonFile( $this->get_composer_json_path() ); } /** * Gets the absolute path to the WP-CLI packages composer.json. */ private function get_composer_json_path() { static $composer_path; if ( null === $composer_path || getenv( 'WP_CLI_TEST_PACKAGE_GET_COMPOSER_JSON_PATH' ) ) { if ( getenv( 'WP_CLI_PACKAGES_DIR' ) ) { $composer_path = Utils\trailingslashit( getenv( 'WP_CLI_PACKAGES_DIR' ) ) . 'composer.json'; } else { $composer_path = Utils\trailingslashit( Utils\get_home_dir() ) . '.wp-cli/packages/composer.json'; } // `composer.json` and its directory might need to be created if ( ! file_exists( $composer_path ) ) { $composer_path = $this->create_default_composer_json( $composer_path ); } else { $composer_path = realpath( $composer_path ); if ( false === $composer_path ) { $error = error_get_last(); WP_CLI::error( sprintf( "Composer path '%s' for packages/composer.json not found: %s", $composer_path, $error['message'] ) ); } } } return $composer_path; } /** * Gets the WP-CLI version for composer.json */ private static function get_wp_cli_version_composer() { preg_match( '#^[0-9\.]+(-(alpha|beta)[^-]{0,})?#', WP_CLI_VERSION, $matches ); $version = isset( $matches[0] ) ? $matches[0] : ''; return $version; } /** * Creates a default WP-CLI packages composer.json. * * @param string $composer_path Where the composer.json should be created * @return string Returns the absolute path of the newly created default WP-CLI packages composer.json. */ private function create_default_composer_json( $composer_path ) { $composer_dir = pathinfo( $composer_path, PATHINFO_DIRNAME ); if ( ! is_dir( $composer_dir ) ) { if ( ! @mkdir( $composer_dir, 0777, true ) ) { // @codingStandardsIgnoreLine $error = error_get_last(); WP_CLI::error( sprintf( "Composer directory '%s' for packages couldn't be created: %s", $composer_dir, $error['message'] ) ); } } $composer_dir = realpath( $composer_dir ); if ( false === $composer_dir ) { $error = error_get_last(); WP_CLI::error( sprintf( "Composer directory '%s' for packages not found: %s", $composer_dir, $error['message'] ) ); } $composer_path = Utils\trailingslashit( $composer_dir ) . Utils\basename( $composer_path ); $json_file = new JsonFile( $composer_path ); $repositories = (object) [ 'wp-cli' => (object) $this->composer_type_package, ]; $options = [ 'name' => 'wp-cli/wp-cli', 'description' => 'Installed community packages used by WP-CLI', 'version' => self::get_wp_cli_version_composer(), 'authors' => [ (object) $this->author_data ], 'homepage' => self::PACKAGE_INDEX_URL, 'require' => new stdClass(), 'require-dev' => new stdClass(), 'minimum-stability' => 'dev', 'prefer-stable' => true, 'license' => 'MIT', 'repositories' => $repositories, ]; try { $json_file->write( $options ); } catch ( Exception $e ) { WP_CLI::error( $e->getMessage() ); } return $composer_path; } /** * Given a package, this finds the latest package matching it * * @param PackageInterface $package * @param Composer $composer * @param string $phpVersion * @param bool $minorOnly * * @return PackageInterface|null */ private function find_latest_package( PackageInterface $package, Composer $composer, $php_version, $minor_only = false ) { // Find the latest version allowed in this pool/repository set. $name = $package->getPrettyName(); $version_selector = $this->get_version_selector( $composer ); $stability = $composer->getPackage()->getMinimumStability(); $flags = $composer->getPackage()->getStabilityFlags(); if ( isset( $flags[ $name ] ) ) { $stability = array_search( $flags[ $name ], BasePackage::$stabilities, true ); } $best_stability = $stability; if ( $composer->getPackage()->getPreferStable() ) { $best_stability = $package->getStability(); } $target_version = null; if ( 0 === strpos( $package->getVersion(), 'dev-' ) ) { $target_version = $package->getVersion(); } if ( null === $target_version && $minor_only ) { $target_version = '^' . $package->getVersion(); } if ( $this->is_composer_v2() ) { return $version_selector->findBestCandidate( $name, $target_version, $best_stability ); } return $version_selector->findBestCandidate( $name, $target_version, $php_version, $best_stability ); } private function get_version_selector( Composer $composer ) { if ( ! $this->version_selector ) { if ( $this->is_composer_v2() ) { $repository_set = new Repository\RepositorySet( $composer->getPackage()->getMinimumStability(), $composer->getPackage()->getStabilityFlags() ); $repository_set->addRepository( new CompositeRepository( $composer->getRepositoryManager()->getRepositories() ) ); $this->version_selector = new VersionSelector( $repository_set ); } else { $pool = new Pool( $composer->getPackage()->getMinimumStability(), $composer->getPackage()->getStabilityFlags() ); $pool->addRepository( new CompositeRepository( $composer->getRepositoryManager()->getRepositories() ) ); $this->version_selector = new VersionSelector( $pool ); } } return $this->version_selector; } /** * Checks whether a given package is a git repository. * * @param string $package Package name to check. * * @return bool Whether the package is a git repository. */ private function is_git_repository( $package ) { return '.git' === strtolower( substr( $package, -4, 4 ) ); } /** * Checks that `$package_name` matches the name in composer.json at Github.com, and return corrected value if not. * * @param string $package_name Package name to check. * @param string $version Optional. Package version. Defaults to empty string. * @param bool $insecure Optional. Whether to insecurely retry downloads that failed TLS handshake. Defaults * to false. */ private function check_github_package_name( $package_name, $version = '', $insecure = false ) { $github_token = getenv( 'GITHUB_TOKEN' ); // Use GITHUB_TOKEN if available to avoid authorization failures or rate-limiting. $headers = $github_token ? [ 'Authorization' => 'token ' . $github_token ] : []; $options = [ 'insecure' => $insecure ]; // Generate raw git URL of composer.json file. $raw_content_url = "https://raw.githubusercontent.com/{$package_name}/{$this->get_raw_git_version( $version )}/composer.json"; $response = Utils\http_request( 'GET', $raw_content_url, null /*data*/, $headers, $options ); if ( 20 !== (int) substr( $response->status_code, 0, 2 ) ) { // Could not get composer.json. Possibly private so warn and return best guess from input (always xxx/xxx). WP_CLI::warning( sprintf( "Couldn't download composer.json file from '%s' (HTTP code %d). Presuming package name is '%s'.", $raw_content_url, $response->status_code, $package_name ) ); return $package_name; } // Convert composer.json JSON to Array. $composer_content_as_array = json_decode( $response->body, true ); if ( null === $composer_content_as_array ) { WP_CLI::error( sprintf( "Failed to parse '%s' as json.", $raw_content_url ) ); } if ( empty( $composer_content_as_array['name'] ) ) { WP_CLI::error( sprintf( "Invalid package: no name in composer.json file '%s'.", $raw_content_url ) ); } // Package name in composer.json that is hosted on GitHub. $package_name_on_repo = $composer_content_as_array['name']; // If package name and repository name are not identical, then fix it. if ( $package_name !== $package_name_on_repo ) { WP_CLI::warning( sprintf( "Package name mismatch...Updating from git name '%s' to composer.json name '%s'.", $package_name, $package_name_on_repo ) ); $package_name = $package_name_on_repo; } return $package_name; } /** * Checks that `$package_name` matches the name in composer.json at the corresponding upstream repository, and return corrected value if not. * * @param string $package_name Package name to check. * @param string $url URL to fetch the package from. * @param string $version Optional. Package version. Defaults to empty string. * @param bool $insecure Optional. Whether to insecurely retry downloads that failed TLS handshake. Defaults * to false. */ private function check_git_package_name( $package_name, $url = '', $version = '', $insecure = false ) { if ( $url && ( ( strpos( $url, '://gitlab.com/' ) !== false ) || ( strpos( $url, 'git@gitlab.com:' ) !== false ) ) ) { $matches = []; preg_match( '#gitlab.com[:/](.*?)\.git#', $url, $matches ); return $this->check_gitlab_package_name( $matches[1], $version, $insecure ); } return $this->check_github_package_name( $package_name, $version, $insecure ); } /** * Checks that `$package_name` matches the name in composer.json at GitLab.com, and return corrected value if not. * * @param string $project_name Package name to check. * @param string $version Optional. Package version. Defaults to empty string. * @param bool $insecure Optional. Whether to insecurely retry downloads that failed TLS handshake. Defaults * to false. */ private function check_gitlab_package_name( $project_name, $version = '', $insecure = false ) { $options = [ 'insecure' => $insecure ]; // Generate raw git URL of composer.json file. $raw_content_public_url = 'https://gitlab.com/' . $project_name . '/-/raw/' . $this->get_raw_git_version( $version ) . '/composer.json'; $raw_content_private_url = 'https://gitlab.com/api/v4/projects/' . rawurlencode( $project_name ) . '/repository/files/composer.json/raw?ref=' . $this->get_raw_git_version( $version ); $matches = []; preg_match( '#([^:\/]+\/[^\/]+$)#', $project_name, $matches ); $package_name = $matches[1]; $gitlab_token = getenv( 'GITLAB_TOKEN' ); // Use GITLAB_TOKEN if available to avoid authorization failures or rate-limiting. $response = Utils\http_request( 'GET', $raw_content_public_url, null /*data*/, [], $options ); if ( ! $gitlab_token && ( $response->status_code < 200 || $response->status_code >= 300 ) ) { // Could not get composer.json. Possibly private so warn and return best guess from input (always xxx/xxx). WP_CLI::warning( sprintf( "Couldn't download composer.json file from '%s' (HTTP code %d). Presuming package name is '%s'.", $raw_content_public_url, $response->status_code, $package_name ) ); return $package_name; } if ( strpos( $response->headers['content-type'], 'text/html' ) === 0 ) { $headers = $gitlab_token ? [ 'PRIVATE-TOKEN' => $gitlab_token ] : []; $response = Utils\http_request( 'GET', $raw_content_private_url, null /*data*/, $headers, $options ); if ( $response->status_code < 200 || $response->status_code >= 300 ) { // Could not get composer.json. Possibly private so warn and return best guess from input (always xxx/xxx). WP_CLI::warning( sprintf( "Couldn't download composer.json file from '%s' (HTTP code %d). Presuming package name is '%s'.", $raw_content_private_url, $response->status_code, $package_name ) ); return $package_name; } } // Convert composer.json JSON to Array. $composer_content_as_array = json_decode( $response->body, true ); if ( null === $composer_content_as_array ) { WP_CLI::error( sprintf( "Failed to parse '%s' as json.", $response->url ) ); } if ( empty( $composer_content_as_array['name'] ) ) { WP_CLI::error( sprintf( "Invalid package: no name in composer.json file '%s'.", $response->url ) ); } // Package name in composer.json that is hosted on Gitlab. $package_name_on_repo = $composer_content_as_array['name']; // If package name and repository name are not identical, then fix it. if ( $package_name !== $package_name_on_repo ) { WP_CLI::warning( sprintf( "Package name mismatch...Updating from git name '%s' to composer.json name '%s'.", $package_name, $package_name_on_repo ) ); $package_name = $package_name_on_repo; } return $package_name; } /** * Get the version to use for raw GitHub request. Very basic. * * @string $version Package version. * @string Version to use for GitHub request. */ private function get_raw_git_version( $version ) { if ( '' === $version ) { return 'master'; } // If Composer hash given then just use whatever's after it. $hash_pos = strpos( $version, '#' ); if ( false !== $hash_pos ) { return substr( $version, $hash_pos + 1 ); } // Strip any Composer 'dev-' prefix. if ( 0 === strncmp( $version, 'dev-', 4 ) ) { $version = substr( $version, 4 ); } // Ignore/strip any relative suffixes. return str_replace( [ '^', '~' ], '', $version ); } /** * Gets the release tag for the latest stable release of a GitHub repository. * * @param string $package_name Name of the repository. * * @return string Release tag. */ private function get_github_latest_release_tag( $package_name, $insecure ) { $url = "https://api.github.com/repos/{$package_name}/releases/latest"; $options = [ 'insecure' => $insecure ]; $response = Utils\http_request( 'GET', $url, null, [], $options ); if ( 20 !== (int) substr( $response->status_code, 0, 2 ) ) { WP_CLI::warning( 'Could not guess stable version from GitHub repository, falling back to master branch' ); return 'master'; } $package_data = json_decode( $response->body ); if ( JSON_ERROR_NONE !== json_last_error() ) { WP_CLI::warning( 'Could not guess stable version from GitHub repository, falling back to master branch' ); return 'master'; } $tag = $package_data->tag_name; WP_CLI::debug( "Extracted latest stable release tag: {$tag}", 'packages' ); return $tag; } /** * Guesses the version constraint from a release tag. * * @param string $tag Release tag to guess the version constraint from. * * @return string Version constraint. */ private function guess_version_constraint_from_tag( $tag ) { $matches = []; if ( 1 !== preg_match( '/(?:version|v)\s*((?:[0-9]+\.?)+)(?:-.*)/i', $tag, $matches ) ) { return $tag; } $constraint = "^{$matches[1]}"; WP_CLI::debug( "Guessing version constraint to use: {$constraint}", 'packages' ); return $constraint; } /** * Sets `COMPOSER_AUTH` environment variable (which Composer merges into the config setup in `Composer\Factory::createConfig()`) depending on available environment variables. * Avoids authorization failures when accessing various sites. */ private function set_composer_auth_env_var() { $changed = false; $composer_auth = getenv( 'COMPOSER_AUTH' ); if ( false !== $composer_auth ) { $composer_auth = json_decode( $composer_auth, true /*assoc*/ ); } if ( empty( $composer_auth ) || ! is_array( $composer_auth ) ) { $composer_auth = []; } $github_token = getenv( 'GITHUB_TOKEN' ); if ( ! isset( $composer_auth['github-oauth'] ) && is_string( $github_token ) ) { $composer_auth['github-oauth'] = [ 'github.com' => $github_token ]; $changed = true; } if ( $changed ) { putenv( 'COMPOSER_AUTH=' . json_encode( $composer_auth ) ); } } /** * Avoid using default Composer CA bundle if in phar as we don't include it. * See https://github.com/composer/ca-bundle/blob/1.1.0/src/CaBundle.php#L64 */ private function avoid_composer_ca_bundle() { if ( Utils\inside_phar() && ! getenv( 'SSL_CERT_FILE' ) && ! getenv( 'SSL_CERT_DIR' ) && ! ini_get( 'openssl.cafile' ) && ! ini_get( 'openssl.capath' ) ) { $certificate_path = Utils\extract_from_phar( RequestsLibrary::get_bundled_certificate_path() ); putenv( "SSL_CERT_FILE={$certificate_path}" ); } } /** * Reads the WP-CLI packages composer.json, checking validity and returning array containing its path, contents, and decoded contents. * * @return array Indexed array containing the path, the contents, and the decoded contents of the WP-CLI packages composer.json. */ private function get_composer_json_path_backup_decoded() { $composer_json_obj = $this->get_composer_json(); $json_path = $composer_json_obj->getPath(); $composer_backup = file_get_contents( $json_path ); if ( false === $composer_backup ) { $error = error_get_last(); WP_CLI::error( sprintf( "Failed to read '%s': %s", $json_path, $error['message'] ) ); } try { $composer_backup_decoded = $composer_json_obj->read(); } catch ( Exception $e ) { WP_CLI::error( sprintf( "Failed to parse '%s' as json: %s", $json_path, $e->getMessage() ) ); } return [ $json_path, $composer_backup, $composer_backup_decoded ]; } /** * Registers a PHP shutdown function to revert composer.json unless * referenced `$revert` flag is false. * * @param string $json_path Path to composer.json. * @param string $composer_backup Original contents of composer.json. * @param bool &$revert Flags whether to revert or not. */ private function register_revert_shutdown_function( $json_path, $composer_backup, &$revert ) { // Allocate all needed memory beforehand as much as possible. $revert_msg = "Reverted composer.json.\n"; $revert_fail_msg = "Failed to revert composer.json.\n"; $memory_msg = "WP-CLI ran out of memory. Please see https://bit.ly/wpclimem for further help.\n"; $memory_string = 'Allowed memory size of'; $error_array = [ 'type' => 42, 'message' => 'Some random dummy string to take up memory', 'file' => 'Another random string, which would be a filename this time', 'line' => 314, ]; register_shutdown_function( static function () use ( $json_path, $composer_backup, &$revert, $revert_msg, $revert_fail_msg, $memory_msg, $memory_string, $error_array ) { if ( $revert ) { if ( false !== file_put_contents( $json_path, $composer_backup ) ) { fwrite( STDERR, $revert_msg ); } else { fwrite( STDERR, $revert_fail_msg ); } } $error_array = error_get_last(); if ( is_array( $error_array ) && false !== strpos( $error_array['message'], $memory_string ) ) { fwrite( STDERR, $memory_msg ); } } ); } /** * Check whether we are dealing with Composer version 2.0.0+. * * @return bool */ private function is_composer_v2() { return version_compare( Composer::getVersion(), '2.0.0', '>=' ); } /** * Try to retrieve default branch via GitHub API. * * @param string $package_name GitHub package name to retrieve the default branch from. * @param bool $insecure Optional. Whether to insecurely retry downloads that failed TLS handshake. Defaults * to false. * @return string Default branch, or 'master' if it could not be retrieved. */ private function get_github_default_branch( $package_name, $insecure = false ) { $github_token = getenv( 'GITHUB_TOKEN' ); // Use GITHUB_TOKEN if available to avoid authorization failures or rate-limiting. $headers = $github_token ? [ 'Authorization' => 'token ' . $github_token ] : []; $options = [ 'insecure' => $insecure ]; $matches = []; if ( preg_match( '#^(?:https?://github\.com/|git@github\.com:)(?<repo_name>.*?).git$#', $package_name, $matches ) ) { $package_name = $matches['repo_name']; } $github_api_repo_url = "https://api.github.com/repos/{$package_name}"; $response = Utils\http_request( 'GET', $github_api_repo_url, null /*data*/, $headers, $options ); if ( 20 !== (int) substr( $response->status_code, 0, 2 ) ) { WP_CLI::warning( sprintf( "Couldn't fetch default branch for package '%s' (HTTP code %d). Presuming default branch is 'master'.", $package_name, $response->status_code ) ); return 'master'; } $package_data = json_decode( $response->body ); if ( JSON_ERROR_NONE !== json_last_error() ) { WP_CLI::warning( "Couldn't fetch default branch for package '%s' (failed to decode JSON response). Presuming default branch is 'master'." ); return 'master'; } $default_branch = $package_data->default_branch; if ( ! is_string( $default_branch ) || empty( $default_branch ) ) { WP_CLI::warning( sprintf( "Couldn't fetch default branch for package '%s'. Presuming default branch is 'master'.", $package_name ) ); return 'master'; } WP_CLI::debug( "Detected package default branch: {$default_branch}", 'packages' ); return $default_branch; } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_package_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_package_autoloader ) && ! class_exists( 'Package_Command' ) ) { require_once $wpcli_package_autoloader; } WP_CLI::add_command( 'package', 'Package_Command' ); <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli; /** * A more complex type of Notifier, `Progress` Notifiers always have a maxim * value and generally show some form of percent complete or estimated time * to completion along with the standard Notifier displays. * * @see cli\Notify */ abstract class Progress extends \cli\Notify { protected $_total = 0; /** * Instantiates a Progress Notifier. * * @param string $msg The text to display next to the Notifier. * @param int $total The total number of ticks we will be performing. * @param int $interval The interval in milliseconds between updates. * @see cli\Progress::setTotal() */ public function __construct($msg, $total, $interval = 100) { parent::__construct($msg, $interval); $this->setTotal($total); } /** * Set the max increments for this progress notifier. * * @param int $total The total number of times this indicator should be `tick`ed. * @throws \InvalidArgumentException Thrown if the `$total` is less than 0. */ public function setTotal($total) { $this->_total = (int)$total; if ($this->_total < 0) { throw new \InvalidArgumentException('Maximum value out of range, must be positive.'); } } /** * Reset the progress state so the same instance can be used in multiple loops. */ public function reset($total = null) { parent::reset(); if ($total) { $this->setTotal($total); } } /** * Behaves in a similar manner to `cli\Notify::current()`, but the output * is padded to match the length of `cli\Progress::total()`. * * @return string The formatted and padded tick count. * @see cli\Progress::total() */ public function current() { $size = strlen($this->total()); return str_pad(parent::current(), $size); } /** * Returns the formatted total expected ticks. * * @return string The formatted total ticks. */ public function total() { return number_format($this->_total); } /** * Calculates the estimated total time for the tick count to reach the * total ticks given. * * @return int The estimated total number of seconds for all ticks to be * completed. This is not the estimated time left, but total. * @see cli\Notify::speed() * @see cli\Notify::elapsed() */ public function estimated() { $speed = $this->speed(); if (!$speed || !$this->elapsed()) { return 0; } $estimated = round($this->_total / $speed); return $estimated; } /** * Forces the current tick count to the total ticks given at instatiation * time before passing on to `cli\Notify::finish()`. */ public function finish() { $this->_current = $this->_total; parent::finish(); } /** * Increments are tick counter by the given amount. If no amount is provided, * the ticker is incremented by 1. * * @param int $increment The amount to increment by. */ public function increment($increment = 1) { $this->_current = min($this->_total, $this->_current + $increment); } /** * Calculate the percentage completed. * * @return float The percent completed. */ public function percent() { if ($this->_total == 0) { return 1; } return ($this->_current / $this->_total); } } <?php namespace cli; class Streams { protected static $out = STDOUT; protected static $in = STDIN; protected static $err = STDERR; static function _call( $func, $args ) { $method = __CLASS__ . '::' . $func; return call_user_func_array( $method, $args ); } static public function isTty() { if ( function_exists('stream_isatty') ) { return stream_isatty(static::$out); } else { return (function_exists('posix_isatty') && posix_isatty(static::$out)); } } /** * Handles rendering strings. If extra scalar arguments are given after the `$msg` * the string will be rendered with `sprintf`. If the second argument is an `array` * then each key in the array will be the placeholder name. Placeholders are of the * format {:key}. * * @param string $msg The message to render. * @param mixed ... Either scalar arguments or a single array argument. * @return string The rendered string. */ public static function render( $msg ) { $args = func_get_args(); // No string replacement is needed if( count( $args ) == 1 || ( is_string( $args[1] ) && '' === $args[1] ) ) { return Colors::shouldColorize() ? Colors::colorize( $msg ) : $msg; } // If the first argument is not an array just pass to sprintf if( !is_array( $args[1] ) ) { // Colorize the message first so sprintf doesn't bitch at us if ( Colors::shouldColorize() ) { $args[0] = Colors::colorize( $args[0] ); } // Escape percent characters for sprintf $args[0] = preg_replace('/(%([^\w]|$))/', "%$1", $args[0]); return call_user_func_array( 'sprintf', $args ); } // Here we do named replacement so formatting strings are more understandable foreach( $args[1] as $key => $value ) { $msg = str_replace( '{:' . $key . '}', $value, $msg ); } return Colors::shouldColorize() ? Colors::colorize( $msg ) : $msg; } /** * Shortcut for printing to `STDOUT`. The message and parameters are passed * through `sprintf` before output. * * @param string $msg The message to output in `printf` format. * @param mixed ... Either scalar arguments or a single array argument. * @return void * @see \cli\render() */ public static function out( $msg ) { fwrite( static::$out, self::_call( 'render', func_get_args() ) ); } /** * Pads `$msg` to the width of the shell before passing to `cli\out`. * * @param string $msg The message to pad and pass on. * @param mixed ... Either scalar arguments or a single array argument. * @return void * @see cli\out() */ public static function out_padded( $msg ) { $msg = self::_call( 'render', func_get_args() ); self::out( str_pad( $msg, \cli\Shell::columns() ) ); } /** * Prints a message to `STDOUT` with a newline appended. See `\cli\out` for * more documentation. * * @see cli\out() */ public static function line( $msg = '' ) { // func_get_args is empty if no args are passed even with the default above. $args = array_merge( func_get_args(), array( '' ) ); $args[0] .= "\n"; self::_call( 'out', $args ); } /** * Shortcut for printing to `STDERR`. The message and parameters are passed * through `sprintf` before output. * * @param string $msg The message to output in `printf` format. With no string, * a newline is printed. * @param mixed ... Either scalar arguments or a single array argument. * @return void */ public static function err( $msg = '' ) { // func_get_args is empty if no args are passed even with the default above. $args = array_merge( func_get_args(), array( '' ) ); $args[0] .= "\n"; fwrite( static::$err, self::_call( 'render', $args ) ); } /** * Takes input from `STDIN` in the given format. If an end of transmission * character is sent (^D), an exception is thrown. * * @param string $format A valid input format. See `fscanf` for documentation. * If none is given, all input up to the first newline * is accepted. * @param boolean $hide If true will hide what the user types in. * @return string The input with whitespace trimmed. * @throws \Exception Thrown if ctrl-D (EOT) is sent as input. */ public static function input( $format = null, $hide = false ) { if ( $hide ) Shell::hide(); if( $format ) { fscanf( static::$in, $format . "\n", $line ); } else { $line = fgets( static::$in ); } if ( $hide ) { Shell::hide( false ); echo "\n"; } if( $line === false ) { throw new \Exception( 'Caught ^D during input' ); } return trim( $line ); } /** * Displays an input prompt. If no default value is provided the prompt will * continue displaying until input is received. * * @param string $question The question to ask the user. * @param bool|string $default A default value if the user provides no input. * @param string $marker A string to append to the question and default value * on display. * @param boolean $hide Optionally hides what the user types in. * @return string The users input. * @see cli\input() */ public static function prompt( $question, $default = false, $marker = ': ', $hide = false ) { if( $default && strpos( $question, '[' ) === false ) { $question .= ' [' . $default . ']'; } while( true ) { self::out( $question . $marker ); $line = self::input( null, $hide ); if ( trim( $line ) !== '' ) return $line; if( $default !== false ) return $default; } } /** * Presents a user with a multiple choice question, useful for 'yes/no' type * questions (which this public static function defaults too). * * @param string $question The question to ask the user. * @param string $choice A string of characters allowed as a response. Case is ignored. * @param string $default The default choice. NULL if a default is not allowed. * @return string The users choice. * @see cli\prompt() */ public static function choose( $question, $choice = 'yn', $default = 'n' ) { if( !is_string( $choice ) ) { $choice = join( '', $choice ); } // Make every choice character lowercase except the default $choice = str_ireplace( $default, strtoupper( $default ), strtolower( $choice ) ); // Seperate each choice with a forward-slash $choices = trim( join( '/', preg_split( '//', $choice ) ), '/' ); while( true ) { $line = self::prompt( sprintf( '%s? [%s]', $question, $choices ), $default, '' ); if( stripos( $choice, $line ) !== false ) { return strtolower( $line ); } if( !empty( $default ) ) { return strtolower( $default ); } } } /** * Displays an array of strings as a menu where a user can enter a number to * choose an option. The array must be a single dimension with either strings * or objects with a `__toString()` method. * * @param array $items The list of items the user can choose from. * @param string $default The index of the default item. * @param string $title The message displayed to the user when prompted. * @return string The index of the chosen item. * @see cli\line() * @see cli\input() * @see cli\err() */ public static function menu( $items, $default = null, $title = 'Choose an item' ) { $map = array_values( $items ); if( $default && strpos( $title, '[' ) === false && isset( $items[$default] ) ) { $title .= ' [' . $items[$default] . ']'; } foreach( $map as $idx => $item ) { self::line( ' %d. %s', $idx + 1, (string)$item ); } self::line(); while( true ) { fwrite( static::$out, sprintf( '%s: ', $title ) ); $line = self::input(); if( is_numeric( $line ) ) { $line--; if( isset( $map[$line] ) ) { return array_search( $map[$line], $items ); } if( $line < 0 || $line >= count( $map ) ) { self::err( 'Invalid menu selection: out of range' ); } } else if( isset( $default ) ) { return $default; } } } /** * Sets one of the streams (input, output, or error) to a `stream` type resource. * * Valid $whichStream values are: * - 'in' (default: STDIN) * - 'out' (default: STDOUT) * - 'err' (default: STDERR) * * Any custom streams will be closed for you on shutdown, so please don't close stream * resources used with this method. * * @param string $whichStream The stream property to update * @param resource $stream The new stream resource to use * @return void * @throws \Exception Thrown if $stream is not a resource of the 'stream' type. */ public static function setStream( $whichStream, $stream ) { if( !is_resource( $stream ) || get_resource_type( $stream ) !== 'stream' ) { throw new \Exception( 'Invalid resource type!' ); } if( property_exists( __CLASS__, $whichStream ) ) { static::${$whichStream} = $stream; } register_shutdown_function( function() use ($stream) { fclose( $stream ); } ); } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author Ryan Sullivan <rsullivan@connectstudios.com> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli; /** * The `Tree` class is used to display data in a tree-like format. */ class Tree { protected $_renderer; protected $_data = array(); /** * Sets the renderer used by this tree. * * @param tree\Renderer $renderer The renderer to use for output. * @see tree\Renderer * @see tree\Ascii * @see tree\Markdown */ public function setRenderer(tree\Renderer $renderer) { $this->_renderer = $renderer; } /** * Set the data. * Format: * [ * 'Label' => [ * 'Thing' => ['Thing'], * ], * 'Thing', * ] * @param array $data */ public function setData(array $data) { $this->_data = $data; } /** * Render the tree and return it as a string. * * @return string|null */ public function render() { return $this->_renderer->render($this->_data); } /** * Display the rendered tree */ public function display() { echo $this->render(); } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli; /** * Change the color of text. * * Reference: http://graphcomp.com/info/specs/ansi_col.html#colors */ class Colors { static protected $_colors = array( 'color' => array( 'black' => 30, 'red' => 31, 'green' => 32, 'yellow' => 33, 'blue' => 34, 'magenta' => 35, 'cyan' => 36, 'white' => 37 ), 'style' => array( 'bright' => 1, 'dim' => 2, 'underline' => 4, 'blink' => 5, 'reverse' => 7, 'hidden' => 8 ), 'background' => array( 'black' => 40, 'red' => 41, 'green' => 42, 'yellow' => 43, 'blue' => 44, 'magenta' => 45, 'cyan' => 46, 'white' => 47 ) ); static protected $_enabled = null; static protected $_string_cache = array(); static public function enable($force = true) { self::$_enabled = $force === true ? true : null; } static public function disable($force = true) { self::$_enabled = $force === true ? false : null; } /** * Check if we should colorize output based on local flags and shell type. * * Only check the shell type if `Colors::$_enabled` is null and `$colored` is null. */ static public function shouldColorize($colored = null) { return self::$_enabled === true || (self::$_enabled !== false && ($colored === true || ($colored !== false && Streams::isTty()))); } /** * Set the color. * * @param string $color The name of the color or style to set. * @return string */ static public function color($color) { if (!is_array($color)) { $color = compact('color'); } $color += array('color' => null, 'style' => null, 'background' => null); if ($color['color'] == 'reset') { return "\033[0m"; } $colors = array(); foreach (array('color', 'style', 'background') as $type) { $code = $color[$type]; if (isset(self::$_colors[$type][$code])) { $colors[] = self::$_colors[$type][$code]; } } if (empty($colors)) { $colors[] = 0; } return "\033[" . join(';', $colors) . "m"; } /** * Colorize a string using helpful string formatters. If the `Streams::$out` points to a TTY coloring will be enabled, * otherwise disabled. You can control this check with the `$colored` parameter. * * @param string $string * @param boolean $colored Force enable or disable the colorized output. If left as `null` the TTY will control coloring. * @return string */ static public function colorize($string, $colored = null) { $passed = $string; if (!self::shouldColorize($colored)) { $return = self::decolorize( $passed, 2 /*keep_encodings*/ ); self::cacheString($passed, $return); return $return; } $md5 = md5($passed); if (isset(self::$_string_cache[$md5]['colorized'])) { return self::$_string_cache[$md5]['colorized']; } $string = str_replace('%%', '%Â¾', $string); foreach (self::getColors() as $key => $value) { $string = str_replace($key, self::color($value), $string); } $string = str_replace('%Â¾', '%', $string); self::cacheString($passed, $string); return $string; } /** * Remove color information from a string. * * @param string $string A string with color information. * @param int $keep Optional. If the 1 bit is set, color tokens (eg "%n") won't be stripped. If the 2 bit is set, color encodings (ANSI escapes) won't be stripped. Default 0. * @return string A string with color information removed. */ static public function decolorize( $string, $keep = 0 ) { $string = (string) $string; if ( ! ( $keep & 1 ) ) { // Get rid of color tokens if they exist $string = str_replace('%%', '%Â¾', $string); $string = str_replace(array_keys(self::getColors()), '', $string); $string = str_replace('%Â¾', '%', $string); } if ( ! ( $keep & 2 ) ) { // Remove color encoding if it exists foreach (self::getColors() as $key => $value) { $string = str_replace(self::color($value), '', $string); } } return $string; } /** * Cache the original, colorized, and decolorized versions of a string. * * @param string $passed The original string before colorization. * @param string $colorized The string after running through self::colorize. * @param string $deprecated Optional. Not used. Default null. */ static public function cacheString( $passed, $colorized, $deprecated = null ) { self::$_string_cache[md5($passed)] = array( 'passed' => $passed, 'colorized' => $colorized, 'decolorized' => self::decolorize($passed), // Not very useful but keep for BC. ); } /** * Return the length of the string without color codes. * * @param string $string the string to measure * @return int */ static public function length($string) { return safe_strlen( self::decolorize( $string ) ); } /** * Return the width (length in characters) of the string without color codes if enabled. * * @param string $string The string to measure. * @param bool $pre_colorized Optional. Set if the string is pre-colorized. Default false. * @param string|bool $encoding Optional. The encoding of the string. Default false. * @return int */ static public function width( $string, $pre_colorized = false, $encoding = false ) { return strwidth( $pre_colorized || self::shouldColorize() ? self::decolorize( $string, $pre_colorized ? 1 /*keep_tokens*/ : 0 ) : $string, $encoding ); } /** * Pad the string to a certain display length. * * @param string $string The string to pad. * @param int $length The display length. * @param bool $pre_colorized Optional. Set if the string is pre-colorized. Default false. * @param string|bool $encoding Optional. The encoding of the string. Default false. * @param int $pad_type Optional. Can be STR_PAD_RIGHT, STR_PAD_LEFT, or STR_PAD_BOTH. If pad_type is not specified it is assumed to be STR_PAD_RIGHT. * @return string */ static public function pad( $string, $length, $pre_colorized = false, $encoding = false, $pad_type = STR_PAD_RIGHT ) { $string = (string) $string; $real_length = self::width( $string, $pre_colorized, $encoding ); $diff = strlen( $string ) - $real_length; $length += $diff; return str_pad( $string, $length, ' ', $pad_type ); } /** * Get the color mapping array. * * @return array Array of color tokens mapped to colors and styles. */ static public function getColors() { return array( '%y' => array('color' => 'yellow'), '%g' => array('color' => 'green'), '%b' => array('color' => 'blue'), '%r' => array('color' => 'red'), '%p' => array('color' => 'magenta'), '%m' => array('color' => 'magenta'), '%c' => array('color' => 'cyan'), '%w' => array('color' => 'white'), '%k' => array('color' => 'black'), '%n' => array('color' => 'reset'), '%Y' => array('color' => 'yellow', 'style' => 'bright'), '%G' => array('color' => 'green', 'style' => 'bright'), '%B' => array('color' => 'blue', 'style' => 'bright'), '%R' => array('color' => 'red', 'style' => 'bright'), '%P' => array('color' => 'magenta', 'style' => 'bright'), '%M' => array('color' => 'magenta', 'style' => 'bright'), '%C' => array('color' => 'cyan', 'style' => 'bright'), '%W' => array('color' => 'white', 'style' => 'bright'), '%K' => array('color' => 'black', 'style' => 'bright'), '%N' => array('color' => 'reset', 'style' => 'bright'), '%3' => array('background' => 'yellow'), '%2' => array('background' => 'green'), '%4' => array('background' => 'blue'), '%1' => array('background' => 'red'), '%5' => array('background' => 'magenta'), '%6' => array('background' => 'cyan'), '%7' => array('background' => 'white'), '%0' => array('background' => 'black'), '%F' => array('style' => 'blink'), '%U' => array('style' => 'underline'), '%8' => array('style' => 'reverse'), '%9' => array('style' => 'bright'), '%_' => array('style' => 'bright') ); } /** * Get the cached string values. * * @return array The cached string values. */ static public function getStringCache() { return self::$_string_cache; } /** * Clear the string cache. */ static public function clearStringCache() { self::$_string_cache = array(); } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli\progress; use cli; use cli\Notify; use cli\Progress; use cli\Shell; use cli\Streams; /** * Displays a progress bar spanning the entire shell. * * Basic format: * * ^MSG PER% [======================= ] 00:00 / 00:00$ */ class Bar extends Progress { protected $_bars = '=>'; protected $_formatMessage = '{:msg} {:percent}% ['; protected $_formatTiming = '] {:elapsed} / {:estimated}'; protected $_format = '{:msg}{:bar}{:timing}'; /** * Prints the progress bar to the screen with percent complete, elapsed time * and estimated total time. * * @param boolean $finish `true` if this was called from * `cli\Notify::finish()`, `false` otherwise. * @see cli\out() * @see cli\Notify::formatTime() * @see cli\Notify::elapsed() * @see cli\Progress::estimated(); * @see cli\Progress::percent() * @see cli\Shell::columns() */ public function display($finish = false) { $_percent = $this->percent(); $percent = str_pad(floor($_percent * 100), 3); $msg = $this->_message; $msg = Streams::render($this->_formatMessage, compact('msg', 'percent')); $estimated = $this->formatTime($this->estimated()); $elapsed = str_pad($this->formatTime($this->elapsed()), strlen($estimated)); $timing = Streams::render($this->_formatTiming, compact('elapsed', 'estimated')); $size = Shell::columns(); $size -= strlen($msg . $timing); if ( $size < 0 ) { $size = 0; } $bar = str_repeat($this->_bars[0], floor($_percent * $size)) . $this->_bars[1]; // substr is needed to trim off the bar cap at 100% $bar = substr(str_pad($bar, $size, ' '), 0, $size); Streams::out($this->_format, compact('msg', 'bar', 'timing')); } /** * This method augments the base definition from cli\Notify to optionally * allow passing a new message. * * @param int $increment The amount to increment by. * @param string $msg The text to display next to the Notifier. (optional) * @see cli\Notify::tick() */ public function tick($increment = 1, $msg = null) { if ($msg) { $this->_message = $msg; } Notify::tick($increment); } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli\table; /** * Table renderers are used to change how a table is displayed. */ abstract class Renderer { protected $_widths = array(); public function __construct(array $widths = array()) { $this->setWidths($widths); } /** * Set the widths of each column in the table. * * @param array $widths The widths of the columns. * @param bool $fallback Whether to use these values as fallback only. */ public function setWidths(array $widths, $fallback = false) { if ($fallback) { foreach ( $this->_widths as $index => $value ) { $widths[$index] = $value; } } $this->_widths = $widths; } /** * Render a border for the top and bottom and separating the headers from the * table rows. * * @return string The table border. */ public function border() { return null; } /** * Renders a row for output. * * @param array $row The table row. * @return string The formatted table row. */ abstract public function row(array $row); } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli\table; /** * The tabular renderer is used for displaying data in a tabular format. */ class Tabular extends Renderer { /** * Renders a row for output. * * @param array $row The table row. * @return string The formatted table row. */ public function row( array $row ) { $rows = []; $output = ''; foreach ( $row as $col => $value ) { $value = isset( $value ) ? (string) $value : ''; $value = str_replace( "\t", ' ', $value ); $split_lines = preg_split( '/\r\n|\n/', $value ); // Keep anything before the first line break on the original line $row[ $col ] = array_shift( $split_lines ); } $rows[] = $row; foreach ( $split_lines as $i => $line ) { if ( ! isset( $rows[ $i + 1 ] ) ) { $rows[ $i + 1 ] = array_fill_keys( array_keys( $row ), '' ); } $rows[ $i + 1 ][ $col ] = $line; } foreach ( $rows as $r ) { $output .= implode( "\t", array_values( $r ) ) . PHP_EOL; } return rtrim( $output, PHP_EOL ); } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli\table; use cli\Colors; use cli\Shell; /** * The ASCII renderer renders tables with ASCII borders. */ class Ascii extends Renderer { protected $_characters = array( 'corner' => '+', 'line' => '-', 'border' => '|', 'padding' => ' ', ); protected $_border = null; protected $_constraintWidth = null; protected $_pre_colorized = false; /** * Set the widths of each column in the table. * * @param array $widths The widths of the columns. * @param bool $fallback Whether to use these values as fallback only. */ public function setWidths(array $widths, $fallback = false) { if ($fallback) { foreach ( $this->_widths as $index => $value ) { $widths[$index] = $value; } } $this->_widths = $widths; if ( is_null( $this->_constraintWidth ) ) { $this->_constraintWidth = (int) Shell::columns(); } $col_count = count( $widths ); $col_borders_count = $col_count ? ( ( $col_count - 1 ) * strlen( $this->_characters['border'] ) ) : 0; $table_borders_count = strlen( $this->_characters['border'] ) * 2; $col_padding_count = $col_count * strlen( $this->_characters['padding'] ) * 2; $max_width = $this->_constraintWidth - $col_borders_count - $table_borders_count - $col_padding_count; if ( $widths && $max_width && array_sum( $widths ) > $max_width ) { $avg = floor( $max_width / count( $widths ) ); $resize_widths = array(); $extra_width = 0; foreach( $widths as $width ) { if ( $width > $avg ) { $resize_widths[] = $width; } else { $extra_width = $extra_width + ( $avg - $width ); } } if ( ! empty( $resize_widths ) && $extra_width ) { $avg_extra_width = floor( $extra_width / count( $resize_widths ) ); foreach( $widths as &$width ) { if ( in_array( $width, $resize_widths ) ) { $width = $avg + $avg_extra_width; array_shift( $resize_widths ); // Last item gets the cake if ( empty( $resize_widths ) ) { $width = 0; // Zero it so not in sum. $width = $max_width - array_sum( $widths ); } } } } } $this->_widths = $widths; } /** * Set the constraint width for the table * * @param int $constraintWidth */ public function setConstraintWidth( $constraintWidth ) { $this->_constraintWidth = $constraintWidth; } /** * Set the characters used for rendering the Ascii table. * * The keys `corner`, `line` and `border` are used in rendering. * * @param $characters array Characters used in rendering. */ public function setCharacters(array $characters) { $this->_characters = array_merge($this->_characters, $characters); } /** * Render a border for the top and bottom and separating the headers from the * table rows. * * @return string The table border. */ public function border() { if (!isset($this->_border)) { $this->_border = $this->_characters['corner']; foreach ($this->_widths as $width) { $this->_border .= str_repeat($this->_characters['line'], $width + 2); $this->_border .= $this->_characters['corner']; } } return $this->_border; } /** * Renders a row for output. * * @param array $row The table row. * @return string The formatted table row. */ public function row( array $row ) { $extra_row_count = 0; if ( count( $row ) > 0 ) { $extra_rows = array_fill( 0, count( $row ), array() ); foreach ( $row as $col => $value ) { $value = $value ?: ''; $col_width = $this->_widths[ $col ]; $encoding = function_exists( 'mb_detect_encoding' ) ? mb_detect_encoding( $value, null, true /*strict*/ ) : false; $original_val_width = Colors::width( $value, self::isPreColorized( $col ), $encoding ); if ( $col_width && ( $original_val_width > $col_width || strpos( $value, "\n" ) !== false ) ) { $split_lines = preg_split( '/\r\n|\n/', $value ); $wrapped_lines = []; foreach ( $split_lines as $line ) { do { $wrapped_value = \cli\safe_substr( $line, 0, $col_width, true /*is_width*/, $encoding ); $val_width = Colors::width( $wrapped_value, self::isPreColorized( $col ), $encoding ); if ( $val_width ) { $wrapped_lines[] = $wrapped_value; $line = \cli\safe_substr( $line, \cli\safe_strlen( $wrapped_value, $encoding ), null /*length*/, false /*is_width*/, $encoding ); } } while ( $line ); } $row[ $col ] = array_shift( $wrapped_lines ); foreach ( $wrapped_lines as $wrapped_line ) { $extra_rows[ $col ][] = $wrapped_line; ++$extra_row_count; } } } } $row = array_map(array($this, 'padColumn'), $row, array_keys($row)); array_unshift($row, ''); // First border array_push($row, ''); // Last border $ret = join($this->_characters['border'], $row); if ( $extra_row_count ) { foreach( $extra_rows as $col => $col_values ) { while( count( $col_values ) < $extra_row_count ) { $col_values[] = ''; } } do { $row_values = array(); $has_more = false; foreach( $extra_rows as $col => &$col_values ) { $row_values[ $col ] = ! empty( $col_values ) ? array_shift( $col_values ) : ''; if ( count( $col_values ) ) { $has_more = true; } } $row_values = array_map(array($this, 'padColumn'), $row_values, array_keys($row_values)); array_unshift($row_values, ''); // First border array_push($row_values, ''); // Last border $ret .= PHP_EOL . join($this->_characters['border'], $row_values); } while( $has_more ); } return $ret; } private function padColumn($content, $column) { $content = str_replace( "\t", ' ', (string) $content ); return $this->_characters['padding'] . Colors::pad( $content, $this->_widths[ $column ], $this->isPreColorized( $column ) ) . $this->_characters['padding']; } /** * Set whether items are pre-colorized. * * @param bool|array $colorized A boolean to set all columns in the table as pre-colorized, or an array of booleans keyed by column index (number) to set individual columns as pre-colorized. */ public function setPreColorized( $pre_colorized ) { $this->_pre_colorized = $pre_colorized; } /** * Is a column pre-colorized? * * @param int $column Column index to check. * @return bool True if whole table is marked as pre-colorized, or if the individual column is pre-colorized; else false. */ public function isPreColorized( $column ) { if ( is_bool( $this->_pre_colorized ) ) { return $this->_pre_colorized; } if ( is_array( $this->_pre_colorized ) && isset( $this->_pre_colorized[ $column ] ) ) { return $this->_pre_colorized[ $column ]; } return false; } } <?php // Generated by "gen_east_asian_width.php" from "http://www.unicode.org/Public/10.0.0/ucd/EastAsianWidth.txt". $eaw_regex = '/\xe1(?:\x84[\x80-\xbf]|\x85[\x80-\x9f])|\xe2(?:\x8c[\x9a\x9b\xa9\xaa]|\x8f[\xa9-\xac\xb0\xb3]|\x97[\xbd\xbe]|\x98[\x94\x95]|\x99[\x88-\x93\xbf]|\x9a[\x93\xa1\xaa\xab\xbd\xbe]|\x9b[\x84\x85\x8e\x94\xaa\xb2\xb3\xb5\xba\xbd]|\x9c[\x85\x8a\x8b\xa8]|\x9d[\x8c\x8e\x93-\x95\x97]|\x9e[\x95-\x97\xb0\xbf]|\xac[\x9b\x9c]|\xad[\x90\x95]|\xba[\x80-\x99\x9b-\xbf]|\xbb[\x80-\xb3]|[\xbc-\xbe][\x80-\xbf]|\xbf[\x80-\x95\xb0-\xbb])|\xe3(?:\x80[\x80-\xbe]|\x81[\x81-\xbf]|\x82[\x80-\x96\x99-\xbf]|\x83[\x80-\xbf]|\x84[\x85-\xae\xb1-\xbf]|\x85[\x80-\xbf]|\x86[\x80-\x8e\x90-\xba]|\x87[\x80-\xa3\xb0-\xbf]|\x88[\x80-\x9e\xa0-\xbf]|\x89[\x80-\x87\x90-\xbf]|\x8a[\x80-\xbf]|\x8b[\x80-\xbe]|[\x8c-\xbf][\x80-\xbf])|\xe4(?:[\x80-\xb6][\x80-\xbf]|[\xb8-\xbf][\x80-\xbf])|[\xe5-\xe9][\x80-\xbf][\x80-\xbf]|\xea(?:[\x80-\x91][\x80-\xbf]|\x92[\x80-\x8c\x90-\xbf]|\x93[\x80-\x86]|\xa5[\xa0-\xbc]|[\xb0-\xbf][\x80-\xbf])|[\xeb\xec][\x80-\xbf][\x80-\xbf]|\xed(?:[\x80-\x9d][\x80-\xbf]|\x9e[\x80-\xa3])|\xef(?:[\xa4-\xab][\x80-\xbf]|\xb8[\x90-\x99\xb0-\xbf]|\xb9[\x80-\x92\x94-\xa6\xa8-\xab]|\xbc[\x81-\xbf]|\xbd[\x80-\xa0]|\xbf[\xa0-\xa6])|\xf0(?:\x96\xbf[\xa0\xa1]|\x97[\x80-\xbf][\x80-\xbf]|\x98(?:[\x80-\x9e][\x80-\xbf]|\x9f[\x80-\xac]|[\xa0-\xaa][\x80-\xbf]|\xab[\x80-\xb2])|\x9b(?:[\x80-\x83][\x80-\xbf]|\x84[\x80-\x9e]|\x85[\xb0-\xbf]|[\x86-\x8a][\x80-\xbf]|\x8b[\x80-\xbb])|\x9f(?:\x80\x84|\x83\x8f|\x86[\x8e\x91-\x9a]|\x88[\x80-\x82\x90-\xbb]|\x89[\x80-\x88\x90\x91\xa0-\xa5]|\x8c[\x80-\xa0\xad-\xb5\xb7-\xbf]|\x8d[\x80-\xbc\xbe\xbf]|\x8e[\x80-\x93\xa0-\xbf]|\x8f[\x80-\x8a\x8f-\x93\xa0-\xb0\xb4\xb8-\xbf]|\x90[\x80-\xbe]|\x91[\x80\x82-\xbf]|\x92[\x80-\xbf]|\x93[\x80-\xbc\xbf]|\x94[\x80-\xbd]|\x95[\x8b-\x8e\x90-\xa7\xba]|\x96[\x95\x96\xa4]|\x97[\xbb-\xbf]|\x98[\x80-\xbf]|\x99[\x80-\x8f]|\x9a[\x80-\xbf]|\x9b[\x80-\x85\x8c\x90-\x92\xab\xac\xb4-\xb8]|\xa4[\x90-\xbe]|\xa5[\x80-\x8c\x90-\xab]|\xa6[\x80-\x97]|\xa7[\x80\x90-\xa6])|[\xa0-\xae][\x80-\xbf][\x80-\xbf]|\xaf(?:[\x80-\xbe][\x80-\xbf]|\xbf[\x80-\xbd])|[\xb0-\xbe][\x80-\xbf][\x80-\xbf]|\xbf(?:[\x80-\xbe][\x80-\xbf]|\xbf[\x80-\xbd]))/'; // 181738 code points. // Generated by "gen_cat_regex_alts.php" from "http://www.unicode.org/Public/10.0.0/ucd/UnicodeData.txt". $m_regex = '/\xcc[\x80-\xbf]|\xcd[\x80-\xaf]|\xd2[\x83-\x89]|\xd6[\x91-\xbd\xbf]|\xd7[\x81\x82\x84\x85\x87]|\xd8[\x90-\x9a]|\xd9[\x8b-\x9f\xb0]|\xdb[\x96-\x9c\x9f-\xa4\xa7\xa8\xaa-\xad]|\xdc[\x91\xb0-\xbf]|\xdd[\x80-\x8a]|\xde[\xa6-\xb0]|\xdf[\xab-\xb3]|\xe0(?:\xa0[\x96-\x99\x9b-\xa3\xa5-\xa7\xa9-\xad]|\xa1[\x99-\x9b]|\xa3[\x94-\xa1\xa3-\xbf]|\xa4[\x80-\x83\xba-\xbc\xbe\xbf]|\xa5[\x80-\x8f\x91-\x97\xa2\xa3]|\xa6[\x81-\x83\xbc\xbe\xbf]|\xa7[\x80-\x84\x87\x88\x8b-\x8d\x97\xa2\xa3]|\xa8[\x81-\x83\xbc\xbe\xbf]|\xa9[\x80-\x82\x87\x88\x8b-\x8d\x91\xb0\xb1\xb5]|\xaa[\x81-\x83\xbc\xbe\xbf]|\xab[\x80-\x85\x87-\x89\x8b-\x8d\xa2\xa3\xba-\xbf]|\xac[\x81-\x83\xbc\xbe\xbf]|\xad[\x80-\x84\x87\x88\x8b-\x8d\x96\x97\xa2\xa3]|\xae[\x82\xbe\xbf]|\xaf[\x80-\x82\x86-\x88\x8a-\x8d\x97]|\xb0[\x80-\x83\xbe\xbf]|\xb1[\x80-\x84\x86-\x88\x8a-\x8d\x95\x96\xa2\xa3]|\xb2[\x81-\x83\xbc\xbe\xbf]|\xb3[\x80-\x84\x86-\x88\x8a-\x8d\x95\x96\xa2\xa3]|\xb4[\x80-\x83\xbb\xbc\xbe\xbf]|\xb5[\x80-\x84\x86-\x88\x8a-\x8d\x97\xa2\xa3]|\xb6[\x82\x83]|\xb7[\x8a\x8f-\x94\x96\x98-\x9f\xb2\xb3]|\xb8[\xb1\xb4-\xba]|\xb9[\x87-\x8e]|\xba[\xb1\xb4-\xb9\xbb\xbc]|\xbb[\x88-\x8d]|\xbc[\x98\x99\xb5\xb7\xb9\xbe\xbf]|\xbd[\xb1-\xbf]|\xbe[\x80-\x84\x86\x87\x8d-\x97\x99-\xbc]|\xbf\x86)|\xe1(?:\x80[\xab-\xbe]|\x81[\x96-\x99\x9e-\xa0\xa2-\xa4\xa7-\xad\xb1-\xb4]|\x82[\x82-\x8d\x8f\x9a-\x9d]|\x8d[\x9d-\x9f]|\x9c[\x92-\x94\xb2-\xb4]|\x9d[\x92\x93\xb2\xb3]|\x9e[\xb4-\xbf]|\x9f[\x80-\x93\x9d]|\xa0[\x8b-\x8d]|\xa2[\x85\x86\xa9]|\xa4[\xa0-\xab\xb0-\xbb]|\xa8[\x97-\x9b]|\xa9[\x95-\x9e\xa0-\xbc\xbf]|\xaa[\xb0-\xbe]|\xac[\x80-\x84\xb4-\xbf]|\xad[\x80-\x84\xab-\xb3]|\xae[\x80-\x82\xa1-\xad]|\xaf[\xa6-\xb3]|\xb0[\xa4-\xb7]|\xb3[\x90-\x92\x94-\xa8\xad\xb2-\xb4\xb7-\xb9]|\xb7[\x80-\xb9\xbb-\xbf])|\xe2(?:\x83[\x90-\xb0]|\xb3[\xaf-\xb1]|\xb5\xbf|\xb7[\xa0-\xbf])|\xe3(?:\x80[\xaa-\xaf]|\x82[\x99\x9a])|\xea(?:\x99[\xaf-\xb2\xb4-\xbd]|\x9a[\x9e\x9f]|\x9b[\xb0\xb1]|\xa0[\x82\x86\x8b\xa3-\xa7]|\xa2[\x80\x81\xb4-\xbf]|\xa3[\x80-\x85\xa0-\xb1]|\xa4[\xa6-\xad]|\xa5[\x87-\x93]|\xa6[\x80-\x83\xb3-\xbf]|\xa7[\x80\xa5]|\xa8[\xa9-\xb6]|\xa9[\x83\x8c\x8d\xbb-\xbd]|\xaa[\xb0\xb2-\xb4\xb7\xb8\xbe\xbf]|\xab[\x81\xab-\xaf\xb5\xb6]|\xaf[\xa3-\xaa\xac\xad])|\xef(?:\xac\x9e|\xb8[\x80-\x8f\xa0-\xaf])|\xf0(?:\x90(?:\x87\xbd|\x8b\xa0|\x8d[\xb6-\xba]|\xa8[\x81-\x83\x85\x86\x8c-\x8f\xb8-\xba\xbf]|\xab[\xa5\xa6])|\x91(?:\x80[\x80-\x82\xb8-\xbf]|\x81[\x80-\x86\xbf]|\x82[\x80-\x82\xb0-\xba]|\x84[\x80-\x82\xa7-\xb4]|\x85\xb3|\x86[\x80-\x82\xb3-\xbf]|\x87[\x80\x8a-\x8c]|\x88[\xac-\xb7\xbe]|\x8b[\x9f-\xaa]|\x8c[\x80-\x83\xbc\xbe\xbf]|\x8d[\x80-\x84\x87\x88\x8b-\x8d\x97\xa2\xa3\xa6-\xac\xb0-\xb4]|\x90[\xb5-\xbf]|\x91[\x80-\x86]|\x92[\xb0-\xbf]|\x93[\x80-\x83]|\x96[\xaf-\xb5\xb8-\xbf]|\x97[\x80\x9c\x9d]|\x98[\xb0-\xbf]|\x99\x80|\x9a[\xab-\xb7]|\x9c[\x9d-\xab]|\xa8[\x81-\x8a\xb3-\xb9\xbb-\xbe]|\xa9[\x87\x91-\x9b]|\xaa[\x8a-\x99]|\xb0[\xaf-\xb6\xb8-\xbf]|\xb2[\x92-\xa7\xa9-\xb6]|\xb4[\xb1-\xb6\xba\xbc\xbd\xbf]|\xb5[\x80-\x85\x87])|\x96(?:\xab[\xb0-\xb4]|\xac[\xb0-\xb6]|\xbd[\x91-\xbe]|\xbe[\x8f-\x92])|\x9b\xb2[\x9d\x9e]|\x9d(?:\x85[\xa5-\xa9\xad-\xb2\xbb-\xbf]|\x86[\x80-\x82\x85-\x8b\xaa-\xad]|\x89[\x82-\x84]|\xa8[\x80-\xb6\xbb-\xbf]|\xa9[\x80-\xac\xb5]|\xaa[\x84\x9b-\x9f\xa1-\xaf])|\x9e(?:\x80[\x80-\x86\x88-\x98\x9b-\xa1\xa3\xa4\xa6-\xaa]|\xa3[\x90-\x96]|\xa5[\x84-\x8a]))|\xf3\xa0(?:[\x84-\x86][\x80-\xbf]|\x87[\x80-\xaf])/'; // 2177 code points. <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author Ryan Sullivan <rsullivan@connectstudios.com> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli\tree; /** * Tree renderers are used to change how a tree is displayed. */ abstract class Renderer { /** * @param array $tree * @return string|null */ abstract public function render(array $tree); } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author Ryan Sullivan <rsullivan@connectstudios.com> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli\tree; /** * The ASCII renderer renders trees with ASCII lines. */ class Markdown extends Renderer { /** * How many spaces to indent by * @var int */ protected $_padding = 2; /** * @param int $padding Optional. Default 2. */ function __construct($padding = null) { if ($padding) { $this->_padding = $padding; } } /** * Renders the tree * * @param array $tree * @param int $level Optional * @return string */ public function render(array $tree, $level = 0) { $output = ''; foreach ($tree as $label => $next) { if (is_string($next)) { $label = $next; } // Output the label $output .= sprintf("%s- %s\n", str_repeat(' ', $level * $this->_padding), $label); // Next level if (is_array($next)) { $output .= $this->render($next, $level + 1); } } return $output; } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author Ryan Sullivan <rsullivan@connectstudios.com> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli\tree; /** * The ASCII renderer renders trees with ASCII lines. */ class Ascii extends Renderer { /** * @param array $tree * @return string */ public function render(array $tree) { $output = ''; $treeIterator = new \RecursiveTreeIterator( new \RecursiveArrayIterator($tree), \RecursiveTreeIterator::SELF_FIRST ); foreach ($treeIterator as $val) { $output .= $val . "\n"; } return $output; } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli; /** * The `Shell` class is a utility class for shell related tasks such as * information on width. */ class Shell { /** * Returns the number of columns the current shell has for display. * * @return int The number of columns. * @todo Test on more systems. */ static public function columns() { static $columns; if ( getenv( 'PHP_CLI_TOOLS_TEST_SHELL_COLUMNS_RESET' ) ) { $columns = null; } if ( null === $columns ) { if ( function_exists( 'exec' ) ) { if ( self::is_windows() ) { // Cater for shells such as Cygwin and Git bash where `mode CON` returns an incorrect value for columns. if ( ( $shell = getenv( 'SHELL' ) ) && preg_match( '/(?:bash|zsh)(?:\.exe)?$/', $shell ) && getenv( 'TERM' ) ) { $columns = (int) exec( 'tput cols' ); } if ( ! $columns ) { $return_var = -1; $output = array(); exec( 'mode CON', $output, $return_var ); if ( 0 === $return_var && $output ) { // Look for second line ending in ": <number>" (searching for "Columns:" will fail on non-English locales). if ( preg_match( '/:\s*[0-9]+\n[^:]+:\s*([0-9]+)\n/', implode( "\n", $output ), $matches ) ) { $columns = (int) $matches[1]; } } } } else { if ( ! ( $columns = (int) getenv( 'COLUMNS' ) ) ) { $size = exec( '/usr/bin/env stty size 2>/dev/null' ); if ( '' !== $size && preg_match( '/[0-9]+ ([0-9]+)/', $size, $matches ) ) { $columns = (int) $matches[1]; } if ( ! $columns ) { if ( getenv( 'TERM' ) ) { $columns = (int) exec( '/usr/bin/env tput cols 2>/dev/null' ); } } } } } if ( ! $columns ) { $columns = 80; // default width of cmd window on Windows OS } } return $columns; } /** * Checks whether the output of the current script is a TTY or a pipe / redirect * * Returns true if STDOUT output is being redirected to a pipe or a file; false is * output is being sent directly to the terminal. * * If an env variable SHELL_PIPE exists, returned result depends it's * value. Strings like 1, 0, yes, no, that validate to booleans are accepted. * * To enable ASCII formatting even when shell is piped, use the * ENV variable SHELL_PIPE=0 * * @return bool */ static public function isPiped() { $shellPipe = getenv('SHELL_PIPE'); if ($shellPipe !== false) { return filter_var($shellPipe, FILTER_VALIDATE_BOOLEAN); } else { if ( function_exists('stream_isatty') ) { return !stream_isatty(STDOUT); } else { return (function_exists('posix_isatty') && !posix_isatty(STDOUT)); } } } /** * Uses `stty` to hide input/output completely. * @param boolean $hidden Will hide/show the next data. Defaults to true. */ static public function hide($hidden = true) { system( 'stty ' . ( $hidden? '-echo' : 'echo' ) ); } /** * Is this shell in Windows? * * @return bool */ static private function is_windows() { return strtoupper(substr(PHP_OS, 0, 3)) === 'WIN'; } } ?> <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli; /** * Handles rendering strings. If extra scalar arguments are given after the `$msg` * the string will be rendered with `sprintf`. If the second argument is an `array` * then each key in the array will be the placeholder name. Placeholders are of the * format {:key}. * * @param string $msg The message to render. * @param mixed ... Either scalar arguments or a single array argument. * @return string The rendered string. */ function render( $msg ) { return Streams::_call( 'render', func_get_args() ); } /** * Shortcut for printing to `STDOUT`. The message and parameters are passed * through `sprintf` before output. * * @param string $msg The message to output in `printf` format. * @param mixed ... Either scalar arguments or a single array argument. * @return void * @see \cli\render() */ function out( $msg ) { Streams::_call( 'out', func_get_args() ); } /** * Pads `$msg` to the width of the shell before passing to `cli\out`. * * @param string $msg The message to pad and pass on. * @param mixed ... Either scalar arguments or a single array argument. * @return void * @see cli\out() */ function out_padded( $msg ) { Streams::_call( 'out_padded', func_get_args() ); } /** * Prints a message to `STDOUT` with a newline appended. See `\cli\out` for * more documentation. * * @see cli\out() */ function line( $msg = '' ) { Streams::_call( 'line', func_get_args() ); } /** * Shortcut for printing to `STDERR`. The message and parameters are passed * through `sprintf` before output. * * @param string $msg The message to output in `printf` format. With no string, * a newline is printed. * @param mixed ... Either scalar arguments or a single array argument. * @return void */ function err( $msg = '' ) { Streams::_call( 'err', func_get_args() ); } /** * Takes input from `STDIN` in the given format. If an end of transmission * character is sent (^D), an exception is thrown. * * @param string $format A valid input format. See `fscanf` for documentation. * If none is given, all input up to the first newline * is accepted. * @return string The input with whitespace trimmed. * @throws \Exception Thrown if ctrl-D (EOT) is sent as input. */ function input( $format = null ) { return Streams::input( $format ); } /** * Displays an input prompt. If no default value is provided the prompt will * continue displaying until input is received. * * @param string $question The question to ask the user. * @param string|false $default A default value if the user provides no input. Default false. * @param string $marker A string to append to the question and default value on display. * @param boolean $hide If the user input should be hidden * @return string The users input. * @see cli\input() */ function prompt( $question, $default = false, $marker = ': ', $hide = false ) { return Streams::prompt( $question, $default, $marker, $hide ); } /** * Presents a user with a multiple choice question, useful for 'yes/no' type * questions (which this function defaults too). * * @param string $question The question to ask the user. * @param string $choice * @param string|null $default The default choice. NULL if a default is not allowed. * @internal param string $valid A string of characters allowed as a response. Case * is ignored. * @return string The users choice. * @see cli\prompt() */ function choose( $question, $choice = 'yn', $default = 'n' ) { return Streams::choose( $question, $choice, $default ); } /** * Does the same as {@see choose()}, but always asks yes/no and returns a boolean * * @param string $question The question to ask the user. * @param bool|null $default The default choice, in a boolean format. * @return bool */ function confirm( $question, $default = false ) { if ( is_bool( $default ) ) { $default = $default? 'y' : 'n'; } $result = choose( $question, 'yn', $default ); return $result == 'y'; } /** * Displays an array of strings as a menu where a user can enter a number to * choose an option. The array must be a single dimension with either strings * or objects with a `__toString()` method. * * @param array $items The list of items the user can choose from. * @param string $default The index of the default item. * @param string $title The message displayed to the user when prompted. * @return string The index of the chosen item. * @see cli\line() * @see cli\input() * @see cli\err() */ function menu( $items, $default = null, $title = 'Choose an item' ) { return Streams::menu( $items, $default, $title ); } /** * Attempts an encoding-safe way of getting string length. If intl extension or PCRE with '\X' or mb_string extension aren't * available, falls back to basic strlen. * * @param string $str The string to check. * @param string|bool $encoding Optional. The encoding of the string. Default false. * @return int Numeric value that represents the string's length */ function safe_strlen( $str, $encoding = false ) { // Allow for selective testings - "1" bit set tests grapheme_strlen(), "2" preg_match_all( '/\X/u' ), "4" mb_strlen(), "other" strlen(). $test_safe_strlen = getenv( 'PHP_CLI_TOOLS_TEST_SAFE_STRLEN' ); // Assume UTF-8 if no encoding given - `grapheme_strlen()` will return null if given non-UTF-8 string. if ( ( ! $encoding || 'UTF-8' === $encoding ) && can_use_icu() && null !== ( $length = grapheme_strlen( $str ) ) ) { if ( ! $test_safe_strlen || ( $test_safe_strlen & 1 ) ) { return $length; } } // Assume UTF-8 if no encoding given - `preg_match_all()` will return false if given non-UTF-8 string. if ( ( ! $encoding || 'UTF-8' === $encoding ) && can_use_pcre_x() && false !== ( $length = preg_match_all( '/\X/u', $str, $dummy /*needed for PHP 5.3*/ ) ) ) { if ( ! $test_safe_strlen || ( $test_safe_strlen & 2 ) ) { return $length; } } // Legacy encodings and old PHPs will reach here. if ( function_exists( 'mb_strlen' ) && ( $encoding || function_exists( 'mb_detect_encoding' ) ) ) { if ( ! $encoding ) { $encoding = mb_detect_encoding( $str, null, true /*strict*/ ); } $length = $encoding ? mb_strlen( $str, $encoding ) : mb_strlen( $str ); // mbstring funcs can fail if given `$encoding` arg that evals to false. if ( 'UTF-8' === $encoding ) { // Subtract combining characters. $length -= preg_match_all( get_unicode_regexs( 'm' ), $str, $dummy /*needed for PHP 5.3*/ ); } if ( ! $test_safe_strlen || ( $test_safe_strlen & 4 ) ) { return $length; } } return strlen( $str ); } /** * Attempts an encoding-safe way of getting a substring. If intl extension or PCRE with '\X' or mb_string extension aren't * available, falls back to substr(). * * @param string $str The input string. * @param int $start The starting position of the substring. * @param int|bool|null $length Optional, unless $is_width is set. Maximum length of the substring. Default false. Negative not supported. * @param int|bool $is_width Optional. If set and encoding is UTF-8, $length (which must be specified) is interpreted as spacing width. Default false. * @param string|bool $encoding Optional. The encoding of the string. Default false. * @return bool|string False if given unsupported args, otherwise substring of string specified by start and length parameters */ function safe_substr( $str, $start, $length = false, $is_width = false, $encoding = false ) { // Negative $length or $is_width and $length not specified not supported. if ( $length < 0 || ( $is_width && ( null === $length || false === $length ) ) ) { return false; } // Need this for normalization below and other uses. $safe_strlen = safe_strlen( $str, $encoding ); // Normalize `$length` when not specified - PHP 5.3 substr takes false as full length, PHP > 5.3 takes null. if ( null === $length || false === $length ) { $length = $safe_strlen; } // Normalize `$start` - various methods treat this differently. if ( $start > $safe_strlen ) { return ''; } if ( $start < 0 && -$start > $safe_strlen ) { $start = 0; } // Allow for selective testings - "1" bit set tests grapheme_substr(), "2" preg_split( '/\X/' ), "4" mb_substr(), "8" substr(). $test_safe_substr = getenv( 'PHP_CLI_TOOLS_TEST_SAFE_SUBSTR' ); // Assume UTF-8 if no encoding given - `grapheme_substr()` will return false (not null like `grapheme_strlen()`) if given non-UTF-8 string. if ( ( ! $encoding || 'UTF-8' === $encoding ) && can_use_icu() && false !== ( $try = grapheme_substr( $str, $start, $length ) ) ) { if ( ! $test_safe_substr || ( $test_safe_substr & 1 ) ) { return $is_width ? _safe_substr_eaw( $try, $length ) : $try; } } // Assume UTF-8 if no encoding given - `preg_split()` returns a one element array if given non-UTF-8 string (PHP bug) so need to check `preg_last_error()`. if ( ( ! $encoding || 'UTF-8' === $encoding ) && can_use_pcre_x() ) { if ( false !== ( $try = preg_split( '/(\X)/u', $str, $safe_strlen + 1, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY ) ) && ! preg_last_error() ) { $try = implode( '', array_slice( $try, $start, $length ) ); if ( ! $test_safe_substr || ( $test_safe_substr & 2 ) ) { return $is_width ? _safe_substr_eaw( $try, $length ) : $try; } } } // Legacy encodings and old PHPs will reach here. if ( function_exists( 'mb_substr' ) && ( $encoding || function_exists( 'mb_detect_encoding' ) ) ) { if ( ! $encoding ) { $encoding = mb_detect_encoding( $str, null, true /*strict*/ ); } // Bug: not adjusting for combining chars. $try = $encoding ? mb_substr( $str, $start, $length, $encoding ) : mb_substr( $str, $start, $length ); // mbstring funcs can fail if given `$encoding` arg that evals to false. if ( 'UTF-8' === $encoding && $is_width ) { $try = _safe_substr_eaw( $try, $length ); } if ( ! $test_safe_substr || ( $test_safe_substr & 4 ) ) { return $try; } } return substr( $str, $start, $length ); } /** * Internal function used by `safe_substr()` to adjust for East Asian double-width chars. * * @return string */ function _safe_substr_eaw( $str, $length ) { // Set the East Asian Width regex. $eaw_regex = get_unicode_regexs( 'eaw' ); // If there's any East Asian double-width chars... if ( preg_match( $eaw_regex, $str ) ) { // Note that if the length ends in the middle of a double-width char, the char is excluded, not included. // See if it's all EAW. if ( function_exists( 'mb_substr' ) && preg_match_all( $eaw_regex, $str, $dummy /*needed for PHP 5.3*/ ) === $length ) { // Just halve the length so (rounded down to a minimum of 1). $str = mb_substr( $str, 0, max( (int) ( $length / 2 ), 1 ), 'UTF-8' ); } else { // Explode string into an array of UTF-8 chars. Based on core `_mb_substr()` in "wp-includes/compat.php". $chars = preg_split( '/([\x00-\x7f\xc2-\xf4][^\x00-\x7f\xc2-\xf4]*)/', $str, $length + 1, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY ); $cnt = min( count( $chars ), $length ); $width = $length; for ( $length = 0; $length < $cnt && $width > 0; $length++ ) { $width -= preg_match( $eaw_regex, $chars[ $length ] ) ? 2 : 1; } // Round down to a minimum of 1. if ( $width < 0 && $length > 1 ) { $length--; } return join( '', array_slice( $chars, 0, $length ) ); } } return $str; } /** * An encoding-safe way of padding string length for display * * @param string $string The string to pad. * @param int $length The length to pad it to. * @param string|bool $encoding Optional. The encoding of the string. Default false. * @return string */ function safe_str_pad( $string, $length, $encoding = false ) { $real_length = strwidth( $string, $encoding ); $diff = strlen( $string ) - $real_length; $length += $diff; return str_pad( $string, $length ); } /** * Get width of string, ie length in characters, taking into account multi-byte and mark characters for UTF-8, and multi-byte for non-UTF-8. * * @param string $string The string to check. * @param string|bool $encoding Optional. The encoding of the string. Default false. * @return int The string's width. */ function strwidth( $string, $encoding = false ) { $string = (string) $string; // Set the East Asian Width and Mark regexs. list( $eaw_regex, $m_regex ) = get_unicode_regexs(); // Allow for selective testings - "1" bit set tests grapheme_strlen(), "2" preg_match_all( '/\X/u' ), "4" mb_strwidth(), "other" safe_strlen(). $test_strwidth = getenv( 'PHP_CLI_TOOLS_TEST_STRWIDTH' ); // Assume UTF-8 if no encoding given - `grapheme_strlen()` will return null if given non-UTF-8 string. if ( ( ! $encoding || 'UTF-8' === $encoding ) && can_use_icu() && null !== ( $width = grapheme_strlen( $string ) ) ) { if ( ! $test_strwidth || ( $test_strwidth & 1 ) ) { return $width + preg_match_all( $eaw_regex, $string, $dummy /*needed for PHP 5.3*/ ); } } // Assume UTF-8 if no encoding given - `preg_match_all()` will return false if given non-UTF-8 string. if ( ( ! $encoding || 'UTF-8' === $encoding ) && can_use_pcre_x() && false !== ( $width = preg_match_all( '/\X/u', $string, $dummy /*needed for PHP 5.3*/ ) ) ) { if ( ! $test_strwidth || ( $test_strwidth & 2 ) ) { return $width + preg_match_all( $eaw_regex, $string, $dummy /*needed for PHP 5.3*/ ); } } // Legacy encodings and old PHPs will reach here. if ( function_exists( 'mb_strwidth' ) && ( $encoding || function_exists( 'mb_detect_encoding' ) ) ) { if ( ! $encoding ) { $encoding = mb_detect_encoding( $string, null, true /*strict*/ ); } $width = $encoding ? mb_strwidth( $string, $encoding ) : mb_strwidth( $string ); // mbstring funcs can fail if given `$encoding` arg that evals to false. if ( 'UTF-8' === $encoding ) { // Subtract combining characters. $width -= preg_match_all( $m_regex, $string, $dummy /*needed for PHP 5.3*/ ); } if ( ! $test_strwidth || ( $test_strwidth & 4 ) ) { return $width; } } return safe_strlen( $string, $encoding ); } /** * Returns whether ICU is modern enough not to flake out. * * @return bool */ function can_use_icu() { static $can_use_icu = null; if ( null === $can_use_icu ) { // Choosing ICU 54, Unicode 7.0. $can_use_icu = defined( 'INTL_ICU_VERSION' ) && version_compare( INTL_ICU_VERSION, '54.1', '>=' ) && function_exists( 'grapheme_strlen' ) && function_exists( 'grapheme_substr' ); } return $can_use_icu; } /** * Returns whether PCRE Unicode extended grapheme cluster '\X' is available for use. * * @return bool */ function can_use_pcre_x() { static $can_use_pcre_x = null; if ( null === $can_use_pcre_x ) { // '\X' introduced (as Unicde extended grapheme cluster) in PCRE 8.32 - see https://vcs.pcre.org/pcre/code/tags/pcre-8.32/ChangeLog?view=markup line 53. // Older versions of PCRE were bundled with PHP <= 5.3.23 & <= 5.4.13. $pcre_version = substr( PCRE_VERSION, 0, strspn( PCRE_VERSION, '0123456789.' ) ); // Remove any trailing date stuff. $can_use_pcre_x = version_compare( $pcre_version, '8.32', '>=' ) && false !== @preg_match( '/\X/u', '' ); } return $can_use_pcre_x; } /** * Get the regexs generated from Unicode data. * * @param string $idx Optional. Return a specific regex only. Default null. * @return array|string Returns keyed array if not given $idx or $idx doesn't exist, otherwise the specific regex string. */ function get_unicode_regexs( $idx = null ) { static $eaw_regex; // East Asian Width regex. Characters that count as 2 characters as they're "wide" or "fullwidth". See http://www.unicode.org/reports/tr11/tr11-19.html static $m_regex; // Mark characters regex (Unicode property "M") - mark combining "Mc", mark enclosing "Me" and mark non-spacing "Mn" chars that should be ignored for spacing purposes. if ( null === $eaw_regex ) { // Load both regexs generated from Unicode data. require __DIR__ . '/unicode/regex.php'; } if ( null !== $idx ) { if ( 'eaw' === $idx ) { return $eaw_regex; } if ( 'm' === $idx ) { return $m_regex; } } return array( $eaw_regex, $m_regex, ); } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli; use cli\arguments\Argument; use cli\arguments\HelpScreen; use cli\arguments\InvalidArguments; use cli\arguments\Lexer; /** * Parses command line arguments. */ class Arguments implements \ArrayAccess { protected $_flags = array(); protected $_options = array(); protected $_strict = false; protected $_input = array(); protected $_invalid = array(); protected $_parsed; protected $_lexer; /** * Initializes the argument parser. If you wish to change the default behaviour * you may pass an array of options as the first argument. Valid options are * `'help'` and `'strict'`, each a boolean. * * `'help'` is `true` by default, `'strict'` is false by default. * * @param array $options An array of options for this parser. */ public function __construct($options = array()) { $options += array( 'strict' => false, 'input' => array_slice($_SERVER['argv'], 1) ); $this->_input = $options['input']; $this->setStrict($options['strict']); if (isset($options['flags'])) { $this->addFlags($options['flags']); } if (isset($options['options'])) { $this->addOptions($options['options']); } } /** * Get the list of arguments found by the defined definitions. * * @return array */ public function getArguments() { if (!isset($this->_parsed)) { $this->parse(); } return $this->_parsed; } public function getHelpScreen() { return new HelpScreen($this); } /** * Encodes the parsed arguments as JSON. * * @return string */ public function asJSON() { return json_encode($this->_parsed); } /** * Returns true if a given argument was parsed. * * @param mixed $offset An Argument object or the name of the argument. * @return bool */ #[\ReturnTypeWillChange] public function offsetExists($offset) { if ($offset instanceOf Argument) { $offset = $offset->key; } return array_key_exists($offset, $this->_parsed); } /** * Get the parsed argument's value. * * @param mixed $offset An Argument object or the name of the argument. * @return mixed */ #[\ReturnTypeWillChange] public function offsetGet($offset) { if ($offset instanceOf Argument) { $offset = $offset->key; } if (isset($this->_parsed[$offset])) { return $this->_parsed[$offset]; } } /** * Sets the value of a parsed argument. * * @param mixed $offset An Argument object or the name of the argument. * @param mixed $value The value to set */ #[\ReturnTypeWillChange] public function offsetSet($offset, $value) { if ($offset instanceOf Argument) { $offset = $offset->key; } $this->_parsed[$offset] = $value; } /** * Unset a parsed argument. * * @param mixed $offset An Argument object or the name of the argument. */ #[\ReturnTypeWillChange] public function offsetUnset($offset) { if ($offset instanceOf Argument) { $offset = $offset->key; } unset($this->_parsed[$offset]); } /** * Adds a flag (boolean argument) to the argument list. * * @param mixed $flag A string representing the flag, or an array of strings. * @param array $settings An array of settings for this flag. * @setting string description A description to be shown in --help. * @setting bool default The default value for this flag. * @setting bool stackable Whether the flag is repeatable to increase the value. * @setting array aliases Other ways to trigger this flag. * @return $this */ public function addFlag($flag, $settings = array()) { if (is_string($settings)) { $settings = array('description' => $settings); } if (is_array($flag)) { $settings['aliases'] = $flag; $flag = array_shift($settings['aliases']); } if (isset($this->_flags[$flag])) { $this->_warn('flag already exists: ' . $flag); return $this; } $settings += array( 'default' => false, 'stackable' => false, 'description' => null, 'aliases' => array() ); $this->_flags[$flag] = $settings; return $this; } /** * Add multiple flags at once. The input array should be keyed with the * primary flag character, and the values should be the settings array * used by {addFlag}. * * @param array $flags An array of flags to add * @return $this */ public function addFlags($flags) { foreach ($flags as $flag => $settings) { if (is_numeric($flag)) { $this->_warn('No flag character given'); continue; } $this->addFlag($flag, $settings); } return $this; } /** * Adds an option (string argument) to the argument list. * * @param mixed $option A string representing the option, or an array of strings. * @param array $settings An array of settings for this option. * @setting string description A description to be shown in --help. * @setting bool default The default value for this option. * @setting array aliases Other ways to trigger this option. * @return $this */ public function addOption($option, $settings = array()) { if (is_string($settings)) { $settings = array('description' => $settings); } if (is_array($option)) { $settings['aliases'] = $option; $option = array_shift($settings['aliases']); } if (isset($this->_options[$option])) { $this->_warn('option already exists: ' . $option); return $this; } $settings += array( 'default' => null, 'description' => null, 'aliases' => array() ); $this->_options[$option] = $settings; return $this; } /** * Add multiple options at once. The input array should be keyed with the * primary option string, and the values should be the settings array * used by {addOption}. * * @param array $options An array of options to add * @return $this */ public function addOptions($options) { foreach ($options as $option => $settings) { if (is_numeric($option)) { $this->_warn('No option string given'); continue; } $this->addOption($option, $settings); } return $this; } /** * Enable or disable strict mode. If strict mode is active any invalid * arguments found by the parser will throw `cli\arguments\InvalidArguments`. * * Even if strict is disabled, invalid arguments are logged and can be * retrieved with `cli\Arguments::getInvalidArguments()`. * * @param bool $strict True to enable, false to disable. * @return $this */ public function setStrict($strict) { $this->_strict = (bool)$strict; return $this; } /** * Get the list of invalid arguments the parser found. * * @return array */ public function getInvalidArguments() { return $this->_invalid; } /** * Get a flag by primary matcher or any defined aliases. * * @param mixed $flag Either a string representing the flag or an * cli\arguments\Argument object. * @return array */ public function getFlag($flag) { if ($flag instanceOf Argument) { $obj = $flag; $flag = $flag->value; } if (isset($this->_flags[$flag])) { return $this->_flags[$flag]; } foreach ($this->_flags as $master => $settings) { if (in_array($flag, (array)$settings['aliases'])) { if (isset($obj)) { $obj->key = $master; } $cache[$flag] =& $settings; return $settings; } } } public function getFlags() { return $this->_flags; } public function hasFlags() { return !empty($this->_flags); } /** * Returns true if the given argument is defined as a flag. * * @param mixed $argument Either a string representing the flag or an * cli\arguments\Argument object. * @return bool */ public function isFlag($argument) { return (null !== $this->getFlag($argument)); } /** * Returns true if the given flag is stackable. * * @param mixed $flag Either a string representing the flag or an * cli\arguments\Argument object. * @return bool */ public function isStackable($flag) { $settings = $this->getFlag($flag); return isset($settings) && (true === $settings['stackable']); } /** * Get an option by primary matcher or any defined aliases. * * @param mixed $option Either a string representing the option or an * cli\arguments\Argument object. * @return array */ public function getOption($option) { if ($option instanceOf Argument) { $obj = $option; $option = $option->value; } if (isset($this->_options[$option])) { return $this->_options[$option]; } foreach ($this->_options as $master => $settings) { if (in_array($option, (array)$settings['aliases'])) { if (isset($obj)) { $obj->key = $master; } return $settings; } } } public function getOptions() { return $this->_options; } public function hasOptions() { return !empty($this->_options); } /** * Returns true if the given argument is defined as an option. * * @param mixed $argument Either a string representing the option or an * cli\arguments\Argument object. * @return bool */ public function isOption($argument) { return (null != $this->getOption($argument)); } /** * Parses the argument list with the given options. The returned argument list * will use either the first long name given or the first name in the list * if a long name is not given. * * @return array * @throws arguments\InvalidArguments */ public function parse() { $this->_invalid = array(); $this->_parsed = array(); $this->_lexer = new Lexer($this->_input); $this->_applyDefaults(); foreach ($this->_lexer as $argument) { if ($this->_parseFlag($argument)) { continue; } if ($this->_parseOption($argument)) { continue; } array_push($this->_invalid, $argument->raw); } if ($this->_strict && !empty($this->_invalid)) { throw new InvalidArguments($this->_invalid); } } /** * This applies the default values, if any, of all of the * flags and options, so that if there is a default value * it will be available. */ private function _applyDefaults() { foreach($this->_flags as $flag => $settings) { $this[$flag] = $settings['default']; } foreach($this->_options as $option => $settings) { // If the default is 0 we should still let it be set. if (!empty($settings['default']) || $settings['default'] === 0) { $this[$option] = $settings['default']; } } } private function _warn($message) { trigger_error('[' . __CLASS__ .'] ' . $message, E_USER_WARNING); } private function _parseFlag($argument) { if (!$this->isFlag($argument)) { return false; } if ($this->isStackable($argument)) { if (!isset($this[$argument])) { $this[$argument->key] = 0; } $this[$argument->key] += 1; } else { $this[$argument->key] = true; } return true; } private function _parseOption($option) { if (!$this->isOption($option)) { return false; } // Peak ahead to make sure we get a value. if ($this->_lexer->end() || !$this->_lexer->peek->isValue) { $optionSettings = $this->getOption($option->key); if (empty($optionSettings['default']) && $optionSettings !== 0) { // Oops! Got no value and no default , throw a warning and continue. $this->_warn('no value given for ' . $option->raw); $this[$option->key] = null; } else { // No value and we have a default, so we set to the default $this[$option->key] = $optionSettings['default']; } return true; } // Store as array and join to string after looping for values $values = array(); // Loop until we find a flag in peak-ahead foreach ($this->_lexer as $value) { array_push($values, $value->raw); if (!$this->_lexer->end() && !$this->_lexer->peek->isValue) { break; } } $this[$option->key] = join(' ', $values); return true; } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli\notify; use cli\Notify; use cli\Streams; /** * The `Spinner` Notifier displays an ASCII spinner. */ class Spinner extends Notify { protected $_chars = '-\|/'; protected $_format = '{:msg} {:char} ({:elapsed}, {:speed}/s)'; protected $_iteration = 0; /** * Prints the current spinner position to `STDOUT` with the time elapsed * and tick speed. * * @param boolean $finish `true` if this was called from * `cli\Notify::finish()`, `false` otherwise. * @see cli\out_padded() * @see cli\Notify::formatTime() * @see cli\Notify::speed() */ public function display($finish = false) { $msg = $this->_message; $idx = $this->_iteration++ % strlen($this->_chars); $char = $this->_chars[$idx]; $speed = number_format(round($this->speed())); $elapsed = $this->formatTime($this->elapsed()); Streams::out_padded($this->_format, compact('msg', 'char', 'elapsed', 'speed')); } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli\notify; use cli\Notify; use cli\Streams; /** * A Notifer that displays a string of periods. */ class Dots extends Notify { protected $_dots; protected $_format = '{:msg}{:dots} ({:elapsed}, {:speed}/s)'; protected $_iteration; /** * Instatiates a Notification object. * * @param string $msg The text to display next to the Notifier. * @param int $dots The number of dots to iterate through. * @param int $interval The interval in milliseconds between updates. * @throws \InvalidArgumentException */ public function __construct($msg, $dots = 3, $interval = 100) { parent::__construct($msg, $interval); $this->_dots = (int)$dots; if ($this->_dots <= 0) { throw new \InvalidArgumentException('Dot count out of range, must be positive.'); } } /** * Prints the correct number of dots to `STDOUT` with the time elapsed and * tick speed. * * @param boolean $finish `true` if this was called from * `cli\Notify::finish()`, `false` otherwise. * @see cli\out_padded() * @see cli\Notify::formatTime() * @see cli\Notify::speed() */ public function display($finish = false) { $repeat = $this->_dots; if (!$finish) { $repeat = $this->_iteration++ % $repeat; } $msg = $this->_message; $dots = str_pad(str_repeat('.', $repeat), $this->_dots); $speed = number_format(round($this->speed())); $elapsed = $this->formatTime($this->elapsed()); Streams::out_padded($this->_format, compact('msg', 'dots', 'speed', 'elapsed')); } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli; use cli\Streams; /** * The `Notify` class is the basis of all feedback classes, such as Indicators * and Progress meters. The default behaviour is to refresh output after 100ms * have passed. This is done to preventing the screen from flickering and keep * slowdowns from output to a minimum. * * The most basic form of Notifier has no maxim, and simply displays a series * of characters to indicate progress is being made. */ abstract class Notify { protected $_current = 0; protected $_first = true; protected $_interval; protected $_message; protected $_start; protected $_timer; protected $_tick; protected $_iteration = 0; protected $_speed = 0; /** * Instatiates a Notification object. * * @param string $msg The text to display next to the Notifier. * @param int $interval The interval in milliseconds between updates. */ public function __construct($msg, $interval = 100) { $this->_message = $msg; $this->_interval = (int)$interval; } /** * This method should be used to print out the Notifier. This method is * called from `cli\Notify::tick()` after `cli\Notify::$_interval` has passed. * * @abstract * @param boolean $finish * @see cli\Notify::tick() */ abstract public function display($finish = false); /** * Reset the notifier state so the same instance can be used in multiple loops. */ public function reset() { $this->_current = 0; $this->_first = true; $this->_start = null; $this->_timer = null; } /** * Returns the formatted tick count. * * @return string The formatted tick count. */ public function current() { return number_format($this->_current); } /** * Calculates the time elapsed since the Notifier was first ticked. * * @return int The elapsed time in seconds. */ public function elapsed() { if (!$this->_start) { return 0; } $elapsed = time() - $this->_start; return $elapsed; } /** * Calculates the speed (number of ticks per second) at which the Notifier * is being updated. * * @return int The number of ticks performed in 1 second. */ public function speed() { if (!$this->_start) { return 0; } else if (!$this->_tick) { $this->_tick = $this->_start; } $now = microtime(true); $span = $now - $this->_tick; if ($span > 1) { $this->_iteration++; $this->_tick = $now; $this->_speed = ($this->_current / $this->_iteration) / $span; } return $this->_speed; } /** * Takes a time span given in seconds and formats it for display. The * returned string will be in MM:SS form. * * @param int $time The time span in seconds to format. * @return string The formatted time span. */ public function formatTime($time) { return floor($time / 60) . ':' . str_pad($time % 60, 2, 0, STR_PAD_LEFT); } /** * Finish our Notification display. Should be called after the Notifier is * no longer needed. * * @see cli\Notify::display() */ public function finish() { Streams::out("\r"); $this->display(true); Streams::line(); } /** * Increments are tick counter by the given amount. If no amount is provided, * the ticker is incremented by 1. * * @param int $increment The amount to increment by. */ public function increment($increment = 1) { $this->_current += $increment; } /** * Determines whether the display should be updated or not according to * our interval setting. * * @return boolean `true` if the display should be updated, `false` otherwise. */ public function shouldUpdate() { $now = microtime(true) * 1000; if (empty($this->_timer)) { $this->_start = (int)(($this->_timer = $now) / 1000); return true; } if (($now - $this->_timer) > $this->_interval) { $this->_timer = $now; return true; } return false; } /** * This method is the meat of all Notifiers. First we increment the ticker * and then update the display if enough time has passed since our last tick. * * @param int $increment The amount to increment by. * @see cli\Notify::increment() * @see cli\Notify::shouldUpdate() * @see cli\Notify::display() */ public function tick($increment = 1) { $this->increment($increment); if ($this->shouldUpdate()) { Streams::out("\r"); $this->display(); } } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli; abstract class Memoize { protected $_memoCache = array(); public function __get($name) { if (isset($this->_memoCache[$name])) { return $this->_memoCache[$name]; } // Hide probable private methods if (0 == strncmp($name, '_', 1)) { return ($this->_memoCache[$name] = null); } if (!method_exists($this, $name)) { return ($this->_memoCache[$name] = null); } $method = array($this, $name); ($this->_memoCache[$name] = call_user_func($method)); return $this->_memoCache[$name]; } protected function _unmemo($name) { if ($name === true) { $this->_memoCache = array(); } else { unset($this->_memoCache[$name]); } } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli; use cli\Shell; use cli\Streams; use cli\table\Ascii; use cli\table\Renderer; use cli\table\Tabular; /** * The `Table` class is used to display data in a tabular format. */ class Table { protected $_renderer; protected $_headers = array(); protected $_footers = array(); protected $_width = array(); protected $_rows = array(); /** * Initializes the `Table` class. * * There are 3 ways to instantiate this class: * * 1. Pass an array of strings as the first parameter for the column headers * and a 2-dimensional array as the second parameter for the data rows. * 2. Pass an array of hash tables (string indexes instead of numerical) * where each hash table is a row and the indexes of the *first* hash * table are used as the header values. * 3. Pass nothing and use `setHeaders()` and `addRow()` or `setRows()`. * * @param array $headers Headers used in this table. Optional. * @param array $rows The rows of data for this table. Optional. * @param array $footers Footers used in this table. Optional. */ public function __construct(array $headers = array(), array $rows = array(), array $footers = array()) { if (!empty($headers)) { // If all the rows is given in $headers we use the keys from the // first row for the header values if ($rows === array()) { $rows = $headers; $keys = array_keys(array_shift($headers)); $headers = array(); foreach ($keys as $header) { $headers[$header] = $header; } } $this->setHeaders($headers); $this->setRows($rows); } if (!empty($footers)) { $this->setFooters($footers); } if (Shell::isPiped()) { $this->setRenderer(new Tabular()); } else { $this->setRenderer(new Ascii()); } } public function resetTable() { $this->_headers = array(); $this->_width = array(); $this->_rows = array(); $this->_footers = array(); return $this; } /** * Sets the renderer used by this table. * * @param table\Renderer $renderer The renderer to use for output. * @see table\Renderer * @see table\Ascii * @see table\Tabular */ public function setRenderer(Renderer $renderer) { $this->_renderer = $renderer; } /** * Loops through the row and sets the maximum width for each column. * * @param array $row The table row. * @return array $row */ protected function checkRow(array $row) { foreach ($row as $column => $str) { $width = Colors::width( $str, $this->isAsciiPreColorized( $column ) ); if (!isset($this->_width[$column]) || $width > $this->_width[$column]) { $this->_width[$column] = $width; } } return $row; } /** * Output the table to `STDOUT` using `cli\line()`. * * If STDOUT is a pipe or redirected to a file, should output simple * tab-separated text. Otherwise, renders table with ASCII table borders * * @uses cli\Shell::isPiped() Determine what format to output * * @see cli\Table::renderRow() */ public function display() { foreach( $this->getDisplayLines() as $line ) { Streams::line( $line ); } } /** * Get the table lines to output. * * @see cli\Table::display() * @see cli\Table::renderRow() * * @return array */ public function getDisplayLines() { $this->_renderer->setWidths($this->_width, $fallback = true); $border = $this->_renderer->border(); $out = array(); if (isset($border)) { $out[] = $border; } $out[] = $this->_renderer->row($this->_headers); if (isset($border)) { $out[] = $border; } foreach ($this->_rows as $row) { $row = $this->_renderer->row($row); $row = explode( PHP_EOL, $row ); $out = array_merge( $out, $row ); } if (isset($border)) { $out[] = $border; } if ($this->_footers) { $out[] = $this->_renderer->row($this->_footers); if (isset($border)) { $out[] = $border; } } return $out; } /** * Sort the table by a column. Must be called before `cli\Table::display()`. * * @param int $column The index of the column to sort by. */ public function sort($column) { if (!isset($this->_headers[$column])) { trigger_error('No column with index ' . $column, E_USER_NOTICE); return; } usort($this->_rows, function($a, $b) use ($column) { return strcmp($a[$column], $b[$column]); }); } /** * Set the headers of the table. * * @param array $headers An array of strings containing column header names. */ public function setHeaders(array $headers) { $this->_headers = $this->checkRow($headers); } /** * Set the footers of the table. * * @param array $footers An array of strings containing column footers names. */ public function setFooters(array $footers) { $this->_footers = $this->checkRow($footers); } /** * Add a row to the table. * * @param array $row The row data. * @see cli\Table::checkRow() */ public function addRow(array $row) { $this->_rows[] = $this->checkRow($row); } /** * Clears all previous rows and adds the given rows. * * @param array $rows A 2-dimensional array of row data. * @see cli\Table::addRow() */ public function setRows(array $rows) { $this->_rows = array(); foreach ($rows as $row) { $this->addRow($row); } } public function countRows() { return count($this->_rows); } /** * Set whether items in an Ascii table are pre-colorized. * * @param bool|array $precolorized A boolean to set all columns in the table as pre-colorized, or an array of booleans keyed by column index (number) to set individual columns as pre-colorized. * @see cli\Ascii::setPreColorized() */ public function setAsciiPreColorized( $pre_colorized ) { if ( $this->_renderer instanceof Ascii ) { $this->_renderer->setPreColorized( $pre_colorized ); } } /** * Is a column in an Ascii table pre-colorized? * * @param int $column Column index to check. * @return bool True if whole Ascii table is marked as pre-colorized, or if the individual column is pre-colorized; else false. * @see cli\Ascii::isPreColorized() */ private function isAsciiPreColorized( $column ) { if ( $this->_renderer instanceof Ascii ) { return $this->_renderer->isPreColorized( $column ); } return false; } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli\arguments; use cli\Memoize; /** * Represents an Argument or a value and provides several helpers related to parsing an argument list. */ class Argument extends Memoize { /** * The canonical name of this argument, used for aliasing. * * @param string */ public $key; private $_argument; private $_raw; /** * @param string $argument The raw argument, leading dashes included. */ public function __construct($argument) { $this->_raw = $argument; $this->key =& $this->_argument; if ($this->isLong) { $this->_argument = substr($this->_raw, 2); } else if ($this->isShort) { $this->_argument = substr($this->_raw, 1); } else { $this->_argument = $this->_raw; } } /** * Returns the raw input as a string. * * @return string */ public function __toString() { return (string)$this->_raw; } /** * Returns the formatted argument string. * * @return string */ public function value() { return $this->_argument; } /** * Returns the raw input. * * @return mixed */ public function raw() { return $this->_raw; } /** * Returns true if the string matches the pattern for long arguments. * * @return bool */ public function isLong() { return (0 == strncmp((string)$this->_raw, '--', 2)); } /** * Returns true if the string matches the pattern for short arguments. * * @return bool */ public function isShort() { return !$this->isLong && (0 == strncmp((string)$this->_raw, '-', 1)); } /** * Returns true if the string matches the pattern for arguments. * * @return bool */ public function isArgument() { return $this->isShort() || $this->isLong(); } /** * Returns true if the string matches the pattern for values. * * @return bool */ public function isValue() { return !$this->isArgument; } /** * Returns true if the argument is short but contains several characters. Each * character is considered a separate argument. * * @return bool */ public function canExplode() { return $this->isShort && strlen($this->_argument) > 1; } /** * Returns all but the first character of the argument, removing them from the * objects representation at the same time. * * @return array */ public function exploded() { $exploded = array(); for ($i = strlen($this->_argument); $i > 0; $i--) { array_push($exploded, $this->_argument[$i - 1]); } $this->_argument = array_pop($exploded); $this->_raw = '-' . $this->_argument; return $exploded; } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli\arguments; use cli\Memoize; class Lexer extends Memoize implements \Iterator { private $_item; private $_items = array(); private $_index = 0; private $_length = 0; private $_first = true; /** * @param array $items A list of strings to process as tokens. */ public function __construct(array $items) { $this->_items = $items; $this->_length = count($items); } /** * The current token. * * @return string */ #[\ReturnTypeWillChange] public function current() { return $this->_item; } /** * Peek ahead to the next token without moving the cursor. * * @return Argument */ public function peek() { return new Argument($this->_items[0]); } /** * Move the cursor forward 1 element if it is valid. */ #[\ReturnTypeWillChange] public function next() { if ($this->valid()) { $this->_shift(); } } /** * Return the current position of the cursor. * * @return int */ #[\ReturnTypeWillChange] public function key() { return $this->_index; } /** * Move forward 1 element and, if the method hasn't been called before, reset * the cursor's position to 0. */ #[\ReturnTypeWillChange] public function rewind() { $this->_shift(); if ($this->_first) { $this->_index = 0; $this->_first = false; } } /** * Returns true if the cursor has not reached the end of the list. * * @return bool */ #[\ReturnTypeWillChange] public function valid() { return ($this->_index < $this->_length); } /** * Push an element to the front of the stack. * * @param mixed $item The value to set */ public function unshift($item) { array_unshift($this->_items, $item); $this->_length += 1; } /** * Returns true if the cursor is at the end of the list. * * @return bool */ public function end() { return ($this->_index + 1) == $this->_length; } private function _shift() { $this->_item = new Argument(array_shift($this->_items)); $this->_index += 1; $this->_explode(); $this->_unmemo('peek'); } private function _explode() { if (!$this->_item->canExplode) { return false; } foreach ($this->_item->exploded as $piece) { $this->unshift('-' . $piece); } } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli\arguments; /** * Thrown when undefined arguments are detected in strict mode. */ class InvalidArguments extends \InvalidArgumentException { protected $arguments; /** * @param array $arguments A list of arguments that do not fit the profile. */ public function __construct(array $arguments) { $this->arguments = $arguments; $this->message = $this->_generateMessage(); } /** * Get the arguments that caused the exception. * * @return array */ public function getArguments() { return $this->arguments; } private function _generateMessage() { return 'unknown argument' . (count($this->arguments) > 1 ? 's' : '') . ': ' . join(', ', $this->arguments); } } <?php /** * PHP Command Line Tools * * This source file is subject to the MIT license that is bundled * with this package in the file LICENSE. * * @author James Logsdon <dwarf@girsbrain.org> * @copyright 2010 James Logsdom (http://girsbrain.org) * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ namespace cli\arguments; use cli\Arguments; /** * Arguments help screen renderer */ class HelpScreen { protected $_flags = array(); protected $_flagMax = 0; protected $_options = array(); protected $_optionMax = 0; public function __construct(Arguments $arguments) { $this->setArguments($arguments); } public function __toString() { return $this->render(); } public function setArguments(Arguments $arguments) { $this->consumeArgumentFlags($arguments); $this->consumeArgumentOptions($arguments); } public function consumeArgumentFlags(Arguments $arguments) { $data = $this->_consume($arguments->getFlags()); $this->_flags = $data[0]; $this->_flagMax = $data[1]; } public function consumeArgumentOptions(Arguments $arguments) { $data = $this->_consume($arguments->getOptions()); $this->_options = $data[0]; $this->_optionMax = $data[1]; } public function render() { $help = array(); array_push($help, $this->_renderFlags()); array_push($help, $this->_renderOptions()); return join("\n\n", $help); } private function _renderFlags() { if (empty($this->_flags)) { return null; } return "Flags\n" . $this->_renderScreen($this->_flags, $this->_flagMax); } private function _renderOptions() { if (empty($this->_options)) { return null; } return "Options\n" . $this->_renderScreen($this->_options, $this->_optionMax); } private function _renderScreen($options, $max) { $help = array(); foreach ($options as $option => $settings) { $formatted = ' ' . str_pad($option, $max); $dlen = 80 - 4 - $max; $description = str_split($settings['description'], $dlen); $formatted.= ' ' . array_shift($description); if ($settings['default']) { $formatted .= ' [default: ' . $settings['default'] . ']'; } $pad = str_repeat(' ', $max + 3); while ($desc = array_shift($description)) { $formatted .= "\n{$pad}{$desc}"; } array_push($help, $formatted); } return join("\n", $help); } private function _consume($options) { $max = 0; $out = array(); foreach ($options as $option => $settings) { $names = array('--' . $option); foreach ($settings['aliases'] as $alias) { array_push($names, '-' . $alias); } $names = join(', ', $names); $max = max(strlen($names), $max); $out[$names] = $settings; } return array($out, $max); } } <?php /** * An example application using php-cli-tools and Buzz */ require_once __DIR__ . '/vendor/autoload.php'; define('BUZZ_PATH', realpath('../Buzz')); define('SCRIPT_NAME', array_shift($argv)); require_once BUZZ_PATH . '/lib/Buzz/ClassLoader.php'; Buzz\ClassLoader::register(); class HttpConsole { protected $_host; protected $_prompt; public function __construct($host) { $this->_host = 'http://' . $host; $this->_prompt = '%K' . $this->_host . '%n/%K>%n '; } public function handleRequest($type, $path) { $request = new Buzz\Message\Request($type, $path, $this->_host); $response = new Buzz\Message\Response; $client = new Buzz\Client\FileGetContents(); $client->send($request, $response); // Display headers foreach ($response->getHeaders() as $i => $header) { if ($i == 0) { \cli\line('%G{:header}%n', compact('header')); continue; } list($key, $value) = explode(': ', $header, 2); \cli\line('%W{:key}%n: {:value}', compact('key', 'value')); } \cli\line("\n"); print $response->getContent() . "\n"; switch ($type) { } } public function run() { while (true) { $cmd = \cli\prompt($this->_prompt, false, null); if (preg_match('/^(HEAD|GET|POST|PUT|DELETE) (\S+)$/', $cmd, $matches)) { $this->handleRequest($matches[1], $matches[2]); continue; } if ($cmd == '\q') { break; } } } } try { $console = new HttpConsole(array_shift($argv) ?: '127.0.0.1:80'); $console->run(); } catch (\Exception $e) { \cli\err("\n\n%R" . $e->getMessage() . "%n\n"); } ?> <?php error_reporting(-1); require_once __DIR__ . '/vendor/autoload.php'; $args = new cli\Arguments(array( 'flags' => array( 'verbose' => array( 'description' => 'Turn on verbose mode', 'aliases' => array('v') ), 'c' => array( 'description' => 'A counter to test stackable', 'stackable' => true ) ), 'options' => array( 'user' => array( 'description' => 'Username for authentication', 'aliases' => array('u') ) ), 'strict' => true )); try { $args->parse(); } catch (cli\InvalidArguments $e) { echo $e->getMessage() . "\n\n"; } print_r($args->getArguments()); <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_db_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_db_autoloader ) ) { require_once $wpcli_db_autoloader; } WP_CLI::add_command( 'db', 'DB_Command' ); <?php use WP_CLI\Formatter; use WP_CLI\Utils; /** * Performs basic database operations using credentials stored in wp-config.php. * * ## EXAMPLES * * # Create a new database. * $ wp db create * Success: Database created. * * # Drop an existing database. * $ wp db drop --yes * Success: Database dropped. * * # Reset the current database. * $ wp db reset --yes * Success: Database reset. * * # Execute a SQL query stored in a file. * $ wp db query < debug.sql * * @when after_wp_config_load */ class DB_Command extends WP_CLI_Command { /** * Legacy UTF-8 encoding for MySQL. * * @var string */ const ENCODING_UTF8 = 'utf8'; /** * Standards-compliant UTF-8 encoding for MySQL. * * @var string */ const ENCODING_UTF8MB4 = 'utf8mb4'; /** * A list of incompatible SQL modes. * * Copied over from WordPress Core code. * @see https://github.com/WordPress/wordpress-develop/blob/5.4.0/src/wp-includes/wp-db.php#L559-L572 * * @var string[] Array of SQL mode names that are incompatible with WordPress. */ protected $sql_incompatible_modes = [ 'NO_ZERO_DATE', 'ONLY_FULL_GROUP_BY', 'STRICT_TRANS_TABLES', 'STRICT_ALL_TABLES', 'TRADITIONAL', 'ANSI', ]; /** * Creates a new database. * * Runs `CREATE_DATABASE` SQL statement using `DB_HOST`, `DB_NAME`, * `DB_USER` and `DB_PASSWORD` database credentials specified in * wp-config.php. * * ## OPTIONS * * [--dbuser=<value>] * : Username to pass to mysql. Defaults to DB_USER. * * [--dbpass=<value>] * : Password to pass to mysql. Defaults to DB_PASSWORD. * * [--defaults] * : Loads the environment's MySQL option files. Default behavior is to skip loading them to avoid failures due to misconfiguration. * * ## EXAMPLES * * $ wp db create * Success: Database created. */ public function create( $_, $assoc_args ) { $this->run_query( self::get_create_query(), $assoc_args ); WP_CLI::success( 'Database created.' ); } /** * Deletes the existing database. * * Runs `DROP_DATABASE` SQL statement using `DB_HOST`, `DB_NAME`, * `DB_USER` and `DB_PASSWORD` database credentials specified in * wp-config.php. * * ## OPTIONS * * [--dbuser=<value>] * : Username to pass to mysql. Defaults to DB_USER. * * [--dbpass=<value>] * : Password to pass to mysql. Defaults to DB_PASSWORD. * * [--yes] * : Answer yes to the confirmation message. * * [--defaults] * : Loads the environment's MySQL option files. Default behavior is to skip loading them to avoid failures due to misconfiguration. * * ## EXAMPLES * * $ wp db drop --yes * Success: Database dropped. */ public function drop( $_, $assoc_args ) { WP_CLI::confirm( "Are you sure you want to drop the '" . DB_NAME . "' database?", $assoc_args ); $this->run_query( sprintf( 'DROP DATABASE `%s`', DB_NAME ), $assoc_args ); WP_CLI::success( 'Database dropped.' ); } /** * Removes all tables from the database. * * Runs `DROP_DATABASE` and `CREATE_DATABASE` SQL statements using * `DB_HOST`, `DB_NAME`, `DB_USER` and `DB_PASSWORD` database credentials * specified in wp-config.php. * * ## OPTIONS * * [--dbuser=<value>] * : Username to pass to mysql. Defaults to DB_USER. * * [--dbpass=<value>] * : Password to pass to mysql. Defaults to DB_PASSWORD. * * [--yes] * : Answer yes to the confirmation message. * * [--defaults] * : Loads the environment's MySQL option files. Default behavior is to skip loading them to avoid failures due to misconfiguration. * * ## EXAMPLES * * $ wp db reset --yes * Success: Database reset. */ public function reset( $_, $assoc_args ) { WP_CLI::confirm( "Are you sure you want to reset the '" . DB_NAME . "' database?", $assoc_args ); $this->run_query( sprintf( 'DROP DATABASE IF EXISTS `%s`', DB_NAME ), $assoc_args ); $this->run_query( self::get_create_query(), $assoc_args ); WP_CLI::success( 'Database reset.' ); } /** * Removes all tables with `$table_prefix` from the database. * * Runs `DROP_TABLE` for each table that has a `$table_prefix` as specified * in wp-config.php. * * ## OPTIONS * * [--dbuser=<value>] * : Username to pass to mysql. Defaults to DB_USER. * * [--dbpass=<value>] * : Password to pass to mysql. Defaults to DB_PASSWORD. * * [--yes] * : Answer yes to the confirmation message. * * [--defaults] * : Loads the environment's MySQL option files. Default behavior is to skip loading them to avoid failures due to misconfiguration. * * ## EXAMPLES * * # Delete all tables that match the current site prefix. * $ wp db clean --yes * Success: Tables dropped. * * @when after_wp_load */ public function clean( $_, $assoc_args ) { global $wpdb; WP_CLI::confirm( sprintf( "Are you sure you want to drop all the tables on '%s' that use the current site's database prefix ('%s')?", DB_NAME, $wpdb->get_blog_prefix() ), $assoc_args ); $tables = Utils\wp_get_table_names( [], [ 'all-tables-with-prefix' => true ] ); foreach ( $tables as $table ) { $this->run_query( sprintf( 'DROP TABLE IF EXISTS `%s`.`%s`', DB_NAME, $table ), $assoc_args ); } WP_CLI::success( 'Tables dropped.' ); } /** * Checks the current status of the database. * * Runs `mysqlcheck` utility with `--check` using `DB_HOST`, * `DB_NAME`, `DB_USER` and `DB_PASSWORD` database credentials * specified in wp-config.php. * * [See docs](http://dev.mysql.com/doc/refman/5.7/en/check-table.html) * for more details on the `CHECK TABLE` statement. * * This command does not check whether WordPress is installed; * to do that run `wp core is-installed`. * * ## OPTIONS * * [--dbuser=<value>] * : Username to pass to mysqlcheck. Defaults to DB_USER. * * [--dbpass=<value>] * : Password to pass to mysqlcheck. Defaults to DB_PASSWORD. * * [--<field>=<value>] * : Extra arguments to pass to mysqlcheck. [Refer to mysqlcheck docs](https://dev.mysql.com/doc/en/mysqlcheck.html). * * [--defaults] * : Loads the environment's MySQL option files. Default behavior is to skip loading them to avoid failures due to misconfiguration. * * ## EXAMPLES * * $ wp db check * Success: Database checked. */ public function check( $_, $assoc_args ) { $command = sprintf( '/usr/bin/env %s%s %s', Utils\get_sql_check_command(), $this->get_defaults_flag_string( $assoc_args ), '%s' ); WP_CLI::debug( "Running shell command: {$command}", 'db' ); $assoc_args['check'] = true; self::run( Utils\esc_cmd( $command, DB_NAME ), $assoc_args ); WP_CLI::debug( 'Associative arguments: ' . json_encode( $assoc_args ), 'db' ); WP_CLI::success( 'Database checked.' ); } /** * Optimizes the database. * * Runs `mysqlcheck` utility with `--optimize=true` using `DB_HOST`, * `DB_NAME`, `DB_USER` and `DB_PASSWORD` database credentials * specified in wp-config.php. * * [See docs](http://dev.mysql.com/doc/refman/5.7/en/optimize-table.html) * for more details on the `OPTIMIZE TABLE` statement. * * ## OPTIONS * * [--dbuser=<value>] * : Username to pass to mysqlcheck. Defaults to DB_USER. * * [--dbpass=<value>] * : Password to pass to mysqlcheck. Defaults to DB_PASSWORD. * * [--<field>=<value>] * : Extra arguments to pass to mysqlcheck. [Refer to mysqlcheck docs](https://dev.mysql.com/doc/en/mysqlcheck.html). * * [--defaults] * : Loads the environment's MySQL option files. Default behavior is to skip loading them to avoid failures due to misconfiguration. * * ## EXAMPLES * * $ wp db optimize * Success: Database optimized. */ public function optimize( $_, $assoc_args ) { $command = sprintf( '/usr/bin/env %s%s %s', Utils\get_sql_check_command(), $this->get_defaults_flag_string( $assoc_args ), '%s' ); WP_CLI::debug( "Running shell command: {$command}", 'db' ); $assoc_args['optimize'] = true; self::run( Utils\esc_cmd( $command, DB_NAME ), $assoc_args ); WP_CLI::debug( 'Associative arguments: ' . json_encode( $assoc_args ), 'db' ); WP_CLI::success( 'Database optimized.' ); } /** * Repairs the database. * * Runs `mysqlcheck` utility with `--repair=true` using `DB_HOST`, * `DB_NAME`, `DB_USER` and `DB_PASSWORD` database credentials * specified in wp-config.php. * * [See docs](http://dev.mysql.com/doc/refman/5.7/en/repair-table.html) for * more details on the `REPAIR TABLE` statement. * * ## OPTIONS * * [--dbuser=<value>] * : Username to pass to mysqlcheck. Defaults to DB_USER. * * [--dbpass=<value>] * : Password to pass to mysqlcheck. Defaults to DB_PASSWORD. * * [--<field>=<value>] * : Extra arguments to pass to mysqlcheck. [Refer to mysqlcheck docs](https://dev.mysql.com/doc/en/mysqlcheck.html). * * [--defaults] * : Loads the environment's MySQL option files. Default behavior is to skip loading them to avoid failures due to misconfiguration. * * ## EXAMPLES * * $ wp db repair * Success: Database repaired. */ public function repair( $_, $assoc_args ) { $command = sprintf( '/usr/bin/env %s%s %s', Utils\get_sql_check_command(), $this->get_defaults_flag_string( $assoc_args ), '%s' ); WP_CLI::debug( "Running shell command: {$command}", 'db' ); $assoc_args['repair'] = true; self::run( Utils\esc_cmd( $command, DB_NAME ), $assoc_args ); WP_CLI::debug( 'Associative arguments: ' . json_encode( $assoc_args ), 'db' ); WP_CLI::success( 'Database repaired.' ); } /** * Opens a MySQL console using credentials from wp-config.php * * ## OPTIONS * * [--database=<database>] * : Use a specific database. Defaults to DB_NAME. * * [--default-character-set=<character-set>] * : Use a specific character set. Defaults to DB_CHARSET when defined. * * [--dbuser=<value>] * : Username to pass to mysql. Defaults to DB_USER. * * [--dbpass=<value>] * : Password to pass to mysql. Defaults to DB_PASSWORD. * * [--<field>=<value>] * : Extra arguments to pass to mysql. [Refer to mysql docs](https://dev.mysql.com/doc/en/mysql-command-options.html). * * [--defaults] * : Loads the environment's MySQL option files. Default behavior is to skip loading them to avoid failures due to misconfiguration. * * ## EXAMPLES * * # Open MySQL console * $ wp db cli * mysql> * * @alias connect */ public function cli( $_, $assoc_args ) { $command = sprintf( '/usr/bin/env %s%s --no-auto-rehash', $this->get_mysql_command(), $this->get_defaults_flag_string( $assoc_args ) ); WP_CLI::debug( "Running shell command: {$command}", 'db' ); if ( ! isset( $assoc_args['database'] ) ) { $assoc_args['database'] = DB_NAME; } WP_CLI::debug( 'Associative arguments: ' . json_encode( $assoc_args ), 'db' ); self::run( $command, $assoc_args, null, true ); } /** * Executes a SQL query against the database. * * Executes an arbitrary SQL query using `DB_HOST`, `DB_NAME`, `DB_USER` * and `DB_PASSWORD` database credentials specified in wp-config.php. * * Use the `--skip-column-names` MySQL argument to exclude the headers * from a SELECT query. Pipe the output to remove the ASCII table * entirely. * * ## OPTIONS * * [<sql>] * : A SQL query. If not passed, will try to read from STDIN. * * [--dbuser=<value>] * : Username to pass to mysql. Defaults to DB_USER. * * [--dbpass=<value>] * : Password to pass to mysql. Defaults to DB_PASSWORD. * * [--<field>=<value>] * : Extra arguments to pass to mysql. [Refer to mysql docs](https://dev.mysql.com/doc/en/mysql-command-options.html). * * [--defaults] * : Loads the environment's MySQL option files. Default behavior is to skip loading them to avoid failures due to misconfiguration. * * ## EXAMPLES * * # Execute a query stored in a file * $ wp db query < debug.sql * * # Query for a specific value in the database (pipe the result to remove the ASCII table borders) * $ wp db query 'SELECT option_value FROM wp_options WHERE option_name="home"' --skip-column-names * +---------------------+ * | https://example.com | * +---------------------+ * * # Check all tables in the database * $ wp db query "CHECK TABLE $(wp db tables | paste -s -d, -);" * +---------------------------------------+-------+----------+----------+ * | Table | Op | Msg_type | Msg_text | * +---------------------------------------+-------+----------+----------+ * | wordpress_dbase.wp_users | check | status | OK | * | wordpress_dbase.wp_usermeta | check | status | OK | * | wordpress_dbase.wp_posts | check | status | OK | * | wordpress_dbase.wp_comments | check | status | OK | * | wordpress_dbase.wp_links | check | status | OK | * | wordpress_dbase.wp_options | check | status | OK | * | wordpress_dbase.wp_postmeta | check | status | OK | * | wordpress_dbase.wp_terms | check | status | OK | * | wordpress_dbase.wp_term_taxonomy | check | status | OK | * | wordpress_dbase.wp_term_relationships | check | status | OK | * | wordpress_dbase.wp_termmeta | check | status | OK | * | wordpress_dbase.wp_commentmeta | check | status | OK | * +---------------------------------------+-------+----------+----------+ * * # Pass extra arguments through to MySQL * $ wp db query 'SELECT * FROM wp_options WHERE option_name="home"' --skip-column-names * +---+------+------------------------------+-----+ * | 2 | home | http://wordpress-develop.dev | yes | * +---+------+------------------------------+-----+ * * ## MULTISITE USAGE * * Please note that the global `--url` parameter will have no effect on this command. * In order to query for data in a site other than your primary site, * you will need to manually modify the table names to use the prefix that includes the site's ID. * * For example, to get the `home` option for your second site, modify the example above like so: * * $ wp db query 'SELECT option_value FROM wp_2_options WHERE option_name="home"' --skip-column-names * +----------------------+ * | https://example2.com | * +----------------------+ * * To confirm the ID for the site you want to query, you can use the `wp site list` command: * * # wp site list --fields=blog_id,url * +---------+-----------------------+ * | blog_id | url | * +---------+-----------------------+ * | 1 | https://example1.com/ | * | 2 | https://example2.com/ | * +---------+-----------------------+ */ public function query( $args, $assoc_args ) { $command = sprintf( '/usr/bin/env %s%s --no-auto-rehash', $this->get_mysql_command(), $this->get_defaults_flag_string( $assoc_args ) ); WP_CLI::debug( "Running shell command: {$command}", 'db' ); $assoc_args['database'] = DB_NAME; // The query might come from STDIN. if ( ! empty( $args ) ) { $assoc_args['execute'] = $args[0]; } if ( isset( $assoc_args['execute'] ) ) { // Ensure that the SQL mode is compatible with WPDB. $assoc_args['execute'] = $this->get_sql_mode_query( $assoc_args ) . $assoc_args['execute']; } $is_row_modifying_query = isset( $assoc_args['execute'] ) && preg_match( '/\b(UPDATE|DELETE|INSERT|REPLACE|LOAD DATA)\b/i', $assoc_args['execute'] ); if ( $is_row_modifying_query ) { $assoc_args['execute'] .= '; SELECT ROW_COUNT();'; } WP_CLI::debug( 'Associative arguments: ' . json_encode( $assoc_args ), 'db' ); list( $stdout, $stderr, $exit_code ) = self::run( $command, $assoc_args, false ); if ( $exit_code ) { WP_CLI::error( "Query failed: {$stderr}" ); } if ( $is_row_modifying_query ) { $output_lines = explode( "\n", trim( $stdout ) ); $affected_rows = (int) trim( end( $output_lines ) ); WP_CLI::success( "Query succeeded. Rows affected: {$affected_rows}" ); } elseif ( ! empty( $stdout ) ) { WP_CLI::line( $stdout ); } } /** * Exports the database to a file or to STDOUT. * * Runs `mysqldump` utility using `DB_HOST`, `DB_NAME`, `DB_USER` and * `DB_PASSWORD` database credentials specified in wp-config.php. Accepts any valid `mysqldump` flags. * * ## OPTIONS * * [<file>] * : The name of the SQL file to export. If '-', then outputs to STDOUT. If * omitted, it will be '{dbname}-{Y-m-d}-{random-hash}.sql'. * * [--dbuser=<value>] * : Username to pass to mysqldump. Defaults to DB_USER. * * [--dbpass=<value>] * : Password to pass to mysqldump. Defaults to DB_PASSWORD. * * [--<field>=<value>] * : Extra arguments to pass to mysqldump. [Refer to mysqldump docs](https://dev.mysql.com/doc/en/mysqldump.html#mysqldump-option-summary). * * [--tables=<tables>] * : The comma separated list of specific tables to export. Excluding this parameter will export all tables in the database. * * [--exclude_tables=<tables>] * : The comma separated list of specific tables that should be skipped from exporting. Excluding this parameter will export all tables in the database. * * [--include-tablespaces] * : Skips adding the default --no-tablespaces option to mysqldump. * * [--porcelain] * : Output filename for the exported database. * * [--add-drop-table] * : Include a `DROP TABLE IF EXISTS` statement before each `CREATE TABLE` statement. * * [--defaults] * : Loads the environment's MySQL option files. Default behavior is to skip loading them to avoid failures due to misconfiguration. * * ## EXAMPLES * * # Export database with drop query included * $ wp db export --add-drop-table * Success: Exported to 'wordpress_dbase-db72bb5.sql'. * * # Export certain tables * $ wp db export --tables=wp_options,wp_users * Success: Exported to 'wordpress_dbase-db72bb5.sql'. * * # Export all tables matching a wildcard * $ wp db export --tables=$(wp db tables 'wp_user*' --format=csv) * Success: Exported to 'wordpress_dbase-db72bb5.sql'. * * # Export all tables matching prefix * $ wp db export --tables=$(wp db tables --all-tables-with-prefix --format=csv) * Success: Exported to 'wordpress_dbase-db72bb5.sql'. * * # Export certain posts without create table statements * $ wp db export --no-create-info=true --tables=wp_posts --where="ID in (100,101,102)" * Success: Exported to 'wordpress_dbase-db72bb5.sql'. * * # Export relating meta for certain posts without create table statements * $ wp db export --no-create-info=true --tables=wp_postmeta --where="post_id in (100,101,102)" * Success: Exported to 'wordpress_dbase-db72bb5.sql'. * * # Skip certain tables from the exported database * $ wp db export --exclude_tables=wp_options,wp_users * Success: Exported to 'wordpress_dbase-db72bb5.sql'. * * # Skip all tables matching a wildcard from the exported database * $ wp db export --exclude_tables=$(wp db tables 'wp_user*' --format=csv) * Success: Exported to 'wordpress_dbase-db72bb5.sql'. * * # Skip all tables matching prefix from the exported database * $ wp db export --exclude_tables=$(wp db tables --all-tables-with-prefix --format=csv) * Success: Exported to 'wordpress_dbase-db72bb5.sql'. * * # Export database to STDOUT. * $ wp db export - * -- MySQL dump 10.13 Distrib 5.7.19, for osx10.12 (x86_64) * -- * -- Host: localhost Database: wpdev * -- ------------------------------------------------------ * -- Server version 5.7.19 * ... * * @alias dump */ public function export( $args, $assoc_args ) { if ( ! empty( $args[0] ) ) { $result_file = $args[0]; } else { // phpcs:ignore WordPress.WP.AlternativeFunctions.rand_mt_rand -- WordPress is not loaded. $hash = substr( md5( mt_rand() ), 0, 7 ); $result_file = sprintf( '%s-%s-%s.sql', DB_NAME, date( 'Y-m-d' ), $hash ); // phpcs:ignore WordPress.DateTime.RestrictedFunctions.date_date } $stdout = ( '-' === $result_file ); $porcelain = Utils\get_flag_value( $assoc_args, 'porcelain' ); // Bail if both porcelain and STDOUT are set. if ( $stdout && $porcelain ) { WP_CLI::error( 'Porcelain is not allowed when output mode is STDOUT.' ); } if ( ! $stdout ) { $assoc_args['result-file'] = $result_file; } $mysqldump_binary = Utils\force_env_on_nix_systems( Utils\get_sql_dump_command() ); $support_column_statistics = exec( $mysqldump_binary . ' --help | grep "column-statistics"' ); /* * In case that `--default-character-set` is not given and `DB_CHARSET` is `utf8`, * we try to deduce what the actual character set for the posts table of the * current database is and use `utf8mb4` as a `default-character-set` if that * seems like the safer default, to ensure emojis are encoded correctly. */ if ( ! isset( $assoc_args['default-character-set'] ) && ( defined( 'DB_CHARSET' ) && self::ENCODING_UTF8 === constant( 'DB_CHARSET' ) ) && self::ENCODING_UTF8MB4 === $this->get_posts_table_charset( $assoc_args ) ) { WP_CLI::debug( 'Setting missing default character set to ' . self::ENCODING_UTF8MB4, 'db' ); $assoc_args['default-character-set'] = self::ENCODING_UTF8MB4; } $initial_command = sprintf( "{$mysqldump_binary}%s ", $this->get_defaults_flag_string( $assoc_args ) ); WP_CLI::debug( "Running initial shell command: {$initial_command}", 'db' ); $default_arguments = [ '%s' ]; if ( $support_column_statistics ) { $default_arguments[] = '--skip-column-statistics'; } if ( ! Utils\get_flag_value( $assoc_args, 'include-tablespaces', false ) ) { $default_arguments[] = '--no-tablespaces'; } $command = $initial_command . implode( ' ', $default_arguments ); $command_esc_args = [ DB_NAME ]; if ( isset( $assoc_args['tables'] ) ) { $tables = explode( ',', trim( $assoc_args['tables'], ',' ) ); unset( $assoc_args['tables'] ); $command .= ' --tables'; foreach ( $tables as $table ) { $command .= ' %s'; $command_esc_args[] = trim( $table ); } } $exclude_tables = Utils\get_flag_value( $assoc_args, 'exclude_tables' ); if ( isset( $exclude_tables ) ) { $tables = explode( ',', trim( $assoc_args['exclude_tables'], ',' ) ); unset( $assoc_args['exclude_tables'] ); foreach ( $tables as $table ) { $command .= ' --ignore-table'; $command .= ' %s'; $command_esc_args[] = trim( DB_NAME . '.' . $table ); } } $escaped_command = call_user_func_array( '\WP_CLI\Utils\esc_cmd', array_merge( [ $command ], $command_esc_args ) ); // Remove parameters not needed for SQL run. unset( $assoc_args['porcelain'] ); WP_CLI::debug( 'Associative arguments: ' . json_encode( $assoc_args ), 'db' ); self::run( $escaped_command, $assoc_args ); if ( $porcelain ) { WP_CLI::line( $result_file ); } elseif ( ! $stdout ) { WP_CLI::success( sprintf( "Exported to '%s'.", $result_file ) ); } } /** * Get the current character set of the posts table. * * @param array Associative array of associative arguments. * @return string Posts table character set. */ private function get_posts_table_charset( $assoc_args ) { $query = 'SELECT CCSA.character_set_name ' . 'FROM information_schema.`TABLES` T, ' . 'information_schema.`COLLATION_CHARACTER_SET_APPLICABILITY` CCSA ' . 'WHERE CCSA.collation_name = T.table_collation ' . "AND T.table_schema = '" . DB_NAME . "' " . "AND T.table_name LIKE '%\_posts';"; list( $stdout, $stderr, $exit_code ) = self::run( sprintf( '%s%s --no-auto-rehash --batch --skip-column-names', $this->get_mysql_command(), $this->get_defaults_flag_string( $assoc_args ) ), [ 'execute' => $query ], false ); if ( $exit_code ) { WP_CLI::warning( 'Failed to get current character set of the posts table.' . ( ! empty( $stderr ) ? " Reason: {$stderr}" : '' ) ); return self::ENCODING_UTF8MB4; } $stdout = trim( $stdout ); WP_CLI::debug( "Detected character set of the posts table: {$stdout}.", 'db' ); return $stdout; } /** * Imports a database from a file or from STDIN. * * Runs SQL queries using `DB_HOST`, `DB_NAME`, `DB_USER` and * `DB_PASSWORD` database credentials specified in wp-config.php. This * does not create database by itself and only performs whatever tasks are * defined in the SQL. * * ## OPTIONS * * [<file>] * : The name of the SQL file to import. If '-', then reads from STDIN. If omitted, it will look for '{dbname}.sql'. * * [--dbuser=<value>] * : Username to pass to mysql. Defaults to DB_USER. * * [--dbpass=<value>] * : Password to pass to mysql. Defaults to DB_PASSWORD. * * [--<field>=<value>] * : Extra arguments to pass to mysql. [Refer to mysql binary docs](https://dev.mysql.com/doc/refman/8.0/en/mysql-command-options.html). * * [--skip-optimization] * : When using an SQL file, do not include speed optimization such as disabling auto-commit and key checks. * * [--defaults] * : Loads the environment's MySQL option files. Default behavior is to skip loading them to avoid failures due to misconfiguration. * * ## EXAMPLES * * # Import MySQL from a file. * $ wp db import wordpress_dbase.sql * Success: Imported from 'wordpress_dbase.sql'. */ public function import( $args, $assoc_args ) { if ( ! empty( $args[0] ) ) { $result_file = $args[0]; } else { $result_file = sprintf( '%s.sql', DB_NAME ); } // Process options to MySQL. $mysql_args = array_merge( [ 'database' => DB_NAME ], self::get_dbuser_dbpass_args( $assoc_args ), self::get_mysql_args( $assoc_args ) ); if ( '-' !== $result_file ) { if ( ! is_readable( $result_file ) ) { WP_CLI::error( sprintf( 'Import file missing or not readable: %s', $result_file ) ); } $query = Utils\get_flag_value( $assoc_args, 'skip-optimization' ) ? 'SOURCE %s;' : 'SET autocommit = 0; SET unique_checks = 0; SET foreign_key_checks = 0; SOURCE %s; COMMIT;'; $query = $this->get_sql_mode_query( $assoc_args ) . $query; $mysql_args['execute'] = sprintf( $query, $result_file ); } else { $result_file = 'STDIN'; } $command = sprintf( '/usr/bin/env %s%s --no-auto-rehash', $this->get_mysql_command(), $this->get_defaults_flag_string( $assoc_args ) ); WP_CLI::debug( "Running shell command: {$command}", 'db' ); WP_CLI::debug( 'Associative arguments: ' . json_encode( $assoc_args ), 'db' ); self::run( $command, $mysql_args ); WP_CLI::success( sprintf( "Imported from '%s'.", $result_file ) ); } /** * Lists the database tables. * * Defaults to all tables registered to the $wpdb database handler. * * ## OPTIONS * * [<table>...] * : List tables based on wildcard search, e.g. 'wp_*_options' or 'wp_post?'. * * [--scope=<scope>] * : Can be all, global, ms_global, blog, or old tables. Defaults to all. * * [--network] * : List all the tables in a multisite install. * * [--all-tables-with-prefix] * : List all tables that match the table prefix even if not registered on $wpdb. Overrides --network. * * [--all-tables] * : List all tables in the database, regardless of the prefix, and even if not registered on $wpdb. Overrides --all-tables-with-prefix. * * [--format=<format>] * : Render output in a particular format. * --- * default: list * options: * - list * - csv * --- * * ## EXAMPLES * * # List tables for a single site, without shared tables like 'wp_users' * $ wp db tables --scope=blog --url=sub.example.com * wp_3_posts * wp_3_comments * wp_3_options * wp_3_postmeta * wp_3_terms * wp_3_term_taxonomy * wp_3_term_relationships * wp_3_termmeta * wp_3_commentmeta * * # Export only tables for a single site * $ wp db export --tables=$(wp db tables --url=sub.example.com --format=csv) * Success: Exported to wordpress_dbase.sql * * @when after_wp_load */ public function tables( $args, $assoc_args ) { $format = Utils\get_flag_value( $assoc_args, 'format' ); unset( $assoc_args['format'] ); if ( empty( $args ) && empty( $assoc_args ) ) { $assoc_args['scope'] = 'all'; } $tables = Utils\wp_get_table_names( $args, $assoc_args ); if ( 'csv' === $format ) { WP_CLI::line( implode( ',', $tables ) ); } else { foreach ( $tables as $table ) { WP_CLI::line( $table ); } } } /** * Displays the database name and size. * * Display the database name and size for `DB_NAME` specified in wp-config.php. * The size defaults to a human-readable number. * * Available size formats include: * * b (bytes) * * kb (kilobytes) * * mb (megabytes) * * gb (gigabytes) * * tb (terabytes) * * B (ISO Byte setting, with no conversion) * * KB (ISO Kilobyte setting, with 1 KB = 1,000 B) * * KiB (ISO Kibibyte setting, with 1 KiB = 1,024 B) * * MB (ISO Megabyte setting, with 1 MB = 1,000 KB) * * MiB (ISO Mebibyte setting, with 1 MiB = 1,024 KiB) * * GB (ISO Gigabyte setting, with 1 GB = 1,000 MB) * * GiB (ISO Gibibyte setting, with 1 GiB = 1,024 MiB) * * TB (ISO Terabyte setting, with 1 TB = 1,000 GB) * * TiB (ISO Tebibyte setting, with 1 TiB = 1,024 GiB) * * ## OPTIONS * * [--size_format=<format>] * : Display the database size only, as a bare number. * --- * options: * - b * - kb * - mb * - gb * - tb * - B * - KB * - KiB * - MB * - MiB * - GB * - GiB * - TB * - TiB * --- * * [--tables] * : Display each table name and size instead of the database size. * * [--human-readable] * : Display database sizes in human readable formats. * * [--format=<format>] * : Render output in a particular format. * --- * options: * - table * - csv * - json * - yaml * --- * * [--scope=<scope>] * : Can be all, global, ms_global, blog, or old tables. Defaults to all. * * [--network] * : List all the tables in a multisite install. * * [--decimals=<decimals>] * : Number of digits after decimal point. Defaults to 0. * * [--all-tables-with-prefix] * : List all tables that match the table prefix even if not registered on $wpdb. Overrides --network. * * [--all-tables] * : List all tables in the database, regardless of the prefix, and even if not registered on $wpdb. Overrides --all-tables-with-prefix. * * [--order=<order>] * : Ascending or Descending order. * --- * default: asc * options: * - asc * - desc * --- * * [--orderby=<orderby>] * : Order by fields. * --- * default: name * options: * - name * - size * --- * * ## EXAMPLES * * $ wp db size * +-------------------+------+ * | Name | Size | * +-------------------+------+ * | wordpress_default | 6 MB | * +-------------------+------+ * * $ wp db size --tables * +-----------------------+-------+ * | Name | Size | * +-----------------------+-------+ * | wp_users | 64 KB | * | wp_usermeta | 48 KB | * | wp_posts | 80 KB | * | wp_comments | 96 KB | * | wp_links | 32 KB | * | wp_options | 32 KB | * | wp_postmeta | 48 KB | * | wp_terms | 48 KB | * | wp_term_taxonomy | 48 KB | * | wp_term_relationships | 32 KB | * | wp_termmeta | 48 KB | * | wp_commentmeta | 48 KB | * +-----------------------+-------+ * * $ wp db size --size_format=b * 5865472 * * $ wp db size --size_format=kb * 5728 * * $ wp db size --size_format=mb * 6 * * @when after_wp_load */ public function size( $args, $assoc_args ) { global $wpdb; $format = Utils\get_flag_value( $assoc_args, 'format' ); $size_format = Utils\get_flag_value( $assoc_args, 'size_format' ); $human_readable = Utils\get_flag_value( $assoc_args, 'human-readable', false ); $tables = Utils\get_flag_value( $assoc_args, 'tables' ); $tables = ! empty( $tables ); $all_tables = Utils\get_flag_value( $assoc_args, 'all-tables' ); $all_tables_with_prefix = Utils\get_flag_value( $assoc_args, 'all-tables-with-prefix' ); $order = Utils\get_flag_value( $assoc_args, 'order', 'asc' ); $orderby = Utils\get_flag_value( $assoc_args, 'orderby', null ); if ( ! is_null( $size_format ) && $human_readable ) { WP_CLI::error( 'Cannot use --size_format and --human-readable arguments at the same time.' ); } unset( $assoc_args['format'] ); unset( $assoc_args['size_format'] ); unset( $assoc_args['human-readable'] ); unset( $assoc_args['tables'] ); if ( empty( $args ) && empty( $assoc_args ) ) { $assoc_args['scope'] = 'all'; } // Build rows for the formatter. $rows = []; $fields = [ 'Name', 'Size' ]; $default_unit = ( empty( $size_format ) && ! $human_readable ) ? ' B' : ''; if ( $tables || $all_tables || $all_tables_with_prefix ) { // Add all of the table sizes. foreach ( Utils\wp_get_table_names( $args, $assoc_args ) as $table_name ) { // Get the table size. $table_bytes = $wpdb->get_var( $wpdb->prepare( 'SELECT SUM(data_length + index_length) FROM information_schema.TABLES where table_schema = %s and Table_Name = %s GROUP BY Table_Name LIMIT 1', DB_NAME, $table_name ) ); // Add the table size to the list. $rows[] = [ 'Name' => $table_name, 'Size' => strtoupper( $table_bytes ) . $default_unit, 'Bytes' => strtoupper( $table_bytes ), ]; } } else { // Get the database size. $db_bytes = $wpdb->get_var( $wpdb->prepare( 'SELECT SUM(data_length + index_length) FROM information_schema.TABLES where table_schema = %s GROUP BY table_schema;', DB_NAME ) ); // Add the database size to the list. $rows[] = [ 'Name' => DB_NAME, 'Size' => strtoupper( $db_bytes ) . $default_unit, 'Bytes' => strtoupper( $db_bytes ), ]; } if ( ! empty( $size_format ) || $human_readable ) { foreach ( $rows as $index => $row ) { // phpcs:disable WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedConstantFound -- Backfilling WP native constants. if ( ! defined( 'KB_IN_BYTES' ) ) { define( 'KB_IN_BYTES', 1024 ); } if ( ! defined( 'MB_IN_BYTES' ) ) { define( 'MB_IN_BYTES', 1024 * KB_IN_BYTES ); } if ( ! defined( 'GB_IN_BYTES' ) ) { define( 'GB_IN_BYTES', 1024 * MB_IN_BYTES ); } if ( ! defined( 'TB_IN_BYTES' ) ) { define( 'TB_IN_BYTES', 1024 * GB_IN_BYTES ); } // phpcs:enable if ( $human_readable ) { $size_key = floor( log( $row['Size'] ) / log( 1000 ) ); $sizes = [ 'B', 'KB', 'MB', 'GB', 'TB' ]; $size_format = isset( $sizes[ $size_key ] ) ? $sizes[ $size_key ] : $sizes[0]; } // Display the database size as a number. switch ( $size_format ) { case 'TB': $divisor = pow( 1000, 4 ); break; case 'GB': $divisor = pow( 1000, 3 ); break; case 'MB': $divisor = pow( 1000, 2 ); break; case 'KB': $divisor = 1000; break; case 'tb': case 'TiB': $divisor = TB_IN_BYTES; break; case 'gb': case 'GiB': $divisor = GB_IN_BYTES; break; case 'mb': case 'MiB': $divisor = MB_IN_BYTES; break; case 'kb': case 'KiB': $divisor = KB_IN_BYTES; break; case 'b': case 'B': default: $divisor = 1; break; } $size_format_display = preg_replace( '/IB$/u', 'iB', strtoupper( $size_format ) ); $decimals = Utils\get_flag_value( $assoc_args, 'decimals', 0 ); $rows[ $index ]['Size'] = round( (int) $row['Bytes'] / $divisor, $decimals ) . ' ' . $size_format_display; } } if ( ! empty( $size_format ) && ! $tables && ! $format && ! $human_readable && true !== $all_tables && true !== $all_tables_with_prefix ) { WP_CLI::line( str_replace( " {$size_format_display}", '', $rows[0]['Size'] ) ); } else { // Sort the rows by user input if ( $orderby ) { usort( $rows, function ( $a, $b ) use ( $order, $orderby ) { $orderby_array = 'asc' === $order ? array( $a, $b ) : array( $b, $a ); list( $first, $second ) = $orderby_array; if ( 'size' === $orderby ) { return $first['Bytes'] > $second['Bytes']; } return strcmp( $first['Name'], $second['Name'] ); } ); } // Display the rows. $args = [ 'format' => $format, ]; $formatter = new Formatter( $args, $fields ); $formatter->display_items( $rows ); } } /** * Displays the database table prefix. * * Display the database table prefix, as defined by the database handler's interpretation of the current site. * * ## EXAMPLES * * $ wp db prefix * wp_ * * @when after_wp_load */ public function prefix() { global $wpdb; WP_CLI::log( $wpdb->prefix ); } /** * Finds a string in the database. * * Searches through all of the text columns in a selection of database tables for a given string, Outputs colorized references to the string. * * Defaults to searching through all tables registered to $wpdb. On multisite, this default is limited to the tables for the current site. * * ## OPTIONS * * <search> * : String to search for. The search is case-insensitive by default. * * [<tables>...] * : One or more tables to search through for the string. * * [--network] * : Search through all the tables registered to $wpdb in a multisite install. * * [--all-tables-with-prefix] * : Search through all tables that match the registered table prefix, even if not registered on $wpdb. On one hand, sometimes plugins use tables without registering them to $wpdb. On another hand, this could return tables you don't expect. Overrides --network. * * [--all-tables] * : Search through ALL tables in the database, regardless of the prefix, and even if not registered on $wpdb. Overrides --network and --all-tables-with-prefix. * * [--before_context=<num>] * : Number of characters to display before the match. * --- * default: 40 * --- * * [--after_context=<num>] * : Number of characters to display after the match. * --- * default: 40 * --- * * [--regex] * : Runs the search as a regular expression (without delimiters). The search becomes case-sensitive (i.e. no PCRE flags are added). Delimiters must be escaped if they occur in the expression. Because the search is run on individual columns, you can use the `^` and `$` tokens to mark the start and end of a match, respectively. * * [--regex-flags=<regex-flags>] * : Pass PCRE modifiers to the regex search (e.g. 'i' for case-insensitivity). * * [--regex-delimiter=<regex-delimiter>] * : The delimiter to use for the regex. It must be escaped if it appears in the search string. The default value is the result of `chr(1)`. * * [--table_column_once] * : Output the 'table:column' line once before all matching row lines in the table column rather than before each matching row. * * [--one_line] * : Place the 'table:column' output on the same line as the row id and match ('table:column:id:match'). Overrides --table_column_once. * * [--matches_only] * : Only output the string matches (including context). No 'table:column's or row ids are outputted. * * [--stats] * : Output stats on the number of matches found, time taken, tables/columns/rows searched, tables skipped. * * [--table_column_color=<color_code>] * : Percent color code to use for the 'table:column' output. For a list of available percent color codes, see below. Default '%G' (bright green). * * [--id_color=<color_code>] * : Percent color code to use for the row id output. For a list of available percent color codes, see below. Default '%Y' (bright yellow). * * [--match_color=<color_code>] * : Percent color code to use for the match (unless both before and after context are 0, when no color code is used). For a list of available percent color codes, see below. Default '%3%k' (black on a mustard background). * * [--fields=<fields>] * : Get a specific subset of the fields. * * [--format=<format>] * : Render output in a particular format. * --- * options: * - table * - csv * - json * - yaml * - ids * - count * --- * * The percent color codes available are: * * | Code | Color * | ---- | ----- * | %y | Yellow (dark) (mustard) * | %g | Green (dark) * | %b | Blue (dark) * | %r | Red (dark) * | %m | Magenta (dark) * | %c | Cyan (dark) * | %w | White (dark) (light gray) * | %k | Black * | %Y | Yellow (bright) * | %G | Green (bright) * | %B | Blue (bright) * | %R | Red (bright) * | %M | Magenta (bright) * | %C | Cyan (bright) * | %W | White * | %K | Black (bright) (dark gray) * | %3 | Yellow background (dark) (mustard) * | %2 | Green background (dark) * | %4 | Blue background (dark) * | %1 | Red background (dark) * | %5 | Magenta background (dark) * | %6 | Cyan background (dark) * | %7 | White background (dark) (light gray) * | %0 | Black background * | %8 | Reverse * | %U | Underline * | %F | Blink (unlikely to work) * * They can be concatenated. For instance, the default match color of black on a mustard (dark yellow) background `%3%k` can be made black on a bright yellow background with `%Y%0%8`. * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each result: * * * table * * column * * match * * primary_key_name * * primary_key_value * * ## EXAMPLES * * # Search through the database for the 'wordpress-develop' string * $ wp db search wordpress-develop * wp_options:option_value * 1:http://wordpress-develop.dev * wp_options:option_value * 1:https://example.com/foo * ... * * # Search through a multisite database on the subsite 'foo' for the 'example.com' string * $ wp db search example.com --url=example.com/foo * wp_2_comments:comment_author_url * 1:https://example.com/ * wp_2_options:option_value * ... * * # Search through the database for the 'https?://' regular expression, printing stats. * $ wp db search 'https?://' --regex --stats * wp_comments:comment_author_url * 1:https://wordpress.org/ * ... * Success: Found 99146 matches in 10.752s (10.559s searching). Searched 12 tables, 53 columns, 1358907 rows. 1 table skipped: wp_term_relationships. * * # SQL search database table 'wp_options' where 'option_name' match 'foo' * wp db query 'SELECT * FROM wp_options WHERE option_name like "%foo%"' --skip-column-names * +----+--------------+--------------------------------+-----+ * | 98 | foo_options | a:1:{s:12:"_multiwidget";i:1;} | yes | * | 99 | foo_settings | a:0:{} | yes | * +----+--------------+--------------------------------+-----+ * * # SQL search and delete records from database table 'wp_options' where 'option_name' match 'foo' * wp db query "DELETE from wp_options where option_id in ($(wp db query "SELECT GROUP_CONCAT(option_id SEPARATOR ',') from wp_options where option_name like '%foo%';" --silent --skip-column-names))" * * # Search for a string and print the result as a table * $ wp db search https://localhost:8889 --format=table --fields=table,column,match * +------------+--------------+-----------------------------+ * | table | column | match | * +------------+--------------+-----------------------------+ * | wp_options | option_value | https://localhost:8889 | * | wp_options | option_value | https://localhost:8889 | * | wp_posts | guid | https://localhost:8889/?p=1 | * | wp_users | user_url | https://localhost:8889 | * +------------+--------------+-----------------------------+ * * # Search for a string and get only the IDs (only works for a single table) * $ wp db search https://localhost:8889 wp_options --format=ids * 1 2 * * @when after_wp_load */ public function search( $args, $assoc_args ) { global $wpdb; $start_run_time = microtime( true ); $search = array_shift( $args ); $before_context = Utils\get_flag_value( $assoc_args, 'before_context', 40 ); $before_context = '' === $before_context ? $before_context : (int) $before_context; $after_context = Utils\get_flag_value( $assoc_args, 'after_context', 40 ); $after_context = '' === $after_context ? $after_context : (int) $after_context; $regex = Utils\get_flag_value( $assoc_args, 'regex', false ); if ( false !== $regex ) { $regex_flags = Utils\get_flag_value( $assoc_args, 'regex-flags', false ); $default_regex_delimiter = false; $regex_delimiter = Utils\get_flag_value( $assoc_args, 'regex-delimiter', '' ); if ( '' === $regex_delimiter ) { $regex_delimiter = chr( 1 ); $default_regex_delimiter = true; } } $colors = self::get_colors( $assoc_args, [ 'table_column' => '%G', 'id' => '%Y', 'match' => $before_context || $after_context ? '%3%k' : '', ] ); $table_column_once = Utils\get_flag_value( $assoc_args, 'table_column_once', false ); $one_line = Utils\get_flag_value( $assoc_args, 'one_line', false ); $matches_only = Utils\get_flag_value( $assoc_args, 'matches_only', false ); $stats = Utils\get_flag_value( $assoc_args, 'stats', false ); $fields = Utils\get_flag_value( $assoc_args, 'fields' ); $format = Utils\get_flag_value( $assoc_args, 'format' ); $column_count = 0; $row_count = 0; $match_count = 0; $skipped = []; if ( $regex ) { // Note the user must escape the delimiter in the search. $search_regex = $regex_delimiter . $search . $regex_delimiter; if ( $regex_flags ) { $search_regex .= $regex_flags; } // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged -- Unsure why this is needed, leaving in for now. if ( false === @preg_match( $search_regex, '' ) ) { if ( $default_regex_delimiter ) { $flags_msg = $regex_flags ? "flags '$regex_flags'" : 'no flags'; $msg = "The regex pattern '$search' with default delimiter 'chr(1)' and {$flags_msg} fails."; } else { $msg = "The regex '$search_regex' fails."; } WP_CLI::error( $msg ); } } else { $search_regex = '#' . preg_quote( $search, '#' ) . '#i'; $esc_like_search = '%' . Utils\esc_like( $search ) . '%'; } $encoding = null; if ( 0 === strpos( $wpdb->charset, self::ENCODING_UTF8 ) ) { $encoding = 'UTF-8'; } $tables = Utils\wp_get_table_names( $args, $assoc_args ); $search_results = []; $start_search_time = microtime( true ); foreach ( $tables as $table ) { list( $primary_keys, $text_columns, $all_columns ) = self::get_columns( $table ); if ( ! $all_columns ) { WP_CLI::error( "No such table '$table'." ); } if ( ! $text_columns ) { if ( $stats ) { $skipped[] = $table; // Don't bother warning for term relationships (which is just 3 int columns). } elseif ( ! preg_match( '/_term_relationships$/', $table ) ) { WP_CLI::warning( $primary_keys ? "No text columns for table '$table' - skipped." : "No primary key or text columns for table '$table' - skipped." ); } continue; } $table_sql = self::esc_sql_ident( $table ); $column_count += count( $text_columns ); if ( ! $primary_keys ) { WP_CLI::warning( "No primary key for table '$table'. No row ids will be outputted." ); $primary_key = ''; $primary_key_sql = ''; } else { $primary_key = array_shift( $primary_keys ); $primary_key_sql = self::esc_sql_ident( $primary_key ) . ', '; } foreach ( $text_columns as $column ) { $column_sql = self::esc_sql_ident( $column ); if ( $regex ) { // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Escaped through esc_sql_ident/esc_like. $results = $wpdb->get_results( "SELECT {$primary_key_sql}{$column_sql} FROM {$table_sql}" ); } else { // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Escaped through esc_sql_ident/esc_like. $results = $wpdb->get_results( $wpdb->prepare( "SELECT {$primary_key_sql}{$column_sql} FROM {$table_sql} WHERE {$column_sql} LIKE %s;", $esc_like_search ) ); } if ( $results ) { $row_count += count( $results ); $table_column_val = $colors['table_column'][0] . "{$table}:{$column}" . $colors['table_column'][1]; $outputted_table_column_once = false; foreach ( $results as $result ) { $col_val = $result->$column; if ( preg_match_all( $search_regex, $col_val, $matches, PREG_OFFSET_CAPTURE ) ) { if ( ! $format && ! $matches_only && ( ! $table_column_once || ! $outputted_table_column_once ) && ! $one_line ) { WP_CLI::log( $table_column_val ); $outputted_table_column_once = true; } $pk_val = $primary_key ? ( $colors['id'][0] . $result->$primary_key . $colors['id'][1] . ':' ) : ''; $bits = []; $col_encoding = $encoding; if ( ! $col_encoding && ( $before_context || $after_context ) && function_exists( 'mb_detect_encoding' ) ) { $col_encoding = mb_detect_encoding( $col_val, null, true /*strict*/ ); } $append_next = false; $last_offset = 0; $match_cnt = count( $matches[0] ); for ( $i = 0; $i < $match_cnt; $i++ ) { $match = $matches[0][ $i ][0]; $offset = $matches[0][ $i ][1]; $log = $colors['match'][0] . $match . $colors['match'][1]; $before = ''; $after = ''; $after_shortened = false; // Offsets are in bytes, so need to use `strlen()` and `substr()` before using `safe_substr()`. if ( $before_context && $offset && ! $append_next ) { $before = \cli\safe_substr( substr( $col_val, $last_offset, $offset - $last_offset ), -$before_context, null /*length*/, false /*is_width*/, $col_encoding ); } if ( $after_context ) { $end_offset = $offset + strlen( $match ); $after = \cli\safe_substr( substr( $col_val, $end_offset ), 0, $after_context, false /*is_width*/, $col_encoding ); // To lessen context duplication in output, shorten the after context if it overlaps with the next match. if ( $i + 1 < $match_cnt && $end_offset + strlen( $after ) > $matches[0][ $i + 1 ][1] ) { $after = substr( $after, 0, $matches[0][ $i + 1 ][1] - $end_offset ); $after_shortened = true; // On the next iteration, will append with no before context. } } if ( $append_next ) { $cnt = count( $bits ); $bits[ $cnt - 1 ] .= $log . $after; } else { $bits[] = $before . $log . $after; } $append_next = $after_shortened; $last_offset = $offset; } $match_count += $match_cnt; $col_val = implode( ' [...] ', $bits ); if ( $format ) { $search_results[] = [ 'table' => $table, 'column' => $column, // Remove the colors for the format output. 'match' => str_replace( [ $colors['match'][0], $colors['match'][1] ], [ '','' ], $col_val ), 'primary_key_name' => $primary_key, 'primary_key_value' => $result->$primary_key, ]; } else { WP_CLI::log( $matches_only ? $col_val : ( $one_line ? "{$table_column_val}:{$pk_val}{$col_val}" : "{$pk_val}{$col_val}" ) ); } } } } } } if ( $format ) { $formatter_args = [ 'format' => $format, ]; $formatter_fields = [ 'table', 'column', 'match', 'primary_key_name', 'primary_key_value' ]; if ( $fields ) { $fields = explode( ',', $assoc_args['fields'] ); $formatter_fields = array_values( array_intersect( $formatter_fields, $fields ) ); } if ( in_array( $format, [ 'ids', 'count' ], true ) ) { if ( count( $tables ) > 1 ) { WP_CLI::error( "The \"{$format}\" format can only be used for a single table." ); } $search_results = array_column( $search_results, 'primary_key_value' ); } $formatter = new Formatter( $formatter_args, $formatter_fields ); $formatter->display_items( $search_results ); } if ( $stats ) { $table_count = count( $tables ); $skipped_count = count( $skipped ); $match_str = 1 === $match_count ? 'match' : 'matches'; $table_str = 1 === $table_count ? 'table' : 'tables'; $column_str = 1 === $column_count ? 'column' : 'columns'; $row_str = 1 === $row_count ? 'row' : 'rows'; $skipped_str = 1 === $skipped_count ? 'table skipped' : 'tables skipped'; if ( 0 !== $skipped_count ) { $skipped_str .= ': ' . implode( ', ', $skipped ); } $end_time = microtime( true ); $run_time = $end_time - $start_run_time; $search_time = $end_time - $start_search_time; $stats_msg = sprintf( 'Found %d %s in %.3fs (%.3fs searching). Searched %d %s, %d %s, %d %s. %d %s.', $match_count, $match_str, $run_time, $search_time, $table_count, $table_str, $column_count, $column_str, $row_count, $row_str, $skipped_count, $skipped_str ); WP_CLI::success( $stats_msg ); } } /** * Displays information about a given table. * * ## OPTIONS * * <table> * : Name of the database table. * * [--format] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - yaml * --- * * ## EXAMPLES * * $ wp db columns wp_posts * +-----------------------+---------------------+------+-----+---------------------+----------------+ * | Field | Type | Null | Key | Default | Extra | * +-----------------------+---------------------+------+-----+---------------------+----------------+ * | ID | bigint(20) unsigned | NO | PRI | | auto_increment | * | post_author | bigint(20) unsigned | NO | MUL | 0 | | * | post_date | datetime | NO | | 0000-00-00 00:00:00 | | * | post_date_gmt | datetime | NO | | 0000-00-00 00:00:00 | | * | post_content | longtext | NO | | | | * | post_title | text | NO | | | | * | post_excerpt | text | NO | | | | * | post_status | varchar(20) | NO | | publish | | * | comment_status | varchar(20) | NO | | open | | * | ping_status | varchar(20) | NO | | open | | * | post_password | varchar(255) | NO | | | | * | post_name | varchar(200) | NO | MUL | | | * | to_ping | text | NO | | | | * | pinged | text | NO | | | | * | post_modified | datetime | NO | | 0000-00-00 00:00:00 | | * | post_modified_gmt | datetime | NO | | 0000-00-00 00:00:00 | | * | post_content_filtered | longtext | NO | | | | * | post_parent | bigint(20) unsigned | NO | MUL | 0 | | * | guid | varchar(255) | NO | | | | * | menu_order | int(11) | NO | | 0 | | * | post_type | varchar(20) | NO | MUL | post | | * | post_mime_type | varchar(100) | NO | | | | * | comment_count | bigint(20) | NO | | 0 | | * +-----------------------+---------------------+------+-----+---------------------+----------------+ * * @when after_wp_load */ public function columns( $args, $assoc_args ) { global $wpdb; $format = Utils\get_flag_value( $assoc_args, 'format' ); Utils\wp_get_table_names( [ $args[0] ], [ 'all-tables' => true ] ); $columns = $wpdb->get_results( // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- Asserted to be a valid table name through wp_get_table_names. 'SHOW COLUMNS FROM ' . $args[0] ); $formatter_fields = [ 'Field', 'Type', 'Null', 'Key', 'Default', 'Extra' ]; $formatter_args = [ 'format' => $format, ]; $formatter = new Formatter( $formatter_args, $formatter_fields ); $formatter->display_items( $columns ); } private static function get_create_query() { $create_query = sprintf( 'CREATE DATABASE %s', self::esc_sql_ident( DB_NAME ) ); if ( defined( 'DB_CHARSET' ) && constant( 'DB_CHARSET' ) ) { $create_query .= sprintf( ' DEFAULT CHARSET %s', self::esc_sql_ident( DB_CHARSET ) ); } if ( defined( 'DB_COLLATE' ) && constant( 'DB_COLLATE' ) ) { $create_query .= sprintf( ' DEFAULT COLLATE %s', self::esc_sql_ident( DB_COLLATE ) ); } return $create_query; } /** * Run a single query via the 'mysql' binary. * * This includes the necessary setup to make sure the queries behave similar * to what WPDB produces. * * @param string $query Query to execute. * @param array $assoc_args Optional. Associative array of arguments. */ protected function run_query( $query, $assoc_args = [] ) { // Ensure that the SQL mode is compatible with WPDB. $query = $this->get_sql_mode_query( $assoc_args ) . $query; WP_CLI::debug( "Query: {$query}", 'db' ); $mysql_args = array_merge( self::get_dbuser_dbpass_args( $assoc_args ), self::get_mysql_args( $assoc_args ) ); self::run( sprintf( '%s%s --no-auto-rehash', $this->get_mysql_command(), $this->get_defaults_flag_string( $assoc_args ) ), array_merge( [ 'execute' => $query ], $mysql_args ) ); } /** * Run a MySQL command and optionally return the output. * * @param string $cmd Command to run. * @param array $assoc_args Optional. Associative array of arguments to * use. * @param bool $send_to_shell Optional. Whether to send STDOUT and STDERR * immediately to the shell. Defaults to true. * @param bool $interactive Optional. Whether MySQL is meant to be * executed as an interactive process. Defaults * to false. * * @return array { * Associative array containing STDOUT and STDERR output. * * @type string $stdout Output that was sent to STDOUT. * @type string $stderr Output that was sent to STDERR. * @type int $exit_code Exit code of the process. * } */ private static function run( $cmd, $assoc_args = [], $send_to_shell = true, $interactive = false ) { $required = [ 'host' => DB_HOST, 'user' => DB_USER, 'pass' => DB_PASSWORD, ]; if ( ! isset( $assoc_args['default-character-set'] ) && defined( 'DB_CHARSET' ) && constant( 'DB_CHARSET' ) ) { $required['default-character-set'] = constant( 'DB_CHARSET' ); } // Using 'dbuser' as option name to workaround clash with WP-CLI's global WP 'user' parameter, with 'dbpass' also available for tidyness. if ( isset( $assoc_args['dbuser'] ) ) { $required['user'] = $assoc_args['dbuser']; unset( $assoc_args['dbuser'] ); } if ( isset( $assoc_args['dbpass'] ) ) { $required['pass'] = $assoc_args['dbpass']; unset( $assoc_args['dbpass'], $assoc_args['password'] ); } $final_args = array_merge( $required, $assoc_args ); // Adapt ordering of arguments. uksort( $final_args, static function ( $a, $b ) { if ( 'force' === $a ) { return 1; } elseif ( 'force' === $b ) { return -1; } else { return 0; } } ); return Utils\run_mysql_command( $cmd, $final_args, null, $send_to_shell, $interactive ); } /** * Helper to pluck 'dbuser' and 'dbpass' from associative args array. * * @param array $assoc_args Associative args array. * @return array Array with `dbuser' and 'dbpass' set if in passed-in associative args array. */ private static function get_dbuser_dbpass_args( $assoc_args ) { $mysql_args = []; $dbuser = Utils\get_flag_value( $assoc_args, 'dbuser' ); if ( null !== $dbuser ) { $mysql_args['dbuser'] = $dbuser; } $dbpass = Utils\get_flag_value( $assoc_args, 'dbpass' ); if ( null !== $dbpass ) { $mysql_args['dbpass'] = $dbpass; } return $mysql_args; } /** * Gets the column names of a db table differentiated into key columns and text columns and all columns. * * @param string $table The table name. * @return array A 3 element array consisting of an array of primary key column names, an array of text column names, and an array containing all column names. */ private static function get_columns( $table ) { global $wpdb; $table_sql = self::esc_sql_ident( $table ); $primary_keys = []; $text_columns = []; $all_columns = []; $suppress_errors = $wpdb->suppress_errors(); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Escaped through esc_sql_ident/esc_like. $results = $wpdb->get_results( "DESCRIBE $table_sql" ); if ( $results ) { foreach ( $results as $col ) { // phpcs:disable WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase -- Property names come from database. if ( 'PRI' === $col->Key ) { $primary_keys[] = $col->Field; } if ( self::is_text_col( $col->Type ) ) { $text_columns[] = $col->Field; } $all_columns[] = $col->Field; // phpcs:enable } } $wpdb->suppress_errors( $suppress_errors ); return [ $primary_keys, $text_columns, $all_columns ]; } /** * Determines whether a column is considered text or not. * * @param string Column type. * @return bool True if text column, false otherwise. */ private static function is_text_col( $type ) { foreach ( [ 'text', 'varchar' ] as $token ) { if ( false !== strpos( $type, $token ) ) { return true; } } return false; } /** * Escapes (backticks) MySQL identifiers (aka schema object names) - i.e. column names, table names, and database/index/alias/view etc names. * See https://dev.mysql.com/doc/refman/5.5/en/identifiers.html * * @param string|array $idents A single identifier or an array of identifiers. * @return string|array An escaped string if given a string, or an array of escaped strings if given an array of strings. */ private static function esc_sql_ident( $idents ) { $backtick = static function ( $v ) { // Escape any backticks in the identifier by doubling. return '`' . str_replace( '`', '``', $v ) . '`'; }; if ( is_string( $idents ) ) { return $backtick( $idents ); } return array_map( $backtick, $idents ); } /** * Gets the color codes from the options if any, and returns the passed in array colorized with 2 elements per entry, a color code (or '') and a reset (or ''). * * @param array $assoc_args The associative argument array passed to the command. * @param array $colors Array of default percent color code strings keyed by the 3 color contexts 'table_column', 'id', 'match'. * @return array Array containing 3 2-element arrays. */ private function get_colors( $assoc_args, $colors ) { $color_reset = WP_CLI::colorize( '%n' ); $color_codes = implode( '', array_map( function ( $v ) { return substr( $v, 1 ); }, array_keys( \cli\Colors::getColors() ) ) ); $color_codes_regex = '/^(?:%[' . $color_codes . '])*$/'; foreach ( array_keys( $colors ) as $color_col ) { $col_color_flag = Utils\get_flag_value( $assoc_args, $color_col . '_color', false ); if ( false !== $col_color_flag ) { if ( ! preg_match( $color_codes_regex, $col_color_flag, $matches ) ) { WP_CLI::warning( "Unrecognized percent color code '$col_color_flag' for '{$color_col}_color'." ); } else { $colors[ $color_col ] = $matches[0]; } } $colors[ $color_col ] = $colors[ $color_col ] ? [ WP_CLI::colorize( $colors[ $color_col ] ), $color_reset ] : [ '', '' ]; } return $colors; } /** * Helper to pluck `mysql` options from associative args array. * * @param array $assoc_args Associative args array. * @return array Array with `mysql` options set if in passed-in associative args array. */ private static function get_mysql_args( $assoc_args ) { $allowed_mysql_options = [ 'auto-rehash', 'auto-vertical-output', 'batch', 'binary-as-hex', 'binary-mode', 'bind-address', 'character-sets-dir', 'column-names', 'column-type-info', 'comments', 'compress', 'connect-expired-password', 'connect_timeout', 'database', 'debug', 'debug-check', 'debug-info', 'default-auth', 'default-character-set', 'defaults-extra-file', 'defaults-file', 'defaults-group-suffix', 'delimiter', 'enable-cleartext-plugin', 'execute', 'force', 'get-server-public-key', 'help', 'histignore', 'host', 'html', 'ignore-spaces', 'init-command', 'line-numbers', 'local-infile', 'login-path', 'max_allowed_packet', 'max_join_size', 'named-commands', 'net_buffer_length', 'no-beep', 'one-database', 'pager', 'pipe', 'plugin-dir', 'port', 'print-defaults', 'protocol', 'quick', 'raw', 'reconnect', 'i-am-a-dummy', 'safe-updates', 'secure-auth', 'select_limit', 'server-public-key-path', 'shared-memory-base-name', 'show-warnings', 'sigint-ignore', 'silent', 'skip-auto-rehash', 'skip-column-names', 'skip-line-numbers', 'skip-named-commands', 'skip-pager', 'skip-reconnect', 'socket', 'ssl-ca', 'ssl-capath', 'ssl-cert', 'ssl-cipher', 'ssl-crl', 'ssl-crlpath', 'ssl-fips-mode', 'ssl-key', 'ssl-mode', 'syslog', 'table', 'tee', 'tls-version', 'unbuffered', 'verbose', 'version', 'vertical', 'wait', 'xml', ]; $mysql_args = []; foreach ( $assoc_args as $mysql_option_key => $mysql_option_value ) { // Check flags to make sure they only contain valid options. if ( in_array( $mysql_option_key, $allowed_mysql_options, true ) && ! empty( $mysql_option_value ) ) { $mysql_args[ $mysql_option_key ] = $mysql_option_value; } } return $mysql_args; } /** * Writes out the `--no-defaults` flag for MySQL commands unless the --defaults flag is specified for the WP_CLI command. * * @param array $assoc_args Associative args array. * @return string Either the '--no-defaults' flag for use in the command or an empty string. */ protected function get_defaults_flag_string( &$assoc_args ) { $flag_string = ' --no-defaults'; if ( array_key_exists( 'defaults', $assoc_args ) ) { if ( true === Utils\get_flag_value( $assoc_args, 'defaults' ) ) { $flag_string = ''; } unset( $assoc_args['defaults'] ); } return $flag_string; } /** * Get the query to change the current SQL mode, and ensure its WordPress compatibility. * * If no modes are passed, it will ensure the current MySQL server modes are * compatible. * * Copied and adapted from WordPress Core code. * * @see https://github.com/WordPress/wordpress-develop/blob/5.4.0/src/wp-includes/wp-db.php#L817-L880 * * @param array $assoc_args The associative argument array passed to the command. * @param array $modes Optional. A list of SQL modes to set. * @return string Query string to use for setting the SQL modes to a * compatible state. */ protected function get_sql_mode_query( $assoc_args, $modes = [] ) { if ( empty( $modes ) ) { $modes = $this->get_current_sql_modes( $assoc_args ); } $modes = array_change_key_case( $modes, CASE_UPPER ); $is_mode_adaptation_needed = false; foreach ( $modes as $i => $mode ) { if ( in_array( $mode, $this->sql_incompatible_modes, true ) ) { unset( $modes[ $i ] ); $is_mode_adaptation_needed = true; } } if ( ! $is_mode_adaptation_needed ) { WP_CLI::debug( sprintf( 'SQL modes look fine: %s', json_encode( $modes ) ) ); return ''; } WP_CLI::debug( sprintf( 'SQL mode adaptation is needed: %s => %s', json_encode( $this->get_current_sql_modes( $assoc_args ) ), json_encode( $modes ) ) ); $modes_str = implode( ',', $modes ); return "SET SESSION sql_mode='{$modes_str}';"; } /** * Get the list of current SQL modes. * * @param array $assoc_args The associative argument array passed to the command. * @return string[] Array of SQL modes. */ protected function get_current_sql_modes( $assoc_args ) { static $modes = null; // Make sure the provided arguments don't interfere with the expected // output here. $args = []; foreach ( [] as $arg ) { if ( isset( $assoc_args[ $arg ] ) ) { $args[ $arg ] = $assoc_args[ $arg ]; } } if ( null === $modes ) { $modes = []; list( $stdout, $stderr, $exit_code ) = self::run( sprintf( '%s%s --no-auto-rehash --batch --skip-column-names', $this->get_mysql_command(), $this->get_defaults_flag_string( $assoc_args ) ), array_merge( $args, [ 'execute' => 'SELECT @@SESSION.sql_mode' ] ), false ); if ( $exit_code ) { WP_CLI::error( 'Failed to get current SQL modes.' . ( ! empty( $stderr ) ? " Reason: {$stderr}" : '' ), $exit_code ); } if ( ! empty( $stdout ) ) { $modes = array_filter( array_map( 'trim', preg_split( "/\r\n|\n|\r|,/", $stdout ) ) ); } if ( false === $modes ) { $modes = []; } } return $modes; } /** * Returns the correct `mysql` command based on the detected database type. * * @return string The appropriate check command. */ private function get_mysql_command() { return 'mariadb' === Utils\get_db_type() ? 'mariadb' : 'mysql'; } } <?php use WP_CLI\Utils; class EvalFile_Command extends WP_CLI_Command { /** * Regular expression pattern to match the shell shebang. * * @var string */ const SHEBANG_PATTERN = '/^(#!.*)$/m'; /** * Loads and executes a PHP file. * * Note: because code is executed within a method, global variables need * to be explicitly globalized. * * ## OPTIONS * * <file> * : The path to the PHP file to execute. Use '-' to run code from STDIN. * * [<arg>...] * : One or more positional arguments to pass to the file. They are placed in the $args variable. * * [--skip-wordpress] * : Load and execute file without loading WordPress. * * [--use-include] * : Process the provided file via include instead of evaluating its contents. * * @when before_wp_load * * ## EXAMPLES * * # Execute file my-code.php and pass value1 and value2 arguments. * # Access arguments in $args array ($args[0] = value1, $args[1] = value2). * $ wp eval-file my-code.php value1 value2 */ public function __invoke( $args, $assoc_args ) { $file = array_shift( $args ); if ( '-' !== $file && ! file_exists( $file ) ) { WP_CLI::error( "'$file' does not exist." ); } $use_include = Utils\get_flag_value( $assoc_args, 'use-include', false ); if ( '-' === $file && $use_include ) { WP_CLI::error( '"-" and "--use-include" parameters cannot be used at the same time' ); } if ( null === Utils\get_flag_value( $assoc_args, 'skip-wordpress' ) ) { WP_CLI::get_runner()->load_wordpress(); } self::execute_eval( $file, $args, $use_include ); } /** * Evaluate a provided file. * * @param string $file Filepath to execute, or - for STDIN. * @param mixed $args Array of positional arguments to pass to the file. * @param bool $use_include Process the provided file via include instead of evaluating its contents. */ private static function execute_eval( $file, $args, $use_include ) { if ( '-' === $file ) { eval( '?>' . file_get_contents( 'php://stdin' ) ); } elseif ( $use_include ) { include $file; } else { $file_contents = file_get_contents( $file ); // Adjust for __FILE__ and __DIR__ magic constants. $file_contents = Utils\replace_path_consts( $file_contents, $file ); // Check for and remove she-bang. if ( 0 === strncmp( $file_contents, '#!', 2 ) ) { $file_contents = preg_replace( static::SHEBANG_PATTERN, '', $file_contents ); } eval( '?>' . $file_contents ); } } } <?php use WP_CLI\Utils; class Eval_Command extends WP_CLI_Command { /** * Executes arbitrary PHP code. * * Note: because code is executed within a method, global variables need * to be explicitly globalized. * * ## OPTIONS * * <php-code> * : The code to execute, as a string. * * [--skip-wordpress] * : Execute code without loading WordPress. * * ## EXAMPLES * * # Display WordPress content directory. * $ wp eval 'echo WP_CONTENT_DIR;' * /var/www/wordpress/wp-content * * # Generate a random number. * $ wp eval 'echo rand();' --skip-wordpress * 479620423 * * @when before_wp_load */ public function __invoke( $args, $assoc_args ) { if ( null === Utils\get_flag_value( $assoc_args, 'skip-wordpress' ) ) { WP_CLI::get_runner()->load_wordpress(); } eval( $args[0] ); } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_eval_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_eval_autoloader ) ) { require_once $wpcli_eval_autoloader; } WP_CLI::add_command( 'eval', 'Eval_Command' ); WP_CLI::add_command( 'eval-file', 'EvalFile_Command' ); <?php namespace WP_CLI\Embeds; use WP_CLI; use WP_CLI\Formatter; use WP_CLI\Utils; use WP_CLI_Command; /** * Retrieves oEmbed providers. * * ## EXAMPLES * * # List format,endpoint fields of available providers. * $ wp embed provider list * +------------------------------+-----------------------------------------+ * | format | endpoint | * +------------------------------+-----------------------------------------+ * | #https?://youtu\.be/.*#i | https://www.youtube.com/oembed | * | #https?://flic\.kr/.*#i | https://www.flickr.com/services/oembed/ | * | #https?://wordpress\.tv/.*#i | https://wordpress.tv/oembed/ | * * # Get the matching provider for the URL. * $ wp embed provider match https://www.youtube.com/watch?v=dQw4w9WgXcQ * https://www.youtube.com/oembed * * @package wp-cli */ class Provider_Command extends WP_CLI_Command { protected $default_fields = array( 'format', 'endpoint', ); /** * Lists all available oEmbed providers. * * ## OPTIONS * * [--field=<field>] * : Display the value of a single field * * [--fields=<fields>] * : Limit the output to specific fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * --- * * [--force-regex] * : Turn the asterisk-type provider URLs into regexes. * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each provider: * * * format * * endpoint * * This field is optionally available: * * * regex * * ## EXAMPLES * * # List format,endpoint fields of available providers. * $ wp embed provider list --fields=format,endpoint * +------------------------------+-----------------------------------------+ * | format | endpoint | * +------------------------------+-----------------------------------------+ * | #https?://youtu\.be/.*#i | https://www.youtube.com/oembed | * | #https?://flic\.kr/.*#i | https://www.flickr.com/services/oembed/ | * | #https?://wordpress\.tv/.*#i | https://wordpress.tv/oembed/ | * * @subcommand list */ public function list_providers( $args, $assoc_args ) { $oembed = new oEmbed(); $force_regex = Utils\get_flag_value( $assoc_args, 'force-regex' ); $providers = array(); foreach ( (array) $oembed->providers as $matchmask => $data ) { list( $providerurl, $regex ) = $data; // Turn the asterisk-type provider URLs into regex if ( $force_regex && ! $regex ) { $matchmask = '#' . str_replace( '___wildcard___', '(.+)', preg_quote( str_replace( '*', '___wildcard___', $matchmask ), '#' ) ) . '#i'; $matchmask = preg_replace( '|^#http\\\://|', '#https?\://', $matchmask ); } $providers[] = array( 'format' => $matchmask, 'endpoint' => $providerurl, 'regex' => $regex ? '1' : '0', ); } $formatter = $this->get_formatter( $assoc_args ); $formatter->display_items( $providers ); } /** * Gets the matching provider for a given URL. * * ## OPTIONS * * <url> * : URL to retrieve provider for. * * [--discover] * : Whether to use oEmbed discovery or not. Defaults to true. * * [--limit-response-size=<size>] * : Limit the size of the resulting HTML when using discovery. Default 150 KB (the standard WordPress limit). Not compatible with 'no-discover'. * * [--link-type=<json|xml>] * : Whether to accept only a certain link type when using discovery. Defaults to any (json or xml), preferring json. Not compatible with 'no-discover'. * --- * options: * - json * - xml * --- * * ## EXAMPLES * * # Get the matching provider for the URL. * $ wp embed provider match https://www.youtube.com/watch?v=dQw4w9WgXcQ * https://www.youtube.com/oembed * * @subcommand match */ public function match_provider( $args, $assoc_args ) { $oembed = new oEmbed(); $url = $args[0]; $discover = \WP_CLI\Utils\get_flag_value( $assoc_args, 'discover', true ); $response_size_limit = \WP_CLI\Utils\get_flag_value( $assoc_args, 'limit-response-size' ); $link_type = \WP_CLI\Utils\get_flag_value( $assoc_args, 'link-type' ); if ( ! $discover && ( null !== $response_size_limit || null !== $link_type ) ) { if ( null !== $response_size_limit && null !== $link_type ) { $msg = "The 'limit-response-size' and 'link-type' options can only be used with discovery."; } elseif ( null !== $response_size_limit ) { $msg = "The 'limit-response-size' option can only be used with discovery."; } else { $msg = "The 'link-type' option can only be used with discovery."; } WP_CLI::error( $msg ); } if ( $response_size_limit ) { if ( Utils\wp_version_compare( '4.0', '<' ) ) { WP_CLI::warning( "The 'limit-response-size' option only works for WordPress 4.0 onwards." ); // Fall through anyway... } add_filter( 'oembed_remote_get_args', function ( $args ) use ( $response_size_limit ) { $args['limit_response_size'] = $response_size_limit; return $args; } ); } if ( $link_type ) { // Filter discovery response. add_filter( 'oembed_linktypes', function ( $linktypes ) use ( $link_type ) { foreach ( $linktypes as $mime_type => $linktype_format ) { if ( $link_type !== $linktype_format ) { unset( $linktypes[ $mime_type ] ); } } return $linktypes; } ); } $oembed_args = array( 'discover' => $discover, ); $provider = $oembed->get_provider( $url, $oembed_args ); if ( ! $provider ) { if ( ! $discover ) { WP_CLI::error( 'No oEmbed provider found for given URL. Maybe try discovery?' ); } else { WP_CLI::error( 'No oEmbed provider found for given URL.' ); } } WP_CLI::line( $provider ); } /** * Get Formatter object based on supplied parameters. * * @param array $assoc_args Parameters passed to command. Determines formatting. * @return \WP_CLI\Formatter */ protected function get_formatter( &$assoc_args ) { return new Formatter( $assoc_args, $this->default_fields ); } } <?php namespace WP_CLI\Embeds; if ( ! class_exists( '\WP_oEmbed' ) ) { require_once ABSPATH . WPINC . '/class-oembed.php'; } /** * Polyfill for older WP versions. */ class oEmbed extends \WP_oEmbed { /** * Takes a URL and returns the corresponding oEmbed provider's URL, if there is one. * * @since 4.0.0 * * @see WP_oEmbed::discover() * * @param string $url The URL to the content. * @param string|array $args Optional provider arguments. * @return false|string False on failure, otherwise the oEmbed provider URL. */ public function get_provider( $url, $args = '' ) { if ( method_exists( 'WP_oEmbed', 'get_provider' ) ) { return parent::get_provider( $url, $args ); } $args = wp_parse_args( $args ); $provider = false; if ( ! isset( $args['discover'] ) ) { $args['discover'] = true; } foreach ( $this->providers as $matchmask => $data ) { list( $providerurl, $regex ) = $data; // Turn the asterisk-type provider URLs into regex if ( ! $regex ) { $matchmask = '#' . str_replace( '___wildcard___', '(.+)', preg_quote( str_replace( '*', '___wildcard___', $matchmask ), '#' ) ) . '#i'; $matchmask = preg_replace( '|^#http\\\://|', '#https?\://', $matchmask ); } if ( preg_match( $matchmask, $url ) ) { $provider = str_replace( '{format}', 'json', $providerurl ); // JSON is easier to deal with than XML break; } } if ( ! $provider && $args['discover'] ) { $provider = $this->discover( $url ); } return $provider; } } <?php namespace WP_CLI\Embeds; use WP_CLI; use WP_CLI\Formatter; use WP_CLI_Command; /** * Retrieves embed handlers. * * ## EXAMPLES * * # List id,regex,priority fields of available handlers. * $ wp embed handler list --fields=priority,id * +----------+-------------------+ * | priority | id | * +----------+-------------------+ * | 10 | youtube_embed_url | * | 9999 | audio | * | 9999 | video | * * @package wp-cli */ class Handler_Command extends WP_CLI_Command { protected $default_fields = array( 'id', 'regex', ); /** * Lists all available embed handlers. * * ## OPTIONS * * [--field=<field>] * : Display the value of a single field * * [--fields=<fields>] * : Limit the output to specific fields. * * [--format=<format>] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each handler: * * * id * * regex * * These fields are optionally available: * * * callback * * priority * * ## EXAMPLES * * # List id,regex,priority fields of available handlers. * $ wp embed handler list --fields=priority,id * +----------+-------------------+ * | priority | id | * +----------+-------------------+ * | 10 | youtube_embed_url | * | 9999 | audio | * | 9999 | video | * * @subcommand list */ public function list_handlers( $args, $assoc_args ) { /** @var \WP_Embed $wp_embed */ global $wp_embed; $all_handlers = array(); ksort( $wp_embed->handlers ); foreach ( $wp_embed->handlers as $priority => $handlers ) { foreach ( $handlers as $id => $handler ) { $all_handlers[] = array( 'id' => $id, 'regex' => $handler['regex'], 'callback' => $handler['callback'], 'priority' => $priority, ); } } $formatter = $this->get_formatter( $assoc_args ); $formatter->display_items( $all_handlers ); } /** * Get Formatter object based on supplied parameters. * * @param array $assoc_args Parameters passed to command. Determines formatting. * @return \WP_CLI\Formatter */ protected function get_formatter( &$assoc_args ) { return new Formatter( $assoc_args, $this->default_fields ); } } <?php namespace WP_CLI\Embeds; use WP_CLI\Dispatcher\CommandNamespace; /** * Inspects oEmbed providers, clears embed cache, and more. * * ## EXAMPLES * * # Get embed HTML for a given URL. * $ wp embed fetch https://www.youtube.com/watch?v=dQw4w9WgXcQ * <iframe width="525" height="295" src="https://www.youtube.com/embed/dQw4w9WgXcQ?feature=oembed" ... * * # Find cache post ID for a given URL. * $ wp embed cache find https://www.youtube.com/watch?v=dQw4w9WgXcQ --width=500 * 123 * * # List format,endpoint fields of available providers. * $ wp embed provider list * +------------------------------+-----------------------------------------+ * | format | endpoint | * +------------------------------+-----------------------------------------+ * | #https?://youtu\.be/.*#i | https://www.youtube.com/oembed | * | #https?://flic\.kr/.*#i | https://www.flickr.com/services/oembed/ | * | #https?://wordpress\.tv/.*#i | https://wordpress.tv/oembed/ | * * # List id,regex,priority fields of available handlers. * $ wp embed handler list --fields=priority,id * +----------+-------------------+ * | priority | id | * +----------+-------------------+ * | 10 | youtube_embed_url | * | 9999 | audio | * | 9999 | video | * +----------+-------------------+ * * @package wp-cli */ class Embeds_Namespace extends CommandNamespace { } <?php namespace WP_CLI\Embeds; use WP_CLI; use WP_CLI\Process; use WP_CLI\Utils; use WP_CLI\Formatter; use WP_CLI_Command; /** * Finds, triggers, and deletes oEmbed caches. * * ## EXAMPLES * * # Find cache post ID for a given URL. * $ wp embed cache find https://www.youtube.com/watch?v=dQw4w9WgXcQ --width=500 * 123 * * # Clear cache for a post. * $ wp embed cache clear 123 * Success: Cleared oEmbed cache. * * # Triggers cache for a post. * $ wp embed cache trigger 456 * Success: Caching triggered! * * @package wp-cli */ class Cache_Command extends WP_CLI_Command { /** * Deletes all oEmbed caches for a given post. * * oEmbed caches for a post are stored in the post's metadata. * * ## OPTIONS * * <post_id> * : ID of the post to clear the cache for. * * ## EXAMPLES * * # Clear cache for a post * $ wp embed cache clear 123 * Success: Cleared oEmbed cache. */ public function clear( $args, $assoc_args ) { /** @var \WP_Embed $wp_embed */ global $wp_embed; $post_id = $args[0]; $post_metas = get_post_custom_keys( $post_id ); if ( $post_metas ) { $post_metas = array_filter( $post_metas, function ( $v ) { return '_oembed_' === substr( $v, 0, 8 ); } ); } if ( empty( $post_metas ) ) { WP_CLI::error( 'No cache to clear!' ); } $wp_embed->delete_oembed_caches( $post_id ); WP_CLI::success( 'Cleared oEmbed cache.' ); } /** * Finds an oEmbed cache post ID for a given URL. * * Starting with WordPress 4.9, embeds that aren't associated with a specific post will be cached in * a new oembed_cache post type. There can be more than one such entry for a url depending on attributes and context. * * Not to be confused with oEmbed caches for a given post which are stored in the post's metadata. * * ## OPTIONS * * <url> * : URL to retrieve oEmbed data for. * * [--width=<width>] * : Width of the embed in pixels. Part of cache key so must match. Defaults to `content_width` if set else 500px, so is theme and context dependent. * * [--height=<height>] * : Height of the embed in pixels. Part of cache key so must match. Defaults to 1.5 * default width (`content_width` or 500px), to a maximum of 1000px. * * [--discover] * : Whether to search with the discover attribute set or not. Part of cache key so must match. If not given, will search with attribute: unset, '1', '0', returning first. * * ## EXAMPLES * * # Find cache post ID for a given URL. * $ wp embed cache find https://www.youtube.com/watch?v=dQw4w9WgXcQ --width=500 * 123 */ public function find( $args, $assoc_args ) { if ( Utils\wp_version_compare( '4.9', '<' ) ) { WP_CLI::error( 'Requires WordPress 4.9 or greater.' ); } /** @var \WP_Embed $wp_embed */ global $wp_embed; $url = $args[0]; $width = Utils\get_flag_value( $assoc_args, 'width' ); $height = Utils\get_flag_value( $assoc_args, 'height' ); $discover = Utils\get_flag_value( $assoc_args, 'discover' ); // The `$key_suffix` used for caching is part based on serializing the attributes array without normalizing it first so need to try to replicate that. $oembed_args = array(); if ( null !== $width ) { $oembed_args['width'] = $width; // Keep as string as if from a shortcode attribute. } if ( null !== $height ) { $oembed_args['height'] = $height; // Keep as string as if from a shortcode attribute. } if ( null !== $discover ) { $discovers = array( ( $discover ) ? '1' : '0' ); } else { $discovers = array( null, '1', '0' ); } $attr = wp_parse_args( $oembed_args, wp_embed_defaults( $url ) ); foreach ( $discovers as $discover ) { if ( null !== $discover ) { $attr['discover'] = $discover; } // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.serialize_serialize -- needed to mimic WP Core behavior. See: \WP_Embed::shortcode. $key_suffix = md5( $url . serialize( $attr ) ); $cached_post_id = $wp_embed->find_oembed_post_id( $key_suffix ); if ( $cached_post_id ) { WP_CLI::line( $cached_post_id ); return; } } WP_CLI::error( 'No cache post ID found!' ); } /** * Triggers the caching of all oEmbed results for a given post. * * oEmbed caches for a post are stored in the post's metadata. * * ## OPTIONS * * <post_id> * : ID of the post to do the caching for. * * ## EXAMPLES * * # Triggers cache for a post * $ wp embed cache trigger 456 * Success: Caching triggered! */ public function trigger( $args, $assoc_args ) { /** @var \WP_Embed $wp_embed */ global $wp_embed; $post_id = $args[0]; $post = get_post( $post_id ); $post_types = get_post_types( array( 'show_ui' => true ) ); if ( empty( $post->ID ) ) { WP_CLI::warning( sprintf( "Post id '%s' not found.", $post_id ) ); return; } /** This filter is documented in wp-includes/class-wp-embed.php */ // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Using WP Core hook. if ( ! in_array( $post->post_type, apply_filters( 'embed_cache_oembed_types', $post_types ), true ) ) { WP_CLI::warning( sprintf( "Cannot cache oEmbed results for '%s' post type", $post->post_type ) ); return; } $wp_embed->cache_oembed( $post_id ); WP_CLI::success( 'Caching triggered!' ); } } <?php namespace WP_CLI\Embeds; use WP_CLI; use WP_CLI\Utils; use WP_CLI_Command; class Fetch_Command extends WP_CLI_Command { /** * Attempts to convert a URL into embed HTML. * * In non-raw mode, starts by checking the URL against the regex of the registered embed handlers. * If none of the regex matches and it's enabled, then the URL will be given to the WP_oEmbed class. * * In raw mode, checks the providers directly and returns the data. * * ## OPTIONS * * <url> * : URL to retrieve oEmbed data for. * * [--width=<width>] * : Width of the embed in pixels. * * [--height=<height>] * : Height of the embed in pixels. * * [--post-id=<id>] * : Cache oEmbed response for a given post. * * [--discover] * : Enable oEmbed discovery. Defaults to true. * * [--skip-cache] * : Ignore already cached oEmbed responses. Has no effect if using the 'raw' option, which doesn't use the cache. * * [--skip-sanitization] * : Remove the filter that WordPress from 4.4 onwards uses to sanitize oEmbed responses. Has no effect if using the 'raw' option, which by-passes sanitization. * * [--do-shortcode] * : If the URL is handled by a registered embed handler and returns a shortcode, do shortcode and return result. Has no effect if using the 'raw' option, which by-passes handlers. * * [--limit-response-size=<size>] * : Limit the size of the resulting HTML when using discovery. Default 150 KB (the standard WordPress limit). Not compatible with 'no-discover'. * * [--raw] * : Return the raw oEmbed response instead of the resulting HTML. Ignores the cache and does not sanitize responses or use registered embed handlers. * * [--raw-format=<json|xml>] * : Render raw oEmbed data in a particular format. Defaults to json. Can only be specified in conjunction with the 'raw' option. * --- * options: * - json * - xml * --- * * ## EXAMPLES * * # Get embed HTML for a given URL. * $ wp embed fetch https://www.youtube.com/watch?v=dQw4w9WgXcQ * <iframe width="525" height="295" src="https://www.youtube.com/embed/dQw4w9WgXcQ?feature=oembed" ... * * # Get raw oEmbed data for a given URL. * $ wp embed fetch https://www.youtube.com/watch?v=dQw4w9WgXcQ --raw * {"author_url":"https:\/\/www.youtube.com\/user\/RickAstleyVEVO","width":525,"version":"1.0", ... */ public function __invoke( $args, $assoc_args ) { /** @var \WP_Embed $wp_embed */ global $wp_embed; $url = $args[0]; $raw = Utils\get_flag_value( $assoc_args, 'raw' ); $raw_format = Utils\get_flag_value( $assoc_args, 'raw-format' ); $post_id = Utils\get_flag_value( $assoc_args, 'post-id' ); $discover = Utils\get_flag_value( $assoc_args, 'discover' ); $response_size_limit = Utils\get_flag_value( $assoc_args, 'limit-response-size' ); $width = Utils\get_flag_value( $assoc_args, 'width' ); $height = Utils\get_flag_value( $assoc_args, 'height' ); // The `$key_suffix` used for caching is part based on serializing the attributes array without normalizing it first so need to try to replicate that. $oembed_args = array(); if ( null !== $width ) { $oembed_args['width'] = $width; // Keep as string as if from a shortcode attribute. } if ( null !== $height ) { $oembed_args['height'] = $height; // Keep as string as if from a shortcode attribute. } if ( null !== $discover ) { $oembed_args['discover'] = $discover ? '1' : '0'; // Make it a string as if from a shortcode attribute. } $discover = null === $discover ? true : (bool) $discover; // Will use to set `$oembed_args['discover']` when not calling `WP_Embed::shortcode()`. if ( ! $discover && null !== $response_size_limit ) { WP_CLI::error( "The 'limit-response-size' option can only be used with discovery." ); } if ( ! $raw && null !== $raw_format ) { WP_CLI::error( "The 'raw-format' option can only be used with the 'raw' option." ); } if ( $response_size_limit ) { if ( Utils\wp_version_compare( '4.0', '<' ) ) { WP_CLI::warning( "The 'limit-response-size' option only works for WordPress 4.0 onwards." ); // Fall through anyway... } add_filter( 'oembed_remote_get_args', function ( $args ) use ( $response_size_limit ) { $args['limit_response_size'] = $response_size_limit; return $args; }, PHP_INT_MAX ); } // If raw, query providers directly, by-passing cache. if ( $raw ) { $oembed = new oEmbed(); // Needs to be here to make sure `_wp_oembed_get_object()` defined (in "wp-includes/class-oembed.php" for WP < 4.7). $oembed_args['discover'] = $discover; // Make 'oembed_dataparse' filter a no-op so get raw unsanitized data. remove_all_filters( 'oembed_dataparse' ); // Save a few cycles. add_filter( 'oembed_dataparse', function ( $ret, $data, $url ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter return $data; }, PHP_INT_MAX, 3 ); // Allow `wp_filter_pre_oembed_result()` to provide local URLs (WP >= 4.5.3). // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Using WP Core hook. $data = apply_filters( 'pre_oembed_result', null, $url, $oembed_args ); if ( null === $data ) { $provider = $oembed->get_provider( $url, $oembed_args ); if ( ! $provider ) { if ( ! $discover ) { WP_CLI::error( 'No oEmbed provider found for given URL. Maybe try discovery?' ); } else { WP_CLI::error( 'No oEmbed provider found for given URL.' ); } } $data = $oembed->fetch( $provider, $url, $oembed_args ); } if ( false === $data ) { WP_CLI::error( 'There was an error fetching the oEmbed data.' ); } if ( 'xml' === $raw_format ) { if ( ! class_exists( 'SimpleXMLElement' ) ) { WP_CLI::error( "The PHP extension 'SimpleXMLElement' is not available but is required for XML-formatted output." ); } WP_CLI::log( $this->oembed_create_xml( (array) $data ) ); } else { WP_CLI::log( json_encode( $data ) ); } return; } if ( $post_id ) { // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- the request is asking for a post id directly so need to override the global. $GLOBALS['post'] = get_post( $post_id ); if ( null === $GLOBALS['post'] ) { WP_CLI::warning( sprintf( "Post id '%s' not found.", $post_id ) ); } } if ( Utils\get_flag_value( $assoc_args, 'skip-sanitization' ) ) { remove_filter( 'oembed_dataparse', 'wp_filter_oembed_result', 10, 3 ); } if ( Utils\get_flag_value( $assoc_args, 'skip-cache' ) ) { $wp_embed->usecache = false; // In order to skip caching, also need `$cached_recently` to be false in `WP_Embed::shortcode()`, so set TTL to zero. add_filter( 'oembed_ttl', '__return_zero', PHP_INT_MAX ); } else { $wp_embed->usecache = true; } // `WP_Embed::shortcode()` sets the 'discover' attribute based on 'embed_oembed_discover' filter, no matter what's passed to it. add_filter( 'embed_oembed_discover', $discover ? '__return_true' : '__return_false', PHP_INT_MAX ); // For WP < 4.9, `WP_Embed::shortcode()` won't check providers if no post_id supplied, so set `maybe_make_link()` to return false so can check and do it ourselves. // Also set if WP < 4.4 and don't have 'unfiltered_html' privileges on post. $check_providers = Utils\wp_version_compare( '4.9', '<' ) && ( ! $post_id || ( Utils\wp_version_compare( '4.4', '<' ) && ! author_can( $post_id, 'unfiltered_html' ) ) ); if ( $check_providers ) { add_filter( 'embed_maybe_make_link', '__return_false', PHP_INT_MAX ); } $html = $wp_embed->shortcode( $oembed_args, $url ); if ( false === $html && $check_providers ) { // Check providers. $oembed_args['discover'] = $discover; $html = wp_oembed_get( $url, $oembed_args ); // `wp_oembed_get()` returns zero-length string instead of false on failure due to `_strip_newlines()` 'oembed_dataparse' filter so make sure false. if ( '' === $html ) { $html = false; } } if ( false !== $html && '[' === substr( $html, 0, 1 ) && Utils\get_flag_value( $assoc_args, 'do-shortcode' ) ) { $html = do_shortcode( $html, true ); } if ( false === $html ) { WP_CLI::error( 'There was an error fetching the oEmbed data.' ); } WP_CLI::log( $html ); } /** * Creates an XML string from a given array. * * Same as `\_oembed_create_xml()` in "wp-includes\embed.php" introduced in WP 4.4.0. Polyfilled as marked private (and also to cater for older WP versions). * * @see _oembed_create_xml() * * @param array $data The original oEmbed response data. * @param \SimpleXMLElement $node Optional. XML node to append the result to recursively. * @return string|false XML string on success, false on error. */ protected function oembed_create_xml( $data, $node = null ) { if ( ! is_array( $data ) || empty( $data ) ) { return false; } if ( null === $node ) { $node = new \SimpleXMLElement( '<oembed></oembed>' ); } foreach ( $data as $key => $value ) { if ( is_numeric( $key ) ) { $key = 'oembed'; } if ( is_array( $value ) ) { $item = $node->addChild( $key ); $this->oembed_create_xml( $value, $item ); } else { $node->addChild( $key, esc_html( $value ) ); } } return $node->asXML(); } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_embed_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_embed_autoloader ) ) { require_once $wpcli_embed_autoloader; } if ( class_exists( 'WP_CLI\Dispatcher\CommandNamespace' ) ) { WP_CLI::add_command( 'embed', '\WP_CLI\Embeds\Embeds_Namespace' ); } WP_CLI::add_command( 'embed fetch', '\WP_CLI\Embeds\Fetch_Command' ); WP_CLI::add_command( 'embed provider', '\WP_CLI\Embeds\Provider_Command' ); WP_CLI::add_command( 'embed handler', '\WP_CLI\Embeds\Handler_Command' ); WP_CLI::add_command( 'embed cache', '\WP_CLI\Embeds\Cache_Command' ); <?php use WP_CLI\Utils; class Shell_Command extends WP_CLI_Command { /** * Opens an interactive PHP console for running and testing PHP code. * * `wp shell` allows you to evaluate PHP statements and expressions * interactively, from within a WordPress environment. Type a bit of code, * hit enter, and see the code execute right before you. Because WordPress * is loaded, you have access to all the functions, classes and globals * that you can use within a WordPress plugin, for example. * * ## OPTIONS * * [--basic] * : Force the use of WP-CLI's built-in PHP REPL, even if the Boris or * PsySH PHP REPLs are available. * * ## EXAMPLES * * # Call get_bloginfo() to get the name of the site. * $ wp shell * wp> get_bloginfo( 'name' ); * => string(6) "WP-CLI" */ public function __invoke( $_, $assoc_args ) { $implementations = array( 'Psy\\Shell', 'Boris\\Boris', 'WP_CLI\\Shell\\REPL', ); if ( Utils\get_flag_value( $assoc_args, 'basic' ) ) { $class = 'WP_CLI\\Shell\\REPL'; } else { foreach ( $implementations as $candidate ) { if ( class_exists( $candidate ) ) { $class = $candidate; break; } } } if ( 'Psy\\Shell' === $class ) { $shell = new Psy\Shell(); $shell->run(); } else { $repl = new $class( 'wp> ' ); $repl->start(); } } } <?php namespace WP_CLI\Shell; use WP_CLI; class REPL { private $prompt; private $history_file; public function __construct( $prompt ) { $this->prompt = $prompt; $this->set_history_file(); } public function start() { while ( true ) { $line = $this->prompt(); if ( '' === $line ) { continue; } $line = rtrim( $line, ';' ) . ';'; if ( self::starts_with( self::non_expressions(), $line ) ) { ob_start(); // phpcs:ignore Squiz.PHP.Eval.Discouraged -- This is meant to be a REPL, no way to avoid eval. eval( $line ); $out = ob_get_clean(); if ( 0 < strlen( $out ) ) { $out = rtrim( $out, "\n" ) . "\n"; } fwrite( STDOUT, $out ); } else { if ( ! self::starts_with( 'return', $line ) ) { $line = 'return ' . $line; } // Write directly to STDOUT, to sidestep any output buffers created by plugins ob_start(); // phpcs:ignore Squiz.PHP.Eval.Discouraged -- This is meant to be a REPL, no way to avoid eval. $evl = eval( $line ); $out = ob_get_clean(); if ( 0 < strlen( $out ) ) { echo rtrim( $out, "\n" ) . "\n"; } echo '=> '; var_dump( $evl ); fwrite( STDOUT, ob_get_clean() ); } } } private static function non_expressions() { return implode( '|', array( 'echo', 'global', 'unset', 'function', 'do', 'while', 'for', 'foreach', 'if', 'switch', 'include', 'include\_once', 'require', 'require\_once', ) ); } private function prompt() { $full_line = false; $done = false; do { $prompt = ( ! $done && false !== $full_line ) ? '--> ' : $this->prompt; $fp = popen( self::create_prompt_cmd( $prompt, $this->history_file ), 'r' ); $line = fgets( $fp ); pclose( $fp ); if ( ! $line ) { break; } $line = rtrim( $line, "\n" ); if ( $line && '\\' === $line[ strlen( $line ) - 1 ] ) { $line = substr( $line, 0, -1 ); } else { $done = true; } $full_line .= $line; } while ( ! $done ); if ( false === $full_line ) { return 'exit'; } return $full_line; } private static function create_prompt_cmd( $prompt, $history_path ) { $prompt = escapeshellarg( $prompt ); $history_path = escapeshellarg( $history_path ); if ( getenv( 'WP_CLI_CUSTOM_SHELL' ) ) { $shell_binary = getenv( 'WP_CLI_CUSTOM_SHELL' ); } else { $shell_binary = '/bin/bash'; } if ( ! is_file( $shell_binary ) || ! is_readable( $shell_binary ) ) { WP_CLI::error( "The shell binary '{$shell_binary}' is not valid. You can override the shell to be used through the WP_CLI_CUSTOM_SHELL environment variable." ); } $shell_binary = escapeshellarg( $shell_binary ); $cmd = 'set -f; ' . "history -r {$history_path}; " . 'LINE=""; ' . "read -re -p {$prompt} LINE; " . '[ $? -eq 0 ] || exit; ' . 'history -s "$LINE"; ' . "history -w {$history_path}; " . 'echo $LINE; '; return "{$shell_binary} -c " . escapeshellarg( $cmd ); } private function set_history_file() { $data = getcwd() . get_current_user(); $this->history_file = \WP_CLI\Utils\get_temp_dir() . 'wp-cli-history-' . md5( $data ); } private static function starts_with( $tokens, $line ) { return preg_match( "/^($tokens)[\(\s]+/", $line ); } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_shell_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_shell_autoloader ) ) { require_once $wpcli_shell_autoloader; } WP_CLI::add_command( 'shell', 'Shell_Command' ); <?php /** * Spyc -- A Simple PHP YAML Class * @version 0.6.2 * @author Vlad Andersen <vlad.andersen@gmail.com> * @author Chris Wanstrath <chris@ozmm.org> * @link https://github.com/mustangostang/spyc/ * @copyright Copyright 2005-2006 Chris Wanstrath, 2006-2011 Vlad Andersen * @license http://www.opensource.org/licenses/mit-license.php MIT License * @package Spyc */ if (!class_exists('Mustangostang\Spyc')) { require_once dirname(__FILE__) . '/src/Spyc.php'; } class_alias('Mustangostang\Spyc', 'Spyc'); require_once dirname(__FILE__) . '/includes/functions.php'; // Enable use of Spyc from command line // The syntax is the following: php Spyc.php spyc.yaml do { if (PHP_SAPI != 'cli') break; if (empty ($_SERVER['argc']) || $_SERVER['argc'] < 2) break; if (empty ($_SERVER['PHP_SELF']) || FALSE === strpos ($_SERVER['PHP_SELF'], 'Spyc.php') ) break; $file = $argv[1]; echo json_encode (spyc_load_file ($file)); } while (0); <?php php5to4 ("../spyc.php", 'spyc-latest.php4'); function php5to4 ($src, $dest) { $code = file_get_contents ($src); $code = preg_replace ('#(public|private|protected)\s+\$#i', 'var \$', $code); $code = preg_replace ('#(public|private|protected)\s+static\s+\$#i', 'var \$', $code); $code = preg_replace ('#(public|private|protected)\s+function#i', 'function', $code); $code = preg_replace ('#(public|private|protected)\s+static\s+function#i', 'function', $code); $code = preg_replace ('#throw new Exception\$([^)]*)\$#i', 'trigger_error($1,E_USER_ERROR)', $code); $code = str_replace ('self::', '$this->', $code); $f = fopen ($dest, 'w'); fwrite($f, $code); fclose ($f); print "Written to $dest.\n"; }<?php # # S P Y C # a simple php yaml class # v0.3 # # author: [chris wanstrath, chris@ozmm.org] # websites: [http://www.yaml.org, http://spyc.sourceforge.net/] # license: [MIT License, http://www.opensource.org/licenses/mit-license.php] # copyright: (c) 2005-2006 Chris Wanstrath # # We're gonna load a file into memory and see if we get what we expect. # If not, we're gonna complain. # # Pretty lo-fi. Let's see if we can't get some unit testing going in the next, # I dunno, 20 months? Alright. Go team. # error_reporting(E_ALL); include('spyc.php4'); $yaml = Spyc::YAMLLoad('../spyc.yaml'); // print_r ($yaml); # Added in .2 if ($yaml[1040] != "Ooo, a numeric key!") die('Key: 1040 failed'); # Test mappings / types if ($yaml['String'] != "Anyone's name, really.") die('Key: String failed'); if ($yaml['Int'] !== 13) die('Key: Int failed'); if ($yaml['True'] !== true) die('Key: True failed'); if ($yaml['False'] !== false) die('Key: False failed'); if ($yaml['Zero'] !== 0) die('Key: Zero failed'); if (isset($yaml['Null'])) die('Key: Null failed'); if ($yaml['Float'] !== 5.34) die('Key: Float failed'); # Test sequences if ($yaml[0] != "PHP Class") die('Sequence 0 failed'); if ($yaml[1] != "Basic YAML Loader") die('Sequence 1 failed'); if ($yaml[2] != "Very Basic YAML Dumper") die('Sequence 2 failed'); # A sequence of a sequence if ($yaml[3] != array("YAML is so easy to learn.", "Your config files will never be the same.")) die('Sequence 3 failed'); # Sequence of mappings if ($yaml[4] != array("cpu" => "1.5ghz", "ram" => "1 gig", "os" => "os x 10.4.1")) die('Sequence 4 failed'); # Mapped sequence if ($yaml['domains'] != array("yaml.org", "php.net")) die("Key: 'domains' failed"); # A sequence like this. if ($yaml[5] != array("program" => "Adium", "platform" => "OS X", "type" => "Chat Client")) die('Sequence 5 failed'); # A folded block as a mapped value if ($yaml['no time'] != "There isn't any time for your tricks!\nDo you understand?") die("Key: 'no time' failed"); # A literal block as a mapped value if ($yaml['some time'] != "There is nothing but time\nfor your tricks.") die("Key: 'some time' failed"); # Crazy combinations if ($yaml['databases'] != array( array("name" => "spartan", "notes" => array( "Needs to be backed up", "Needs to be normalized" ), "type" => "mysql" ))) die("Key: 'databases' failed"); # You can be a bit tricky if ($yaml["if: you'd"] != "like") die("Key: 'if: you\'d' failed"); # Inline sequences if ($yaml[6] != array("One", "Two", "Three", "Four")) die("Sequence 6 failed"); # Nested Inline Sequences if ($yaml[7] != array("One", array("Two", "And", "Three"), "Four", "Five")) die("Sequence 7 failed"); # Nested Nested Inline Sequences if ($yaml[8] != array( "This", array("Is", "Getting", array("Ridiculous", "Guys")), "Seriously", array("Show", "Mercy"))) die("Sequence 8 failed"); # Inline mappings if ($yaml[9] != array("name" => "chris", "age" => "young", "brand" => "lucky strike")) die("Sequence 9 failed"); # Nested inline mappings if ($yaml[10] != array("name" => "mark", "age" => "older than chris", "brand" => array("marlboro", "lucky strike"))) die("Sequence 10 failed"); # References -- they're shaky, but functional if ($yaml['dynamic languages'] != array('Perl', 'Python', 'PHP', 'Ruby')) die("Key: 'dynamic languages' failed"); if ($yaml['compiled languages'] != array('C/C++', 'Java')) die("Key: 'compiled languages' failed"); if ($yaml['all languages'] != array( array('Perl', 'Python', 'PHP', 'Ruby'), array('C/C++', 'Java') )) die("Key: 'all languages' failed"); # Added in .2.2: Escaped quotes if ($yaml[11] != "you know, this shouldn't work. but it does.") die("Sequence 11 failed."); if ($yaml[12] != "that's my value.") die("Sequence 12 failed."); if ($yaml[13] != "again, that's my value.") die("Sequence 13 failed."); if ($yaml[14] != "here's to \"quotes\", boss.") die("Sequence 14 failed."); if ($yaml[15] != array( 'name' => "Foo, Bar's", 'age' => 20)) die("Sequence 15 failed."); if ($yaml[16] != array( 0 => "a", 1 => array (0 => 1, 1 => 2), 2 => "b")) die("Sequence 16 failed."); if ($yaml['endloop'] != "Does this line in the end indeed make Spyc go to an infinite loop?") die("[endloop] failed."); print "spyc.yaml parsed correctly\n"; ?><?php /** * Spyc -- A Simple PHP YAML Class * @version 0.4.5 * @author Vlad Andersen <vlad.andersen@gmail.com> * @author Chris Wanstrath <chris@ozmm.org> * @link http://code.google.com/p/spyc/ * @copyright Copyright 2005-2006 Chris Wanstrath, 2006-2009 Vlad Andersen * @license http://www.opensource.org/licenses/mit-license.php MIT License * @package Spyc */ if (!function_exists('spyc_load')) { /** * Parses YAML to array. * @param string $string YAML string. * @return array */ function spyc_load ($string) { return Spyc::YAMLLoadString($string); } } if (!function_exists('spyc_load_file')) { /** * Parses YAML to array. * @param string $file Path to YAML file. * @return array */ function spyc_load_file ($file) { return Spyc::YAMLLoad($file); } } /** * The Simple PHP YAML Class. * * This class can be used to read a YAML file and convert its contents * into a PHP array. It currently supports a very limited subsection of * the YAML spec. * * Usage: * <code> * $Spyc = new Spyc; * $array = $Spyc->load($file); * </code> * or: * <code> * $array = Spyc::YAMLLoad($file); * </code> * or: * <code> * $array = spyc_load_file($file); * </code> * @package Spyc */ class Spyc { // SETTINGS /** * Setting this to true will force YAMLDump to enclose any string value in * quotes. False by default. * * @var bool */ var $setting_dump_force_quotes = false; /** * Setting this to true will forse YAMLLoad to use syck_load function when * possible. False by default. * @var bool */ var $setting_use_syck_is_possible = false; /**#@+ * @access private * @var mixed */ var $_dumpIndent; var $_dumpWordWrap; var $_containsGroupAnchor = false; var $_containsGroupAlias = false; var $path; var $result; var $LiteralPlaceHolder = '___YAML_Literal_Block___'; var $SavedGroups = array(); var $indent; /** * Path modifier that should be applied after adding current element. * @var array */ var $delayedPath = array(); /**#@+ * @access public * @var mixed */ var $_nodeId; /** * Load a valid YAML string to Spyc. * @param string $input * @return array */ function load ($input) { return $this->__loadString($input); } /** * Load a valid YAML file to Spyc. * @param string $file * @return array */ function loadFile ($file) { return $this->__load($file); } /** * Load YAML into a PHP array statically * * The load method, when supplied with a YAML stream (string or file), * will do its best to convert YAML in a file into a PHP array. Pretty * simple. * Usage: * <code> * $array = Spyc::YAMLLoad('lucky.yaml'); * print_r($array); * </code> * @access public * @return array * @param string $input Path of YAML file or string containing YAML */ function YAMLLoad($input) { $Spyc = new Spyc; return $Spyc->__load($input); } /** * Load a string of YAML into a PHP array statically * * The load method, when supplied with a YAML string, will do its best * to convert YAML in a string into a PHP array. Pretty simple. * * Note: use this function if you don't want files from the file system * loaded and processed as YAML. This is of interest to people concerned * about security whose input is from a string. * * Usage: * <code> * $array = Spyc::YAMLLoadString("---\n0: hello world\n"); * print_r($array); * </code> * @access public * @return array * @param string $input String containing YAML */ function YAMLLoadString($input) { $Spyc = new Spyc; return $Spyc->__loadString($input); } /** * Dump YAML from PHP array statically * * The dump method, when supplied with an array, will do its best * to convert the array into friendly YAML. Pretty simple. Feel free to * save the returned string as nothing.yaml and pass it around. * * Oh, and you can decide how big the indent is and what the wordwrap * for folding is. Pretty cool -- just pass in 'false' for either if * you want to use the default. * * Indent's default is 2 spaces, wordwrap's default is 40 characters. And * you can turn off wordwrap by passing in 0. * * @access public * @return string * @param array $array PHP array * @param int $indent Pass in false to use the default, which is 2 * @param int $wordwrap Pass in 0 for no wordwrap, false for default (40) */ function YAMLDump($array,$indent = false,$wordwrap = false) { $spyc = new Spyc; return $spyc->dump($array,$indent,$wordwrap); } /** * Dump PHP array to YAML * * The dump method, when supplied with an array, will do its best * to convert the array into friendly YAML. Pretty simple. Feel free to * save the returned string as tasteful.yaml and pass it around. * * Oh, and you can decide how big the indent is and what the wordwrap * for folding is. Pretty cool -- just pass in 'false' for either if * you want to use the default. * * Indent's default is 2 spaces, wordwrap's default is 40 characters. And * you can turn off wordwrap by passing in 0. * * @access public * @return string * @param array $array PHP array * @param int $indent Pass in false to use the default, which is 2 * @param int $wordwrap Pass in 0 for no wordwrap, false for default (40) */ function dump($array,$indent = false,$wordwrap = false) { // Dumps to some very clean YAML. We'll have to add some more features // and options soon. And better support for folding. // New features and options. if ($indent === false or !is_numeric($indent)) { $this->_dumpIndent = 2; } else { $this->_dumpIndent = $indent; } if ($wordwrap === false or !is_numeric($wordwrap)) { $this->_dumpWordWrap = 40; } else { $this->_dumpWordWrap = $wordwrap; } // New YAML document $string = "---\n"; // Start at the base of the array and move through it. if ($array) { $array = (array)$array; $first_key = key($array); $previous_key = -1; foreach ($array as $key => $value) { $string .= $this->_yamlize($key,$value,0,$previous_key, $first_key); $previous_key = $key; } } return $string; } /** * Attempts to convert a key / value array item to YAML * @access private * @return string * @param $key The name of the key * @param $value The value of the item * @param $indent The indent of the current node */ function _yamlize($key,$value,$indent, $previous_key = -1, $first_key = 0) { if (is_array($value)) { if (empty ($value)) return $this->_dumpNode($key, array(), $indent, $previous_key, $first_key); // It has children. What to do? // Make it the right kind of item $string = $this->_dumpNode($key, NULL, $indent, $previous_key, $first_key); // Add the indent $indent += $this->_dumpIndent; // Yamlize the array $string .= $this->_yamlizeArray($value,$indent); } elseif (!is_array($value)) { // It doesn't have children. Yip. $string = $this->_dumpNode($key, $value, $indent, $previous_key, $first_key); } return $string; } /** * Attempts to convert an array to YAML * @access private * @return string * @param $array The array you want to convert * @param $indent The indent of the current level */ function _yamlizeArray($array,$indent) { if (is_array($array)) { $string = ''; $previous_key = -1; $first_key = key($array); foreach ($array as $key => $value) { $string .= $this->_yamlize($key, $value, $indent, $previous_key, $first_key); $previous_key = $key; } return $string; } else { return false; } } /** * Returns YAML from a key and a value * @access private * @return string * @param $key The name of the key * @param $value The value of the item * @param $indent The indent of the current node */ function _dumpNode($key, $value, $indent, $previous_key = -1, $first_key = 0) { // do some folding here, for blocks if (is_string ($value) && ((strpos($value,"\n") !== false || strpos($value,": ") !== false || strpos($value,"- ") !== false || strpos($value,"*") !== false || strpos($value,"#") !== false || strpos($value,"<") !== false || strpos($value,">") !== false || strpos($value,"[") !== false || strpos($value,"]") !== false || strpos($value,"{") !== false || strpos($value,"}") !== false) || substr ($value, -1, 1) == ':')) { $value = $this->_doLiteralBlock($value,$indent); } else { $value = $this->_doFolding($value,$indent); if (is_bool($value)) { $value = ($value) ? "true" : "false"; } } if ($value === array()) $value = '[ ]'; $spaces = str_repeat(' ',$indent); if (is_int($key) && $key - 1 == $previous_key && $first_key===0) { // It's a sequence $string = $spaces.'- '.$value."\n"; } else { if ($first_key===0) throw new Exception('Keys are all screwy. The first one was zero, now it\'s "'. $key .'"'); // It's mapped if (strpos($key, ":") !== false) { $key = '"' . $key . '"'; } $string = $spaces.$key.': '.$value."\n"; } return $string; } /** * Creates a literal block for dumping * @access private * @return string * @param $value * @param $indent int The value of the indent */ function _doLiteralBlock($value,$indent) { if (strpos($value, "\n") === false && strpos($value, "'") === false) { return sprintf ("'%s'", $value); } if (strpos($value, "\n") === false && strpos($value, '"') === false) { return sprintf ('"%s"', $value); } $exploded = explode("\n",$value); $newValue = '|'; $indent += $this->_dumpIndent; $spaces = str_repeat(' ',$indent); foreach ($exploded as $line) { $newValue .= "\n" . $spaces . trim($line); } return $newValue; } /** * Folds a string of text, if necessary * @access private * @return string * @param $value The string you wish to fold */ function _doFolding($value,$indent) { // Don't do anything if wordwrap is set to 0 if ($this->_dumpWordWrap !== 0 && is_string ($value) && strlen($value) > $this->_dumpWordWrap) { $indent += $this->_dumpIndent; $indent = str_repeat(' ',$indent); $wrapped = wordwrap($value,$this->_dumpWordWrap,"\n$indent"); $value = ">\n".$indent.$wrapped; } else { if ($this->setting_dump_force_quotes && is_string ($value)) $value = '"' . $value . '"'; } return $value; } // LOADING FUNCTIONS function __load($input) { $Source = $this->loadFromSource($input); return $this->loadWithSource($Source); } function __loadString($input) { $Source = $this->loadFromString($input); return $this->loadWithSource($Source); } function loadWithSource($Source) { if (empty ($Source)) return array(); if ($this->setting_use_syck_is_possible && function_exists ('syck_load')) { $array = syck_load (implode ('', $Source)); return is_array($array) ? $array : array(); } $this->path = array(); $this->result = array(); $cnt = count($Source); for ($i = 0; $i < $cnt; $i++) { $line = $Source[$i]; $this->indent = strlen($line) - strlen(ltrim($line)); $tempPath = $this->getParentPathByIndent($this->indent); $line = $this->stripIndent($line, $this->indent); if ($this->isComment($line)) continue; if ($this->isEmpty($line)) continue; $this->path = $tempPath; $literalBlockStyle = $this->startsLiteralBlock($line); if ($literalBlockStyle) { $line = rtrim ($line, $literalBlockStyle . " \n"); $literalBlock = ''; $line .= $this->LiteralPlaceHolder; while (++$i < $cnt && $this->literalBlockContinues($Source[$i], $this->indent)) { $literalBlock = $this->addLiteralLine($literalBlock, $Source[$i], $literalBlockStyle); } $i--; } while (++$i < $cnt && $this->greedilyNeedNextLine($line)) { $line = rtrim ($line, " \n\t\r") . ' ' . ltrim ($Source[$i], " \t"); } $i--; if (strpos ($line, '#')) { if (strpos ($line, '"') === false && strpos ($line, "'") === false) $line = preg_replace('/\s+#(.+)$/','',$line); } $lineArray = $this->_parseLine($line); if ($literalBlockStyle) $lineArray = $this->revertLiteralPlaceHolder ($lineArray, $literalBlock); $this->addArray($lineArray, $this->indent); foreach ($this->delayedPath as $indent => $delayedPath) $this->path[$indent] = $delayedPath; $this->delayedPath = array(); } return $this->result; } function loadFromSource ($input) { if (!empty($input) && strpos($input, "\n") === false && file_exists($input)) return file($input); return $this->loadFromString($input); } function loadFromString ($input) { $lines = explode("\n",$input); foreach ($lines as $k => $_) { $lines[$k] = rtrim ($_, "\r"); } return $lines; } /** * Parses YAML code and returns an array for a node * @access private * @return array * @param string $line A line from the YAML file */ function _parseLine($line) { if (!$line) return array(); $line = trim($line); if (!$line) return array(); $array = array(); $group = $this->nodeContainsGroup($line); if ($group) { $this->addGroup($line, $group); $line = $this->stripGroup ($line, $group); } if ($this->startsMappedSequence($line)) return $this->returnMappedSequence($line); if ($this->startsMappedValue($line)) return $this->returnMappedValue($line); if ($this->isArrayElement($line)) return $this->returnArrayElement($line); if ($this->isPlainArray($line)) return $this->returnPlainArray($line); return $this->returnKeyValuePair($line); } /** * Finds the type of the passed value, returns the value as the new type. * @access private * @param string $value * @return mixed */ function _toType($value) { if ($value === '') return null; $first_character = $value[0]; $last_character = substr($value, -1, 1); $is_quoted = false; do { if (!$value) break; if ($first_character != '"' && $first_character != "'") break; if ($last_character != '"' && $last_character != "'") break; $is_quoted = true; } while (0); if ($is_quoted) return strtr(substr ($value, 1, -1), array ('\\"' => '"', '\'\'' => '\'', '\\\'' => '\'')); if (strpos($value, ' #') !== false) $value = preg_replace('/\s+#(.+)$/','',$value); if ($first_character == '[' && $last_character == ']') { // Take out strings sequences and mappings $innerValue = trim(substr ($value, 1, -1)); if ($innerValue === '') return array(); $explode = $this->_inlineEscape($innerValue); // Propagate value array $value = array(); foreach ($explode as $v) { $value[] = $this->_toType($v); } return $value; } if (strpos($value,': ')!==false && $first_character != '{') { $array = explode(': ',$value); $key = trim($array[0]); array_shift($array); $value = trim(implode(': ',$array)); $value = $this->_toType($value); return array($key => $value); } if ($first_character == '{' && $last_character == '}') { $innerValue = trim(substr ($value, 1, -1)); if ($innerValue === '') return array(); // Inline Mapping // Take out strings sequences and mappings $explode = $this->_inlineEscape($innerValue); // Propagate value array $array = array(); foreach ($explode as $v) { $SubArr = $this->_toType($v); if (empty($SubArr)) continue; if (is_array ($SubArr)) { $array[key($SubArr)] = $SubArr[key($SubArr)]; continue; } $array[] = $SubArr; } return $array; } if ($value == 'null' || $value == 'NULL' || $value == 'Null' || $value == '' || $value == '~') { return null; } if (intval($first_character) > 0 && preg_match ('/^[1-9]+[0-9]*$/', $value)) { $intvalue = (int)$value; if ($intvalue != PHP_INT_MAX) $value = $intvalue; return $value; } if (in_array($value, array('true', 'on', '+', 'yes', 'y', 'True', 'TRUE', 'On', 'ON', 'YES', 'Yes', 'Y'))) { return true; } if (in_array(strtolower($value), array('false', 'off', '-', 'no', 'n'))) { return false; } if (is_numeric($value)) { if ($value === '0') return 0; if (trim ($value, 0) === $value) $value = (float)$value; return $value; } return $value; } /** * Used in inlines to check for more inlines or quoted strings * @access private * @return array */ function _inlineEscape($inline) { // There's gotta be a cleaner way to do this... // While pure sequences seem to be nesting just fine, // pure mappings and mappings with sequences inside can't go very // deep. This needs to be fixed. $seqs = array(); $maps = array(); $saved_strings = array(); // Check for strings $regex = '/(?:(")|(?:\'))((?(1)[^"]+|[^\']+))(?(1)"|\')/'; if (preg_match_all($regex,$inline,$strings)) { $saved_strings = $strings[0]; $inline = preg_replace($regex,'YAMLString',$inline); } unset($regex); $i = 0; do { // Check for sequences while (preg_match('/\[([^{}\[\]]+)\]/U',$inline,$matchseqs)) { $seqs[] = $matchseqs[0]; $inline = preg_replace('/\[([^{}\[\]]+)\]/U', ('YAMLSeq' . (count($seqs) - 1) . 's'), $inline, 1); } // Check for mappings while (preg_match('/{([^\[\]{}]+)}/U',$inline,$matchmaps)) { $maps[] = $matchmaps[0]; $inline = preg_replace('/{([^\[\]{}]+)}/U', ('YAMLMap' . (count($maps) - 1) . 's'), $inline, 1); } if ($i++ >= 10) break; } while (strpos ($inline, '[') !== false || strpos ($inline, '{') !== false); $explode = explode(', ',$inline); $stringi = 0; $i = 0; while (1) { // Re-add the sequences if (!empty($seqs)) { foreach ($explode as $key => $value) { if (strpos($value,'YAMLSeq') !== false) { foreach ($seqs as $seqk => $seq) { $explode[$key] = str_replace(('YAMLSeq'.$seqk.'s'),$seq,$value); $value = $explode[$key]; } } } } // Re-add the mappings if (!empty($maps)) { foreach ($explode as $key => $value) { if (strpos($value,'YAMLMap') !== false) { foreach ($maps as $mapk => $map) { $explode[$key] = str_replace(('YAMLMap'.$mapk.'s'), $map, $value); $value = $explode[$key]; } } } } // Re-add the strings if (!empty($saved_strings)) { foreach ($explode as $key => $value) { while (strpos($value,'YAMLString') !== false) { $explode[$key] = preg_replace('/YAMLString/',$saved_strings[$stringi],$value, 1); unset($saved_strings[$stringi]); ++$stringi; $value = $explode[$key]; } } } $finished = true; foreach ($explode as $key => $value) { if (strpos($value,'YAMLSeq') !== false) { $finished = false; break; } if (strpos($value,'YAMLMap') !== false) { $finished = false; break; } if (strpos($value,'YAMLString') !== false) { $finished = false; break; } } if ($finished) break; $i++; if ($i > 10) break; // Prevent infinite loops. } return $explode; } function literalBlockContinues ($line, $lineIndent) { if (!trim($line)) return true; if (strlen($line) - strlen(ltrim($line)) > $lineIndent) return true; return false; } function referenceContentsByAlias ($alias) { do { if (!isset($this->SavedGroups[$alias])) { echo "Bad group name: $alias."; break; } $groupPath = $this->SavedGroups[$alias]; $value = $this->result; foreach ($groupPath as $k) { $value = $value[$k]; } } while (false); return $value; } function addArrayInline ($array, $indent) { $CommonGroupPath = $this->path; if (empty ($array)) return false; foreach ($array as $k => $_) { $this->addArray(array($k => $_), $indent); $this->path = $CommonGroupPath; } return true; } function addArray ($incoming_data, $incoming_indent) { // print_r ($incoming_data); if (count ($incoming_data) > 1) return $this->addArrayInline ($incoming_data, $incoming_indent); $key = key ($incoming_data); $value = isset($incoming_data[$key]) ? $incoming_data[$key] : null; if ($key === '__!YAMLZero') $key = '0'; if ($incoming_indent == 0 && !$this->_containsGroupAlias && !$this->_containsGroupAnchor) { // Shortcut for root-level values. if ($key || $key === '' || $key === '0') { $this->result[$key] = $value; } else { $this->result[] = $value; end ($this->result); $key = key ($this->result); } $this->path[$incoming_indent] = $key; return; } $history = array(); // Unfolding inner array tree. $history[] = $_arr = $this->result; foreach ($this->path as $k) { $history[] = $_arr = $_arr[$k]; } if ($this->_containsGroupAlias) { $value = $this->referenceContentsByAlias($this->_containsGroupAlias); $this->_containsGroupAlias = false; } // Adding string or numeric key to the innermost level or $this->arr. if (is_string($key) && $key == '<<') { if (!is_array ($_arr)) { $_arr = array (); } $_arr = array_merge ($_arr, $value); } else if ($key || $key === '' || $key === '0') { $_arr[$key] = $value; } else { if (!is_array ($_arr)) { $_arr = array ($value); $key = 0; } else { $_arr[] = $value; end ($_arr); $key = key ($_arr); } } $reverse_path = array_reverse($this->path); $reverse_history = array_reverse ($history); $reverse_history[0] = $_arr; $cnt = count($reverse_history) - 1; for ($i = 0; $i < $cnt; $i++) { $reverse_history[$i+1][$reverse_path[$i]] = $reverse_history[$i]; } $this->result = $reverse_history[$cnt]; $this->path[$incoming_indent] = $key; if ($this->_containsGroupAnchor) { $this->SavedGroups[$this->_containsGroupAnchor] = $this->path; if (is_array ($value)) { $k = key ($value); if (!is_int ($k)) { $this->SavedGroups[$this->_containsGroupAnchor][$incoming_indent + 2] = $k; } } $this->_containsGroupAnchor = false; } } function startsLiteralBlock ($line) { $lastChar = substr (trim($line), -1); if ($lastChar != '>' && $lastChar != '|') return false; if ($lastChar == '|') return $lastChar; // HTML tags should not be counted as literal blocks. if (preg_match ('#<.*?>$#', $line)) return false; return $lastChar; } function greedilyNeedNextLine($line) { $line = trim ($line); if (!strlen($line)) return false; if (substr ($line, -1, 1) == ']') return false; if ($line[0] == '[') return true; if (preg_match ('#^[^:]+?:\s*\[#', $line)) return true; return false; } function addLiteralLine ($literalBlock, $line, $literalBlockStyle) { $line = $this->stripIndent($line); $line = rtrim ($line, "\r\n\t ") . "\n"; if ($literalBlockStyle == '|') { return $literalBlock . $line; } if (strlen($line) == 0) return rtrim($literalBlock, ' ') . "\n"; if ($line == "\n" && $literalBlockStyle == '>') { return rtrim ($literalBlock, " \t") . "\n"; } if ($line != "\n") $line = trim ($line, "\r\n ") . " "; return $literalBlock . $line; } function revertLiteralPlaceHolder ($lineArray, $literalBlock) { foreach ($lineArray as $k => $_) { if (is_array($_)) $lineArray[$k] = $this->revertLiteralPlaceHolder ($_, $literalBlock); else if (substr($_, -1 * strlen ($this->LiteralPlaceHolder)) == $this->LiteralPlaceHolder) $lineArray[$k] = rtrim ($literalBlock, " \r\n"); } return $lineArray; } function stripIndent ($line, $indent = -1) { if ($indent == -1) $indent = strlen($line) - strlen(ltrim($line)); return substr ($line, $indent); } function getParentPathByIndent ($indent) { if ($indent == 0) return array(); $linePath = $this->path; do { end($linePath); $lastIndentInParentPath = key($linePath); if ($indent <= $lastIndentInParentPath) array_pop ($linePath); } while ($indent <= $lastIndentInParentPath); return $linePath; } function clearBiggerPathValues ($indent) { if ($indent == 0) $this->path = array(); if (empty ($this->path)) return true; foreach ($this->path as $k => $_) { if ($k > $indent) unset ($this->path[$k]); } return true; } function isComment ($line) { if (!$line) return false; if ($line[0] == '#') return true; if (trim($line, " \r\n\t") == '---') return true; return false; } function isEmpty ($line) { return (trim ($line) === ''); } function isArrayElement ($line) { if (!$line) return false; if ($line[0] != '-') return false; if (strlen ($line) > 3) if (substr($line,0,3) == '---') return false; return true; } function isHashElement ($line) { return strpos($line, ':'); } function isLiteral ($line) { if ($this->isArrayElement($line)) return false; if ($this->isHashElement($line)) return false; return true; } function unquote ($value) { if (!$value) return $value; if (!is_string($value)) return $value; if ($value[0] == '\'') return trim ($value, '\''); if ($value[0] == '"') return trim ($value, '"'); return $value; } function startsMappedSequence ($line) { return ($line[0] == '-' && substr ($line, -1, 1) == ':'); } function returnMappedSequence ($line) { $array = array(); $key = $this->unquote(trim(substr($line,1,-1))); $array[$key] = array(); $this->delayedPath = array(strpos ($line, $key) + $this->indent => $key); return array($array); } function returnMappedValue ($line) { $array = array(); $key = $this->unquote (trim(substr($line,0,-1))); $array[$key] = ''; return $array; } function startsMappedValue ($line) { return (substr ($line, -1, 1) == ':'); } function isPlainArray ($line) { return ($line[0] == '[' && substr ($line, -1, 1) == ']'); } function returnPlainArray ($line) { return $this->_toType($line); } function returnKeyValuePair ($line) { $array = array(); $key = ''; if (strpos ($line, ':')) { // It's a key/value pair most likely // If the key is in double quotes pull it out if (($line[0] == '"' || $line[0] == "'") && preg_match('/^(["\'](.*)["\'](\s)*:)/',$line,$matches)) { $value = trim(str_replace($matches[1],'',$line)); $key = $matches[2]; } else { // Do some guesswork as to the key and the value $explode = explode(':',$line); $key = trim($explode[0]); array_shift($explode); $value = trim(implode(':',$explode)); } // Set the type of the value. Int, string, etc $value = $this->_toType($value); if ($key === '0') $key = '__!YAMLZero'; $array[$key] = $value; } else { $array = array ($line); } return $array; } function returnArrayElement ($line) { if (strlen($line) <= 1) return array(array()); // Weird %) $array = array(); $value = trim(substr($line,1)); $value = $this->_toType($value); $array[] = $value; return $array; } function nodeContainsGroup ($line) { $symbolsForReference = 'A-z0-9_\-'; if (strpos($line, '&') === false && strpos($line, '*') === false) return false; // Please die fast ;-) if ($line[0] == '&' && preg_match('/^(&['.$symbolsForReference.']+)/', $line, $matches)) return $matches[1]; if ($line[0] == '*' && preg_match('/^(\*['.$symbolsForReference.']+)/', $line, $matches)) return $matches[1]; if (preg_match('/(&['.$symbolsForReference.']+)$/', $line, $matches)) return $matches[1]; if (preg_match('/(\*['.$symbolsForReference.']+$)/', $line, $matches)) return $matches[1]; if (preg_match ('#^\s*<<\s*:\s*(\*[^\s]+).*$#', $line, $matches)) return $matches[1]; return false; } function addGroup ($line, $group) { if ($group[0] == '&') $this->_containsGroupAnchor = substr ($group, 1); if ($group[0] == '*') $this->_containsGroupAlias = substr ($group, 1); //print_r ($this->path); } function stripGroup ($line, $group) { $line = trim(str_replace($group, '', $line)); return $line; } } // Enable use of Spyc from command line // The syntax is the following: php spyc.php spyc.yaml define ('SPYC_FROM_COMMAND_LINE', false); do { if (!SPYC_FROM_COMMAND_LINE) break; if (empty ($_SERVER['argc']) || $_SERVER['argc'] < 2) break; if (empty ($_SERVER['PHP_SELF']) || $_SERVER['PHP_SELF'] != 'spyc.php') break; $file = $argv[1]; printf ("Spyc loading file: %s\n", $file); print_r (spyc_load_file ($file)); } while (0);<?php namespace Mustangostang; /** * Spyc -- A Simple PHP YAML Class * @version 0.6.2 * @author Vlad Andersen <vlad.andersen@gmail.com> * @author Chris Wanstrath <chris@ozmm.org> * @link https://github.com/mustangostang/spyc/ * @copyright Copyright 2005-2006 Chris Wanstrath, 2006-2011 Vlad Andersen * @license http://www.opensource.org/licenses/mit-license.php MIT License * @package Spyc */ /** * The Simple PHP YAML Class. * * This class can be used to read a YAML file and convert its contents * into a PHP array. It currently supports a very limited subsection of * the YAML spec. * * Usage: * <code> * $Spyc = new Spyc; * $array = $Spyc->load($file); * </code> * or: * <code> * $array = Spyc::YAMLLoad($file); * </code> * or: * <code> * $array = spyc_load_file($file); * </code> * @package Spyc */ class Spyc { // SETTINGS const REMPTY = "\0\0\0\0\0"; /** * Setting this to true will force YAMLDump to enclose any string value in * quotes. False by default. * * @var bool */ public $setting_dump_force_quotes = false; /** * Setting this to true will forse YAMLLoad to use syck_load function when * possible. False by default. * @var bool */ public $setting_use_syck_is_possible = false; /**#@+ * @access private * @var mixed */ private $_dumpIndent; private $_dumpWordWrap; private $_containsGroupAnchor = false; private $_containsGroupAlias = false; private $path; private $result; private $LiteralPlaceHolder = '___YAML_Literal_Block___'; private $SavedGroups = array(); private $indent; /** * Path modifier that should be applied after adding current element. * @var array */ private $delayedPath = array(); /**#@+ * @access public * @var mixed */ public $_nodeId; /** * Load a valid YAML string to Spyc. * @param string $input * @return array */ public function load ($input) { return $this->_loadString($input); } /** * Load a valid YAML file to Spyc. * @param string $file * @return array */ public function loadFile ($file) { return $this->_load($file); } /** * Load YAML into a PHP array statically * * The load method, when supplied with a YAML stream (string or file), * will do its best to convert YAML in a file into a PHP array. Pretty * simple. * Usage: * <code> * $array = Spyc::YAMLLoad('lucky.yaml'); * print_r($array); * </code> * @access public * @return array * @param string $input Path of YAML file or string containing YAML */ public static function YAMLLoad($input) { $Spyc = new Spyc; return $Spyc->_load($input); } /** * Load a string of YAML into a PHP array statically * * The load method, when supplied with a YAML string, will do its best * to convert YAML in a string into a PHP array. Pretty simple. * * Note: use this function if you don't want files from the file system * loaded and processed as YAML. This is of interest to people concerned * about security whose input is from a string. * * Usage: * <code> * $array = Spyc::YAMLLoadString("---\n0: hello world\n"); * print_r($array); * </code> * @access public * @return array * @param string $input String containing YAML */ public static function YAMLLoadString($input) { $Spyc = new Spyc; return $Spyc->_loadString($input); } /** * Dump YAML from PHP array statically * * The dump method, when supplied with an array, will do its best * to convert the array into friendly YAML. Pretty simple. Feel free to * save the returned string as nothing.yaml and pass it around. * * Oh, and you can decide how big the indent is and what the wordwrap * for folding is. Pretty cool -- just pass in 'false' for either if * you want to use the default. * * Indent's default is 2 spaces, wordwrap's default is 40 characters. And * you can turn off wordwrap by passing in 0. * * @access public * @return string * @param array|\stdClass $array PHP array * @param int $indent Pass in false to use the default, which is 2 * @param int $wordwrap Pass in 0 for no wordwrap, false for default (40) * @param bool $no_opening_dashes Do not start YAML file with "---\n" */ public static function YAMLDump($array, $indent = false, $wordwrap = false, $no_opening_dashes = false) { $spyc = new Spyc; return $spyc->dump($array, $indent, $wordwrap, $no_opening_dashes); } /** * Dump PHP array to YAML * * The dump method, when supplied with an array, will do its best * to convert the array into friendly YAML. Pretty simple. Feel free to * save the returned string as tasteful.yaml and pass it around. * * Oh, and you can decide how big the indent is and what the wordwrap * for folding is. Pretty cool -- just pass in 'false' for either if * you want to use the default. * * Indent's default is 2 spaces, wordwrap's default is 40 characters. And * you can turn off wordwrap by passing in 0. * * @access public * @return string * @param array $array PHP array * @param int $indent Pass in false to use the default, which is 2 * @param int $wordwrap Pass in 0 for no wordwrap, false for default (40) */ public function dump($array,$indent = false,$wordwrap = false, $no_opening_dashes = false) { // Dumps to some very clean YAML. We'll have to add some more features // and options soon. And better support for folding. // New features and options. if ($indent === false or !is_numeric($indent)) { $this->_dumpIndent = 2; } else { $this->_dumpIndent = $indent; } if ($wordwrap === false or !is_numeric($wordwrap)) { $this->_dumpWordWrap = 40; } else { $this->_dumpWordWrap = $wordwrap; } // New YAML document $string = ""; if (!$no_opening_dashes) $string = "---\n"; // Start at the base of the array and move through it. if ($array) { $array = (array)$array; $previous_key = -1; foreach ($array as $key => $value) { if (!isset($first_key)) $first_key = $key; $string .= $this->_yamlize($key,$value,0,$previous_key, $first_key, $array); $previous_key = $key; } } return $string; } /** * Attempts to convert a key / value array item to YAML * @access private * @return string * @param $key The name of the key * @param $value The value of the item * @param $indent The indent of the current node */ private function _yamlize($key,$value,$indent, $previous_key = -1, $first_key = 0, $source_array = null) { if(is_object($value)) $value = (array)$value; if (is_array($value)) { if (empty ($value)) return $this->_dumpNode($key, array(), $indent, $previous_key, $first_key, $source_array); // It has children. What to do? // Make it the right kind of item $string = $this->_dumpNode($key, self::REMPTY, $indent, $previous_key, $first_key, $source_array); // Add the indent $indent += $this->_dumpIndent; // Yamlize the array $string .= $this->_yamlizeArray($value,$indent); } elseif (!is_array($value)) { // It doesn't have children. Yip. $string = $this->_dumpNode($key, $value, $indent, $previous_key, $first_key, $source_array); } return $string; } /** * Attempts to convert an array to YAML * @access private * @return string * @param $array The array you want to convert * @param $indent The indent of the current level */ private function _yamlizeArray($array,$indent) { if (is_array($array)) { $string = ''; $previous_key = -1; foreach ($array as $key => $value) { if (!isset($first_key)) $first_key = $key; $string .= $this->_yamlize($key, $value, $indent, $previous_key, $first_key, $array); $previous_key = $key; } return $string; } else { return false; } } /** * Returns YAML from a key and a value * @access private * @return string * @param $key The name of the key * @param $value The value of the item * @param $indent The indent of the current node */ private function _dumpNode($key, $value, $indent, $previous_key = -1, $first_key = 0, $source_array = null) { // do some folding here, for blocks if (is_string ($value) && ((strpos($value,"\n") !== false || strpos($value,": ") !== false || strpos($value,"- ") !== false || strpos($value,"*") !== false || strpos($value,"#") !== false || strpos($value,"<") !== false || strpos($value,">") !== false || strpos ($value, '%') !== false || strpos ($value, ' ') !== false || strpos($value,"[") !== false || strpos($value,"]") !== false || strpos($value,"{") !== false || strpos($value,"}") !== false) || strpos($value,"&") !== false || strpos($value, "'") !== false || strpos($value, "!") === 0 || substr ($value, -1, 1) == ':') ) { $value = $this->_doLiteralBlock($value,$indent); } else { $value = $this->_doFolding($value,$indent); } if ($value === array()) $value = '[ ]'; if ($value === "") $value = '""'; if (self::isTranslationWord($value)) { $value = $this->_doLiteralBlock($value, $indent); } if (trim ($value) != $value) $value = $this->_doLiteralBlock($value,$indent); if (is_bool($value)) { $value = $value ? "true" : "false"; } if ($value === null) $value = 'null'; if ($value === "'" . self::REMPTY . "'") $value = null; $spaces = str_repeat(' ',$indent); //if (is_int($key) && $key - 1 == $previous_key && $first_key===0) { if (is_array ($source_array) && array_keys($source_array) === range(0, count($source_array) - 1)) { // It's a sequence $string = $spaces.'- '.$value."\n"; } else { // if ($first_key===0) throw new \Exception('Keys are all screwy. The first one was zero, now it\'s "'. $key .'"'); // It's mapped if (strpos($key, ":") !== false || strpos($key, "#") !== false) { $key = '"' . $key . '"'; } $string = rtrim ($spaces.$key.': '.$value)."\n"; } return $string; } /** * Creates a literal block for dumping * @access private * @return string * @param $value * @param $indent int The value of the indent */ private function _doLiteralBlock($value,$indent) { if ($value === "\n") return '\n'; if (strpos($value, "\n") === false && strpos($value, "'") === false) { return sprintf ("'%s'", $value); } if (strpos($value, "\n") === false && strpos($value, '"') === false) { return sprintf ('"%s"', $value); } $exploded = explode("\n",$value); $newValue = '|'; if (isset($exploded[0]) && ($exploded[0] == "|" || $exploded[0] == "|-" || $exploded[0] == ">")) { $newValue = $exploded[0]; unset($exploded[0]); } $indent += $this->_dumpIndent; $spaces = str_repeat(' ',$indent); foreach ($exploded as $line) { $line = trim($line); if (strpos($line, '"') === 0 && strrpos($line, '"') == (strlen($line)-1) || strpos($line, "'") === 0 && strrpos($line, "'") == (strlen($line)-1)) { $line = substr($line, 1, -1); } $newValue .= "\n" . $spaces . ($line); } return $newValue; } /** * Folds a string of text, if necessary * @access private * @return string * @param $value The string you wish to fold */ private function _doFolding($value,$indent) { // Don't do anything if wordwrap is set to 0 if ($this->_dumpWordWrap !== 0 && is_string ($value) && strlen($value) > $this->_dumpWordWrap) { $indent += $this->_dumpIndent; $indent = str_repeat(' ',$indent); $wrapped = wordwrap($value,$this->_dumpWordWrap,"\n$indent"); $value = ">\n".$indent.$wrapped; } else { if ($this->setting_dump_force_quotes && is_string ($value) && $value !== self::REMPTY) $value = '"' . $value . '"'; if (is_numeric($value) && is_string($value)) $value = '"' . $value . '"'; } return $value; } private function isTrueWord($value) { $words = self::getTranslations(array('true', 'on', 'yes', 'y')); return in_array($value, $words, true); } private function isFalseWord($value) { $words = self::getTranslations(array('false', 'off', 'no', 'n')); return in_array($value, $words, true); } private function isNullWord($value) { $words = self::getTranslations(array('null', '~')); return in_array($value, $words, true); } private function isTranslationWord($value) { return ( self::isTrueWord($value) || self::isFalseWord($value) || self::isNullWord($value) ); } /** * Coerce a string into a native type * Reference: http://yaml.org/type/bool.html * TODO: Use only words from the YAML spec. * @access private * @param $value The value to coerce */ private function coerceValue(&$value) { if (self::isTrueWord($value)) { $value = true; } else if (self::isFalseWord($value)) { $value = false; } else if (self::isNullWord($value)) { $value = null; } } /** * Given a set of words, perform the appropriate translations on them to * match the YAML 1.1 specification for type coercing. * @param $words The words to translate * @access private */ private static function getTranslations(array $words) { $result = array(); foreach ($words as $i) { $result = array_merge($result, array(ucfirst($i), strtoupper($i), strtolower($i))); } return $result; } // LOADING FUNCTIONS private function _load($input) { $Source = $this->loadFromSource($input); return $this->loadWithSource($Source); } private function _loadString($input) { $Source = $this->loadFromString($input); return $this->loadWithSource($Source); } private function loadWithSource($Source) { if (empty ($Source)) return array(); if ($this->setting_use_syck_is_possible && function_exists ('syck_load')) { $array = syck_load (implode ("\n", $Source)); return is_array($array) ? $array : array(); } $this->path = array(); $this->result = array(); $cnt = count($Source); for ($i = 0; $i < $cnt; $i++) { $line = $Source[$i]; $this->indent = strlen($line) - strlen(ltrim($line)); $tempPath = $this->getParentPathByIndent($this->indent); $line = self::stripIndent($line, $this->indent); if (self::isComment($line)) continue; if (self::isEmpty($line)) continue; $this->path = $tempPath; $literalBlockStyle = self::startsLiteralBlock($line); if ($literalBlockStyle) { $line = rtrim ($line, $literalBlockStyle . " \n"); $literalBlock = ''; $line .= ' '.$this->LiteralPlaceHolder; $literal_block_indent = strlen($Source[$i+1]) - strlen(ltrim($Source[$i+1])); while (++$i < $cnt && $this->literalBlockContinues($Source[$i], $this->indent)) { $literalBlock = $this->addLiteralLine($literalBlock, $Source[$i], $literalBlockStyle, $literal_block_indent); } $i--; } // Strip out comments if (strpos ($line, '#')) { $line = preg_replace('/\s*#([^"\']+)$/','',$line); } while (++$i < $cnt && self::greedilyNeedNextLine($line)) { $line = rtrim ($line, " \n\t\r") . ' ' . ltrim ($Source[$i], " \t"); } $i--; $lineArray = $this->_parseLine($line); if ($literalBlockStyle) $lineArray = $this->revertLiteralPlaceHolder ($lineArray, $literalBlock); $this->addArray($lineArray, $this->indent); foreach ($this->delayedPath as $indent => $delayedPath) $this->path[$indent] = $delayedPath; $this->delayedPath = array(); } return $this->result; } private function loadFromSource ($input) { if (!empty($input) && strpos($input, "\n") === false && file_exists($input)) $input = file_get_contents($input); return $this->loadFromString($input); } private function loadFromString ($input) { $lines = explode("\n",$input); foreach ($lines as $k => $_) { $lines[$k] = rtrim ($_, "\r"); } return $lines; } /** * Parses YAML code and returns an array for a node * @access private * @return array * @param string $line A line from the YAML file */ private function _parseLine($line) { if (!$line) return array(); $line = trim($line); if (!$line) return array(); $array = array(); $group = $this->nodeContainsGroup($line); if ($group) { $this->addGroup($line, $group); $line = $this->stripGroup ($line, $group); } if ($this->startsMappedSequence($line)) return $this->returnMappedSequence($line); if ($this->startsMappedValue($line)) return $this->returnMappedValue($line); if ($this->isArrayElement($line)) return $this->returnArrayElement($line); if ($this->isPlainArray($line)) return $this->returnPlainArray($line); return $this->returnKeyValuePair($line); } /** * Finds the type of the passed value, returns the value as the new type. * @access private * @param string $value * @return mixed */ private function _toType($value) { if ($value === '') return ""; $first_character = $value[0]; $last_character = substr($value, -1, 1); $is_quoted = false; do { if (!$value) break; if ($first_character != '"' && $first_character != "'") break; if ($last_character != '"' && $last_character != "'") break; $is_quoted = true; } while (0); if ($is_quoted) { $value = str_replace('\n', "\n", $value); if ($first_character == "'") return strtr(substr ($value, 1, -1), array ('\'\'' => '\'', '\\\''=> '\'')); return strtr(substr ($value, 1, -1), array ('\\"' => '"', '\\\''=> '\'')); } if (strpos($value, ' #') !== false && !$is_quoted) $value = preg_replace('/\s+#(.+)$/','',$value); if ($first_character == '[' && $last_character == ']') { // Take out strings sequences and mappings $innerValue = trim(substr ($value, 1, -1)); if ($innerValue === '') return array(); $explode = $this->_inlineEscape($innerValue); // Propagate value array $value = array(); foreach ($explode as $v) { $value[] = $this->_toType($v); } return $value; } if (strpos($value,': ')!==false && $first_character != '{') { $array = explode(': ',$value); $key = trim($array[0]); array_shift($array); $value = trim(implode(': ',$array)); $value = $this->_toType($value); return array($key => $value); } if ($first_character == '{' && $last_character == '}') { $innerValue = trim(substr ($value, 1, -1)); if ($innerValue === '') return array(); // Inline Mapping // Take out strings sequences and mappings $explode = $this->_inlineEscape($innerValue); // Propagate value array $array = array(); foreach ($explode as $v) { $SubArr = $this->_toType($v); if (empty($SubArr)) continue; if (is_array ($SubArr)) { $array[key($SubArr)] = $SubArr[key($SubArr)]; continue; } $array[] = $SubArr; } return $array; } if ($value == 'null' || $value == 'NULL' || $value == 'Null' || $value == '' || $value == '~') { return null; } if ( is_numeric($value) && preg_match ('/^(-|)[1-9]+[0-9]*$/', $value) ){ $intvalue = (int)$value; if ($intvalue != PHP_INT_MAX && $intvalue != ~PHP_INT_MAX) $value = $intvalue; return $value; } if ( is_string($value) && preg_match('/^0[xX][0-9a-fA-F]+$/', $value)) { // Hexadecimal value. return hexdec($value); } $this->coerceValue($value); if (is_numeric($value)) { if ($value === '0') return 0; if (rtrim ($value, 0) === $value) $value = (float)$value; return $value; } return $value; } /** * Used in inlines to check for more inlines or quoted strings * @access private * @return array */ private function _inlineEscape($inline) { // There's gotta be a cleaner way to do this... // While pure sequences seem to be nesting just fine, // pure mappings and mappings with sequences inside can't go very // deep. This needs to be fixed. $seqs = array(); $maps = array(); $saved_strings = array(); $saved_empties = array(); // Check for empty strings $regex = '/("")|(\'\')/'; if (preg_match_all($regex,$inline,$strings)) { $saved_empties = $strings[0]; $inline = preg_replace($regex,'YAMLEmpty',$inline); } unset($regex); // Check for strings $regex = '/(?:(")|(?:\'))((?(1)[^"]+|[^\']+))(?(1)"|\')/'; if (preg_match_all($regex,$inline,$strings)) { $saved_strings = $strings[0]; $inline = preg_replace($regex,'YAMLString',$inline); } unset($regex); // echo $inline; $i = 0; do { // Check for sequences while (preg_match('/\[([^{}\[\]]+)\]/U',$inline,$matchseqs)) { $seqs[] = $matchseqs[0]; $inline = preg_replace('/\[([^{}\[\]]+)\]/U', ('YAMLSeq' . (count($seqs) - 1) . 's'), $inline, 1); } // Check for mappings while (preg_match('/{([^\[\]{}]+)}/U',$inline,$matchmaps)) { $maps[] = $matchmaps[0]; $inline = preg_replace('/{([^\[\]{}]+)}/U', ('YAMLMap' . (count($maps) - 1) . 's'), $inline, 1); } if ($i++ >= 10) break; } while (strpos ($inline, '[') !== false || strpos ($inline, '{') !== false); $explode = explode(',',$inline); $explode = array_map('trim', $explode); $stringi = 0; $i = 0; while (1) { // Re-add the sequences if (!empty($seqs)) { foreach ($explode as $key => $value) { if (strpos($value,'YAMLSeq') !== false) { foreach ($seqs as $seqk => $seq) { $explode[$key] = str_replace(('YAMLSeq'.$seqk.'s'),$seq,$value); $value = $explode[$key]; } } } } // Re-add the mappings if (!empty($maps)) { foreach ($explode as $key => $value) { if (strpos($value,'YAMLMap') !== false) { foreach ($maps as $mapk => $map) { $explode[$key] = str_replace(('YAMLMap'.$mapk.'s'), $map, $value); $value = $explode[$key]; } } } } // Re-add the strings if (!empty($saved_strings)) { foreach ($explode as $key => $value) { while (strpos($value,'YAMLString') !== false) { $explode[$key] = preg_replace('/YAMLString/',$saved_strings[$stringi],$value, 1); unset($saved_strings[$stringi]); ++$stringi; $value = $explode[$key]; } } } // Re-add the empties if (!empty($saved_empties)) { foreach ($explode as $key => $value) { while (strpos($value,'YAMLEmpty') !== false) { $explode[$key] = preg_replace('/YAMLEmpty/', '', $value, 1); $value = $explode[$key]; } } } $finished = true; foreach ($explode as $key => $value) { if (strpos($value,'YAMLSeq') !== false) { $finished = false; break; } if (strpos($value,'YAMLMap') !== false) { $finished = false; break; } if (strpos($value,'YAMLString') !== false) { $finished = false; break; } if (strpos($value,'YAMLEmpty') !== false) { $finished = false; break; } } if ($finished) break; $i++; if ($i > 10) break; // Prevent infinite loops. } return $explode; } private function literalBlockContinues ($line, $lineIndent) { if (!trim($line)) return true; if (strlen($line) - strlen(ltrim($line)) > $lineIndent) return true; return false; } private function referenceContentsByAlias ($alias) { do { if (!isset($this->SavedGroups[$alias])) { echo "Bad group name: $alias."; break; } $groupPath = $this->SavedGroups[$alias]; $value = $this->result; foreach ($groupPath as $k) { $value = $value[$k]; } } while (false); return $value; } private function addArrayInline ($array, $indent) { $CommonGroupPath = $this->path; if (empty ($array)) return false; foreach ($array as $k => $_) { $this->addArray(array($k => $_), $indent); $this->path = $CommonGroupPath; } return true; } private function addArray ($incoming_data, $incoming_indent) { // print_r ($incoming_data); if (count ($incoming_data) > 1) return $this->addArrayInline ($incoming_data, $incoming_indent); $key = key ($incoming_data); $value = isset($incoming_data[$key]) ? $incoming_data[$key] : null; if ($key === '__!YAMLZero') $key = '0'; if ($incoming_indent == 0 && !$this->_containsGroupAlias && !$this->_containsGroupAnchor) { // Shortcut for root-level values. if ($key || $key === '' || $key === '0') { $this->result[$key] = $value; } else { $this->result[] = $value; end ($this->result); $key = key ($this->result); } $this->path[$incoming_indent] = $key; return; } $history = array(); // Unfolding inner array tree. $history[] = $_arr = $this->result; foreach ($this->path as $k) { $history[] = $_arr = $_arr[$k]; } if ($this->_containsGroupAlias) { $value = $this->referenceContentsByAlias($this->_containsGroupAlias); $this->_containsGroupAlias = false; } // Adding string or numeric key to the innermost level or $this->arr. if (is_string($key) && $key == '<<') { if (!is_array ($_arr)) { $_arr = array (); } $_arr = array_merge ($_arr, $value); } else if ($key || $key === '' || $key === '0') { if (!is_array ($_arr)) $_arr = array ($key=>$value); else $_arr[$key] = $value; } else { if (!is_array ($_arr)) { $_arr = array ($value); $key = 0; } else { $_arr[] = $value; end ($_arr); $key = key ($_arr); } } $reverse_path = array_reverse($this->path); $reverse_history = array_reverse ($history); $reverse_history[0] = $_arr; $cnt = count($reverse_history) - 1; for ($i = 0; $i < $cnt; $i++) { $reverse_history[$i+1][$reverse_path[$i]] = $reverse_history[$i]; } $this->result = $reverse_history[$cnt]; $this->path[$incoming_indent] = $key; if ($this->_containsGroupAnchor) { $this->SavedGroups[$this->_containsGroupAnchor] = $this->path; if (is_array ($value)) { $k = key ($value); if (!is_int ($k)) { $this->SavedGroups[$this->_containsGroupAnchor][$incoming_indent + 2] = $k; } } $this->_containsGroupAnchor = false; } } private static function startsLiteralBlock ($line) { $lastChar = substr (trim($line), -1); if ($lastChar != '>' && $lastChar != '|') return false; if ($lastChar == '|') return $lastChar; // HTML tags should not be counted as literal blocks. if (preg_match ('#<.*?>$#', $line)) return false; return $lastChar; } private static function greedilyNeedNextLine($line) { $line = trim ($line); if (!strlen($line)) return false; if (substr ($line, -1, 1) == ']') return false; if ($line[0] == '[') return true; if (preg_match ('#^[^:]+?:\s*\[#', $line)) return true; return false; } private function addLiteralLine ($literalBlock, $line, $literalBlockStyle, $indent = -1) { $line = self::stripIndent($line, $indent); if ($literalBlockStyle !== '|') { $line = self::stripIndent($line); } $line = rtrim ($line, "\r\n\t ") . "\n"; if ($literalBlockStyle == '|') { return $literalBlock . $line; } if (strlen($line) == 0) return rtrim($literalBlock, ' ') . "\n"; if ($line == "\n" && $literalBlockStyle == '>') { return rtrim ($literalBlock, " \t") . "\n"; } if ($line != "\n") $line = trim ($line, "\r\n ") . " "; return $literalBlock . $line; } function revertLiteralPlaceHolder ($lineArray, $literalBlock) { foreach ($lineArray as $k => $_) { if (is_array($_)) $lineArray[$k] = $this->revertLiteralPlaceHolder ($_, $literalBlock); else if (substr($_, -1 * strlen ($this->LiteralPlaceHolder)) == $this->LiteralPlaceHolder) $lineArray[$k] = rtrim ($literalBlock, " \r\n"); } return $lineArray; } private static function stripIndent ($line, $indent = -1) { if ($indent == -1) $indent = strlen($line) - strlen(ltrim($line)); return substr ($line, $indent); } private function getParentPathByIndent ($indent) { if ($indent == 0) return array(); $linePath = $this->path; do { end($linePath); $lastIndentInParentPath = key($linePath); if ($indent <= $lastIndentInParentPath) array_pop ($linePath); } while ($indent <= $lastIndentInParentPath); return $linePath; } private function clearBiggerPathValues ($indent) { if ($indent == 0) $this->path = array(); if (empty ($this->path)) return true; foreach ($this->path as $k => $_) { if ($k > $indent) unset ($this->path[$k]); } return true; } private static function isComment ($line) { if (!$line) return false; if ($line[0] == '#') return true; if (trim($line, " \r\n\t") == '---') return true; return false; } private static function isEmpty ($line) { return (trim ($line) === ''); } private function isArrayElement ($line) { if (!$line || !is_scalar($line)) return false; if (substr($line, 0, 2) != '- ') return false; if (strlen ($line) > 3) if (substr($line,0,3) == '---') return false; return true; } private function isHashElement ($line) { return strpos($line, ':'); } private function isLiteral ($line) { if ($this->isArrayElement($line)) return false; if ($this->isHashElement($line)) return false; return true; } private static function unquote ($value) { if (!$value) return $value; if (!is_string($value)) return $value; if ($value[0] == '\'') return trim ($value, '\''); if ($value[0] == '"') return trim ($value, '"'); return $value; } private function startsMappedSequence ($line) { return (substr($line, 0, 2) == '- ' && substr ($line, -1, 1) == ':'); } private function returnMappedSequence ($line) { $array = array(); $key = self::unquote(trim(substr($line,1,-1))); $array[$key] = array(); $this->delayedPath = array(strpos ($line, $key) + $this->indent => $key); return array($array); } private function checkKeysInValue($value) { if (strchr('[{"\'', $value[0]) === false) { if (strchr($value, ': ') !== false) { throw new \Exception('Too many keys: '.$value); } } } private function returnMappedValue ($line) { $this->checkKeysInValue($line); $array = array(); $key = self::unquote (trim(substr($line,0,-1))); $array[$key] = ''; return $array; } private function startsMappedValue ($line) { return (substr ($line, -1, 1) == ':'); } private function isPlainArray ($line) { return ($line[0] == '[' && substr ($line, -1, 1) == ']'); } private function returnPlainArray ($line) { return $this->_toType($line); } private function returnKeyValuePair ($line) { $array = array(); $key = ''; if (strpos ($line, ': ')) { // It's a key/value pair most likely // If the key is in double quotes pull it out if (($line[0] == '"' || $line[0] == "'") && preg_match('/^(["\'](.*)["\'](\s)*:)/',$line,$matches)) { $value = trim(str_replace($matches[1],'',$line)); $key = $matches[2]; } else { // Do some guesswork as to the key and the value $explode = explode(': ', $line); $key = trim(array_shift($explode)); $value = trim(implode(': ', $explode)); $this->checkKeysInValue($value); } // Set the type of the value. Int, string, etc $value = $this->_toType($value); if ($key === '0') $key = '__!YAMLZero'; $array[$key] = $value; } else { $array = array ($line); } return $array; } private function returnArrayElement ($line) { if (strlen($line) <= 1) return array(array()); // Weird %) $array = array(); $value = trim(substr($line,1)); $value = $this->_toType($value); if ($this->isArrayElement($value)) { $value = $this->returnArrayElement($value); } $array[] = $value; return $array; } private function nodeContainsGroup ($line) { $symbolsForReference = 'A-z0-9_\-'; if (strpos($line, '&') === false && strpos($line, '*') === false) return false; // Please die fast ;-) if ($line[0] == '&' && preg_match('/^(&['.$symbolsForReference.']+)/', $line, $matches)) return $matches[1]; if ($line[0] == '*' && preg_match('/^(\*['.$symbolsForReference.']+)/', $line, $matches)) return $matches[1]; if (preg_match('/(&['.$symbolsForReference.']+)$/', $line, $matches)) return $matches[1]; if (preg_match('/(\*['.$symbolsForReference.']+$)/', $line, $matches)) return $matches[1]; if (preg_match ('#^\s*<<\s*:\s*(\*[^\s]+).*$#', $line, $matches)) return $matches[1]; return false; } private function addGroup ($line, $group) { if ($group[0] == '&') $this->_containsGroupAnchor = substr ($group, 1); if ($group[0] == '*') $this->_containsGroupAlias = substr ($group, 1); //print_r ($this->path); } private function stripGroup ($line, $group) { $line = trim(str_replace($group, '', $line)); return $line; } } <?php /** * Spyc -- A Simple PHP YAML Class * @version 0.6.2 * @author Vlad Andersen <vlad.andersen@gmail.com> * @author Chris Wanstrath <chris@ozmm.org> * @link https://github.com/mustangostang/spyc/ * @copyright Copyright 2005-2006 Chris Wanstrath, 2006-2011 Vlad Andersen * @license http://www.opensource.org/licenses/mit-license.php MIT License * @package Spyc */ if (!function_exists('spyc_load')) { /** * Parses YAML to array. * @param string $string YAML string. * @return array */ function spyc_load ($string) { return Spyc::YAMLLoadString($string); } } if (!function_exists('spyc_load_file')) { /** * Parses YAML to array. * @param string $file Path to YAML file. * @return array */ function spyc_load_file ($file) { return Spyc::YAMLLoad($file); } } if (!function_exists('spyc_dump')) { /** * Dumps array to YAML. * @param array $data Array. * @return string */ function spyc_dump ($data) { return Spyc::YAMLDump($data, false, false, true); } } <?php use WP_CLI\Utils; use WP_CLI\Inflector; /** * Generates code for post types, taxonomies, plugins, child themes, etc. * * ## EXAMPLES * * # Generate a new plugin with unit tests. * $ wp scaffold plugin sample-plugin * Success: Created plugin files. * Success: Created test files. * * # Generate theme based on _s. * $ wp scaffold _s sample-theme --theme_name="Sample Theme" --author="John Doe" * Success: Created theme 'Sample Theme'. * * # Generate code for post type registration in given theme. * $ wp scaffold post-type movie --label=Movie --theme=simple-life * Success: Created '/var/www/example.com/public_html/wp-content/themes/simple-life/post-types/movie.php'. * * @package wp-cli */ class Scaffold_Command extends WP_CLI_Command { /** * Generates PHP code for registering a custom post type. * * ## OPTIONS * * <slug> * : The internal name of the post type. * * [--label=<label>] * : The text used to translate the update messages. * * [--textdomain=<textdomain>] * : The textdomain to use for the labels. * * [--dashicon=<dashicon>] * : The dashicon to use in the menu. * * [--theme] * : Create a file in the active theme directory, instead of sending to * STDOUT. Specify a theme with `--theme=<theme>` to have the file placed in that theme. * * [--plugin=<plugin>] * : Create a file in the given plugin's directory, instead of sending to STDOUT. * * [--raw] * : Just generate the `register_post_type()` call and nothing else. * * [--force] * : Overwrite files that already exist. * * ## EXAMPLES * * # Generate a 'movie' post type for the 'simple-life' theme * $ wp scaffold post-type movie --label=Movie --theme=simple-life * Success: Created '/var/www/example.com/public_html/wp-content/themes/simple-life/post-types/movie.php'. * * @subcommand post-type * * @alias cpt */ public function post_type( $args, $assoc_args ) { if ( strlen( $args[0] ) > 20 ) { WP_CLI::error( 'Post type slugs cannot exceed 20 characters in length.' ); } $defaults = [ 'textdomain' => '', 'dashicon' => 'admin-post', ]; $templates = [ 'post_type.mustache', 'post_type_extended.mustache', ]; $this->scaffold( $args[0], $assoc_args, $defaults, '/post-types/', $templates ); } /** * Generates PHP code for registering a custom taxonomy. * * ## OPTIONS * * <slug> * : The internal name of the taxonomy. * * [--post_types=<post-types>] * : Post types to register for use with the taxonomy. * * [--label=<label>] * : The text used to translate the update messages. * * [--textdomain=<textdomain>] * : The textdomain to use for the labels. * * [--theme] * : Create a file in the active theme directory, instead of sending to * STDOUT. Specify a theme with `--theme=<theme>` to have the file placed in that theme. * * [--plugin=<plugin>] * : Create a file in the given plugin's directory, instead of sending to STDOUT. * * [--raw] * : Just generate the `register_taxonomy()` call and nothing else. * * [--force] * : Overwrite files that already exist. * * ## EXAMPLES * * # Generate PHP code for registering a custom taxonomy and save in a file * $ wp scaffold taxonomy venue --post_types=event,presentation > taxonomy.php * * @subcommand taxonomy * * @alias tax */ public function taxonomy( $args, $assoc_args ) { $defaults = [ 'textdomain' => '', 'post_types' => "'post'", ]; if ( isset( $assoc_args['post_types'] ) ) { $assoc_args['post_types'] = $this->quote_comma_list_elements( $assoc_args['post_types'] ); } $templates = [ 'taxonomy.mustache', 'taxonomy_extended.mustache', ]; $this->scaffold( $args[0], $assoc_args, $defaults, '/taxonomies/', $templates ); } private function scaffold( $slug, $assoc_args, $defaults, $subdir, $templates ) { $wp_filesystem = $this->init_wp_filesystem(); $control_defaults = [ 'label' => preg_replace( '/_|-/', ' ', strtolower( $slug ) ), 'theme' => false, 'plugin' => false, 'raw' => false, ]; $control_args = $this->extract_args( $assoc_args, $control_defaults ); $vars = $this->extract_args( $assoc_args, $defaults ); $dashicon = $this->extract_dashicon( $assoc_args ); if ( $dashicon ) { $vars['dashicon'] = $dashicon; } $vars['slug'] = $slug; $vars['textdomain'] = $this->get_textdomain( $vars['textdomain'], $control_args ); $vars['label'] = $control_args['label']; $vars['label_ucfirst'] = ucfirst( $vars['label'] ); $vars['label_plural'] = $this->pluralize( $vars['label'] ); $vars['label_plural_ucfirst'] = ucfirst( $vars['label_plural'] ); $machine_name = $this->generate_machine_name( $slug ); $machine_name_plural = $this->pluralize( $slug ); list( $raw_template, $extended_template ) = $templates; $raw_output = self::mustache_render( $raw_template, $vars ); if ( ! $control_args['raw'] ) { $vars['machine_name'] = $machine_name; $vars['output'] = rtrim( $raw_output ); $target_slug = ''; if ( false !== $control_args['theme'] ) { $target_slug = $control_args['theme']; } elseif ( false !== $control_args['plugin'] ) { $target_slug = $control_args['plugin']; } $target_name = ( $target_slug ) ? $this->generate_machine_name( $target_slug ) : ''; if ( empty( $target_name ) ) { $target_name = $machine_name; } $vars['prefix'] = $target_name; $final_output = self::mustache_render( $extended_template, $vars ); } else { $final_output = $raw_output; } $path = $this->get_output_path( $control_args, $subdir ); if ( is_string( $path ) && ! empty( $path ) ) { $filename = "{$path}{$slug}.php"; $force = Utils\get_flag_value( $assoc_args, 'force' ); $files_written = $this->create_files( [ $filename => $final_output ], $force ); $skip_message = "Skipped creating '{$filename}'."; $success_message = "Created '{$filename}'."; $this->log_whether_files_written( $files_written, $skip_message, $success_message ); } else { // STDOUT echo $final_output; } } /** * Generates PHP, JS and CSS code for registering a Gutenberg block for a plugin or theme. * * **Warning: `wp scaffold block` is deprecated.** * * The official script to generate a block is the [@wordpress/create-block](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-create-block/) package. * * See the [Create a Block tutorial](https://developer.wordpress.org/block-editor/getting-started/tutorial/) for a complete walk-through. * * ## OPTIONS * * <slug> * : The internal name of the block. * * [--title=<title>] * : The display title for your block. * * [--dashicon=<dashicon>] * : The dashicon to make it easier to identify your block. * * [--category=<category>] * : The category name to help users browse and discover your block. * --- * default: widgets * options: * - common * - embed * - formatting * - layout * - widgets * --- * * [--theme] * : Create files in the active theme directory. Specify a theme with `--theme=<theme>` to have the file placed in that theme. * * [--plugin=<plugin>] * : Create files in the given plugin's directory. * * [--force] * : Overwrite files that already exist. * * @subcommand block */ public function block( $args, $assoc_args ) { $slug = $args[0]; if ( ! preg_match( '/^[a-z][a-z0-9\-]*$/', $slug ) ) { WP_CLI::error( 'Invalid block slug specified. Block slugs can contain only lowercase alphanumeric characters or dashes, and start with a letter.' ); } $defaults = [ 'title' => str_replace( '-', ' ', $slug ), 'category' => 'widgets', ]; $data = $this->extract_args( $assoc_args, $defaults ); $data['slug'] = $slug; $data['title_ucfirst'] = ucfirst( $data['title'] ); $data['title_ucfirst_js'] = esc_js( $data['title_ucfirst'] ); $dashicon = $this->extract_dashicon( $assoc_args ); if ( $dashicon ) { $data['dashicon'] = $dashicon; } $control_defaults = [ 'force' => false, 'plugin' => false, 'theme' => false, ]; $control_args = $this->extract_args( $assoc_args, $control_defaults ); if ( isset( $control_args['plugin'] ) ) { if ( ! preg_match( '/^[A-Za-z0-9\-]*$/', $control_args['plugin'] ) ) { WP_CLI::error( 'Invalid plugin name specified. The block editor can only register blocks for plugins that have nothing but lowercase alphanumeric characters or dashes in their slug.' ); } } $data['namespace'] = $control_args['plugin'] ? $control_args['plugin'] : $this->get_theme_name( $control_args['theme'] ); $data['machine_name'] = $this->generate_machine_name( $slug ); $data['plugin'] = $control_args['plugin'] ? true : false; $data['theme'] = ! $data['plugin']; $block_dir = $this->get_output_path( $control_args, '/blocks' ); if ( ! $block_dir ) { WP_CLI::error( 'No plugin or theme selected.' ); } $files_to_create = [ "{$block_dir}/{$slug}.php" => self::mustache_render( 'block-php.mustache', $data ), "{$block_dir}/{$slug}/index.js" => self::mustache_render( 'block-index-js.mustache', $data ), "{$block_dir}/{$slug}/editor.css" => self::mustache_render( 'block-editor-css.mustache', $data ), "{$block_dir}/{$slug}/style.css" => self::mustache_render( 'block-style-css.mustache', $data ), ]; $files_written = $this->create_files( $files_to_create, $control_args['force'] ); $skip_message = 'All block files were skipped.'; $success_message = "Created block '{$data['title_ucfirst']}'."; $this->log_whether_files_written( $files_written, $skip_message, $success_message ); } /** * Generates starter code for a theme based on _s. * * See the [Underscores website](https://underscores.me/) for more details. * * ## OPTIONS * * <slug> * : The slug for the new theme, used for prefixing functions. * * [--activate] * : Activate the newly downloaded theme. * * [--enable-network] * : Enable the newly downloaded theme for the entire network. * * [--theme_name=<title>] * : What to put in the 'Theme Name:' header in 'style.css'. * * [--author=<full-name>] * : What to put in the 'Author:' header in 'style.css'. * * [--author_uri=<uri>] * : What to put in the 'Author URI:' header in 'style.css'. * * [--sassify] * : Include stylesheets as SASS. * * [--woocommerce] * : Include WooCommerce boilerplate files. * * [--force] * : Overwrite files that already exist. * * ## EXAMPLES * * # Generate a theme with name "Sample Theme" and author "John Doe" * $ wp scaffold _s sample-theme --theme_name="Sample Theme" --author="John Doe" * Success: Created theme 'Sample Theme'. * * @alias _s */ public function underscores( $args, $assoc_args ) { $theme_slug = $args[0]; $theme_path = WP_CONTENT_DIR . '/themes'; $url = 'https://underscores.me'; $timeout = 30; if ( ! preg_match( '/^[a-z_]\w+$/i', str_replace( '-', '_', $theme_slug ) ) ) { WP_CLI::error( 'Invalid theme slug specified. Theme slugs can only contain letters, numbers, underscores and hyphens, and can only start with a letter or underscore.' ); } $defaults = [ 'theme_name' => ucfirst( $theme_slug ), 'author' => 'Me', 'author_uri' => '', ]; $data = wp_parse_args( $assoc_args, $defaults ); $_s_theme_path = "$theme_path/$data[theme_name]"; $error_msg = $this->check_target_directory( 'theme', $_s_theme_path ); if ( ! empty( $error_msg ) ) { WP_CLI::error( "Invalid theme slug specified. {$error_msg}" ); } $force = Utils\get_flag_value( $assoc_args, 'force' ); $should_write_file = $this->prompt_if_files_will_be_overwritten( $_s_theme_path, $force ); if ( ! $should_write_file ) { WP_CLI::log( 'No files created' ); die; } $theme_description = "Custom theme: {$data['theme_name']}, developed by {$data['author']}"; $body = []; $body['underscoresme_name'] = $data['theme_name']; $body['underscoresme_slug'] = $theme_slug; $body['underscoresme_author'] = $data['author']; $body['underscoresme_author_uri'] = $data['author_uri']; $body['underscoresme_description'] = $theme_description; $body['underscoresme_generate_submit'] = 'Generate'; $body['underscoresme_generate'] = '1'; if ( Utils\get_flag_value( $assoc_args, 'sassify' ) ) { $body['underscoresme_sass'] = 1; } if ( Utils\get_flag_value( $assoc_args, 'woocommerce' ) ) { $body['underscoresme_woocommerce'] = 1; } $tmpfname = wp_tempnam( $url ); $post_args = [ 'timeout' => $timeout, 'body' => $body, 'stream' => true, 'filename' => $tmpfname, ]; $response = wp_remote_post( $url, $post_args ); if ( is_wp_error( $response ) ) { WP_CLI::error( $response ); } $response_code = wp_remote_retrieve_response_code( $response ); if ( 200 !== (int) $response_code ) { WP_CLI::error( "Couldn't create theme (received {$response_code} response)." ); } $this->maybe_create_themes_dir(); $this->init_wp_filesystem(); $unzip_result = unzip_file( $tmpfname, $theme_path ); unlink( $tmpfname ); if ( true === $unzip_result ) { $files_to_create = [ "{$theme_path}/{$theme_slug}/.editorconfig" => file_get_contents( self::get_template_path( '.editorconfig' ) ), ]; $this->create_files( $files_to_create, false ); WP_CLI::success( "Created theme '{$data['theme_name']}'." ); } else { WP_CLI::error( "Could not decompress your theme files ('{$tmpfname}') at '{$theme_path}': {$unzip_result->get_error_message()}" ); } if ( Utils\get_flag_value( $assoc_args, 'activate' ) ) { WP_CLI::run_command( [ 'theme', 'activate', $theme_slug ] ); } elseif ( Utils\get_flag_value( $assoc_args, 'enable-network' ) ) { WP_CLI::run_command( [ 'theme', 'enable', $theme_slug ], [ 'network' => true ] ); } } /** * Generates child theme based on an existing theme. * * Creates a child theme folder with `functions.php` and `style.css` files. * * ## OPTIONS * * <slug> * : The slug for the new child theme. * * --parent_theme=<slug> * : What to put in the 'Template:' header in 'style.css'. * * [--theme_name=<title>] * : What to put in the 'Theme Name:' header in 'style.css'. * * [--author=<full-name>] * : What to put in the 'Author:' header in 'style.css'. * * [--author_uri=<uri>] * : What to put in the 'Author URI:' header in 'style.css'. * * [--theme_uri=<uri>] * : What to put in the 'Theme URI:' header in 'style.css'. * * [--activate] * : Activate the newly created child theme. * * [--enable-network] * : Enable the newly created child theme for the entire network. * * [--force] * : Overwrite files that already exist. * * ## EXAMPLES * * # Generate a 'sample-theme' child theme based on TwentySixteen * $ wp scaffold child-theme sample-theme --parent_theme=twentysixteen * Success: Created '/var/www/example.com/public_html/wp-content/themes/sample-theme'. * * @subcommand child-theme */ public function child_theme( $args, $assoc_args ) { $theme_slug = $args[0]; if ( in_array( $theme_slug, [ '.', '..' ], true ) ) { WP_CLI::error( "Invalid theme slug specified. The slug cannot be '.' or '..'." ); } $defaults = [ 'theme_name' => ucfirst( $theme_slug ), 'author' => 'Me', 'author_uri' => '', 'theme_uri' => '', ]; $data = wp_parse_args( $assoc_args, $defaults ); $data['slug'] = $theme_slug; $data['prefix_safe'] = str_replace( [ ' ', '-' ], '_', $theme_slug ); $data['description'] = ucfirst( $data['parent_theme'] ) . ' child theme.'; $theme_dir = WP_CONTENT_DIR . "/themes/{$theme_slug}"; $error_msg = $this->check_target_directory( 'theme', $theme_dir ); if ( ! empty( $error_msg ) ) { WP_CLI::error( "Invalid theme slug specified. {$error_msg}" ); } $theme_style_path = "{$theme_dir}/style.css"; $theme_functions_path = "{$theme_dir}/functions.php"; $this->maybe_create_themes_dir(); $files_to_create = [ $theme_style_path => self::mustache_render( 'child_theme.mustache', $data ), $theme_functions_path => self::mustache_render( 'child_theme_functions.mustache', $data ), "{$theme_dir}/.editorconfig" => file_get_contents( self::get_template_path( '.editorconfig' ) ), ]; $force = Utils\get_flag_value( $assoc_args, 'force' ); $files_written = $this->create_files( $files_to_create, $force ); $skip_message = 'All theme files were skipped.'; $success_message = "Created '{$theme_dir}'."; $this->log_whether_files_written( $files_written, $skip_message, $success_message ); if ( Utils\get_flag_value( $assoc_args, 'activate' ) ) { WP_CLI::run_command( [ 'theme', 'activate', $theme_slug ] ); } elseif ( Utils\get_flag_value( $assoc_args, 'enable-network' ) ) { WP_CLI::run_command( [ 'theme', 'enable', $theme_slug ], [ 'network' => true ] ); } } private function get_output_path( $assoc_args, $subdir ) { if ( $assoc_args['theme'] ) { $theme = $assoc_args['theme']; if ( is_string( $theme ) ) { $path = get_theme_root( $theme ) . "/{$theme}"; } else { $path = get_stylesheet_directory(); } if ( ! is_dir( $path ) ) { WP_CLI::error( "Can't find '{$theme}' theme." ); } } elseif ( $assoc_args['plugin'] ) { $plugin = $assoc_args['plugin']; $path = WP_PLUGIN_DIR . "/{$plugin}"; if ( ! is_dir( $path ) ) { WP_CLI::error( "Can't find '{$plugin}' plugin." ); } } else { return false; } $path .= $subdir; return $path; } /** * Generates starter code for a plugin. * * The following files are always generated: * * * `plugin-slug.php` is the main PHP plugin file. * * `readme.txt` is the readme file for the plugin. * * `package.json` needed by NPM holds various metadata relevant to the project. Packages: `grunt`, `grunt-wp-i18n` and `grunt-wp-readme-to-markdown`. Scripts: `start`, `readme`, `i18n`. * * `Gruntfile.js` is the JS file containing Grunt tasks. Tasks: `i18n` containing `addtextdomain` and `makepot`, `readme` containing `wp_readme_to_markdown`. * * `.editorconfig` is the configuration file for Editor. * * `.gitignore` tells which files (or patterns) git should ignore. * * `.distignore` tells which files and folders should be ignored in distribution. * * The following files are also included unless the `--skip-tests` is used: * * * `phpunit.xml.dist` is the configuration file for PHPUnit. * * `.circleci/config.yml` is the configuration file for CircleCI. Use `--ci=<provider>` to select a different service. * * `bin/install-wp-tests.sh` configures the WordPress test suite and a test database. * * `tests/bootstrap.php` is the file that makes the current plugin active when running the test suite. * * `tests/test-sample.php` is a sample file containing test cases. * * `.phpcs.xml.dist` is a collection of PHP_CodeSniffer rules. * * ## OPTIONS * * <slug> * : The internal name of the plugin. * * [--dir=<dirname>] * : Put the new plugin in some arbitrary directory path. Plugin directory will be path plus supplied slug. * * [--plugin_name=<title>] * : What to put in the 'Plugin Name:' header. * * [--plugin_description=<description>] * : What to put in the 'Description:' header. * * [--plugin_author=<author>] * : What to put in the 'Author:' header. * * [--plugin_author_uri=<url>] * : What to put in the 'Author URI:' header. * * [--plugin_uri=<url>] * : What to put in the 'Plugin URI:' header. * * [--skip-tests] * : Don't generate files for unit testing. * * [--ci=<provider>] * : Choose a configuration file for a continuous integration provider. * --- * default: circle * options: * - circle * - gitlab * - bitbucket * - github * --- * * [--activate] * : Activate the newly generated plugin. * * [--activate-network] * : Network activate the newly generated plugin. * * [--force] * : Overwrite files that already exist. * * ## EXAMPLES * * $ wp scaffold plugin sample-plugin * Success: Created plugin files. * Success: Created test files. */ public function plugin( $args, $assoc_args ) { $plugin_slug = $args[0]; $plugin_name = ucwords( str_replace( '-', ' ', $plugin_slug ) ); $plugin_package = str_replace( ' ', '_', $plugin_name ); if ( in_array( $plugin_slug, [ '.', '..' ], true ) ) { WP_CLI::error( "Invalid plugin slug specified. The slug cannot be '.' or '..'." ); } $defaults = [ 'plugin_slug' => $plugin_slug, 'plugin_name' => $plugin_name, 'plugin_package' => $plugin_package, 'plugin_description' => 'PLUGIN DESCRIPTION HERE', 'plugin_author' => 'YOUR NAME HERE', 'plugin_author_uri' => 'YOUR SITE HERE', 'plugin_uri' => 'PLUGIN SITE HERE', 'plugin_tested_up_to' => get_bloginfo( 'version' ), ]; $data = wp_parse_args( $assoc_args, $defaults ); $data['textdomain'] = $plugin_slug; if ( ! empty( $assoc_args['dir'] ) ) { if ( ! is_dir( $assoc_args['dir'] ) ) { WP_CLI::error( "Cannot create plugin in directory that doesn't exist." ); } $plugin_dir = "{$assoc_args['dir']}/{$plugin_slug}"; } else { $plugin_dir = WP_PLUGIN_DIR . "/{$plugin_slug}"; $this->maybe_create_plugins_dir(); $error_msg = $this->check_target_directory( 'plugin', $plugin_dir ); if ( ! empty( $error_msg ) ) { WP_CLI::error( "Invalid plugin slug specified. {$error_msg}" ); } } $plugin_path = "{$plugin_dir}/{$plugin_slug}.php"; $plugin_readme_path = "{$plugin_dir}/readme.txt"; $files_to_create = [ $plugin_path => self::mustache_render( 'plugin.mustache', $data ), $plugin_readme_path => self::mustache_render( 'plugin-readme.mustache', $data ), "{$plugin_dir}/composer.json" => self::mustache_render( 'plugin-composer.mustache', $data ), "{$plugin_dir}/.gitignore" => self::mustache_render( 'plugin-gitignore.mustache', $data ), "{$plugin_dir}/.distignore" => self::mustache_render( 'plugin-distignore.mustache', $data ), "{$plugin_dir}/.editorconfig" => file_get_contents( self::get_template_path( '.editorconfig' ) ), ]; $force = Utils\get_flag_value( $assoc_args, 'force' ); $files_written = $this->create_files( $files_to_create, $force ); $skip_message = 'All plugin files were skipped.'; $success_message = 'Created plugin files.'; $this->log_whether_files_written( $files_written, $skip_message, $success_message ); if ( ! Utils\get_flag_value( $assoc_args, 'skip-tests' ) ) { $command_args = [ 'dir' => $plugin_dir, 'ci' => empty( $assoc_args['ci'] ) ? '' : $assoc_args['ci'], 'force' => $force, ]; WP_CLI::run_command( [ 'scaffold', 'plugin-tests', $plugin_slug ], $command_args ); } if ( Utils\get_flag_value( $assoc_args, 'activate' ) ) { WP_CLI::run_command( [ 'plugin', 'activate', $plugin_slug ] ); } elseif ( Utils\get_flag_value( $assoc_args, 'activate-network' ) ) { WP_CLI::run_command( [ 'plugin', 'activate', $plugin_slug ], [ 'network' => true ] ); } } /** * Generates files needed for running PHPUnit tests in a plugin. * * The following files are generated by default: * * * `phpunit.xml.dist` is the configuration file for PHPUnit. * * `.circleci/config.yml` is the configuration file for CircleCI. Use `--ci=<provider>` to select a different service. * * `bin/install-wp-tests.sh` configures the WordPress test suite and a test database. * * `tests/bootstrap.php` is the file that makes the current plugin active when running the test suite. * * `tests/test-sample.php` is a sample file containing the actual tests. * * `.phpcs.xml.dist` is a collection of PHP_CodeSniffer rules. * * Learn more from the [plugin unit tests documentation](https://make.wordpress.org/cli/handbook/misc/plugin-unit-tests/). * * ## ENVIRONMENT * * The `tests/bootstrap.php` file looks for the WP_TESTS_DIR environment * variable. * * ## OPTIONS * * [<plugin>] * : The name of the plugin to generate test files for. * * [--dir=<dirname>] * : Generate test files for a non-standard plugin path. If no plugin slug is specified, the directory name is used. * * [--ci=<provider>] * : Choose a configuration file for a continuous integration provider. * --- * default: circle * options: * - circle * - gitlab * - bitbucket * - github * --- * * [--force] * : Overwrite files that already exist. * * ## EXAMPLES * * # Generate unit test files for plugin 'sample-plugin'. * $ wp scaffold plugin-tests sample-plugin * Success: Created test files. * * @subcommand plugin-tests */ public function plugin_tests( $args, $assoc_args ) { $this->scaffold_plugin_theme_tests( $args, $assoc_args, 'plugin' ); } /** * Generates files needed for running PHPUnit tests in a theme. * * The following files are generated by default: * * * `phpunit.xml.dist` is the configuration file for PHPUnit. * * `.circleci/config.yml` is the configuration file for CircleCI. Use `--ci=<provider>` to select a different service. * * `bin/install-wp-tests.sh` configures the WordPress test suite and a test database. * * `tests/bootstrap.php` is the file that makes the current theme active when running the test suite. * * `tests/test-sample.php` is a sample file containing the actual tests. * * `.phpcs.xml.dist` is a collection of PHP_CodeSniffer rules. * * Learn more from the [plugin unit tests documentation](https://make.wordpress.org/cli/handbook/misc/plugin-unit-tests/). * * ## ENVIRONMENT * * The `tests/bootstrap.php` file looks for the WP_TESTS_DIR environment * variable. * * ## OPTIONS * * [<theme>] * : The name of the theme to generate test files for. * * [--dir=<dirname>] * : Generate test files for a non-standard theme path. If no theme slug is specified, the directory name is used. * * [--ci=<provider>] * : Choose a configuration file for a continuous integration provider. * --- * default: circle * options: * - circle * - gitlab * - bitbucket * - github * --- * * [--force] * : Overwrite files that already exist. * * ## EXAMPLES * * # Generate unit test files for theme 'twentysixteenchild'. * $ wp scaffold theme-tests twentysixteenchild * Success: Created test files. * * @subcommand theme-tests */ public function theme_tests( $args, $assoc_args ) { $this->scaffold_plugin_theme_tests( $args, $assoc_args, 'theme' ); } private function scaffold_plugin_theme_tests( $args, $assoc_args, $type ) { $wp_filesystem = $this->init_wp_filesystem(); if ( ! empty( $args[0] ) ) { $slug = $args[0]; if ( in_array( $slug, [ '.', '..' ], true ) ) { WP_CLI::error( "Invalid {$type} slug specified. The slug cannot be '.' or '..'." ); } if ( 'theme' === $type ) { $theme = wp_get_theme( $slug ); if ( $theme->exists() ) { $target_dir = $theme->get_stylesheet_directory(); } else { WP_CLI::error( "Invalid {$type} slug specified. The theme '{$slug}' does not exist." ); } } else { $target_dir = WP_PLUGIN_DIR . "/{$slug}"; } if ( empty( $assoc_args['dir'] ) && ! is_dir( $target_dir ) ) { WP_CLI::error( "Invalid {$type} slug specified. No such target directory '{$target_dir}'." ); } $error_msg = $this->check_target_directory( $type, $target_dir ); if ( ! empty( $error_msg ) ) { WP_CLI::error( "Invalid {$type} slug specified. {$error_msg}" ); } } if ( ! empty( $assoc_args['dir'] ) ) { $target_dir = $assoc_args['dir']; if ( ! is_dir( $target_dir ) ) { WP_CLI::error( "Invalid {$type} directory specified. No such directory '{$target_dir}'." ); } if ( empty( $slug ) ) { $slug = Utils\basename( $target_dir ); } } if ( empty( $slug ) || empty( $target_dir ) ) { WP_CLI::error( "Invalid {$type} specified." ); } $name = ucwords( str_replace( '-', ' ', $slug ) ); $package = str_replace( ' ', '_', $name ); $tests_dir = "{$target_dir}/tests"; $bin_dir = "{$target_dir}/bin"; $wp_filesystem->mkdir( $tests_dir ); $wp_filesystem->mkdir( $bin_dir ); $wp_versions_to_test = []; // Parse plugin readme.txt if ( file_exists( "{$target_dir}/readme.txt" ) ) { $readme_content = file_get_contents( "{$target_dir}/readme.txt" ); preg_match( '/Requires at least\:(.*)\n/m', $readme_content, $matches ); if ( isset( $matches[1] ) && $matches[1] ) { $wp_versions_to_test[] = trim( $matches[1] ); } } $wp_versions_to_test[] = 'latest'; $wp_versions_to_test[] = 'trunk'; $main_file = "{$slug}.php"; if ( 'plugin' === $type ) { if ( ! function_exists( 'get_plugins' ) ) { require_once ABSPATH . 'wp-admin/includes/plugin.php'; } $all_plugins = get_plugins(); if ( ! empty( $all_plugins ) ) { $filtered = array_filter( array_keys( $all_plugins ), static function ( $item ) use ( $slug ) { return ( false !== strpos( $item, "{$slug}/" ) ); } ); if ( ! empty( $filtered ) ) { $main_file = basename( reset( $filtered ) ); } } } $template_data = [ "{$type}_slug" => $slug, "{$type}_package" => $package, "{$type}_main_file" => $main_file, ]; $force = Utils\get_flag_value( $assoc_args, 'force' ); $files_to_create = [ "{$tests_dir}/bootstrap.php" => self::mustache_render( "{$type}-bootstrap.mustache", $template_data ), "{$tests_dir}/test-sample.php" => self::mustache_render( "{$type}-test-sample.mustache", $template_data ), ]; if ( 'circle' === $assoc_args['ci'] ) { $files_to_create[ "{$target_dir}/.circleci/config.yml" ] = self::mustache_render( 'plugin-circle.mustache', compact( 'wp_versions_to_test' ) ); } elseif ( 'gitlab' === $assoc_args['ci'] ) { $files_to_create[ "{$target_dir}/.gitlab-ci.yml" ] = self::mustache_render( 'plugin-gitlab.mustache' ); } elseif ( 'bitbucket' === $assoc_args['ci'] ) { $files_to_create[ "{$target_dir}/bitbucket-pipelines.yml" ] = self::mustache_render( 'plugin-bitbucket.mustache' ); } elseif ( 'github' === $assoc_args['ci'] ) { $files_to_create[ "{$target_dir}/.github/workflows/testing.yml" ] = self::mustache_render( 'plugin-github.mustache' ); } $files_written = $this->create_files( $files_to_create, $force ); $to_copy = [ 'install-wp-tests.sh' => $bin_dir, 'phpunit.xml.dist' => $target_dir, '.phpcs.xml.dist' => $target_dir, ]; foreach ( $to_copy as $file => $dir ) { $file_name = "{$dir}/{$file}"; $force = Utils\get_flag_value( $assoc_args, 'force' ); $should_write_file = $this->prompt_if_files_will_be_overwritten( $file_name, $force ); if ( ! $should_write_file ) { continue; } $files_written[] = $file_name; $wp_filesystem->copy( self::get_template_path( $file ), $file_name, true ); if ( 'install-wp-tests.sh' === $file ) { if ( ! $wp_filesystem->chmod( "{$dir}/{$file}", 0755 ) ) { WP_CLI::warning( "Couldn't mark 'install-wp-tests.sh' as executable." ); } } } $skip_message = 'All test files were skipped.'; $success_message = 'Created test files.'; $this->log_whether_files_written( $files_written, $skip_message, $success_message ); } /** * Checks that the `$target_dir` is a child directory of the WP themes or plugins directory, depending on `$type`. * * @param string $type "theme" or "plugin" * @param string $target_dir The theme/plugin directory to check. * * @return null|string Returns null on success, error message on error. */ private function check_target_directory( $type, $target_dir ) { $parent_dir = dirname( self::canonicalize_path( str_replace( '\\', '/', $target_dir ) ) ); if ( 'theme' === $type && str_replace( '\\', '/', WP_CONTENT_DIR . '/themes' ) !== $parent_dir ) { return sprintf( 'The target directory \'%1$s\' is not in \'%2$s\'.', $target_dir, WP_CONTENT_DIR . '/themes' ); } if ( 'plugin' === $type && str_replace( '\\', '/', WP_PLUGIN_DIR ) !== $parent_dir ) { return sprintf( 'The target directory \'%1$s\' is not in \'%2$s\'.', $target_dir, WP_PLUGIN_DIR ); } // Success. return null; } protected function create_files( $files_and_contents, $force ) { $wp_filesystem = $this->init_wp_filesystem(); $wrote_files = []; foreach ( $files_and_contents as $filename => $contents ) { $should_write_file = $this->prompt_if_files_will_be_overwritten( $filename, $force ); if ( ! $should_write_file ) { continue; } $wp_filesystem->mkdir( dirname( $filename ) ); // Create multi-level folders. if ( false === $wp_filesystem->exists( dirname( $filename ) ) ) { $wp_filesystem->mkdir( dirname( dirname( $filename ) ) ); $wp_filesystem->mkdir( dirname( $filename ) ); } if ( ! $wp_filesystem->put_contents( $filename, $contents ) ) { WP_CLI::error( "Error creating file: {$filename}" ); } elseif ( $should_write_file ) { $wrote_files[] = $filename; } } return $wrote_files; } protected function prompt_if_files_will_be_overwritten( $filename, $force ) { $should_write_file = true; if ( ! file_exists( $filename ) ) { return true; } WP_CLI::warning( 'File already exists.' ); WP_CLI::log( $filename ); if ( ! $force ) { do { $answer = cli\prompt( 'Skip this file, or replace it with scaffolding?', $default = false, $marker = '[s/r]: ' ); } while ( ! in_array( $answer, [ 's', 'r' ], true ) ); $should_write_file = 'r' === $answer; } $outcome = $should_write_file ? 'Replacing' : 'Skipping'; WP_CLI::log( $outcome . PHP_EOL ); return $should_write_file; } protected function log_whether_files_written( $files_written, $skip_message, $success_message ) { if ( empty( $files_written ) ) { WP_CLI::log( $skip_message ); } else { WP_CLI::success( $success_message ); } } /** * Extracts dashicon name when provided or return null otherwise. * * @param array $assoc_args * @return string|null */ private function extract_dashicon( $assoc_args ) { $dashicon = Utils\get_flag_value( $assoc_args, 'dashicon' ); if ( ! $dashicon ) { return null; } return preg_replace( '/dashicon(-|s-)/', '', $dashicon ); } /** * If you're writing your files to your theme directory your textdomain also needs to be the same as your theme. * Same goes for when plugin is being used. */ private function get_textdomain( $textdomain, $args ) { if ( strlen( $textdomain ) ) { return $textdomain; } if ( $args['theme'] ) { return $this->get_theme_name( $args['theme'] ); } if ( $args['plugin'] && true !== $args['plugin'] ) { return $args['plugin']; } return 'YOUR-TEXTDOMAIN'; } /** * Generates the machine name for function declarations. * * @param string $slug Slug name to convert. * @return string */ private function generate_machine_name( $slug ) { return str_replace( '-', '_', $slug ); } /** * Pluralizes a noun. * * @see Inflector::pluralize() * @param string $word Word to be pluralized. * @return string */ private function pluralize( $word ) { return Inflector::pluralize( $word ); } protected function extract_args( $assoc_args, $defaults ) { $out = []; foreach ( $defaults as $key => $value ) { $out[ $key ] = Utils\get_flag_value( $assoc_args, $key, $value ); } return $out; } protected function quote_comma_list_elements( $comma_list ) { return "'" . implode( "', '", explode( ',', $comma_list ) ) . "'"; } /** * Creates the themes directory if it doesn't already exist. */ protected function maybe_create_themes_dir() { $themes_dir = WP_CONTENT_DIR . '/themes'; if ( ! is_dir( $themes_dir ) ) { wp_mkdir_p( $themes_dir ); } } /** * Creates the plugins directory if it doesn't already exist. */ protected function maybe_create_plugins_dir() { if ( ! is_dir( WP_PLUGIN_DIR ) ) { wp_mkdir_p( WP_PLUGIN_DIR ); } } /** * Initializes WP_Filesystem. */ protected function init_wp_filesystem() { global $wp_filesystem; WP_Filesystem(); return $wp_filesystem; } /** * Localizes the template path. */ private static function mustache_render( $template, $data = [] ) { return Utils\mustache_render( dirname( __DIR__ ) . "/templates/{$template}", $data ); } /** * Gets the template path based on installation type. */ private static function get_template_path( $template ) { $command_root = Utils\phar_safe_path( dirname( __DIR__ ) ); $template_path = "{$command_root}/templates/{$template}"; if ( ! file_exists( $template_path ) ) { WP_CLI::error( "Couldn't find {$template}" ); } return $template_path; } /* * Returns the canonicalized path, with dot and double dot segments resolved. * * Copied from Symfony\Component\DomCrawler\AbstractUriElement::canonicalizePath(). * Implements RFC 3986, section 5.2.4. * * @param string $path The path to make canonical. * * @return string The canonicalized path. */ private static function canonicalize_path( $path ) { if ( '' === $path || '/' === $path ) { return $path; } if ( '.' === substr( $path, -1 ) ) { $path .= '/'; } $output = []; foreach ( explode( '/', $path ) as $segment ) { if ( '..' === $segment ) { array_pop( $output ); } elseif ( '.' !== $segment ) { $output[] = $segment; } } return implode( '/', $output ); } /** * Gets an active theme's name when true provided or the same name otherwise. * * @param string|bool $theme Theme name or true. * @return string */ private function get_theme_name( $theme ) { if ( true === $theme ) { $theme = wp_get_theme()->template; } return strtolower( $theme ); } } <?php /** * Functions to register client-side assets (scripts and stylesheets) for the * Gutenberg block. * * @package {{namespace}} */ /** * Registers all block assets so that they can be enqueued through Gutenberg in * the corresponding context. * * @see https://wordpress.org/gutenberg/handbook/designers-developers/developers/tutorials/block-tutorial/applying-styles-with-stylesheets/ */ function {{machine_name}}_block_init() { // Skip block registration if Gutenberg is not enabled/merged. if ( ! function_exists( 'register_block_type' ) ) { return; } {{#plugin}} $dir = dirname( __FILE__ ); {{/plugin}} {{#theme}} $dir = get_stylesheet_directory() . '/blocks'; {{/theme}} $index_js = '{{slug}}/index.js'; wp_register_script( '{{slug}}-block-editor', {{#plugin}} plugins_url( $index_js, __FILE__ ), {{/plugin}} {{#theme}} get_stylesheet_directory_uri() . "/blocks/{$index_js}", {{/theme}} [ 'wp-blocks', 'wp-i18n', 'wp-element', ], filemtime( "{$dir}/{$index_js}" ) ); $editor_css = '{{slug}}/editor.css'; wp_register_style( '{{slug}}-block-editor', {{#plugin}} plugins_url( $editor_css, __FILE__ ), {{/plugin}} {{#theme}} get_stylesheet_directory_uri() . "/blocks/{$editor_css}", {{/theme}} [], filemtime( "{$dir}/{$editor_css}" ) ); $style_css = '{{slug}}/style.css'; wp_register_style( '{{slug}}-block', {{#plugin}} plugins_url( $style_css, __FILE__ ), {{/plugin}} {{#theme}} get_stylesheet_directory_uri() . "/blocks/{$style_css}", {{/theme}} [], filemtime( "{$dir}/{$style_css}" ) ); register_block_type( '{{namespace}}/{{slug}}', [ 'editor_script' => '{{slug}}-block-editor', 'editor_style' => '{{slug}}-block-editor', 'style' => '{{slug}}-block', ] ); } add_action( 'init', '{{machine_name}}_block_init' ); <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_scaffold_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_scaffold_autoloader ) ) { require_once $wpcli_scaffold_autoloader; } WP_CLI::add_command( 'scaffold', 'Scaffold_Command' ); <?php use WP_CLI\ExitException; use WP_CLI\Utils; use WP_CLI\WpOrgApi; /** * Generates and reads the wp-config.php file. * * ## EXAMPLES * * # Create standard wp-config.php file. * $ wp config create --dbname=testing --dbuser=wp --dbpass=securepswd --locale=ro_RO * Success: Generated 'wp-config.php' file. * * # List constants and variables defined in wp-config.php file. * $ wp config list * +------------------+------------------------------------------------------------------+----------+ * | key | value | type | * +------------------+------------------------------------------------------------------+----------+ * | table_prefix | wp_ | variable | * | DB_NAME | wp_cli_test | constant | * | DB_USER | root | constant | * | DB_PASSWORD | root | constant | * | AUTH_KEY | r6+@shP1yO&$)1gdu.hl[/j;7Zrvmt~o;#WxSsa0mlQOi24j2cR,7i+QM/#7S:o^ | constant | * | SECURE_AUTH_KEY | iO-z!_m--YH$Tx2tf/&V,YW*13Z_HiRLqi)d?$o-tMdY+82pK$`T.NYW~iTLW;xp | constant | * +------------------+------------------------------------------------------------------+----------+ * * # Get wp-config.php file path. * $ wp config path * /home/person/htdocs/project/wp-config.php * * # Get the table_prefix as defined in wp-config.php file. * $ wp config get table_prefix * wp_ * * # Set the WP_DEBUG constant to true. * $ wp config set WP_DEBUG true --raw * Success: Updated the constant 'WP_DEBUG' in the 'wp-config.php' file with the raw value 'true'. * * # Delete the COOKIE_DOMAIN constant from the wp-config.php file. * $ wp config delete COOKIE_DOMAIN * Success: Deleted the constant 'COOKIE_DOMAIN' from the 'wp-config.php' file. * * # Launch system editor to edit wp-config.php file. * $ wp config edit * * # Check whether the DB_PASSWORD constant exists in the wp-config.php file. * $ wp config has DB_PASSWORD * $ echo $? * 0 * * # Assert if MULTISITE is true. * $ wp config is-true MULTISITE * $ echo $? * 0 * * # Get new salts for your wp-config.php file. * $ wp config shuffle-salts * Success: Shuffled the salt keys. * * @package wp-cli */ class Config_Command extends WP_CLI_Command { /** * List of characters that are valid for a key name. * * @var string */ const VALID_KEY_CHARACTERS = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*()-_ []{}<>~`+=,.;:/?|'; /** * List of default constants that are generated by WordPress Core. * * @string */ const DEFAULT_SALT_CONSTANTS = [ 'AUTH_KEY', 'SECURE_AUTH_KEY', 'LOGGED_IN_KEY', 'NONCE_KEY', 'AUTH_SALT', 'SECURE_AUTH_SALT', 'LOGGED_IN_SALT', 'NONCE_SALT', ]; /** * Retrieve the initial locale from the WordPress version file. * * @return string Initial locale if present, or an empty string if not. */ private static function get_initial_locale() { global $wp_local_package; include ABSPATH . '/wp-includes/version.php'; if ( ! empty( $wp_local_package ) ) { return $wp_local_package; } return ''; } /** * Generates a wp-config.php file. * * Creates a new wp-config.php with database constants, and verifies that * the database constants are correct. * * ## OPTIONS * * --dbname=<dbname> * : Set the database name. * * --dbuser=<dbuser> * : Set the database user. * * [--dbpass=<dbpass>] * : Set the database user password. * * [--dbhost=<dbhost>] * : Set the database host. * --- * default: localhost * --- * * [--dbprefix=<dbprefix>] * : Set the database table prefix. * --- * default: wp_ * --- * * [--dbcharset=<dbcharset>] * : Set the database charset. * --- * default: utf8 * --- * * [--dbcollate=<dbcollate>] * : Set the database collation. * --- * default: * --- * * [--locale=<locale>] * : Set the WPLANG constant. Defaults to $wp_local_package variable. * * [--extra-php] * : If set, the command copies additional PHP code into wp-config.php from STDIN. * * [--skip-salts] * : If set, keys and salts won't be generated, but should instead be passed via `--extra-php`. * * [--skip-check] * : If set, the database connection is not checked. * * [--force] * : Overwrites existing files, if present. * * [--config-file=<path>] * : Specify the file path to the config file to be created. Defaults to the root of the * WordPress installation and the filename "wp-config.php". * * [--insecure] * : Retry API download without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack. * * ## EXAMPLES * * # Standard wp-config.php file * $ wp config create --dbname=testing --dbuser=wp --dbpass=securepswd --locale=ro_RO * Success: Generated 'wp-config.php' file. * * # Enable WP_DEBUG and WP_DEBUG_LOG * $ wp config create --dbname=testing --dbuser=wp --dbpass=securepswd --extra-php <<PHP * define( 'WP_DEBUG', true ); * define( 'WP_DEBUG_LOG', true ); * PHP * Success: Generated 'wp-config.php' file. * * # Avoid disclosing password to bash history by reading from password.txt * # Using --prompt=dbpass will prompt for the 'dbpass' argument * $ wp config create --dbname=testing --dbuser=wp --prompt=dbpass < password.txt * Success: Generated 'wp-config.php' file. */ public function create( $_, $assoc_args ) { if ( ! Utils\get_flag_value( $assoc_args, 'force' ) ) { if ( isset( $assoc_args['config-file'] ) && file_exists( $assoc_args['config-file'] ) ) { $this->config_file_already_exist_error( basename( $assoc_args['config-file'] ) ); } elseif ( ! isset( $assoc_args['config-file'] ) && Utils\locate_wp_config() ) { $this->config_file_already_exist_error( 'wp-config.php' ); } } $defaults = [ 'dbhost' => 'localhost', 'dbpass' => '', 'dbprefix' => 'wp_', 'dbcharset' => 'utf8', 'dbcollate' => '', 'locale' => self::get_initial_locale(), 'config-file' => rtrim( ABSPATH, '/\\' ) . '/wp-config.php', ]; $assoc_args = array_merge( $defaults, $assoc_args ); if ( empty( $assoc_args['dbprefix'] ) ) { WP_CLI::error( '--dbprefix cannot be empty' ); } if ( preg_match( '|[^a-z0-9_]|i', $assoc_args['dbprefix'] ) ) { WP_CLI::error( '--dbprefix can only contain numbers, letters, and underscores.' ); } // Check DB connection. To make command more portable, we are not using MySQL CLI and using // mysqli directly instead, as $wpdb is not accessible in this context. if ( ! Utils\get_flag_value( $assoc_args, 'skip-check' ) ) { // phpcs:disable WordPress.DB.RestrictedFunctions $mysql = mysqli_init(); mysqli_report( MYSQLI_REPORT_STRICT ); try { // Accept similar format to one used by parse_db_host() e.g. 'localhost:/tmp/mysql.sock' $socket = ''; $host = $assoc_args['dbhost']; $socket_pos = strpos( $host, ':/' ); if ( false !== $socket_pos ) { $socket = substr( $host, $socket_pos + 1 ); $host = substr( $host, 0, $socket_pos ); } if ( file_exists( $socket ) ) { // If dbhost is a path to a socket mysqli_real_connect( $mysql, null, $assoc_args['dbuser'], $assoc_args['dbpass'], null, null, $socket ); } else { // If dbhost is a hostname or IP address mysqli_real_connect( $mysql, $host, $assoc_args['dbuser'], $assoc_args['dbpass'] ); } } catch ( mysqli_sql_exception $exception ) { WP_CLI::error( 'Database connection error (' . $exception->getCode() . ') ' . $exception->getMessage() ); } // phpcs:enable WordPress.DB.RestrictedFunctions } if ( ! Utils\get_flag_value( $assoc_args, 'skip-salts' ) ) { try { $assoc_args['keys-and-salts'] = true; $assoc_args['auth-key'] = self::unique_key(); $assoc_args['secure-auth-key'] = self::unique_key(); $assoc_args['logged-in-key'] = self::unique_key(); $assoc_args['nonce-key'] = self::unique_key(); $assoc_args['auth-salt'] = self::unique_key(); $assoc_args['secure-auth-salt'] = self::unique_key(); $assoc_args['logged-in-salt'] = self::unique_key(); $assoc_args['nonce-salt'] = self::unique_key(); $assoc_args['wp-cache-key-salt'] = self::unique_key(); } catch ( Exception $e ) { $assoc_args['keys-and-salts'] = false; $assoc_args['keys-and-salts-alt'] = self::fetch_remote_salts( (bool) Utils\get_flag_value( $assoc_args, 'insecure', false ) ); } } if ( Utils\wp_version_compare( '4.0', '<' ) ) { $assoc_args['add-wplang'] = true; } else { $assoc_args['add-wplang'] = false; } foreach ( $assoc_args as $key => $value ) { $assoc_args[ $key ] = $this->escape_config_value( $key, $value ); } // 'extra-php' from STDIN is retrieved after escaping to avoid breaking // the PHP code. if ( Utils\get_flag_value( $assoc_args, 'extra-php' ) === true ) { $assoc_args['extra-php'] = file_get_contents( 'php://stdin' ); } $command_root = Utils\phar_safe_path( dirname( __DIR__ ) ); $out = Utils\mustache_render( "{$command_root}/templates/wp-config.mustache", $assoc_args ); $wp_config_file_name = basename( $assoc_args['config-file'] ); $bytes_written = file_put_contents( $assoc_args['config-file'], $out ); if ( ! $bytes_written ) { WP_CLI::error( "Could not create new '{$wp_config_file_name}' file." ); } else { WP_CLI::success( "Generated '{$wp_config_file_name}' file." ); } } /** * Gives error when wp-config already exist and try to create it. * * @param string $wp_config_file_name Config file name. * @return void */ private function config_file_already_exist_error( $wp_config_file_name ) { WP_CLI::error( "The '{$wp_config_file_name}' file already exists." ); } /** * Launches system editor to edit the wp-config.php file. * * ## OPTIONS * * [--config-file=<path>] * : Specify the file path to the config file to be edited. Defaults to the root of the * WordPress installation and the filename "wp-config.php". * * ## EXAMPLES * * # Launch system editor to edit wp-config.php file * $ wp config edit * * # Edit wp-config.php file in a specific editor * $ EDITOR=vim wp config edit * * @when before_wp_load */ public function edit( $_, $assoc_args ) { $path = $this->get_config_path( $assoc_args ); $wp_config_file_name = basename( $path ); $contents = file_get_contents( $path ); $r = Utils\launch_editor_for_input( $contents, $wp_config_file_name, 'php' ); if ( false === $r ) { WP_CLI::warning( "No changes made to {$wp_config_file_name}, aborted." ); } else { file_put_contents( $path, $r ); } } /** * Gets the path to wp-config.php file. * * ## EXAMPLES * * # Get wp-config.php file path * $ wp config path * /home/person/htdocs/project/wp-config.php * * @when before_wp_load */ public function path() { WP_CLI::line( $this->get_config_path( array() ) ); } /** * Lists variables, constants, and file includes defined in wp-config.php file. * * ## OPTIONS * * [<filter>...] * : Name or partial name to filter the list by. * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a particular format. * Dotenv is limited to non-object values. * --- * default: table * options: * - table * - csv * - json * - yaml * - dotenv * --- * * [--strict] * : Enforce strict matching when a filter is provided. * * [--config-file=<path>] * : Specify the file path to the config file to be read. Defaults to the root of the * WordPress installation and the filename "wp-config.php". * * ## EXAMPLES * * # List constants and variables defined in wp-config.php file. * $ wp config list * +------------------+------------------------------------------------------------------+----------+ * | key | value | type | * +------------------+------------------------------------------------------------------+----------+ * | table_prefix | wp_ | variable | * | DB_NAME | wp_cli_test | constant | * | DB_USER | root | constant | * | DB_PASSWORD | root | constant | * | AUTH_KEY | r6+@shP1yO&$)1gdu.hl[/j;7Zrvmt~o;#WxSsa0mlQOi24j2cR,7i+QM/#7S:o^ | constant | * | SECURE_AUTH_KEY | iO-z!_m--YH$Tx2tf/&V,YW*13Z_HiRLqi)d?$o-tMdY+82pK$`T.NYW~iTLW;xp | constant | * +------------------+------------------------------------------------------------------+----------+ * * # List only database user and password from wp-config.php file. * $ wp config list DB_USER DB_PASSWORD --strict * +------------------+-------+----------+ * | key | value | type | * +------------------+-------+----------+ * | DB_USER | root | constant | * | DB_PASSWORD | root | constant | * +------------------+-------+----------+ * * # List all salts from wp-config.php file. * $ wp config list _SALT * +------------------+------------------------------------------------------------------+----------+ * | key | value | type | * +------------------+------------------------------------------------------------------+----------+ * | AUTH_SALT | n:]Xditk+_7>Qi=>BmtZHiH-6/Ecrvl(V5ceeGP:{>?;BT^=[B3-0>,~F5z$(+Q$ | constant | * | SECURE_AUTH_SALT | ?Z/p|XhDw3w}?c.z%|+BAr|(Iv*H%%U+Du&kKR y?cJOYyRVRBeB[2zF-`(>+LCC | constant | * | LOGGED_IN_SALT | +$@(1{b~Z~s}Cs>8Y]6[m6~TnoCDpE>O%e75u}&6kUH!>q:7uM4lxbB6[1pa_X,q | constant | * | NONCE_SALT | _x+F li|QL?0OSQns1_JZ{|Ix3Jleox-71km/gifnyz8kmo=w-;@AE8W,(fP<N}2 | constant | * +------------------+------------------------------------------------------------------+----------+ * * @when before_wp_load * @subcommand list */ public function list_( $args, $assoc_args ) { $path = $this->get_config_path( $assoc_args ); $wp_config_file_name = basename( $path ); $strict = Utils\get_flag_value( $assoc_args, 'strict' ); if ( $strict && empty( $args ) ) { WP_CLI::error( 'The --strict option can only be used in combination with a filter.' ); } $default_fields = [ 'name', 'value', 'type', ]; $defaults = [ 'fields' => implode( ',', $default_fields ), 'format' => 'table', ]; $assoc_args = array_merge( $defaults, $assoc_args ); $values = self::get_wp_config_vars( $path ); if ( ! empty( $args ) ) { $values = $this->filter_values( $values, $args, $strict ); } if ( empty( $values ) ) { WP_CLI::error( "No matching entries found in '{$wp_config_file_name}'." ); } if ( 'dotenv' === $assoc_args['format'] ) { return array_walk( $values, array( $this, 'print_dotenv' ) ); } Utils\format_items( $assoc_args['format'], $values, $assoc_args['fields'] ); } /** * Gets the value of a specific constant or variable defined in wp-config.php file. * * ## OPTIONS * * <name> * : Name of the wp-config.php constant or variable. * * [--type=<type>] * : Type of config value to retrieve. Defaults to 'all'. * --- * default: all * options: * - constant * - variable * - all * --- * * [--format=<format>] * : Get value in a particular format. * Dotenv is limited to non-object values. * --- * default: var_export * options: * - var_export * - json * - yaml * - dotenv * --- * * [--config-file=<path>] * : Specify the file path to the config file to be read. Defaults to the root of the * WordPress installation and the filename "wp-config.php". * * ## EXAMPLES * * # Get the table_prefix as defined in wp-config.php file. * $ wp config get table_prefix * wp_ * * @when before_wp_load */ public function get( $args, $assoc_args ) { $value = $this->get_value( $assoc_args, $args ); WP_CLI::print_value( $value, $assoc_args ); } /** * Determines whether value of a specific defined constant or variable is truthy. * * This determination is made by evaluating the retrieved value via boolval(). * * ## OPTIONS * * <name> * : Name of the wp-config.php constant or variable. * * [--type=<type>] * : Type of config value to retrieve. Defaults to 'all'. * --- * default: all * options: * - constant * - variable * - all * --- * * [--config-file=<path>] * : Specify the file path to the config file to be read. Defaults to the root of the * WordPress installation and the filename "wp-config.php". * * ## EXAMPLES * * # Assert if MULTISITE is true * $ wp config is-true MULTISITE * $ echo $? * 0 * * @subcommand is-true * @when before_wp_load */ public function is_true( $args, $assoc_args ) { $value = $this->get_value( $assoc_args, $args ); if ( boolval( $value ) ) { WP_CLI::halt( 0 ); } WP_CLI::halt( 1 ); } /** * Get the array of wp-config.php constants and variables. * * @param string $wp_config_path Config file path * * @return array */ private static function get_wp_config_vars( $wp_config_path = '' ) { $wp_cli_original_defined_constants = get_defined_constants(); $wp_cli_original_defined_vars = get_defined_vars(); $wp_cli_original_includes = get_included_files(); // Output buffering prevents warnings or notices while parsing wp-config // from printing twice. See https://github.com/wp-cli/wp-cli/issues/4944 ob_start(); // phpcs:ignore Squiz.PHP.Eval.Discouraged -- Don't have another way. eval( WP_CLI::get_runner()->get_wp_config_code( $wp_config_path ) ); ob_end_clean(); $wp_config_vars = self::get_wp_config_diff( get_defined_vars(), $wp_cli_original_defined_vars, 'variable', [ 'wp_cli_original_defined_vars' ] ); $wp_config_constants = self::get_wp_config_diff( get_defined_constants(), $wp_cli_original_defined_constants, 'constant' ); foreach ( $wp_config_vars as $name => $value ) { if ( 'wp_cli_original_includes' === $value['name'] ) { $name_backup = $name; break; } } unset( $wp_config_vars[ $name_backup ] ); $wp_config_vars = array_values( $wp_config_vars ); $wp_config_includes = array_diff( get_included_files(), $wp_cli_original_includes ); $wp_config_includes_array = []; foreach ( $wp_config_includes as $name => $value ) { $wp_config_includes_array[] = [ 'name' => basename( $value ), 'value' => $value, 'type' => 'includes', ]; } return array_merge( $wp_config_vars, $wp_config_constants, $wp_config_includes_array ); } /** * Sets the value of a specific constant or variable defined in wp-config.php file. * * ## OPTIONS * * <name> * : Name of the wp-config.php constant or variable. * * <value> * : Value to set the wp-config.php constant or variable to. * * [--add] * : Add the value if it doesn't exist yet. * This is the default behavior, override with --no-add. * * [--raw] * : Place the value into the wp-config.php file as is, instead of as a quoted string. * * [--anchor=<anchor>] * : Anchor string where additions of new values are anchored around. * Defaults to "/* That's all, stop editing!". * The special case "EOF" string uses the end of the file as the anchor. * * [--placement=<placement>] * : Where to place the new values in relation to the anchor string. * --- * default: 'before' * options: * - before * - after * --- * * [--separator=<separator>] * : Separator string to put between an added value and its anchor string. * The following escape sequences will be recognized and properly interpreted: '\n' => newline, '\r' => carriage return, '\t' => tab. * Defaults to a single EOL ("\n" on *nix and "\r\n" on Windows). * * [--type=<type>] * : Type of the config value to set. Defaults to 'all'. * --- * default: all * options: * - constant * - variable * - all * --- * * [--config-file=<path>] * : Specify the file path to the config file to be modified. Defaults to the root of the * WordPress installation and the filename "wp-config.php". * * ## EXAMPLES * * # Set the WP_DEBUG constant to true. * $ wp config set WP_DEBUG true --raw * Success: Updated the constant 'WP_DEBUG' in the 'wp-config.php' file with the raw value 'true'. * * @when before_wp_load */ public function set( $args, $assoc_args ) { $path = $this->get_config_path( $assoc_args ); $wp_config_file_name = basename( $path ); list( $name, $value ) = $args; $type = Utils\get_flag_value( $assoc_args, 'type' ); $options = []; $option_flags = [ 'raw' => false, 'add' => true, 'anchor' => null, 'placement' => null, 'separator' => null, ]; foreach ( $option_flags as $option => $default ) { $option_value = Utils\get_flag_value( $assoc_args, $option, $default ); if ( null !== $option_value ) { $options[ $option ] = $option_value; if ( 'separator' === $option ) { $options['separator'] = $this->parse_separator( $options['separator'] ); } } } $adding = false; try { $config_transformer = new WPConfigTransformer( $path ); switch ( $type ) { case 'all': $has_constant = $config_transformer->exists( 'constant', $name ); $has_variable = $config_transformer->exists( 'variable', $name ); if ( $has_constant && $has_variable ) { WP_CLI::error( "Found both a constant and a variable '{$name}' in the '{$wp_config_file_name}' file. Use --type=<type> to disambiguate." ); } if ( ! $has_constant && ! $has_variable ) { if ( ! $options['add'] ) { $message = "The constant or variable '{$name}' is not defined in the '{$wp_config_file_name}' file."; WP_CLI::error( $message ); } $type = 'constant'; $adding = true; } else { $type = $has_constant ? 'constant' : 'variable'; } break; case 'constant': case 'variable': if ( ! $config_transformer->exists( $type, $name ) ) { if ( ! $options['add'] ) { WP_CLI::error( "The {$type} '{$name}' is not defined in the '{$wp_config_file_name}' file." ); } $adding = true; } } $config_transformer->update( $type, $name, $value, $options ); } catch ( Exception $exception ) { WP_CLI::error( "Could not process the '{$wp_config_file_name}' transformation.\nReason: {$exception->getMessage()}" ); } $raw = $options['raw'] ? 'raw ' : ''; if ( $adding ) { $message = "Added the {$type} '{$name}' to the '{$wp_config_file_name}' file with the {$raw}value '{$value}'."; } else { $message = "Updated the {$type} '{$name}' in the '{$wp_config_file_name}' file with the {$raw}value '{$value}'."; } WP_CLI::success( $message ); } /** * Deletes a specific constant or variable from the wp-config.php file. * * ## OPTIONS * * <name> * : Name of the wp-config.php constant or variable. * * [--type=<type>] * : Type of the config value to delete. Defaults to 'all'. * --- * default: all * options: * - constant * - variable * - all * --- * * [--config-file=<path>] * : Specify the file path to the config file to be modified. Defaults to the root of the * WordPress installation and the filename "wp-config.php". * * ## EXAMPLES * * # Delete the COOKIE_DOMAIN constant from the wp-config.php file. * $ wp config delete COOKIE_DOMAIN * Success: Deleted the constant 'COOKIE_DOMAIN' from the 'wp-config.php' file. * * @when before_wp_load */ public function delete( $args, $assoc_args ) { $path = $this->get_config_path( $assoc_args ); $wp_config_file_name = basename( $path ); list( $name ) = $args; $type = Utils\get_flag_value( $assoc_args, 'type' ); try { $config_transformer = new WPConfigTransformer( $path ); switch ( $type ) { case 'all': $has_constant = $config_transformer->exists( 'constant', $name ); $has_variable = $config_transformer->exists( 'variable', $name ); if ( $has_constant && $has_variable ) { WP_CLI::error( "Found both a constant and a variable '{$name}' in the '{$wp_config_file_name}' file. Use --type=<type> to disambiguate." ); } if ( ! $has_constant && ! $has_variable ) { WP_CLI::error( "The constant or variable '{$name}' is not defined in the '{$wp_config_file_name}' file." ); } else { $type = $has_constant ? 'constant' : 'variable'; } break; case 'constant': case 'variable': if ( ! $config_transformer->exists( $type, $name ) ) { WP_CLI::error( "The {$type} '{$name}' is not defined in the '{$wp_config_file_name}' file." ); } } $config_transformer->remove( $type, $name ); } catch ( Exception $exception ) { WP_CLI::error( "Could not process the '{$wp_config_file_name}' transformation.\nReason: {$exception->getMessage()}" ); } WP_CLI::success( "Deleted the {$type} '{$name}' from the '{$wp_config_file_name}' file." ); } /** * Checks whether a specific constant or variable exists in the wp-config.php file. * * ## OPTIONS * * <name> * : Name of the wp-config.php constant or variable. * * [--type=<type>] * : Type of the config value to set. Defaults to 'all'. * --- * default: all * options: * - constant * - variable * - all * --- * * [--config-file=<path>] * : Specify the file path to the config file to be checked. Defaults to the root of the * WordPress installation and the filename "wp-config.php". * * ## EXAMPLES * * # Check whether the DB_PASSWORD constant exists in the wp-config.php file. * $ wp config has DB_PASSWORD * * @when before_wp_load */ public function has( $args, $assoc_args ) { $path = $this->get_config_path( $assoc_args ); $wp_config_file_name = basename( $path ); list( $name ) = $args; $type = Utils\get_flag_value( $assoc_args, 'type' ); try { $config_transformer = new WPConfigTransformer( $path, true ); switch ( $type ) { case 'all': $has_constant = $config_transformer->exists( 'constant', $name ); $has_variable = $config_transformer->exists( 'variable', $name ); if ( $has_constant && $has_variable ) { WP_CLI::error( "Found both a constant and a variable '{$name}' in the '{$wp_config_file_name}' file. Use --type=<type> to disambiguate." ); } if ( ! $has_constant && ! $has_variable ) { WP_CLI::halt( 1 ); } else { WP_CLI::halt( 0 ); } break; case 'constant': case 'variable': if ( ! $config_transformer->exists( $type, $name ) ) { WP_CLI::halt( 1 ); } WP_CLI::halt( 0 ); } } catch ( Exception $exception ) { WP_CLI::error( "Could not process the '{$wp_config_file_name}' transformation.\nReason: {$exception->getMessage()}" ); } } /** * Refreshes the salts defined in the wp-config.php file. * * ## OPTIONS * * [<keys>...] * : One ore more keys to shuffle. If none are provided, this falls back to the default WordPress Core salt keys. * * [--force] * : If an unknown key is requested to be shuffled, add it instead of throwing a warning. * * [--config-file=<path>] * : Specify the file path to the config file to be modified. Defaults to the root of the * WordPress installation and the filename "wp-config.php". * * [--insecure] * : Retry API download without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack. * * ## EXAMPLES * * # Get new salts for your wp-config.php file * $ wp config shuffle-salts * Success: Shuffled the salt keys. * * # Add a cache key salt to the wp-config.php file * $ wp config shuffle-salts WP_CACHE_KEY_SALT --force * Success: Shuffled the salt keys. * * @subcommand shuffle-salts * @when before_wp_load */ public function shuffle_salts( $args, $assoc_args ) { $keys = $args; $force = Utils\get_flag_value( $assoc_args, 'force', false ); $has_keys = ( ! empty( $keys ) ) ? true : false; if ( empty( $keys ) ) { $keys = self::DEFAULT_SALT_CONSTANTS; } $successes = 0; $errors = 0; $skipped = 0; $secret_keys = []; try { foreach ( $keys as $key ) { $unique_key = self::unique_key(); if ( ! $force && ! in_array( $key, self::DEFAULT_SALT_CONSTANTS, true ) ) { WP_CLI::warning( "Could not shuffle the unknown key '{$key}'." ); ++$skipped; continue; } $secret_keys[ $key ] = trim( $unique_key ); } } catch ( Exception $ex ) { foreach ( $keys as $key ) { if ( ! in_array( $key, self::DEFAULT_SALT_CONSTANTS, true ) ) { if ( $force ) { WP_CLI::warning( "Could not add the key '{$key}' because 'random_int()' is not supported." ); } else { WP_CLI::warning( "Could not shuffle the unknown key '{$key}'." ); } ++$skipped; } } $remote_salts = self::fetch_remote_salts( (bool) Utils\get_flag_value( $assoc_args, 'insecure', false ) ); $remote_salts = explode( "\n", $remote_salts ); foreach ( $remote_salts as $k => $salt ) { if ( ! empty( $salt ) ) { $key = self::DEFAULT_SALT_CONSTANTS[ $k ]; if ( in_array( $key, $keys, true ) ) { $secret_keys[ $key ] = trim( substr( $salt, 28, 64 ) ); } } } } $path = $this->get_config_path( $assoc_args ); try { $config_transformer = new WPConfigTransformer( $path ); foreach ( $secret_keys as $key => $value ) { $is_updated = $config_transformer->update( 'constant', $key, (string) $value ); if ( $is_updated ) { ++$successes; } else { ++$errors; } } } catch ( Exception $exception ) { $wp_config_file_name = basename( $path ); WP_CLI::error( "Could not process the '{$wp_config_file_name}' transformation.\nReason: {$exception->getMessage()}" ); } if ( $has_keys ) { Utils\report_batch_operation_results( 'salt', 'shuffle', count( $keys ), $successes, $errors, $skipped ); } else { WP_CLI::success( 'Shuffled the salt keys.' ); } } /** * Filters wp-config.php file configurations. * * @param array $vars * @param array $previous_list * @param string $type * @param array $exclude_list * @return array */ private static function get_wp_config_diff( $vars, $previous_list, $type, $exclude_list = [] ) { $result = []; foreach ( $vars as $name => $val ) { if ( array_key_exists( $name, $previous_list ) || in_array( $name, $exclude_list, true ) ) { continue; } $out = []; $out['name'] = $name; $out['value'] = $val; $out['type'] = $type; $result[] = $out; } return $result; } /** * Read the salts from the WordPress.org API. * * @param bool $insecure Optional. Whether to retry without certificate validation on TLS handshake failure. * @return string String with a set of PHP define() statements to define the salts. * @throws ExitException If the remote request failed. */ private static function fetch_remote_salts( $insecure = false ) { try { $salts = (string) ( new WpOrgApi( [ 'insecure' => $insecure ] ) )->get_salts(); } catch ( Exception $exception ) { WP_CLI::error( $exception ); } // Adapt whitespace to adhere to WPCS. $salts = preg_replace( '/define$\'(.*?)\'$;/', 'define( \'$1\' );', $salts ); return $salts; } /** * Prints the value of a constant or variable defined in the wp-config.php file. * * If the constant or variable is not defined in the wp-config file then an error will be returned. * * @param string $name * @param string $type * @param string $type * @param string $wp_config_file_name Config file name * @return string The value of the requested constant or variable as defined in the wp-config.php file; if the * requested constant or variable is not defined then the function will print an error and exit. */ private function return_value( $name, $type, $values, $wp_config_file_name ) { $results = []; foreach ( $values as $value ) { if ( $name === $value['name'] && ( 'all' === $type || $type === $value['type'] ) ) { $results[] = $value; } } if ( count( $results ) > 1 ) { WP_CLI::error( "Found both a constant and a variable '{$name}' in the '{$wp_config_file_name}' file. Use --type=<type> to disambiguate." ); } if ( ! empty( $results ) ) { return $results[0]['value']; } $type = 'all' === $type ? 'constant or variable' : $type; $names = array_column( $values, 'name' ); $candidate = Utils\get_suggestion( $name, $names ); if ( ! empty( $candidate ) && $candidate !== $name ) { WP_CLI::error( "The {$type} '{$name}' is not defined in the '{$wp_config_file_name}' file.\nDid you mean '{$candidate}'?" ); } WP_CLI::error( "The {$type} '{$name}' is not defined in the '{$wp_config_file_name}' file." ); } /** * Generates a unique key/salt for the wp-config file. * * @throws Exception * * @return string */ private static function unique_key() { if ( ! function_exists( 'random_int' ) ) { throw new Exception( "'random_int' does not exist" ); } $chars = self::VALID_KEY_CHARACTERS; $key = ''; for ( $i = 0; $i < 64; $i++ ) { // phpcs:ignore PHPCompatibility.FunctionUse.NewFunctions.random_intFound -- Will be called only if function exists. $key .= substr( $chars, random_int( 0, strlen( $chars ) - 1 ), 1 ); } return $key; } /** * Filters the values based on a provider filter key. * * @param array $values * @param array $filters * @param bool $strict * * @return array */ private function filter_values( $values, $filters, $strict ) { $result = []; foreach ( $values as $value ) { foreach ( $filters as $filter ) { if ( $strict && $filter !== $value['name'] ) { continue; } if ( false === strpos( $value['name'], $filter ) ) { continue; } $result[] = $value; } } return $result; } /** * Gets the path to the wp-config.php file or gives a helpful error if none found. * * @param array $assoc_args associative arguments given while calling wp config subcommand * @return string Path to wp-config.php file. */ private function get_config_path( $assoc_args ) { if ( isset( $assoc_args['config-file'] ) ) { $path = $assoc_args['config-file']; if ( ! file_exists( $path ) ) { $this->config_file_not_found_error( basename( $assoc_args['config-file'] ) ); } } else { $path = Utils\locate_wp_config(); if ( ! $path ) { $this->config_file_not_found_error( 'wp-config.php' ); } } return $path; } /** * Gives error the wp-config file not found * * @param string $wp_config_file_name Config file name. * @return void */ private function config_file_not_found_error( $wp_config_file_name ) { WP_CLI::error( "'{$wp_config_file_name}' not found.\nEither create one manually or use `wp config create`." ); } /** * Parses the separator argument, to allow for special character handling. * * Does the following transformations: * - '\n' => "\n" (newline) * - '\r' => "\r" (carriage return) * - '\t' => "\t" (tab) * * @param string $separator Separator string to parse. * * @return mixed Parsed separator string. */ private function parse_separator( $separator ) { $separator = str_replace( [ '\n', '\r', '\t' ], [ "\n", "\r", "\t" ], $separator ); return $separator; } /** * Gets the value of a specific constant or variable defined in wp-config.php file. * * @param $assoc_args * @param $args * * @return string */ protected function get_value( $assoc_args, $args ) { $path = $this->get_config_path( $assoc_args ); $wp_config_file_name = basename( $path ); list( $name ) = $args; $type = Utils\get_flag_value( $assoc_args, 'type' ); $value = $this->return_value( $name, $type, self::get_wp_config_vars( $path ), $wp_config_file_name ); return $value; } /** * Writes a provided variable's key and value to stdout, in dotenv format. * * @param array $value */ private function print_dotenv( array $value ) { if ( ! isset( $value['name'] ) || ! isset( $value['type'] ) || 'constant' !== $value['type'] ) { return; } $name = strtoupper( $value['name'] ); $variable_value = isset( $value['value'] ) ? $value['value'] : ''; $variable_value = str_replace( "'", "\'", $variable_value ); if ( ! is_numeric( $variable_value ) ) { $variable_value = "'{$variable_value}'"; } WP_CLI::line( "{$name}={$variable_value}" ); } /** * Escape a config value so it can be safely used within single quotes. * * @param string $key Key into the arguments array. * @param mixed $value Value to escape. * @return mixed Escaped value. */ private function escape_config_value( $key, $value ) { // Skip 'extra-php', it mustn't be escaped. if ( 'extra-php' === $key ) { return $value; } // Skip 'keys-and-salts-alt' and assume they are safe. if ( 'keys-and-salts-alt' === $key && ! empty( $value ) ) { return $value; } if ( is_string( $value ) ) { return addslashes( $value ); } return $value; } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_config_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_config_autoloader ) ) { require_once $wpcli_config_autoloader; } WP_CLI::add_command( 'config', 'Config_Command' ); <?php use WP_CLI\Fetchers\User as UserFetcher; /** * Lists, adds, or removes super admin users on a multisite installation. * * ## EXAMPLES * * # List user with super-admin capabilities. * $ wp super-admin list * supervisor * administrator * * # Grant super-admin privileges to the user. * $ wp super-admin add superadmin2 * Success: Granted super-admin capabilities to 1 user. * * # Revoke super-admin privileges from the user. * $ wp super-admin remove superadmin2 * Success: Revoked super-admin capabilities from 1 user. * * @package wp-cli */ class Super_Admin_Command extends WP_CLI_Command { private $fields = [ 'user_login', ]; private $fetcher; public function __construct() { $this->fetcher = new UserFetcher(); } /** * Lists users with super admin capabilities. * * ## OPTIONS * * [--format=<format>] * : Render output in a particular format. * --- * default: list * options: * - list * - table * - csv * - json * - count * - ids * - yaml * --- * * ## EXAMPLES * * # List user with super-admin capabilities. * $ wp super-admin list * supervisor * administrator * * @subcommand list */ public function list_subcommand( $_, $assoc_args ) { $super_admins = self::get_admins(); if ( 'list' === $assoc_args['format'] ) { foreach ( $super_admins as $user_login ) { WP_CLI::line( $user_login ); } } else { $output_users = []; foreach ( $super_admins as $user_login ) { $output_user = new stdClass(); $output_user->user_login = $user_login; $output_users[] = $output_user; } if ( ! empty( $assoc_args['format'] ) && 'ids' === $assoc_args['format'] ) { $formatter = new \WP_CLI\Formatter( $assoc_args ); $user_ids = []; foreach ( $super_admins as $user_login ) { $user_obj = get_user_by( 'login', $user_login ); $user_ids[] = $user_obj->ID; } $formatter->display_items( $user_ids ); } else { $formatter = new \WP_CLI\Formatter( $assoc_args, $this->fields ); $formatter->display_items( $output_users ); } } } /** * Grants super admin privileges to one or more users. * * ## OPTIONS * * <user>... * : One or more user IDs, user emails, or user logins. * * ## EXAMPLES * * # Grant super-admin privileges to the user. * $ wp super-admin add superadmin2 * Success: Granted super-admin capabilities to 1 user. */ public function add( $args, $_ ) { $successes = 0; $errors = 0; $users = $this->fetcher->get_many( $args ); if ( count( $users ) !== count( $args ) ) { $errors = count( $args ) - count( $users ); } $super_admins = self::get_admins(); $num_super_admins = count( $super_admins ); $new_super_admins = []; foreach ( $users as $user ) { do_action( 'grant_super_admin', (int) $user->ID ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound if ( in_array( $user->user_login, $super_admins, true ) ) { WP_CLI::warning( "User '{$user->user_login}' already has super-admin capabilities." ); continue; } $new_super_admins[] = $user->ID; $super_admins[] = $user->user_login; ++$successes; } if ( count( $super_admins ) === $num_super_admins ) { if ( $errors ) { $user_count = count( $args ); WP_CLI::error( "Couldn't grant super-admin capabilities to {$errors} of {$user_count} users." ); } else { WP_CLI::success( 'Super admins remain unchanged.' ); } } elseif ( update_site_option( 'site_admins', $super_admins ) ) { if ( $errors ) { $user_count = count( $args ); WP_CLI::error( "Only granted super-admin capabilities to {$successes} of {$user_count} users." ); } else { $message = $successes > 1 ? 'users' : 'user'; WP_CLI::success( "Granted super-admin capabilities to {$successes} {$message}." ); } } else { WP_CLI::error( 'Site options update failed.' ); } foreach ( $new_super_admins as $user_id ) { do_action( 'granted_super_admin', (int) $user_id ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound } } /** * Removes super admin privileges from one or more users. * * ## OPTIONS * * <user>... * : One or more user IDs, user emails, or user logins. * * ## EXAMPLES * * # Revoke super-admin privileges from the user. * $ wp super-admin remove superadmin2 * Success: Revoked super-admin capabilities from 1 user. */ public function remove( $args, $_ ) { $users = $this->fetcher->get_many( $args ); $user_logins = $users ? array_values( array_unique( wp_list_pluck( $users, 'user_login' ) ) ) : []; $user_logins_count = count( $user_logins ); $user_ids = []; foreach ( $users as $user ) { $user_ids[ $user->user_login ] = $user->ID; do_action( 'revoke_super_admin', (int) $user->ID ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound } $super_admins = self::get_admins(); if ( ! $super_admins ) { WP_CLI::error( 'No super admins to revoke super-admin privileges from.' ); } if ( $user_logins_count < count( $args ) ) { $flipped_user_logins = array_flip( $user_logins ); // Fetcher has already warned so don't bother here, but continue with any args that are possible login names to cater for invalid users in the site options meta. $user_logins = array_merge( $user_logins, array_unique( array_filter( $args, static function ( $v ) use ( $flipped_user_logins ) { // Exclude numeric and email-like logins (login names can be email-like but ignore this given the circumstances). return ! isset( $flipped_user_logins[ $v ] ) && ! is_numeric( $v ) && ! is_email( $v ); } ) ) ); $user_logins_count = count( $user_logins ); } if ( ! $user_logins ) { WP_CLI::error( 'No valid user logins given to revoke super-admin privileges from.' ); } $update_super_admins = array_diff( $super_admins, $user_logins ); if ( $update_super_admins === $super_admins ) { WP_CLI::error( $user_logins_count > 1 ? 'None of the given users is a super admin.' : 'The given user is not a super admin.' ); } update_site_option( 'site_admins', $update_super_admins ); $successes = count( $super_admins ) - count( $update_super_admins ); if ( $successes === $user_logins_count ) { $message = $user_logins_count > 1 ? 'users' : 'user'; $msg = "Revoked super-admin capabilities from {$user_logins_count} {$message}."; } else { $msg = "Revoked super-admin capabilities from {$successes} of {$user_logins_count} users."; } if ( ! $update_super_admins ) { $msg .= ' There are no remaining super admins.'; } WP_CLI::success( $msg ); $removed_logins = array_intersect( $user_logins, $super_admins ); foreach ( $removed_logins as $user_login ) { $user_id = null; if ( array_key_exists( $user_login, $user_ids ) ) { $user_id = $user_ids[ $user_login ]; } else { $user = get_user_by( 'login', $user_login ); if ( $user instanceof WP_User ) { $user_id = $user->ID; } } if ( null !== $user_id ) { do_action( 'revoked_super_admin', (int) $user_ids[ $user_login ] ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound } } } private static function get_admins() { // We don't use get_super_admins() because we don't want to mess with the global return (array) get_site_option( 'site_admins', [ 'admin' ] ); } } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_super_admin_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_super_admin_autoloader ) ) { require_once $wpcli_super_admin_autoloader; } WP_CLI::add_command( 'super-admin', 'Super_Admin_Command', array( 'before_invoke' => function () { if ( ! is_multisite() ) { WP_CLI::error( 'This is not a multisite installation.' ); } }, ) ); <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_server_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_server_autoloader ) ) { require_once $wpcli_server_autoloader; } WP_CLI::add_command( 'server', 'Server_Command', array( 'before_invoke' => function () { $min_version = '5.4'; if ( version_compare( PHP_VERSION, $min_version, '<' ) ) { WP_CLI::error( "The `wp server` command requires PHP {$min_version} or newer." ); } }, ) ); <?php use WP_CLI\Utils; class Server_Command extends WP_CLI_Command { /** * Launches PHP's built-in web server for a specific WordPress installation. * * Uses `php -S` to launch a web server serving the WordPress webroot. * <http://php.net/manual/en/features.commandline.webserver.php> * * Importantly, PHP's built-in web server doesn't support `.htaccess` files. * If this is a requirement, please use a more advanced web server. * * ## OPTIONS * * [--host=<host>] * : The hostname to bind the server to. * --- * default: localhost * --- * * [--port=<port>] * : The port number to bind the server to. * --- * default: 8080 * --- * * [--docroot=<path>] * : The path to use as the document root. If the path global parameter is * set, the default value is it. * * [--config=<file>] * : Configure the server with a specific .ini file. * * ## EXAMPLES * * # Make the instance available on any address (with port 8080) * $ wp server --host=0.0.0.0 * PHP 5.6.9 Development Server started at Tue May 24 01:27:11 2016 * Listening on http://0.0.0.0:8080 * Document root is / * Press Ctrl-C to quit. * * # Run on port 80 (for multisite) * $ wp server --host=localhost.localdomain --port=80 * PHP 5.6.9 Development Server started at Tue May 24 01:30:06 2016 * Listening on http://localhost1.localdomain1:80 * Document root is / * Press Ctrl-C to quit. * * # Configure the server with a specific .ini file * $ wp server --config=development.ini * PHP 7.0.9 Development Server started at Mon Aug 22 12:09:04 2016 * Listening on http://localhost:8080 * Document root is / * Press Ctrl-C to quit. * * @when before_wp_load */ public function __invoke( $_, $assoc_args ) { $defaults = array( 'host' => 'localhost', 'port' => 8080, 'docroot' => ! is_null( WP_CLI::get_runner()->config['path'] ) ? WP_CLI::get_runner()->config['path'] : false, 'config' => get_cfg_var( 'cfg_file_path' ), ); $assoc_args = array_merge( $defaults, $assoc_args ); $docroot = $assoc_args['docroot']; if ( ! $docroot ) { $config_path = WP_CLI::get_runner()->project_config_path; if ( ! $config_path ) { $docroot = ABSPATH; } else { $docroot = dirname( $config_path ); } } // Get the path to the router file $command_root = Utils\phar_safe_path( dirname( __DIR__ ) ); $router_path = $command_root . '/router.php'; if ( ! file_exists( $router_path ) ) { WP_CLI::error( "Couldn't find router.php" ); } $cmd = Utils\esc_cmd( '%s -S %s -t %s -c %s %s', WP_CLI::get_php_binary(), $assoc_args['host'] . ':' . $assoc_args['port'], $docroot, $assoc_args['config'], Utils\extract_from_phar( $router_path ) ); $descriptors = array( STDIN, STDOUT, STDERR ); // https://bugs.php.net/bug.php?id=60181 $options = array(); if ( Utils\is_windows() ) { $options['bypass_shell'] = true; } exit( proc_close( proc_open( $cmd, $descriptors, $pipes, null, null, $options ) ) ); } } <?php // Used by `wp server` to route requests. namespace WP_CLI\Router; /** * This is a copy of WordPress's add_filter() function. * * We duplicate it because WordPress is not loaded yet. */ function add_filter( $tag, $function_to_add, $priority = 10, $accepted_args = 1 ) { global $wp_filter, $merged_filters; $idx = _wp_filter_build_unique_id( $tag, $function_to_add, $priority ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited $wp_filter[ $tag ][ $priority ][ $idx ] = array( 'function' => $function_to_add, 'accepted_args' => $accepted_args, ); unset( $merged_filters[ $tag ] ); return true; } /** * This is a copy of WordPress's _wp_filter_build_unique_id() function. * * We duplicate it because WordPress is not loaded yet. */ function _wp_filter_build_unique_id( $tag, $callback, $priority ) { global $wp_filter; static $filter_id_count = 0; if ( is_string( $callback ) ) { return $callback; } if ( is_object( $callback ) ) { // Closures are currently implemented as objects $callback = array( $callback, '' ); } else { $callback = (array) $callback; } if ( is_object( $callback[0] ) ) { // Object Class Calling if ( function_exists( 'spl_object_hash' ) ) { return spl_object_hash( $callback[0] ) . $callback[1]; } else { $obj_idx = get_class( $callback[0] ) . $callback[1]; if ( ! isset( $callback[0]->wp_filter_id ) ) { if ( false === $priority ) { return false; } $obj_idx .= isset( $wp_filter[ $tag ][ $priority ] ) ? count( (array) $wp_filter[ $tag ][ $priority ] ) : $filter_id_count; $callback[0]->wp_filter_id = $filter_id_count; ++$filter_id_count; } else { $obj_idx .= $callback[0]->wp_filter_id; } return $obj_idx; } } elseif ( is_string( $callback[0] ) ) { // Static Calling return $callback[0] . '::' . $callback[1]; } } function _get_full_host( $url ) { // phpcs:ignore WordPress.WP.AlternativeFunctions.parse_url_parse_url $parsed_url = parse_url( $url ); $host = $parsed_url['host']; if ( isset( $parsed_url['port'] ) && 80 !== $parsed_url['port'] ) { $host .= ':' . $parsed_url['port']; } return $host; } // We need to trick WordPress into using the URL set by `wp server`, especially on multisite. add_filter( 'option_home', function ( $url ) { $GLOBALS['wpcli_server_original_url'] = $url; return 'http://' . $_SERVER['HTTP_HOST']; }, 20 ); add_filter( 'option_siteurl', function ( $url ) { if ( ! isset( $GLOBALS['wpcli_server_original_url'] ) ) { get_option( 'home' ); // trigger the option_home filter } $home_url_host = _get_full_host( $GLOBALS['wpcli_server_original_url'] ); $site_url_host = _get_full_host( $url ); if ( $site_url_host === $home_url_host ) { $url = str_replace( $site_url_host, $_SERVER['HTTP_HOST'], $url ); } return $url; }, 20 ); $_SERVER['SERVER_ADDR'] = gethostbyname( $_SERVER['SERVER_NAME'] ); $wpcli_server_root = $_SERVER['DOCUMENT_ROOT']; // phpcs:ignore WordPress.WP.AlternativeFunctions.parse_url_parse_url $wpcli_server_path = '/' . ltrim( parse_url( urldecode( $_SERVER['REQUEST_URI'] ) )['path'], '/' ); if ( file_exists( $wpcli_server_root . $wpcli_server_path ) ) { if ( is_dir( $wpcli_server_root . $wpcli_server_path ) && substr( $wpcli_server_path, -1 ) !== '/' ) { header( "Location: $wpcli_server_path/" ); exit; } if ( strpos( $wpcli_server_path, '.php' ) !== false ) { chdir( dirname( $wpcli_server_root . $wpcli_server_path ) ); require_once $wpcli_server_root . $wpcli_server_path; } else { return false; } } else { chdir( $wpcli_server_root ); require_once 'index.php'; } <?php if ( ! class_exists( 'WP_CLI' ) ) { return; } $wpcli_media_autoloader = __DIR__ . '/vendor/autoload.php'; if ( file_exists( $wpcli_media_autoloader ) ) { require_once $wpcli_media_autoloader; } /** * Check for Imagick and GD extensions availability. * * @throws \WP_CLI\ExitException */ $wpcli_media_assert_image_editor_support = function () { if ( ! wp_image_editor_supports() ) { WP_CLI::error( 'No support for generating images found. ' . 'Please install the Imagick or GD PHP extensions.' ); } }; WP_CLI::add_command( 'media', 'Media_Command', [ 'before_invoke' => $wpcli_media_assert_image_editor_support ] ); <?php use WP_CLI\Utils; /** * Imports files as attachments, regenerates thumbnails, or lists registered image sizes. * * ## EXAMPLES * * # Re-generate all thumbnails, without confirmation. * $ wp media regenerate --yes * Found 3 images to regenerate. * 1/3 Regenerated thumbnails for "Sydney Harbor Bridge" (ID 760). * 2/3 Regenerated thumbnails for "Boardwalk" (ID 757). * 3/3 Regenerated thumbnails for "Sunburst Over River" (ID 756). * Success: Regenerated 3 of 3 images. * * # Import a local image and set it to be the featured image for a post. * $ wp media import ~/Downloads/image.png --post_id=123 --title="A downloaded picture" --featured_image * Imported file '/home/person/Downloads/image.png' as attachment ID 1753 and attached to post 123 as featured image. * Success: Imported 1 of 1 images. * * # List all registered image sizes * $ wp media image-size * +---------------------------+-------+--------+-------+ * | name | width | height | crop | * +---------------------------+-------+--------+-------+ * | full | | | N/A | * | twentyfourteen-full-width | 1038 | 576 | hard | * | large | 1024 | 1024 | soft | * | medium_large | 768 | 0 | soft | * | medium | 300 | 300 | soft | * | thumbnail | 150 | 150 | hard | * +---------------------------+-------+--------+-------+ * * # Fix orientation for specific images. * $ wp media fix-orientation 63 * 1/1 Fixing orientation for "Portrait_6" (ID 63). * Success: Fixed 1 of 1 images. * * @package wp-cli */ class Media_Command extends WP_CLI_Command { /** * Clear the WP object cache after this many regenerations/imports. * * @var integer */ const WP_CLEAR_OBJECT_CACHE_INTERVAL = 500; /** * Regenerates thumbnails for one or more attachments. * * ## OPTIONS * * [<attachment-id>...] * : One or more IDs of the attachments to regenerate. * * [--image_size=<image_size>] * : Name of the image size to regenerate. Only thumbnails of this image size will be regenerated, thumbnails of other image sizes will not. * * [--skip-delete] * : Skip deletion of the original thumbnails. If your thumbnails are linked from sources outside your control, it's likely best to leave them around. Defaults to false. * * [--only-missing] * : Only generate thumbnails for images missing image sizes. * * [--delete-unknown] * : Only delete thumbnails for old unregistered image sizes. * * [--yes] * : Answer yes to the confirmation message. Confirmation only shows when no IDs passed as arguments. * * ## EXAMPLES * * # Regenerate thumbnails for given attachment IDs. * $ wp media regenerate 123 124 125 * Found 3 images to regenerate. * 1/3 Regenerated thumbnails for "Vertical Image" (ID 123). * 2/3 Regenerated thumbnails for "Horizontal Image" (ID 124). * 3/3 Regenerated thumbnails for "Beautiful Picture" (ID 125). * Success: Regenerated 3 of 3 images. * * # Regenerate all thumbnails, without confirmation. * $ wp media regenerate --yes * Found 3 images to regenerate. * 1/3 Regenerated thumbnails for "Sydney Harbor Bridge" (ID 760). * 2/3 Regenerated thumbnails for "Boardwalk" (ID 757). * 3/3 Regenerated thumbnails for "Sunburst Over River" (ID 756). * Success: Regenerated 3 of 3 images. * * # Re-generate all thumbnails that have IDs between 1000 and 2000. * $ seq 1000 2000 | xargs wp media regenerate * Found 4 images to regenerate. * 1/4 Regenerated thumbnails for "Vertical Featured Image" (ID 1027). * 2/4 Regenerated thumbnails for "Horizontal Featured Image" (ID 1022). * 3/4 Regenerated thumbnails for "Unicorn Wallpaper" (ID 1045). * 4/4 Regenerated thumbnails for "I Am Worth Loving Wallpaper" (ID 1023). * Success: Regenerated 4 of 4 images. * * # Re-generate only the thumbnails of "large" image size for all images. * $ wp media regenerate --image_size=large * Do you really want to regenerate the "large" image size for all images? [y/n] y * Found 3 images to regenerate. * 1/3 Regenerated "large" thumbnail for "Sydney Harbor Bridge" (ID 760). * 2/3 No "large" thumbnail regeneration needed for "Boardwalk" (ID 757). * 3/3 Regenerated "large" thumbnail for "Sunburst Over River" (ID 756). * Success: Regenerated 3 of 3 images. */ public function regenerate( $args, $assoc_args = array() ) { $assoc_args = wp_parse_args( $assoc_args, [ 'image_size' => '' ] ); $image_size = $assoc_args['image_size']; if ( $image_size && ! in_array( $image_size, get_intermediate_image_sizes(), true ) ) { WP_CLI::error( sprintf( 'Unknown image size "%s".', $image_size ) ); } if ( empty( $args ) ) { if ( $image_size ) { WP_CLI::confirm( sprintf( 'Do you really want to regenerate the "%s" image size for all images?', $image_size ), $assoc_args ); } else { WP_CLI::confirm( 'Do you really want to regenerate all images?', $assoc_args ); } } $skip_delete = Utils\get_flag_value( $assoc_args, 'skip-delete' ); $only_missing = Utils\get_flag_value( $assoc_args, 'only-missing' ); if ( $only_missing ) { $skip_delete = true; } $delete_unknown = Utils\get_flag_value( $assoc_args, 'delete-unknown' ); if ( $delete_unknown ) { $skip_delete = false; } $additional_mime_types = array(); if ( Utils\wp_version_compare( '4.7', '>=' ) ) { $additional_mime_types[] = 'application/pdf'; } $images = $this->get_images( $args, $additional_mime_types ); $count = $images->post_count; if ( ! $count ) { WP_CLI::warning( 'No images found.' ); return; } WP_CLI::log( sprintf( 'Found %1$d %2$s to regenerate.', $count, _n( 'image', 'images', $count ) ) ); if ( $image_size ) { $image_size_filters = $this->add_image_size_filters( $image_size ); } $number = 0; $successes = 0; $errors = 0; $skips = 0; foreach ( $images->posts as $post_id ) { ++$number; if ( 0 === $number % self::WP_CLEAR_OBJECT_CACHE_INTERVAL ) { Utils\wp_clear_object_cache(); } $this->process_regeneration( $post_id, $skip_delete, $only_missing, $delete_unknown, $image_size, $number . '/' . $count, $successes, $errors, $skips ); } if ( $image_size ) { $this->remove_image_size_filters( $image_size_filters ); } Utils\report_batch_operation_results( 'image', 'regenerate', $count, $successes, $errors, $skips ); } /** * Creates attachments from local files or URLs. * * ## OPTIONS * * <file>... * : Path to file or files to be imported. Supports the glob(3) capabilities of the current shell. * If file is recognized as a URL (for example, with a scheme of http or ftp), the file will be * downloaded to a temp file before being sideloaded. * * [--post_id=<post_id>] * : ID of the post to attach the imported files to. * * [--post_name=<post_name>] * : Name of the post to attach the imported files to. * * [--file_name=<name>] * : Attachment name (post_name field). * * [--title=<title>] * : Attachment title (post title field). * * [--caption=<caption>] * : Caption for attachment (post excerpt field). * * [--alt=<alt_text>] * : Alt text for image (saved as post meta). * * [--desc=<description>] * : "Description" field (post content) of attachment post. * * [--skip-copy] * : If set, media files (local only) are imported to the library but not moved on disk. * File names will not be run through wp_unique_filename() with this set. * * [--preserve-filetime] * : Use the file modified time as the post published & modified dates. * Remote files will always use the current time. * * [--featured_image] * : If set, set the imported image as the Featured Image of the post it is attached to. * * [--porcelain[=<field>]] * : Output a single field for each imported image. Defaults to attachment ID when used as flag. * --- * options: * - url * --- * * ## EXAMPLES * * # Import all jpgs in the current user's "Pictures" directory, not attached to any post. * $ wp media import ~/Pictures/**\/*.jpg * Imported file '/home/person/Pictures/landscape-photo.jpg' as attachment ID 1751. * Imported file '/home/person/Pictures/fashion-icon.jpg' as attachment ID 1752. * Success: Imported 2 of 2 items. * * # Import a local image and set it to be the post thumbnail for a post. * $ wp media import ~/Downloads/image.png --post_id=123 --title="A downloaded picture" --featured_image * Imported file '/home/person/Downloads/image.png' as attachment ID 1753 and attached to post 123 as featured image. * Success: Imported 1 of 1 images. * * # Import a local image, but set it as the featured image for all posts. * # 1. Import the image and get its attachment ID. * # 2. Assign the attachment ID as the featured image for all posts. * $ ATTACHMENT_ID="$(wp media import ~/Downloads/image.png --porcelain)" * $ wp post list --post_type=post --format=ids | xargs -d ' ' -I % wp post meta add % _thumbnail_id $ATTACHMENT_ID * Success: Added custom field. * Success: Added custom field. * * # Import an image from the web. * $ wp media import http://s.wordpress.org/style/images/wp-header-logo.png --title='The WordPress logo' --alt="Semantic personal publishing" * Imported file 'http://s.wordpress.org/style/images/wp-header-logo.png' as attachment ID 1755. * Success: Imported 1 of 1 images. * * # Get the URL for an attachment after import. * $ wp media import http://s.wordpress.org/style/images/wp-header-logo.png --porcelain | xargs -I {} wp post list --post__in={} --field=url --post_type=attachment * http://wordpress-develop.dev/wp-header-logo/ */ public function import( $args, $assoc_args = array() ) { $assoc_args = wp_parse_args( $assoc_args, array( 'file_name' => '', 'title' => '', 'caption' => '', 'alt' => '', 'desc' => '', 'post_name' => '', ) ); // Assume the most generic term $noun = 'item'; // Current site's timezone offset. $gmt_offset = get_option( 'gmt_offset' ); // Use the noun `image` when sure the media file is an image if ( Utils\get_flag_value( $assoc_args, 'featured_image' ) || $assoc_args['alt'] ) { $noun = 'image'; } $porcelain = Utils\get_flag_value( $assoc_args, 'porcelain' ); if ( is_string( $porcelain ) && ! in_array( $porcelain, array( 'url' ), true ) ) { WP_CLI::error( sprintf( 'Invalid value for <porcelain>: %s. Expected flag or \'url\'.', $porcelain ) ); } if ( isset( $assoc_args['post_id'] ) ) { if ( ! get_post( $assoc_args['post_id'] ) ) { WP_CLI::warning( 'Invalid --post_id' ); $assoc_args['post_id'] = false; } } else { $assoc_args['post_id'] = false; } $number = 0; $successes = 0; $errors = 0; foreach ( $args as $file ) { ++$number; if ( 0 === $number % self::WP_CLEAR_OBJECT_CACHE_INTERVAL ) { Utils\wp_clear_object_cache(); } // phpcs:ignore WordPress.WP.AlternativeFunctions.parse_url_parse_url -- parse_url will only be used in absence of wp_parse_url. $is_file_remote = function_exists( 'wp_parse_url' ) ? wp_parse_url( $file, PHP_URL_HOST ) : parse_url( $file, PHP_URL_HOST ); $orig_filename = $file; $file_time = ''; if ( empty( $is_file_remote ) ) { if ( ! file_exists( $file ) ) { WP_CLI::warning( "Unable to import file '$file'. Reason: File doesn't exist." ); ++$errors; continue; } if ( Utils\get_flag_value( $assoc_args, 'skip-copy' ) ) { $tempfile = $file; } else { $tempfile = $this->make_copy( $file ); } $name = Utils\basename( $file ); if ( Utils\get_flag_value( $assoc_args, 'preserve-filetime' ) ) { $file_time = @filemtime( $file ); } } else { $tempfile = download_url( $file ); if ( is_wp_error( $tempfile ) ) { WP_CLI::warning( sprintf( "Unable to import file '%s'. Reason: %s", $file, implode( ', ', $tempfile->get_error_messages() ) ) ); ++$errors; continue; } $name = strtok( Utils\basename( $file ), '?' ); } if ( ! empty( $assoc_args['file_name'] ) ) { $image_name = $this->get_image_name( $name, $assoc_args['file_name'] ); $name = ! empty( $image_name ) ? $image_name : $name; } $file_array = array( 'tmp_name' => $tempfile, 'name' => $name, ); $post_array = array( 'post_title' => $assoc_args['title'], 'post_excerpt' => $assoc_args['caption'], 'post_content' => $assoc_args['desc'], 'post_name' => $assoc_args['post_name'], ); if ( ! empty( $file_time ) ) { $post_array['post_date'] = gmdate( 'Y-m-d H:i:s', $file_time + ( $gmt_offset * HOUR_IN_SECONDS ) ); $post_array['post_date_gmt'] = gmdate( 'Y-m-d H:i:s', $file_time ); $post_array['post_modified'] = gmdate( 'Y-m-d H:i:s', $file_time + ( $gmt_offset * HOUR_IN_SECONDS ) ); $post_array['post_modified_gmt'] = gmdate( 'Y-m-d H:i:s', $file_time ); } $post_array = wp_slash( $post_array ); // use image exif/iptc data for title and caption defaults if possible if ( empty( $post_array['post_title'] ) || empty( $post_array['post_excerpt'] ) ) { // @codingStandardsIgnoreStart $image_meta = @wp_read_image_metadata( $tempfile ); // @codingStandardsIgnoreEnd if ( ! empty( $image_meta ) ) { if ( empty( $post_array['post_title'] ) && trim( $image_meta['title'] ) && ! is_numeric( sanitize_title( $image_meta['title'] ) ) ) { $post_array['post_title'] = $image_meta['title']; } if ( empty( $post_array['post_excerpt'] ) && trim( $image_meta['caption'] ) ) { $post_array['post_excerpt'] = $image_meta['caption']; } } } if ( empty( $post_array['post_title'] ) ) { $post_array['post_title'] = preg_replace( '/\.[^.]+$/', '', Utils\basename( $file ) ); } if ( Utils\get_flag_value( $assoc_args, 'skip-copy' ) ) { $wp_filetype = wp_check_filetype( $file, null ); $post_array['post_mime_type'] = $wp_filetype['type']; $post_array['post_status'] = 'inherit'; $success = wp_insert_attachment( $post_array, $file, $assoc_args['post_id'] ); if ( is_wp_error( $success ) ) { WP_CLI::warning( sprintf( "Unable to insert file '%s'. Reason: %s", $orig_filename, implode( ', ', $success->get_error_messages() ) ) ); ++$errors; continue; } wp_update_attachment_metadata( $success, wp_generate_attachment_metadata( $success, $file ) ); } else { // Deletes the temporary file. $success = media_handle_sideload( $file_array, $assoc_args['post_id'], $assoc_args['title'], $post_array ); if ( is_wp_error( $success ) ) { WP_CLI::warning( sprintf( "Unable to import file '%s'. Reason: %s", $orig_filename, implode( ', ', $success->get_error_messages() ) ) ); ++$errors; continue; } } // Set alt text if ( $assoc_args['alt'] ) { update_post_meta( $success, '_wp_attachment_image_alt', wp_slash( $assoc_args['alt'] ) ); } // Set as featured image, if --post_id and --featured_image are set if ( $assoc_args['post_id'] && Utils\get_flag_value( $assoc_args, 'featured_image' ) ) { update_post_meta( $assoc_args['post_id'], '_thumbnail_id', $success ); } $attachment_success_text = ''; if ( $assoc_args['file_name'] ) { $attachment_success_text .= " with file name {$name}"; } if ( $assoc_args['post_id'] ) { $attachment_success_text = " and attached to post {$assoc_args['post_id']}"; if ( Utils\get_flag_value( $assoc_args, 'featured_image' ) ) { $attachment_success_text .= ' as featured image'; } } if ( $porcelain ) { if ( 'url' === strtolower( $porcelain ) ) { $file_location = $this->get_real_attachment_url( $success ); WP_CLI::line( $file_location ); } else { WP_CLI::line( $success ); } } else { WP_CLI::log( sprintf( "Imported file '%s' as attachment ID %d%s.", $orig_filename, $success, $attachment_success_text ) ); } ++$successes; } // Report the result of the operation if ( ! Utils\get_flag_value( $assoc_args, 'porcelain' ) ) { Utils\report_batch_operation_results( $noun, 'import', count( $args ), $successes, $errors ); } elseif ( $errors ) { WP_CLI::halt( 1 ); } } /** * Lists image sizes registered with WordPress. * * ## OPTIONS * * [--fields=<fields>] * : Limit the output to specific fields. Defaults to all fields. * * [--format=<format>] * : Render output in a specific format * --- * default: table * options: * - table * - json * - csv * - yaml * - count * --- * * ## AVAILABLE FIELDS * * These fields will be displayed by default for each image size: * * name * * width * * height * * crop * * ratio * * ## EXAMPLES * * # List all registered image sizes * $ wp media image-size * +---------------------------+-------+--------+-------+-------+ * | name | width | height | crop | ratio | * +---------------------------+-------+--------+-------+-------+ * | full | | | N/A | N/A | * | twentyfourteen-full-width | 1038 | 576 | hard | 173:96| * | large | 1024 | 1024 | soft | N/A | * | medium_large | 768 | 0 | soft | N/A | * | medium | 300 | 300 | soft | N/A | * | thumbnail | 150 | 150 | hard | 1:1 | * +---------------------------+-------+--------+-------+-------+ * * @subcommand image-size */ public function image_size( $args, $assoc_args ) { $assoc_args = array_merge( array( 'fields' => 'name,width,height,crop,ratio', ), $assoc_args ); $sizes = $this->get_registered_image_sizes(); usort( $sizes, function ( $a, $b ) { if ( $a['width'] === $b['width'] ) { return 0; } return ( $a['width'] < $b['width'] ) ? 1 : -1; } ); array_unshift( $sizes, array( 'name' => 'full', 'width' => '', 'height' => '', 'crop' => 'N/A', 'ratio' => 'N/A', ) ); WP_CLI\Utils\format_items( $assoc_args['format'], $sizes, explode( ',', $assoc_args['fields'] ) ); } private function get_ratio( $width, $height ) { if ( 0 === $height ) { return "0:{$width}"; } if ( 0 === $width ) { return "{$height}:0"; } $gcd = $this->gcd( $width, $height ); $width_ratio = $width / $gcd; $height_ratio = $height / $gcd; return "{$width_ratio}:{$height_ratio}"; } private function gcd( $num1, $num2 ) { while ( 0 !== $num2 ) { $t = $num1 % $num2; $num1 = $num2; $num2 = $t; } return $num1; } // wp_tempnam() inexplicably forces a .tmp extension, which spoils MIME type detection private function make_copy( $path ) { $dir = get_temp_dir(); $filename = Utils\basename( $path ); if ( empty( $filename ) ) { $filename = time(); } $filename = $dir . wp_unique_filename( $dir, $filename ); if ( ! copy( $path, $filename ) ) { WP_CLI::error( "Could not create temporary file for $path." ); } return $filename; } private function process_regeneration( $id, $skip_delete, $only_missing, $delete_unknown, $image_size, $progress, &$successes, &$errors, &$skips ) { $title = get_the_title( $id ); if ( '' === $title ) { // If audio or video cover art then the id is the sub attachment id, which has no title. if ( metadata_exists( 'post', $id, '_cover_hash' ) ) { // Unfortunately the only way to get the attachment title would be to do a non-indexed query against the meta value of `_thumbnail_id`. So don't. $att_desc = sprintf( 'cover attachment (ID %d)', $id ); } else { $att_desc = sprintf( '"(no title)" (ID %d)', $id ); } } else { $att_desc = sprintf( '"%1$s" (ID %2$d)', $title, $id ); } $thumbnail_desc = $image_size ? sprintf( '"%s" thumbnail', $image_size ) : 'thumbnail'; $fullsizepath = $this->get_attached_file( $id ); if ( false === $fullsizepath || ! file_exists( $fullsizepath ) ) { WP_CLI::warning( "Can't find $att_desc." ); ++$errors; return; } $is_pdf = 'application/pdf' === get_post_mime_type( $id ); $original_meta = wp_get_attachment_metadata( $id ); if ( $delete_unknown ) { $this->delete_unknown_image_sizes( $id, $fullsizepath ); WP_CLI::log( "$progress Deleted unknown image sizes for $att_desc." ); ++$successes; return; } $needs_regeneration = $this->needs_regeneration( $id, $fullsizepath, $is_pdf, $image_size, $skip_delete, $skip_it ); if ( $skip_it ) { WP_CLI::log( "$progress Skipped $thumbnail_desc regeneration for $att_desc." ); ++$skips; return; } if ( $only_missing && ! $needs_regeneration ) { WP_CLI::log( "$progress No $thumbnail_desc regeneration needed for $att_desc." ); ++$successes; return; } $metadata = wp_generate_attachment_metadata( $id, $fullsizepath ); // Note it's possible for no metadata to be generated for PDFs if restricted to a specific image size. if ( empty( $metadata ) && ! ( $is_pdf && $image_size ) ) { WP_CLI::warning( sprintf( 'No metadata. (ID %d)', $id ) ); WP_CLI::log( "$progress Couldn't regenerate thumbnails for $att_desc." ); ++$errors; return; } // On read error, we might only get the filesize returned and nothing else. if ( 1 === count( $metadata ) && array_key_exists( 'filesize', $metadata ) && ! ( $is_pdf && $image_size ) ) { WP_CLI::warning( sprintf( 'Read error while retrieving metadata. (ID %d)', $id ) ); WP_CLI::log( "$progress Couldn't regenerate thumbnails for $att_desc." ); ++$errors; return; } if ( $image_size ) { if ( $this->update_attachment_metadata_for_image_size( $id, $metadata, $image_size, $original_meta ) ) { WP_CLI::log( "$progress Regenerated $thumbnail_desc for $att_desc." ); } else { WP_CLI::log( "$progress No $thumbnail_desc regeneration needed for $att_desc." ); } } else { wp_update_attachment_metadata( $id, $metadata ); WP_CLI::log( "$progress Regenerated thumbnails for $att_desc." ); } ++$successes; } private function remove_old_images( $metadata, $fullsizepath, $image_size ) { if ( empty( $metadata['sizes'] ) ) { return; } if ( $image_size ) { if ( empty( $metadata['sizes'][ $image_size ] ) ) { return; } $metadata['sizes'] = array( $image_size => $metadata['sizes'][ $image_size ] ); } $dir_path = dirname( $fullsizepath ) . '/'; foreach ( $metadata['sizes'] as $size_info ) { $intermediate_path = $dir_path . $size_info['file']; if ( $intermediate_path === $fullsizepath ) { continue; } if ( file_exists( $intermediate_path ) ) { unlink( $intermediate_path ); } } } private function needs_regeneration( $att_id, $fullsizepath, $is_pdf, $image_size, $skip_delete, &$skip_it ) { // Assume not skipping. $skip_it = false; // Note: zero-length string returned if no metadata, for instance if PDF or non-standard image (eg an SVG). $metadata = wp_get_attachment_metadata( $att_id ); $image_sizes = $this->get_intermediate_image_sizes_for_attachment( $fullsizepath, $is_pdf, $metadata, $att_id ); // First check if no applicable editor currently available (non-destructive - ie old thumbnails not removed). if ( is_wp_error( $image_sizes ) && 'image_no_editor' === $image_sizes->get_error_code() ) { // Warn unless PDF or non-standard image. if ( ! $is_pdf && is_array( $metadata ) && ! empty( $metadata['sizes'] ) ) { WP_CLI::warning( sprintf( '%s (ID %d)', $image_sizes->get_error_message(), $att_id ) ); } $skip_it = true; return false; } // If uploaded when applicable image editor such as Imagick unavailable, the metadata or sizes metadata may not exist. if ( ! is_array( $metadata ) ) { $metadata = array(); } // If set `$metadata['sizes']` should be array but explicitly check as following code depends on it. if ( ! isset( $metadata['sizes'] ) || ! is_array( $metadata['sizes'] ) ) { $metadata['sizes'] = array(); } // Remove any old thumbnails (so now destructive). if ( ! $skip_delete ) { $this->remove_old_images( $metadata, $fullsizepath, $image_size ); } // Check for any other error (such as load error) apart from no editor available. if ( is_wp_error( $image_sizes ) ) { // Warn but assume it may be possible to regenerate and allow processing to continue and possibly fail. WP_CLI::warning( sprintf( '%s (ID %d)', $image_sizes->get_error_message(), $att_id ) ); return true; } // Have sizes - check whether they're new ones or they've changed. Note that an attachment can have no sizes if it's on or below the thumbnail threshold. if ( $image_size ) { if ( empty( $image_sizes[ $image_size ] ) ) { return false; } if ( empty( $metadata['sizes'][ $image_size ] ) ) { return true; } $metadata['sizes'] = array( $image_size => $metadata['sizes'][ $image_size ] ); } if ( $this->image_sizes_differ( $image_sizes, $metadata['sizes'] ) ) { return true; } $dir_path = dirname( $fullsizepath ) . '/'; // Check that the thumbnail files exist. foreach ( $metadata['sizes'] as $size_info ) { $intermediate_path = $dir_path . $size_info['file']; if ( $intermediate_path === $fullsizepath ) { continue; } if ( ! file_exists( $intermediate_path ) ) { return true; } } return false; } // Whether there's new image sizes or the width/height of existing image sizes have changed. private function image_sizes_differ( $image_sizes, $meta_sizes ) { // Check if have new image size(s). if ( array_diff( array_keys( $image_sizes ), array_keys( $meta_sizes ) ) ) { return true; } // Check if image sizes have changed. foreach ( $image_sizes as $name => $image_size ) { if ( $image_size['width'] !== $meta_sizes[ $name ]['width'] || $image_size['height'] !== $meta_sizes[ $name ]['height'] ) { return true; } } return false; } /** * Returns image sizes for a given attachment. * * Like WP's get_intermediate_image_sizes(), but removes sizes that won't be generated for a particular attachment due to it being on or below their thresholds, * and returns associative array with size name => width/height entries, resolved to crop values if applicable. * * @param string $fullsizepath Filepath of the attachment * @param bool $is_pdf Whether it is a PDF. * @param array $metadata Attachment metadata. * @param int $att_id Attachment ID. * * @return array|WP_Error Image sizes on success, WP_Error instance otherwise. */ private function get_intermediate_image_sizes_for_attachment( $fullsizepath, $is_pdf, $metadata, $att_id ) { // Need to get width, height of attachment for image_resize_dimensions(). $editor = wp_get_image_editor( $fullsizepath ); if ( is_wp_error( $editor ) ) { return $editor; } $result = $editor->load(); if ( is_wp_error( $result ) ) { unset( $editor ); return $result; } list( $width, $height ) = array_values( $editor->get_size() ); unset( $editor ); $sizes = array(); foreach ( $this->get_intermediate_sizes( $is_pdf, $metadata, $att_id ) as $name => $size ) { // Need to check destination and original width or height differ before calling image_resize_dimensions(), otherwise it will return non-false. $dims = image_resize_dimensions( $width, $height, $size['width'], $size['height'], $size['crop'] ); if ( ( $width !== $size['width'] || $height !== $size['height'] ) && $dims ) { list( $dst_x, $dst_y, $src_x, $src_y, $dst_w, $dst_h, $src_w, $src_h ) = $dims; $sizes[ $name ] = array( 'width' => $dst_w, 'height' => $dst_h, ); } } return $sizes; } // Like WP's get_intermediate_image_sizes(), but returns associative array with name => size info entries (and caters for PDFs also). private function get_intermediate_sizes( $is_pdf, $metadata, $att_id ) { if ( $is_pdf ) { // Copied from wp_generate_attachment_metadata() in "wp-admin/includes/image.php". $fallback_sizes = array( 'thumbnail', 'medium', 'large', ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. $intermediate_image_sizes = apply_filters( 'fallback_intermediate_image_sizes', $fallback_sizes, $metadata ); } else { $intermediate_image_sizes = get_intermediate_image_sizes(); } // Adapted from wp_generate_attachment_metadata() in "wp-admin/includes/image.php". if ( function_exists( 'wp_get_additional_image_sizes' ) ) { $_wp_additional_image_sizes = wp_get_additional_image_sizes(); } else { // For WP < 4.7.0. global $_wp_additional_image_sizes; if ( ! $_wp_additional_image_sizes ) { // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- Used as a fallback for WordPress version less than 4.7.0 as function wp_get_additional_image_sizes didn't exist then. $_wp_additional_image_sizes = array(); } } $sizes = array(); foreach ( $intermediate_image_sizes as $s ) { if ( isset( $_wp_additional_image_sizes[ $s ]['width'] ) ) { $sizes[ $s ]['width'] = (int) $_wp_additional_image_sizes[ $s ]['width']; } else { $sizes[ $s ]['width'] = (int) get_option( "{$s}_size_w" ); } if ( isset( $_wp_additional_image_sizes[ $s ]['height'] ) ) { $sizes[ $s ]['height'] = (int) $_wp_additional_image_sizes[ $s ]['height']; } else { $sizes[ $s ]['height'] = (int) get_option( "{$s}_size_h" ); } if ( isset( $_wp_additional_image_sizes[ $s ]['crop'] ) ) { $sizes[ $s ]['crop'] = (bool) $_wp_additional_image_sizes[ $s ]['crop']; // Force PDF thumbnails to be soft crops. } elseif ( $is_pdf && 'thumbnail' === $s ) { $sizes[ $s ]['crop'] = false; } else { $sizes[ $s ]['crop'] = (bool) get_option( "{$s}_crop" ); } } // Check here that not PDF (as filter not applied in core if is) and `$metadata` is array (as may not be and filter only applied in core when is). if ( ! $is_pdf && is_array( $metadata ) ) { if ( Utils\wp_version_compare( '5.3', '>=' ) ) { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. $sizes = apply_filters( 'intermediate_image_sizes_advanced', $sizes, $metadata, $att_id ); } else { // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook. $sizes = apply_filters( 'intermediate_image_sizes_advanced', $sizes, $metadata ); } } return $sizes; } // Add filters to only process a particular intermediate image size in wp_generate_attachment_metadata(). private function add_image_size_filters( $image_size ) { $image_size_filters = array(); // For images. $image_size_filters['intermediate_image_sizes_advanced'] = function ( $sizes ) use ( $image_size ) { // $sizes is associative array of name => size info entries. if ( isset( $sizes[ $image_size ] ) ) { return array( $image_size => $sizes[ $image_size ] ); } return array(); }; // For PDF previews. $image_size_filters['fallback_intermediate_image_sizes'] = function ( $fallback_sizes ) use ( $image_size ) { // $fallback_sizes is indexed array of size names. if ( in_array( $image_size, $fallback_sizes, true ) ) { return array( $image_size ); } return array(); }; foreach ( $image_size_filters as $name => $filter ) { add_filter( $name, $filter, PHP_INT_MAX ); } return $image_size_filters; } // Remove above intermediate image size filters. private function remove_image_size_filters( $image_size_filters ) { foreach ( $image_size_filters as $name => $filter ) { remove_filter( $name, $filter, PHP_INT_MAX ); } } // Update attachment sizes metadata just for a particular intermediate image size. private function update_attachment_metadata_for_image_size( $id, $new_metadata, $image_size, $metadata ) { if ( ! is_array( $metadata ) ) { return false; } // If have metadata for image_size. if ( ! empty( $new_metadata['sizes'][ $image_size ] ) ) { $metadata['sizes'][ $image_size ] = $new_metadata['sizes'][ $image_size ]; wp_update_attachment_metadata( $id, $metadata ); return true; } // Else remove unused metadata if any. if ( ! empty( $metadata['sizes'][ $image_size ] ) ) { unset( $metadata['sizes'][ $image_size ] ); wp_update_attachment_metadata( $id, $metadata ); // Treat removing unused metadata as no change. } return false; } /** * Get images from the installation. * * @param array $args The query arguments to use. Optional. * @param array $additional_mime_types The additional mime types to search for. Optional. * * @return WP_Query The query result. */ private function get_images( $args = array(), $additional_mime_types = array() ) { $mime_types = array_merge( array( 'image' ), $additional_mime_types ); $query_args = array( 'post_type' => 'attachment', 'post__in' => $args, 'post_mime_type' => $mime_types, 'post_status' => 'any', 'posts_per_page' => -1, 'fields' => 'ids', 'update_post_meta_cache' => false, 'update_post_term_cache' => false, ); return new WP_Query( $query_args ); } /** * Get all the registered image sizes along with their dimensions. * * @return array $image_sizes The image sizes */ private function get_registered_image_sizes() { $image_sizes = array(); $all_sizes = $this->wp_get_registered_image_subsizes(); foreach ( $all_sizes as $size => $size_args ) { $crop = filter_var( $size_args['crop'], FILTER_VALIDATE_BOOLEAN ); $image_sizes[] = array( 'name' => $size, 'width' => $size_args['width'], 'height' => $size_args['height'], 'crop' => empty( $crop ) || is_array( $size_args['crop'] ) ? 'soft' : 'hard', 'ratio' => empty( $crop ) || is_array( $size_args['crop'] ) ? 'N/A' : $this->get_ratio( $size_args['width'], $size_args['height'] ), ); } return $image_sizes; } /** * Returns a normalized list of all currently registered image sub-sizes. * * If exists, uses output of wp_get_registered_image_subsizes() function (introduced in WP 5.3). * Definition of this method is modified version of core function wp_get_registered_image_subsizes(). * * @global array $_wp_additional_image_sizes * * @return array[] Associative array of arrays of image sub-size information, keyed by image size name. */ private function wp_get_registered_image_subsizes() { if ( Utils\wp_version_compare( '5.3', '>=' ) ) { return wp_get_registered_image_subsizes(); } global $_wp_additional_image_sizes; $additional_sizes = $_wp_additional_image_sizes ? $_wp_additional_image_sizes : array(); $all_sizes = array(); foreach ( get_intermediate_image_sizes() as $size_name ) { $size_data = array( 'width' => 0, 'height' => 0, 'crop' => false, ); if ( isset( $additional_sizes[ $size_name ]['width'] ) ) { // For sizes added by plugins and themes. $size_data['width'] = (int) $additional_sizes[ $size_name ]['width']; } else { // For default sizes set in options. $size_data['width'] = (int) get_option( "{$size_name}_size_w" ); } if ( isset( $additional_sizes[ $size_name ]['height'] ) ) { $size_data['height'] = (int) $additional_sizes[ $size_name ]['height']; } else { $size_data['height'] = (int) get_option( "{$size_name}_size_h" ); } if ( empty( $size_data['width'] ) && empty( $size_data['height'] ) ) { // This size isn't set. continue; } if ( isset( $additional_sizes[ $size_name ]['crop'] ) ) { $size_data['crop'] = $additional_sizes[ $size_name ]['crop']; } else { $size_data['crop'] = get_option( "{$size_name}_crop" ); } if ( ! is_array( $size_data['crop'] ) || empty( $size_data['crop'] ) ) { $size_data['crop'] = (bool) $size_data['crop']; } $all_sizes[ $size_name ] = $size_data; } return $all_sizes; } /** * Fix image orientation for one or more attachments. * * ## OPTIONS * * [<attachment-id>...] * : One or more IDs of the attachments to regenerate. * * [--dry-run] * : Check images needing orientation without performing the operation. * * ## EXAMPLES * * # Fix orientation for all images. * $ wp media fix-orientation * 1/3 Fixing orientation for "Landscape_4" (ID 62). * 2/3 Fixing orientation for "Landscape_3" (ID 61). * 3/3 Fixing orientation for "Landscape_2" (ID 60). * Success: Fixed 3 of 3 images. * * # Fix orientation dry run. * $ wp media fix-orientation 63 --dry-run * 1/1 "Portrait_6" (ID 63) will be affected. * Success: 1 of 1 image will be affected. * * # Fix orientation for specific images. * $ wp media fix-orientation 63 * 1/1 Fixing orientation for "Portrait_6" (ID 63). * Success: Fixed 1 of 1 images. * * @subcommand fix-orientation */ public function fix_orientation( $args, $assoc_args ) { // EXIF is required to read image metadata for orientation. if ( ! extension_loaded( 'exif' ) ) { WP_CLI::error( "'EXIF' extension is not loaded, it is required for this operation." ); } elseif ( ! function_exists( 'exif_read_data' ) ) { WP_CLI::error( "Function 'exif_read_data' does not exist, it is required for this operation." ); } $images = $this->get_images( $args ); $count = $images->post_count; $dry_run = Utils\get_flag_value( $assoc_args, 'dry-run' ); if ( ! $count ) { WP_CLI::error( 'No images found.' ); } $number = 0; $successes = 0; $errors = 0; foreach ( $images->posts as $post_id ) { ++$number; if ( 0 === $number % self::WP_CLEAR_OBJECT_CACHE_INTERVAL ) { Utils\wp_clear_object_cache(); } $this->process_orientation_fix( $post_id, "{$number}/{$count}", $successes, $errors, $dry_run ); } if ( Utils\get_flag_value( $assoc_args, 'dry-run' ) ) { WP_CLI::success( sprintf( '%s of %s %s will be affected.', $successes, $count, Utils\pluralize( 'image', $count ) ) ); } else { Utils\report_batch_operation_results( 'image', 'fix', $count, $successes, $errors ); } } /** * Perform orientation fix on attachments. * * @param int $id Attachment Id. * @param string $progress Current progress string. * @param int $successes Count of success in current operation. * @param int $errors Count of errors in current operation. * @param bool $dry_run Is this a dry run? */ private function process_orientation_fix( $id, $progress, &$successes, &$errors, $dry_run ) { $title = get_the_title( $id ); if ( '' === $title ) { // If audio or video cover art then the id is the sub attachment id, which has no title. if ( metadata_exists( 'post', $id, '_cover_hash' ) ) { // Unfortunately the only way to get the attachment title would be to do a non-indexed query against the meta value of `_thumbnail_id`. So don't. $att_desc = sprintf( 'cover attachment (ID %d)', $id ); } else { $att_desc = sprintf( '"(no title)" (ID %d)', $id ); } } else { $att_desc = sprintf( '"%1$s" (ID %2$d)', $title, $id ); } $full_size_path = $this->get_attached_file( $id ); if ( false === $full_size_path || ! file_exists( $full_size_path ) ) { WP_CLI::warning( "Can't find {$att_desc}." ); ++$errors; return; } // Get current metadata of the attachment. $metadata = wp_generate_attachment_metadata( $id, $full_size_path ); $image_meta = ! empty( $metadata['image_meta'] ) ? $metadata['image_meta'] : []; if ( isset( $image_meta['orientation'] ) && absint( $image_meta['orientation'] ) > 1 ) { if ( ! $dry_run ) { WP_CLI::log( "{$progress} Fixing orientation for {$att_desc}." ); if ( false !== $this->flip_rotate_image( $id, $metadata, $image_meta, $full_size_path ) ) { ++$successes; } else { ++$errors; WP_CLI::log( "Couldn't fix orientation for {$att_desc}." ); } } else { WP_CLI::log( "{$progress} {$att_desc} will be affected." ); ++$successes; } } else { WP_CLI::log( "{$progress} No orientation fix required for {$att_desc}." ); } } /** * Perform image rotate operations on the image. * * @param int $id Attachment Id. * @param array $metadata Attachment Metadata. * @param array $image_meta `image_meta` information for the attachment. * @param string $full_size_path Path to original image. * * @return bool Whether the image rotation operation succeeded. */ private function flip_rotate_image( $id, $metadata, $image_meta, $full_size_path ) { $editor = wp_get_image_editor( $full_size_path ); if ( ! is_wp_error( $editor ) ) { $operations = $this->calculate_transformation( (int) $image_meta['orientation'] ); // Rotate image if required. if ( true === $operations['rotate'] ) { $editor->rotate( $operations['degree'] ); } // Flip image if required. if ( false !== $operations['flip'] ) { $editor->flip( $operations['flip'][0], $operations['flip'][1] ); } // Save the image and generate metadata. $editor->save( $full_size_path ); $metadata = wp_generate_attachment_metadata( $id, $full_size_path ); $image_meta = empty( $metadata['image_meta'] ) ? [] : $metadata['image_meta']; // Update attachment metadata with newly generated data. wp_update_attachment_metadata( $id, $metadata ); if ( isset( $image_meta['orientation'] ) && absint( $image_meta['orientation'] ) === 0 ) { return true; } } return false; } /** * Return array of operations to be done for provided orientation value. * * @param int $orientation EXIF orientation value. * * @return array */ private function calculate_transformation( $orientation ) { $rotate = false; $flip = false; $degree = 0; switch ( $orientation ) { case 2: $flip = [ false, true ]; // $flip image along given axis [ horizontal, vertical ] break; case 3: $flip = [ true, true ]; break; case 4: $flip = [ true, false ]; break; case 5: $degree = -90; $rotate = true; $flip = [ false, true ]; break; case 6: $degree = -90; $rotate = true; break; case 7: $degree = 90; $rotate = true; $flip = [ false, true ]; break; case 8: $degree = 90; $rotate = true; break; default: $degree = 0; $rotate = true; break; } return [ 'flip' => $flip, 'degree' => $degree, 'rotate' => $rotate, ]; } /** * Add compatibility indirection to get_attached_file(). * * In WordPress 5.3, behavior changed to account for automatic resizing of * big image files. * * @see https://core.trac.wordpress.org/ticket/47873 * * @param int $attachment_id ID of the attachment to get the filepath for. * @return string|false Filepath of the attachment, or false if not found. */ private function get_attached_file( $attachment_id ) { if ( function_exists( 'wp_get_original_image_path' ) ) { $filepath = wp_get_original_image_path( $attachment_id ); if ( false !== $filepath ) { return $filepath; } } return get_attached_file( $attachment_id ); } /** * Image-friendly alternative to wp_get_attachment_url(). Will return the full size URL of an image instead of the `-scaled` version. * * In WordPress 5.3, behavior changed to account for automatic resizing of * big image files. * * @see https://core.trac.wordpress.org/ticket/47873 * * @param int $attachment_id ID of the attachment to get the URL for. * @return string|false URL of the attachment, or false if not found. */ private function get_real_attachment_url( $attachment_id ) { if ( function_exists( 'wp_get_original_image_url' ) ) { $url = wp_get_original_image_url( $attachment_id ); if ( false !== $url ) { return $url; } } return wp_get_attachment_url( $attachment_id ); } /** * Create image slug based on user input slug. * Add basename extension to slug. * * @param string $basename Default slu of image. * @param string $slug User input slug. * * @return string Image slug with extension. */ private function get_image_name( $basename, $slug ) { $extension = pathinfo( $basename, PATHINFO_EXTENSION ); return $slug . '.' . $extension; } /** * Removes files for unknown/unregistered image sizes. * * Similar to {@see self::remove_old_images} but also updates metadata afterwards. * * @param int $id Attachment ID. * @param string $fullsizepath Filepath of the attachment. * * @return void */ private function delete_unknown_image_sizes( $id, $fullsizepath ) { $original_meta = wp_get_attachment_metadata( $id ); $image_sizes = wp_list_pluck( $this->get_registered_image_sizes(), 'name' ); $dir_path = dirname( $fullsizepath ) . '/'; $sizes_to_delete = array(); if ( isset( $original_meta['sizes'] ) ) { foreach ( $original_meta['sizes'] as $size_name => $size_meta ) { if ( 'full' === $size_name ) { continue; } if ( ! in_array( $size_name, $image_sizes, true ) ) { $intermediate_path = $dir_path . $size_meta['file']; if ( $intermediate_path === $fullsizepath ) { continue; } if ( file_exists( $intermediate_path ) ) { unlink( $intermediate_path ); } $sizes_to_delete[] = $size_name; } } foreach ( $sizes_to_delete as $size_name ) { unset( $original_meta['sizes'][ $size_name ] ); } } wp_update_attachment_metadata( $id, $original_meta ); } } <?php /** * This script is added via the `WP_CLI_REQUIRE` environment variable to the WP-CLI commands executed by the Behat test runner. * It starts coverage collection right away and registers a shutdown hook to complete it * after the respective WP-CLI command has finished. */ use SebastianBergmann\CodeCoverage\CodeCoverage; use SebastianBergmann\CodeCoverage\Driver\Selector; use SebastianBergmann\CodeCoverage\Filter; use SebastianBergmann\CodeCoverage\Report\PHP as PHPReport; /* * The names of the current feature and scenario are passed on from the Behat test runner * to this script through environment variables. */ $feature = getenv( 'BEHAT_FEATURE_TITLE' ); $scenario = getenv( 'BEHAT_SCENARIO_TITLE' ); $step_line = (int) getenv( 'BEHAT_STEP_LINE' ); $name = "{$feature} - {$scenario} - {$step_line}"; /* * Do not run coverage if they are empty, which means we are running some command * during test preparation, e.g. the `wp core download` in `FeatureContext::prepare()`. */ if ( empty( $feature ) | empty( $scenario ) ) { return; } $project_dir = (string) getenv( 'TEST_RUN_DIR' ); if ( ! class_exists( 'SebastianBergmann\CodeCoverage\Filter' ) ) { if ( ! file_exists( $project_dir . '/vendor/autoload.php' ) ) { die( 'Could not load dependencies for generating code coverage' ); } require "{$project_dir}/vendor/autoload.php"; } $filtered_items = new CallbackFilterIterator( new DirectoryIterator( $project_dir ), function ( $file ) { // Allow directories named "php" or "src" if ( $file->isDir() && in_array( $file->getFilename(), [ 'php', 'src' ], true ) ) { return true; } // Allow top-level files ending in "-command.php" if ( $file->isFile() && false !== strpos( $file->getFilename(), '-command.php' ) ) { return true; } return false; } ); $files = []; foreach ( $filtered_items as $item ) { if ( $item->isDir() ) { foreach ( new RecursiveIteratorIterator( new RecursiveDirectoryIterator( $item->getPathname(), RecursiveDirectoryIterator::SKIP_DOTS ) ) as $file ) { if ( $file->isFile() && $file->getExtension() === 'php' ) { $files[] = $file->getPathname(); } } } else { $files[] = $item->getPathname(); } } $filter = new Filter(); $filter->includeFiles( $files ); $coverage = new CodeCoverage( ( new Selector() )->forLineCoverage( $filter ), $filter ); $coverage->start( $name ); register_shutdown_function( static function () use ( $coverage, $feature, $scenario, $step_line, $name, $project_dir ) { $coverage->stop(); $feature_suffix = preg_replace( '/[^a-z0-9]+/', '-', strtolower( $feature ) ); $scenario_suffix = preg_replace( '/[^a-z0-9]+/', '-', strtolower( $scenario ) ); $db_type = strtolower( getenv( 'WP_CLI_TEST_DBTYPE' ) ); $destination = "$project_dir/build/logs/$feature_suffix-$scenario_suffix-$step_line-$db_type.cov"; $dir = dirname( $destination ); if ( ! file_exists( $dir ) ) { mkdir( $dir, 0777, true /*recursive*/ ); } ( new PHPReport() )->process( $coverage, $destination ); } ); <?php /** * Polyfills used by Behat to support multiple versions of WP. * * This file will get installed as a must-use plugin in WP installs that are run * by the functional tests. */ /* * Add a polyfill for the get_theme_file_uri(), as it is required for the * TwentyTwenty theme's starter content, and will fatal the site if you install * WP 5.3 first (setting TwentyTwenty as the active theme) and then downgrade * to a version of WP lower than 4.7. * * Note: This is a quick fix, and a cleaner solution would be to change the * active theme on downgrading, if the current theme declares it is not * supported. * * See: https://github.com/WordPress/twentytwenty/issues/973 */ if ( ! function_exists( 'get_theme_file_uri' ) ) { /** * Retrieves the URL of a file in the theme. * * Searches in the stylesheet directory before the template directory so themes * which inherit from a parent theme can just override one file. * * @since 4.7.0 * * @param string $file Optional. File to search for in the stylesheet directory. * @return string The URL of the file. */ function get_theme_file_uri( $file = '' ) { $file = ltrim( $file, '/' ); if ( empty( $file ) ) { $url = get_stylesheet_directory_uri(); } elseif ( file_exists( get_stylesheet_directory() . '/' . $file ) ) { $url = get_stylesheet_directory_uri() . '/' . $file; } else { $url = get_template_directory_uri() . '/' . $file; } /** * Filters the URL to a file in the theme. * * @since 4.7.0 * * @param string $url The file URL. * @param string $file The requested file to search for. */ return apply_filters( 'theme_file_uri', $url, $file ); } } /* * Add a polyfill for the is_customize_preview(), as it is required for the * TwentyTwenty theme's starter content, and will fatal the site if you install * WP 5.3 first (setting TwentyTwenty as the active theme) and then downgrade * to a version of WP lower than 4.0. * * Note: This is a quick fix, and a cleaner solution would be to change the * active theme on downgrading, if the current theme declares it is not * supported. * * See: https://github.com/WordPress/twentytwenty/issues/973 */ if ( ! function_exists( 'is_customize_preview' ) ) { /** * Whether the site is being previewed in the Customizer. * * @since 4.0.0 * * @global WP_Customize_Manager $wp_customize Customizer instance. * * @return bool True if the site is being previewed in the Customizer, false otherwise. */ function is_customize_preview() { return false; } } <?php /** * This file is copied as a mu-plugin into new WP installs to reroute normal * mails into log entries. */ /** * Replace WP native pluggable wp_mail function for test purposes. * * @param string|string[] $to Array or comma-separated list of email addresses to send message. * @return bool Whether the email was sent successfully. * * @phpcs:disable WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedFunctionFound -- WP native function. */ function wp_mail( $to ) { if ( is_array( $to ) ) { $to = join( ', ', $to ); } // Log for testing purposes WP_CLI::log( "WP-CLI test suite: Sent email to {$to}." ); // Assume sending mail always succeeds. return true; } // phpcs:enable #!/bin/sh # Run the code style check only if a configuration file exists. if [ -f ".phpcs.xml" ] || [ -f "phpcs.xml" ] || [ -f ".phpcs.xml.dist" ] || [ -f "phpcs.xml.dist" ] then vendor/bin/phpcbf "$@" fi #!/bin/sh # Run the unit tests, if they exist if [ -f "phpunit.xml" ] || [ -f "phpunit.xml.dist" ] || [ -f ".phpunit.xml" ] || [ -f ".phpunit.xml.dist" ] then PHPUNIT_VERSION=$(vendor/bin/phpunit --version | grep --only-matching --max-count=1 --extended-regexp '\b[0-9]+\.[0-9]+') EXTRA_ARGS="" if [ "${PHPUNIT_VERSION#11}" != "$PHPUNIT_VERSION" ] || [ "${PHPUNIT_VERSION#10}" != "$PHPUNIT_VERSION" ]; then EXTRA_ARGS="--display-warnings --fail-on-warning --display-notices --fail-on-notice --display-deprecations --fail-on-deprecation" fi if [ -f "./vendor/wp-cli/wp-cli-tests/tests/bootstrap.php" ]; then vendor/bin/phpunit --color=always "$@" $EXTRA_ARGS --bootstrap ./vendor/wp-cli/wp-cli-tests/tests/bootstrap.php else vendor/bin/phpunit --color=always "$@" $EXTRA_ARGS fi fi #!/bin/sh # Run the code style check only if a configuration file exists. if [ -f ".phpcs.xml" ] || [ -f "phpcs.xml" ] || [ -f ".phpcs.xml.dist" ] || [ -f "phpcs.xml.dist" ] then vendor/bin/phpcs "$@" fi <?php namespace WP_CLI\Tests\Context; use WP_CLI\Process; use Exception; trait WhenStepDefinitions { public function wpcli_tests_invoke_proc( $proc, $mode ) { $map = array( 'run' => 'run_check_stderr', 'try' => 'run', ); $method = $map[ $mode ]; return $proc->$method(); } public function wpcli_tests_capture_email_sends( $stdout ) { $stdout = preg_replace( '#WP-CLI test suite: Sent email to.+\n?#', '', $stdout, -1, $email_sends ); return array( $stdout, $email_sends ); } /** * Launch a given command in the background. * * ``` * Scenario: My example scenario * Given a WP install * And I launch in the background `wp server --host=localhost --port=8181` * ... * ``` * * @access public * * @When /^I launch in the background `([^`]+)`$/ */ public function when_i_launch_in_the_background( $cmd ) { $this->background_proc( $cmd ); } /** * Run or try a given command. * * `run` expects an exit code 0, whereas `try` allows for non-zero exit codes. * * So if using `run` and the command errors, the step will fail. * * ``` * Scenario: My example scenario * When I run `wp core version` * Then STDOUT should contain: * """ * 6.8 * """ * * Scenario: My other scenario * When I try `wp i18n make-pot foo bar/baz.pot` * Then STDERR should contain: * """ * Error: Not a valid source directory. * """ * And the return code should be 1 * ``` * * @access public * * @When /^I (run|try) `([^`]+)`$/ */ public function when_i_run( $mode, $cmd ) { $cmd = $this->replace_variables( $cmd ); $this->result = $this->wpcli_tests_invoke_proc( $this->proc( $cmd ), $mode ); list( $this->result->stdout, $this->email_sends ) = $this->wpcli_tests_capture_email_sends( $this->result->stdout ); } /** * Run or try a given command in a subdirectory. * * `run` expects an exit code 0, whereas `try` allows for non-zero exit codes. * * ``` * Scenario: My example scenario * When I run `wp core is-installed` * Then STDOUT should be empty * * When I run `wp core is-installed` from 'foo/wp-content' * Then STDOUT should be empty * ``` * * @access public * * @When /^I (run|try) `([^`]+)` from '([^\s]+)'$/ */ public function when_i_run_from_a_subfolder( $mode, $cmd, $subdir ) { $cmd = $this->replace_variables( $cmd ); $this->result = $this->wpcli_tests_invoke_proc( $this->proc( $cmd, array(), $subdir ), $mode ); list( $this->result->stdout, $this->email_sends ) = $this->wpcli_tests_capture_email_sends( $this->result->stdout ); } /** * Run or try the previous command again. * * `run` expects an exit code 0, whereas `try` allows for non-zero exit codes. * * ``` * Scenario: My example scenario * When I run `wp site option update admin_user_id 1` * Then STDOUT should contain: * """ * Success: Updated 'admin_user_id' site option. * """ * * When I run the previous command again * Then STDOUT should contain: * """ * Success: Value passed for 'admin_user_id' site option is unchanged. * """ * ``` * * @access public * * @When /^I (run|try) the previous command again$/ */ public function when_i_run_the_previous_command_again( $mode ) { if ( ! isset( $this->result ) ) { throw new Exception( 'No previous command.' ); } $proc = Process::create( $this->result->command, $this->result->cwd, $this->result->env ); $this->result = $this->wpcli_tests_invoke_proc( $proc, $mode ); list( $this->result->stdout, $this->email_sends ) = $this->wpcli_tests_capture_email_sends( $this->result->stdout ); } } <?php namespace WP_CLI\Tests\Context; use Behat\Gherkin\Node\PyStringNode; use Behat\Gherkin\Node\TableNode; use Exception; use Requests; use RuntimeException; trait ThenStepDefinitions { use Support; /** * Expect a specific exit code of the previous command. * * ``` * Scenario: My example scenario * Given a WP installation * When I try `wp plugin install` * Then the return code should be 1 * ``` * * @access public * * @Then /^the return code should( not)? be (\d+)$/ */ public function then_the_return_code_should_be( $not, $return_code ) { if ( ( ! $not && (int) $return_code !== $this->result->return_code ) || ( $not && (int) $return_code === $this->result->return_code ) ) { throw new RuntimeException( $this->result ); } } /** * Check the contents of STDOUT or STDERR. * * ``` * Scenario: My example scenario * Given an empty directory * When I run `wp core is-installed` * Then STDOUT should be empty * * Scenario: My other scenario * Given a WP install * When I run `wp plugin install akismet` * Then STDOUT should contain: * """ * Plugin installed successfully. * """ * And STDERR should be empty * ``` * * @access public * * @Then /^(STDOUT|STDERR) should( strictly)? (be|contain|not contain):$/ */ public function then_stdout_stderr_should_contain( $stream, $strictly, $action, PyStringNode $expected ) { $stream = strtolower( $stream ); $expected = $this->replace_variables( (string) $expected ); $this->check_string( $this->result->$stream, $expected, $action, $this->result, (bool) $strictly ); } /** * Expect STDOUT or STDERR to be a numeric value. * * ``` * Scenario: My example scenario * Given a WP installation * When I run `wp db size --size_format=b` * Then STDOUT should be a number * ``` * * @access public * * @Then /^(STDOUT|STDERR) should be a number$/ */ public function then_stdout_stderr_should_be_a_number( $stream ) { $stream = strtolower( $stream ); $this->assert_numeric( trim( $this->result->$stream, "\n" ) ); } /** * Expect STDOUT or STDERR to not be a numeric value. * * ``` * Scenario: My example scenario * Given a WP installation * When I run `wp post list --format=json` * Then STDOUT should not be a number * ``` * * @access public * * @Then /^(STDOUT|STDERR) should not be a number$/ */ public function then_stdout_stderr_should_not_be_a_number( $stream ) { $stream = strtolower( $stream ); $this->assert_not_numeric( trim( $this->result->$stream, "\n" ) ); } /** * Expect STDOUT to be a table containing the given rows. * * ``` * Scenario: My example scenario * Given a WP installation * When I run `wp config list --fields=name,type` * Then STDOUT should be a table containing rows: * | name | type | * | DB_NAME | constant | * | DB_USER | constant | * ``` * * @access public * * @Then /^STDOUT should be a table containing rows:$/ */ public function then_stdout_should_be_a_table_containing_rows( TableNode $expected ) { $output = $this->result->stdout; $actual_rows = explode( "\n", rtrim( $output, "\n" ) ); $expected_rows = array(); foreach ( $expected->getRows() as $row ) { $expected_rows[] = $this->replace_variables( implode( "\t", $row ) ); } $this->compare_tables( $expected_rows, $actual_rows, $output ); } /** * Expect STDOUT to end with a table containing the given rows. * * Useful when the table is preceded by some other output. * * ``` * Scenario: My example scenario * Given a WP installation * When I run `wp search-replace foo bar --report-changed-only` * Then STDOUT should contain: * """ * Success: Made 3 replacements. * """ * And STDOUT should end with a table containing rows: * | Table | Column | Replacements | Type | * | wp_options | option_value | 1 | PHP | * | wp_postmeta | meta_value | 1 | SQL | * | wp_posts | post_title | 1 | SQL | * ``` * * @access public * * @Then /^STDOUT should end with a table containing rows:$/ */ public function then_stdout_should_end_with_a_table_containing_rows( TableNode $expected ) { $output = $this->result->stdout; $actual_rows = explode( "\n", rtrim( $output, "\n" ) ); $expected_rows = array(); foreach ( $expected->getRows() as $row ) { $expected_rows[] = $this->replace_variables( implode( "\t", $row ) ); } $start = array_search( $expected_rows[0], $actual_rows, true ); if ( false === $start ) { throw new Exception( $this->result ); } $this->compare_tables( $expected_rows, array_slice( $actual_rows, $start ), $output ); } /** * Expect valid JSON output in STDOUT. * * ``` * Scenario: My example scenario * When I run `wp post meta get 1 meta-key --format=json` * Then STDOUT should be JSON containing: * """ * { * "foo": "baz" * } * """ * ``` * * @access public * * @Then /^STDOUT should be JSON containing:$/ */ public function then_stdout_should_be_json_containing( PyStringNode $expected ) { $output = $this->result->stdout; $expected = $this->replace_variables( (string) $expected ); if ( ! $this->check_that_json_string_contains_json_string( $output, $expected ) ) { throw new Exception( $this->result ); } } /** * Expect valid JSON array output in STDOUT. * * Errors when some items are missing from the expected array. * * ``` * Scenario: My example scenario * When I run `wp plugin list --field=name --format=json` * Then STDOUT should be a JSON array containing: * """ * ["akismet", "hello-dolly"] * """ * ``` * * @access public * * @Then /^STDOUT should be a JSON array containing:$/ */ public function then_stdout_should_be_a_json_array_containing( PyStringNode $expected ) { $output = $this->result->stdout; $expected = $this->replace_variables( (string) $expected ); $actual_values = json_decode( $output ); $expected_values = json_decode( $expected ); $missing = array_diff( $expected_values, $actual_values ); if ( ! empty( $missing ) ) { throw new Exception( $this->result ); } } /** * Expect STDOUT to be CSV containing certain values. * * ``` * Scenario: My example scenario * When I run `wp term list post_tag --fields=name,slug --format=csv` * Then STDOUT should be CSV containing: * | name | slug | * | Test term | test | * ``` * * @access public * * @Then /^STDOUT should be CSV containing:$/ */ public function then_stdout_should_be_csv_containing( TableNode $expected ) { $output = $this->result->stdout; $expected_rows = $expected->getRows(); foreach ( $expected as &$row ) { foreach ( $row as &$value ) { $value = $this->replace_variables( $value ); } } if ( ! $this->check_that_csv_string_contains_values( $output, $expected_rows ) ) { throw new Exception( $this->result ); } } /** * Expect STDOUT to be YAML containig certain content. * * ``` * Scenario: My example scenario * When I run `wp cli alias list` * Then STDOUT should be YAML containing: * """ * @all: Run command against every registered alias. * @foo: * path: {TEST_DIR}/foo * """ * ``` * * @access public * * @Then /^STDOUT should be YAML containing:$/ */ public function then_stdout_should_be_yaml_containing( PyStringNode $expected ) { $output = $this->result->stdout; $expected = $this->replace_variables( (string) $expected ); if ( ! $this->check_that_yaml_string_contains_yaml_string( $output, $expected ) ) { throw new Exception( $this->result ); } } /** * Expect STDOUT or STDERR to be empty. * * ``` * Scenario: My other scenario * Given a WP install * When I run `wp plugin install akismet` * Then STDERR should be empty * ``` * * @access public * * @Then /^(STDOUT|STDERR) should be empty$/ */ public function then_stdout_stderr_should_be_empty( $stream ) { $stream = strtolower( $stream ); if ( ! empty( $this->result->$stream ) ) { throw new Exception( $this->result ); } } /** * Expect STDOUT or STDERR not to be empty. * * ``` * Scenario: My example scenario * When I run `wp user create examplejane jane@example.com` * Then STDOUT should not be empty * ``` * * @access public * * @Then /^(STDOUT|STDERR) should not be empty$/ */ public function then_stdout_stderr_should_not_be_empty( $stream ) { $stream = strtolower( $stream ); if ( '' === rtrim( $this->result->$stream, "\n" ) ) { throw new Exception( $this->result ); } } /** * Expect STDOUT or STDERR to be a version string comparing to the given version. * * ``` * Scenario: My example scenario * Given a WP install * When I run `wp core version * Then STDOUT should be a version string >= 6.8 * ``` * * @access public * * @Then /^(STDOUT|STDERR) should be a version string (<|<=|>|>=|==|=|!=|<>) ([+\w.{}-]+)$/ */ public function then_stdout_stderr_should_be_a_specific_version_string( $stream, $operator, $goal_ver ) { $goal_ver = $this->replace_variables( $goal_ver ); $stream = strtolower( $stream ); if ( false === version_compare( trim( $this->result->$stream, "\n" ), $goal_ver, $operator ) ) { throw new Exception( $this->result ); } } /** * Expect a certain file or directory to (not) exist or (not) contain certain contents. * * ``` * Scenario: My example scenario * When I run `wp core download` * Then the wp-settings.php file should exist * And the wp-content directory should exist * And the {RUN_DIR} directory should contain: * """ * index.php * license.txt * """ * And the wp-config.php file should contain: * """ * That's all, stop editing! Happy publishing. * """ * ``` * * @access public * * @Then /^the (.+) (file|directory) should( strictly)? (exist|not exist|be:|contain:|not contain:)$/ */ public function then_a_specific_file_folder_should_exist( $path, $type, $strictly, $action, $expected = null ) { $path = $this->replace_variables( $path ); // If it's a relative path, make it relative to the current test dir. if ( '/' !== $path[0] ) { $path = $this->variables['RUN_DIR'] . "/$path"; } $exists = static function ( $path ) use ( $type ) { // Clear the stat cache for the path first to avoid // potentially inaccurate results when files change outside of PHP. // See https://www.php.net/manual/en/function.clearstatcache.php clearstatcache( false, $path ); if ( 'directory' === $type ) { return is_dir( $path ); } return file_exists( $path ); }; switch ( $action ) { case 'exist': if ( ! $exists( $path ) ) { throw new Exception( "$path doesn't exist." ); } break; case 'not exist': if ( $exists( $path ) ) { throw new Exception( "$path exists." ); } break; default: if ( ! $exists( $path ) ) { throw new Exception( "$path doesn't exist." ); } $action = substr( $action, 0, -1 ); $expected = $this->replace_variables( (string) $expected ); if ( 'file' === $type ) { $contents = file_get_contents( $path ); } elseif ( 'directory' === $type ) { $files = glob( rtrim( $path, '/' ) . '/*' ); foreach ( $files as &$file ) { $file = str_replace( $path . '/', '', $file ); } $contents = implode( PHP_EOL, $files ); } $this->check_string( $contents, $expected, $action, false, (bool) $strictly ); } } /** * Match file contents against a regex. * * ``` * Scenario: My example scenario * When I run `wp scaffold plugin hello-world` * Then the contents of the wp-content/plugins/hello-world/languages/hello-world.pot file should match /X-Generator:\s/ * ``` * * @access public * * @Then /^the contents of the (.+) file should( not)? match (((\/.+\/)|(#.+#))([a-z]+)?)$/ */ public function then_the_contents_of_a_specific_file_should_match( $path, $not, $expected ) { $path = $this->replace_variables( $path ); $expected = $this->replace_variables( $expected ); // If it's a relative path, make it relative to the current test dir. if ( '/' !== $path[0] ) { $path = $this->variables['RUN_DIR'] . "/$path"; } $contents = file_get_contents( $path ); if ( $not ) { $this->assert_not_regex( $expected, $contents ); } else { $this->assert_regex( $expected, $contents ); } } /** * Match STDOUT or STDERR against a regex. * * ``` * Scenario: My example scenario * When I run `wp dist-archive wp-content/plugins/hello-world` * Then STDOUT should match /^Success: Created hello-world.0.1.0.zip $Size: \d+(?:\.\d*)? [a-zA-Z]{1,3}$$/ * ``` * * @access public * * @Then /^(STDOUT|STDERR) should( not)? match (((\/.+\/)|(#.+#))([a-z]+)?)$/ */ public function then_stdout_stderr_should_match_a_string( $stream, $not, $expected ) { $expected = $this->replace_variables( $expected ); $stream = strtolower( $stream ); if ( $not ) { $this->assert_not_regex( $expected, $this->result->$stream ); } else { $this->assert_regex( $expected, $this->result->$stream ); } } /** * Expect an email to be sent (or not). * * ``` * Scenario: My example scenario * When I run `wp user reset-password 1` * Then an email should be sent * ``` * * @access public * * @Then /^an email should (be sent|not be sent)$/ */ public function then_an_email_should_be_sent( $expected ) { if ( 'be sent' === $expected ) { $this->assert_not_equals( 0, $this->email_sends ); } elseif ( 'not be sent' === $expected ) { $this->assert_equals( 0, $this->email_sends ); } else { throw new Exception( 'Invalid expectation' ); } } /** * Expect the HTTP status code for visiting `http://localhost:8080`. * * ``` * Scenario: My example scenario * Given a WP installation with Composer * And a PHP built-in web server to serve 'WordPress' * Then the HTTP status code should be 200 * ``` * * @access public * * @Then the HTTP status code should be :code */ public function then_the_http_status_code_should_be( $return_code ) { $response = Requests::request( 'http://localhost:8080' ); $this->assert_equals( $return_code, $response->status_code ); } } <?php namespace WP_CLI\Tests\Context; use Behat\Gherkin\Node\PyStringNode; use Behat\Gherkin\Node\TableNode; use RuntimeException; use WP_CLI\Process; use WP_CLI\Utils; trait GivenStepDefinitions { /** * Creates an empty directory. * * ``` * Scenario: My example scenario * Given an empty directory * ... * ``` * * @access public * * @Given an empty directory */ public function given_an_empty_directory() { $this->create_run_dir(); } /** * Creates or deletes a specific directory. * * ``` * Scenario: My example scenario * Given an empty foo-plugin directory * And a non-existent bar-plugin directory * ... * ``` * * @access public * * @Given /^an? (empty|non-existent) ([^\s]+) directory$/ */ public function given_a_specific_directory( $empty_or_nonexistent, $dir ) { $dir = $this->replace_variables( $dir ); if ( ! Utils\is_path_absolute( $dir ) ) { $dir = $this->variables['RUN_DIR'] . "/$dir"; } // Mac OS X can prefix the `/var` folder to turn it into `/private/var`. $dir = preg_replace( '|^/private/var/|', '/var/', $dir ); $temp_dir = sys_get_temp_dir(); // Also check for temp dir prefixed with `/private` for Mac OS X. if ( 0 !== strpos( $dir, $temp_dir ) && 0 !== strpos( $dir, "/private{$temp_dir}" ) ) { throw new RuntimeException( sprintf( "Attempted to delete directory '%s' that is not in the temp directory '%s'. " . __FILE__ . ':' . __LINE__, $dir, $temp_dir ) ); } $this->remove_dir( $dir ); if ( 'empty' === $empty_or_nonexistent ) { mkdir( $dir, 0777, true /*recursive*/ ); } } /** * Clears the WP-CLI cache directory. * * ``` * Scenario: My example scenario * Given an empty cache * ... * ``` * * @access public * * @Given an empty cache */ public function given_an_empty_cache() { $this->variables['SUITE_CACHE_DIR'] = FeatureContext::create_cache_dir(); } /** * Creates a file with the given contents. * * The file can be created either in the current working directory * or in the cache directory. * * ``` * Scenario: My example scenario * Given a wp-cli.yml file: * """ * @foo: * path: foo * user: admin * """ * ``` * * @access public * * @Given /^an? ([^\s]+) (file|cache file):$/ */ public function given_a_specific_file( $path, $type, PyStringNode $content ) { $path = $this->replace_variables( (string) $path ); $content = $this->replace_variables( (string) $content ) . "\n"; $full_path = 'cache file' === $type ? $this->variables['SUITE_CACHE_DIR'] . "/$path" : $this->variables['RUN_DIR'] . "/$path"; $dir = dirname( $full_path ); if ( ! file_exists( $dir ) ) { mkdir( $dir, 0777, true /*recursive*/ ); } file_put_contents( $full_path, $content ); } /** * Search and replace a string in a file using regex. * * ``` * Scenario: My example scenario * Given "Foo" replaced with "Bar" in the readme.html file * ... * ``` * * @access public * * @Given /^"([^"]+)" replaced with "([^"]+)" in the ([^\s]+) file$/ */ public function given_string_replaced_with_string_in_a_specific_file( $search, $replace, $path ) { $full_path = $this->variables['RUN_DIR'] . "/$path"; $contents = file_get_contents( $full_path ); $contents = str_replace( $search, $replace, $contents ); file_put_contents( $full_path, $contents ); } /** * Mock HTTP requests to a given URL. * * ``` * Scenario: My example scenario * Given that HTTP requests to https://api.github.com/repos/wp-cli/wp-cli/releases?per_page=100 will respond with: * """ * HTTP/1.1 200 * Content-Type: application/json * * { "foo": "bar" } * """ * ``` * * @access public * * @Given /^that HTTP requests to (.*?) will respond with:$/ */ public function given_a_request_to_a_url_respond_with_file( $url_or_pattern, PyStringNode $content ) { if ( ! isset( $this->variables['RUN_DIR'] ) ) { $this->create_run_dir(); } $config_file = $this->variables['RUN_DIR'] . '/wp-cli.yml'; $mock_file = $this->variables['RUN_DIR'] . '/mock-requests.php'; $dir = dirname( $config_file ); if ( ! file_exists( $dir ) ) { mkdir( $dir, 0777, true /*recursive*/ ); } $config_file_contents = <<<FILE require: - mock-requests.php FILE; file_put_contents( $config_file, $config_file_contents ); $this->mocked_requests[ $url_or_pattern ] = (string) $content; $mocked_requests = var_export( $this->mocked_requests, true /* return */ ); $mock_file_contents = <<<FILE <?php /** * HTTP request mocking supporting both Requests v1 and v2. */ trait WP_CLI_Tests_Mock_Requests_Trait { public function request( \$url, \$headers = array(), \$data = array(), \$options = array() ) { \$mocked_requests = $mocked_requests; foreach ( \$mocked_requests as \$pattern => \$response ) { \$pattern = '/' . preg_quote( \$pattern, '/' ) . '/'; if ( 1 === preg_match( \$pattern, \$url ) ) { \$pos = strpos( \$response, "\\n\\n"); if ( false !== \$pos ) { \$response = substr( \$response, 0, \$pos ) . "\\r\\n\\r\\n" . substr( \$response, \$pos + 2 ); } return \$response; } } if ( class_exists( '\WpOrg\Requests\Transport\Curl' ) ) { return ( new \WpOrg\Requests\Transport\Curl() )->request( \$url, \$headers, \$data, \$options ); } return ( new \Requests_Transport_cURL() )->request( \$url, \$headers, \$data, \$options ); } public function request_multiple( \$requests, \$options ) { throw new Exception( 'Method not implemented: ' . __METHOD__ ); } public static function test( \$capabilities = array() ) { return true; } } if ( interface_exists( '\WpOrg\Requests\Transport' ) ) { class WP_CLI_Tests_Mock_Requests_Transport implements \WpOrg\Requests\Transport { use WP_CLI_Tests_Mock_Requests_Trait; } } else { class WP_CLI_Tests_Mock_Requests_Transport implements \Requests_Transport { use WP_CLI_Tests_Mock_Requests_Trait; } } WP_CLI::add_hook( 'http_request_options', static function( \$options ) { \$options['transport'] = new WP_CLI_Tests_Mock_Requests_Transport(); return \$options; } ); WP_CLI::add_wp_hook( 'pre_http_request', static function( \$pre, \$parsed_args, \$url ) { \$mocked_requests = $mocked_requests; foreach ( \$mocked_requests as \$pattern => \$response ) { \$pattern = '/' . preg_quote( \$pattern, '/' ) . '/'; if ( 1 === preg_match( \$pattern, \$url ) ) { \$pos = strpos( \$response, "\n\n"); if ( false !== \$pos ) { \$response = substr( \$response, 0, \$pos ) . "\r\n\r\n" . substr( \$response, \$pos + 2 ); } if ( class_exists( '\WpOrg\Requests\Requests' ) ) { WpOrg\Requests\Requests::parse_multiple( \$response, array( 'url' => \$url, 'headers' => array(), 'data' => array(), 'options' => array_merge( WpOrg\Requests\Requests::OPTION_DEFAULTS, array( 'hooks' => new WpOrg\Requests\Hooks(), ) ), ) ); } else { \Requests::parse_multiple( \$response, array( 'url' => \$url, 'headers' => array(), 'data' => array(), 'options' => array( 'blocking' => true, 'filename' => false, 'follow_redirects' => true, 'redirected' => 0, 'redirects' => 10, 'hooks' => new Requests_Hooks(), ), ) ); } return array( 'headers' => \$response->headers->getAll(), 'body' => \$response->body, 'response' => array( 'code' => \$response->status_code, 'message' => get_status_header_desc( \$response->status_code ), ), 'cookies' => array(), 'filename' => '', ); } } return \$pre; }, 10, 3 ); FILE; file_put_contents( $mock_file, $mock_file_contents ); } /** * Download WordPress files without installing. * * ``` * Scenario: My example scenario * Given an empty directory * And WP files * ``` * * @access public * * @Given WP files */ public function given_wp_files() { $this->download_wp(); } /** * Create a wp-config.php file using `wp config create`. * * ``` * Scenario: My example scenario * Given an empty directory * And WP files * And wp-config.php * ``` * * @access public * * @Given wp-config.php */ public function given_wp_config_php() { $this->create_config(); } /** * Creates an empty database. * * Has no effect when tests run with SQLite. * * ``` * Scenario: My example scenario * Given a database * ... * ``` * * @access public * * @Given a database */ public function given_a_database() { $this->create_db(); } /** * Installs WordPress. * * ``` * Scenario: My example scenario * Given a WP installation * ... * * Scenario: My other scenario * Given a WP install * ... * ``` * * @access public * * @Given a WP install(ation) */ public function given_a_wp_installation() { $this->install_wp(); } /** * Installs WordPress in a given directory. * * ``` * Scenario: My example scenario * Given a WP installation in 'foo' * ... * * Scenario: My other scenario * Given a WP install in 'bar' * ... * ``` * * @access public * * @Given a WP install(ation) in :subdir */ public function given_a_wp_installation_in_a_specific_folder( $subdir ) { $this->install_wp( $subdir ); } /** * Installs WordPress with Composer. * * ``` * Scenario: My example scenario * Given a WP installation with Composer * ... * * Scenario: My other scenario * Given a WP install with Composer * ... * ``` * * @access public * * @Given a WP install(ation) with Composer */ public function given_a_wp_installation_with_composer() { $this->install_wp_with_composer(); } /** * Installs WordPress with Composer and a custom vendor directory. * * ``` * Scenario: My example scenario * Given a WP installation with Composer and a custom vendor directory 'vendor-custom' * ... * * Scenario: My other scenario * Given a WP install with Composer with Composer and a custom vendor directory 'vendor-custom' * ... * ``` * * @access public * * @Given a WP install(ation) with Composer and a custom vendor directory :vendor_directory */ public function given_a_wp_installation_with_composer_and_a_custom_vendor_folder( $vendor_directory ) { $this->install_wp_with_composer( $vendor_directory ); } /** * Installs WordPress Multisite. * * Supports either subdirectory or subdomain installation. * * ``` * Scenario: My example scenario * Given a WP multisite subdomain installation * ... * * Scenario: My other scenario * Given a WP subdirectory install * ... * ``` * * @access public * * @Given /^a WP multisite (subdirectory|subdomain)?\s?(install|installation)$/ */ public function given_a_wp_multisite_installation( $type = 'subdirectory' ) { $this->install_wp(); $subdomains = ! empty( $type ) && 'subdomain' === $type ? 1 : 0; $this->proc( 'wp core install-network', array( 'title' => 'WP CLI Network', 'subdomains' => $subdomains, ) )->run_check(); } /** * Installs and activates one or more plugins. * * ``` * Scenario: My example scenario * Given a WP installation * And these installed and active plugins: * """ * akismet * wordpress-importer * """ * ``` * * @access public * * @Given these installed and active plugins: */ public function given_these_installed_and_active_plugins( $stream ) { $plugins = implode( ' ', array_map( 'trim', explode( PHP_EOL, (string) $stream ) ) ); $plugins = $this->replace_variables( $plugins ); $this->proc( "wp plugin install $plugins --activate" )->run_check(); } /** * Configure a custom `wp-content` directory. * * Defines the `WP_CONTENT_DIR`, `WP_PLUGIN_DIR`, and `WPMU_PLUGIN_DIR` constants. * * ``` * Scenario: My example scenario * Given a WP install * And a custom wp-content directory * ``` * * @access public * * @Given a custom wp-content directory */ public function given_a_custom_wp_directory() { $wp_config_path = $this->variables['RUN_DIR'] . '/wp-config.php'; $wp_config_code = file_get_contents( $wp_config_path ); $this->move_files( 'wp-content', 'my-content' ); $this->add_line_to_wp_config( $wp_config_code, "define( 'WP_CONTENT_DIR', dirname(__FILE__) . '/my-content' );" ); $this->move_files( 'my-content/plugins', 'my-plugins' ); $this->add_line_to_wp_config( $wp_config_code, "define( 'WP_PLUGIN_DIR', __DIR__ . '/my-plugins' );" ); $this->move_files( 'my-content/mu-plugins', 'my-mu-plugins' ); $this->add_line_to_wp_config( $wp_config_code, "define( 'WPMU_PLUGIN_DIR', __DIR__ . '/my-mu-plugins' );" ); file_put_contents( $wp_config_path, $wp_config_code ); if ( 'sqlite' === self::$db_type ) { $db_dropin = $this->variables['RUN_DIR'] . '/my-content/db.php'; /* similar to https://github.com/WordPress/sqlite-database-integration/blob/3306576c9b606bc23bbb26c15383fef08e03ab11/activate.php#L95 */ $file_contents = str_replace( 'mu-plugins/', '../my-mu-plugins/', file_get_contents( $db_dropin ) ); file_put_contents( $db_dropin, $file_contents ); } } /** * Download multiple files into the given destinations. * * ``` * Scenario: My example scenario * Given download: * | path | url | * | {CACHE_DIR}/foo.jpg | https://example.com/foo.jpg | * | {CACHE_DIR}/bar.png | https://example.com/another-image.png | * ``` * * @access public * * @Given download: */ public function given_a_download( TableNode $table ) { foreach ( $table->getHash() as $row ) { $path = $this->replace_variables( $row['path'] ); if ( file_exists( $path ) ) { // Assume it's the same file and skip re-download. continue; } Process::create( Utils\esc_cmd( 'curl -sSL %s > %s', $row['url'], $path ) )->run_check(); } } /** * Store STDOUT or STDERR contents in a variable. * * ``` * Scenario: My example scenario * When I run `wp package path` * Then save STDOUT as {PACKAGE_PATH} * * Scenario: My other scenario * When I run `wp core download` * Then save STDOUT 'Downloading WordPress ([\d\.]+)' as {VERSION} * ``` * * @access public * * @Given /^save (STDOUT|STDERR) ([\'].+[^\'])?\s?as \{(\w+)\}$/ */ public function given_saved_stdout_stderr( $stream, $output_filter, $key ) { $stream = strtolower( $stream ); if ( $output_filter ) { $output_filter = '/' . trim( str_replace( '%s', '(.+[^\b])', $output_filter ), "' " ) . '/'; if ( false !== preg_match( $output_filter, $this->result->$stream, $matches ) ) { $output = array_pop( $matches ); } else { $output = ''; } } else { $output = $this->result->$stream; } $this->variables[ $key ] = trim( $output, "\n" ); } /** * Build a new WP-CLI Phar file with a given version. * * ``` * Scenario: My example scenario * Given an empty directory * And a new Phar with version "2.11.0" * ``` * * @access public * * @Given /^a new Phar with (?:the same version|version "([^"]+)")$/ */ public function given_a_new_phar_with_a_specific_version( $version = 'same' ) { $this->build_phar( $version ); } /** * Download a specific WP-CLI Phar version from GitHub. * * ``` * Scenario: My example scenario * Given an empty directory * And a downloaded Phar with version "2.11.0" * * Scenario: My other scenario * Given an empty directory * And a downloaded Phar with the same version * ``` * * @access public * * @Given /^a downloaded Phar with (?:the same version|version "([^"]+)")$/ */ public function given_a_downloaded_phar_with_a_specific_version( $version = 'same' ) { $this->download_phar( $version ); } /** * Stores the contents of the given file in a variable. * * ``` * Scenario: My example scenario * Given a WP installation with Composer * And save the {RUN_DIR}/composer.json file as {COMPOSER_JSON} * ``` * * @access public * * @Given /^save the (.+) file ([\'].+[^\'])?as \{(\w+)\}$/ */ public function given_saved_a_specific_file( $filepath, $output_filter, $key ) { $full_file = file_get_contents( $this->replace_variables( $filepath ) ); if ( $output_filter ) { $output_filter = '/' . trim( str_replace( '%s', '(.+[^\b])', $output_filter ), "' " ) . '/'; if ( false !== preg_match( $output_filter, $full_file, $matches ) ) { $output = array_pop( $matches ); } else { $output = ''; } } else { $output = $full_file; } $this->variables[ $key ] = trim( $output, "\n" ); } /** * Modify wp-config.php to set `WP_CONTENT_DIR` to an empty string. * * ``` * Scenario: My example scenario * Given a WP install * And a misconfigured WP_CONTENT_DIR constant directory * ``` * * @access public * * @Given a misconfigured WP_CONTENT_DIR constant directory */ public function given_a_misconfigured_wp_content_dir_constant_directory() { $wp_config_path = $this->variables['RUN_DIR'] . '/wp-config.php'; $wp_config_code = file_get_contents( $wp_config_path ); $this->add_line_to_wp_config( $wp_config_code, "define( 'WP_CONTENT_DIR', '' );" ); file_put_contents( $wp_config_path, $wp_config_code ); } /** * Add `wp-cli/wp-cli` as a Composer dependency. * * ``` * Scenario: My example scenario * Given a WP installation with Composer * And a dependency on current wp-cli * ``` * * @access public * * @Given a dependency on current wp-cli */ public function given_a_dependency_on_wp_cli() { $this->composer_require_current_wp_cli(); } /** * Start a PHP built-in web server in the current directory. * * ``` * Scenario: My example scenario * Given a WP installation * And a PHP built-in web server * ``` * * @access public * * @Given a PHP built-in web server */ public function given_a_php_built_in_web_server() { $this->start_php_server(); } /** * Start a PHP built-in web server in the given subdirectory. * * ``` * Scenario: My example scenario * Given a WP installation * And a PHP built-in web server to serve 'WordPress' * ``` * * @access public * * @Given a PHP built-in web server to serve :subdir */ public function given_a_php_built_in_web_server_to_serve_a_specific_folder( $subdir ) { $this->start_php_server( $subdir ); } } <?php /** * Utility functions used by the Behat steps. */ namespace WP_CLI\Tests\Context; use Behat\Behat\Exception\PendingException; use Exception; use Mustangostang\Spyc; trait Support { protected function assert_regex( $regex, $actual ) { if ( ! preg_match( $regex, $actual ) ) { throw new Exception( 'Actual value: ' . var_export( $actual, true ) ); } } protected function assert_not_regex( $regex, $actual ) { if ( preg_match( $regex, $actual ) ) { throw new Exception( 'Actual value: ' . var_export( $actual, true ) ); } } protected function assert_equals( $expected, $actual ) { // phpcs:ignore Universal.Operators.StrictComparisons.LooseNotEqual -- Deliberate loose comparison. if ( $expected != $actual ) { throw new Exception( 'Actual value: ' . var_export( $actual, true ) ); } } protected function assert_not_equals( $expected, $actual ) { // phpcs:ignore Universal.Operators.StrictComparisons.LooseEqual -- Deliberate loose comparison. if ( $expected == $actual ) { throw new Exception( 'Actual value: ' . var_export( $actual, true ) ); } } protected function assert_numeric( $actual ) { if ( ! is_numeric( $actual ) ) { throw new Exception( 'Actual value: ' . var_export( $actual, true ) ); } } protected function assert_not_numeric( $actual ) { if ( is_numeric( $actual ) ) { throw new Exception( 'Actual value: ' . var_export( $actual, true ) ); } } protected function check_string( $output, $expected, $action, $message = false, $strictly = false ) { // Strip ANSI color codes before comparing strings. if ( ! $strictly ) { $output = preg_replace( '/\e[[][A-Za-z0-9];?[0-9]*m?/', '', $output ); } switch ( $action ) { case 'be': $r = rtrim( $output, "\n" ) === $expected; break; case 'contain': $r = false !== strpos( $output, $expected ); break; case 'not contain': $r = false === strpos( $output, $expected ); break; default: throw new PendingException(); } if ( ! $r ) { if ( false === $message ) { $message = $output; } throw new Exception( $message ); } } protected function compare_tables( $expected_rows, $actual_rows, $output ) { // The first row is the header and must be present. if ( $expected_rows[0] !== $actual_rows[0] ) { throw new Exception( $output ); } unset( $actual_rows[0] ); unset( $expected_rows[0] ); $missing_rows = array_diff( $expected_rows, $actual_rows ); if ( ! empty( $missing_rows ) ) { throw new Exception( $output ); } } protected function compare_contents( $expected, $actual ) { if ( gettype( $expected ) !== gettype( $actual ) ) { return false; } if ( is_object( $expected ) ) { foreach ( get_object_vars( $expected ) as $name => $value ) { if ( ! $this->compare_contents( $value, $actual->$name ) ) { return false; } } } elseif ( is_array( $expected ) ) { foreach ( $expected as $key => $value ) { if ( ! $this->compare_contents( $value, $actual[ $key ] ) ) { return false; } } } else { return $expected === $actual; } return true; } /** * Compare two strings containing JSON to ensure that $actualJson contains at * least what the JSON string $expectedJson contains. * * @param string $actual_json the JSON string to be tested * @param string $expected_json the expected JSON string * * @return bool Whether or not $actual_json contains $expected_json. * * Examples: * expected: {'a':1,'array':[1,3,5]} * * 1 ) * actual: {'a':1,'b':2,'c':3,'array':[1,2,3,4,5]} * return: true * * 2 ) * actual: {'b':2,'c':3,'array':[1,2,3,4,5]} * return: false * element 'a' is missing from the root object * * 3 ) * actual: {'a':0,'b':2,'c':3,'array':[1,2,3,4,5]} * return: false * the value of element 'a' is not 1 * * 4 ) * actual: {'a':1,'b':2,'c':3,'array':[1,2,4,5]} * return: false * the contents of 'array' does not include 3 */ protected function check_that_json_string_contains_json_string( $actual_json, $expected_json ) { $actual_value = json_decode( $actual_json ); $expected_value = json_decode( $expected_json ); if ( ! $actual_value ) { return false; } return $this->compare_contents( $expected_value, $actual_value ); } /** * Compare two strings to confirm $actualCSV contains $expectedCSV * Both strings are expected to have headers for their CSVs. * $actualCSV must match all data rows in $expectedCSV * * @param string $actual_csv A CSV string * @param array $expected_csv A nested array of values * @return bool Whether $actual_csv contains $expected_csv */ protected function check_that_csv_string_contains_values( $actual_csv, $expected_csv ) { $actual_csv = array_map( static function ( $str ) { return str_getcsv( $str, ',', '"', '\\' ); }, explode( PHP_EOL, $actual_csv ) ); if ( empty( $actual_csv ) ) { return false; } // Each sample must have headers. $actual_headers = array_values( array_shift( $actual_csv ) ); $expected_headers = array_values( array_shift( $expected_csv ) ); // Each expected_csv must exist somewhere in actual_csv in the proper column. $expected_result = 0; foreach ( $expected_csv as $expected_row ) { $expected_row = array_combine( $expected_headers, $expected_row ); foreach ( $actual_csv as $actual_row ) { if ( count( $actual_headers ) !== count( $actual_row ) ) { continue; } $actual_row = array_intersect_key( array_combine( $actual_headers, $actual_row ), $expected_row ); if ( $actual_row === $expected_row ) { ++$expected_result; } } } return $expected_result >= count( $expected_csv ); } /** * Compare two strings containing YAML to ensure that $actualYaml contains at * least what the YAML string $expectedYaml contains. * * @param string $actual_yaml the YAML string to be tested * @param string $expected_yaml the expected YAML string * * @return bool whether or not $actual_yaml contains $expected_json */ protected function check_that_yaml_string_contains_yaml_string( $actual_yaml, $expected_yaml ) { $actual_value = Spyc::YAMLLoad( $actual_yaml ); $expected_value = Spyc::YAMLLoad( $expected_yaml ); if ( ! $actual_value ) { return false; } return $this->compare_contents( $expected_value, $actual_value ); } } <?php namespace WP_CLI\Tests\Context; use Behat\Behat\Context\SnippetAcceptingContext; use Behat\Behat\Hook\Scope\AfterScenarioScope; use Behat\Behat\Hook\Scope\BeforeScenarioScope; use Behat\Testwork\Hook\Scope\AfterSuiteScope; use Behat\Testwork\Hook\Scope\BeforeSuiteScope; use Behat\Behat\Hook\Scope\AfterFeatureScope; use Behat\Behat\Hook\Scope\BeforeFeatureScope; use Behat\Behat\Hook\Scope\BeforeStepScope; use SebastianBergmann\CodeCoverage\Report\Clover; use SebastianBergmann\CodeCoverage\Driver\Selector; use SebastianBergmann\CodeCoverage\Filter; use SebastianBergmann\CodeCoverage\CodeCoverage; use SebastianBergmann\Environment\Runtime; use RuntimeException; use DirectoryIterator; use WP_CLI\Process; use WP_CLI\Utils; use WP_CLI\WpOrgApi; /** * Features context. */ class FeatureContext implements SnippetAcceptingContext { use GivenStepDefinitions; use ThenStepDefinitions; use WhenStepDefinitions; /** * The result of the last command run with `When I run` or `When I try`. Lives until the end of the scenario. */ protected $result; /** * The number of emails sent by the last command run with `When I run` or `When I try`. Lives until the end of the scenario. */ protected $email_sends; /** * The current working directory for scenarios that have a "Given a WP installation" or "Given an empty directory" step. Variable RUN_DIR. Lives until the end of the scenario. */ private static $run_dir; /** * The Directory that 'composer behat' is run from, assumed to always be the top level project folder */ private static $behat_run_dir; /** * Where WordPress core is downloaded to for caching, and which is copied to RUN_DIR during a "Given a WP installation" step. Lives until manually deleted. */ private static $cache_dir; /** * The directory that holds the install cache, and which is copied to RUN_DIR during a "Given a WP installation" step. Recreated on each suite run. */ private static $install_cache_dir; /** * The directory that holds a copy of the sqlite-database-integration plugin, and which is copied to RUN_DIR during a "Given a WP installation" step. Lives until manually deleted. */ private static $sqlite_cache_dir; /** * The directory that the WP-CLI cache (WP_CLI_CACHE_DIR, normally "$HOME/.wp-cli/cache") is set to on a "Given an empty cache" step. * Variable SUITE_CACHE_DIR. Lives until the end of the scenario (or until another "Given an empty cache" step within the scenario). */ private static $suite_cache_dir; /** * Where the current WP-CLI source repository is copied to for Composer-based tests with a "Given a dependency on current wp-cli" step. * Variable COMPOSER_LOCAL_REPOSITORY. Lives until the end of the suite. */ private static $composer_local_repository; /** * The test database settings. All but `dbname` can be set via environment variables. The database is dropped at the start of each scenario and created on a "Given a WP installation" step. */ private static $db_settings = [ 'dbname' => 'wp_cli_test', 'dbuser' => 'wp_cli_test', 'dbpass' => 'password1', 'dbhost' => '127.0.0.1', ]; /** * What type of database should WordPress use for the test installations. Default to MySQL */ private static $db_type = 'mysql'; /** * Name of mysql binary to use (mysql or mariadb). Default to mysql */ private static $mysql_binary = 'mysql'; /** * Array of background process ids started by the current scenario. Used to terminate them at the end of the scenario. */ private $running_procs = []; /** * Array of variables available as {VARIABLE_NAME}. Some are always set: CORE_CONFIG_SETTINGS, DB_USER, DB_PASSWORD, DB_HOST, SRC_DIR, CACHE_DIR, WP_VERSION-version-latest. * Some are step-dependent: RUN_DIR, SUITE_CACHE_DIR, COMPOSER_LOCAL_REPOSITORY, PHAR_PATH. One is set on use: INVOKE_WP_CLI_WITH_PHP_ARGS-args. * Scenarios can define their own variables using "Given save" steps. Variables are reset for each scenario. */ public $variables = []; /** * The current feature file and scenario line number as '<file>.<line>'. Used in RUN_DIR and SUITE_CACHE_DIR directory names. Set at the start of each scenario. */ private static $temp_dir_infix; /** * Settings and variables for WP_CLI_TEST_LOG_RUN_TIMES run time logging. */ private static $log_run_times; // Whether to log run times - WP_CLI_TEST_LOG_RUN_TIMES env var. Set on `@BeforeScenario'. private static $suite_start_time; // When the suite started, set on `@BeforeScenario'. private static $output_to; // Where to output log - stdout|error_log. Set on `@BeforeSuite`. private static $num_top_processes; // Number of processes/methods to output by longest run times. Set on `@BeforeSuite`. private static $num_top_scenarios; // Number of scenarios to output by longest run times. Set on `@BeforeSuite`. private static $scenario_run_times = []; // Scenario run times (top `self::$num_top_scenarios` only). private static $scenario_count = 0; // Scenario count, incremented on `@AfterScenario`. private static $proc_method_run_times = []; // Array of run time info for proc methods, keyed by method name and arg, each a 2-element array containing run time and run count. private $mocked_requests = []; /** * The current feature. * * @var \Behat\Gherkin\Node\FeatureNode|null */ private static $feature; /** * The current scenario. * * @var \Behat\Gherkin\Node\ScenarioInterface|null */ private $scenario; /** * Line of the current step. * * @var int */ private $step_line = 0; /** * @BeforeFeature */ public static function store_feature( BeforeFeatureScope $scope ) { self::$feature = $scope->getFeature(); } /** * @BeforeScenario */ public function store_scenario( BeforeScenarioScope $scope ) { $this->scenario = $scope->getScenario(); } /** * @BeforeStep */ public function store_step( BeforeStepScope $scope ) { $this->step_line = $scope->getStep()->getLine(); } /** * @AfterScenario */ public function forget_scenario( AfterScenarioScope $scope ) { $this->step_line = 0; $this->scenario = null; } /** * @AfterFeature */ public static function forget_feature( AfterFeatureScope $scope ) { self::$feature = null; } /** * @AfterSuite */ public static function merge_coverage_reports() { $with_code_coverage = (string) getenv( 'WP_CLI_TEST_COVERAGE' ); if ( ! \in_array( $with_code_coverage, [ 'true', '1' ], true ) ) { return; } $filter = new Filter(); $coverage = new CodeCoverage( ( new Selector() )->forLineCoverage( $filter ), $filter ); foreach ( new DirectoryIterator( self::$behat_run_dir . '/build/logs' ) as $file ) { if ( ! $file->isFile() || 'cov' !== $file->getExtension() ) { continue; } $coverage->merge( include $file->getPathname() ); unlink( $file->getPathname() ); } ( new Clover() )->process( $coverage, self::$behat_run_dir . '/build/logs/behat-coverage.xml' ); } /** * Get the path to the Composer vendor folder. * * @return string Absolute path to the Composer vendor folder. */ public static function get_vendor_dir() { static $vendor_folder = null; if ( null !== $vendor_folder ) { return $vendor_folder; } // We try to detect the vendor folder in the most probable locations. $vendor_locations = [ // wp-cli/wp-cli-tests is a dependency of the current working dir. getcwd() . '/vendor', // wp-cli/wp-cli-tests is the root project. dirname( dirname( __DIR__ ) ) . '/vendor', // wp-cli/wp-cli-tests is a dependency. dirname( dirname( dirname( dirname( __DIR__ ) ) ) ), ]; $vendor_folder = ''; foreach ( $vendor_locations as $location ) { if ( is_dir( $location ) && is_readable( $location ) && is_file( "{$location}/autoload.php" ) ) { $vendor_folder = $location; break; } } return $vendor_folder; } /** * Get the path to the WP-CLI framework folder. * * @return string Absolute path to the WP-CLI framework folder. */ public static function get_framework_dir() { static $framework_folder = null; if ( null !== $framework_folder ) { return $framework_folder; } $vendor_folder = self::get_vendor_dir(); // Now we need to detect the location of wp-cli/wp-cli package. $framework_locations = [ // wp-cli/wp-cli is the root project. dirname( $vendor_folder ), // wp-cli/wp-cli is a dependency. "{$vendor_folder}/wp-cli/wp-cli", ]; $framework_folder = ''; foreach ( $framework_locations as $location ) { if ( is_dir( $location ) && is_readable( $location ) && is_file( "{$location}/php/utils.php" ) ) { $framework_folder = $location; break; } } return $framework_folder; } /** * Get the path to the WP-CLI binary. * * @return string Absolute path to the WP-CLI binary. */ public static function get_bin_path() { static $bin_path = null; if ( null !== $bin_path ) { return $bin_path; } $bin_path = getenv( 'WP_CLI_BIN_DIR' ); if ( ! empty( $bin_path ) ) { return $bin_path; } $bin_paths = [ self::get_vendor_dir() . '/bin', self::get_framework_dir() . '/bin', ]; foreach ( $bin_paths as $path ) { if ( is_file( "{$path}/wp" ) && is_executable( "{$path}/wp" ) ) { $bin_path = $path; break; } } return $bin_path; } /** * Get the environment variables required for launched `wp` processes */ private static function get_process_env_variables() { static $env = null; if ( null !== $env ) { return $env; } // Ensure we're using the expected `wp` binary. $bin_path = self::get_bin_path(); wp_cli_behat_env_debug( "WP-CLI binary path: {$bin_path}" ); if ( ! file_exists( "{$bin_path}/wp" ) ) { wp_cli_behat_env_debug( "WARNING: No file named 'wp' found in the provided/detected binary path." ); } if ( ! is_executable( "{$bin_path}/wp" ) ) { wp_cli_behat_env_debug( "WARNING: File named 'wp' found in the provided/detected binary path is not executable." ); } $path_separator = Utils\is_windows() ? ';' : ':'; $env = [ 'PATH' => $bin_path . $path_separator . getenv( 'PATH' ), 'BEHAT_RUN' => 1, 'HOME' => sys_get_temp_dir() . '/wp-cli-home', 'TEST_RUN_DIR' => self::$behat_run_dir, ]; $with_code_coverage = (string) getenv( 'WP_CLI_TEST_COVERAGE' ); if ( \in_array( $with_code_coverage, [ 'true', '1' ], true ) ) { $has_coverage_driver = ( new Runtime() )->hasXdebug() || ( new Runtime() )->hasPCOV(); if ( ! $has_coverage_driver ) { throw new RuntimeException( 'No coverage driver available. Re-run script with `--xdebug` flag, i.e. `composer behat -- --xdebug`.' ); } $coverage_require_file = self::$behat_run_dir . '/vendor/wp-cli/wp-cli-tests/utils/generate-coverage.php'; if ( ! file_exists( $coverage_require_file ) ) { // This file is not vendored inside the wp-cli-tests project $coverage_require_file = self::$behat_run_dir . '/utils/generate-coverage.php'; } $current = getenv( 'WP_CLI_REQUIRE' ); $updated = $current ? "{$current},{$coverage_require_file}" : $coverage_require_file; $env['WP_CLI_REQUIRE'] = $updated; } $config_path = getenv( 'WP_CLI_CONFIG_PATH' ); if ( false !== $config_path ) { $env['WP_CLI_CONFIG_PATH'] = $config_path; } $allow_root = getenv( 'WP_CLI_ALLOW_ROOT' ); if ( false !== $allow_root ) { $env['WP_CLI_ALLOW_ROOT'] = $allow_root; } $term = getenv( 'TERM' ); if ( false !== $term ) { $env['TERM'] = $term; } $php_args = getenv( 'WP_CLI_PHP_ARGS' ); if ( false !== $php_args ) { $env['WP_CLI_PHP_ARGS'] = $php_args; } $php_used = getenv( 'WP_CLI_PHP_USED' ); if ( false !== $php_used ) { $env['WP_CLI_PHP_USED'] = $php_used; } $php = getenv( 'WP_CLI_PHP' ); if ( false !== $php ) { $env['WP_CLI_PHP'] = $php; } $travis_build_dir = getenv( 'TRAVIS_BUILD_DIR' ); if ( false !== $travis_build_dir ) { $env['TRAVIS_BUILD_DIR'] = $travis_build_dir; } // Dump environment for debugging purposes, but before adding the GitHub token. wp_cli_behat_env_debug( 'Environment:' ); foreach ( $env as $key => $value ) { wp_cli_behat_env_debug( " [{$key}] => {$value}" ); } $github_token = getenv( 'GITHUB_TOKEN' ); if ( false !== $github_token ) { $env['GITHUB_TOKEN'] = $github_token; } return $env; } /** * Get the internal variables to use within tests. * * @return array Associative array of internal variables that will be mapped * into tests. */ private static function get_behat_internal_variables() { static $variables = null; if ( null !== $variables ) { return $variables; } $paths = [ dirname( dirname( dirname( dirname( __DIR__ ) ) ) ) . '/wp-cli/wp-cli/VERSION', dirname( dirname( dirname( dirname( dirname( __DIR__ ) ) ) ) ) . '/VERSION', dirname( dirname( __DIR__ ) ) . '/vendor/wp-cli/wp-cli/VERSION', ]; $framework_root = dirname( dirname( __DIR__ ) ); foreach ( $paths as $path ) { if ( file_exists( $path ) ) { $framework_root = (string) realpath( dirname( $path ) ); break; } } $variables = [ 'FRAMEWORK_ROOT' => realpath( $framework_root ), 'SRC_DIR' => realpath( dirname( dirname( __DIR__ ) ) ), 'PROJECT_DIR' => realpath( dirname( dirname( dirname( dirname( dirname( __DIR__ ) ) ) ) ) ), ]; return $variables; } /** * Download and extract a single copy of the sqlite-database-integration plugin * for use in subsequent WordPress copies */ private static function download_sqlite_plugin( $dir ) { $download_url = 'https://downloads.wordpress.org/plugin/sqlite-database-integration.zip'; $download_location = $dir . '/sqlite-database-integration.zip'; if ( ! is_dir( $dir ) ) { mkdir( $dir ); } Process::create( Utils\esc_cmd( 'curl -sSfL %1$s > %2$s', $download_url, $download_location ) )->run_check(); $zip = new \ZipArchive(); $new_zip_file = $download_location; if ( $zip->open( $new_zip_file ) === true ) { if ( $zip->extractTo( $dir ) ) { $zip->close(); unlink( $new_zip_file ); } else { $error_message = $zip->getStatusString(); throw new RuntimeException( sprintf( 'Failed to extract files from the zip: %s', $error_message ) ); } } else { $error_message = $zip->getStatusString(); throw new RuntimeException( sprintf( 'Failed to open the zip file: %s', $error_message ) ); } } /** * Given a WordPress installation with the sqlite-database-integration plugin, * configure it to use SQLite as the database by placing the db.php dropin file */ private static function configure_sqlite( $dir ) { $db_copy = $dir . '/wp-content/mu-plugins/sqlite-database-integration/db.copy'; $db_dropin = $dir . '/wp-content/db.php'; /* similar to https://github.com/WordPress/sqlite-database-integration/blob/3306576c9b606bc23bbb26c15383fef08e03ab11/activate.php#L95 */ $file_contents = str_replace( array( '\'{SQLITE_IMPLEMENTATION_FOLDER_PATH}\'', '{SQLITE_PLUGIN}', '/plugins/', ), array( '__DIR__ . \'mu-plugins/sqlite-database-integration\'', 'sqlite-database-integration/load.php', '/mu-plugins/', ), file_get_contents( $db_copy ) ); file_put_contents( $db_dropin, $file_contents ); } /** * We cache the results of `wp core download` to improve test performance. * Ideally, we'd cache at the HTTP layer for more reliable tests. */ private static function cache_wp_files() { $wp_version = getenv( 'WP_VERSION' ); $wp_version_suffix = ( false !== $wp_version ) ? "-$wp_version" : ''; self::$cache_dir = sys_get_temp_dir() . '/wp-cli-test-core-download-cache' . $wp_version_suffix; self::$sqlite_cache_dir = sys_get_temp_dir() . '/wp-cli-test-sqlite-integration-cache'; if ( 'sqlite' === getenv( 'WP_CLI_TEST_DBTYPE' ) ) { if ( ! is_readable( self::$sqlite_cache_dir . '/sqlite-database-integration/db.copy' ) ) { self::download_sqlite_plugin( self::$sqlite_cache_dir ); } } if ( is_readable( self::$cache_dir . '/wp-config-sample.php' ) ) { return; } $cmd = Utils\esc_cmd( 'wp core download --force --path=%s', self::$cache_dir ); if ( $wp_version ) { $cmd .= Utils\esc_cmd( ' --version=%s', $wp_version ); } Process::create( $cmd, null, self::get_process_env_variables() )->run_check(); } /** * @BeforeSuite */ public static function prepare( BeforeSuiteScope $scope ) { // Test performance statistics - useful for detecting slow tests. self::$log_run_times = getenv( 'WP_CLI_TEST_LOG_RUN_TIMES' ); if ( false !== self::$log_run_times ) { self::log_run_times_before_suite( $scope ); } self::$behat_run_dir = getcwd(); self::$mysql_binary = Utils\get_mysql_binary_path(); $result = Process::create( 'wp cli info', null, self::get_process_env_variables() )->run_check(); echo "{$result->stdout}\n"; self::cache_wp_files(); $result = Process::create( Utils\esc_cmd( 'wp core version --debug --path=%s', self::$cache_dir ), null, self::get_process_env_variables() )->run_check(); echo "[Debug messages]\n"; echo "{$result->stderr}\n"; echo "WordPress {$result->stdout}\n"; // Remove install cache if any (not setting the static var). $wp_version = getenv( 'WP_VERSION' ); $wp_version_suffix = ( false !== $wp_version ) ? "-$wp_version" : ''; $install_cache_dir = sys_get_temp_dir() . '/wp-cli-test-core-install-cache' . $wp_version_suffix; if ( file_exists( $install_cache_dir ) ) { self::remove_dir( $install_cache_dir ); } if ( getenv( 'WP_CLI_TEST_DEBUG_BEHAT_ENV' ) ) { exit; } } /** * @AfterSuite */ public static function afterSuite( AfterSuiteScope $scope ) { if ( self::$composer_local_repository ) { self::remove_dir( self::$composer_local_repository ); self::$composer_local_repository = null; } if ( self::$log_run_times ) { self::log_run_times_after_suite( $scope ); } } /** * @BeforeScenario */ public function beforeScenario( BeforeScenarioScope $scope ) { if ( self::$log_run_times ) { self::log_run_times_before_scenario( $scope ); } $this->variables = array_merge( $this->variables, self::get_behat_internal_variables() ); $mysql_binary = Utils\get_mysql_binary_path(); $sql_dump_command = Utils\get_sql_dump_command(); $this->variables['MYSQL_BINARY'] = $mysql_binary; $this->variables['SQL_DUMP_COMMAND'] = $sql_dump_command; // Used in the names of the RUN_DIR and SUITE_CACHE_DIR directories. self::$temp_dir_infix = null; $file = self::get_event_file( $scope, $line ); if ( isset( $file ) ) { self::$temp_dir_infix = basename( $file ) . '.' . $line; } } /** * @AfterScenario */ public function afterScenario( AfterScenarioScope $scope ) { if ( self::$run_dir ) { // Remove altered WP install, unless there's an error. if ( $scope->getTestResult()->getResultCode() <= 10 ) { self::remove_dir( self::$run_dir ); } self::$run_dir = null; } // Remove WP-CLI package directory if any. Set to `wp package path` by package-command and scaffold-package-command features, and by cli-info.feature. if ( isset( $this->variables['PACKAGE_PATH'] ) ) { self::remove_dir( $this->variables['PACKAGE_PATH'] ); } // Remove SUITE_CACHE_DIR if any. if ( self::$suite_cache_dir ) { self::remove_dir( self::$suite_cache_dir ); self::$suite_cache_dir = null; } // Remove global config file if any. $env = self::get_process_env_variables(); if ( isset( $env['HOME'] ) && file_exists( "{$env['HOME']}/.wp-cli/config.yml" ) ) { unlink( "{$env['HOME']}/.wp-cli/config.yml" ); } // Remove any background processes. foreach ( $this->running_procs as $proc ) { $status = proc_get_status( $proc ); self::terminate_proc( $status['pid'] ); } if ( self::$log_run_times ) { self::log_run_times_after_scenario( $scope ); } } /** * Terminate a process and any of its children. */ private static function terminate_proc( $master_pid ) { $output = `ps -o ppid,pid,command | grep $master_pid`; foreach ( explode( PHP_EOL, $output ) as $line ) { if ( preg_match( '/^\s*(\d+)\s+(\d+)/', $line, $matches ) ) { $parent = $matches[1]; $child = $matches[2]; if ( (int) $parent === (int) $master_pid ) { self::terminate_proc( $child ); } } } if ( ! posix_kill( (int) $master_pid, 9 ) ) { $errno = posix_get_last_error(); // Ignore "No such process" error as that's what we want. if ( 3 /*ESRCH*/ !== $errno ) { throw new RuntimeException( posix_strerror( $errno ) ); } } } /** * Create a temporary WP_CLI_CACHE_DIR. Exposed as SUITE_CACHE_DIR in "Given an empty cache" step. */ public static function create_cache_dir() { if ( self::$suite_cache_dir ) { self::remove_dir( self::$suite_cache_dir ); } self::$suite_cache_dir = sys_get_temp_dir() . '/' . uniqid( 'wp-cli-test-suite-cache-' . self::$temp_dir_infix . '-', true ); mkdir( self::$suite_cache_dir ); return self::$suite_cache_dir; } /** * Initializes context. * Every scenario gets its own context object. */ public function __construct() { if ( getenv( 'WP_CLI_TEST_DBROOTUSER' ) ) { $this->variables['DB_ROOT_USER'] = getenv( 'WP_CLI_TEST_DBROOTUSER' ); } if ( false !== getenv( 'WP_CLI_TEST_DBROOTPASS' ) ) { $this->variables['DB_ROOT_PASSWORD'] = getenv( 'WP_CLI_TEST_DBROOTPASS' ); } if ( getenv( 'WP_CLI_TEST_DBNAME' ) ) { $this->variables['DB_NAME'] = getenv( 'WP_CLI_TEST_DBNAME' ); } else { $this->variables['DB_NAME'] = 'wp_cli_test'; } if ( getenv( 'WP_CLI_TEST_DBUSER' ) ) { $this->variables['DB_USER'] = getenv( 'WP_CLI_TEST_DBUSER' ); } else { $this->variables['DB_USER'] = 'wp_cli_test'; } if ( false !== getenv( 'WP_CLI_TEST_DBPASS' ) ) { $this->variables['DB_PASSWORD'] = getenv( 'WP_CLI_TEST_DBPASS' ); } else { $this->variables['DB_PASSWORD'] = 'password1'; } if ( getenv( 'WP_CLI_TEST_DBHOST' ) ) { $this->variables['DB_HOST'] = getenv( 'WP_CLI_TEST_DBHOST' ); } else { $this->variables['DB_HOST'] = 'localhost'; } if ( getenv( 'WP_CLI_TEST_DBTYPE' ) ) { $this->variables['DB_TYPE'] = getenv( 'WP_CLI_TEST_DBTYPE' ); } else { $this->variables['DB_TYPE'] = 'mysql'; } if ( getenv( 'MYSQL_TCP_PORT' ) ) { $this->variables['MYSQL_PORT'] = getenv( 'MYSQL_TCP_PORT' ); } if ( getenv( 'MYSQL_HOST' ) ) { $this->variables['MYSQL_HOST'] = getenv( 'MYSQL_HOST' ); } if ( getenv( 'WP_CLI_TEST_DBSOCKET' ) ) { $this->variables['DB_SOCKET'] = getenv( 'WP_CLI_TEST_DBSOCKET' ); } self::$db_settings['dbname'] = $this->variables['DB_NAME']; self::$db_settings['dbuser'] = $this->variables['DB_USER']; self::$db_settings['dbpass'] = $this->variables['DB_PASSWORD']; self::$db_settings['dbhost'] = $this->variables['DB_HOST']; self::$db_type = $this->variables['DB_TYPE']; $this->variables['CORE_CONFIG_SETTINGS'] = Utils\assoc_args_to_str( self::$db_settings ); $this->drop_db(); $this->set_cache_dir(); } /** * Replace standard {VARIABLE_NAME} variables and the special {INVOKE_WP_CLI_WITH_PHP_ARGS-args} and {WP_VERSION-version-latest} variables. * Note that standard variable names can only contain uppercase letters, digits and underscores and cannot begin with a digit. */ public function replace_variables( $str ) { if ( false !== strpos( $str, '{INVOKE_WP_CLI_WITH_PHP_ARGS-' ) ) { $str = $this->replace_invoke_wp_cli_with_php_args( $str ); } $str = preg_replace_callback( '/\{([A-Z_][A-Z_0-9]*)\}/', [ $this, 'replace_var' ], $str ); if ( false !== strpos( $str, '{WP_VERSION-' ) ) { $str = $this->replace_wp_versions( $str ); } return $str; } /** * Substitute {INVOKE_WP_CLI_WITH_PHP_ARGS-args} variables. */ private function replace_invoke_wp_cli_with_php_args( $str ) { static $phar_path = null, $shell_path = null; if ( null === $phar_path ) { $phar_path = false; $phar_begin = '#!/usr/bin/env php'; $phar_begin_len = strlen( $phar_begin ); $bin_dir = getenv( 'WP_CLI_BIN_DIR' ); if ( false !== $bin_dir && file_exists( $bin_dir . '/wp' ) && file_get_contents( $bin_dir . '/wp', false, null, 0, $phar_begin_len ) === $phar_begin ) { $phar_path = $bin_dir . '/wp'; } else { $src_dir = dirname( dirname( __DIR__ ) ); $bin_path = $src_dir . '/bin/wp'; $vendor_bin_path = $src_dir . '/vendor/bin/wp'; if ( file_exists( $bin_path ) && is_executable( $bin_path ) ) { $shell_path = $bin_path; } elseif ( file_exists( $vendor_bin_path ) && is_executable( $vendor_bin_path ) ) { $shell_path = $vendor_bin_path; } else { $shell_path = 'wp'; } } } $str = preg_replace_callback( '/{INVOKE_WP_CLI_WITH_PHP_ARGS-([^}]*)}/', function ( $matches ) use ( $phar_path, $shell_path ) { return $phar_path ? "php {$matches[1]} {$phar_path}" : ( 'WP_CLI_PHP_ARGS=' . escapeshellarg( $matches[1] ) . ' ' . $shell_path ); }, $str ); return $str; } /** * Replace variables callback. */ private function replace_var( $matches ) { $str = $matches[0]; foreach ( array_slice( $matches, 1 ) as $key ) { $str = str_replace( '{' . $key . '}', array_key_exists( $key, $this->variables ) ? $this->variables[ $key ] : '', $str ); } return $str; } /** * Substitute {WP_VERSION-version-latest} variables. */ private function replace_wp_versions( $str ) { static $wp_versions = null; if ( null === $wp_versions ) { $wp_versions = []; $wp_org_api = new WpOrgApi(); $result = $wp_org_api->get_core_version_check(); if ( is_array( $result ) && ! empty( $result['offers'] ) ) { // Latest version alias. $wp_versions['{WP_VERSION-latest}'] = count( $result['offers'] ) ? $result['offers'][0]['version'] : ''; foreach ( $result['offers'] as $offer ) { $sub_ver = preg_replace( '/(^[0-9]+\.[0-9]+)\.[0-9]+$/', '$1', $offer['version'] ); $sub_ver_key = "{WP_VERSION-{$sub_ver}-latest}"; $main_ver = preg_replace( '/(^[0-9]+)\.[0-9]+$/', '$1', $sub_ver ); $main_ver_key = "{WP_VERSION-{$main_ver}-latest}"; if ( ! isset( $wp_versions[ $main_ver_key ] ) ) { $wp_versions[ $main_ver_key ] = $offer['version']; } if ( ! isset( $wp_versions[ $sub_ver_key ] ) ) { $wp_versions[ $sub_ver_key ] = $offer['version']; } } } } return strtr( $str, $wp_versions ); } /** * Get the file and line number for the current behat scope. */ private static function get_event_file( $scope, &$line ) { if ( method_exists( $scope, 'getScenario' ) ) { $scenario_feature = $scope->getScenario(); } elseif ( method_exists( $scope, 'getFeature' ) ) { $scenario_feature = $scope->getFeature(); } elseif ( method_exists( $scope, 'getOutline' ) ) { $scenario_feature = $scope->getOutline(); } else { return null; } $line = $scenario_feature->getLine(); if ( ! method_exists( $scenario_feature, 'getFile' ) ) { return null; } return $scenario_feature->getFile(); } /** * Create the RUN_DIR directory, unless already set for this scenario. */ public function create_run_dir() { if ( ! isset( $this->variables['RUN_DIR'] ) ) { self::$run_dir = sys_get_temp_dir() . '/' . uniqid( 'wp-cli-test-run-' . self::$temp_dir_infix . '-', true ); $this->variables['RUN_DIR'] = self::$run_dir; mkdir( $this->variables['RUN_DIR'] ); } } public function build_phar( $version = 'same' ) { $this->variables['PHAR_PATH'] = $this->variables['RUN_DIR'] . '/' . uniqid( 'wp-cli-build-', true ) . '.phar'; // Test running against a package installed as a WP-CLI dependency // WP-CLI bundle installed as a project dependency $make_phar_path = self::get_vendor_dir() . '/wp-cli/wp-cli-bundle/utils/make-phar.php'; if ( ! file_exists( $make_phar_path ) ) { // Running against WP-CLI bundle proper $make_phar_path = self::get_vendor_dir() . '/../utils/make-phar.php'; } $this->proc( Utils\esc_cmd( 'php -dphar.readonly=0 %1$s %2$s --version=%3$s && chmod +x %2$s', $make_phar_path, $this->variables['PHAR_PATH'], $version ) )->run_check(); } public function download_phar( $version = 'same' ) { if ( 'same' === $version ) { $version = WP_CLI_VERSION; } $download_url = sprintf( 'https://github.com/wp-cli/wp-cli/releases/download/v%1$s/wp-cli-%1$s.phar', $version ); $this->variables['PHAR_PATH'] = $this->variables['RUN_DIR'] . '/' . uniqid( 'wp-cli-download-', true ) . '.phar'; Process::create( Utils\esc_cmd( 'curl -sSfL %1$s > %2$s && chmod +x %2$s', $download_url, $this->variables['PHAR_PATH'] ) )->run_check(); } /** * CACHE_DIR is a cache for downloaded test data such as images. Lives until manually deleted. */ private function set_cache_dir() { $path = sys_get_temp_dir() . '/wp-cli-test-cache'; if ( ! file_exists( $path ) ) { mkdir( $path ); } $this->variables['CACHE_DIR'] = $path; } /** * Run a MySQL command with `$db_settings`. * * @param string $sql_cmd Command to run. * @param array $assoc_args Optional. Associative array of options. Default empty. * @param bool $add_database Optional. Whether to add dbname to the $sql_cmd. Default false. */ private static function run_sql( $sql_cmd, $assoc_args = [], $add_database = false ) { $default_assoc_args = [ 'host' => self::$db_settings['dbhost'], 'user' => self::$db_settings['dbuser'], 'pass' => self::$db_settings['dbpass'], ]; if ( $add_database ) { $sql_cmd .= ' ' . escapeshellarg( self::$db_settings['dbname'] ); } $start_time = microtime( true ); Utils\run_mysql_command( $sql_cmd, array_merge( $assoc_args, $default_assoc_args ) ); if ( self::$log_run_times ) { self::log_proc_method_run_time( 'run_sql ' . $sql_cmd, $start_time ); } } public function create_db() { if ( 'sqlite' === self::$db_type ) { return; } $dbname = self::$db_settings['dbname']; self::run_sql( self::$mysql_binary . ' --no-defaults', [ 'execute' => "CREATE DATABASE IF NOT EXISTS $dbname" ] ); } public function drop_db() { if ( 'sqlite' === self::$db_type ) { return; } $dbname = self::$db_settings['dbname']; self::run_sql( self::$mysql_binary . ' --no-defaults', [ 'execute' => "DROP DATABASE IF EXISTS $dbname" ] ); } public function proc( $command, $assoc_args = [], $path = '' ) { if ( ! empty( $assoc_args ) ) { $command .= Utils\assoc_args_to_str( $assoc_args ); } $env = self::get_process_env_variables(); if ( isset( $this->variables['SUITE_CACHE_DIR'] ) ) { $env['WP_CLI_CACHE_DIR'] = $this->variables['SUITE_CACHE_DIR']; } if ( isset( $this->variables['PROJECT_DIR'] ) ) { $env['BEHAT_PROJECT_DIR'] = $this->variables['PROJECT_DIR']; } if ( self::$feature ) { $env['BEHAT_FEATURE_TITLE'] = self::$feature->getTitle(); } if ( $this->scenario ) { $env['BEHAT_SCENARIO_TITLE'] = $this->scenario->getTitle(); } $env['BEHAT_STEP_LINE'] = $this->step_line; $env['WP_CLI_TEST_DBTYPE'] = self::$db_type; if ( isset( $this->variables['RUN_DIR'] ) ) { $cwd = "{$this->variables['RUN_DIR']}/{$path}"; } else { $cwd = null; } return Process::create( $command, $cwd, $env ); } /** * Start a background process. Will automatically be closed when the tests finish. */ public function background_proc( $cmd ) { $descriptors = [ 0 => STDIN, 1 => [ 'pipe', 'w' ], 2 => [ 'pipe', 'w' ], ]; $proc = proc_open( $cmd, $descriptors, $pipes, $this->variables['RUN_DIR'], self::get_process_env_variables() ); sleep( 1 ); $status = proc_get_status( $proc ); if ( ! $status['running'] ) { $stderr = is_resource( $pipes[2] ) ? ( ': ' . stream_get_contents( $pipes[2] ) ) : ''; throw new RuntimeException( sprintf( "Failed to start background process '%s'%s.", $cmd, $stderr ) ); } else { $this->running_procs[] = $proc; } } public function move_files( $src, $dest ) { rename( $this->variables['RUN_DIR'] . "/$src", $this->variables['RUN_DIR'] . "/$dest" ); } /** * Remove a directory (recursive). */ public static function remove_dir( $dir ) { Process::create( Utils\esc_cmd( 'rm -rf %s', $dir ) )->run_check(); } /** * Copy a directory (recursive). Destination directory must exist. */ public static function copy_dir( $src_dir, $dest_dir ) { $shell_command = ( 'Darwin' === PHP_OS ) ? Utils\esc_cmd( 'cp -R %s/* %s', $src_dir, $dest_dir ) : Utils\esc_cmd( 'cp -r %s/* %s', $src_dir, $dest_dir ); Process::create( $shell_command )->run_check(); } public function add_line_to_wp_config( &$wp_config_code, $line ) { $token = "/* That's all, stop editing!"; $wp_config_code = str_replace( $token, "$line\n\n$token", $wp_config_code ); } public function download_wp( $subdir = '' ) { $dest_dir = $this->variables['RUN_DIR'] . "/$subdir"; if ( $subdir ) { mkdir( $dest_dir ); } self::copy_dir( self::$cache_dir, $dest_dir ); if ( ! is_dir( $dest_dir . '/wp-content/mu-plugins' ) ) { mkdir( $dest_dir . '/wp-content/mu-plugins' ); } // Disable emailing. copy( dirname( dirname( __DIR__ ) ) . '/utils/no-mail.php', $dest_dir . '/wp-content/mu-plugins/no-mail.php' ); // Add polyfills. copy( dirname( dirname( __DIR__ ) ) . '/utils/polyfills.php', $dest_dir . '/wp-content/mu-plugins/polyfills.php' ); if ( 'sqlite' === self::$db_type ) { self::copy_dir( self::$sqlite_cache_dir, $dest_dir . '/wp-content/mu-plugins' ); self::configure_sqlite( $dest_dir ); } } public function create_config( $subdir = '', $extra_php = false ) { $params = self::$db_settings; // Replaces all characters that are not alphanumeric or an underscore into an underscore. $params['dbprefix'] = $subdir ? preg_replace( '#[^a-zA-Z\_0-9]#', '_', $subdir ) : 'wp_'; $params['skip-salts'] = true; // Do not check database connection if running SQLite as the check would fail. if ( 'sqlite' === self::$db_type ) { $params['skip-check'] = true; } if ( false !== $extra_php ) { $params['extra-php'] = $extra_php; } $run_dir = '' !== $subdir ? ( $this->variables['RUN_DIR'] . "/$subdir" ) : $this->variables['RUN_DIR']; $config_cache_path = ''; if ( self::$install_cache_dir ) { $config_cache_path = self::$install_cache_dir . '/config_' . md5( implode( ':', $params ) . ':subdir=' . $subdir ); } if ( $config_cache_path && file_exists( $config_cache_path ) ) { copy( $config_cache_path, $run_dir . '/wp-config.php' ); } else { $this->proc( 'wp config create', $params, $subdir )->run_check(); if ( $config_cache_path && file_exists( $run_dir . '/wp-config.php' ) ) { copy( $run_dir . '/wp-config.php', $config_cache_path ); } } } public function install_wp( $subdir = '' ) { $wp_version = getenv( 'WP_VERSION' ); $wp_version_suffix = ( false !== $wp_version ) ? "-$wp_version" : ''; self::$install_cache_dir = sys_get_temp_dir() . '/wp-cli-test-core-install-cache' . $wp_version_suffix; if ( ! file_exists( self::$install_cache_dir ) ) { mkdir( self::$install_cache_dir ); } $subdir = $this->replace_variables( $subdir ); // Disable WP Cron by default to avoid bogus HTTP requests in CLI context. $config_extra_php = "if ( ! defined( 'DISABLE_WP_CRON' ) ) { define( 'DISABLE_WP_CRON', true ); }\n"; if ( 'sqlite' !== self::$db_type ) { $this->create_db(); } $this->create_run_dir(); $this->download_wp( $subdir ); $this->create_config( $subdir, $config_extra_php ); $install_args = [ 'url' => 'https://example.com', 'title' => 'WP CLI Site', 'admin_user' => 'admin', 'admin_email' => 'admin@example.com', 'admin_password' => 'password1', 'skip-email' => true, ]; $run_dir = '' !== $subdir ? ( $this->variables['RUN_DIR'] . "/$subdir" ) : $this->variables['RUN_DIR']; $install_cache_path = ''; if ( self::$install_cache_dir ) { $install_cache_path = self::$install_cache_dir . '/install_' . md5( implode( ':', $install_args ) . ':subdir=' . $subdir ); } if ( $install_cache_path && file_exists( $install_cache_path ) ) { self::copy_dir( $install_cache_path, $run_dir ); // This is the sqlite equivalent of restoring a database dump in MySQL if ( 'sqlite' === self::$db_type ) { copy( "{$install_cache_path}.sqlite", "$run_dir/wp-content/database/.ht.sqlite" ); } else { self::run_sql( self::$mysql_binary . ' --no-defaults', [ 'execute' => "source {$install_cache_path}.sql" ], true /*add_database*/ ); } } else { $this->proc( 'wp core install', $install_args, $subdir )->run_check(); if ( $install_cache_path ) { mkdir( $install_cache_path ); self::dir_diff_copy( $run_dir, self::$cache_dir, $install_cache_path ); if ( 'sqlite' !== self::$db_type ) { $mysqldump_binary = Utils\get_sql_dump_command(); $mysqldump_binary = Utils\force_env_on_nix_systems( $mysqldump_binary ); $support_column_statistics = exec( "{$mysqldump_binary} --help | grep 'column-statistics'" ); $command = "{$mysqldump_binary} --no-defaults --no-tablespaces"; if ( $support_column_statistics ) { $command .= ' --skip-column-statistics'; } self::run_sql( $command, [ 'result-file' => "{$install_cache_path}.sql" ], true /*add_database*/ ); } if ( 'sqlite' === self::$db_type ) { // This is the sqlite equivalent of creating a database dump in MySQL copy( "$run_dir/wp-content/database/.ht.sqlite", "{$install_cache_path}.sqlite" ); } } } } public function install_wp_with_composer( $vendor_directory = 'vendor' ) { $this->create_run_dir(); $this->create_db(); $yml_path = $this->variables['RUN_DIR'] . '/wp-cli.yml'; file_put_contents( $yml_path, 'path: WordPress' ); $this->composer_command( 'init --name="wp-cli/composer-test" --type="project"' ); $this->composer_command( 'config vendor-dir ' . $vendor_directory ); $this->composer_command( 'config extra.wordpress-install-dir WordPress' ); // Allow for all Composer plugins to run to avoid warnings. $this->composer_command( 'config --no-plugins allow-plugins true' ); $this->composer_command( 'require johnpbloch/wordpress-core-installer johnpbloch/wordpress-core --optimize-autoloader' ); // Disable WP Cron by default to avoid bogus HTTP requests in CLI context. $config_extra_php = "if ( ! defined( 'DISABLE_WP_CRON' ) ) { define( 'DISABLE_WP_CRON', true ); }\n"; $config_extra_php .= "require_once dirname(__DIR__) . '/" . $vendor_directory . "/autoload.php';\n"; $this->create_config( 'WordPress', $config_extra_php ); $install_args = [ 'url' => 'http://localhost:8080', 'title' => 'WP CLI Site with both WordPress and wp-cli as Composer dependencies', 'admin_user' => 'admin', 'admin_email' => 'admin@example.com', 'admin_password' => 'password1', 'skip-email' => true, ]; if ( ! is_dir( $this->variables['RUN_DIR'] . '/WordPress/wp-content/mu-plugins' ) ) { mkdir( $this->variables['RUN_DIR'] . '/WordPress/wp-content/mu-plugins' ); } if ( 'sqlite' === self::$db_type ) { mkdir( $this->variables['RUN_DIR'] . '/WordPress/wp-content/mu-plugins/sqlite-database-integration' ); self::copy_dir( self::$sqlite_cache_dir, $this->variables['RUN_DIR'] . '/WordPress/wp-content/mu-plugins' ); self::configure_sqlite( $this->variables['RUN_DIR'] . '/WordPress' ); } $this->proc( 'wp core install', $install_args )->run_check(); } public function composer_add_wp_cli_local_repository() { if ( ! self::$composer_local_repository ) { self::$composer_local_repository = sys_get_temp_dir() . '/' . uniqid( 'wp-cli-composer-local-', true ); mkdir( self::$composer_local_repository ); $env = self::get_process_env_variables(); $src = isset( $env['TRAVIS_BUILD_DIR'] ) ? $env['TRAVIS_BUILD_DIR'] : realpath( self::get_vendor_dir() . '/../' ); self::copy_dir( $src, self::$composer_local_repository . '/' ); self::remove_dir( self::$composer_local_repository . '/.git' ); self::remove_dir( self::$composer_local_repository . '/vendor' ); } $dest = self::$composer_local_repository . '/'; $this->composer_command( "config repositories.wp-cli '{\"type\": \"path\", \"url\": \"$dest\", \"options\": {\"symlink\": false, \"versions\": { \"wp-cli/wp-cli\": \"dev-main\"}}}'" ); $this->variables['COMPOSER_LOCAL_REPOSITORY'] = self::$composer_local_repository; } public function composer_require_current_wp_cli() { $this->composer_add_wp_cli_local_repository(); // TODO: Specific alias version should be deduced to keep up-to-date. $this->composer_command( 'require "wp-cli/wp-cli:dev-main as 2.5.x-dev" --optimize-autoloader' ); } public function start_php_server( $subdir = '' ) { $dir = $this->variables['RUN_DIR'] . '/'; if ( $subdir ) { $dir .= trim( $subdir, '/' ) . '/'; } $cmd = Utils\esc_cmd( '%s -S %s -t %s -c %s %s', Utils\get_php_binary(), 'localhost:8080', $dir, get_cfg_var( 'cfg_file_path' ), $this->variables['RUN_DIR'] . '/vendor/wp-cli/server-command/router.php' ); $this->background_proc( $cmd ); } private function composer_command( $cmd ) { if ( ! isset( $this->variables['COMPOSER_PATH'] ) ) { $this->variables['COMPOSER_PATH'] = exec( 'which composer' ); } $this->proc( $this->variables['COMPOSER_PATH'] . ' --no-interaction ' . $cmd )->run_check(); } /** * Initialize run time logging. */ private static function log_run_times_before_suite( BeforeSuiteScope $scope ) { self::$suite_start_time = microtime( true ); Process::$log_run_times = true; $travis = getenv( 'TRAVIS' ); // Default output settings. self::$output_to = 'stdout'; self::$num_top_processes = $travis ? 10 : 40; self::$num_top_scenarios = $travis ? 10 : 20; // Allow setting of above with "WP_CLI_TEST_LOG_RUN_TIMES=<output_to>[,<num_top_processes>][,<num_top_scenarios>]" formatted env var. if ( preg_match( '/^(stdout|error_log)?(,[0-9]+)?(,[0-9]+)?$/i', self::$log_run_times, $matches ) ) { if ( isset( $matches[1] ) ) { self::$output_to = strtolower( $matches[1] ); } if ( isset( $matches[2] ) ) { self::$num_top_processes = max( (int) substr( $matches[2], 1 ), 1 ); } if ( isset( $matches[3] ) ) { self::$num_top_scenarios = max( (int) substr( $matches[3], 1 ), 1 ); } } } /** * Record the start time of the scenario into the `$scenario_run_times` array. */ private static function log_run_times_before_scenario( $scope ) { $scenario_key = self::get_scenario_key( $scope ); if ( $scenario_key ) { self::$scenario_run_times[ $scenario_key ] = -microtime( true ); } } /** * Save the run time of the scenario into the `$scenario_run_times` array. Only the top `self::$num_top_scenarios` are kept. */ private static function log_run_times_after_scenario( $scope ) { $scenario_key = self::get_scenario_key( $scope ); if ( $scenario_key ) { self::$scenario_run_times[ $scenario_key ] += microtime( true ); ++self::$scenario_count; if ( count( self::$scenario_run_times ) > self::$num_top_scenarios ) { arsort( self::$scenario_run_times ); array_pop( self::$scenario_run_times ); } } } /** * Copy files in updated directory that are not in source directory to copy directory. ("Incremental backup".) * Note: does not deal with changed files (ie does not compare file contents for changes), for speed reasons. * * @param string $upd_dir The directory to search looking for files/directories not in `$src_dir`. * @param string $src_dir The directory to be compared to `$upd_dir`. * @param string $cop_dir Where to copy any files/directories in `$upd_dir` but not in `$src_dir` to. */ private static function dir_diff_copy( $upd_dir, $src_dir, $cop_dir ) { $files = scandir( $upd_dir ); if ( false === $files ) { $error = error_get_last(); throw new RuntimeException( sprintf( "Failed to open updated directory '%s': %s. " . __FILE__ . ':' . __LINE__, $upd_dir, $error['message'] ) ); } foreach ( array_diff( $files, [ '.', '..' ] ) as $file ) { $upd_file = $upd_dir . '/' . $file; $src_file = $src_dir . '/' . $file; $cop_file = $cop_dir . '/' . $file; if ( ! file_exists( $src_file ) ) { if ( is_dir( $upd_file ) ) { if ( ! file_exists( $cop_file ) && ! mkdir( $cop_file, 0777, true /*recursive*/ ) ) { $error = error_get_last(); throw new RuntimeException( sprintf( "Failed to create copy directory '%s': %s. " . __FILE__ . ':' . __LINE__, $cop_file, $error['message'] ) ); } self::copy_dir( $upd_file, $cop_file ); } elseif ( ! copy( $upd_file, $cop_file ) ) { $error = error_get_last(); throw new RuntimeException( sprintf( "Failed to copy '%s' to '%s': %s. " . __FILE__ . ':' . __LINE__, $upd_file, $cop_file, $error['message'] ) ); } } elseif ( is_dir( $upd_file ) ) { self::dir_diff_copy( $upd_file, $src_file, $cop_file ); } } } /** * Get the scenario key used for `$scenario_run_times` array. * Format "<grandparent-dir> <feature-file>:<line-number>", eg "core-command core-update.feature:221". */ private static function get_scenario_key( $scope ) { $scenario_key = ''; $file = self::get_event_file( $scope, $line ); if ( isset( $file ) ) { $scenario_grandparent = Utils\basename( dirname( dirname( $file ) ) ); $scenario_key = $scenario_grandparent . ' ' . Utils\basename( $file ) . ':' . $line; } return $scenario_key; } /** * Print out stats on the run times of processes and scenarios. */ private static function log_run_times_after_suite( AfterSuiteScope $scope ) { $suite = ''; if ( self::$scenario_run_times ) { // Grandparent directory is first part of key. $keys = array_keys( self::$scenario_run_times ); $suite = substr( $keys[0], 0, strpos( $keys[0], ' ' ) ); } $run_from = Utils\basename( dirname( dirname( __DIR__ ) ) ); // Format same as Behat, if have minutes. $fmt = function ( $time ) { $mins = floor( $time / 60 ); return round( $time, 3 ) . ( $mins ? ( ' (' . $mins . 'm' . round( $time - ( $mins * 60 ), 3 ) . 's)' ) : '' ); }; $time = microtime( true ) - self::$suite_start_time; $log = PHP_EOL . str_repeat( '(', 80 ) . PHP_EOL; // Process and proc method run times. $run_times = array_merge( Process::$run_times, self::$proc_method_run_times ); $reduce_callback = function ( $carry, $item ) { return [ $carry[0] + $item[0], $carry[1] + $item[1] ]; }; list( $ptime, $calls ) = array_reduce( $run_times, $reduce_callback, [ 0, 0 ] ); $overhead = $time - $ptime; $pct = round( ( $overhead / $time ) * 100 ); $unique = count( $run_times ); $log .= sprintf( PHP_EOL . "Total process run time %s (tests %s, overhead %.3f %d%%), calls %d (%d unique) for '%s' run from '%s'" . PHP_EOL, $fmt( $ptime ), $fmt( $time ), $overhead, $pct, $calls, $unique, $suite, $run_from ); $sort_callback = function ( $a, $b ) { return $a[0] === $b[0] ? 0 : ( $a[0] < $b[0] ? 1 : -1 ); // Reverse sort. }; uasort( $run_times, $sort_callback ); $tops = array_slice( $run_times, 0, self::$num_top_processes, true ); $runtime_callback = function ( $k, $v, $i ) { return sprintf( ' %3d. %7.3f %3d %s', $i + 1, round( $v[0], 3 ), $v[1], $k ); }; $log .= PHP_EOL . 'Top ' . self::$num_top_processes . " process run times for '$suite'"; $log .= PHP_EOL . implode( PHP_EOL, array_map( $runtime_callback, array_keys( $tops ), $tops, array_keys( array_keys( $tops ) ) ) ) . PHP_EOL; // Scenario run times. arsort( self::$scenario_run_times ); $tops = array_slice( self::$scenario_run_times, 0, self::$num_top_scenarios, true ); $scenario_runtime_callback = function ( $k, $v, $i ) { return sprintf( ' %3d. %7.3f %s', $i + 1, round( $v, 3 ), substr( $k, strpos( $k, ' ' ) + 1 ) ); }; $log .= PHP_EOL . 'Top ' . self::$num_top_scenarios . ' (of ' . self::$scenario_count . ") scenario run times for '$suite'"; $log .= PHP_EOL . implode( PHP_EOL, array_map( $scenario_runtime_callback, array_keys( $tops ), $tops, array_keys( array_keys( $tops ) ) ) ) . PHP_EOL; $log .= PHP_EOL . str_repeat( ')', 80 ); if ( 'error_log' === self::$output_to ) { error_log( $log ); } else { echo PHP_EOL . $log; } } /** * Log the run time of a proc method (one that doesn't use Process but does (use a function that does) a `proc_open()`). */ private static function log_proc_method_run_time( $key, $start_time ) { $run_time = microtime( true ) - $start_time; if ( ! isset( self::$proc_method_run_times[ $key ] ) ) { self::$proc_method_run_times[ $key ] = [ 0, 0 ]; } self::$proc_method_run_times[ $key ][0] += $run_time; ++self::$proc_method_run_times[ $key ][1]; } } // phpcs:ignore Universal.Files.SeparateFunctionsFromOO.Mixed function wp_cli_behat_env_debug( $message ) { if ( ! getenv( 'WP_CLI_TEST_DEBUG_BEHAT_ENV' ) ) { return; } echo "{$message}\n"; } /** * Load required support files as needed before heading into the Behat context. */ function wpcli_bootstrap_behat_feature_context() { $vendor_folder = FeatureContext::get_vendor_dir(); wp_cli_behat_env_debug( "Vendor folder location: {$vendor_folder}" ); // Didn't manage to detect a valid vendor folder. if ( empty( $vendor_folder ) ) { return; } // We assume the vendor folder is located in the project root folder. $project_folder = dirname( $vendor_folder ); $framework_folder = FeatureContext::get_framework_dir(); wp_cli_behat_env_debug( "Framework folder location: {$framework_folder}" ); // Didn't manage to detect a valid framework folder. if ( empty( $vendor_folder ) ) { return; } // Load helper functionality that is needed for the tests. require_once "{$framework_folder}/php/utils.php"; require_once "{$framework_folder}/php/WP_CLI/Process.php"; require_once "{$framework_folder}/php/WP_CLI/ProcessRun.php"; // Manually load Composer file includes by generating a config with require: // statements for each file. $project_composer = "{$project_folder}/composer.json"; if ( ! file_exists( $project_composer ) ) { return; } $composer = json_decode( file_get_contents( $project_composer ) ); if ( empty( $composer->autoload->files ) ) { return; } $contents = "require:\n"; foreach ( $composer->autoload->files as $file ) { $contents .= " - {$project_folder}/{$file}\n"; } $temp_folder = sys_get_temp_dir() . '/wp-cli-package-test'; if ( ! is_dir( $temp_folder ) && ! mkdir( $temp_folder ) && ! is_dir( $temp_folder ) ) { return; } $project_config = "{$temp_folder}/config.yml"; file_put_contents( $project_config, $contents ); putenv( 'WP_CLI_CONFIG_PATH=' . $project_config ); wp_cli_behat_env_debug( "Project config file location: {$project_config}" ); wp_cli_behat_env_debug( "Project config:\n{$contents}" ); } wpcli_bootstrap_behat_feature_context(); <?php class Oxymel { private $xml; private $dom; private $current_element; private $last_inserted; private $go_deep_on_next_element = 0; private $go_up_on_next_element = 0; private $nesting_level = 0; private $contains_nesting_level = 0; private $indentation= ' '; public function __construct() { $this->xml = ''; $this->init_new_dom(); } public function to_string() { return $this->xml .= $this->indent( $this->xml_from_dom(), $this->nesting_level ); } public function __call( $name, $args ) { array_unshift( $args, $name ); return call_user_func_array( array( $this, 'tag' ), $args ); } public function __get( $name ) { return $this->$name(); } public function contains() { $this->contains_nesting_level++; $this->nesting_level++; if ( $this->go_deep_on_next_element ) { throw new OxymelException( 'contains cannot be used consecutively more than once' ); } $this->go_deep_on_next_element++; return $this; } public function end() { $this->contains_nesting_level--; $this->nesting_level--; if ( $this->contains_nesting_level < 0 ) { throw new OxymelException( 'end is used without a matching contains' ); } $this->go_up_on_next_element++; return $this; } public function tag( $name, $content_or_attributes = null, $attributes = array() ) { list( $content, $attributes ) = $this->get_content_and_attributes_from_tag_args( $content_or_attributes, $attributes ); $is_opening = 0 === strpos( $name, 'open_' ); $is_closing = 0 === strpos( $name, 'close_' ); $name = preg_replace("/^(open|close)_/", '', $name ); $element = $this->create_element( $name, $content, $attributes ); if ( !$is_opening && !$is_closing ) $this->add_element_to_dom( $element ); elseif ( $is_opening ) $this->add_opening_tag_from_element( $element ); elseif ( $is_closing ) $this->add_closing_tag_from_tag_name( $name ); return $this; } public function cdata( $text ) { $this->add_element_to_dom( $this->dom->createCDATASection( $text ) ); return $this; } public function text( $text ) { $this->add_element_to_dom( $this->dom->createTextNode( $text ) ); return $this; } public function comment( $text ) { $this->add_element_to_dom( $this->dom->createComment( $text ) ); return $this; } public function xml() { $this->add_element_to_dom( $this->dom->createProcessingInstruction( 'xml', 'version="1.0" encoding="UTF-8"' ) ); return $this; } public function oxymel( Oxymel $other ) { foreach( $other->dom->childNodes as $child ) { $child = $this->dom->importNode( $child, true ); $this->add_element_to_dom( $child ); } return $this; } public function raw( $raw_xml ) { if ( !$raw_xml ) { return $this; } $fragment = $this->dom->createDocumentFragment(); $fragment->appendXML($raw_xml); $this->add_element_to_dom( $fragment ); return $this; } private function add_element_to_dom( $element ) { $this->move_current_element_deep(); $this->move_current_element_up(); $this->last_inserted = $this->current_element->appendChild($element); } private function move_current_element_deep() { if ( $this->go_deep_on_next_element ) { if ( !$this->last_inserted ) { throw new OxymelException( 'contains has been used before adding any tags' ); } $this->current_element = $this->last_inserted; $this->go_deep_on_next_element--; } } private function move_current_element_up() { if ( $this->go_up_on_next_element ) { while ( $this->go_up_on_next_element ) { $this->current_element = $this->current_element->parentNode; $this->go_up_on_next_element--; } } } private function get_content_and_attributes_from_tag_args( $content_or_attributes, array $attributes ) { $content = null; if ( !$attributes ) { if ( is_array( $content_or_attributes ) ) $attributes = $content_or_attributes; else $content = $content_or_attributes; } else { $content = $content_or_attributes; } return array( $content, $attributes ); } private function init_new_dom() { unset( $this->dom, $this->current_element ); $this->dom = new DOMDocument(); $this->dom->formatOutput = true; $this->current_element = $this->dom; $this->last_inserted = null; } private function xml_from_dom() { if ( 0 !== $this->contains_nesting_level ) { throw new OxymelException( 'contains and end calls do not match' ); } $xml = ''; foreach( $this->dom->childNodes as $child ) { $xml .= $this->dom->saveXML( $child ) . "\n"; } return $xml; } private function create_element( $name, $content, $attributes ) { if ( !is_null( $content ) ) $element = $this->dom->createElement( $name, $content ); else $element = $this->dom->createElement( $name ); foreach( $attributes as $attribute_name => $attribute_value ) { $element->setAttribute( $attribute_name, $attribute_value ); } return $element; } private function add_opening_tag_from_element( $element ) { $this->xml .= $this->indent( $this->xml_from_dom(), $this->nesting_level ); $tag = $this->dom->saveXML($element); $this->xml .= $this->indent( str_replace( '/>', '>', $tag ) . "\n", $this->nesting_level ); $this->nesting_level++; $this->init_new_dom(); } private function add_closing_tag_from_tag_name( $name ) { $this->xml .= $this->xml_from_dom(); $this->nesting_level--; if ( $this->nesting_level < 0 ) { $this->xml = $this->indent( $this->xml, -$this->nesting_level ); $this->nesting_level = 0; } $this->xml .= $this->indent( "</$name>\n", $this->nesting_level ); $this->init_new_dom(); } private function indent( $string, $level ) { if ( !$level ) { return $string; } $lines = explode( "\n", $string ); foreach( $lines as &$line ) { if ( !trim( $line ) ) continue; $line = str_repeat( $this->indentation, $level ) . $line; } return implode( "\n", $lines ); } } class OxymelException extends Exception { } <?php require_once dirname( __FILE__ ) . '/Oxymel.php'; class OxymelTest extends PHPUnit_Framework_TestCase { function __construct() { $this->x = new Oxymel; } function test_xml_adds_procesing_instrution_with_version_and_encoding() { $this->a( '<?xml version="1.0" encoding="UTF-8"?>', $this->x->xml ); } function test_self_closing() { $this->a('<baba/>', $this->x->baba); } function test_self_closing_method() { $this->a('<baba/>', $this->x->baba()); } function test_attribute_no_content() { $this->a('<baba a="b" c="d"/>', $this->x->baba( array( 'a' => 'b', 'c' => 'd' ) ) ); } function test_content_no_attribute() { $this->a('<baba>content</baba>', $this->x->baba( 'content' ) ); } function test_escapiing_of_content() { $this->a('<baba><</baba>', $this->x->baba( '<' ) ); } function test_escaping_of_attributes() { $this->a('<baba a="<"/>', $this->x->baba( array( 'a' => '<' ) ) ); } function test_content_and_attributes() { $this->a('<baba a="b" c="d">content</baba>', $this->x->baba( 'content', array( 'a' => 'b', 'c' => 'd' ) ) ); } function test_content_and_attributes_error() { $this->setExpectedException( 'PHPUnit_Framework_Error' ); $this->a('<baba a="b" c="d">content</baba>', $this->x->baba( array( 'a' => 'b', 'c' => 'd' ), 'content' ) ); } function test_go_down() { $this->a('<baba> <dyado/> </baba>', $this->x->baba->contains->dyado->end ); } function test_go_down_and_up() { $this->a("<level0> <level1/> </level0> <level0/>", $this->x->level0->contains->level1->end->level0 ); } function test_cdata() { $this->a('<baba><![CDATA[content]]></baba>', $this->x->baba->contains->cdata('content')->end); } function test_nested_cdata() { $this->a( '<![CDATA[x]]]]><![CDATA[>]]>', $this->x->cdata( 'x]]>' ) ); } function test_raw() { $this->a('<baba> <dyado/> </baba>', $this->x->baba->contains->raw('<dyado></dyado>')->end); } function test_raw_doesnt_do_anything_with_empty_arg() { $this->a('<baba/>', $this->x->baba->raw( '' ) ); } function test_oxymel_ns() { $oxymel = new Oxymel; $oxymel->tag( 'wp:baba' ); $this->a( '<wp:baba/>', $this->x->oxymel( $oxymel ) ); } function x_test_only_up_error() { $this->a('', $this->x->end ); } function test_open_in_the_end() { $this->a("<baba/> <newtag>", $this->x->baba->open_newtag ); } function test_open_with_attributes() { $this->a("<baba/> <newtag a=\"b\">", $this->x->baba->open_newtag( array( 'a' => 'b' ) ) ); } function test_dom_open_dom() { $this->a("<baba/> <newtag> <baba/>", $this->x->baba->open_newtag->baba ); } function test_close_in_the_beginning() { $this->a("</oldtag> <baba/>", $this->x->close_oldtag->baba ); } function test_dom_close_dom() { $this->a(" <baba/> </oldtag> <baba/>", $this->x->baba->close_oldtag->baba ); } function test_baba() { $this->a("<a>baba<x/></a>", $this->x->a('baba')->contains->x->end ); } function test_comment() { $this->a('', $this->x->comment('baba')); } function test_two_invocations() { $this->x->baba(); $this->x->dyado(); $this->a( "<baba/> <dyado/>", $this->x ); } function test_double_end() { $this->a( "<out> <mid> <in/> </mid> </out> <nextout/>", $this->x->out->contains->mid->contains->in->end->end->nextout ); } function test_end_without_contains() { $this->setExpectedException( 'OxymelException' ); $this->x->end->baba; } function test_leading_contains() { $this->setExpectedException( 'OxymelException' ); $this->a( '<baba/>', $this->x->contains->baba ); } function test_consecutive_contains_should_error() { $this->setExpectedException( 'OxymelException' ); $this->x->baba->contains->contains->dyado->end->wink; } function test_end_without_mathcing_contains_but_with_enough_parents() { $this->setExpectedException( 'OxymelException' ); $this->x->contains->baba->end->end->baba; } function test_contains_after_newly_initialized_dom_should_error() { $this->setExpectedException( 'OxymelException' ); $this->x->baba->open_rss->contains->baba->end; } function test_nested_open_tags_should_be_indented() { $this->a( "<baba> <baba>", $this->x->open_baba->open_baba ); } function test_normal_xml_between_two_opening_tags_should_be_indented() { $this->a( "<baba> <baba/> <baba>", $this->x->open_baba->baba->open_baba ); } function test_normal_xml_after_opening_tag_should_be_indented() { $this->a( "<baba> <baba/>", $this->x->open_baba->baba ); } function test_normal_xml_before_closing_tag_should_be_indented() { $this->a( " <baba/> </baba>", $this->x->baba->close_baba ); } function test_text_should_escape_the_content_inside() { $this->a( 'a & b', $this->x->text( 'a & b' ) ); } function test_dangling_contains_should_be_caught_in_the_end() { $this->setExpectedException( 'OxymelException' ); $this->x->contains->to_string(); } private function a($value, $x) { $this->assertEquals( $value . "\n", $x->to_string()); } } <?php namespace Psr\Log; /** * This Logger can be used to avoid conditional log calls. * * Logging should always be optional, and if no logger is provided to your * library creating a NullLogger instance to have something to throw logs at * is a good way to avoid littering your code with `if ($this->logger) { }` * blocks. */ class NullLogger extends AbstractLogger { /** * Logs with an arbitrary level. * * @param mixed $level * @param string $message * @param array $context * * @return void * * @throws \Psr\Log\InvalidArgumentException */ public function log($level, $message, array $context = array()) { // noop } } <?php namespace Psr\Log; /** * Describes a logger instance. * * The message MUST be a string or object implementing __toString(). * * The message MAY contain placeholders in the form: {foo} where foo * will be replaced by the context data in key "foo". * * The context array can contain arbitrary data. The only assumption that * can be made by implementors is that if an Exception instance is given * to produce a stack trace, it MUST be in a key named "exception". * * See https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-3-logger-interface.md * for the full interface specification. */ interface LoggerInterface { /** * System is unusable. * * @param string $message * @param mixed[] $context * * @return void */ public function emergency($message, array $context = array()); /** * Action must be taken immediately. * * Example: Entire website down, database unavailable, etc. This should * trigger the SMS alerts and wake you up. * * @param string $message * @param mixed[] $context * * @return void */ public function alert($message, array $context = array()); /** * Critical conditions. * * Example: Application component unavailable, unexpected exception. * * @param string $message * @param mixed[] $context * * @return void */ public function critical($message, array $context = array()); /** * Runtime errors that do not require immediate action but should typically * be logged and monitored. * * @param string $message * @param mixed[] $context * * @return void */ public function error($message, array $context = array()); /** * Exceptional occurrences that are not errors. * * Example: Use of deprecated APIs, poor use of an API, undesirable things * that are not necessarily wrong. * * @param string $message * @param mixed[] $context * * @return void */ public function warning($message, array $context = array()); /** * Normal but significant events. * * @param string $message * @param mixed[] $context * * @return void */ public function notice($message, array $context = array()); /** * Interesting events. * * Example: User logs in, SQL logs. * * @param string $message * @param mixed[] $context * * @return void */ public function info($message, array $context = array()); /** * Detailed debug information. * * @param string $message * @param mixed[] $context * * @return void */ public function debug($message, array $context = array()); /** * Logs with an arbitrary level. * * @param mixed $level * @param string $message * @param mixed[] $context * * @return void * * @throws \Psr\Log\InvalidArgumentException */ public function log($level, $message, array $context = array()); } <?php namespace Psr\Log; /** * Describes log levels. */ class LogLevel { const EMERGENCY = 'emergency'; const ALERT = 'alert'; const CRITICAL = 'critical'; const ERROR = 'error'; const WARNING = 'warning'; const NOTICE = 'notice'; const INFO = 'info'; const DEBUG = 'debug'; } <?php namespace Psr\Log; class InvalidArgumentException extends \InvalidArgumentException { } <?php namespace Psr\Log; /** * This is a simple Logger trait that classes unable to extend AbstractLogger * (because they extend another class, etc) can include. * * It simply delegates all log-level-specific methods to the `log` method to * reduce boilerplate code that a simple Logger that does the same thing with * messages regardless of the error level has to implement. */ trait LoggerTrait { /** * System is unusable. * * @param string $message * @param array $context * * @return void */ public function emergency($message, array $context = array()) { $this->log(LogLevel::EMERGENCY, $message, $context); } /** * Action must be taken immediately. * * Example: Entire website down, database unavailable, etc. This should * trigger the SMS alerts and wake you up. * * @param string $message * @param array $context * * @return void */ public function alert($message, array $context = array()) { $this->log(LogLevel::ALERT, $message, $context); } /** * Critical conditions. * * Example: Application component unavailable, unexpected exception. * * @param string $message * @param array $context * * @return void */ public function critical($message, array $context = array()) { $this->log(LogLevel::CRITICAL, $message, $context); } /** * Runtime errors that do not require immediate action but should typically * be logged and monitored. * * @param string $message * @param array $context * * @return void */ public function error($message, array $context = array()) { $this->log(LogLevel::ERROR, $message, $context); } /** * Exceptional occurrences that are not errors. * * Example: Use of deprecated APIs, poor use of an API, undesirable things * that are not necessarily wrong. * * @param string $message * @param array $context * * @return void */ public function warning($message, array $context = array()) { $this->log(LogLevel::WARNING, $message, $context); } /** * Normal but significant events. * * @param string $message * @param array $context * * @return void */ public function notice($message, array $context = array()) { $this->log(LogLevel::NOTICE, $message, $context); } /** * Interesting events. * * Example: User logs in, SQL logs. * * @param string $message * @param array $context * * @return void */ public function info($message, array $context = array()) { $this->log(LogLevel::INFO, $message, $context); } /** * Detailed debug information. * * @param string $message * @param array $context * * @return void */ public function debug($message, array $context = array()) { $this->log(LogLevel::DEBUG, $message, $context); } /** * Logs with an arbitrary level. * * @param mixed $level * @param string $message * @param array $context * * @return void * * @throws \Psr\Log\InvalidArgumentException */ abstract public function log($level, $message, array $context = array()); } <?php namespace Psr\Log; /** * This is a simple Logger implementation that other Loggers can inherit from. * * It simply delegates all log-level-specific methods to the `log` method to * reduce boilerplate code that a simple Logger that does the same thing with * messages regardless of the error level has to implement. */ abstract class AbstractLogger implements LoggerInterface { /** * System is unusable. * * @param string $message * @param mixed[] $context * * @return void */ public function emergency($message, array $context = array()) { $this->log(LogLevel::EMERGENCY, $message, $context); } /** * Action must be taken immediately. * * Example: Entire website down, database unavailable, etc. This should * trigger the SMS alerts and wake you up. * * @param string $message * @param mixed[] $context * * @return void */ public function alert($message, array $context = array()) { $this->log(LogLevel::ALERT, $message, $context); } /** * Critical conditions. * * Example: Application component unavailable, unexpected exception. * * @param string $message * @param mixed[] $context * * @return void */ public function critical($message, array $context = array()) { $this->log(LogLevel::CRITICAL, $message, $context); } /** * Runtime errors that do not require immediate action but should typically * be logged and monitored. * * @param string $message * @param mixed[] $context * * @return void */ public function error($message, array $context = array()) { $this->log(LogLevel::ERROR, $message, $context); } /** * Exceptional occurrences that are not errors. * * Example: Use of deprecated APIs, poor use of an API, undesirable things * that are not necessarily wrong. * * @param string $message * @param mixed[] $context * * @return void */ public function warning($message, array $context = array()) { $this->log(LogLevel::WARNING, $message, $context); } /** * Normal but significant events. * * @param string $message * @param mixed[] $context * * @return void */ public function notice($message, array $context = array()) { $this->log(LogLevel::NOTICE, $message, $context); } /** * Interesting events. * * Example: User logs in, SQL logs. * * @param string $message * @param mixed[] $context * * @return void */ public function info($message, array $context = array()) { $this->log(LogLevel::INFO, $message, $context); } /** * Detailed debug information. * * @param string $message * @param mixed[] $context * * @return void */ public function debug($message, array $context = array()) { $this->log(LogLevel::DEBUG, $message, $context); } } <?php namespace Psr\Log; /** * Describes a logger-aware instance. */ interface LoggerAwareInterface { /** * Sets a logger instance on the object. * * @param LoggerInterface $logger * * @return void */ public function setLogger(LoggerInterface $logger); } <?php namespace Psr\Log; /** * Basic Implementation of LoggerAwareInterface. */ trait LoggerAwareTrait { /** * The logger instance. * * @var LoggerInterface|null */ protected $logger; /** * Sets a logger. * * @param LoggerInterface $logger */ public function setLogger(LoggerInterface $logger) { $this->logger = $logger; } } <?php /** * @license http://www.opensource.org/licenses/mit-license.php MIT (see the LICENSE file) */ namespace Psr\Container; /** * No entry was found in the container. */ interface NotFoundExceptionInterface extends ContainerExceptionInterface { } <?php /** * @license http://www.opensource.org/licenses/mit-license.php MIT (see the LICENSE file) */ namespace Psr\Container; /** * Base interface representing a generic exception in a container. */ interface ContainerExceptionInterface { } <?php /** * @license http://www.opensource.org/licenses/mit-license.php MIT (see the LICENSE file) */ namespace Psr\Container; /** * Describes the interface of a container that exposes methods to read its entries. */ interface ContainerInterface { /** * Finds an entry of the container by its identifier and returns it. * * @param string $id Identifier of the entry to look for. * * @throws NotFoundExceptionInterface No entry was found for **this** identifier. * @throws ContainerExceptionInterface Error while retrieving the entry. * * @return mixed Entry. */ public function get($id); /** * Returns true if the container can return an entry for the given identifier. * Returns false otherwise. * * `has($id)` returning true does not mean that `get($id)` will not throw an exception. * It does however mean that `get($id)` will not throw a `NotFoundExceptionInterface`. * * @param string $id Identifier of the entry to look for. * * @return bool */ public function has($id); } <?php /* * This file is part of the JSON Lint package. * * (c) Jordi Boggiano <j.boggiano@seld.be> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Seld\JsonLint; class ParsingException extends \Exception { /** * @var array{text?: string, token?: string|int, line?: int, loc?: array{first_line: int, first_column: int, last_line: int, last_column: int}, expected?: string[]} */ protected $details; /** * @param string $message * @phpstan-param array{text?: string, token?: string|int, line?: int, loc?: array{first_line: int, first_column: int, last_line: int, last_column: int}, expected?: string[]} $details */ public function __construct($message, $details = array()) { $this->details = $details; parent::__construct($message); } /** * @phpstan-return array{text?: string, token?: string|int, line?: int, loc?: array{first_line: int, first_column: int, last_line: int, last_column: int}, expected?: string[]} */ public function getDetails() { return $this->details; } } <?php /* * This file is part of the JSON Lint package. * * (c) Jordi Boggiano <j.boggiano@seld.be> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Seld\JsonLint; class Undefined { } <?php /* * This file is part of the JSON Lint package. * * (c) Jordi Boggiano <j.boggiano@seld.be> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Seld\JsonLint; /** * Lexer class * * Ported from https://github.com/zaach/jsonlint */ class Lexer { /** @internal */ const EOF = 1; /** @internal */ const T_INVALID = -1; const T_SKIP_WHITESPACE = 0; const T_ERROR = 2; /** @internal */ const T_BREAK_LINE = 3; /** @internal */ const T_COMMENT = 30; /** @internal */ const T_OPEN_COMMENT = 31; /** @internal */ const T_CLOSE_COMMENT = 32; /** * @phpstan-var array<int<0,17>, string> * @const */ private $rules = array( 0 => '/\G\s*\n\r?/', 1 => '/\G\s+/', 2 => '/\G-?([0-9]|[1-9][0-9]+)(\.[0-9]+)?([eE][+-]?[0-9]+)?\b/', 3 => '{\G"(?>\\\\["bfnrt/\\\\]|\\\\u[a-fA-F0-9]{4}|[^\0-\x1f\\\\"]++)*+"}', 4 => '/\G\{/', 5 => '/\G\}/', 6 => '/\G\[/', 7 => '/\G\]/', 8 => '/\G,/', 9 => '/\G:/', 10 => '/\Gtrue\b/', 11 => '/\Gfalse\b/', 12 => '/\Gnull\b/', 13 => '/\G$/', 14 => '/\G\/\//', 15 => '/\G\/\*/', 16 => '/\G\*\//', 17 => '/\G./', ); /** @var string */ private $input; /** @var bool */ private $more; /** @var bool */ private $done; /** @var 0|positive-int */ private $offset; /** @var int */ private $flags; /** @var string */ public $match; /** @var 0|positive-int */ public $yylineno; /** @var 0|positive-int */ public $yyleng; /** @var string */ public $yytext; /** @var array{first_line: 0|positive-int, first_column: 0|positive-int, last_line: 0|positive-int, last_column: 0|positive-int} */ public $yylloc; /** * @param int $flags */ public function __construct($flags = 0) { $this->flags = $flags; } /** * @return 0|1|4|6|8|10|11|14|17|18|21|22|23|24|30|-1 */ public function lex() { while (true) { $symbol = $this->next(); switch ($symbol) { case self::T_SKIP_WHITESPACE: case self::T_BREAK_LINE: break; case self::T_COMMENT: case self::T_OPEN_COMMENT: if (!($this->flags & JsonParser::ALLOW_COMMENTS)) { $this->parseError('Lexical error on line ' . ($this->yylineno+1) . ". Comments are not allowed.\n" . $this->showPosition()); } $this->skipUntil($symbol === self::T_COMMENT ? self::T_BREAK_LINE : self::T_CLOSE_COMMENT); if ($this->done) { // last symbol '/\G$/' before EOF return 14; } break; case self::T_CLOSE_COMMENT: $this->parseError('Lexical error on line ' . ($this->yylineno+1) . ". Unexpected token.\n" . $this->showPosition()); default: return $symbol; } } } /** * @param string $input * @return $this */ public function setInput($input) { $this->input = $input; $this->more = false; $this->done = false; $this->offset = 0; $this->yylineno = $this->yyleng = 0; $this->yytext = $this->match = ''; $this->yylloc = array('first_line' => 1, 'first_column' => 0, 'last_line' => 1, 'last_column' => 0); return $this; } /** * @return string */ public function showPosition() { if ($this->yylineno === 0 && $this->offset === 1 && $this->match !== '{') { return $this->match.'...' . "\n^"; } $pre = str_replace("\n", '', $this->getPastInput()); $c = str_repeat('-', max(0, \strlen($pre) - 1)); // new Array(pre.length + 1).join("-"); return $pre . str_replace("\n", '', $this->getUpcomingInput()) . "\n" . $c . "^"; } /** * @return string */ public function getPastInput() { $pastLength = $this->offset - \strlen($this->match); return ($pastLength > 20 ? '...' : '') . substr($this->input, max(0, $pastLength - 20), min(20, $pastLength)); } /** * @return string */ public function getUpcomingInput() { $next = $this->match; if (\strlen($next) < 20) { $next .= substr($this->input, $this->offset, 20 - \strlen($next)); } return substr($next, 0, 20) . (\strlen($next) > 20 ? '...' : ''); } /** * @return string */ public function getFullUpcomingInput() { $next = $this->match; if (substr($next, 0, 1) === '"' && substr_count($next, '"') === 1) { $len = \strlen($this->input); if ($len === $this->offset) { $strEnd = $len; } else { $strEnd = min(strpos($this->input, '"', $this->offset + 1) ?: $len, strpos($this->input, "\n", $this->offset + 1) ?: $len); } $next .= substr($this->input, $this->offset, $strEnd - $this->offset); } elseif (\strlen($next) < 20) { $next .= substr($this->input, $this->offset, 20 - \strlen($next)); } return $next; } /** * @param string $str * @return never */ protected function parseError($str) { throw new ParsingException($str); } /** * @param int $token * @return void */ private function skipUntil($token) { $symbol = $this->next(); while ($symbol !== $token && false === $this->done) { $symbol = $this->next(); } } /** * @return 0|1|3|4|6|8|10|11|14|17|18|21|22|23|24|30|31|32|-1 */ private function next() { if ($this->done) { return self::EOF; } if ($this->offset === \strlen($this->input)) { $this->done = true; } $token = null; $match = null; $col = null; $lines = null; if (!$this->more) { $this->yytext = ''; $this->match = ''; } $rulesLen = count($this->rules); for ($i=0; $i < $rulesLen; $i++) { if (preg_match($this->rules[$i], $this->input, $match, 0, $this->offset)) { $lines = explode("\n", $match[0]); array_shift($lines); $lineCount = \count($lines); $this->yylineno += $lineCount; $this->yylloc = array( 'first_line' => $this->yylloc['last_line'], 'last_line' => $this->yylineno+1, 'first_column' => $this->yylloc['last_column'], 'last_column' => $lineCount > 0 ? \strlen($lines[$lineCount - 1]) : $this->yylloc['last_column'] + \strlen($match[0]), ); $this->yytext .= $match[0]; $this->match .= $match[0]; $this->yyleng = \strlen($this->yytext); $this->more = false; $this->offset += \strlen($match[0]); return $this->performAction($i); } } if ($this->offset === \strlen($this->input)) { return self::EOF; } $this->parseError( 'Lexical error on line ' . ($this->yylineno+1) . ". Unrecognized text.\n" . $this->showPosition() ); } /** * @param int $rule * @return 0|3|4|6|8|10|11|14|17|18|21|22|23|24|30|31|32|-1 */ private function performAction($rule) { switch ($rule) { case 0:/* skip break line */ return self::T_BREAK_LINE; case 1:/* skip whitespace */ return self::T_SKIP_WHITESPACE; case 2: return 6; case 3: $this->yytext = substr($this->yytext, 1, $this->yyleng-2); return 4; case 4: return 17; case 5: return 18; case 6: return 23; case 7: return 24; case 8: return 22; case 9: return 21; case 10: return 10; case 11: return 11; case 12: return 8; case 13: return 14; case 14: return self::T_COMMENT; case 15: return self::T_OPEN_COMMENT; case 16: return self::T_CLOSE_COMMENT; case 17: return self::T_INVALID; default: throw new \LogicException('Unsupported rule '.$rule); } } } <?php /* * This file is part of the JSON Lint package. * * (c) Jordi Boggiano <j.boggiano@seld.be> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Seld\JsonLint; use stdClass; /** * Parser class * * Example: * * $parser = new JsonParser(); * // returns null if it's valid json, or an error object * $parser->lint($json); * // returns parsed json, like json_decode does, but slower, throws exceptions on failure. * $parser->parse($json); * * Ported from https://github.com/zaach/jsonlint */ class JsonParser { const DETECT_KEY_CONFLICTS = 1; const ALLOW_DUPLICATE_KEYS = 2; const PARSE_TO_ASSOC = 4; const ALLOW_COMMENTS = 8; const ALLOW_DUPLICATE_KEYS_TO_ARRAY = 16; /** @var Lexer */ private $lexer; /** * @var int * @phpstan-var int-mask-of<self::*> */ private $flags; /** @var list<int> */ private $stack; /** @var list<stdClass|array<mixed>|int|bool|float|string|null> */ private $vstack; // semantic value stack /** @var list<array{first_line: int, first_column: int, last_line: int, last_column: int}> */ private $lstack; // location stack /** * @phpstan-var array<string, int> */ private $symbols = array( 'error' => 2, 'JSONString' => 3, 'STRING' => 4, 'JSONNumber' => 5, 'NUMBER' => 6, 'JSONNullLiteral' => 7, 'NULL' => 8, 'JSONBooleanLiteral' => 9, 'TRUE' => 10, 'FALSE' => 11, 'JSONText' => 12, 'JSONValue' => 13, 'EOF' => 14, 'JSONObject' => 15, 'JSONArray' => 16, '{' => 17, '}' => 18, 'JSONMemberList' => 19, 'JSONMember' => 20, ':' => 21, ',' => 22, '[' => 23, ']' => 24, 'JSONElementList' => 25, '$accept' => 0, '$end' => 1, ); /** * @phpstan-var array<int, string> * @const */ private $terminals_ = array( 2 => "error", 4 => "STRING", 6 => "NUMBER", 8 => "NULL", 10 => "TRUE", 11 => "FALSE", 14 => "EOF", 17 => "{", 18 => "}", 21 => ":", 22 => ",", 23 => "[", 24 => "]", ); /** * @phpstan-var array<int<1,21>, array{int, int}> * @const */ private $productions_ = array( 1 => array(3, 1), 2 => array(5, 1), 3 => array(7, 1), 4 => array(9, 1), 5 => array(9, 1), 6 => array(12, 2), 7 => array(13, 1), 8 => array(13, 1), 9 => array(13, 1), 10 => array(13, 1), 11 => array(13, 1), 12 => array(13, 1), 13 => array(15, 2), 14 => array(15, 3), 15 => array(20, 3), 16 => array(19, 1), 17 => array(19, 3), 18 => array(16, 2), 19 => array(16, 3), 20 => array(25, 1), 21 => array(25, 3) ); /** * @var array<int<0, 31>, array<int, array<int>|int>> List of stateID=>symbolID=>actionIDs|actionID * @const */ private $table = array( 0 => array( 3 => 5, 4 => array(1,12), 5 => 6, 6 => array(1,13), 7 => 3, 8 => array(1,9), 9 => 4, 10 => array(1,10), 11 => array(1,11), 12 => 1, 13 => 2, 15 => 7, 16 => 8, 17 => array(1,14), 23 => array(1,15)), 1 => array( 1 => array(3)), 2 => array( 14 => array(1,16)), 3 => array( 14 => array(2,7), 18 => array(2,7), 22 => array(2,7), 24 => array(2,7)), 4 => array( 14 => array(2,8), 18 => array(2,8), 22 => array(2,8), 24 => array(2,8)), 5 => array( 14 => array(2,9), 18 => array(2,9), 22 => array(2,9), 24 => array(2,9)), 6 => array( 14 => array(2,10), 18 => array(2,10), 22 => array(2,10), 24 => array(2,10)), 7 => array( 14 => array(2,11), 18 => array(2,11), 22 => array(2,11), 24 => array(2,11)), 8 => array( 14 => array(2,12), 18 => array(2,12), 22 => array(2,12), 24 => array(2,12)), 9 => array( 14 => array(2,3), 18 => array(2,3), 22 => array(2,3), 24 => array(2,3)), 10 => array( 14 => array(2,4), 18 => array(2,4), 22 => array(2,4), 24 => array(2,4)), 11 => array( 14 => array(2,5), 18 => array(2,5), 22 => array(2,5), 24 => array(2,5)), 12 => array( 14 => array(2,1), 18 => array(2,1), 21 => array(2,1), 22 => array(2,1), 24 => array(2,1)), 13 => array( 14 => array(2,2), 18 => array(2,2), 22 => array(2,2), 24 => array(2,2)), 14 => array( 3 => 20, 4 => array(1,12), 18 => array(1,17), 19 => 18, 20 => 19 ), 15 => array( 3 => 5, 4 => array(1,12), 5 => 6, 6 => array(1,13), 7 => 3, 8 => array(1,9), 9 => 4, 10 => array(1,10), 11 => array(1,11), 13 => 23, 15 => 7, 16 => 8, 17 => array(1,14), 23 => array(1,15), 24 => array(1,21), 25 => 22 ), 16 => array( 1 => array(2,6)), 17 => array( 14 => array(2,13), 18 => array(2,13), 22 => array(2,13), 24 => array(2,13)), 18 => array( 18 => array(1,24), 22 => array(1,25)), 19 => array( 18 => array(2,16), 22 => array(2,16)), 20 => array( 21 => array(1,26)), 21 => array( 14 => array(2,18), 18 => array(2,18), 22 => array(2,18), 24 => array(2,18)), 22 => array( 22 => array(1,28), 24 => array(1,27)), 23 => array( 22 => array(2,20), 24 => array(2,20)), 24 => array( 14 => array(2,14), 18 => array(2,14), 22 => array(2,14), 24 => array(2,14)), 25 => array( 3 => 20, 4 => array(1,12), 20 => 29 ), 26 => array( 3 => 5, 4 => array(1,12), 5 => 6, 6 => array(1,13), 7 => 3, 8 => array(1,9), 9 => 4, 10 => array(1,10), 11 => array(1,11), 13 => 30, 15 => 7, 16 => 8, 17 => array(1,14), 23 => array(1,15)), 27 => array( 14 => array(2,19), 18 => array(2,19), 22 => array(2,19), 24 => array(2,19)), 28 => array( 3 => 5, 4 => array(1,12), 5 => 6, 6 => array(1,13), 7 => 3, 8 => array(1,9), 9 => 4, 10 => array(1,10), 11 => array(1,11), 13 => 31, 15 => 7, 16 => 8, 17 => array(1,14), 23 => array(1,15)), 29 => array( 18 => array(2,17), 22 => array(2,17)), 30 => array( 18 => array(2,15), 22 => array(2,15)), 31 => array( 22 => array(2,21), 24 => array(2,21)), ); /** * @var array{16: array{2, 6}} * @const */ private $defaultActions = array( 16 => array(2, 6) ); /** * @param string $input JSON string * @param int $flags Bitmask of parse/lint options (see constants of this class) * @return null|ParsingException null if no error is found, a ParsingException containing all details otherwise * * @phpstan-param int-mask-of<self::*> $flags */ public function lint($input, $flags = 0) { try { $this->parse($input, $flags); } catch (ParsingException $e) { return $e; } return null; } /** * @param string $input JSON string * @param int $flags Bitmask of parse/lint options (see constants of this class) * @return mixed * @throws ParsingException * * @phpstan-param int-mask-of<self::*> $flags */ public function parse($input, $flags = 0) { if (($flags & self::ALLOW_DUPLICATE_KEYS_TO_ARRAY) && ($flags & self::ALLOW_DUPLICATE_KEYS)) { throw new \InvalidArgumentException('Only one of ALLOW_DUPLICATE_KEYS and ALLOW_DUPLICATE_KEYS_TO_ARRAY can be used, you passed in both.'); } $this->failOnBOM($input); $this->flags = $flags; $this->stack = array(0); $this->vstack = array(null); $this->lstack = array(); $yytext = ''; $yylineno = 0; $yyleng = 0; /** @var int<0,3> */ $recovering = 0; $this->lexer = new Lexer($flags); $this->lexer->setInput($input); $yyloc = $this->lexer->yylloc; $this->lstack[] = $yyloc; $symbol = null; $preErrorSymbol = null; $action = null; $a = null; $r = null; $p = null; $len = null; $newState = null; $expected = null; /** @var string|null */ $errStr = null; while (true) { // retrieve state number from top of stack $state = $this->stack[\count($this->stack)-1]; // use default actions if available if (isset($this->defaultActions[$state])) { $action = $this->defaultActions[$state]; } else { if ($symbol === null) { $symbol = $this->lexer->lex(); } // read action for current state and first input /** @var array<int, int>|false */ $action = isset($this->table[$state][$symbol]) ? $this->table[$state][$symbol] : false; } // handle parse error if (!$action || !$action[0]) { assert(isset($symbol)); if (!$recovering) { // Report error $expected = array(); foreach ($this->table[$state] as $p => $ignore) { if (isset($this->terminals_[$p]) && $p > 2) { $expected[] = "'" . $this->terminals_[$p] . "'"; } } $message = null; if (\in_array("'STRING'", $expected) && \in_array(substr($this->lexer->match, 0, 1), array('"', "'"))) { $message = "Invalid string"; if ("'" === substr($this->lexer->match, 0, 1)) { $message .= ", it appears you used single quotes instead of double quotes"; } elseif (preg_match('{".+?(\\\\[^"bfnrt/\\\\u](...)?)}', $this->lexer->getFullUpcomingInput(), $match)) { $message .= ", it appears you have an unescaped backslash at: ".$match[1]; } elseif (preg_match('{"(?:[^"]+|\\\\")*$}m', $this->lexer->getFullUpcomingInput())) { $message .= ", it appears you forgot to terminate a string, or attempted to write a multiline string which is invalid"; } } $errStr = 'Parse error on line ' . ($yylineno+1) . ":\n"; $errStr .= $this->lexer->showPosition() . "\n"; if ($message) { $errStr .= $message; } else { $errStr .= (\count($expected) > 1) ? "Expected one of: " : "Expected: "; $errStr .= implode(', ', $expected); } if (',' === substr(trim($this->lexer->getPastInput()), -1)) { $errStr .= " - It appears you have an extra trailing comma"; } $this->parseError($errStr, array( 'text' => $this->lexer->match, 'token' => isset($this->terminals_[$symbol]) ? $this->terminals_[$symbol] : $symbol, 'line' => $this->lexer->yylineno, 'loc' => $yyloc, 'expected' => $expected, )); } // just recovered from another error if ($recovering == 3) { if ($symbol === Lexer::EOF) { throw new ParsingException($errStr ?: 'Parsing halted.'); } // discard current lookahead and grab another $yyleng = $this->lexer->yyleng; $yytext = $this->lexer->yytext; $yylineno = $this->lexer->yylineno; $yyloc = $this->lexer->yylloc; $symbol = $this->lexer->lex(); } // try to recover from error while (true) { // check for error recovery rule in this state if (\array_key_exists(Lexer::T_ERROR, $this->table[$state])) { break; } if ($state == 0) { throw new ParsingException($errStr ?: 'Parsing halted.'); } $this->popStack(1); $state = $this->stack[\count($this->stack)-1]; } $preErrorSymbol = $symbol; // save the lookahead token $symbol = Lexer::T_ERROR; // insert generic error symbol as new lookahead $state = $this->stack[\count($this->stack)-1]; /** @var array<int, int>|false */ $action = isset($this->table[$state][Lexer::T_ERROR]) ? $this->table[$state][Lexer::T_ERROR] : false; if ($action === false) { throw new \LogicException('No table value found for '.$state.' => '.Lexer::T_ERROR); } $recovering = 3; // allow 3 real symbols to be shifted before reporting a new error } // this shouldn't happen, unless resolve defaults are off if (\is_array($action[0]) && \count($action) > 1) { throw new ParsingException('Parse Error: multiple actions possible at state: ' . $state . ', token: ' . $symbol); } switch ($action[0]) { case 1: // shift assert(isset($symbol)); $this->stack[] = $symbol; $this->vstack[] = $this->lexer->yytext; $this->lstack[] = $this->lexer->yylloc; $this->stack[] = $action[1]; // push state $symbol = null; if (!$preErrorSymbol) { // normal execution/no error $yyleng = $this->lexer->yyleng; $yytext = $this->lexer->yytext; $yylineno = $this->lexer->yylineno; $yyloc = $this->lexer->yylloc; if ($recovering > 0) { $recovering--; } } else { // error just occurred, resume old lookahead from before error $symbol = $preErrorSymbol; $preErrorSymbol = null; } break; case 2: // reduce $len = $this->productions_[$action[1]][1]; // perform semantic action $currentToken = $this->vstack[\count($this->vstack) - $len]; // default to $$ = $1 // default location, uses first token for firsts, last for lasts $position = array( // _$ = store 'first_line' => $this->lstack[\count($this->lstack) - ($len ?: 1)]['first_line'], 'last_line' => $this->lstack[\count($this->lstack) - 1]['last_line'], 'first_column' => $this->lstack[\count($this->lstack) - ($len ?: 1)]['first_column'], 'last_column' => $this->lstack[\count($this->lstack) - 1]['last_column'], ); list($newToken, $actionResult) = $this->performAction($currentToken, $yytext, $yyleng, $yylineno, $action[1]); if (!$actionResult instanceof Undefined) { return $actionResult; } if ($len) { $this->popStack($len); } $this->stack[] = $this->productions_[$action[1]][0]; // push nonterminal (reduce) $this->vstack[] = $newToken; $this->lstack[] = $position; /** @var int */ $newState = $this->table[$this->stack[\count($this->stack)-2]][$this->stack[\count($this->stack)-1]]; $this->stack[] = $newState; break; case 3: // accept return true; } } } /** * @param string $str * @param array{text: string, token: string|int, line: int, loc: array{first_line: int, first_column: int, last_line: int, last_column: int}, expected: string[]}|null $hash * @return never */ protected function parseError($str, $hash = null) { throw new ParsingException($str, $hash ?: array()); } /** * @param stdClass|array<mixed>|int|bool|float|string|null $currentToken * @param string $yytext * @param int $yyleng * @param int $yylineno * @param int $yystate * @return array{stdClass|array<mixed>|int|bool|float|string|null, stdClass|array<mixed>|int|bool|float|string|null|Undefined} */ private function performAction($currentToken, $yytext, $yyleng, $yylineno, $yystate) { $token = $currentToken; $len = \count($this->vstack) - 1; switch ($yystate) { case 1: $yytext = preg_replace_callback('{(?:\\\\["bfnrt/\\\\]|\\\\u[a-fA-F0-9]{4})}', array($this, 'stringInterpolation'), $yytext); $token = $yytext; break; case 2: if (strpos($yytext, 'e') !== false || strpos($yytext, 'E') !== false) { $token = \floatval($yytext); } else { $token = strpos($yytext, '.') === false ? \intval($yytext) : \floatval($yytext); } break; case 3: $token = null; break; case 4: $token = true; break; case 5: $token = false; break; case 6: $token = $this->vstack[$len-1]; return array($token, $token); case 13: if ($this->flags & self::PARSE_TO_ASSOC) { $token = array(); } else { $token = new stdClass; } break; case 14: $token = $this->vstack[$len-1]; break; case 15: $token = array($this->vstack[$len-2], $this->vstack[$len]); break; case 16: assert(\is_array($this->vstack[$len])); if (PHP_VERSION_ID < 70100) { $property = $this->vstack[$len][0] === '' ? '_empty_' : $this->vstack[$len][0]; } else { $property = $this->vstack[$len][0]; } if ($this->flags & self::PARSE_TO_ASSOC) { $token = array(); $token[$property] = $this->vstack[$len][1]; } else { $token = new stdClass; $token->$property = $this->vstack[$len][1]; } break; case 17: assert(\is_array($this->vstack[$len])); if ($this->flags & self::PARSE_TO_ASSOC) { assert(\is_array($this->vstack[$len-2])); $token =& $this->vstack[$len-2]; $key = $this->vstack[$len][0]; if (($this->flags & self::DETECT_KEY_CONFLICTS) && isset($this->vstack[$len-2][$key])) { $errStr = 'Parse error on line ' . ($yylineno+1) . ":\n"; $errStr .= $this->lexer->showPosition() . "\n"; $errStr .= "Duplicate key: ".$this->vstack[$len][0]; throw new DuplicateKeyException($errStr, $this->vstack[$len][0], array('line' => $yylineno+1)); } if (($this->flags & self::ALLOW_DUPLICATE_KEYS) && isset($this->vstack[$len-2][$key])) { $duplicateCount = 1; do { $duplicateKey = $key . '.' . $duplicateCount++; } while (isset($this->vstack[$len-2][$duplicateKey])); $this->vstack[$len-2][$duplicateKey] = $this->vstack[$len][1]; } elseif (($this->flags & self::ALLOW_DUPLICATE_KEYS_TO_ARRAY) && isset($this->vstack[$len-2][$key])) { if (!isset($this->vstack[$len-2][$key]['__duplicates__']) || !is_array($this->vstack[$len-2][$key]['__duplicates__'])) { $this->vstack[$len-2][$key] = array('__duplicates__' => array($this->vstack[$len-2][$key])); } $this->vstack[$len-2][$key]['__duplicates__'][] = $this->vstack[$len][1]; } else { $this->vstack[$len-2][$key] = $this->vstack[$len][1]; } } else { assert($this->vstack[$len-2] instanceof stdClass); $token = $this->vstack[$len-2]; if (PHP_VERSION_ID < 70100) { $key = $this->vstack[$len][0] === '' ? '_empty_' : $this->vstack[$len][0]; } else { $key = $this->vstack[$len][0]; } if (($this->flags & self::DETECT_KEY_CONFLICTS) && isset($this->vstack[$len-2]->$key)) { $errStr = 'Parse error on line ' . ($yylineno+1) . ":\n"; $errStr .= $this->lexer->showPosition() . "\n"; $errStr .= "Duplicate key: ".$this->vstack[$len][0]; throw new DuplicateKeyException($errStr, $this->vstack[$len][0], array('line' => $yylineno+1)); } if (($this->flags & self::ALLOW_DUPLICATE_KEYS) && isset($this->vstack[$len-2]->$key)) { $duplicateCount = 1; do { $duplicateKey = $key . '.' . $duplicateCount++; } while (isset($this->vstack[$len-2]->$duplicateKey)); $this->vstack[$len-2]->$duplicateKey = $this->vstack[$len][1]; } elseif (($this->flags & self::ALLOW_DUPLICATE_KEYS_TO_ARRAY) && isset($this->vstack[$len-2]->$key)) { if (!isset($this->vstack[$len-2]->$key->__duplicates__)) { $this->vstack[$len-2]->$key = (object) array('__duplicates__' => array($this->vstack[$len-2]->$key)); } $this->vstack[$len-2]->$key->__duplicates__[] = $this->vstack[$len][1]; } else { $this->vstack[$len-2]->$key = $this->vstack[$len][1]; } } break; case 18: $token = array(); break; case 19: $token = $this->vstack[$len-1]; break; case 20: $token = array($this->vstack[$len]); break; case 21: assert(\is_array($this->vstack[$len-2])); $this->vstack[$len-2][] = $this->vstack[$len]; $token = $this->vstack[$len-2]; break; } return array($token, new Undefined()); } /** * @param string $match * @return string */ private function stringInterpolation($match) { switch ($match[0]) { case '\\\\': return '\\'; case '\"': return '"'; case '\b': return \chr(8); case '\f': return \chr(12); case '\n': return "\n"; case '\r': return "\r"; case '\t': return "\t"; case '\/': return "/"; default: return html_entity_decode('&#x'.ltrim(substr($match[0], 2), '0').';', ENT_QUOTES, 'UTF-8'); } } /** * @param int $n * @return void */ private function popStack($n) { $this->stack = \array_slice($this->stack, 0, - (2 * $n)); $this->vstack = \array_slice($this->vstack, 0, - $n); $this->lstack = \array_slice($this->lstack, 0, - $n); } /** * @param string $input * @return void */ private function failOnBOM($input) { // UTF-8 ByteOrderMark sequence $bom = "\xEF\xBB\xBF"; if (substr($input, 0, 3) === $bom) { $this->parseError("BOM detected, make sure your input does not include a Unicode Byte-Order-Mark"); } } } <?php /* * This file is part of the JSON Lint package. * * (c) Jordi Boggiano <j.boggiano@seld.be> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Seld\JsonLint; class DuplicateKeyException extends ParsingException { /** * @var array{key: string, line: int} */ protected $details; /** * @param string $message * @param string $key * @phpstan-param array{line: int} $details */ public function __construct($message, $key, array $details) { $details['key'] = $key; parent::__construct($message, $details); } /** * @return string */ public function getKey() { return $this->details['key']; } /** * @phpstan-return array{key: string, line: int} */ public function getDetails() { return $this->details; } } <?php /* * This file is part of PHAR Utils. * * (c) Jordi Boggiano <j.boggiano@seld.be> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Seld\PharUtils; class Timestamps { private $contents; /** * @param string $file path to the phar file to use */ public function __construct($file) { $this->contents = file_get_contents($file); } /** * Updates each file's unix timestamps in the PHAR * * The PHAR signature can then be produced in a reproducible manner. * * @param int|\DateTimeInterface|string $timestamp Date string or DateTime or unix timestamp to use */ public function updateTimestamps($timestamp = null) { if ($timestamp instanceof \DateTime || $timestamp instanceof \DateTimeInterface) { $timestamp = $timestamp->getTimestamp(); } elseif (is_string($timestamp)) { $timestamp = strtotime($timestamp); } elseif (!is_int($timestamp)) { $timestamp = strtotime('1984-12-24T00:00:00Z'); } // detect manifest offset / end of stub if (!preg_match('{__HALT_COMPILER;(?: +\?>)?\r?\n}', $this->contents, $match, PREG_OFFSET_CAPTURE)) { throw new \RuntimeException('Could not detect the stub\'s end in the phar'); } // set starting position and skip past manifest length $pos = $match[0][1] + strlen($match[0][0]); $stubEnd = $pos + $this->readUint($pos, 4); $pos += 4; $numFiles = $this->readUint($pos, 4); $pos += 4; // skip API version (YOLO) $pos += 2; // skip PHAR flags $pos += 4; $aliasLength = $this->readUint($pos, 4); $pos += 4 + $aliasLength; $metadataLength = $this->readUint($pos, 4); $pos += 4 + $metadataLength; while ($pos < $stubEnd) { $filenameLength = $this->readUint($pos, 4); $pos += 4 + $filenameLength; // skip filesize $pos += 4; // update timestamp to a fixed value $timeStampBytes = pack('L', $timestamp); $this->contents[$pos + 0] = $timeStampBytes[0]; $this->contents[$pos + 1] = $timeStampBytes[1]; $this->contents[$pos + 2] = $timeStampBytes[2]; $this->contents[$pos + 3] = $timeStampBytes[3]; // skip timestamp, compressed file size, crc32 checksum and file flags $pos += 4*4; $metadataLength = $this->readUint($pos, 4); $pos += 4 + $metadataLength; $numFiles--; } if ($numFiles !== 0) { throw new \LogicException('All files were not processed, something must have gone wrong'); } } /** * Saves the updated phar file, optionally with an updated signature. * * @param string $path * @param int $signatureAlgo One of Phar::MD5, Phar::SHA1, Phar::SHA256 or Phar::SHA512 * @return bool */ public function save($path, $signatureAlgo) { $pos = $this->determineSignatureBegin(); $algos = array( \Phar::MD5 => 'md5', \Phar::SHA1 => 'sha1', \Phar::SHA256 => 'sha256', \Phar::SHA512 => 'sha512', ); if (!isset($algos[$signatureAlgo])) { throw new \UnexpectedValueException('Invalid hash algorithm given: '.$signatureAlgo.' expected one of Phar::MD5, Phar::SHA1, Phar::SHA256 or Phar::SHA512'); } $algo = $algos[$signatureAlgo]; // re-sign phar // signature $signature = hash($algo, substr($this->contents, 0, $pos), true) // sig type . pack('L', $signatureAlgo) // ohai Greg & Marcus . 'GBMB'; $this->contents = substr($this->contents, 0, $pos) . $signature; return file_put_contents($path, $this->contents); } private function readUint($pos, $bytes) { $res = unpack('V', substr($this->contents, $pos, $bytes)); return $res[1]; } /** * Determine the beginning of the signature. * * @return int */ private function determineSignatureBegin() { // detect signature position if (!preg_match('{__HALT_COMPILER;(?: +\?>)?\r?\n}', $this->contents, $match, PREG_OFFSET_CAPTURE)) { throw new \RuntimeException('Could not detect the stub\'s end in the phar'); } // set starting position and skip past manifest length $pos = $match[0][1] + strlen($match[0][0]); $manifestEnd = $pos + 4 + $this->readUint($pos, 4); $pos += 4; $numFiles = $this->readUint($pos, 4); $pos += 4; // skip API version (YOLO) $pos += 2; // skip PHAR flags $pos += 4; $aliasLength = $this->readUint($pos, 4); $pos += 4 + $aliasLength; $metadataLength = $this->readUint($pos, 4); $pos += 4 + $metadataLength; $compressedSizes = 0; while (($numFiles > 0) && ($pos < $manifestEnd - 24)) { $filenameLength = $this->readUint($pos, 4); $pos += 4 + $filenameLength; // skip filesize and timestamp $pos += 2*4; $compressedSizes += $this->readUint($pos, 4); // skip compressed file size, crc32 checksum and file flags $pos += 3*4; $metadataLength = $this->readUint($pos, 4); $pos += 4 + $metadataLength; $numFiles--; } if ($numFiles !== 0) { throw new \LogicException('All files were not processed, something must have gone wrong'); } return $manifestEnd + $compressedSizes; } } <?php /* * This file is part of PHAR Utils. * * (c) Jordi Boggiano <j.boggiano@seld.be> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Seld\PharUtils; class Linter { /** * Lints all php files inside a given phar with the current PHP version * * @param string $path Phar file path * @param list<string> $excludedPaths Paths which should be skipped by the linter */ public static function lint($path, array $excludedPaths = array()) { $php = defined('PHP_BINARY') ? PHP_BINARY : 'php'; if ($isWindows = defined('PHP_WINDOWS_VERSION_BUILD')) { $tmpFile = @tempnam(sys_get_temp_dir(), ''); if (!$tmpFile || !is_writable($tmpFile)) { throw new \RuntimeException('Unable to create temp file'); } $php = self::escapeWindowsPath($php); $tmpFile = self::escapeWindowsPath($tmpFile); // PHP 8 encloses the command in double-quotes if (PHP_VERSION_ID >= 80000) { $format = '%s -l %s'; } else { $format = '"%s -l %s"'; } $command = sprintf($format, $php, $tmpFile); } else { $command = "'".$php."' -l"; } $descriptorspec = array( 0 => array('pipe', 'r'), 1 => array('pipe', 'w'), 2 => array('pipe', 'w') ); // path to phar + phar:// + trailing slash $baseLen = strlen(realpath($path)) + 7 + 1; foreach (new \RecursiveIteratorIterator(new \Phar($path)) as $file) { if ($file->isDir()) { continue; } if (substr($file, -4) === '.php') { $filename = (string) $file; if (in_array(substr($filename, $baseLen), $excludedPaths, true)) { continue; } if ($isWindows) { file_put_contents($tmpFile, file_get_contents($filename)); } $process = proc_open($command, $descriptorspec, $pipes); if (is_resource($process)) { if (!$isWindows) { fwrite($pipes[0], file_get_contents($filename)); } fclose($pipes[0]); $stdout = stream_get_contents($pipes[1]); fclose($pipes[1]); $stderr = stream_get_contents($pipes[2]); fclose($pipes[2]); $exitCode = proc_close($process); if ($exitCode !== 0) { if ($isWindows) { $stderr = str_replace($tmpFile, $filename, $stderr); } throw new \UnexpectedValueException('Failed linting '.$file.': '.$stderr); } } else { throw new \RuntimeException('Could not start linter process'); } } } if ($isWindows) { @unlink($tmpFile); } } /** * Escapes a Windows file path * * @param string $path * @return string The escaped path */ private static function escapeWindowsPath($path) { // Quote if path contains spaces or brackets if (strpbrk($path, " ()") !== false) { $path = '"'.$path.'"'; } return $path; } } <?php namespace JsonSchema; class Rfc3339 { const REGEX = '/^(\d{4}-\d{2}-\d{2}[T ]{1}\d{2}:\d{2}:\d{2})(\.\d+)?(Z|([+-]\d{2}):?(\d{2}))$/'; /** * Try creating a DateTime instance * * @param string $string * * @return \DateTime|null */ public static function createFromString($string) { if (!preg_match(self::REGEX, strtoupper($string), $matches)) { return null; } $dateAndTime = $matches[1]; $microseconds = $matches[2] ?: '.000000'; $timeZone = 'Z' !== $matches[3] ? $matches[4] . ':' . $matches[5] : '+00:00'; $dateFormat = strpos($dateAndTime, 'T') === false ? 'Y-m-d H:i:s.uP' : 'Y-m-d\TH:i:s.uP'; $dateTime = \DateTime::createFromFormat($dateFormat, $dateAndTime . $microseconds . $timeZone, new \DateTimeZone('UTC')); return $dateTime ?: null; } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Exception; class ValidationException extends RuntimeException { } <?php namespace JsonSchema\Exception; interface ExceptionInterface { } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Exception; /** * Wrapper for the RuntimeException */ class RuntimeException extends \RuntimeException implements ExceptionInterface { } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Exception; /** * Wrapper for the InvalidSchemaMediaType */ class InvalidSchemaException extends RuntimeException { } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Exception; /** * Wrapper for the InvalidSourceUriException */ class InvalidSourceUriException extends InvalidArgumentException { } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Exception; /** * Wrapper for the InvalidArgumentException */ class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface { } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Exception; /** * Wrapper for the JsonDecodingException */ class JsonDecodingException extends RuntimeException { public function __construct($code = JSON_ERROR_NONE, \Exception $previous = null) { switch ($code) { case JSON_ERROR_DEPTH: $message = 'The maximum stack depth has been exceeded'; break; case JSON_ERROR_STATE_MISMATCH: $message = 'Invalid or malformed JSON'; break; case JSON_ERROR_CTRL_CHAR: $message = 'Control character error, possibly incorrectly encoded'; break; case JSON_ERROR_UTF8: $message = 'Malformed UTF-8 characters, possibly incorrectly encoded'; break; case JSON_ERROR_SYNTAX: $message = 'JSON syntax is malformed'; break; default: $message = 'Syntax error'; } parent::__construct($message, $code, $previous); } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Exception; /** * Wrapper for the ResourceNotFoundException */ class ResourceNotFoundException extends RuntimeException { } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Exception; /** * @package JsonSchema\Exception * * @author Joost Nijhuis <jnijhuis81@gmail.com> */ class UnresolvableJsonPointerException extends InvalidArgumentException { } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Exception; /** * Wrapper for the InvalidSchemaMediaType */ class InvalidSchemaMediaTypeException extends RuntimeException { } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Exception; /** * Wrapper for the ResourceNotFoundException */ class InvalidConfigException extends RuntimeException { } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Exception; /** * Wrapper for the UriResolverException */ class UriResolverException extends RuntimeException { } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Iterator; /** * @package JsonSchema\Iterator * * @author Joost Nijhuis <jnijhuis81@gmail.com> */ class ObjectIterator implements \Iterator, \Countable { /** @var object */ private $object; /** @var int */ private $position = 0; /** @var array */ private $data = array(); /** @var bool */ private $initialized = false; /** * @param object $object */ public function __construct($object) { $this->object = $object; } /** * {@inheritdoc} */ public function current() { $this->initialize(); return $this->data[$this->position]; } /** * {@inheritdoc} */ public function next() { $this->initialize(); $this->position++; } /** * {@inheritdoc} */ public function key() { $this->initialize(); return $this->position; } /** * {@inheritdoc} */ public function valid() { $this->initialize(); return isset($this->data[$this->position]); } /** * {@inheritdoc} */ public function rewind() { $this->initialize(); $this->position = 0; } /** * {@inheritdoc} */ public function count() { $this->initialize(); return count($this->data); } /** * Initializer */ private function initialize() { if (!$this->initialized) { $this->data = $this->buildDataFromObject($this->object); $this->initialized = true; } } /** * @param object $object * * @return array */ private function buildDataFromObject($object) { $result = array(); $stack = new \SplStack(); $stack->push($object); while (!$stack->isEmpty()) { $current = $stack->pop(); if (is_object($current)) { array_push($result, $current); } foreach ($this->getDataFromItem($current) as $propertyName => $propertyValue) { if (is_object($propertyValue) || is_array($propertyValue)) { $stack->push($propertyValue); } } } return $result; } /** * @param object|array $item * * @return array */ private function getDataFromItem($item) { if (!is_object($item) && !is_array($item)) { return array(); } return is_object($item) ? get_object_vars($item) : $item; } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Constraints; use JsonSchema\Entity\JsonPointer; use JsonSchema\Exception\InvalidArgumentException; use UnexpectedValueException as StandardUnexpectedValueException; /** * The TypeConstraint Constraints, validates an element against a given type * * @author Robert SchÃ¶nthal <seroscho@googlemail.com> * @author Bruno Prieto Reis <bruno.p.reis@gmail.com> */ class TypeConstraint extends Constraint { /** * @var array|string[] type wordings for validation error messages */ public static $wording = array( 'integer' => 'an integer', 'number' => 'a number', 'boolean' => 'a boolean', 'object' => 'an object', 'array' => 'an array', 'string' => 'a string', 'null' => 'a null', 'any' => null, // validation of 'any' is always true so is not needed in message wording 0 => null, // validation of a false-y value is always true, so not needed as well ); /** * {@inheritdoc} */ public function check(&$value = null, $schema = null, JsonPointer $path = null, $i = null) { $type = isset($schema->type) ? $schema->type : null; $isValid = false; $wording = array(); if (is_array($type)) { $this->validateTypesArray($value, $type, $wording, $isValid, $path); } elseif (is_object($type)) { $this->checkUndefined($value, $type, $path); return; } else { $isValid = $this->validateType($value, $type); } if ($isValid === false) { if (!is_array($type)) { $this->validateTypeNameWording($type); $wording[] = self::$wording[$type]; } $this->addError($path, ucwords(gettype($value)) . ' value found, but ' . $this->implodeWith($wording, ', ', 'or') . ' is required', 'type'); } } /** * Validates the given $value against the array of types in $type. Sets the value * of $isValid to true, if at least one $type mateches the type of $value or the value * passed as $isValid is already true. * * @param mixed $value Value to validate * @param array $type TypeConstraints to check agains * @param array $validTypesWording An array of wordings of the valid types of the array $type * @param bool $isValid The current validation value * @param $path */ protected function validateTypesArray(&$value, array $type, &$validTypesWording, &$isValid, $path) { foreach ($type as $tp) { // $tp can be an object, if it's a schema instead of a simple type, validate it // with a new type constraint if (is_object($tp)) { if (!$isValid) { $validator = $this->factory->createInstanceFor('type'); $subSchema = new \stdClass(); $subSchema->type = $tp; $validator->check($value, $subSchema, $path, null); $error = $validator->getErrors(); $isValid = !(bool) $error; $validTypesWording[] = self::$wording['object']; } } else { $this->validateTypeNameWording($tp); $validTypesWording[] = self::$wording[$tp]; if (!$isValid) { $isValid = $this->validateType($value, $tp); } } } } /** * Implodes the given array like implode() with turned around parameters and with the * difference, that, if $listEnd isn't false, the last element delimiter is $listEnd instead of * $delimiter. * * @param array $elements The elements to implode * @param string $delimiter The delimiter to use * @param bool $listEnd The last delimiter to use (defaults to $delimiter) * * @return string */ protected function implodeWith(array $elements, $delimiter = ', ', $listEnd = false) { if ($listEnd === false || !isset($elements[1])) { return implode($delimiter, $elements); } $lastElement = array_slice($elements, -1); $firsElements = join($delimiter, array_slice($elements, 0, -1)); $implodedElements = array_merge(array($firsElements), $lastElement); return join(" $listEnd ", $implodedElements); } /** * Validates the given $type, if there's an associated self::$wording. If not, throws an * exception. * * @param string $type The type to validate * * @throws StandardUnexpectedValueException */ protected function validateTypeNameWording($type) { if (!array_key_exists($type, self::$wording)) { throw new StandardUnexpectedValueException( sprintf( 'No wording for %s available, expected wordings are: [%s]', var_export($type, true), implode(', ', array_filter(self::$wording))) ); } } /** * Verifies that a given value is of a certain type * * @param mixed $value Value to validate * @param string $type TypeConstraint to check against * * @throws InvalidArgumentException * * @return bool */ protected function validateType(&$value, $type) { //mostly the case for inline schema if (!$type) { return true; } if ('any' === $type) { return true; } if ('object' === $type) { return $this->getTypeCheck()->isObject($value); } if ('array' === $type) { return $this->getTypeCheck()->isArray($value); } $coerce = $this->factory->getConfig(Constraint::CHECK_MODE_COERCE_TYPES); if ('integer' === $type) { if ($coerce) { $value = $this->toInteger($value); } return is_int($value); } if ('number' === $type) { if ($coerce) { $value = $this->toNumber($value); } return is_numeric($value) && !is_string($value); } if ('boolean' === $type) { if ($coerce) { $value = $this->toBoolean($value); } return is_bool($value); } if ('string' === $type) { return is_string($value); } if ('email' === $type) { return is_string($value); } if ('null' === $type) { return is_null($value); } throw new InvalidArgumentException((is_object($value) ? 'object' : $value) . ' is an invalid type for ' . $type); } /** * Converts a value to boolean. For example, "true" becomes true. * * @param $value The value to convert to boolean * * @return bool|mixed */ protected function toBoolean($value) { if ($value === 'true') { return true; } if ($value === 'false') { return false; } return $value; } /** * Converts a numeric string to a number. For example, "4" becomes 4. * * @param mixed $value the value to convert to a number * * @return int|float|mixed */ protected function toNumber($value) { if (is_numeric($value)) { return $value + 0; // cast to number } return $value; } protected function toInteger($value) { if (is_numeric($value) && (int) $value == $value) { return (int) $value; // cast to number } return $value; } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Constraints; use JsonSchema\Entity\JsonPointer; /** * The EnumConstraint Constraints, validates an element against a given set of possibilities * * @author Robert SchÃ¶nthal <seroscho@googlemail.com> * @author Bruno Prieto Reis <bruno.p.reis@gmail.com> */ class EnumConstraint extends Constraint { /** * {@inheritdoc} */ public function check(&$element, $schema = null, JsonPointer $path = null, $i = null) { // Only validate enum if the attribute exists if ($element instanceof UndefinedConstraint && (!isset($schema->required) || !$schema->required)) { return; } $type = gettype($element); foreach ($schema->enum as $enum) { $enumType = gettype($enum); if ($this->factory->getConfig(self::CHECK_MODE_TYPE_CAST) && $type == 'array' && $enumType == 'object') { if ((object) $element == $enum) { return; } } if ($type === gettype($enum)) { if ($type == 'object') { if ($element == $enum) { return; } } elseif ($element === $enum) { return; } } } $this->addError($path, 'Does not have a value in the enumeration ' . json_encode($schema->enum), 'enum', array('enum' => $schema->enum)); } } <?php namespace JsonSchema\Constraints\TypeCheck; class StrictTypeCheck implements TypeCheckInterface { public static function isObject($value) { return is_object($value); } public static function isArray($value) { return is_array($value); } public static function propertyGet($value, $property) { return $value->{$property}; } public static function propertySet(&$value, $property, $data) { $value->{$property} = $data; } public static function propertyExists($value, $property) { return property_exists($value, $property); } public static function propertyCount($value) { if (!is_object($value)) { return 0; } return count(get_object_vars($value)); } } <?php namespace JsonSchema\Constraints\TypeCheck; class LooseTypeCheck implements TypeCheckInterface { public static function isObject($value) { return is_object($value) || (is_array($value) && (count($value) == 0 || self::isAssociativeArray($value))); } public static function isArray($value) { return is_array($value) && (count($value) == 0 || !self::isAssociativeArray($value)); } public static function propertyGet($value, $property) { if (is_object($value)) { return $value->{$property}; } return $value[$property]; } public static function propertySet(&$value, $property, $data) { if (is_object($value)) { $value->{$property} = $data; } else { $value[$property] = $data; } } public static function propertyExists($value, $property) { if (is_object($value)) { return property_exists($value, $property); } return array_key_exists($property, $value); } public static function propertyCount($value) { if (is_object($value)) { return count(get_object_vars($value)); } return count($value); } /** * Check if the provided array is associative or not * * @param array $arr * * @return bool */ private static function isAssociativeArray($arr) { return array_keys($arr) !== range(0, count($arr) - 1); } } <?php namespace JsonSchema\Constraints\TypeCheck; interface TypeCheckInterface { public static function isObject($value); public static function isArray($value); public static function propertyGet($value, $property); public static function propertySet(&$value, $property, $data); public static function propertyExists($value, $property); public static function propertyCount($value); } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Constraints; use JsonSchema\Entity\JsonPointer; use JsonSchema\Exception\InvalidArgumentException; use JsonSchema\Exception\InvalidSchemaException; use JsonSchema\Exception\RuntimeException; use JsonSchema\Validator; /** * The SchemaConstraint Constraints, validates an element against a given schema * * @author Robert SchÃ¶nthal <seroscho@googlemail.com> * @author Bruno Prieto Reis <bruno.p.reis@gmail.com> */ class SchemaConstraint extends Constraint { const DEFAULT_SCHEMA_SPEC = 'http://json-schema.org/draft-04/schema#'; /** * {@inheritdoc} */ public function check(&$element, $schema = null, JsonPointer $path = null, $i = null) { if ($schema !== null) { // passed schema $validationSchema = $schema; } elseif ($this->getTypeCheck()->propertyExists($element, $this->inlineSchemaProperty)) { // inline schema $validationSchema = $this->getTypeCheck()->propertyGet($element, $this->inlineSchemaProperty); } else { throw new InvalidArgumentException('no schema found to verify against'); } // cast array schemas to object if (is_array($validationSchema)) { $validationSchema = BaseConstraint::arrayToObjectRecursive($validationSchema); } // validate schema against whatever is defined in $validationSchema->$schema. If no // schema is defined, assume self::DEFAULT_SCHEMA_SPEC (currently draft-04). if ($this->factory->getConfig(self::CHECK_MODE_VALIDATE_SCHEMA)) { if (!$this->getTypeCheck()->isObject($validationSchema)) { throw new RuntimeException('Cannot validate the schema of a non-object'); } if ($this->getTypeCheck()->propertyExists($validationSchema, '$schema')) { $schemaSpec = $this->getTypeCheck()->propertyGet($validationSchema, '$schema'); } else { $schemaSpec = self::DEFAULT_SCHEMA_SPEC; } // get the spec schema $schemaStorage = $this->factory->getSchemaStorage(); if (!$this->getTypeCheck()->isObject($schemaSpec)) { $schemaSpec = $schemaStorage->getSchema($schemaSpec); } // save error count, config & subtract CHECK_MODE_VALIDATE_SCHEMA $initialErrorCount = $this->numErrors(); $initialConfig = $this->factory->getConfig(); $initialContext = $this->factory->getErrorContext(); $this->factory->removeConfig(self::CHECK_MODE_VALIDATE_SCHEMA | self::CHECK_MODE_APPLY_DEFAULTS); $this->factory->addConfig(self::CHECK_MODE_TYPE_CAST); $this->factory->setErrorContext(Validator::ERROR_SCHEMA_VALIDATION); // validate schema try { $this->check($validationSchema, $schemaSpec); } catch (\Exception $e) { if ($this->factory->getConfig(self::CHECK_MODE_EXCEPTIONS)) { throw new InvalidSchemaException('Schema did not pass validation', 0, $e); } } if ($this->numErrors() > $initialErrorCount) { $this->addError($path, 'Schema is not valid', 'schema'); } // restore the initial config $this->factory->setConfig($initialConfig); $this->factory->setErrorContext($initialContext); } // validate element against $validationSchema $this->checkUndefined($element, $validationSchema, $path, $i); } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Constraints; use JsonSchema\Entity\JsonPointer; /** * The NumberConstraint Constraints, validates an number against a given schema * * @author Robert SchÃ¶nthal <seroscho@googlemail.com> * @author Bruno Prieto Reis <bruno.p.reis@gmail.com> */ class NumberConstraint extends Constraint { /** * {@inheritdoc} */ public function check(&$element, $schema = null, JsonPointer $path = null, $i = null) { // Verify minimum if (isset($schema->exclusiveMinimum)) { if (isset($schema->minimum)) { if ($schema->exclusiveMinimum && $element <= $schema->minimum) { $this->addError($path, 'Must have a minimum value of ' . $schema->minimum, 'exclusiveMinimum', array('minimum' => $schema->minimum)); } elseif ($element < $schema->minimum) { $this->addError($path, 'Must have a minimum value of ' . $schema->minimum, 'minimum', array('minimum' => $schema->minimum)); } } else { $this->addError($path, 'Use of exclusiveMinimum requires presence of minimum', 'missingMinimum'); } } elseif (isset($schema->minimum) && $element < $schema->minimum) { $this->addError($path, 'Must have a minimum value of ' . $schema->minimum, 'minimum', array('minimum' => $schema->minimum)); } // Verify maximum if (isset($schema->exclusiveMaximum)) { if (isset($schema->maximum)) { if ($schema->exclusiveMaximum && $element >= $schema->maximum) { $this->addError($path, 'Must have a maximum value of ' . $schema->maximum, 'exclusiveMaximum', array('maximum' => $schema->maximum)); } elseif ($element > $schema->maximum) { $this->addError($path, 'Must have a maximum value of ' . $schema->maximum, 'maximum', array('maximum' => $schema->maximum)); } } else { $this->addError($path, 'Use of exclusiveMaximum requires presence of maximum', 'missingMaximum'); } } elseif (isset($schema->maximum) && $element > $schema->maximum) { $this->addError($path, 'Must have a maximum value of ' . $schema->maximum, 'maximum', array('maximum' => $schema->maximum)); } // Verify divisibleBy - Draft v3 if (isset($schema->divisibleBy) && $this->fmod($element, $schema->divisibleBy) != 0) { $this->addError($path, 'Is not divisible by ' . $schema->divisibleBy, 'divisibleBy', array('divisibleBy' => $schema->divisibleBy)); } // Verify multipleOf - Draft v4 if (isset($schema->multipleOf) && $this->fmod($element, $schema->multipleOf) != 0) { $this->addError($path, 'Must be a multiple of ' . $schema->multipleOf, 'multipleOf', array('multipleOf' => $schema->multipleOf)); } $this->checkFormat($element, $schema, $path, $i); } private function fmod($number1, $number2) { $modulus = ($number1 - round($number1 / $number2) * $number2); $precision = 0.0000000001; if (-$precision < $modulus && $modulus < $precision) { return 0.0; } return $modulus; } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Constraints; use JsonSchema\Entity\JsonPointer; /** * The Base Constraints, all Validators should extend this class * * @author Robert SchÃ¶nthal <seroscho@googlemail.com> * @author Bruno Prieto Reis <bruno.p.reis@gmail.com> */ abstract class Constraint extends BaseConstraint implements ConstraintInterface { protected $inlineSchemaProperty = '$schema'; const CHECK_MODE_NONE = 0x00000000; const CHECK_MODE_NORMAL = 0x00000001; const CHECK_MODE_TYPE_CAST = 0x00000002; const CHECK_MODE_COERCE_TYPES = 0x00000004; const CHECK_MODE_APPLY_DEFAULTS = 0x00000008; const CHECK_MODE_EXCEPTIONS = 0x00000010; const CHECK_MODE_DISABLE_FORMAT = 0x00000020; const CHECK_MODE_ONLY_REQUIRED_DEFAULTS = 0x00000080; const CHECK_MODE_VALIDATE_SCHEMA = 0x00000100; /** * Bubble down the path * * @param JsonPointer|null $path Current path * @param mixed $i What to append to the path * * @return JsonPointer; */ protected function incrementPath(JsonPointer $path = null, $i) { $path = $path ?: new JsonPointer(''); if ($i === null || $i === '') { return $path; } $path = $path->withPropertyPaths( array_merge( $path->getPropertyPaths(), array($i) ) ); return $path; } /** * Validates an array * * @param mixed $value * @param mixed $schema * @param JsonPointer|null $path * @param mixed $i */ protected function checkArray(&$value, $schema = null, JsonPointer $path = null, $i = null) { $validator = $this->factory->createInstanceFor('collection'); $validator->check($value, $schema, $path, $i); $this->addErrors($validator->getErrors()); } /** * Validates an object * * @param mixed $value * @param mixed $schema * @param JsonPointer|null $path * @param mixed $properties * @param mixed $additionalProperties * @param mixed $patternProperties */ protected function checkObject(&$value, $schema = null, JsonPointer $path = null, $properties = null, $additionalProperties = null, $patternProperties = null, $appliedDefaults = array()) { $validator = $this->factory->createInstanceFor('object'); $validator->check($value, $schema, $path, $properties, $additionalProperties, $patternProperties, $appliedDefaults); $this->addErrors($validator->getErrors()); } /** * Validates the type of a property * * @param mixed $value * @param mixed $schema * @param JsonPointer|null $path * @param mixed $i */ protected function checkType(&$value, $schema = null, JsonPointer $path = null, $i = null) { $validator = $this->factory->createInstanceFor('type'); $validator->check($value, $schema, $path, $i); $this->addErrors($validator->getErrors()); } /** * Checks a undefined element * * @param mixed $value * @param mixed $schema * @param JsonPointer|null $path * @param mixed $i */ protected function checkUndefined(&$value, $schema = null, JsonPointer $path = null, $i = null, $fromDefault = false) { $validator = $this->factory->createInstanceFor('undefined'); $validator->check($value, $this->factory->getSchemaStorage()->resolveRefSchema($schema), $path, $i, $fromDefault); $this->addErrors($validator->getErrors()); } /** * Checks a string element * * @param mixed $value * @param mixed $schema * @param JsonPointer|null $path * @param mixed $i */ protected function checkString($value, $schema = null, JsonPointer $path = null, $i = null) { $validator = $this->factory->createInstanceFor('string'); $validator->check($value, $schema, $path, $i); $this->addErrors($validator->getErrors()); } /** * Checks a number element * * @param mixed $value * @param mixed $schema * @param JsonPointer $path * @param mixed $i */ protected function checkNumber($value, $schema = null, JsonPointer $path = null, $i = null) { $validator = $this->factory->createInstanceFor('number'); $validator->check($value, $schema, $path, $i); $this->addErrors($validator->getErrors()); } /** * Checks a enum element * * @param mixed $value * @param mixed $schema * @param JsonPointer|null $path * @param mixed $i */ protected function checkEnum($value, $schema = null, JsonPointer $path = null, $i = null) { $validator = $this->factory->createInstanceFor('enum'); $validator->check($value, $schema, $path, $i); $this->addErrors($validator->getErrors()); } /** * Checks format of an element * * @param mixed $value * @param mixed $schema * @param JsonPointer|null $path * @param mixed $i */ protected function checkFormat($value, $schema = null, JsonPointer $path = null, $i = null) { $validator = $this->factory->createInstanceFor('format'); $validator->check($value, $schema, $path, $i); $this->addErrors($validator->getErrors()); } /** * Get the type check based on the set check mode. * * @return TypeCheck\TypeCheckInterface */ protected function getTypeCheck() { return $this->factory->getTypeCheck(); } /** * @param JsonPointer $pointer * * @return string property path */ protected function convertJsonPointerIntoPropertyPath(JsonPointer $pointer) { $result = array_map( function ($path) { return sprintf(is_numeric($path) ? '[%d]' : '.%s', $path); }, $pointer->getPropertyPaths() ); return trim(implode('', $result), '.'); } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Constraints; use JsonSchema\Entity\JsonPointer; /** * The StringConstraint Constraints, validates an string against a given schema * * @author Robert SchÃ¶nthal <seroscho@googlemail.com> * @author Bruno Prieto Reis <bruno.p.reis@gmail.com> */ class StringConstraint extends Constraint { /** * {@inheritdoc} */ public function check(&$element, $schema = null, JsonPointer $path = null, $i = null) { // Verify maxLength if (isset($schema->maxLength) && $this->strlen($element) > $schema->maxLength) { $this->addError($path, 'Must be at most ' . $schema->maxLength . ' characters long', 'maxLength', array( 'maxLength' => $schema->maxLength, )); } //verify minLength if (isset($schema->minLength) && $this->strlen($element) < $schema->minLength) { $this->addError($path, 'Must be at least ' . $schema->minLength . ' characters long', 'minLength', array( 'minLength' => $schema->minLength, )); } // Verify a regex pattern if (isset($schema->pattern) && !preg_match('#' . str_replace('#', '\\#', $schema->pattern) . '#u', $element)) { $this->addError($path, 'Does not match the regex pattern ' . $schema->pattern, 'pattern', array( 'pattern' => $schema->pattern, )); } $this->checkFormat($element, $schema, $path, $i); } private function strlen($string) { if (extension_loaded('mbstring')) { return mb_strlen($string, mb_detect_encoding($string)); } // mbstring is present on all test platforms, so strlen() can be ignored for coverage return strlen($string); // @codeCoverageIgnore } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Constraints; use JsonSchema\Entity\JsonPointer; /** * The CollectionConstraint Constraints, validates an array against a given schema * * @author Robert SchÃ¶nthal <seroscho@googlemail.com> * @author Bruno Prieto Reis <bruno.p.reis@gmail.com> */ class CollectionConstraint extends Constraint { /** * {@inheritdoc} */ public function check(&$value, $schema = null, JsonPointer $path = null, $i = null) { // Verify minItems if (isset($schema->minItems) && count($value) < $schema->minItems) { $this->addError($path, 'There must be a minimum of ' . $schema->minItems . ' items in the array', 'minItems', array('minItems' => $schema->minItems)); } // Verify maxItems if (isset($schema->maxItems) && count($value) > $schema->maxItems) { $this->addError($path, 'There must be a maximum of ' . $schema->maxItems . ' items in the array', 'maxItems', array('maxItems' => $schema->maxItems)); } // Verify uniqueItems if (isset($schema->uniqueItems) && $schema->uniqueItems) { $unique = $value; if (is_array($value) && count($value)) { $unique = array_map(function ($e) { return var_export($e, true); }, $value); } if (count(array_unique($unique)) != count($value)) { $this->addError($path, 'There are no duplicates allowed in the array', 'uniqueItems'); } } // Verify items if (isset($schema->items)) { $this->validateItems($value, $schema, $path, $i); } } /** * Validates the items * * @param array $value * @param \stdClass $schema * @param JsonPointer|null $path * @param string $i */ protected function validateItems(&$value, $schema = null, JsonPointer $path = null, $i = null) { if (is_object($schema->items)) { // just one type definition for the whole array foreach ($value as $k => &$v) { $initErrors = $this->getErrors(); // First check if its defined in "items" $this->checkUndefined($v, $schema->items, $path, $k); // Recheck with "additionalItems" if the first test fails if (count($initErrors) < count($this->getErrors()) && (isset($schema->additionalItems) && $schema->additionalItems !== false)) { $secondErrors = $this->getErrors(); $this->checkUndefined($v, $schema->additionalItems, $path, $k); } // Reset errors if needed if (isset($secondErrors) && count($secondErrors) < count($this->getErrors())) { $this->errors = $secondErrors; } elseif (isset($secondErrors) && count($secondErrors) === count($this->getErrors())) { $this->errors = $initErrors; } } unset($v); /* remove dangling reference to prevent any future bugs * caused by accidentally using $v elsewhere */ } else { // Defined item type definitions foreach ($value as $k => &$v) { if (array_key_exists($k, $schema->items)) { $this->checkUndefined($v, $schema->items[$k], $path, $k); } else { // Additional items if (property_exists($schema, 'additionalItems')) { if ($schema->additionalItems !== false) { $this->checkUndefined($v, $schema->additionalItems, $path, $k); } else { $this->addError( $path, 'The item ' . $i . '[' . $k . '] is not defined and the definition does not allow additional items', 'additionalItems', array('additionalItems' => $schema->additionalItems)); } } else { // Should be valid against an empty schema $this->checkUndefined($v, new \stdClass(), $path, $k); } } } unset($v); /* remove dangling reference to prevent any future bugs * caused by accidentally using $v elsewhere */ // Treat when we have more schema definitions than values, not for empty arrays if (count($value) > 0) { for ($k = count($value); $k < count($schema->items); $k++) { $undefinedInstance = $this->factory->createInstanceFor('undefined'); $this->checkUndefined($undefinedInstance, $schema->items[$k], $path, $k); } } } } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Constraints; use JsonSchema\Constraints\TypeCheck\LooseTypeCheck; use JsonSchema\Entity\JsonPointer; use JsonSchema\Exception\ValidationException; use JsonSchema\Uri\UriResolver; /** * The UndefinedConstraint Constraints * * @author Robert SchÃ¶nthal <seroscho@googlemail.com> * @author Bruno Prieto Reis <bruno.p.reis@gmail.com> */ #[\AllowDynamicProperties] class UndefinedConstraint extends Constraint { /** * @var array List of properties to which a default value has been applied */ protected $appliedDefaults = array(); /** * {@inheritdoc} */ public function check(&$value, $schema = null, JsonPointer $path = null, $i = null, $fromDefault = false) { if (is_null($schema) || !is_object($schema)) { return; } $path = $this->incrementPath($path ?: new JsonPointer(''), $i); if ($fromDefault) { $path->setFromDefault(); } // check special properties $this->validateCommonProperties($value, $schema, $path, $i); // check allOf, anyOf, and oneOf properties $this->validateOfProperties($value, $schema, $path, ''); // check known types $this->validateTypes($value, $schema, $path, $i); } /** * Validates the value against the types * * @param mixed $value * @param mixed $schema * @param JsonPointer $path * @param string $i */ public function validateTypes(&$value, $schema, JsonPointer $path, $i = null) { // check array if ($this->getTypeCheck()->isArray($value)) { $this->checkArray($value, $schema, $path, $i); } // check object if (LooseTypeCheck::isObject($value)) { // object processing should always be run on assoc arrays, // so use LooseTypeCheck here even if CHECK_MODE_TYPE_CAST // is not set (i.e. don't use $this->getTypeCheck() here). $this->checkObject( $value, $schema, $path, isset($schema->properties) ? $schema->properties : null, isset($schema->additionalProperties) ? $schema->additionalProperties : null, isset($schema->patternProperties) ? $schema->patternProperties : null, $this->appliedDefaults ); } // check string if (is_string($value)) { $this->checkString($value, $schema, $path, $i); } // check numeric if (is_numeric($value)) { $this->checkNumber($value, $schema, $path, $i); } // check enum if (isset($schema->enum)) { $this->checkEnum($value, $schema, $path, $i); } } /** * Validates common properties * * @param mixed $value * @param mixed $schema * @param JsonPointer $path * @param string $i */ protected function validateCommonProperties(&$value, $schema, JsonPointer $path, $i = '') { // if it extends another schema, it must pass that schema as well if (isset($schema->extends)) { if (is_string($schema->extends)) { $schema->extends = $this->validateUri($schema, $schema->extends); } if (is_array($schema->extends)) { foreach ($schema->extends as $extends) { $this->checkUndefined($value, $extends, $path, $i); } } else { $this->checkUndefined($value, $schema->extends, $path, $i); } } // Apply default values from schema if (!$path->fromDefault()) { $this->applyDefaultValues($value, $schema, $path); } // Verify required values if ($this->getTypeCheck()->isObject($value)) { if (!($value instanceof self) && isset($schema->required) && is_array($schema->required)) { // Draft 4 - Required is an array of strings - e.g. "required": ["foo", ...] foreach ($schema->required as $required) { if (!$this->getTypeCheck()->propertyExists($value, $required)) { $this->addError( $this->incrementPath($path ?: new JsonPointer(''), $required), 'The property ' . $required . ' is required', 'required' ); } } } elseif (isset($schema->required) && !is_array($schema->required)) { // Draft 3 - Required attribute - e.g. "foo": {"type": "string", "required": true} if ($schema->required && $value instanceof self) { $propertyPaths = $path->getPropertyPaths(); $propertyName = end($propertyPaths); $this->addError( $path, 'The property ' . $propertyName . ' is required', 'required' ); } } else { // if the value is both undefined and not required, skip remaining checks // in this method which assume an actual, defined instance when validating. if ($value instanceof self) { return; } } } // Verify type if (!($value instanceof self)) { $this->checkType($value, $schema, $path, $i); } // Verify disallowed items if (isset($schema->disallow)) { $initErrors = $this->getErrors(); $typeSchema = new \stdClass(); $typeSchema->type = $schema->disallow; $this->checkType($value, $typeSchema, $path); // if no new errors were raised it must be a disallowed value if (count($this->getErrors()) == count($initErrors)) { $this->addError($path, 'Disallowed value was matched', 'disallow'); } else { $this->errors = $initErrors; } } if (isset($schema->not)) { $initErrors = $this->getErrors(); $this->checkUndefined($value, $schema->not, $path, $i); // if no new errors were raised then the instance validated against the "not" schema if (count($this->getErrors()) == count($initErrors)) { $this->addError($path, 'Matched a schema which it should not', 'not'); } else { $this->errors = $initErrors; } } // Verify that dependencies are met if (isset($schema->dependencies) && $this->getTypeCheck()->isObject($value)) { $this->validateDependencies($value, $schema->dependencies, $path); } } /** * Check whether a default should be applied for this value * * @param mixed $schema * @param mixed $parentSchema * @param bool $requiredOnly * * @return bool */ private function shouldApplyDefaultValue($requiredOnly, $schema, $name = null, $parentSchema = null) { // required-only mode is off if (!$requiredOnly) { return true; } // draft-04 required is set if ( $name !== null && isset($parentSchema->required) && is_array($parentSchema->required) && in_array($name, $parentSchema->required) ) { return true; } // draft-03 required is set if (isset($schema->required) && !is_array($schema->required) && $schema->required) { return true; } // default case return false; } /** * Apply default values * * @param mixed $value * @param mixed $schema * @param JsonPointer $path */ protected function applyDefaultValues(&$value, $schema, $path) { // only apply defaults if feature is enabled if (!$this->factory->getConfig(self::CHECK_MODE_APPLY_DEFAULTS)) { return; } // apply defaults if appropriate $requiredOnly = $this->factory->getConfig(self::CHECK_MODE_ONLY_REQUIRED_DEFAULTS); if (isset($schema->properties) && LooseTypeCheck::isObject($value)) { // $value is an object or assoc array, and properties are defined - treat as an object foreach ($schema->properties as $currentProperty => $propertyDefinition) { $propertyDefinition = $this->factory->getSchemaStorage()->resolveRefSchema($propertyDefinition); if ( !LooseTypeCheck::propertyExists($value, $currentProperty) && property_exists($propertyDefinition, 'default') && $this->shouldApplyDefaultValue($requiredOnly, $propertyDefinition, $currentProperty, $schema) ) { // assign default value if (is_object($propertyDefinition->default)) { LooseTypeCheck::propertySet($value, $currentProperty, clone $propertyDefinition->default); } else { LooseTypeCheck::propertySet($value, $currentProperty, $propertyDefinition->default); } $this->appliedDefaults[] = $currentProperty; } } } elseif (isset($schema->items) && LooseTypeCheck::isArray($value)) { $items = array(); if (LooseTypeCheck::isArray($schema->items)) { $items = $schema->items; } elseif (isset($schema->minItems) && count($value) < $schema->minItems) { $items = array_fill(count($value), $schema->minItems - count($value), $schema->items); } // $value is an array, and items are defined - treat as plain array foreach ($items as $currentItem => $itemDefinition) { $itemDefinition = $this->factory->getSchemaStorage()->resolveRefSchema($itemDefinition); if ( !array_key_exists($currentItem, $value) && property_exists($itemDefinition, 'default') && $this->shouldApplyDefaultValue($requiredOnly, $itemDefinition)) { if (is_object($itemDefinition->default)) { $value[$currentItem] = clone $itemDefinition->default; } else { $value[$currentItem] = $itemDefinition->default; } } $path->setFromDefault(); } } elseif ( $value instanceof self && property_exists($schema, 'default') && $this->shouldApplyDefaultValue($requiredOnly, $schema)) { // $value is a leaf, not a container - apply the default directly $value = is_object($schema->default) ? clone $schema->default : $schema->default; $path->setFromDefault(); } } /** * Validate allOf, anyOf, and oneOf properties * * @param mixed $value * @param mixed $schema * @param JsonPointer $path * @param string $i */ protected function validateOfProperties(&$value, $schema, JsonPointer $path, $i = '') { // Verify type if ($value instanceof self) { return; } if (isset($schema->allOf)) { $isValid = true; foreach ($schema->allOf as $allOf) { $initErrors = $this->getErrors(); $this->checkUndefined($value, $allOf, $path, $i); $isValid = $isValid && (count($this->getErrors()) == count($initErrors)); } if (!$isValid) { $this->addError($path, 'Failed to match all schemas', 'allOf'); } } if (isset($schema->anyOf)) { $isValid = false; $startErrors = $this->getErrors(); $caughtException = null; foreach ($schema->anyOf as $anyOf) { $initErrors = $this->getErrors(); try { $this->checkUndefined($value, $anyOf, $path, $i); if ($isValid = (count($this->getErrors()) == count($initErrors))) { break; } } catch (ValidationException $e) { $isValid = false; } } if (!$isValid) { $this->addError($path, 'Failed to match at least one schema', 'anyOf'); } else { $this->errors = $startErrors; } } if (isset($schema->oneOf)) { $allErrors = array(); $matchedSchemas = 0; $startErrors = $this->getErrors(); foreach ($schema->oneOf as $oneOf) { try { $this->errors = array(); $this->checkUndefined($value, $oneOf, $path, $i); if (count($this->getErrors()) == 0) { $matchedSchemas++; } $allErrors = array_merge($allErrors, array_values($this->getErrors())); } catch (ValidationException $e) { // deliberately do nothing here - validation failed, but we want to check // other schema options in the OneOf field. } } if ($matchedSchemas !== 1) { $this->addErrors(array_merge($allErrors, $startErrors)); $this->addError($path, 'Failed to match exactly one schema', 'oneOf'); } else { $this->errors = $startErrors; } } } /** * Validate dependencies * * @param mixed $value * @param mixed $dependencies * @param JsonPointer $path * @param string $i */ protected function validateDependencies($value, $dependencies, JsonPointer $path, $i = '') { foreach ($dependencies as $key => $dependency) { if ($this->getTypeCheck()->propertyExists($value, $key)) { if (is_string($dependency)) { // Draft 3 string is allowed - e.g. "dependencies": {"bar": "foo"} if (!$this->getTypeCheck()->propertyExists($value, $dependency)) { $this->addError($path, "$key depends on $dependency and $dependency is missing", 'dependencies'); } } elseif (is_array($dependency)) { // Draft 4 must be an array - e.g. "dependencies": {"bar": ["foo"]} foreach ($dependency as $d) { if (!$this->getTypeCheck()->propertyExists($value, $d)) { $this->addError($path, "$key depends on $d and $d is missing", 'dependencies'); } } } elseif (is_object($dependency)) { // Schema - e.g. "dependencies": {"bar": {"properties": {"foo": {...}}}} $this->checkUndefined($value, $dependency, $path, $i); } } } } protected function validateUri($schema, $schemaUri = null) { $resolver = new UriResolver(); $retriever = $this->factory->getUriRetriever(); $jsonSchema = null; if ($resolver->isValid($schemaUri)) { $schemaId = property_exists($schema, 'id') ? $schema->id : null; $jsonSchema = $retriever->retrieve($schemaId, $schemaUri); } return $jsonSchema; } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Constraints; use JsonSchema\Entity\JsonPointer; use JsonSchema\Exception\InvalidArgumentException; use JsonSchema\Exception\ValidationException; use JsonSchema\Validator; /** * A more basic constraint definition - used for the public * interface to avoid exposing library internals. */ class BaseConstraint { /** * @var array Errors */ protected $errors = array(); /** * @var int All error types which have occurred */ protected $errorMask = Validator::ERROR_NONE; /** * @var Factory */ protected $factory; /** * @param Factory $factory */ public function __construct(Factory $factory = null) { $this->factory = $factory ?: new Factory(); } public function addError(JsonPointer $path = null, $message, $constraint = '', array $more = null) { $error = array( 'property' => $this->convertJsonPointerIntoPropertyPath($path ?: new JsonPointer('')), 'pointer' => ltrim(strval($path ?: new JsonPointer('')), '#'), 'message' => $message, 'constraint' => $constraint, 'context' => $this->factory->getErrorContext(), ); if ($this->factory->getConfig(Constraint::CHECK_MODE_EXCEPTIONS)) { throw new ValidationException(sprintf('Error validating %s: %s', $error['pointer'], $error['message'])); } if (is_array($more) && count($more) > 0) { $error += $more; } $this->errors[] = $error; $this->errorMask |= $error['context']; } public function addErrors(array $errors) { if ($errors) { $this->errors = array_merge($this->errors, $errors); $errorMask = &$this->errorMask; array_walk($errors, function ($error) use (&$errorMask) { if (isset($error['context'])) { $errorMask |= $error['context']; } }); } } public function getErrors($errorContext = Validator::ERROR_ALL) { if ($errorContext === Validator::ERROR_ALL) { return $this->errors; } return array_filter($this->errors, function ($error) use ($errorContext) { if ($errorContext & $error['context']) { return true; } }); } public function numErrors($errorContext = Validator::ERROR_ALL) { if ($errorContext === Validator::ERROR_ALL) { return count($this->errors); } return count($this->getErrors($errorContext)); } public function isValid() { return !$this->getErrors(); } /** * Clears any reported errors. Should be used between * multiple validation checks. */ public function reset() { $this->errors = array(); $this->errorMask = Validator::ERROR_NONE; } /** * Get the error mask * * @return int */ public function getErrorMask() { return $this->errorMask; } /** * Recursively cast an associative array to an object * * @param array $array * * @return object */ public static function arrayToObjectRecursive($array) { $json = json_encode($array); if (json_last_error() !== \JSON_ERROR_NONE) { $message = 'Unable to encode schema array as JSON'; if (function_exists('json_last_error_msg')) { $message .= ': ' . json_last_error_msg(); } throw new InvalidArgumentException($message); } return (object) json_decode($json); } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Constraints; use JsonSchema\Entity\JsonPointer; /** * The ObjectConstraint Constraints, validates an object against a given schema * * @author Robert SchÃ¶nthal <seroscho@googlemail.com> * @author Bruno Prieto Reis <bruno.p.reis@gmail.com> */ class ObjectConstraint extends Constraint { /** * @var array List of properties to which a default value has been applied */ protected $appliedDefaults = array(); /** * {@inheritdoc} */ public function check(&$element, $schema = null, JsonPointer $path = null, $properties = null, $additionalProp = null, $patternProperties = null, $appliedDefaults = array()) { if ($element instanceof UndefinedConstraint) { return; } $this->appliedDefaults = $appliedDefaults; $matches = array(); if ($patternProperties) { // validate the element pattern properties $matches = $this->validatePatternProperties($element, $path, $patternProperties); } if ($properties) { // validate the element properties $this->validateProperties($element, $properties, $path); } // validate additional element properties & constraints $this->validateElement($element, $matches, $schema, $path, $properties, $additionalProp); } public function validatePatternProperties($element, JsonPointer $path = null, $patternProperties) { $try = array('/', '#', '+', '~', '%'); $matches = array(); foreach ($patternProperties as $pregex => $schema) { $delimiter = '/'; // Choose delimiter. Necessary for patterns like ^/ , otherwise you get error foreach ($try as $delimiter) { if (strpos($pregex, $delimiter) === false) { // safe to use break; } } // Validate the pattern before using it to test for matches if (@preg_match($delimiter . $pregex . $delimiter . 'u', '') === false) { $this->addError($path, 'The pattern "' . $pregex . '" is invalid', 'pregex', array('pregex' => $pregex)); continue; } foreach ($element as $i => $value) { if (preg_match($delimiter . $pregex . $delimiter . 'u', $i)) { $matches[] = $i; $this->checkUndefined($value, $schema ?: new \stdClass(), $path, $i, in_array($i, $this->appliedDefaults)); } } } return $matches; } /** * Validates the element properties * * @param \StdClass $element Element to validate * @param array $matches Matches from patternProperties (if any) * @param \StdClass $schema ObjectConstraint definition * @param JsonPointer|null $path Current test path * @param \StdClass $properties Properties * @param mixed $additionalProp Additional properties */ public function validateElement($element, $matches, $schema = null, JsonPointer $path = null, $properties = null, $additionalProp = null) { $this->validateMinMaxConstraint($element, $schema, $path); foreach ($element as $i => $value) { $definition = $this->getProperty($properties, $i); // no additional properties allowed if (!in_array($i, $matches) && $additionalProp === false && $this->inlineSchemaProperty !== $i && !$definition) { $this->addError($path, 'The property ' . $i . ' is not defined and the definition does not allow additional properties', 'additionalProp'); } // additional properties defined if (!in_array($i, $matches) && $additionalProp && !$definition) { if ($additionalProp === true) { $this->checkUndefined($value, null, $path, $i, in_array($i, $this->appliedDefaults)); } else { $this->checkUndefined($value, $additionalProp, $path, $i, in_array($i, $this->appliedDefaults)); } } // property requires presence of another $require = $this->getProperty($definition, 'requires'); if ($require && !$this->getProperty($element, $require)) { $this->addError($path, 'The presence of the property ' . $i . ' requires that ' . $require . ' also be present', 'requires'); } $property = $this->getProperty($element, $i, $this->factory->createInstanceFor('undefined')); if (is_object($property)) { $this->validateMinMaxConstraint(!($property instanceof UndefinedConstraint) ? $property : $element, $definition, $path); } } } /** * Validates the definition properties * * @param \stdClass $element Element to validate * @param \stdClass $properties Property definitions * @param JsonPointer|null $path Path? */ public function validateProperties(&$element, $properties = null, JsonPointer $path = null) { $undefinedConstraint = $this->factory->createInstanceFor('undefined'); foreach ($properties as $i => $value) { $property = &$this->getProperty($element, $i, $undefinedConstraint); $definition = $this->getProperty($properties, $i); if (is_object($definition)) { // Undefined constraint will check for is_object() and quit if is not - so why pass it? $this->checkUndefined($property, $definition, $path, $i, in_array($i, $this->appliedDefaults)); } } } /** * retrieves a property from an object or array * * @param mixed $element Element to validate * @param string $property Property to retrieve * @param mixed $fallback Default value if property is not found * * @return mixed */ protected function &getProperty(&$element, $property, $fallback = null) { if (is_array($element) && (isset($element[$property]) || array_key_exists($property, $element)) /*$this->checkMode == self::CHECK_MODE_TYPE_CAST*/) { return $element[$property]; } elseif (is_object($element) && property_exists($element, $property)) { return $element->$property; } return $fallback; } /** * validating minimum and maximum property constraints (if present) against an element * * @param \stdClass $element Element to validate * @param \stdClass $objectDefinition ObjectConstraint definition * @param JsonPointer|null $path Path to test? */ protected function validateMinMaxConstraint($element, $objectDefinition, JsonPointer $path = null) { // Verify minimum number of properties if (isset($objectDefinition->minProperties) && !is_object($objectDefinition->minProperties)) { if ($this->getTypeCheck()->propertyCount($element) < $objectDefinition->minProperties) { $this->addError($path, 'Must contain a minimum of ' . $objectDefinition->minProperties . ' properties', 'minProperties', array('minProperties' => $objectDefinition->minProperties)); } } // Verify maximum number of properties if (isset($objectDefinition->maxProperties) && !is_object($objectDefinition->maxProperties)) { if ($this->getTypeCheck()->propertyCount($element) > $objectDefinition->maxProperties) { $this->addError($path, 'Must contain no more than ' . $objectDefinition->maxProperties . ' properties', 'maxProperties', array('maxProperties' => $objectDefinition->maxProperties)); } } } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Constraints; use JsonSchema\Entity\JsonPointer; use JsonSchema\Rfc3339; /** * Validates against the "format" property * * @author Justin Rainbow <justin.rainbow@gmail.com> * * @see http://tools.ietf.org/html/draft-zyp-json-schema-03#section-5.23 */ class FormatConstraint extends Constraint { /** * {@inheritdoc} */ public function check(&$element, $schema = null, JsonPointer $path = null, $i = null) { if (!isset($schema->format) || $this->factory->getConfig(self::CHECK_MODE_DISABLE_FORMAT)) { return; } switch ($schema->format) { case 'date': if (!$date = $this->validateDateTime($element, 'Y-m-d')) { $this->addError($path, sprintf('Invalid date %s, expected format YYYY-MM-DD', json_encode($element)), 'format', array('format' => $schema->format)); } break; case 'time': if (!$this->validateDateTime($element, 'H:i:s')) { $this->addError($path, sprintf('Invalid time %s, expected format hh:mm:ss', json_encode($element)), 'format', array('format' => $schema->format)); } break; case 'date-time': if (null === Rfc3339::createFromString($element)) { $this->addError($path, sprintf('Invalid date-time %s, expected format YYYY-MM-DDThh:mm:ssZ or YYYY-MM-DDThh:mm:ss+hh:mm', json_encode($element)), 'format', array('format' => $schema->format)); } break; case 'utc-millisec': if (!$this->validateDateTime($element, 'U')) { $this->addError($path, sprintf('Invalid time %s, expected integer of milliseconds since Epoch', json_encode($element)), 'format', array('format' => $schema->format)); } break; case 'regex': if (!$this->validateRegex($element)) { $this->addError($path, 'Invalid regex format ' . $element, 'format', array('format' => $schema->format)); } break; case 'color': if (!$this->validateColor($element)) { $this->addError($path, 'Invalid color', 'format', array('format' => $schema->format)); } break; case 'style': if (!$this->validateStyle($element)) { $this->addError($path, 'Invalid style', 'format', array('format' => $schema->format)); } break; case 'phone': if (!$this->validatePhone($element)) { $this->addError($path, 'Invalid phone number', 'format', array('format' => $schema->format)); } break; case 'uri': if (null === filter_var($element, FILTER_VALIDATE_URL, FILTER_NULL_ON_FAILURE)) { $this->addError($path, 'Invalid URL format', 'format', array('format' => $schema->format)); } break; case 'uriref': case 'uri-reference': if (null === filter_var($element, FILTER_VALIDATE_URL, FILTER_NULL_ON_FAILURE)) { // FILTER_VALIDATE_URL does not conform to RFC-3986, and cannot handle relative URLs, but // the json-schema spec uses RFC-3986, so need a bit of hackery to properly validate them. // See https://tools.ietf.org/html/rfc3986#section-4.2 for additional information. if (substr($element, 0, 2) === '//') { // network-path reference $validURL = filter_var('scheme:' . $element, FILTER_VALIDATE_URL, FILTER_NULL_ON_FAILURE); } elseif (substr($element, 0, 1) === '/') { // absolute-path reference $validURL = filter_var('scheme://host' . $element, FILTER_VALIDATE_URL, FILTER_NULL_ON_FAILURE); } elseif (strlen($element)) { // relative-path reference $pathParts = explode('/', $element, 2); if (strpos($pathParts[0], ':') !== false) { $validURL = null; } else { $validURL = filter_var('scheme://host/' . $element, FILTER_VALIDATE_URL, FILTER_NULL_ON_FAILURE); } } else { $validURL = null; } if ($validURL === null) { $this->addError($path, 'Invalid URL format', 'format', array('format' => $schema->format)); } } break; case 'email': $filterFlags = FILTER_NULL_ON_FAILURE; if (defined('FILTER_FLAG_EMAIL_UNICODE')) { // Only available from PHP >= 7.1.0, so ignore it for coverage checks $filterFlags |= constant('FILTER_FLAG_EMAIL_UNICODE'); // @codeCoverageIgnore } if (null === filter_var($element, FILTER_VALIDATE_EMAIL, $filterFlags)) { $this->addError($path, 'Invalid email', 'format', array('format' => $schema->format)); } break; case 'ip-address': case 'ipv4': if (null === filter_var($element, FILTER_VALIDATE_IP, FILTER_NULL_ON_FAILURE | FILTER_FLAG_IPV4)) { $this->addError($path, 'Invalid IP address', 'format', array('format' => $schema->format)); } break; case 'ipv6': if (null === filter_var($element, FILTER_VALIDATE_IP, FILTER_NULL_ON_FAILURE | FILTER_FLAG_IPV6)) { $this->addError($path, 'Invalid IP address', 'format', array('format' => $schema->format)); } break; case 'host-name': case 'hostname': if (!$this->validateHostname($element)) { $this->addError($path, 'Invalid hostname', 'format', array('format' => $schema->format)); } break; default: // Empty as it should be: // The value of this keyword is called a format attribute. It MUST be a string. // A format attribute can generally only validate a given set of instance types. // If the type of the instance to validate is not in this set, validation for // this format attribute and instance SHOULD succeed. // http://json-schema.org/latest/json-schema-validation.html#anchor105 break; } } protected function validateDateTime($datetime, $format) { $dt = \DateTime::createFromFormat($format, $datetime); if (!$dt) { return false; } if ($datetime === $dt->format($format)) { return true; } // handles the case where a non-6 digit microsecond datetime is passed // which will fail the above string comparison because the passed // $datetime may be '2000-05-01T12:12:12.123Z' but format() will return // '2000-05-01T12:12:12.123000Z' if ((strpos('u', $format) !== -1) && (preg_match('/\.\d+Z$/', $datetime))) { return true; } return false; } protected function validateRegex($regex) { return false !== @preg_match('/' . $regex . '/u', ''); } protected function validateColor($color) { if (in_array(strtolower($color), array('aqua', 'black', 'blue', 'fuchsia', 'gray', 'green', 'lime', 'maroon', 'navy', 'olive', 'orange', 'purple', 'red', 'silver', 'teal', 'white', 'yellow'))) { return true; } return preg_match('/^#([a-f0-9]{3}|[a-f0-9]{6})$/i', $color); } protected function validateStyle($style) { $properties = explode(';', rtrim($style, ';')); $invalidEntries = preg_grep('/^\s*[-a-z]+\s*:\s*.+$/i', $properties, PREG_GREP_INVERT); return empty($invalidEntries); } protected function validatePhone($phone) { return preg_match('/^\+?($\d{3}$|\d{3}) \d{3} \d{4}$/', $phone); } protected function validateHostname($host) { $hostnameRegex = '/^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\-]*[A-Za-z0-9])$/i'; return preg_match($hostnameRegex, $host); } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Constraints; use JsonSchema\Exception\InvalidArgumentException; use JsonSchema\SchemaStorage; use JsonSchema\SchemaStorageInterface; use JsonSchema\Uri\UriRetriever; use JsonSchema\UriRetrieverInterface; use JsonSchema\Validator; /** * Factory for centralize constraint initialization. */ class Factory { /** * @var SchemaStorage */ protected $schemaStorage; /** * @var UriRetriever */ protected $uriRetriever; /** * @var int */ private $checkMode = Constraint::CHECK_MODE_NORMAL; /** * @var TypeCheck\TypeCheckInterface[] */ private $typeCheck = array(); /** * @var int Validation context */ protected $errorContext = Validator::ERROR_DOCUMENT_VALIDATION; /** * @var array */ protected $constraintMap = array( 'array' => 'JsonSchema\Constraints\CollectionConstraint', 'collection' => 'JsonSchema\Constraints\CollectionConstraint', 'object' => 'JsonSchema\Constraints\ObjectConstraint', 'type' => 'JsonSchema\Constraints\TypeConstraint', 'undefined' => 'JsonSchema\Constraints\UndefinedConstraint', 'string' => 'JsonSchema\Constraints\StringConstraint', 'number' => 'JsonSchema\Constraints\NumberConstraint', 'enum' => 'JsonSchema\Constraints\EnumConstraint', 'format' => 'JsonSchema\Constraints\FormatConstraint', 'schema' => 'JsonSchema\Constraints\SchemaConstraint', 'validator' => 'JsonSchema\Validator' ); /** * @var array<ConstraintInterface> */ private $instanceCache = array(); /** * @param SchemaStorage $schemaStorage * @param UriRetrieverInterface $uriRetriever * @param int $checkMode */ public function __construct( SchemaStorageInterface $schemaStorage = null, UriRetrieverInterface $uriRetriever = null, $checkMode = Constraint::CHECK_MODE_NORMAL ) { // set provided config options $this->setConfig($checkMode); $this->uriRetriever = $uriRetriever ?: new UriRetriever(); $this->schemaStorage = $schemaStorage ?: new SchemaStorage($this->uriRetriever); } /** * Set config values * * @param int $checkMode Set checkMode options - does not preserve existing flags */ public function setConfig($checkMode = Constraint::CHECK_MODE_NORMAL) { $this->checkMode = $checkMode; } /** * Enable checkMode flags * * @param int $options */ public function addConfig($options) { $this->checkMode |= $options; } /** * Disable checkMode flags * * @param int $options */ public function removeConfig($options) { $this->checkMode &= ~$options; } /** * Get checkMode option * * @param int $options Options to get, if null then return entire bitmask * * @return int */ public function getConfig($options = null) { if ($options === null) { return $this->checkMode; } return $this->checkMode & $options; } /** * @return UriRetrieverInterface */ public function getUriRetriever() { return $this->uriRetriever; } public function getSchemaStorage() { return $this->schemaStorage; } public function getTypeCheck() { if (!isset($this->typeCheck[$this->checkMode])) { $this->typeCheck[$this->checkMode] = ($this->checkMode & Constraint::CHECK_MODE_TYPE_CAST) ? new TypeCheck\LooseTypeCheck() : new TypeCheck\StrictTypeCheck(); } return $this->typeCheck[$this->checkMode]; } /** * @param string $name * @param string $class * * @return Factory */ public function setConstraintClass($name, $class) { // Ensure class exists if (!class_exists($class)) { throw new InvalidArgumentException('Unknown constraint ' . $name); } // Ensure class is appropriate if (!in_array('JsonSchema\Constraints\ConstraintInterface', class_implements($class))) { throw new InvalidArgumentException('Invalid class ' . $name); } $this->constraintMap[$name] = $class; return $this; } /** * Create a constraint instance for the given constraint name. * * @param string $constraintName * * @throws InvalidArgumentException if is not possible create the constraint instance * * @return ConstraintInterface|ObjectConstraint */ public function createInstanceFor($constraintName) { if (!isset($this->constraintMap[$constraintName])) { throw new InvalidArgumentException('Unknown constraint ' . $constraintName); } if (!isset($this->instanceCache[$constraintName])) { $this->instanceCache[$constraintName] = new $this->constraintMap[$constraintName]($this); } return clone $this->instanceCache[$constraintName]; } /** * Get the error context * * @return string */ public function getErrorContext() { return $this->errorContext; } /** * Set the error context * * @param string $validationContext */ public function setErrorContext($errorContext) { $this->errorContext = $errorContext; } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Constraints; use JsonSchema\Entity\JsonPointer; /** * The Constraints Interface * * @author Robert SchÃ¶nthal <seroscho@googlemail.com> */ interface ConstraintInterface { /** * returns all collected errors * * @return array */ public function getErrors(); /** * adds errors to this validator * * @param array $errors */ public function addErrors(array $errors); /** * adds an error * * @param JsonPointer|null $path * @param string $message * @param string $constraint the constraint/rule that is broken, e.g.: 'minLength' * @param array $more more array elements to add to the error */ public function addError(JsonPointer $path = null, $message, $constraint='', array $more = null); /** * checks if the validator has not raised errors * * @return bool */ public function isValid(); /** * invokes the validation of an element * * @abstract * * @param mixed $value * @param mixed $schema * @param JsonPointer|null $path * @param mixed $i * * @throws \JsonSchema\Exception\ExceptionInterface */ public function check(&$value, $schema = null, JsonPointer $path = null, $i = null); } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema; use JsonSchema\Constraints\BaseConstraint; use JsonSchema\Constraints\Constraint; /** * A JsonSchema Constraint * * @author Robert SchÃ¶nthal <seroscho@googlemail.com> * @author Bruno Prieto Reis <bruno.p.reis@gmail.com> * * @see README.md */ class Validator extends BaseConstraint { const SCHEMA_MEDIA_TYPE = 'application/schema+json'; const ERROR_NONE = 0x00000000; const ERROR_ALL = 0xFFFFFFFF; const ERROR_DOCUMENT_VALIDATION = 0x00000001; const ERROR_SCHEMA_VALIDATION = 0x00000002; /** * Validates the given data against the schema and returns an object containing the results * Both the php object and the schema are supposed to be a result of a json_decode call. * The validation works as defined by the schema proposal in http://json-schema.org. * * Note that the first argument is passed by reference, so you must pass in a variable. */ public function validate(&$value, $schema = null, $checkMode = null) { // make sure $schema is an object if (is_array($schema)) { $schema = self::arrayToObjectRecursive($schema); } // set checkMode $initialCheckMode = $this->factory->getConfig(); if ($checkMode !== null) { $this->factory->setConfig($checkMode); } // add provided schema to SchemaStorage with internal URI to allow internal $ref resolution if (is_object($schema) && property_exists($schema, 'id')) { $schemaURI = $schema->id; } else { $schemaURI = SchemaStorage::INTERNAL_PROVIDED_SCHEMA_URI; } $this->factory->getSchemaStorage()->addSchema($schemaURI, $schema); $validator = $this->factory->createInstanceFor('schema'); $validator->check( $value, $this->factory->getSchemaStorage()->getSchema($schemaURI) ); $this->factory->setConfig($initialCheckMode); $this->addErrors(array_unique($validator->getErrors(), SORT_REGULAR)); return $validator->getErrorMask(); } /** * Alias to validate(), to maintain backwards-compatibility with the previous API */ public function check($value, $schema) { return $this->validate($value, $schema); } /** * Alias to validate(), to maintain backwards-compatibility with the previous API */ public function coerce(&$value, $schema) { return $this->validate($value, $schema, Constraint::CHECK_MODE_COERCE_TYPES); } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema; /** * @package JsonSchema */ interface UriRetrieverInterface { /** * Retrieve a URI * * @param string $uri JSON Schema URI * @param null|string $baseUri * * @return object JSON Schema contents */ public function retrieve($uri, $baseUri = null); } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Entity; use JsonSchema\Exception\InvalidArgumentException; /** * @package JsonSchema\Entity * * @author Joost Nijhuis <jnijhuis81@gmail.com> */ class JsonPointer { /** @var string */ private $filename; /** @var string[] */ private $propertyPaths = array(); /** * @var bool Whether the value at this path was set from a schema default */ private $fromDefault = false; /** * @param string $value * * @throws InvalidArgumentException when $value is not a string */ public function __construct($value) { if (!is_string($value)) { throw new InvalidArgumentException('Ref value must be a string'); } $splitRef = explode('#', $value, 2); $this->filename = $splitRef[0]; if (array_key_exists(1, $splitRef)) { $this->propertyPaths = $this->decodePropertyPaths($splitRef[1]); } } /** * @param string $propertyPathString * * @return string[] */ private function decodePropertyPaths($propertyPathString) { $paths = array(); foreach (explode('/', trim($propertyPathString, '/')) as $path) { $path = $this->decodePath($path); if (is_string($path) && '' !== $path) { $paths[] = $path; } } return $paths; } /** * @return array */ private function encodePropertyPaths() { return array_map( array($this, 'encodePath'), $this->getPropertyPaths() ); } /** * @param string $path * * @return string */ private function decodePath($path) { return strtr($path, array('~1' => '/', '~0' => '~', '%25' => '%')); } /** * @param string $path * * @return string */ private function encodePath($path) { return strtr($path, array('/' => '~1', '~' => '~0', '%' => '%25')); } /** * @return string */ public function getFilename() { return $this->filename; } /** * @return string[] */ public function getPropertyPaths() { return $this->propertyPaths; } /** * @param array $propertyPaths * * @return JsonPointer */ public function withPropertyPaths(array $propertyPaths) { $new = clone $this; $new->propertyPaths = $propertyPaths; return $new; } /** * @return string */ public function getPropertyPathAsString() { return rtrim('#/' . implode('/', $this->encodePropertyPaths()), '/'); } /** * @return string */ public function __toString() { return $this->getFilename() . $this->getPropertyPathAsString(); } /** * Mark the value at this path as being set from a schema default */ public function setFromDefault() { $this->fromDefault = true; } /** * Check whether the value at this path was set from a schema default * * @return bool */ public function fromDefault() { return $this->fromDefault; } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema; /** * @package JsonSchema */ interface UriResolverInterface { /** * Resolves a URI * * @param string $uri Absolute or relative * @param null|string $baseUri Optional base URI * * @return string Absolute URI */ public function resolve($uri, $baseUri = null); } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Uri; use JsonSchema\Exception\UriResolverException; use JsonSchema\UriResolverInterface; /** * Resolves JSON Schema URIs * * @author Sander Coolen <sander@jibber.nl> */ class UriResolver implements UriResolverInterface { /** * Parses a URI into five main components * * @param string $uri * * @return array */ public function parse($uri) { preg_match('|^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?|', $uri, $match); $components = array(); if (5 < count($match)) { $components = array( 'scheme' => $match[2], 'authority' => $match[4], 'path' => $match[5] ); } if (7 < count($match)) { $components['query'] = $match[7]; } if (9 < count($match)) { $components['fragment'] = $match[9]; } return $components; } /** * Builds a URI based on n array with the main components * * @param array $components * * @return string */ public function generate(array $components) { $uri = $components['scheme'] . '://' . $components['authority'] . $components['path']; if (array_key_exists('query', $components) && strlen($components['query'])) { $uri .= '?' . $components['query']; } if (array_key_exists('fragment', $components)) { $uri .= '#' . $components['fragment']; } return $uri; } /** * {@inheritdoc} */ public function resolve($uri, $baseUri = null) { // treat non-uri base as local file path if ( !is_null($baseUri) && !filter_var($baseUri, \FILTER_VALIDATE_URL) && !preg_match('|^[^/]+://|u', $baseUri) ) { if (is_file($baseUri)) { $baseUri = 'file://' . realpath($baseUri); } elseif (is_dir($baseUri)) { $baseUri = 'file://' . realpath($baseUri) . '/'; } else { $baseUri = 'file://' . getcwd() . '/' . $baseUri; } } if ($uri == '') { return $baseUri; } $components = $this->parse($uri); $path = $components['path']; if (!empty($components['scheme'])) { return $uri; } $baseComponents = $this->parse($baseUri); $basePath = $baseComponents['path']; $baseComponents['path'] = self::combineRelativePathWithBasePath($path, $basePath); if (isset($components['fragment'])) { $baseComponents['fragment'] = $components['fragment']; } return $this->generate($baseComponents); } /** * Tries to glue a relative path onto an absolute one * * @param string $relativePath * @param string $basePath * * @throws UriResolverException * * @return string Merged path */ public static function combineRelativePathWithBasePath($relativePath, $basePath) { $relativePath = self::normalizePath($relativePath); if ($relativePath == '') { return $basePath; } if ($relativePath[0] == '/') { return $relativePath; } $basePathSegments = explode('/', $basePath); preg_match('|^/?(\.\./(?:\./)*)*|', $relativePath, $match); $numLevelUp = strlen($match[0]) /3 + 1; if ($numLevelUp >= count($basePathSegments)) { throw new UriResolverException(sprintf("Unable to resolve URI '%s' from base '%s'", $relativePath, $basePath)); } $basePathSegments = array_slice($basePathSegments, 0, -$numLevelUp); $path = preg_replace('|^/?(\.\./(\./)*)*|', '', $relativePath); return implode('/', $basePathSegments) . '/' . $path; } /** * Normalizes a URI path component by removing dot-slash and double slashes * * @param string $path * * @return string */ private static function normalizePath($path) { $path = preg_replace('|((?<!\.)\./)*|', '', $path); $path = preg_replace('|//|', '/', $path); return $path; } /** * @param string $uri * * @return bool */ public function isValid($uri) { $components = $this->parse($uri); return !empty($components); } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Uri; use JsonSchema\Exception\InvalidSchemaMediaTypeException; use JsonSchema\Exception\JsonDecodingException; use JsonSchema\Exception\ResourceNotFoundException; use JsonSchema\Uri\Retrievers\FileGetContents; use JsonSchema\Uri\Retrievers\UriRetrieverInterface; use JsonSchema\UriRetrieverInterface as BaseUriRetrieverInterface; use JsonSchema\Validator; /** * Retrieves JSON Schema URIs * * @author Tyler Akins <fidian@rumkin.com> */ class UriRetriever implements BaseUriRetrieverInterface { /** * @var array Map of URL translations */ protected $translationMap = array( // use local copies of the spec schemas '|^https?://json-schema.org/draft-(0[34])/schema#?|' => 'package://dist/schema/json-schema-draft-$1.json' ); /** * @var array A list of endpoints for media type check exclusion */ protected $allowedInvalidContentTypeEndpoints = array( 'http://json-schema.org/', 'https://json-schema.org/' ); /** * @var null|UriRetrieverInterface */ protected $uriRetriever = null; /** * @var array|object[] * * @see loadSchema */ private $schemaCache = array(); /** * Adds an endpoint to the media type validation exclusion list * * @param string $endpoint */ public function addInvalidContentTypeEndpoint($endpoint) { $this->allowedInvalidContentTypeEndpoints[] = $endpoint; } /** * Guarantee the correct media type was encountered * * @param UriRetrieverInterface $uriRetriever * @param string $uri * * @return bool|void */ public function confirmMediaType($uriRetriever, $uri) { $contentType = $uriRetriever->getContentType(); if (is_null($contentType)) { // Well, we didn't get an invalid one return; } if (in_array($contentType, array(Validator::SCHEMA_MEDIA_TYPE, 'application/json'))) { return; } foreach ($this->allowedInvalidContentTypeEndpoints as $endpoint) { if (strpos($uri, $endpoint) === 0) { return true; } } throw new InvalidSchemaMediaTypeException(sprintf('Media type %s expected', Validator::SCHEMA_MEDIA_TYPE)); } /** * Get a URI Retriever * * If none is specified, sets a default FileGetContents retriever and * returns that object. * * @return UriRetrieverInterface */ public function getUriRetriever() { if (is_null($this->uriRetriever)) { $this->setUriRetriever(new FileGetContents()); } return $this->uriRetriever; } /** * Resolve a schema based on pointer * * URIs can have a fragment at the end in the format of * #/path/to/object and we are to look up the 'path' property of * the first object then the 'to' and 'object' properties. * * @param object $jsonSchema JSON Schema contents * @param string $uri JSON Schema URI * * @throws ResourceNotFoundException * * @return object JSON Schema after walking down the fragment pieces */ public function resolvePointer($jsonSchema, $uri) { $resolver = new UriResolver(); $parsed = $resolver->parse($uri); if (empty($parsed['fragment'])) { return $jsonSchema; } $path = explode('/', $parsed['fragment']); while ($path) { $pathElement = array_shift($path); if (!empty($pathElement)) { $pathElement = str_replace('~1', '/', $pathElement); $pathElement = str_replace('~0', '~', $pathElement); if (!empty($jsonSchema->$pathElement)) { $jsonSchema = $jsonSchema->$pathElement; } else { throw new ResourceNotFoundException( 'Fragment "' . $parsed['fragment'] . '" not found' . ' in ' . $uri ); } if (!is_object($jsonSchema)) { throw new ResourceNotFoundException( 'Fragment part "' . $pathElement . '" is no object ' . ' in ' . $uri ); } } } return $jsonSchema; } /** * {@inheritdoc} */ public function retrieve($uri, $baseUri = null, $translate = true) { $resolver = new UriResolver(); $resolvedUri = $fetchUri = $resolver->resolve($uri, $baseUri); //fetch URL without #fragment $arParts = $resolver->parse($resolvedUri); if (isset($arParts['fragment'])) { unset($arParts['fragment']); $fetchUri = $resolver->generate($arParts); } // apply URI translations if ($translate) { $fetchUri = $this->translate($fetchUri); } $jsonSchema = $this->loadSchema($fetchUri); // Use the JSON pointer if specified $jsonSchema = $this->resolvePointer($jsonSchema, $resolvedUri); if ($jsonSchema instanceof \stdClass) { $jsonSchema->id = $resolvedUri; } return $jsonSchema; } /** * Fetch a schema from the given URI, json-decode it and return it. * Caches schema objects. * * @param string $fetchUri Absolute URI * * @return object JSON schema object */ protected function loadSchema($fetchUri) { if (isset($this->schemaCache[$fetchUri])) { return $this->schemaCache[$fetchUri]; } $uriRetriever = $this->getUriRetriever(); $contents = $this->uriRetriever->retrieve($fetchUri); $this->confirmMediaType($uriRetriever, $fetchUri); $jsonSchema = json_decode($contents); if (JSON_ERROR_NONE < $error = json_last_error()) { throw new JsonDecodingException($error); } $this->schemaCache[$fetchUri] = $jsonSchema; return $jsonSchema; } /** * Set the URI Retriever * * @param UriRetrieverInterface $uriRetriever * * @return $this for chaining */ public function setUriRetriever(UriRetrieverInterface $uriRetriever) { $this->uriRetriever = $uriRetriever; return $this; } /** * Parses a URI into five main components * * @param string $uri * * @return array */ public function parse($uri) { preg_match('|^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?|', $uri, $match); $components = array(); if (5 < count($match)) { $components = array( 'scheme' => $match[2], 'authority' => $match[4], 'path' => $match[5] ); } if (7 < count($match)) { $components['query'] = $match[7]; } if (9 < count($match)) { $components['fragment'] = $match[9]; } return $components; } /** * Builds a URI based on n array with the main components * * @param array $components * * @return string */ public function generate(array $components) { $uri = $components['scheme'] . '://' . $components['authority'] . $components['path']; if (array_key_exists('query', $components)) { $uri .= $components['query']; } if (array_key_exists('fragment', $components)) { $uri .= $components['fragment']; } return $uri; } /** * Resolves a URI * * @param string $uri Absolute or relative * @param string $baseUri Optional base URI * * @return string */ public function resolve($uri, $baseUri = null) { $components = $this->parse($uri); $path = $components['path']; if ((array_key_exists('scheme', $components)) && ('http' === $components['scheme'])) { return $uri; } $baseComponents = $this->parse($baseUri); $basePath = $baseComponents['path']; $baseComponents['path'] = UriResolver::combineRelativePathWithBasePath($path, $basePath); return $this->generate($baseComponents); } /** * @param string $uri * * @return bool */ public function isValid($uri) { $components = $this->parse($uri); return !empty($components); } /** * Set a URL translation rule */ public function setTranslation($from, $to) { $this->translationMap[$from] = $to; } /** * Apply URI translation rules */ public function translate($uri) { foreach ($this->translationMap as $from => $to) { $uri = preg_replace($from, $to, $uri); } // translate references to local files within the json-schema package $uri = preg_replace('|^package://|', sprintf('file://%s/', realpath(__DIR__ . '/../../..')), $uri); return $uri; } } <?php namespace JsonSchema\Uri\Retrievers; use JsonSchema\Validator; /** * URI retrieved based on a predefined array of schemas * * @example * * $retriever = new PredefinedArray(array( * 'http://acme.com/schemas/person#' => '{ ... }', * 'http://acme.com/schemas/address#' => '{ ... }', * )) * * $schema = $retriever->retrieve('http://acme.com/schemas/person#'); */ class PredefinedArray extends AbstractRetriever { /** * Contains schemas as URI => JSON * * @var array */ private $schemas; /** * Constructor * * @param array $schemas * @param string $contentType */ public function __construct(array $schemas, $contentType = Validator::SCHEMA_MEDIA_TYPE) { $this->schemas = $schemas; $this->contentType = $contentType; } /** * {@inheritdoc} * * @see \JsonSchema\Uri\Retrievers\UriRetrieverInterface::retrieve() */ public function retrieve($uri) { if (!array_key_exists($uri, $this->schemas)) { throw new \JsonSchema\Exception\ResourceNotFoundException(sprintf( 'The JSON schema "%s" was not found.', $uri )); } return $this->schemas[$uri]; } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Uri\Retrievers; use JsonSchema\Exception\ResourceNotFoundException; /** * Tries to retrieve JSON schemas from a URI using file_get_contents() * * @author Sander Coolen <sander@jibber.nl> */ class FileGetContents extends AbstractRetriever { protected $messageBody; /** * {@inheritdoc} * * @see \JsonSchema\Uri\Retrievers\UriRetrieverInterface::retrieve() */ public function retrieve($uri) { $errorMessage = null; set_error_handler(function ($errno, $errstr) use (&$errorMessage) { $errorMessage = $errstr; }); $response = file_get_contents($uri); restore_error_handler(); if ($errorMessage) { throw new ResourceNotFoundException($errorMessage); } if (false === $response) { throw new ResourceNotFoundException('JSON schema not found at ' . $uri); } if ($response == '' && substr($uri, 0, 7) == 'file://' && substr($uri, -1) == '/' ) { throw new ResourceNotFoundException('JSON schema not found at ' . $uri); } $this->messageBody = $response; if (!empty($http_response_header)) { // $http_response_header cannot be tested, because it's defined in the method's local scope // See http://php.net/manual/en/reserved.variables.httpresponseheader.php for more info. $this->fetchContentType($http_response_header); // @codeCoverageIgnore } else { // @codeCoverageIgnore // Could be a "file://" url or something else - fake up the response $this->contentType = null; } return $this->messageBody; } /** * @param array $headers HTTP Response Headers * * @return bool Whether the Content-Type header was found or not */ private function fetchContentType(array $headers) { foreach ($headers as $header) { if ($this->contentType = self::getContentTypeMatchInHeader($header)) { return true; } } return false; } /** * @param string $header * * @return string|null */ protected static function getContentTypeMatchInHeader($header) { if (0 < preg_match("/Content-Type:(\V*)/ims", $header, $match)) { return trim($match[1]); } return null; } } <?php /** * JsonSchema * * @filesource */ namespace JsonSchema\Uri\Retrievers; /** * AbstractRetriever implements the default shared behavior * that all descendant Retrievers should inherit * * @author Steven Garcia <webwhammy@gmail.com> */ abstract class AbstractRetriever implements UriRetrieverInterface { /** * Media content type * * @var string */ protected $contentType; /** * {@inheritdoc} * * @see \JsonSchema\Uri\Retrievers\UriRetrieverInterface::getContentType() */ public function getContentType() { return $this->contentType; } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Uri\Retrievers; use JsonSchema\Exception\RuntimeException; use JsonSchema\Validator; /** * Tries to retrieve JSON schemas from a URI using cURL library * * @author Sander Coolen <sander@jibber.nl> */ class Curl extends AbstractRetriever { protected $messageBody; public function __construct() { if (!function_exists('curl_init')) { // Cannot test this, because curl_init is present on all test platforms plus mock throw new RuntimeException('cURL not installed'); // @codeCoverageIgnore } } /** * {@inheritdoc} * * @see \JsonSchema\Uri\Retrievers\UriRetrieverInterface::retrieve() */ public function retrieve($uri) { $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $uri); curl_setopt($ch, CURLOPT_HEADER, true); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, array('Accept: ' . Validator::SCHEMA_MEDIA_TYPE)); $response = curl_exec($ch); if (false === $response) { throw new \JsonSchema\Exception\ResourceNotFoundException('JSON schema not found'); } $this->fetchMessageBody($response); $this->fetchContentType($response); curl_close($ch); return $this->messageBody; } /** * @param string $response cURL HTTP response */ private function fetchMessageBody($response) { preg_match("/(?:\r\n){2}(.*)$/ms", $response, $match); $this->messageBody = $match[1]; } /** * @param string $response cURL HTTP response * * @return bool Whether the Content-Type header was found or not */ protected function fetchContentType($response) { if (0 < preg_match("/Content-Type:(\V*)/ims", $response, $match)) { $this->contentType = trim($match[1]); return true; } return false; } } <?php /* * This file is part of the JsonSchema package. * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace JsonSchema\Uri\Retrievers; /** * Interface for URI retrievers * * @author Sander Coolen <sander@jibber.nl> */ interface UriRetrieverInterface { /** * Retrieve a schema from the specified URI * * @param string $uri URI that resolves to a JSON schema * * @throws \JsonSchema\Exception\ResourceNotFoundException * * @return mixed string|null */ public function retrieve($uri); /** * Get media content type * * @return string */ public function getContentType(); } <?php namespace JsonSchema; use JsonSchema\Constraints\BaseConstraint; use JsonSchema\Entity\JsonPointer; use JsonSchema\Exception\UnresolvableJsonPointerException; use JsonSchema\Uri\UriResolver; use JsonSchema\Uri\UriRetriever; class SchemaStorage implements SchemaStorageInterface { const INTERNAL_PROVIDED_SCHEMA_URI = 'internal://provided-schema/'; protected $uriRetriever; protected $uriResolver; protected $schemas = array(); public function __construct( UriRetrieverInterface $uriRetriever = null, UriResolverInterface $uriResolver = null ) { $this->uriRetriever = $uriRetriever ?: new UriRetriever(); $this->uriResolver = $uriResolver ?: new UriResolver(); } /** * @return UriRetrieverInterface */ public function getUriRetriever() { return $this->uriRetriever; } /** * @return UriResolverInterface */ public function getUriResolver() { return $this->uriResolver; } /** * {@inheritdoc} */ public function addSchema($id, $schema = null) { if (is_null($schema) && $id !== self::INTERNAL_PROVIDED_SCHEMA_URI) { // if the schema was user-provided to Validator and is still null, then assume this is // what the user intended, as there's no way for us to retrieve anything else. User-supplied // schemas do not have an associated URI when passed via Validator::validate(). $schema = $this->uriRetriever->retrieve($id); } // cast array schemas to object if (is_array($schema)) { $schema = BaseConstraint::arrayToObjectRecursive($schema); } // workaround for bug in draft-03 & draft-04 meta-schemas (id & $ref defined with incorrect format) // see https://github.com/json-schema-org/JSON-Schema-Test-Suite/issues/177#issuecomment-293051367 if (is_object($schema) && property_exists($schema, 'id')) { if ($schema->id == 'http://json-schema.org/draft-04/schema#') { $schema->properties->id->format = 'uri-reference'; } elseif ($schema->id == 'http://json-schema.org/draft-03/schema#') { $schema->properties->id->format = 'uri-reference'; $schema->properties->{'$ref'}->format = 'uri-reference'; } } // resolve references $this->expandRefs($schema, $id); $this->schemas[$id] = $schema; } /** * Recursively resolve all references against the provided base * * @param mixed $schema * @param string $base */ private function expandRefs(&$schema, $base = null) { if (!is_object($schema)) { if (is_array($schema)) { foreach ($schema as &$member) { $this->expandRefs($member, $base); } } return; } if (property_exists($schema, 'id') && is_string($schema->id) && $base != $schema->id) { $base = $this->uriResolver->resolve($schema->id, $base); } if (property_exists($schema, '$ref') && is_string($schema->{'$ref'})) { $refPointer = new JsonPointer($this->uriResolver->resolve($schema->{'$ref'}, $base)); $schema->{'$ref'} = (string) $refPointer; } foreach ($schema as &$member) { $this->expandRefs($member, $base); } } /** * {@inheritdoc} */ public function getSchema($id) { if (!array_key_exists($id, $this->schemas)) { $this->addSchema($id); } return $this->schemas[$id]; } /** * {@inheritdoc} */ public function resolveRef($ref) { $jsonPointer = new JsonPointer($ref); // resolve filename for pointer $fileName = $jsonPointer->getFilename(); if (!strlen($fileName)) { throw new UnresolvableJsonPointerException(sprintf( "Could not resolve fragment '%s': no file is defined", $jsonPointer->getPropertyPathAsString() )); } // get & process the schema $refSchema = $this->getSchema($fileName); foreach ($jsonPointer->getPropertyPaths() as $path) { if (is_object($refSchema) && property_exists($refSchema, $path)) { $refSchema = $this->resolveRefSchema($refSchema->{$path}); } elseif (is_array($refSchema) && array_key_exists($path, $refSchema)) { $refSchema = $this->resolveRefSchema($refSchema[$path]); } else { throw new UnresolvableJsonPointerException(sprintf( 'File: %s is found, but could not resolve fragment: %s', $jsonPointer->getFilename(), $jsonPointer->getPropertyPathAsString() )); } } return $refSchema; } /** * {@inheritdoc} */ public function resolveRefSchema($refSchema) { if (is_object($refSchema) && property_exists($refSchema, '$ref') && is_string($refSchema->{'$ref'})) { $newSchema = $this->resolveRef($refSchema->{'$ref'}); $refSchema = (object) (get_object_vars($refSchema) + get_object_vars($newSchema)); unset($refSchema->{'$ref'}); } return $refSchema; } } <?php namespace JsonSchema; interface SchemaStorageInterface { /** * Adds schema with given identifier * * @param string $id * @param object $schema */ public function addSchema($id, $schema = null); /** * Returns schema for given identifier, or null if it does not exist * * @param string $id * * @return object */ public function getSchema($id); /** * Returns schema for given reference with all sub-references resolved * * @param string $ref * * @return object */ public function resolveRef($ref); /** * Returns schema referenced by '$ref' property * * @param mixed $refSchema * * @return object */ public function resolveRefSchema($refSchema); } <?php namespace Gettext\Languages; use Exception; /** * Holds the CLDR data. */ class CldrData { /** * Super-special plural category: this should always be present for any language. * * @var string */ const OTHER_CATEGORY = 'other'; /** * The list of the plural categories, sorted from 'zero' to 'other'. * * @var string[] */ public static $categories = array('zero', 'one', 'two', 'few', 'many', self::OTHER_CATEGORY); /** * The loaded CLDR data. * * @var array */ private static $data; /** * @var array */ private static $plurals; /** * Returns a dictionary containing the language names. * The keys are the language identifiers. * The values are the language names in US English. * * @return string[] */ public static function getLanguageNames() { return self::getData('languages'); } /** * Return a dictionary containing the territory names (in US English). * The keys are the territory identifiers. * The values are the territory names in US English. * * @return string[] */ public static function getTerritoryNames() { return self::getData('territories'); } /** * Return a dictionary containing the script names (in US English). * The keys are the script identifiers. * The values are the script names in US English. * * @param bool $standAlone set to true to retrieve the stand-alone script names, false otherwise * * @return string[] */ public static function getScriptNames($standAlone) { return self::getData($standAlone ? 'standAloneScripts' : 'scripts'); } /** * A dictionary containing the plural rules. * The keys are the language identifiers. * The values are arrays whose keys are the CLDR category names and the values are the CLDR category definition. * * @example The English key-value pair is somethink like this: * <code><pre> * "en": { * "pluralRule-count-one": "i = 1 and v = 0 @integer 1", * "pluralRule-count-other": " @integer 0, 2~16, 100, 1000, 10000, 100000, 1000000, â€¦ @decimal 0.0~1.5, 10.0, 100.0, 1000.0, 10000.0, 100000.0, 1000000.0, â€¦" * } * </pre></code> * * @return array */ public static function getPlurals() { return self::getData('plurals'); } /** * Return a list of superseded language codes. * * @return array keys are the former language codes, values are the new language/locale codes */ public static function getSupersededLanguages() { return self::getData('supersededLanguages'); } /** * Retrieve the name of a language, as well as if a language code is deprecated in favor of another language code. * * @param string $id the language identifier * * @return array|null Returns an array with the keys 'id' (normalized), 'name', 'supersededBy' (optional), 'territory' (optional), 'script' (optional), 'baseLanguage' (optional), 'categories'. If $id is not valid returns null. */ public static function getLanguageInfo($id) { $result = null; $matches = array(); if (preg_match('/^([a-z]{2,3})(?:[_\-]([a-z]{4}))?(?:[_\-]([a-z]{2}|[0-9]{3}))?(?:$|-)/i', $id, $matches)) { $languageId = strtolower($matches[1]); $scriptId = (isset($matches[2]) && ($matches[2] !== '')) ? ucfirst(strtolower($matches[2])) : null; $territoryId = (isset($matches[3]) && ($matches[3] !== '')) ? strtoupper($matches[3]) : null; $normalizedId = $languageId; if (isset($scriptId)) { $normalizedId .= '_' . $scriptId; } if (isset($territoryId)) { $normalizedId .= '_' . $territoryId; } // Structure precedence: see Likely Subtags - http://www.unicode.org/reports/tr35/tr35-31/tr35.html#Likely_Subtags $variants = array(); $variantsWithScript = array(); $variantsWithTerritory = array(); if (isset($scriptId) && isset($territoryId)) { $variantsWithTerritory[] = $variantsWithScript[] = $variants[] = "{$languageId}_{$scriptId}_{$territoryId}"; } if (isset($scriptId)) { $variantsWithScript[] = $variants[] = "{$languageId}_{$scriptId}"; } if (isset($territoryId)) { $variantsWithTerritory[] = $variants[] = "{$languageId}_{$territoryId}"; } $variants[] = $languageId; $allGood = true; $scriptName = null; $scriptStandAloneName = null; if (isset($scriptId)) { $scriptNames = self::getScriptNames(false); if (isset($scriptNames[$scriptId])) { $scriptName = $scriptNames[$scriptId]; $scriptStandAloneNames = self::getScriptNames(true); $scriptStandAloneName = $scriptStandAloneNames[$scriptId]; } else { $allGood = false; } } $territoryName = null; if (isset($territoryId)) { $territoryNames = self::getTerritoryNames(); if (isset($territoryNames[$territoryId])) { if ($territoryId !== '001') { $territoryName = $territoryNames[$territoryId]; } } else { $allGood = false; } } $languageName = null; $languageNames = self::getLanguageNames(); foreach ($variants as $variant) { if (isset($languageNames[$variant])) { $languageName = $languageNames[$variant]; if (isset($scriptName) && (!in_array($variant, $variantsWithScript))) { $languageName = $scriptName . ' ' . $languageName; } if (isset($territoryName) && (!in_array($variant, $variantsWithTerritory))) { $languageName .= ' (' . $territoryNames[$territoryId] . ')'; } break; } } if (!isset($languageName)) { $allGood = false; } $baseLanguage = null; if (isset($scriptId) || isset($territoryId)) { if (isset($languageNames[$languageId]) && ($languageNames[$languageId] !== $languageName)) { $baseLanguage = $languageNames[$languageId]; } } $plural = null; $plurals = self::getPlurals(); foreach ($variants as $variant) { if (isset($plurals[$variant])) { $plural = $plurals[$variant]; break; } } if (!isset($plural)) { $allGood = false; } $supersededBy = null; $supersededBys = self::getSupersededLanguages(); foreach ($variants as $variant) { if (isset($supersededBys[$variant])) { $supersededBy = $supersededBys[$variant]; break; } } if ($allGood) { $result = array(); $result['id'] = $normalizedId; $result['name'] = $languageName; if (isset($supersededBy)) { $result['supersededBy'] = $supersededBy; } if (isset($scriptStandAloneName)) { $result['script'] = $scriptStandAloneName; } if (isset($territoryName)) { $result['territory'] = $territoryName; } if (isset($baseLanguage)) { $result['baseLanguage'] = $baseLanguage; } $result['categories'] = $plural; } } return $result; } /** * Returns the loaded CLDR data. * * @param string $key Can be 'languages', 'territories', 'plurals', 'supersededLanguages', 'scripts', 'standAloneScripts' * * @return array */ private static function getData($key) { if (!isset(self::$data)) { $fixKeys = function ($list, &$standAlone = null) { $result = array(); $standAlone = array(); $match = null; foreach ($list as $key => $value) { $variant = ''; if (preg_match('/^(.+)-alt-(short|variant|stand-alone|long|menu)$/', $key, $match)) { $key = $match[1]; $variant = $match[2]; } $key = str_replace('-', '_', $key); switch ($key) { case 'root': // Language: Root case 'und': // Language: Unknown Language case 'zxx': // Language: No linguistic content case 'ZZ': // Territory: Unknown Region case 'Zinh': // Script: Inherited case 'Zmth': // Script: Mathematical Notation case 'Zsym': // Script: Symbols case 'Zxxx': // Script: Unwritten case 'Zyyy': // Script: Common case 'Zzzz': // Script: Unknown Script break; default: switch ($variant) { case 'stand-alone': $standAlone[$key] = $value; break; case '': $result[$key] = $value; break; } break; } } return $result; }; $data = array(); $json = json_decode(file_get_contents(__DIR__ . '/cldr-data/main/en-US/languages.json'), true); $data['languages'] = $fixKeys($json['main']['en-US']['localeDisplayNames']['languages']); $json = json_decode(file_get_contents(__DIR__ . '/cldr-data/main/en-US/territories.json'), true); $data['territories'] = $fixKeys($json['main']['en-US']['localeDisplayNames']['territories']); $json = json_decode(file_get_contents(__DIR__ . '/cldr-data/supplemental/plurals.json'), true); $data['plurals'] = $fixKeys($json['supplemental']['plurals-type-cardinal']); $json = json_decode(file_get_contents(__DIR__ . '/cldr-data/main/en-US/scripts.json'), true); $data['scripts'] = $fixKeys($json['main']['en-US']['localeDisplayNames']['scripts'], $data['standAloneScripts']); $data['standAloneScripts'] = array_merge($data['scripts'], $data['standAloneScripts']); $data['scripts'] = array_merge($data['standAloneScripts'], $data['scripts']); $data['supersededLanguages'] = array(); // Remove the languages for which we don't have plurals $m = null; foreach (array_keys(array_diff_key($data['languages'], $data['plurals'])) as $missingPlural) { if (preg_match('/^([a-z]{2,3})_/', $missingPlural, $m)) { if (!isset($data['plurals'][$m[1]])) { unset($data['languages'][$missingPlural]); } } else { unset($data['languages'][$missingPlural]); } } // Fix the languages for which we have plurals $formerCodes = array( 'jw' => 'jv', // former Javanese 'mo' => 'ro_MD', // former Moldavian ); $knownMissingLanguages = array( 'guw' => 'Gun', 'hnj' => 'Hmong Njua', 'lld' => 'Dolomitic Ladin', 'nah' => 'Nahuatl', 'smi' => 'Sami', ); foreach (array_keys(array_diff_key($data['plurals'], $data['languages'])) as $missingLanguage) { if (isset($formerCodes[$missingLanguage]) && isset($data['languages'][$formerCodes[$missingLanguage]])) { $data['languages'][$missingLanguage] = $data['languages'][$formerCodes[$missingLanguage]]; $data['supersededLanguages'][$missingLanguage] = $formerCodes[$missingLanguage]; } else { if (isset($knownMissingLanguages[$missingLanguage])) { $data['languages'][$missingLanguage] = $knownMissingLanguages[$missingLanguage]; } else { throw new Exception("We have the plural rule for the language '{$missingLanguage}' but we don't have its language name"); } } } ksort($data['languages'], SORT_STRING); ksort($data['territories'], SORT_STRING); ksort($data['plurals'], SORT_STRING); ksort($data['scripts'], SORT_STRING); ksort($data['standAloneScripts'], SORT_STRING); ksort($data['supersededLanguages'], SORT_STRING); self::$data = $data; } if (!isset(self::$data[$key])) { throw new Exception("Invalid CLDR data key: '{$key}'"); } return self::$data[$key]; } } <?php namespace Gettext\Languages; use Exception; /** * Main class to convert the plural rules of a language from CLDR to gettext. */ class Language { /** * The language ID. * * @var string */ public $id; /** * The language name. * * @var string */ public $name; /** * If this language is deprecated: the gettext code of the new language. * * @var string|null */ public $supersededBy; /** * The script name. * * @var string|null */ public $script; /** * The territory name. * * @var string|null */ public $territory; /** * The name of the base language. * * @var string|null */ public $baseLanguage; /** * The list of categories. * * @var \Gettext\Languages\Category[] */ public $categories; /** * The gettext formula to decide which category should be applied. * * @var string */ public $formula; /** * Initialize the instance and parse the language code. * * @param array $info The result of CldrData::getLanguageInfo() * * @throws \Exception throws an Exception if $fullId is not valid */ private function __construct($info) { $this->id = $info['id']; $this->name = $info['name']; $this->supersededBy = isset($info['supersededBy']) ? $info['supersededBy'] : null; $this->script = isset($info['script']) ? $info['script'] : null; $this->territory = isset($info['territory']) ? $info['territory'] : null; $this->baseLanguage = isset($info['baseLanguage']) ? $info['baseLanguage'] : null; // Let's build the category list $this->categories = array(); foreach ($info['categories'] as $cldrCategoryId => $cldrFormulaAndExamples) { $category = new Category($cldrCategoryId, $cldrFormulaAndExamples); foreach ($this->categories as $c) { if ($category->id === $c->id) { throw new Exception("The category '{$category->id}' is specified more than once"); } } $this->categories[] = $category; } if (empty($this->categories)) { throw new Exception("The language '{$info['id']}' does not have any plural category"); } // Let's sort the categories from 'zero' to 'other' usort($this->categories, function (Category $category1, Category $category2) { return array_search($category1->id, CldrData::$categories) - array_search($category2->id, CldrData::$categories); }); // The 'other' category should always be there if ($this->categories[count($this->categories) - 1]->id !== CldrData::OTHER_CATEGORY) { throw new Exception("The language '{$info['id']}' does not have the '" . CldrData::OTHER_CATEGORY . "' plural category"); } $this->checkAlwaysTrueCategories(); $this->checkAlwaysFalseCategories(); $this->checkAllCategoriesWithExamples(); $this->formula = $this->buildFormula(); } /** * Return a list of all languages available. * * @throws \Exception * * @return \Gettext\Languages\Language[] */ public static function getAll() { $result = array(); foreach (array_keys(CldrData::getLanguageNames()) as $cldrLanguageId) { $result[] = new self(CldrData::getLanguageInfo($cldrLanguageId)); } return $result; } /** * Return a Language instance given the language id. * * @param string $id * * @return \Gettext\Languages\Language|null */ public static function getById($id) { $result = null; $info = CldrData::getLanguageInfo($id); if (isset($info)) { $result = new self($info); } return $result; } /** * Returns a clone of this instance with all the strings to US-ASCII. * * @return \Gettext\Languages\Language */ public function getUSAsciiClone() { $clone = clone $this; self::asciifier($clone->name); self::asciifier($clone->formula); $clone->categories = array(); foreach ($this->categories as $category) { $categoryClone = clone $category; self::asciifier($categoryClone->examples); $clone->categories[] = $categoryClone; } return $clone; } /** * Build the formula starting from the currently defined categories. * * @param bool $withoutParenthesis TRUE to build a formula in standard gettext format, FALSE (default) to build a PHP-compatible formula * * @return string */ public function buildFormula($withoutParenthesis = false) { $numCategories = count($this->categories); switch ($numCategories) { case 1: // Just one category return '0'; case 2: return self::reduceFormula(self::reverseFormula($this->categories[0]->formula)); default: $formula = (string) ($numCategories - 1); for ($i = $numCategories - 2; $i >= 0; $i--) { $f = self::reduceFormula($this->categories[$i]->formula); if (!$withoutParenthesis && !preg_match('/^$[^()]+$$/', $f)) { $f = "({$f})"; } $formula = "{$f} ? {$i} : {$formula}"; if (!$withoutParenthesis && $i > 0) { $formula = "({$formula})"; } } return $formula; } } /** * Let's look for categories that will always occur. * This because with decimals (CLDR) we may have more cases, with integers (gettext) we have just one case. * If we found that (single) category we reduce the categories to that one only. * * @throws \Exception */ private function checkAlwaysTrueCategories() { $alwaysTrueCategory = null; foreach ($this->categories as $category) { if ($category->formula === true) { if (!isset($category->examples)) { throw new Exception("The category '{$category->id}' should always occur, but it does not have examples (so for CLDR it will never occur for integers!)"); } $alwaysTrueCategory = $category; break; } } if (isset($alwaysTrueCategory)) { foreach ($this->categories as $category) { if (($category !== $alwaysTrueCategory) && isset($category->examples)) { throw new Exception("The category '{$category->id}' should never occur, but it has some examples (so for CLDR it will occur!)"); } } $alwaysTrueCategory->id = CldrData::OTHER_CATEGORY; $alwaysTrueCategory->formula = null; $this->categories = array($alwaysTrueCategory); } } /** * Let's look for categories that will never occur. * This because with decimals (CLDR) we may have more cases, with integers (gettext) we have some less cases. * If we found those categories we strip them out. * * @throws \Exception */ private function checkAlwaysFalseCategories() { $filtered = array(); foreach ($this->categories as $category) { if ($category->formula === false) { if (isset($category->examples)) { throw new Exception("The category '{$category->id}' should never occur, but it has examples (so for CLDR it may occur!)"); } } else { $filtered[] = $category; } } $this->categories = $filtered; } /** * Let's look for categories that don't have examples. * This because with decimals (CLDR) we may have more cases, with integers (gettext) we have some less cases. * If we found those categories, we check that they never occur and we strip them out. * * @throws \Exception */ private function checkAllCategoriesWithExamples() { $allCategoriesIds = array(); $goodCategories = array(); $badCategories = array(); $badCategoriesIds = array(); foreach ($this->categories as $category) { $allCategoriesIds[] = $category->id; if (isset($category->examples)) { $goodCategories[] = $category; } else { $badCategories[] = $category; $badCategoriesIds[] = $category->id; } } if (empty($badCategories)) { return; } $removeCategoriesWithoutExamples = false; switch (implode(',', $badCategoriesIds) . '@' . implode(',', $allCategoriesIds)) { case CldrData::OTHER_CATEGORY . '@one,few,many,' . CldrData::OTHER_CATEGORY: switch ($this->buildFormula()) { case '(n % 10 == 1 && n % 100 != 11) ? 0 : ((n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14)) ? 1 : ((n % 10 == 0 || n % 10 >= 5 && n % 10 <= 9 || n % 100 >= 11 && n % 100 <= 14) ? 2 : 3))': // Numbers ending with 0 => case 2 ('many') // Numbers ending with 1 but not with 11 => case 0 ('one') // Numbers ending with 11 => case 2 ('many') // Numbers ending with 2 but not with 12 => case 1 ('few') // Numbers ending with 12 => case 2 ('many') // Numbers ending with 3 but not with 13 => case 1 ('few') // Numbers ending with 13 => case 2 ('many') // Numbers ending with 4 but not with 14 => case 1 ('few') // Numbers ending with 14 => case 2 ('many') // Numbers ending with 5 => case 2 ('many') // Numbers ending with 6 => case 2 ('many') // Numbers ending with 7 => case 2 ('many') // Numbers ending with 8 => case 2 ('many') // Numbers ending with 9 => case 2 ('many') // => the 'other' case never occurs: use 'other' for 'many' $removeCategoriesWithoutExamples = true; break; case '(n == 1) ? 0 : ((n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14)) ? 1 : ((n != 1 && (n % 10 == 0 || n % 10 == 1) || n % 10 >= 5 && n % 10 <= 9 || n % 100 >= 12 && n % 100 <= 14) ? 2 : 3))': // Numbers ending with 0 => case 2 ('many') // Numbers ending with 1 but not number 1 => case 2 ('many') // Number 1 => case 0 ('one') // Numbers ending with 2 but not with 12 => case 1 ('few') // Numbers ending with 12 => case 2 ('many') // Numbers ending with 3 but not with 13 => case 1 ('few') // Numbers ending with 13 => case 2 ('many') // Numbers ending with 4 but not with 14 => case 1 ('few') // Numbers ending with 14 => case 2 ('many') // Numbers ending with 5 => case 2 ('many') // Numbers ending with 6 => case 2 ('many') // Numbers ending with 7 => case 2 ('many') // Numbers ending with 8 => case 2 ('many') // Numbers ending with 9 => case 2 ('many') // => the 'other' case never occurs: use 'other' for 'many' $removeCategoriesWithoutExamples = true; break; } } if (!$removeCategoriesWithoutExamples) { throw new Exception("Unhandled case of plural categories without examples '" . implode(', ', $badCategoriesIds) . "' out of '" . implode(', ', $allCategoriesIds) . "'"); } if ($badCategories[count($badCategories) - 1]->id === CldrData::OTHER_CATEGORY) { // We're removing the 'other' cagory: let's change the last good category to 'other' $lastGood = $goodCategories[count($goodCategories) - 1]; $lastGood->id = CldrData::OTHER_CATEGORY; $lastGood->formula = null; } $this->categories = $goodCategories; } /** * Reverse a formula. * * @param string $formula * * @throws \Exception * * @return string */ private static function reverseFormula($formula) { if (preg_match('/^n( % \d+)? == \d+(\.\.\d+|,\d+)*?$/', $formula)) { return str_replace(' == ', ' != ', $formula); } if (preg_match('/^n( % \d+)? != \d+(\.\.\d+|,\d+)*?$/', $formula)) { return str_replace(' != ', ' == ', $formula); } if (preg_match('/^$?n == \d+ \|\| n == \d+$?$/', $formula)) { return trim(str_replace(array(' == ', ' || '), array(' != ', ' && '), $formula), '()'); } $m = null; if (preg_match('/^(n(?: % \d+)?) == (\d+) && (n(?: % \d+)?) != (\d+)$/', $formula, $m)) { return "{$m[1]} != {$m[2]} || {$m[3]} == {$m[4]}"; } switch ($formula) { case '(n == 1 || n == 2 || n == 3) || n % 10 != 4 && n % 10 != 6 && n % 10 != 9': return 'n != 1 && n != 2 && n != 3 && (n % 10 == 4 || n % 10 == 6 || n % 10 == 9)'; case '(n == 0 || n == 1) || n >= 11 && n <= 99': return 'n >= 2 && (n < 11 || n > 99)'; } throw new Exception("Unable to reverse the formula '{$formula}'"); } /** * Reduce some excessively complex formulas. * * @param string $formula * * @return string */ private static function reduceFormula($formula) { $map = array( 'n != 0 && n != 1' => 'n > 1', '(n == 0 || n == 1) && n != 0' => 'n == 1', ); return isset($map[$formula]) ? $map[$formula] : $formula; } /** * Take one variable and, if it's a string, we transliterate it to US-ASCII. * * @param mixed $value the variable to work on * * @throws \Exception */ private static function asciifier(&$value) { if (is_string($value) && $value !== '') { // Avoid converting from 'Å¸' to '"Y', let's prefer 'Y' $value = strtr($value, array( 'Ã€' => 'A', 'Ã' => 'A', 'Ã‚' => 'A', 'Ãƒ' => 'A', 'Ã„' => 'A', 'Ã…' => 'A', 'Ãˆ' => 'E', 'Ã‰' => 'E', 'ÃŠ' => 'E', 'Ã‹' => 'E', 'ÃŒ' => 'I', 'Ã' => 'I', 'ÃŽ' => 'I', 'Ã' => 'I', 'Ã‘' => 'N', 'Ã’' => 'O', 'Ã“' => 'O', 'Ã”' => 'O', 'Ã•' => 'O', 'Ã–' => 'O', 'Ã™' => 'U', 'Ãš' => 'U', 'Ã›' => 'U', 'Ãœ' => 'U', 'Å¸' => 'Y', 'Ã' => 'Y', 'Ã ' => 'a', 'Ã¡' => 'a', 'Ã¢' => 'a', 'Ã£' => 'a', 'Ã¤' => 'a', 'Ã¥' => 'a', 'Ã¨' => 'e', 'Ã©' => 'e', 'Ãª' => 'e', 'Ã«' => 'e', 'Ã¬' => 'i', 'Ã' => 'i', 'Ã®' => 'i', 'Ã¯' => 'i', 'Ã±' => 'n', 'Ã²' => 'o', 'Ã³' => 'o', 'Ã´' => 'o', 'Ãµ' => 'o', 'Ã¶' => 'o', 'Ã¹' => 'u', 'Ãº' => 'u', 'Ã»' => 'u', 'Ã¼' => 'u', 'Ã½' => 'y', 'Ã¿' => 'y', 'â€¦' => '...', 'Ê¼' => "'", 'â€™' => "'", )); } } } <?php namespace Gettext\Languages\Exporter; class Ruby extends Exporter { /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::getDescription() */ public static function getDescription() { return 'Build a Ruby hash'; } /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::toStringDoWithOptions() */ protected static function toStringDoWithOptions($languages, array $options) { $lines = array(); $lines[] = 'PLURAL_RULES = {'; foreach ($languages as $lc) { $lines[] = ' \'' . $lc->id . '\' => {'; $lines[] = ' \'name\' => \'' . addslashes($lc->name) . '\','; if (isset($lc->supersededBy)) { $lines[] = ' \'supersededBy\' => \'' . $lc->supersededBy . '\','; } if (isset($lc->script)) { $lines[] = ' \'script\' => \'' . addslashes($lc->script) . '\','; } if (isset($lc->territory)) { $lines[] = ' \'territory\' => \'' . addslashes($lc->territory) . '\','; } if (isset($lc->baseLanguage)) { $lines[] = ' \'baseLanguage\' => \'' . addslashes($lc->baseLanguage) . '\','; } $lines[] = ' \'formula\' => \'' . $lc->formula . '\','; $lines[] = ' \'plurals\' => ' . count($lc->categories) . ','; $catNames = array(); foreach ($lc->categories as $c) { $catNames[] = "'{$c->id}'"; } $lines[] = ' \'cases\' => [' . implode(', ', $catNames) . '],'; $lines[] = ' \'examples\' => {'; foreach ($lc->categories as $c) { $lines[] = ' \'' . $c->id . '\' => \'' . $c->examples . '\','; } $lines[] = ' },'; $lines[] = ' },'; } $lines[] = '}'; $lines[] = ''; return implode("\n", $lines); } } <?php namespace Gettext\Languages\Exporter; use Exception; class Po extends Exporter { /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::getDescription() */ public static function getDescription() { return 'Build a string to be used for gettext .po files'; } /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::toStringDoWithOptions() */ protected static function toStringDoWithOptions($languages, array $options) { if (count($languages) !== 1) { throw new Exception('The ' . get_called_class() . ' exporter can only export one language'); } $language = $languages[0]; $lines = array(); $lines[] = '"Language: ' . $language->id . '\n"'; $lines[] = '"Plural-Forms: nplurals=' . count($language->categories) . '; plural=' . $language->formula . '\n"'; $lines[] = ''; return implode("\n", $lines); } } <?php namespace Gettext\Languages\Exporter; class Json extends Exporter { /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::getDescription() */ public static function getDescription() { return 'Build a compressed JSON-encoded file'; } /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::supportsFormulasWithAndWithoutParenthesis() */ public static function supportsFormulasWithAndWithoutParenthesis() { return true; } /** * Return the options for json_encode. * * @return int */ protected static function getEncodeOptions() { $result = 0; if (defined('\JSON_UNESCAPED_SLASHES')) { $result |= \JSON_UNESCAPED_SLASHES; } if (defined('\JSON_UNESCAPED_UNICODE')) { $result |= \JSON_UNESCAPED_UNICODE; } return $result; } /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::toStringDoWithOptions() */ protected static function toStringDoWithOptions($languages, array $options) { $list = array(); foreach ($languages as $language) { $item = array(); $item['name'] = $language->name; if (isset($language->supersededBy)) { $item['supersededBy'] = $language->supersededBy; } if (isset($language->script)) { $item['script'] = $language->script; } if (isset($language->territory)) { $item['territory'] = $language->territory; } if (isset($language->baseLanguage)) { $item['baseLanguage'] = $language->baseLanguage; } if (!empty($options['both-formulas'])) { $item['formulas'] = array( 'standard' => $language->buildFormula(true), 'php' => $language->formula, ); } else { $item['formula'] = $language->formula; } $item['plurals'] = count($language->categories); $item['cases'] = array(); $item['examples'] = array(); foreach ($language->categories as $category) { $item['cases'][] = $category->id; $item['examples'][$category->id] = $category->examples; } $list[$language->id] = $item; } return json_encode($list, static::getEncodeOptions()); } } <?php namespace Gettext\Languages\Exporter; class Php extends Exporter { /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::getDescription() */ public static function getDescription() { return 'Build a PHP array'; } /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::toStringDoWithOptions() */ protected static function toStringDoWithOptions($languages, array $options) { $lines = array(); $lines[] = '<?php'; $lines[] = 'return array('; foreach ($languages as $lc) { $lines[] = ' \'' . $lc->id . '\' => array('; $lines[] = ' \'name\' => \'' . addslashes($lc->name) . '\','; if (isset($lc->supersededBy)) { $lines[] = ' \'supersededBy\' => \'' . $lc->supersededBy . '\','; } if (isset($lc->script)) { $lines[] = ' \'script\' => \'' . addslashes($lc->script) . '\','; } if (isset($lc->territory)) { $lines[] = ' \'territory\' => \'' . addslashes($lc->territory) . '\','; } if (isset($lc->baseLanguage)) { $lines[] = ' \'baseLanguage\' => \'' . addslashes($lc->baseLanguage) . '\','; } $lines[] = ' \'formula\' => \'' . $lc->formula . '\','; $lines[] = ' \'plurals\' => ' . count($lc->categories) . ','; $catNames = array(); foreach ($lc->categories as $c) { $catNames[] = "'{$c->id}'"; } $lines[] = ' \'cases\' => array(' . implode(', ', $catNames) . '),'; $lines[] = ' \'examples\' => array('; foreach ($lc->categories as $c) { $lines[] = ' \'' . $c->id . '\' => \'' . $c->examples . '\','; } $lines[] = ' ),'; $lines[] = ' ),'; } $lines[] = ');'; $lines[] = ''; return implode("\n", $lines); } } <?php namespace Gettext\Languages\Exporter; use Exception; class Prettyjson extends Json { /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::getDescription() */ public static function getDescription() { return 'Build an uncompressed JSON-encoded file (PHP 5.4 or later is needed)'; } /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Json::getEncodeOptions() */ protected static function getEncodeOptions() { if (!(defined('\JSON_PRETTY_PRINT') && defined('\JSON_UNESCAPED_SLASHES') && defined('\JSON_UNESCAPED_UNICODE'))) { throw new Exception('PHP 5.4 or later is required to export uncompressed JSON'); } return \JSON_PRETTY_PRINT | \JSON_UNESCAPED_SLASHES | \JSON_UNESCAPED_UNICODE; } } <?php namespace Gettext\Languages\Exporter; class Xml extends Exporter { /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::getDescription() */ public static function getDescription() { return 'Build an XML file - schema available at https://php-gettext.github.io/Languages/GettextLanguages.xsd'; } /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::toStringDoWithOptions() */ protected static function toStringDoWithOptions($languages, array $options) { $xml = new \DOMDocument('1.0', 'UTF-8'); $xml->loadXML('<languages xmlns="https://github.com/mlocati/cldr-to-gettext-plural-rules" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://github.com/mlocati/cldr-to-gettext-plural-rules https://php-gettext.github.io/Languages/GettextLanguages.xsd" />'); $xLanguages = $xml->firstChild; foreach ($languages as $language) { $xLanguage = $xml->createElement('language'); $xLanguage->setAttribute('id', $language->id); $xLanguage->setAttribute('name', $language->name); if (isset($language->supersededBy)) { $xLanguage->setAttribute('supersededBy', $language->supersededBy); } if (isset($language->script)) { $xLanguage->setAttribute('script', $language->script); } if (isset($language->territory)) { $xLanguage->setAttribute('territory', $language->territory); } if (isset($language->baseLanguage)) { $xLanguage->setAttribute('baseLanguage', $language->baseLanguage); } $xLanguage->setAttribute('formula', $language->formula); foreach ($language->categories as $category) { $xCategory = $xml->createElement('category'); $xCategory->setAttribute('id', $category->id); $xCategory->setAttribute('examples', $category->examples); $xLanguage->appendChild($xCategory); } $xLanguages->appendChild($xLanguage); } $xml->formatOutput = true; return $xml->saveXML(); } } <?php namespace Gettext\Languages\Exporter; class Html extends Exporter { /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::getDescription() */ public static function getDescription() { return 'Build a HTML table'; } /** * {@inheritdoc} * * @see \Gettext\Languages\Exporter\Exporter::toStringDoWithOptions() */ protected static function toStringDoWithOptions($languages, array $options) { $lines = array(); $lines[] = '<table>'; $lines[] = ' <thead>'; $lines[] = ' <tr>'; $lines[] = ' <th>Language code</th>'; $lines[] = ' <th>Language name</th>'; $lines[] = ' <th># plurals</th>'; $lines[] = ' <th>Formula</th>'; $lines[] = ' <th>Plurals</th>'; $lines[] = ' </tr>'; $lines[] = ' </thead>'; $lines[] = ' <tbody>'; foreach ($languages as $lc) { $lines[] = ' <tr>'; $lines[] = ' <td>' . $lc->id . '</td>'; $name = self::h($lc->name); if (isset($lc->supersededBy)) { $name .= '<br /><small><span>Superseded by</span> ' . $lc->supersededBy . '</small>'; } $lines[] = ' <td>' . $name . '</td>'; $lines[] = ' <td>' . count($lc->categories) . '</td>'; $lines[] = ' <td>' . self::h($lc->formula) . '</td>'; $cases = array(); foreach ($lc->categories as $c) { $cases[] = '<li><span>' . $c->id . '</span><code>' . self::h($c->examples) . '</code></li>'; } $lines[] = ' <td><ol start="0">' . implode('', $cases) . '</ol></td>'; $lines[] = ' </tr>'; } $lines[] = ' </tbody>'; $lines[] = '</table>'; return implode("\n", $lines); } protected static function h($str) { return htmlspecialchars($str, ENT_COMPAT, 'UTF-8'); } } <?php namespace Gettext\Languages\Exporter; use Exception; /** * Base class for all the exporters. */ abstract class Exporter { /** * @var array */ private static $exporters; /** * Return the list of all the available exporters. Keys are the exporter handles, values are the exporter class names. * * @param bool $onlyForPublicUse if true, internal exporters will be omitted * * @return string[] */ final public static function getExporters($onlyForPublicUse = false) { if (!isset(self::$exporters)) { $exporters = array(); $m = null; foreach (scandir(__DIR__) as $f) { if (preg_match('/^(\w+)\.php$/', $f, $m)) { if ($f !== basename(__FILE__)) { $exporters[strtolower($m[1])] = $m[1]; } } } self::$exporters = $exporters; } if ($onlyForPublicUse) { $result = array(); foreach (self::$exporters as $handle => $class) { if (call_user_func(self::getExporterClassName($handle) . '::isForPublicUse') === true) { $result[$handle] = $class; } } } else { $result = self::$exporters; } return $result; } /** * Return the description of a specific exporter. * * @param string $exporterHandle the handle of the exporter * * @throws \Exception throws an Exception if $exporterHandle is not valid * * @return string */ final public static function getExporterDescription($exporterHandle) { $exporters = self::getExporters(); if (!isset($exporters[$exporterHandle])) { throw new Exception("Invalid exporter handle: '{$exporterHandle}'"); } return call_user_func(self::getExporterClassName($exporterHandle) . '::getDescription'); } /** * Returns the fully qualified class name of a exporter given its handle. * * @param string $exporterHandle the exporter class handle * * @return string */ final public static function getExporterClassName($exporterHandle) { return __NAMESPACE__ . '\\' . ucfirst(strtolower($exporterHandle)); } /** * Convert a list of Language instances to string. * * @param \Gettext\Languages\Language[] $languages the Language instances to convert * @param array|null $options * * @return string */ final public static function toString($languages, $options = null) { if (!isset($options) || !is_array($options)) { $options = array(); } if (isset($options['us-ascii']) && $options['us-ascii']) { $asciiList = array(); foreach ($languages as $language) { $asciiList[] = $language->getUSAsciiClone(); } $languages = $asciiList; } return static::toStringDoWithOptions($languages, $options); } /** * Save the Language instances to a file. * * @param \Gettext\Languages\Language[] $languages the Language instances to convert * @param array|null $options * * @throws \Exception */ final public static function toFile($languages, $filename, $options = null) { $data = self::toString($languages, $options); if (@file_put_contents($filename, $data) === false) { throw new Exception("Error writing data to '{$filename}'"); } } /** * Is this exporter for public use? * * @return bool */ public static function isForPublicUse() { return true; } /** * Does this exporter supports exporting formulas both with and without extra parenthesis? * * @return bool */ public static function supportsFormulasWithAndWithoutParenthesis() { return false; } /** * Return a short description of the exporter. * * @return string */ public static function getDescription() { throw new Exception(get_called_class() . ' does not implement the method ' . __FUNCTION__); } /** * Convert a list of Language instances to string. * * @param \Gettext\Languages\Language[] $languages the Language instances to convert * @param array $options export options * * @return string */ protected static function toStringDoWithOptions($languages, array $options) { if (method_exists(get_called_class(), 'toStringDo')) { return static::toStringDo($languages); } throw new Exception(get_called_class() . ' does not implement the method ' . __FUNCTION__); } } <?php namespace Gettext\Languages; use Exception; /** * A helper class that handles a single category rules (eg 'zero', 'one', ...) and its formula and examples. */ class Category { /** * The category identifier (eg 'zero', 'one', ..., 'other'). * * @var string */ public $id; /** * The gettext formula that identifies this category (null if and only if the category is 'other'). * * @var string|null */ public $formula; /** * The CLDR representation of some exemplar numeric ranges that satisfy this category. * * @var string|null */ public $examples; /** * Initialize the instance and parse the formula. * * @param string $cldrCategoryId the CLDR category identifier (eg 'pluralRule-count-one') * @param string $cldrFormulaAndExamples the CLDR formula and examples (eg 'i = 1 and v = 0 @integer 1') * * @throws \Exception */ public function __construct($cldrCategoryId, $cldrFormulaAndExamples) { $matches = array(); if (!preg_match('/^pluralRule-count-(.+)$/', $cldrCategoryId, $matches)) { throw new Exception("Invalid CLDR category: '{$cldrCategoryId}'"); } if (!in_array($matches[1], CldrData::$categories)) { throw new Exception("Invalid CLDR category: '{$cldrCategoryId}'"); } $this->id = $matches[1]; $cldrFormulaAndExamplesNormalized = trim(preg_replace('/\s+/', ' ', $cldrFormulaAndExamples)); if (!preg_match('/^([^@]*)(?:@integer([^@]+))?(?:@decimal(?:[^@]+))?$/', $cldrFormulaAndExamplesNormalized, $matches)) { throw new Exception("Invalid CLDR category rule: {$cldrFormulaAndExamples}"); } $cldrFormula = trim($matches[1]); $s = isset($matches[2]) ? trim($matches[2]) : ''; $this->examples = ($s === '') ? null : $s; switch ($this->id) { case CldrData::OTHER_CATEGORY: if ($cldrFormula !== '') { throw new Exception("The '" . CldrData::OTHER_CATEGORY . "' category should not have any formula, but it has '{$cldrFormula}'"); } $this->formula = null; break; default: if ($cldrFormula === '') { throw new Exception("The '{$this->id}' category does not have a formula"); } $this->formula = FormulaConverter::convertFormula($cldrFormula); break; } } /** * Return a list of numbers corresponding to the $examples value. * * @throws \Exception throws an Exception if we weren't able to expand the examples * * @return int[] */ public function getExampleIntegers() { return self::expandExamples($this->examples); } /** * Expand a list of examples as defined by CLDR. * * @param string $examples A string like '1, 2, 5...7, â€¦'. * * @throws \Exception throws an Exception if we weren't able to expand $examples * * @return int[] */ public static function expandExamples($examples) { $result = array(); $m = null; if (substr($examples, -strlen(', â€¦')) === ', â€¦') { $examples = substr($examples, 0, strlen($examples) - strlen(', â€¦')); } foreach (explode(',', str_replace(' ', '', $examples)) as $range) { if (preg_match('/^(?<num>\d+)((c|e)(?<exp>\d+))?$/', $range, $m)) { $result[] = (int) (isset($m['exp']) ? ($m['num'] . str_repeat('0', (int) $m['exp'])) : $range); } elseif (preg_match('/^(\d+)~(\d+)$/', $range, $m)) { $from = (int) $m[1]; $to = (int) $m[2]; $delta = $to - $from; $step = (int) max(1, $delta / 100); for ($i = $from; $i < $to; $i += $step) { $result[] = $i; } $result[] = $to; } else { throw new Exception("Unhandled test range '{$range}' in '{$examples}'"); } } if (empty($result)) { throw new Exception("No test numbers from '{$examples}'"); } return $result; } } <?php namespace Gettext\Languages; use Exception; /** * A helper class to convert a CLDR formula to a gettext formula. */ class FormulaConverter { /** * Converts a formula from the CLDR representation to the gettext representation. * * @param string $cldrFormula the CLDR formula to convert * * @throws \Exception * * @return bool|string returns true if the gettext will always evaluate to true, false if gettext will always evaluate to false, return the gettext formula otherwise */ public static function convertFormula($cldrFormula) { if (strpbrk($cldrFormula, '()') !== false) { throw new Exception("Unable to convert the formula '{$cldrFormula}': parenthesis handling not implemented"); } $orSeparatedChunks = array(); foreach (explode(' or ', $cldrFormula) as $cldrFormulaChunk) { $gettextFormulaChunk = null; $andSeparatedChunks = array(); foreach (explode(' and ', $cldrFormulaChunk) as $cldrAtom) { $gettextAtom = self::convertAtom($cldrAtom); if ($gettextAtom === false) { // One atom joined by 'and' always evaluates to false => the whole 'and' group is always false $gettextFormulaChunk = false; break; } if ($gettextAtom !== true) { $andSeparatedChunks[] = $gettextAtom; } } if (!isset($gettextFormulaChunk)) { if (empty($andSeparatedChunks)) { // All the atoms joined by 'and' always evaluate to true => the whole 'and' group is always true $gettextFormulaChunk = true; } else { $gettextFormulaChunk = implode(' && ', $andSeparatedChunks); // Special cases simplification switch ($gettextFormulaChunk) { case 'n >= 0 && n <= 2 && n != 2': $gettextFormulaChunk = 'n == 0 || n == 1'; break; } } } if ($gettextFormulaChunk === true) { // One part of the formula joined with the others by 'or' always evaluates to true => the whole formula always evaluates to true return true; } if ($gettextFormulaChunk !== false) { $orSeparatedChunks[] = $gettextFormulaChunk; } } if (empty($orSeparatedChunks)) { // All the parts joined by 'or' always evaluate to false => the whole formula always evaluates to false return false; } return implode(' || ', $orSeparatedChunks); } /** * Converts an atomic part of the CLDR formula to its gettext representation. * * @param string $cldrAtom the CLDR formula atom to convert * * @throws \Exception * * @return bool|string returns true if the gettext will always evaluate to true, false if gettext will always evaluate to false, return the gettext formula otherwise */ private static function convertAtom($cldrAtom) { $m = null; $gettextAtom = $cldrAtom; $gettextAtom = str_replace(' = ', ' == ', $gettextAtom); $gettextAtom = str_replace('i', 'n', $gettextAtom); if (preg_match('/^n( % \d+)? (!=|==) \d+$/', $gettextAtom)) { return $gettextAtom; } if (preg_match('/^n( % \d+)? (!=|==) \d+(,\d+|\.\.\d+)+$/', $gettextAtom)) { return self::expandAtom($gettextAtom); } if (preg_match('/^(?:v|w)(?: % 10+)? == (\d+)(?:\.\.\d+)?$/', $gettextAtom, $m)) { // For gettext: v == 0, w == 0 return (int) $m[1] === 0 ? true : false; } if (preg_match('/^(?:v|w)(?: % 10+)? != (\d+)(?:\.\.\d+)?$/', $gettextAtom, $m)) { // For gettext: v == 0, w == 0 return (int) $m[1] === 0 ? false : true; } if (preg_match('/^(?:f|t|c|e)(?: % 10+)? == (\d+)(?:\.\.\d+)?$/', $gettextAtom, $m)) { // f == empty, t == empty, c == empty, e == empty return (int) $m[1] === 0 ? true : false; } if (preg_match('/^(?:f|t|c|e)(?: % 10+)? != (\d+)(?:\.\.\d+)?$/', $gettextAtom, $m)) { // f == empty, t == empty, c == empty, e == empty return (int) $m[1] === 0 ? false : true; } throw new Exception("Unable to convert the formula chunk '{$cldrAtom}' from CLDR to gettext"); } /** * Expands an atom containing a range (for instance: 'n == 1,3..5'). * * @param string $atom * * @throws \Exception * * @return string */ private static function expandAtom($atom) { $m = null; if (preg_match('/^(n(?: % \d+)?) (==|!=) (\d+(?:\.\.\d+|,\d+)+)$/', $atom, $m)) { $what = $m[1]; $op = $m[2]; $chunks = array(); foreach (explode(',', $m[3]) as $range) { $chunk = null; if ((!isset($chunk)) && preg_match('/^\d+$/', $range)) { $chunk = "{$what} {$op} {$range}"; } if ((!isset($chunk)) && preg_match('/^(\d+)\.\.(\d+)$/', $range, $m)) { $from = (int) $m[1]; $to = (int) $m[2]; if (($to - $from) === 1) { switch ($op) { case '==': $chunk = "({$what} == {$from} || {$what} == {$to})"; break; case '!=': $chunk = "{$what} != {$from} && {$what} == {$to}"; break; } } else { switch ($op) { case '==': $chunk = "{$what} >= {$from} && {$what} <= {$to}"; break; case '!=': if ($what === 'n' && $from <= 0) { $chunk = "{$what} > {$to}"; } else { $chunk = "({$what} < {$from} || {$what} > {$to})"; } break; } } } if (!isset($chunk)) { throw new Exception("Unhandled range '{$range}' in '{$atom}'"); } $chunks[] = $chunk; } if (count($chunks) === 1) { return $chunks[0]; } switch ($op) { case '==': return '(' . implode(' || ', $chunks) . ')'; case '!=': return implode(' && ', $chunks); } } throw new Exception("Unable to expand '{$atom}'"); } } <?php spl_autoload_register( function ($class) { if (strpos($class, 'Gettext\\Languages\\') !== 0) { return; } $file = __DIR__ . str_replace('\\', DIRECTORY_SEPARATOR, substr($class, strlen('Gettext\\Languages'))) . '.php'; if (is_file($file)) { require_once $file; } } ); <?php use Gettext\BaseTranslator; /** * Returns the translation of a string. * * @param string $original * * @return string */ function __($original) { $text = BaseTranslator::$current->gettext($original); if (func_num_args() === 1) { return $text; } $args = array_slice(func_get_args(), 1); return is_array($args[0]) ? strtr($text, $args[0]) : vsprintf($text, $args); } /** * Noop, marks the string for translation but returns it unchanged. * * @param string $original * * @return string */ function noop__($original) { return $original; } /** * Returns the singular/plural translation of a string. * * @param string $original * @param string $plural * @param string $value * * @return string */ function n__($original, $plural, $value) { $text = BaseTranslator::$current->ngettext($original, $plural, $value); if (func_num_args() === 3) { return $text; } $args = array_slice(func_get_args(), 3); return is_array($args[0]) ? strtr($text, $args[0]) : vsprintf($text, $args); } /** * Returns the translation of a string in a specific context. * * @param string $context * @param string $original * * @return string */ function p__($context, $original) { $text = BaseTranslator::$current->pgettext($context, $original); if (func_num_args() === 2) { return $text; } $args = array_slice(func_get_args(), 2); return is_array($args[0]) ? strtr($text, $args[0]) : vsprintf($text, $args); } /** * Returns the translation of a string in a specific domain. * * @param string $domain * @param string $original * * @return string */ function d__($domain, $original) { $text = BaseTranslator::$current->dgettext($domain, $original); if (func_num_args() === 2) { return $text; } $args = array_slice(func_get_args(), 2); return is_array($args[0]) ? strtr($text, $args[0]) : vsprintf($text, $args); } /** * Returns the translation of a string in a specific domain and context. * * @param string $domain * @param string $context * @param string $original * * @return string */ function dp__($domain, $context, $original) { $text = BaseTranslator::$current->dpgettext($domain, $context, $original); if (func_num_args() === 3) { return $text; } $args = array_slice(func_get_args(), 3); return is_array($args[0]) ? strtr($text, $args[0]) : vsprintf($text, $args); } /** * Returns the singular/plural translation of a string in a specific domain. * * @param string $domain * @param string $original * @param string $plural * @param string $value * * @return string */ function dn__($domain, $original, $plural, $value) { $text = BaseTranslator::$current->dngettext($domain, $original, $plural, $value); if (func_num_args() === 4) { return $text; } $args = array_slice(func_get_args(), 4); return is_array($args[0]) ? strtr($text, $args[0]) : vsprintf($text, $args); } /** * Returns the singular/plural translation of a string in a specific context. * * @param string $context * @param string $original * @param string $plural * @param string $value * * @return string */ function np__($context, $original, $plural, $value) { $text = BaseTranslator::$current->npgettext($context, $original, $plural, $value); if (func_num_args() === 4) { return $text; } $args = array_slice(func_get_args(), 4); return is_array($args[0]) ? strtr($text, $args[0]) : vsprintf($text, $args); } /** * Returns the singular/plural translation of a string in a specific domain and context. * * @param string $domain * @param string $context * @param string $original * @param string $plural * @param string $value * * @return string */ function dnp__($domain, $context, $original, $plural, $value) { $text = BaseTranslator::$current->dnpgettext($domain, $context, $original, $plural, $value); if (func_num_args() === 5) { return $text; } $args = array_slice(func_get_args(), 5); return is_array($args[0]) ? strtr($text, $args[0]) : vsprintf($text, $args); } <?php namespace Gettext\Generators; use Gettext\Translations; class Po extends Generator implements GeneratorInterface { public static $options = [ 'noLocation' => false, ]; /** * {@parentDoc}. */ public static function toString(Translations $translations, array $options = []) { $options += static::$options; $pluralForm = $translations->getPluralForms(); $pluralSize = is_array($pluralForm) ? ($pluralForm[0] - 1) : null; $lines = ['msgid ""', 'msgstr ""']; foreach ($translations->getHeaders() as $name => $value) { $lines[] = sprintf('"%s: %s\\n"', $name, $value); } $lines[] = ''; //Translations foreach ($translations as $translation) { if ($translation->hasComments()) { foreach ($translation->getComments() as $comment) { $lines[] = '# '.$comment; } } if ($translation->hasExtractedComments()) { foreach ($translation->getExtractedComments() as $comment) { $lines[] = '#. '.$comment; } } if (!$options['noLocation'] && $translation->hasReferences()) { foreach ($translation->getReferences() as $reference) { $lines[] = '#: '.$reference[0].(!is_null($reference[1]) ? ':'.$reference[1] : null); } } if ($translation->hasFlags()) { $lines[] = '#, '.implode(',', $translation->getFlags()); } $prefix = $translation->isDisabled() ? '#~ ' : ''; if ($translation->hasContext()) { $lines[] = $prefix.'msgctxt '.static::convertString($translation->getContext()); } static::addLines($lines, $prefix.'msgid', $translation->getOriginal()); if ($translation->hasPlural()) { static::addLines($lines, $prefix.'msgid_plural', $translation->getPlural()); static::addLines($lines, $prefix.'msgstr[0]', $translation->getTranslation()); foreach ($translation->getPluralTranslations($pluralSize) as $k => $v) { static::addLines($lines, $prefix.'msgstr['.($k + 1).']', $v); } } else { static::addLines($lines, $prefix.'msgstr', $translation->getTranslation()); } $lines[] = ''; } return implode("\n", $lines); } /** * Escapes and adds double quotes to a string. * * @param string $string * * @return string */ protected static function multilineQuote($string) { $lines = explode("\n", $string); $last = count($lines) - 1; foreach ($lines as $k => $line) { if ($k === $last) { $lines[$k] = static::convertString($line); } else { $lines[$k] = static::convertString($line."\n"); } } return $lines; } /** * Add one or more lines depending whether the string is multiline or not. * * @param array &$lines * @param string $name * @param string $value */ protected static function addLines(array &$lines, $name, $value) { $newLines = static::multilineQuote($value); if (count($newLines) === 1) { $lines[] = $name.' '.$newLines[0]; } else { $lines[] = $name.' ""'; foreach ($newLines as $line) { $lines[] = $line; } } } /** * Convert a string to its PO representation. * * @param string $value * * @return string */ public static function convertString($value) { return '"'.strtr( $value, [ "\x00" => '', '\\' => '\\\\', "\t" => '\t', "\r" => '\r', "\n" => '\n', '"' => '\\"', ] ).'"'; } } <?php namespace Gettext\Generators; use Gettext\Translations; use Gettext\Utils\HeadersGeneratorTrait; class Mo extends Generator implements GeneratorInterface { use HeadersGeneratorTrait; public static $options = [ 'includeHeaders' => true, ]; /** * {@parentDoc}. */ public static function toString(Translations $translations, array $options = []) { $options += static::$options; $messages = []; if ($options['includeHeaders']) { $messages[''] = static::generateHeaders($translations); } foreach ($translations as $translation) { if (!$translation->hasTranslation() || $translation->isDisabled()) { continue; } if ($translation->hasContext()) { $originalString = $translation->getContext()."\x04".$translation->getOriginal(); } else { $originalString = $translation->getOriginal(); } $messages[$originalString] = $translation; } ksort($messages); $numEntries = count($messages); $originalsTable = ''; $translationsTable = ''; $originalsIndex = []; $translationsIndex = []; $pluralForm = $translations->getPluralForms(); $pluralSize = is_array($pluralForm) ? ($pluralForm[0] - 1) : null; foreach ($messages as $originalString => $translation) { if (is_string($translation)) { // Headers $translationString = $translation; } else { /* @var $translation \Gettext\Translation */ if ($translation->hasPlural() && $translation->hasPluralTranslations(true)) { $originalString .= "\x00".$translation->getPlural(); $translationString = $translation->getTranslation(); $translationString .= "\x00".implode("\x00", $translation->getPluralTranslations($pluralSize)); } else { $translationString = $translation->getTranslation(); } } $originalsIndex[] = [ 'relativeOffset' => strlen($originalsTable), 'length' => strlen($originalString) ]; $originalsTable .= $originalString."\x00"; $translationsIndex[] = [ 'relativeOffset' => strlen($translationsTable), 'length' => strlen($translationString) ]; $translationsTable .= $translationString."\x00"; } // Offset of table with the original strings index: right after the header (which is 7 words) $originalsIndexOffset = 7 * 4; // Size of table with the original strings index $originalsIndexSize = $numEntries * (4 + 4); // Offset of table with the translation strings index: right after the original strings index table $translationsIndexOffset = $originalsIndexOffset + $originalsIndexSize; // Size of table with the translation strings index $translationsIndexSize = $numEntries * (4 + 4); // Hashing table starts after the header and after the index table $originalsStringsOffset = $translationsIndexOffset + $translationsIndexSize; // Translations start after the keys $translationsStringsOffset = $originalsStringsOffset + strlen($originalsTable); // Let's generate the .mo file binary data $mo = ''; // Magic number $mo .= pack('L', 0x950412de); // File format revision $mo .= pack('L', 0); // Number of strings $mo .= pack('L', $numEntries); // Offset of table with original strings $mo .= pack('L', $originalsIndexOffset); // Offset of table with translation strings $mo .= pack('L', $translationsIndexOffset); // Size of hashing table: we don't use it. $mo .= pack('L', 0); // Offset of hashing table: it would start right after the translations index table $mo .= pack('L', $translationsIndexOffset + $translationsIndexSize); // Write the lengths & offsets of the original strings foreach ($originalsIndex as $info) { $mo .= pack('L', $info['length']); $mo .= pack('L', $originalsStringsOffset + $info['relativeOffset']); } // Write the lengths & offsets of the translated strings foreach ($translationsIndex as $info) { $mo .= pack('L', $info['length']); $mo .= pack('L', $translationsStringsOffset + $info['relativeOffset']); } // Write original strings $mo .= $originalsTable; // Write translation strings $mo .= $translationsTable; return $mo; } } <?php namespace Gettext\Generators; use Gettext\Translations; class Jed extends Generator implements GeneratorInterface { public static $options = [ 'json' => 0, ]; /** * {@parentDoc}. */ public static function toString(Translations $translations, array $options = []) { $domain = $translations->getDomain() ?: 'messages'; $options += static::$options; return json_encode([ $domain => [ '' => [ 'domain' => $domain, 'lang' => $translations->getLanguage() ?: 'en', 'plural-forms' => $translations->getHeader('Plural-Forms') ?: 'nplurals=2; plural=(n != 1);', ], ] + static::buildMessages($translations), ], $options['json']); } /** * Generates an array with all translations. * * @param Translations $translations * * @return array */ protected static function buildMessages(Translations $translations) { $pluralForm = $translations->getPluralForms(); $pluralSize = is_array($pluralForm) ? ($pluralForm[0] - 1) : null; $messages = []; $context_glue = '\u0004'; foreach ($translations as $translation) { if ($translation->isDisabled()) { continue; } $key = ($translation->hasContext() ? $translation->getContext().$context_glue : '') .$translation->getOriginal(); if ($translation->hasPluralTranslations(true)) { $message = $translation->getPluralTranslations($pluralSize); array_unshift($message, $translation->getTranslation()); } else { $message = [$translation->getTranslation()]; } $messages[$key] = $message; } return $messages; } } <?php namespace Gettext\Generators; use Gettext\Translations; use Gettext\Utils\MultidimensionalArrayTrait; class Json extends Generator implements GeneratorInterface { use MultidimensionalArrayTrait; public static $options = [ 'json' => 0, 'includeHeaders' => false, ]; /** * {@inheritdoc} */ public static function toString(Translations $translations, array $options = []) { $options += static::$options; return json_encode(static::toArray($translations, $options['includeHeaders'], true), $options['json']); } } <?php namespace Gettext\Generators; use Gettext\Translations; use Gettext\Utils\HeadersGeneratorTrait; use Gettext\Utils\CsvTrait; /** * Class to export translations to csv. */ class Csv extends Generator implements GeneratorInterface { use HeadersGeneratorTrait; use CsvTrait; public static $options = [ 'includeHeaders' => false, 'delimiter' => ",", 'enclosure' => '"', 'escape_char' => "\\" ]; /** * {@parentDoc}. */ public static function toString(Translations $translations, array $options = []) { $options += static::$options; $handle = fopen('php://memory', 'w'); if ($options['includeHeaders']) { static::fputcsv($handle, ['', '', static::generateHeaders($translations)], $options); } foreach ($translations as $translation) { if ($translation->isDisabled()) { continue; } $line = [$translation->getContext(), $translation->getOriginal(), $translation->getTranslation()]; if ($translation->hasPluralTranslations(true)) { $line = array_merge($line, $translation->getPluralTranslations()); } static::fputcsv($handle, $line, $options); } rewind($handle); $csv = stream_get_contents($handle); fclose($handle); return $csv; } } <?php namespace Gettext\Generators; use Gettext\Translations; use Gettext\Utils\MultidimensionalArrayTrait; use Symfony\Component\Yaml\Yaml as YamlDumper; class Yaml extends Generator implements GeneratorInterface { use MultidimensionalArrayTrait; public static $options = [ 'includeHeaders' => false, 'indent' => 2, 'inline' => 4, ]; /** * {@inheritdoc} */ public static function toString(Translations $translations, array $options = []) { $options += static::$options; return YamlDumper::dump( static::toArray($translations, $options['includeHeaders']), $options['inline'], $options['indent'] ); } } <?php namespace Gettext\Generators; use Gettext\Translation; use Gettext\Translations; use DOMDocument; class Xliff extends Generator implements GeneratorInterface { const UNIT_ID_REGEXP = '/^XLIFF_UNIT_ID: (.*)$/'; /** * {@inheritdoc} */ public static function toString(Translations $translations, array $options = []) { $dom = new DOMDocument('1.0', 'utf-8'); $dom->formatOutput = true; $xliff = $dom->appendChild($dom->createElement('xliff')); $xliff->setAttribute('xmlns', 'urn:oasis:names:tc:xliff:document:2.0'); $xliff->setAttribute('version', '2.0'); $xliff->setAttribute('srcLang', $translations->getLanguage()); $xliff->setAttribute('trgLang', $translations->getLanguage()); $file = $xliff->appendChild($dom->createElement('file')); $file->setAttribute('id', $translations->getDomain().'.'.$translations->getLanguage()); //Save headers as notes $notes = $dom->createElement('notes'); foreach ($translations->getHeaders() as $name => $value) { $notes->appendChild(static::createTextNode($dom, 'note', $value))->setAttribute('id', $name); } if ($notes->hasChildNodes()) { $file->appendChild($notes); } foreach ($translations as $translation) { //Find an XLIFF unit ID, if one is available; otherwise generate $unitId = static::getUnitID($translation)?:md5($translation->getContext().$translation->getOriginal()); $unit = $dom->createElement('unit'); $unit->setAttribute('id', $unitId); //Save comments as notes $notes = $dom->createElement('notes'); $notes->appendChild(static::createTextNode($dom, 'note', $translation->getContext())) ->setAttribute('category', 'context'); foreach ($translation->getComments() as $comment) { //Skip XLIFF unit ID comments. if (preg_match(static::UNIT_ID_REGEXP, $comment)) { continue; } $notes->appendChild(static::createTextNode($dom, 'note', $comment)) ->setAttribute('category', 'comment'); } foreach ($translation->getExtractedComments() as $comment) { $notes->appendChild(static::createTextNode($dom, 'note', $comment)) ->setAttribute('category', 'extracted-comment'); } foreach ($translation->getFlags() as $flag) { $notes->appendChild(static::createTextNode($dom, 'note', $flag)) ->setAttribute('category', 'flag'); } foreach ($translation->getReferences() as $reference) { $notes->appendChild(static::createTextNode($dom, 'note', $reference[0].':'.$reference[1])) ->setAttribute('category', 'reference'); } $unit->appendChild($notes); $segment = $unit->appendChild($dom->createElement('segment')); $segment->appendChild(static::createTextNode($dom, 'source', $translation->getOriginal())); $segment->appendChild(static::createTextNode($dom, 'target', $translation->getTranslation())); foreach ($translation->getPluralTranslations() as $plural) { if ($plural !== '') { $segment->appendChild(static::createTextNode($dom, 'target', $plural)); } } $file->appendChild($unit); } return $dom->saveXML(); } protected static function createTextNode(DOMDocument $dom, $name, $string) { $node = $dom->createElement($name); $text = (preg_match('/[&<>]/', $string) === 1) ? $dom->createCDATASection($string) : $dom->createTextNode($string); $node->appendChild($text); return $node; } /** * Gets the translation's unit ID, if one is available. * * @param Translation $translation * * @return string|null */ public static function getUnitID(Translation $translation) { foreach ($translation->getComments() as $comment) { if (preg_match(static::UNIT_ID_REGEXP, $comment, $matches)) { return $matches[1]; } } return null; } } <?php namespace Gettext\Generators; use Gettext\Translations; use Gettext\Utils\MultidimensionalArrayTrait; class PhpArray extends Generator implements GeneratorInterface { use MultidimensionalArrayTrait; public static $options = [ 'includeHeaders' => true, ]; /** * {@inheritdoc} */ public static function toString(Translations $translations, array $options = []) { $array = static::generate($translations, $options); return '<?php return '.var_export($array, true).';'; } /** * Generates an array with the translations. * * @param Translations $translations * @param array $options * * @return array */ public static function generate(Translations $translations, array $options = []) { $options += static::$options; return static::toArray($translations, $options['includeHeaders'], true); } } <?php namespace Gettext\Generators; use Gettext\Translations; use Gettext\Utils\DictionaryTrait; use Gettext\Utils\CsvTrait; class CsvDictionary extends Generator implements GeneratorInterface { use DictionaryTrait; use CsvTrait; public static $options = [ 'includeHeaders' => false, 'delimiter' => ",", 'enclosure' => '"', 'escape_char' => "\\" ]; /** * {@parentDoc}. */ public static function toString(Translations $translations, array $options = []) { $options += static::$options; $handle = fopen('php://memory', 'w'); foreach (static::toArray($translations, $options['includeHeaders']) as $original => $translation) { static::fputcsv($handle, [$original, $translation], $options); } rewind($handle); $csv = stream_get_contents($handle); fclose($handle); return $csv; } } <?php namespace Gettext\Generators; use Gettext\Translations; use Gettext\Utils\DictionaryTrait; use Symfony\Component\Yaml\Yaml as YamlDumper; class YamlDictionary extends Generator implements GeneratorInterface { use DictionaryTrait; public static $options = [ 'includeHeaders' => false, 'indent' => 2, 'inline' => 3, ]; /** * {@inheritdoc} */ public static function toString(Translations $translations, array $options = []) { $options += static::$options; return YamlDumper::dump( static::toArray($translations, $options['includeHeaders']), $options['inline'], $options['indent'] ); } } <?php namespace Gettext\Generators; use Gettext\Translations; abstract class Generator implements GeneratorInterface { /** * {@inheritdoc} */ public static function toFile(Translations $translations, $file, array $options = []) { $content = static::toString($translations, $options); if (file_put_contents($file, $content) === false) { return false; } return true; } } <?php namespace Gettext\Generators; use Gettext\Translations; interface GeneratorInterface { /** * Saves the translations in a file. * * @param Translations $translations * @param string $file * @param array $options * * @return bool */ public static function toFile(Translations $translations, $file, array $options = []); /** * Generates a string with the translations ready to save in a file. * * @param Translations $translations * @param array $options * * @return string */ public static function toString(Translations $translations, array $options = []); } <?php namespace Gettext\Generators; use Gettext\Translations; use Gettext\Utils\DictionaryTrait; class JsonDictionary extends Generator implements GeneratorInterface { use DictionaryTrait; public static $options = [ 'json' => 0, 'includeHeaders' => false, ]; /** * {@parentDoc}. */ public static function toString(Translations $translations, array $options = []) { $options += static::$options; return json_encode(static::toArray($translations, $options['includeHeaders']), $options['json']); } } <?php namespace Gettext; class GettextTranslator extends BaseTranslator implements TranslatorInterface { /** * Constructor. Detects the current language using the environment variables. * * @param string $language */ public function __construct($language = null) { if (!function_exists('gettext')) { throw new \RuntimeException('This class require the gettext extension for PHP'); } //detects the language environment respecting the priority order //http://php.net/manual/en/function.gettext.php#114062 if (empty($language)) { $language = getenv('LANGUAGE') ?: getenv('LC_ALL') ?: getenv('LC_MESSAGES') ?: getenv('LANG'); } if (!empty($language)) { $this->setLanguage($language); } } /** * Define the current locale. * * @param string $language * @param int|null $category * * @return self */ public function setLanguage($language, $category = null) { if ($category === null) { $category = defined('LC_MESSAGES') ? LC_MESSAGES : LC_ALL; } setlocale($category, $language); putenv('LANGUAGE='.$language); return $this; } /** * Loads a gettext domain. * * @param string $domain * @param string $path * @param bool $default * * @return self */ public function loadDomain($domain, $path = null, $default = true) { bindtextdomain($domain, $path); bind_textdomain_codeset($domain, 'UTF-8'); if ($default) { textdomain($domain); } return $this; } /** * @see TranslatorInterface * * {@inheritdoc} */ public function gettext($original) { return gettext($original); } /** * @see TranslatorInterface * * {@inheritdoc} */ public function ngettext($original, $plural, $value) { return ngettext($original, $plural, $value); } /** * @see TranslatorInterface * * {@inheritdoc} */ public function dngettext($domain, $original, $plural, $value) { return dngettext($domain, $original, $plural, $value); } /** * @see TranslatorInterface * * {@inheritdoc} */ public function npgettext($context, $original, $plural, $value) { $message = $context."\x04".$original; $translation = ngettext($message, $plural, $value); return ($translation === $message) ? $original : $translation; } /** * @see TranslatorInterface * * {@inheritdoc} */ public function pgettext($context, $original) { $message = $context."\x04".$original; $translation = gettext($message); return ($translation === $message) ? $original : $translation; } /** * @see TranslatorInterface * * {@inheritdoc} */ public function dgettext($domain, $original) { return dgettext($domain, $original); } /** * @see TranslatorInterface * * {@inheritdoc} */ public function dpgettext($domain, $context, $original) { $message = $context."\x04".$original; $translation = dgettext($domain, $message); return ($translation === $message) ? $original : $translation; } /** * @see TranslatorInterface * * {@inheritdoc} */ public function dnpgettext($domain, $context, $original, $plural, $value) { $message = $context."\x04".$original; $translation = dngettext($domain, $message, $plural, $value); return ($translation === $message) ? $original : $translation; } } <?php namespace Gettext; use Gettext\Generators\PhpArray; class Translator extends BaseTranslator implements TranslatorInterface { protected $domain; protected $dictionary = []; protected $plurals = []; /** * Loads translation from a Translations instance, a file on an array. * * @param Translations|string|array $translations * * @return static */ public function loadTranslations($translations) { if (is_object($translations) && $translations instanceof Translations) { $translations = PhpArray::generate($translations, ['includeHeaders' => false]); } elseif (is_string($translations) && is_file($translations)) { $translations = include $translations; } elseif (!is_array($translations)) { throw new \InvalidArgumentException( 'Invalid Translator: only arrays, files or instance of Translations are allowed' ); } $this->addTranslations($translations); return $this; } /** * Set the default domain. * * @param string $domain * * @return static */ public function defaultDomain($domain) { $this->domain = $domain; return $this; } /** * @see TranslatorInterface * * {@inheritdoc} */ public function gettext($original) { return $this->dpgettext($this->domain, null, $original); } /** * @see TranslatorInterface * * {@inheritdoc} */ public function ngettext($original, $plural, $value) { return $this->dnpgettext($this->domain, null, $original, $plural, $value); } /** * @see TranslatorInterface * * {@inheritdoc} */ public function dngettext($domain, $original, $plural, $value) { return $this->dnpgettext($domain, null, $original, $plural, $value); } /** * @see TranslatorInterface * * {@inheritdoc} */ public function npgettext($context, $original, $plural, $value) { return $this->dnpgettext($this->domain, $context, $original, $plural, $value); } /** * @see TranslatorInterface * * {@inheritdoc} */ public function pgettext($context, $original) { return $this->dpgettext($this->domain, $context, $original); } /** * @see TranslatorInterface * * {@inheritdoc} */ public function dgettext($domain, $original) { return $this->dpgettext($domain, null, $original); } /** * @see TranslatorInterface * * {@inheritdoc} */ public function dpgettext($domain, $context, $original) { $translation = $this->getTranslation($domain, $context, $original); if (isset($translation[0]) && $translation[0] !== '') { return $translation[0]; } return $original; } /** * @see TranslatorInterface * * {@inheritdoc} */ public function dnpgettext($domain, $context, $original, $plural, $value) { $translation = $this->getTranslation($domain, $context, $original); $key = $this->getPluralIndex($domain, $value, $translation === false); if (isset($translation[$key]) && $translation[$key] !== '') { return $translation[$key]; } return ($key === 0) ? $original : $plural; } /** * Set new translations to the dictionary. * * @param array $translations */ protected function addTranslations(array $translations) { $domain = isset($translations['domain']) ? $translations['domain'] : ''; //Set the first domain loaded as default domain if ($this->domain === null) { $this->domain = $domain; } if (isset($this->dictionary[$domain])) { $this->dictionary[$domain] = array_replace_recursive($this->dictionary[$domain], $translations['messages']); return; } if (!empty($translations['plural-forms'])) { list($count, $code) = array_map('trim', explode(';', $translations['plural-forms'], 2)); // extract just the expression turn 'n' into a php variable '$n'. // Slap on a return keyword and semicolon at the end. $this->plurals[$domain] = [ 'count' => (int) str_replace('nplurals=', '', $count), 'code' => str_replace('plural=', 'return ', str_replace('n', '$n', $code)).';', ]; } $this->dictionary[$domain] = $translations['messages']; } /** * Search and returns a translation. * * @param string $domain * @param string $context * @param string $original * * @return string|false */ protected function getTranslation($domain, $context, $original) { return isset($this->dictionary[$domain][$context][$original]) ? $this->dictionary[$domain][$context][$original] : false; } /** * Executes the plural decision code given the number to decide which * plural version to take. * * @param string $domain * @param string $n * @param bool $fallback set to true to get fallback plural index * * @return int */ protected function getPluralIndex($domain, $n, $fallback) { //Not loaded domain or translation, use a fallback if (!isset($this->plurals[$domain]) || $fallback === true) { return $n == 1 ? 0 : 1; } if (!isset($this->plurals[$domain]['function'])) { $code = static::fixTerseIfs($this->plurals[$domain]['code']); $this->plurals[$domain]['function'] = eval("return function (\$n) { $code };"); } if ($this->plurals[$domain]['count'] <= 2) { return call_user_func($this->plurals[$domain]['function'], $n) ? 1 : 0; } return call_user_func($this->plurals[$domain]['function'], $n); } /** * This function will recursively wrap failure states in brackets if they contain a nested terse if. * * This because PHP can not handle nested terse if's unless they are wrapped in brackets. * * This code probably only works for the gettext plural decision codes. * * return ($n==1 ? 0 : $n%10>=2 && $n%10<=4 && ($n%100<10 || $n%100>=20) ? 1 : 2); * becomes * return ($n==1 ? 0 : ($n%10>=2 && $n%10<=4 && ($n%100<10 || $n%100>=20) ? 1 : 2)); * * @param string $code the terse if string * @param bool $inner If inner is true we wrap it in brackets * * @return string A formatted terse If that PHP can work with. */ private static function fixTerseIfs($code, $inner = false) { /* * (?P<expression>[^?]+) Capture everything up to ? as 'expression' * \? ? * (?P<success>[^:]+) Capture everything up to : as 'success' * : : * (?P<failure>[^;]+) Capture everything up to ; as 'failure' */ preg_match('/(?P<expression>[^?]+)\?(?P<success>[^:]+):(?P<failure>[^;]+)/', $code, $matches); // If no match was found then no terse if was present if (!isset($matches[0])) { return $code; } $expression = $matches['expression']; $success = $matches['success']; $failure = $matches['failure']; // Go look for another terse if in the failure state. $failure = static::fixTerseIfs($failure, true); $code = $expression.' ? '.$success.' : '.$failure; if ($inner) { return "($code)"; } // note the semicolon. We need that for executing the code. return "$code;"; } } <?php namespace Gettext; /** * Static class with merge contants. */ final class Merge { const ADD = 1; const REMOVE = 2; const HEADERS_ADD = 4; const HEADERS_REMOVE = 8; const HEADERS_OVERRIDE = 16; const LANGUAGE_OVERRIDE = 32; const DOMAIN_OVERRIDE = 64; const TRANSLATION_OVERRIDE = 128; const COMMENTS_OURS = 256; const COMMENTS_THEIRS = 512; const EXTRACTED_COMMENTS_OURS = 1024; const EXTRACTED_COMMENTS_THEIRS = 2048; const FLAGS_OURS = 4096; const FLAGS_THEIRS = 8192; const REFERENCES_OURS = 16384; const REFERENCES_THEIRS = 32768; const DEFAULTS = 5; //1 + 4 /** * Merge the flags of two translations. * * @param Translation $from * @param Translation $to * @param int $options */ public static function mergeFlags(Translation $from, Translation $to, $options = self::DEFAULTS) { if ($options & self::FLAGS_THEIRS) { $to->deleteFlags(); } if (!($options & self::FLAGS_OURS)) { foreach ($from->getFlags() as $flag) { $to->addFlag($flag); } } } /** * Merge the extracted comments of two translations. * * @param Translation $from * @param Translation $to * @param int $options */ public static function mergeExtractedComments(Translation $from, Translation $to, $options = self::DEFAULTS) { if ($options & self::EXTRACTED_COMMENTS_THEIRS) { $to->deleteExtractedComments(); } if (!($options & self::EXTRACTED_COMMENTS_OURS)) { foreach ($from->getExtractedComments() as $comment) { $to->addExtractedComment($comment); } } } /** * Merge the comments of two translations. * * @param Translation $from * @param Translation $to * @param int $options */ public static function mergeComments(Translation $from, Translation $to, $options = self::DEFAULTS) { if ($options & self::COMMENTS_THEIRS) { $to->deleteComments(); } if (!($options & self::COMMENTS_OURS)) { foreach ($from->getComments() as $comment) { $to->addComment($comment); } } } /** * Merge the references of two translations. * * @param Translation $from * @param Translation $to * @param int $options */ public static function mergeReferences(Translation $from, Translation $to, $options = self::DEFAULTS) { if ($options & self::REFERENCES_THEIRS) { $to->deleteReferences(); } if (!($options & self::REFERENCES_OURS)) { foreach ($from->getReferences() as $reference) { $to->addReference($reference[0], $reference[1]); } } } /** * Merge the translations of two translations. * * @param Translation $from * @param Translation $to * @param int $options */ public static function mergeTranslation(Translation $from, Translation $to, $options = self::DEFAULTS) { $override = (boolean) ($options & self::TRANSLATION_OVERRIDE); if (!$to->hasTranslation() || ($from->hasTranslation() && $override)) { $to->setTranslation($from->getTranslation()); } if (!$to->hasPlural() || ($from->hasPlural() && $override)) { $to->setPlural($from->getPlural()); } if (!$to->hasPluralTranslations() || ($from->hasPluralTranslations() && $override)) { $to->setPluralTranslations($from->getPluralTranslations()); } } /** * Merge the translations of two translations. * * @param Translations $from * @param Translations $to * @param int $options */ public static function mergeTranslations(Translations $from, Translations $to, $options = self::DEFAULTS) { if ($options & self::REMOVE) { $filtered = []; foreach ($to as $entry) { if ($from->find($entry)) { $filtered[$entry->getId()] = $entry; } } $to->exchangeArray($filtered); } foreach ($from as $entry) { if (($existing = $to->find($entry))) { $existing->mergeWith($entry, $options); } elseif ($options & self::ADD) { $to[] = $entry->getClone(); } } } /** * Merge the headers of two translations. * * @param Translations $from * @param Translations $to * @param int $options */ public static function mergeHeaders(Translations $from, Translations $to, $options = self::DEFAULTS) { if ($options & self::HEADERS_REMOVE) { foreach (array_keys($to->getHeaders()) as $name) { if ($from->getHeader($name) === null) { $to->deleteHeader($name); } } } foreach ($from->getHeaders() as $name => $value) { $current = $to->getHeader($name); if (empty($current)) { if ($options & self::HEADERS_ADD) { $to->setHeader($name, $value); } continue; } if (empty($value)) { continue; } switch ($name) { case Translations::HEADER_LANGUAGE: case Translations::HEADER_PLURAL: if ($options & self::LANGUAGE_OVERRIDE) { $to->setHeader($name, $value); } break; case Translations::HEADER_DOMAIN: if ($options & self::DOMAIN_OVERRIDE) { $to->setHeader($name, $value); } break; default: if ($options & self::HEADERS_OVERRIDE) { $to->setHeader($name, $value); } } } } } <?php namespace Gettext; abstract class BaseTranslator implements TranslatorInterface { /** @var TranslatorInterface */ public static $current; /** * @see TranslatorInterface */ public function noop($original) { return $original; } /** * @see TranslatorInterface */ public function register() { $previous = static::$current; static::$current = $this; static::includeFunctions(); return $previous; } /** * Include the gettext functions */ public static function includeFunctions() { include_once __DIR__.'/translator_functions.php'; } } <?php namespace Gettext; /** * Class to manage a translation string. */ class Translation { protected $id; protected $context; protected $original; protected $translation = ''; protected $plural; protected $pluralTranslation = []; protected $references = []; protected $comments = []; protected $extractedComments = []; protected $flags = []; protected $disabled = false; /** * Generates the id of a translation (context + glue + original). * * @param string $context * @param string $original * * @return string */ public static function generateId($context, $original) { return "{$context}\004{$original}"; } /** * Create a new instance of a Translation object. * * This is a factory method that will work even when Translation is extended. * * @param string $context The context of the translation * @param string $original The original string * @param string $plural The original plural string * @return static New Translation instance */ public static function create($context, $original, $plural = '') { return new static($context, $original, $plural); } /** * Construct. * * @param string $context The context of the translation * @param string $original The original string * @param string $plural The original plural string */ public function __construct($context, $original, $plural = '') { $this->context = (string) $context; $this->original = (string) $original; $this->setPlural($plural); } /** * Clones this translation. * * @param null|string $context Optional new context * @param null|string $original Optional new original * * @return Translation */ public function getClone($context = null, $original = null) { $new = clone $this; if ($context !== null) { $new->context = (string) $context; } if ($original !== null) { $new->original = (string) $original; } return $new; } /** * Sets the id of this translation. * @warning The use of this function to set a custom ID will prevent * Translations::find from matching this translation. * * @param string $id */ public function setId($id) { $this->id = $id; } /** * Returns the id of this translation. * * @return string */ public function getId() { if ($this->id === null) { return static::generateId($this->context, $this->original); } return $this->id; } /** * Checks whether the translation matches with the arguments. * * @param string $context * @param string $original * * @return bool */ public function is($context, $original = '') { return (($this->context === $context) && ($this->original === $original)) ? true : false; } /** * Enable or disable the translation * * @param bool $disabled * * @return self */ public function setDisabled($disabled) { $this->disabled = (bool) $disabled; return $this; } /** * Returns whether the translation is disabled * * @return bool */ public function isDisabled() { return $this->disabled; } /** * Gets the original string. * * @return string */ public function getOriginal() { return $this->original; } /** * Checks if the original string is empty or not. * * @return bool */ public function hasOriginal() { return ($this->original !== '') ? true : false; } /** * Sets the translation string. * * @param string $translation * * @return self */ public function setTranslation($translation) { $this->translation = (string) $translation; return $this; } /** * Gets the translation string. * * @return string */ public function getTranslation() { return $this->translation; } /** * Checks if the translation string is empty or not. * * @return bool */ public function hasTranslation() { return ($this->translation !== '') ? true : false; } /** * Sets the plural translation string. * * @param string $plural * * @return self */ public function setPlural($plural) { $this->plural = (string) $plural; return $this; } /** * Gets the plural translation string. * * @return string */ public function getPlural() { return $this->plural; } /** * Checks if the plural translation string is empty or not. * * @return bool */ public function hasPlural() { return ($this->plural !== '') ? true : false; } /** * Set a new plural translation. * * @param array $plural * * @return self */ public function setPluralTranslations(array $plural) { $this->pluralTranslation = $plural; return $this; } /** * Gets all plural translations. * * @param int $size * * @return array */ public function getPluralTranslations($size = null) { if ($size === null) { return $this->pluralTranslation; } $current = count($this->pluralTranslation); if ($size > $current) { return $this->pluralTranslation + array_fill(0, $size, ''); } if ($size < $current) { return array_slice($this->pluralTranslation, 0, $size); } return $this->pluralTranslation; } /** * Checks if there are any plural translation. * * @param bool $checkContent * * @return bool */ public function hasPluralTranslations($checkContent = false) { if ($checkContent) { return implode('', $this->pluralTranslation) !== ''; } return !empty($this->pluralTranslation); } /** * Removes all plural translations. * * @return self */ public function deletePluralTranslation() { $this->pluralTranslation = []; return $this; } /** * Gets the context of this translation. * * @return string */ public function getContext() { return $this->context; } /** * Checks if the context is empty or not. * * @return bool */ public function hasContext() { return (isset($this->context) && ($this->context !== '')) ? true : false; } /** * Adds a new reference for this translation. * * @param string $filename The file path where the translation has been found * @param null|int $line The line number where the translation has been found * * @return self */ public function addReference($filename, $line = null) { $key = "{$filename}:{$line}"; $this->references[$key] = [$filename, $line]; return $this; } /** * Checks if the translation has any reference. * * @return bool */ public function hasReferences() { return !empty($this->references); } /** * Return all references for this translation. * * @return array */ public function getReferences() { return array_values($this->references); } /** * Removes all references. * * @return self */ public function deleteReferences() { $this->references = []; return $this; } /** * Adds a new comment for this translation. * * @param string $comment * * @return self */ public function addComment($comment) { if (!in_array($comment, $this->comments, true)) { $this->comments[] = $comment; } return $this; } /** * Checks if the translation has any comment. * * @return bool */ public function hasComments() { return isset($this->comments[0]); } /** * Returns all comments for this translation. * * @return array */ public function getComments() { return $this->comments; } /** * Removes all comments. * * @return self */ public function deleteComments() { $this->comments = []; return $this; } /** * Adds a new extracted comment for this translation. * * @param string $comment * * @return self */ public function addExtractedComment($comment) { if (!in_array($comment, $this->extractedComments, true)) { $this->extractedComments[] = $comment; } return $this; } /** * Checks if the translation has any extracted comment. * * @return bool */ public function hasExtractedComments() { return isset($this->extractedComments[0]); } /** * Returns all extracted comments for this translation. * * @return array */ public function getExtractedComments() { return $this->extractedComments; } /** * Removes all extracted comments. * * @return self */ public function deleteExtractedComments() { $this->extractedComments = []; return $this; } /** * Adds a new flag for this translation. * * @param string $flag * * @return self */ public function addFlag($flag) { if (!in_array($flag, $this->flags, true)) { $this->flags[] = $flag; } return $this; } /** * Checks if the translation has any flag. * * @return bool */ public function hasFlags() { return isset($this->flags[0]); } /** * Returns all extracted flags for this translation. * * @return array */ public function getFlags() { return $this->flags; } /** * Removes all flags. * * @return self */ public function deleteFlags() { $this->flags = []; return $this; } /** * Merges this translation with other translation. * * @param Translation $translation The translation to merge with * @param int $options * * @return self */ public function mergeWith(Translation $translation, $options = Merge::DEFAULTS) { Merge::mergeTranslation($translation, $this, $options); Merge::mergeReferences($translation, $this, $options); Merge::mergeComments($translation, $this, $options); Merge::mergeExtractedComments($translation, $this, $options); Merge::mergeFlags($translation, $this, $options); return $this; } } <?php namespace Gettext\Utils; use Exception; use Gettext\Translations; abstract class FunctionsScanner { /** * Scan and returns the functions and the arguments. * * @param array $constants Constants used in the code to replace * * @return array */ abstract public function getFunctions(array $constants = []); /** * Search for specific functions and create translations. * * You can pass multiple translation with different domains and value found will be sorted respectively. * * @param Translations|Translations[] $translations Multiple domain translations instances where to save the values * @param array $options The extractor options * @throws Exception */ public function saveGettextFunctions($translations, array $options) { $translations = is_array($translations) ? $translations : [$translations]; /** @var Translations[] $translationByDomain [domain => translations, ..] */ $translationByDomain = array_reduce($translations, function ($carry, Translations $translations) { $carry[$translations->getDomain()] = $translations; return $carry; }, []); $functions = $options['functions']; $file = $options['file']; /** * List of source code comments already associated with a function. * * Prevents associating the same comment to multiple functions. * * @var ParsedComment[] $commentsCache */ $commentsCache = []; foreach ($this->getFunctions($options['constants']) as $function) { list($name, $line, $args) = $function; if (isset($options['lineOffset'])) { $line += $options['lineOffset']; } if (!isset($functions[$name])) { continue; } $deconstructed = $this->deconstructArgs($functions[$name], $args); if (!$deconstructed) { continue; } list($domain, $context, $original, $plural) = $deconstructed; if ((string)$original === '') { continue; } $isDefaultDomain = $domain === null; $domainTranslations = isset($translationByDomain[$domain]) ? $translationByDomain[$domain] : false; if (!empty($options['domainOnly']) && $isDefaultDomain) { // If we want to find translations for a specific domain, skip default domain messages continue; } if (!$domainTranslations) { continue; } $translation = $domainTranslations->insert($context, $original, $plural); $translation->addReference($file, $line); if (isset($function[3])) { /* @var ParsedComment $extractedComment */ foreach ($function[3] as $extractedComment) { if (in_array($extractedComment, $commentsCache, true)) { continue; } $translation->addExtractedComment($extractedComment->getComment()); $commentsCache[] = $extractedComment; } } } } /** * Deconstruct arguments to translation values * * @param $function * @param $args * @return array|null * @throws Exception */ protected function deconstructArgs($function, $args) { $domain = null; $context = null; $original = null; $plural = null; switch ($function) { case 'noop': case 'gettext': if (!isset($args[0])) { return null; } $original = $args[0]; break; case 'ngettext': if (!isset($args[1])) { return null; } list($original, $plural) = $args; break; case 'pgettext': if (!isset($args[1])) { return null; } list($context, $original) = $args; break; case 'dgettext': if (!isset($args[1])) { return null; } list($domain, $original) = $args; break; case 'dpgettext': if (!isset($args[2])) { return null; } list($domain, $context, $original) = $args; break; case 'npgettext': if (!isset($args[2])) { return null; } list($context, $original, $plural) = $args; break; case 'dnpgettext': if (!isset($args[3])) { return null; } list($domain, $context, $original, $plural) = $args; break; case 'dngettext': if (!isset($args[2])) { return null; } list($domain, $original, $plural) = $args; break; default: throw new Exception(sprintf('Not valid function %s', $function)); } return [$domain, $context, $original, $plural]; } } <?php namespace Gettext\Utils; use Gettext\Extractors\PhpCode; class PhpFunctionsScanner extends FunctionsScanner { /** * PHP tokens of the code to be parsed. * * @var array */ protected $tokens; /** * If not false, comments will be extracted. * * @var string|false|array */ protected $extractComments = false; /** * Enable extracting comments that start with a tag (if $tag is empty all the comments will be extracted). * * @param mixed $tag */ public function enableCommentsExtraction($tag = '') { $this->extractComments = $tag; } /** * Disable comments extraction. */ public function disableCommentsExtraction() { $this->extractComments = false; } /** * Constructor. * * @param string $code The php code to scan */ public function __construct($code) { $this->tokens = array_values( array_filter( token_get_all($code), function ($token) { return !is_array($token) || $token[0] !== T_WHITESPACE; } ) ); } /** * {@inheritdoc} */ public function getFunctions(array $constants = []) { $count = count($this->tokens); /* @var ParsedFunction[] $bufferFunctions */ $bufferFunctions = []; /* @var ParsedComment[] $bufferComments */ $bufferComments = []; /* @var array $functions */ $functions = []; for ($k = 0; $k < $count; ++$k) { $value = $this->tokens[$k]; if (is_string($value)) { if (isset($bufferFunctions[0])) { switch ($value) { case ',': $bufferFunctions[0]->nextArgument(); break; case ')': $functions[] = array_shift($bufferFunctions)->close(); break; case '.': break; default: $bufferFunctions[0]->stopArgument(); break; } } continue; } if (defined('T_NAME_FULLY_QUALIFIED') && T_NAME_FULLY_QUALIFIED === $value[0]) { $value[0] = T_STRING; $value[1] = ltrim($value[1], '\\'); } switch ($value[0]) { case T_CONSTANT_ENCAPSED_STRING: //add an argument to the current function if (isset($bufferFunctions[0])) { $bufferFunctions[0]->addArgumentChunk(PhpCode::convertString($value[1])); } break; case T_STRING: if (isset($bufferFunctions[0])) { if (isset($constants[$value[1]])) { $bufferFunctions[0]->addArgumentChunk($constants[$value[1]]); break; } if (strtolower($value[1]) === 'null') { $bufferFunctions[0]->addArgumentChunk(null); break; } $bufferFunctions[0]->stopArgument(); } //new function found for ($j = $k + 1; $j < $count; ++$j) { $nextToken = $this->tokens[$j]; if (is_array($nextToken) && $nextToken[0] === T_COMMENT) { continue; } if ($nextToken === '(') { $newFunction = new ParsedFunction($value[1], $value[2]); // add comment that was on the line before. if (isset($bufferComments[0])) { $comment = $bufferComments[0]; if ($comment->isRelatedWith($newFunction)) { $newFunction->addComment($comment); } } array_unshift($bufferFunctions, $newFunction); $k = $j; } break; } break; case T_COMMENT: $comment = $this->parsePhpComment($value[1], $value[2]); if ($comment) { array_unshift($bufferComments, $comment); // The comment is inside the function call. if (isset($bufferFunctions[0])) { $bufferFunctions[0]->addComment($comment); } } break; default: if (isset($bufferFunctions[0])) { $bufferFunctions[0]->stopArgument(); } break; } } return $functions; } /** * Extract the actual text from a PHP comment. * * If set, only returns comments that match the prefix(es). * * @param string $value The PHP comment. * @param int $line Line number. * * @return null|ParsedComment Comment or null if comment extraction is disabled or if there is a prefix mismatch. */ protected function parsePhpComment($value, $line) { if ($this->extractComments === false) { return null; } //this returns a comment or null $comment = ParsedComment::create($value, $line); $prefixes = array_filter((array) $this->extractComments); if ($comment && $comment->checkPrefixes($prefixes)) { return $comment; } return null; } } <?php namespace Gettext\Utils; /* * Trait to provide the functionality of read/write csv. */ trait CsvTrait { protected static $csvEscapeChar; /** * Check whether support the escape_char argument to fgetcsv/fputcsv or not * * @return bool */ protected static function supportsCsvEscapeChar() { if (static::$csvEscapeChar === null) { static::$csvEscapeChar = version_compare(PHP_VERSION, '5.5.4') >= 0; } return static::$csvEscapeChar; } /** * @param resource $handle * @param array $options * * @return array */ protected static function fgetcsv($handle, $options) { if (static::supportsCsvEscapeChar()) { return fgetcsv($handle, 0, $options['delimiter'], $options['enclosure'], $options['escape_char']); } return fgetcsv($handle, 0, $options['delimiter'], $options['enclosure']); } /** * @param resource $handle * @param array $fields * @param array $options * * @return bool|int */ protected static function fputcsv($handle, $fields, $options) { if (static::supportsCsvEscapeChar()) { return fputcsv($handle, $fields, $options['delimiter'], $options['enclosure'], $options['escape_char']); } return fputcsv($handle, $fields, $options['delimiter'], $options['enclosure']); } } <?php namespace Gettext\Utils; use Gettext\Translations; /** * Trait to provide the functionality of extracting headers. */ trait HeadersExtractorTrait { /** * Add the headers found to the translations instance. * * @param string $headers * @param Translations $translations * * @return array */ protected static function extractHeaders($headers, Translations $translations) { $headers = explode("\n", $headers); $currentHeader = null; foreach ($headers as $line) { $line = static::convertString($line); if ($line === '') { continue; } if (static::isHeaderDefinition($line)) { $header = array_map('trim', explode(':', $line, 2)); $currentHeader = $header[0]; $translations->setHeader($currentHeader, $header[1]); } else { $entry = $translations->getHeader($currentHeader); $translations->setHeader($currentHeader, $entry.$line); } } } /** * Checks if it is a header definition line. Useful for distguishing between header definitions * and possible continuations of a header entry. * * @param string $line Line to parse * * @return bool */ protected static function isHeaderDefinition($line) { return (bool) preg_match('/^[\w-]+:/', $line); } /** * Normalize a string. * * @param string $value * * @return string */ public static function convertString($value) { return $value; } } <?php namespace Gettext\Utils; /** * Function parsed by PhpFunctionsScanner. */ class ParsedFunction { /** * The function name. * * @var string */ protected $name; /** * The line where the function starts. * * @var int */ protected $line; /** * The strings extracted from the function arguments. * * @var string[] */ protected $arguments; /** * The current index of the function (-1 if no arguments). * * @var int|null */ protected $argumentIndex; /** * Shall we stop adding string chunks to the current argument? * * @var bool */ protected $argumentStopped; /** * Extracted comments. * * @var ParsedComment[]|null */ protected $comments; /** * Initializes the instance. * * @param string $name The function name. * @param int $line The line where the function starts. */ public function __construct($name, $line) { $this->name = $name; $this->line = $line; $this->arguments = []; $this->argumentIndex = -1; $this->argumentStopped = false; $this->comments = null; } /** * Stop extracting strings from the current argument (because we found something that's not a string). */ public function stopArgument() { if ($this->argumentIndex === -1) { $this->argumentIndex = 0; } $this->argumentStopped = true; } /** * Go to the next argument because we a comma was found. */ public function nextArgument() { if ($this->argumentIndex === -1) { // This should neve occur, but let's stay safe - During test/development an Exception should be thrown. $this->argumentIndex = 1; } else { ++$this->argumentIndex; } $this->argumentStopped = false; } /** * Add a string to the current argument. * * @param string|null $chunk */ public function addArgumentChunk($chunk) { if ($this->argumentStopped === false) { if ($this->argumentIndex === -1) { $this->argumentIndex = 0; } if (isset($this->arguments[$this->argumentIndex])) { $this->arguments[$this->argumentIndex] .= $chunk; } else { $this->arguments[$this->argumentIndex] = $chunk; } } } /** * Add a comment associated to this function. * * @param ParsedComment $comment */ public function addComment($comment) { if ($this->comments === null) { $this->comments = []; } $this->comments[] = $comment; } /** * Return the line the function starts. * * @return int Line number. */ public function getLine() { return $this->line; } /** * A closing parenthesis was found: return the final data. * The array returned has the following values: * 0 => string The function name. * 1 => int The line where the function starts. * 2 => string[] the strings extracted from the function arguments. * 3 => string[] the comments associated to the function. * * @return array */ public function close() { $arguments = []; for ($i = 0; $i <= $this->argumentIndex; ++$i) { $arguments[$i] = isset($this->arguments[$i]) ? $this->arguments[$i] : null; } return [ $this->name, $this->line, $arguments, $this->comments, ]; } } <?php namespace Gettext\Utils; /** * Comment parsed by PhpFunctionsScanner. */ class ParsedComment { /** * The comment itself. * * @var string */ protected $comment; /** * The line where the comment starts. * * @var int */ protected $firstLine; /** * The line where the comment ends. * * @var int */ protected $lastLine; /** * Initializes the instance. * * @param string $comment The comment itself. * @param int $firstLine The line where the comment starts. * @param int $lastLine The line where the comment ends. */ public function __construct($comment, $firstLine, $lastLine) { $this->comment = $comment; $this->firstLine = $firstLine; $this->lastLine = $lastLine; } /** * Create new object from raw comment data. * * @param string $value The PHP comment string. * @param int $line The line where the comment starts. * * @return static The parsed comment. */ public static function create($value, $line) { $lastLine = $line + substr_count($value, "\n"); $lines = array_map(function ($line) { if ('' === trim($line)) { return null; } $line = ltrim($line, "#*/ \t"); $line = rtrim($line, "#*/ \t"); return trim($line); }, explode("\n", $value)); // Remove empty lines. $lines = array_filter($lines); $value = implode(' ', $lines); return new static($value, $line, $lastLine); } /** * Return the line where the comment starts. * * @return int Line number. */ public function getFirstLine() { return $this->firstLine; } /** * Return the line where the comment ends. * * @return int Line number. */ public function getLastLine() { return $this->lastLine; } /** * Return the actual comment string. * * @return string The comment. */ public function getComment() { return $this->comment; } /** * Whether this comment is related with a given function. * * @param ParsedFunction $function The function to check. * @return bool Whether the comment is related or not. */ public function isRelatedWith(ParsedFunction $function) { return $this->getLastLine() === $function->getLine() || $this->getLastLine() === $function->getLine() - 1; } /** * Whether the comment matches the required prefixes. * * @param array $prefixes An array of prefixes to check. * @return bool Whether the comment matches the prefixes or not. */ public function checkPrefixes(array $prefixes) { if ('' === $this->comment) { return false; } if (empty($prefixes)) { return true; } foreach ($prefixes as $prefix) { if (strpos($this->comment, $prefix) === 0) { return true; } } return false; } } <?php namespace Gettext\Utils; use Gettext\Translations; /** * Trait used by all generators that exports the translations to plain dictionary (original => singular-translation). */ trait DictionaryTrait { use HeadersGeneratorTrait; use HeadersExtractorTrait; /** * Returns a plain dictionary with the format [original => translation]. * * @param Translations $translations * @param bool $includeHeaders * * @return array */ protected static function toArray(Translations $translations, $includeHeaders) { $messages = []; if ($includeHeaders) { $messages[''] = static::generateHeaders($translations); } foreach ($translations as $translation) { if ($translation->isDisabled()) { continue; } $messages[$translation->getOriginal()] = $translation->getTranslation(); } return $messages; } /** * Extract the entries from a dictionary. * * @param array $messages * @param Translations $translations */ protected static function fromArray(array $messages, Translations $translations) { foreach ($messages as $original => $translation) { if ($original === '') { static::extractHeaders($translation, $translations); continue; } $translations->insert(null, $original)->setTranslation($translation); } } } <?php namespace Gettext\Utils; use Gettext\Translations; /** * Trait to provide the functionality of extracting headers. */ trait HeadersGeneratorTrait { /** * Returns the headers as a string. * * @param Translations $translations * * @return string */ protected static function generateHeaders(Translations $translations) { $headers = ''; foreach ($translations->getHeaders() as $name => $value) { $headers .= sprintf("%s: %s\n", $name, $value); } return $headers; } } <?php namespace Gettext\Utils; class JsFunctionsScanner extends FunctionsScanner { protected $code; protected $status = []; /** * Constructor. * * @param string $code The php code to scan */ public function __construct($code) { // Normalize newline characters $this->code = str_replace(["\r\n", "\n\r", "\r"], "\n", $code); } /** * {@inheritdoc} */ public function getFunctions(array $constants = []) { $length = strlen($this->code); $line = 1; $buffer = ''; $functions = []; $bufferFunctions = []; $char = null; for ($pos = 0; $pos < $length; ++$pos) { $prev = $char; $char = $this->code[$pos]; $next = isset($this->code[$pos + 1]) ? $this->code[$pos + 1] : null; switch ($char) { case '\\': switch ($this->status()) { case 'simple-quote': if ($next !== "'") { break 2; } break; case 'double-quote': if ($next !== '"') { break 2; } break; case 'back-tick': if ($next !== '`') { break 2; } break; } $prev = $char; $char = $next; $pos++; $next = isset($this->code[$pos]) ? $this->code[$pos] : null; break; case "\n": ++$line; if ($this->status('line-comment')) { $this->upStatus(); } break; case '/': switch ($this->status()) { case 'simple-quote': case 'double-quote': case 'back-tick': case 'line-comment': break; case 'block-comment': if ($prev === '*') { $this->upStatus(); } break; default: if ($next === '/') { $this->downStatus('line-comment'); } elseif ($next === '*') { $this->downStatus('block-comment'); } break; } break; case "'": switch ($this->status()) { case 'simple-quote': $this->upStatus(); break; case 'line-comment': case 'block-comment': case 'double-quote': case 'back-tick': break; default: $this->downStatus('simple-quote'); break; } break; case '"': switch ($this->status()) { case 'double-quote': $this->upStatus(); break; case 'line-comment': case 'block-comment': case 'simple-quote': case 'back-tick': break; default: $this->downStatus('double-quote'); break; } break; case '`': switch ($this->status()) { case 'back-tick': $this->upStatus(); break; case 'line-comment': case 'block-comment': case 'simple-quote': case 'double-quote': break; default: $this->downStatus('back-tick'); break; } break; case '(': switch ($this->status()) { case 'simple-quote': case 'double-quote': case 'back-tick': case 'line-comment': case 'block-comment': break; default: if ($buffer && preg_match('/(\w+)$/', $buffer, $matches)) { $this->downStatus('function'); array_unshift($bufferFunctions, [$matches[1], $line, []]); $buffer = ''; continue 3; } break; } break; case ')': switch ($this->status()) { case 'function': if (($argument = static::prepareArgument($buffer))) { $bufferFunctions[0][2][] = $argument; } if (!empty($bufferFunctions)) { $functions[] = array_shift($bufferFunctions); } $this->upStatus(); $buffer = ''; continue 3; } break; case ',': switch ($this->status()) { case 'function': if (($argument = static::prepareArgument($buffer))) { $bufferFunctions[0][2][] = $argument; } $buffer = ''; continue 3; } break; case ' ': case '\t': switch ($this->status()) { case 'double-quote': case 'simple-quote': case 'back-tick': break; default: $buffer = ''; continue 3; } break; } switch ($this->status()) { case 'line-comment': case 'block-comment': break; default: $buffer .= $char; break; } } return $functions; } /** * Get the current context of the scan. * * @param null|string $match To check whether the current status is this value * * @return string|bool */ protected function status($match = null) { $status = isset($this->status[0]) ? $this->status[0] : null; if ($match !== null) { return $status === $match; } return $status; } /** * Add a new status to the stack. * * @param string $status */ protected function downStatus($status) { array_unshift($this->status, $status); } /** * Removes and return the current status. * * @return string|null */ protected function upStatus() { return array_shift($this->status); } /** * Prepares the arguments found in functions. * * @param string $argument * * @return string */ protected static function prepareArgument($argument) { if ($argument && in_array($argument[0], ['"', "'", '`'], true)) { return static::convertString(substr($argument, 1, -1)); } } /** * Decodes a string with an argument. * * @param string $value * * @return string */ protected static function convertString($value) { if (strpos($value, '\\') === false) { return $value; } return preg_replace_callback( '/\\$n|r|t|v|e|f|"|\\$/', function ($match) { switch ($match[1][0]) { case 'n': return "\n"; case 'r': return "\r"; case 't': return "\t"; case 'v': return "\v"; case 'e': return "\e"; case 'f': return "\f"; case '"': return '"'; case '\\': return '\\'; } }, $value ); } } <?php namespace Gettext\Utils; class StringReader { public $pos; public $str; public $strlen; /** * Constructor. * * @param string $str The string to read */ public function __construct($str) { $this->pos = 0; $this->str = $str; $this->strlen = strlen($this->str); } /** * Read and returns a part of the string. * * @param int $bytes The number of bytes to read * * @return string */ public function read($bytes) { $data = substr($this->str, $this->pos, $bytes); $this->seekto($this->pos + $bytes); return $data; } /** * Move the cursor to a specific position. * * @param int $pos The amount of bytes to move * * @return int The new position */ public function seekto($pos) { $this->pos = ($this->strlen < $pos) ? $this->strlen : $pos; return $this->pos; } } <?php namespace Gettext\Utils; use Gettext\Translations; /** * Trait used by all generators that exports the translations to multidimensional arrays * (context => [original => [translation, plural1, pluraln...]]). */ trait MultidimensionalArrayTrait { use HeadersGeneratorTrait; use HeadersExtractorTrait; /** * Returns a multidimensional array. * * @param Translations $translations * @param bool $includeHeaders * @param bool $forceArray * * @return array */ protected static function toArray(Translations $translations, $includeHeaders, $forceArray = false) { $pluralForm = $translations->getPluralForms(); $pluralSize = is_array($pluralForm) ? ($pluralForm[0] - 1) : null; $messages = []; if ($includeHeaders) { $messages[''] = [ '' => [static::generateHeaders($translations)], ]; } foreach ($translations as $translation) { if ($translation->isDisabled()) { continue; } $context = $translation->getContext(); $original = $translation->getOriginal(); if (!isset($messages[$context])) { $messages[$context] = []; } if ($translation->hasPluralTranslations(true)) { $messages[$context][$original] = $translation->getPluralTranslations($pluralSize); array_unshift($messages[$context][$original], $translation->getTranslation()); } elseif ($forceArray) { $messages[$context][$original] = [$translation->getTranslation()]; } else { $messages[$context][$original] = $translation->getTranslation(); } } return [ 'domain' => $translations->getDomain(), 'plural-forms' => $translations->getHeader('Plural-Forms'), 'messages' => $messages, ]; } /** * Extract the entries from a multidimensional array. * * @param array $messages * @param Translations $translations */ protected static function fromArray(array $messages, Translations $translations) { if (!empty($messages['domain'])) { $translations->setDomain($messages['domain']); } if (!empty($messages['plural-forms'])) { $translations->setHeader(Translations::HEADER_PLURAL, $messages['plural-forms']); } foreach ($messages['messages'] as $context => $contextTranslations) { foreach ($contextTranslations as $original => $value) { if ($context === '' && $original === '') { static::extractHeaders(is_array($value) ? array_shift($value) : $value, $translations); continue; } $translation = $translations->insert($context, $original); if (is_array($value)) { $translation->setTranslation(array_shift($value)); $translation->setPluralTranslations($value); } else { $translation->setTranslation($value); } } } } } <?php namespace Gettext; use Gettext\Languages\Language; use BadMethodCallException; use InvalidArgumentException; use ArrayObject; /** * Class to manage a collection of translations. * * @method static $this fromBladeFile(string $filename, array $options = []) * @method static $this fromBladeString(string $string, array $options = []) * @method $this addFromBladeFile(string $filename, array $options = []) * @method $this addFromBladeString(string $string, array $options = []) * @method static $this fromCsvFile(string $filename, array $options = []) * @method static $this fromCsvString(string $string, array $options = []) * @method $this addFromCsvFile(string $filename, array $options = []) * @method $this addFromCsvString(string $string, array $options = []) * @method bool toCsvFile(string $filename, array $options = []) * @method string toCsvString(array $options = []) * @method static $this fromCsvDictionaryFile(string $filename, array $options = []) * @method static $this fromCsvDictionaryString(string $string, array $options = []) * @method $this addFromCsvDictionaryFile(string $filename, array $options = []) * @method $this addFromCsvDictionaryString(string $string, array $options = []) * @method bool toCsvDictionaryFile(string $filename, array $options = []) * @method string toCsvDictionaryString(array $options = []) * @method static $this fromJedFile(string $filename, array $options = []) * @method static $this fromJedString(string $string, array $options = []) * @method $this addFromJedFile(string $filename, array $options = []) * @method $this addFromJedString(string $string, array $options = []) * @method bool toJedFile(string $filename, array $options = []) * @method string toJedString(array $options = []) * @method static $this fromJsCodeFile(string $filename, array $options = []) * @method static $this fromJsCodeString(string $string, array $options = []) * @method $this addFromJsCodeFile(string $filename, array $options = []) * @method $this addFromJsCodeString(string $string, array $options = []) * @method static $this fromJsonFile(string $filename, array $options = []) * @method static $this fromJsonString(string $string, array $options = []) * @method $this addFromJsonFile(string $filename, array $options = []) * @method $this addFromJsonString(string $string, array $options = []) * @method bool toJsonFile(string $filename, array $options = []) * @method string toJsonString(array $options = []) * @method static $this fromJsonDictionaryFile(string $filename, array $options = []) * @method static $this fromJsonDictionaryString(string $string, array $options = []) * @method $this addFromJsonDictionaryFile(string $filename, array $options = []) * @method $this addFromJsonDictionaryString(string $string, array $options = []) * @method bool toJsonDictionaryFile(string $filename, array $options = []) * @method string toJsonDictionaryString(array $options = []) * @method static $this fromMoFile(string $filename, array $options = []) * @method static $this fromMoString(string $string, array $options = []) * @method $this addFromMoFile(string $filename, array $options = []) * @method $this addFromMoString(string $string, array $options = []) * @method bool toMoFile(string $filename, array $options = []) * @method string toMoString(array $options = []) * @method static $this fromPhpArrayFile(string $filename, array $options = []) * @method static $this fromPhpArrayString(string $string, array $options = []) * @method $this addFromPhpArrayFile(string $filename, array $options = []) * @method $this addFromPhpArrayString(string $string, array $options = []) * @method bool toPhpArrayFile(string $filename, array $options = []) * @method string toPhpArrayString(array $options = []) * @method static $this fromPhpCodeFile(string $filename, array $options = []) * @method static $this fromPhpCodeString(string $string, array $options = []) * @method $this addFromPhpCodeFile(string $filename, array $options = []) * @method $this addFromPhpCodeString(string $string, array $options = []) * @method static $this fromPoFile(string $filename, array $options = []) * @method static $this fromPoString(string $string, array $options = []) * @method $this addFromPoFile(string $filename, array $options = []) * @method $this addFromPoString(string $string, array $options = []) * @method bool toPoFile(string $filename, array $options = []) * @method string toPoString(array $options = []) * @method static $this fromTwigFile(string $filename, array $options = []) * @method static $this fromTwigString(string $string, array $options = []) * @method $this addFromTwigFile(string $filename, array $options = []) * @method $this addFromTwigString(string $string, array $options = []) * @method static $this fromVueJsFile(string $filename, array $options = []) * @method static $this fromVueJsString(string $filename, array $options = []) * @method $this addFromVueJsFile(string $filename, array $options = []) * @method $this addFromVueJsString(string $filename, array $options = []) * @method static $this fromXliffFile(string $filename, array $options = []) * @method static $this fromXliffString(string $string, array $options = []) * @method $this addFromXliffFile(string $filename, array $options = []) * @method $this addFromXliffString(string $string, array $options = []) * @method bool toXliffFile(string $filename, array $options = []) * @method string toXliffString(array $options = []) * @method static $this fromYamlFile(string $filename, array $options = []) * @method static $this fromYamlString(string $string, array $options = []) * @method $this addFromYamlFile(string $filename, array $options = []) * @method $this addFromYamlString(string $string, array $options = []) * @method bool toYamlFile(string $filename, array $options = []) * @method string toYamlString(array $options = []) * @method static $this fromYamlDictionaryFile(string $filename, array $options = []) * @method static $this fromYamlDictionaryString(string $string, array $options = []) * @method $this addFromYamlDictionaryFile(string $filename, array $options = []) * @method $this addFromYamlDictionaryString(string $string, array $options = []) * @method bool toYamlDictionaryFile(string $filename, array $options = []) * @method string toYamlDictionaryString(array $options = []) */ class Translations extends ArrayObject { const HEADER_LANGUAGE = 'Language'; const HEADER_PLURAL = 'Plural-Forms'; const HEADER_DOMAIN = 'X-Domain'; public static $options = [ 'defaultHeaders' => [ 'Project-Id-Version' => '', 'Report-Msgid-Bugs-To' => '', 'Last-Translator' => '', 'Language-Team' => '', 'MIME-Version' => '1.0', 'Content-Type' => 'text/plain; charset=UTF-8', 'Content-Transfer-Encoding' => '8bit', ], 'headersSorting' => false, 'defaultDateHeaders' => [ 'POT-Creation-Date', 'PO-Revision-Date', ], ]; protected $headers; protected $translationClass; /** * @see ArrayObject::__construct() */ public function __construct( $input = [], $flags = 0, $iterator_class = 'ArrayIterator', $translationClass = 'Gettext\Translation' ) { $this->headers = static::$options['defaultHeaders']; foreach (static::$options['defaultDateHeaders'] as $header) { $this->headers[$header] = date('c'); } $this->headers[self::HEADER_LANGUAGE] = ''; $this->translationClass = $translationClass; parent::__construct($input, $flags, $iterator_class); } /** * Magic method to create new instances using extractors * For example: Translations::fromMoFile($filename, $options);. * * @return Translations */ public static function __callStatic($name, $arguments) { if (!preg_match('/^from(\w+)(File|String)$/i', $name, $matches)) { throw new BadMethodCallException("The method $name does not exists"); } return call_user_func_array([new static(), 'add'.ucfirst($name)], $arguments); } /** * Magic method to import/export the translations to a specific format * For example: $translations->toMoFile($filename, $options); * For example: $translations->addFromMoFile($filename, $options);. * * @return self|bool */ public function __call($name, $arguments) { if (!preg_match('/^(addFrom|to)(\w+)(File|String)$/i', $name, $matches)) { throw new BadMethodCallException("The method $name does not exists"); } if ($matches[1] === 'addFrom') { $extractor = 'Gettext\\Extractors\\'.$matches[2].'::from'.$matches[3]; $source = array_shift($arguments); $options = array_shift($arguments) ?: []; call_user_func($extractor, $source, $this, $options); return $this; } $generator = 'Gettext\\Generators\\'.$matches[2].'::to'.$matches[3]; array_unshift($arguments, $this); return call_user_func_array($generator, $arguments); } /** * Magic method to clone each translation on clone the translations object. */ public function __clone() { $array = []; foreach ($this as $key => $translation) { $array[$key] = clone $translation; } $this->exchangeArray($array); } /** * Control the new translations added. * * @param mixed $index * @param Translation $value * * @throws InvalidArgumentException If the value is not an instance of Gettext\Translation * * @return Translation */ #[\ReturnTypeWillChange] public function offsetSet($index, $value) { if (!($value instanceof Translation)) { throw new InvalidArgumentException( 'Only instances of Gettext\\Translation must be added to a Gettext\\Translations' ); } $id = $value->getId(); if ($this->offsetExists($id)) { $this[$id]->mergeWith($value); return $this[$id]; } parent::offsetSet($id, $value); return $value; } /** * Set the plural definition. * * @param int $count * @param string $rule * * @return self */ public function setPluralForms($count, $rule) { if (preg_match('/[a-z]/i', str_replace('n', '', $rule))) { throw new \InvalidArgumentException('Invalid Plural form: ' . $rule); } $this->setHeader(self::HEADER_PLURAL, "nplurals={$count}; plural={$rule};"); return $this; } /** * Returns the parsed plural definition. * * @param null|array [count, rule] */ public function getPluralForms() { $header = $this->getHeader(self::HEADER_PLURAL); if (!empty($header) && preg_match('/^nplurals\s*=\s*(\d+)\s*;\s*plural\s*=\s*([^;]+)\s*;$/', $header, $matches) ) { return [intval($matches[1]), $matches[2]]; } } /** * Set a new header. * * @param string $name * @param string $value * * @return self */ public function setHeader($name, $value) { $name = trim($name); $this->headers[$name] = trim(isset($value) ? $value : ''); return $this; } /** * Returns a header value. * * @param string $name * * @return null|string */ public function getHeader($name) { return isset($this->headers[$name]) ? $this->headers[$name] : null; } /** * Returns all header for this translations (in alphabetic order). * * @return array */ public function getHeaders() { if (static::$options['headersSorting']) { ksort($this->headers); } return $this->headers; } /** * Removes all headers. * * @return self */ public function deleteHeaders() { $this->headers = []; return $this; } /** * Removes one header. * * @param string $name * * @return self */ public function deleteHeader($name) { unset($this->headers[$name]); return $this; } /** * Returns the language value. * * @return string $language */ public function getLanguage() { return $this->getHeader(self::HEADER_LANGUAGE); } /** * Sets the language and the plural forms. * * @param string $language * * @throws InvalidArgumentException if the language hasn't been recognized * * @return self */ public function setLanguage($language) { $this->setHeader(self::HEADER_LANGUAGE, trim($language)); if (($info = Language::getById($language))) { return $this->setPluralForms(count($info->categories), $info->formula); } throw new InvalidArgumentException(sprintf('The language "%s" is not valid', $language)); } /** * Checks whether the language is empty or not. * * @return bool */ public function hasLanguage() { $language = $this->getLanguage(); return (is_string($language) && ($language !== '')) ? true : false; } /** * Set a new domain for this translations. * * @param string $domain * * @return self */ public function setDomain($domain) { $this->setHeader(self::HEADER_DOMAIN, trim($domain)); return $this; } /** * Returns the domain. * * @return string */ public function getDomain() { return $this->getHeader(self::HEADER_DOMAIN); } /** * Checks whether the domain is empty or not. * * @return bool */ public function hasDomain() { $domain = $this->getDomain(); return (is_string($domain) && ($domain !== '')) ? true : false; } /** * Search for a specific translation. * * @param string|Translation $context The context of the translation or a translation instance * @param string $original The original string * @warning Translations with custom identifiers (e.g. XLIFF unit IDs) cannot be found using this function. * * @return Translation|false */ public function find($context, $original = '') { if ($context instanceof Translation) { $id = $context->getId(); } else { $id = Translation::generateId($context, $original); } return $this->offsetExists($id) ? $this[$id] : false; } /** * Count all elements translated * * @return integer */ public function countTranslated() { $c = 0; foreach ($this as $v) { if ($v->hasTranslation()) { $c++; } } return $c; } /** * Creates and insert/merges a new translation. * * @param string $context The translation context * @param string $original The translation original string * @param string $plural The translation original plural string * * @return Translation The translation created */ public function insert($context, $original, $plural = '') { return $this->offsetSet(null, $this->createNewTranslation($context, $original, $plural)); } /** * Merges this translations with other translations. * * @param Translations $translations The translations instance to merge with * @param int $options * * @return self */ public function mergeWith(Translations $translations, $options = Merge::DEFAULTS) { Merge::mergeHeaders($translations, $this, $options); Merge::mergeTranslations($translations, $this, $options); return $this; } /** * Create a new instance of a Translation object. * * @param string $context The context of the translation * @param string $original The original string * @param string $plural The original plural string * @return Translation New Translation instance */ public function createNewTranslation($context, $original, $plural = '') { $class = $this->translationClass; return $class::create($context, $original, $plural); } } <?php namespace Gettext; /** * Interface used by all translators. */ interface TranslatorInterface { /** * Register this translator as global, to use with the gettext functions __(), p__(), etc. * Returns the previous translator if exists. * * @return TranslatorInterface|null */ public function register(); /** * Noop, marks the string for translation but returns it unchanged. * * @param string $original * * @return string */ public function noop($original); /** * Gets a translation using the original string. * * @param string $original * * @return string */ public function gettext($original); /** * Gets a translation checking the plural form. * * @param string $original * @param string $plural * @param string $value * * @return string */ public function ngettext($original, $plural, $value); /** * Gets a translation checking the domain and the plural form. * * @param string $domain * @param string $original * @param string $plural * @param string $value * * @return string */ public function dngettext($domain, $original, $plural, $value); /** * Gets a translation checking the context and the plural form. * * @param string $context * @param string $original * @param string $plural * @param string $value * * @return string */ public function npgettext($context, $original, $plural, $value); /** * Gets a translation checking the context. * * @param string $context * @param string $original * * @return string */ public function pgettext($context, $original); /** * Gets a translation checking the domain. * * @param string $domain * @param string $original * * @return string */ public function dgettext($domain, $original); /** * Gets a translation checking the domain and context. * * @param string $domain * @param string $context * @param string $original * * @return string */ public function dpgettext($domain, $context, $original); /** * Gets a translation checking the domain, the context and the plural form. * * @param string $domain * @param string $context * @param string $original * @param string $plural * @param string $value */ public function dnpgettext($domain, $context, $original, $plural, $value); } <?php spl_autoload_register(function ($class) { if (strpos($class, 'Gettext\\') !== 0) { return; } $file = __DIR__.str_replace('\\', DIRECTORY_SEPARATOR, substr($class, strlen('Gettext'))).'.php'; if (is_file($file)) { require_once $file; } }); <?php namespace Gettext\Extractors; use Gettext\Translations; use Gettext\Translation; use Gettext\Utils\HeadersExtractorTrait; /** * Class to get gettext strings from php files returning arrays. */ class Po extends Extractor implements ExtractorInterface { use HeadersExtractorTrait; /** * Parses a .po file and append the translations found in the Translations instance. * * {@inheritdoc} */ public static function fromString($string, Translations $translations, array $options = []) { $lines = explode("\n", $string); $i = 0; $translation = $translations->createNewTranslation('', ''); for ($n = count($lines); $i < $n; ++$i) { $line = trim($lines[$i]); $line = static::fixMultiLines($line, $lines, $i); if ($line === "#") { $line = ""; } if ($line === '') { if ($translation->is('', '')) { static::extractHeaders($translation->getTranslation(), $translations); } elseif ($translation->hasOriginal()) { $translations[] = $translation; } $translation = $translations->createNewTranslation('', ''); continue; } $splitLine = preg_split('/\s+/', $line, 2); $key = $splitLine[0]; $data = isset($splitLine[1]) ? $splitLine[1] : ''; if ($key === '#~') { $translation->setDisabled(true); $splitLine = preg_split('/\s+/', $data, 2); $key = $splitLine[0]; $data = isset($splitLine[1]) ? $splitLine[1] : ''; } switch ($key) { case '#': $translation->addComment($data); $append = null; break; case '#.': $translation->addExtractedComment($data); $append = null; break; case '#,': foreach (array_map('trim', explode(',', trim($data))) as $value) { $translation->addFlag($value); } $append = null; break; case '#:': foreach (preg_split('/\s+/', trim($data)) as $value) { if (preg_match('/^(.+)(:(\d*))?$/U', $value, $matches)) { $translation->addReference($matches[1], isset($matches[3]) ? $matches[3] : null); } } $append = null; break; case 'msgctxt': $translation = $translation->getClone(static::convertString($data)); $append = 'Context'; break; case 'msgid': $translation = $translation->getClone(null, static::convertString($data)); $append = 'Original'; break; case 'msgid_plural': $translation->setPlural(static::convertString($data)); $append = 'Plural'; break; case 'msgstr': case 'msgstr[0]': $translation->setTranslation(static::convertString($data)); $append = 'Translation'; break; case 'msgstr[1]': $translation->setPluralTranslations([static::convertString($data)]); $append = 'PluralTranslation'; break; default: if (strpos($key, 'msgstr[') === 0) { $p = $translation->getPluralTranslations(); $p[] = static::convertString($data); $translation->setPluralTranslations($p); $append = 'PluralTranslation'; break; } if (isset($append)) { if ($append === 'Context') { $translation = $translation->getClone($translation->getContext() ."\n" .static::convertString($data)); break; } if ($append === 'Original') { $translation = $translation->getClone(null, $translation->getOriginal() ."\n" .static::convertString($data)); break; } if ($append === 'PluralTranslation') { $p = $translation->getPluralTranslations(); $p[] = array_pop($p)."\n".static::convertString($data); $translation->setPluralTranslations($p); break; } $getMethod = 'get'.$append; $setMethod = 'set'.$append; $translation->$setMethod($translation->$getMethod()."\n".static::convertString($data)); } break; } } if ($translation->hasOriginal() && !in_array($translation, iterator_to_array($translations))) { $translations[] = $translation; } } /** * Gets one string from multiline strings. * * @param string $line * @param array $lines * @param int &$i * * @return string */ protected static function fixMultiLines($line, array $lines, &$i) { for ($j = $i, $t = count($lines); $j < $t; ++$j) { if (substr($line, -1, 1) == '"' && isset($lines[$j + 1])) { $nextLine = trim($lines[$j + 1]); if (substr($nextLine, 0, 1) == '"') { $line = substr($line, 0, -1).substr($nextLine, 1); continue; } if (substr($nextLine, 0, 4) == '#~ "') { $line = substr($line, 0, -1).substr($nextLine, 4); continue; } } $i = $j; break; } return $line; } /** * Convert a string from its PO representation. * * @param string $value * * @return string */ public static function convertString($value) { if (!$value) { return ''; } if ($value[0] === '"') { $value = substr($value, 1, -1); } return strtr( $value, [ '\\\\' => '\\', '\\a' => "\x07", '\\b' => "\x08", '\\t' => "\t", '\\n' => "\n", '\\v' => "\x0b", '\\f' => "\x0c", '\\r' => "\r", '\\"' => '"', ] ); } } <?php namespace Gettext\Extractors; use Exception; use Gettext\Translations; use Gettext\Utils\StringReader; /** * Class to get gettext strings from .mo files. */ class Mo extends Extractor implements ExtractorInterface { const MAGIC1 = -1794895138; const MAGIC2 = -569244523; const MAGIC3 = 2500072158; protected static $stringReaderClass = 'Gettext\Utils\StringReader'; /** * {@inheritdoc} */ public static function fromString($string, Translations $translations, array $options = []) { /** @var StringReader $stream */ $stream = new static::$stringReaderClass($string); $magic = static::readInt($stream, 'V'); if (($magic === static::MAGIC1) || ($magic === static::MAGIC3)) { //to make sure it works for 64-bit platforms $byteOrder = 'V'; //low endian } elseif ($magic === (static::MAGIC2 & 0xFFFFFFFF)) { $byteOrder = 'N'; //big endian } else { throw new Exception('Not MO file'); } static::readInt($stream, $byteOrder); $total = static::readInt($stream, $byteOrder); //total string count $originals = static::readInt($stream, $byteOrder); //offset of original table $tran = static::readInt($stream, $byteOrder); //offset of translation table $stream->seekto($originals); $table_originals = static::readIntArray($stream, $byteOrder, $total * 2); $stream->seekto($tran); $table_translations = static::readIntArray($stream, $byteOrder, $total * 2); for ($i = 0; $i < $total; ++$i) { $next = $i * 2; $stream->seekto($table_originals[$next + 2]); $original = $stream->read($table_originals[$next + 1]); $stream->seekto($table_translations[$next + 2]); $translated = $stream->read($table_translations[$next + 1]); if ($original === '') { // Headers foreach (explode("\n", $translated) as $headerLine) { if ($headerLine === '') { continue; } $headerChunks = preg_split('/:\s*/', $headerLine, 2); $translations->setHeader($headerChunks[0], isset($headerChunks[1]) ? $headerChunks[1] : ''); } continue; } $chunks = explode("\x04", $original, 2); if (isset($chunks[1])) { $context = $chunks[0]; $original = $chunks[1]; } else { $context = ''; } $chunks = explode("\x00", $original, 2); if (isset($chunks[1])) { $original = $chunks[0]; $plural = $chunks[1]; } else { $plural = ''; } $translation = $translations->insert($context, $original, $plural); if ($translated === '') { continue; } if ($plural === '') { $translation->setTranslation($translated); continue; } $v = explode("\x00", $translated); $translation->setTranslation(array_shift($v)); $translation->setPluralTranslations($v); } } /** * @param StringReader $stream * @param string $byteOrder */ protected static function readInt(StringReader $stream, $byteOrder) { if (($read = $stream->read(4)) === false) { return false; } $read = unpack($byteOrder, $read); return array_shift($read); } /** * @param StringReader $stream * @param string $byteOrder * @param int $count */ protected static function readIntArray(StringReader $stream, $byteOrder, $count) { return unpack($byteOrder.$count, $stream->read(4 * $count)); } } <?php namespace Gettext\Extractors; use Gettext\Translations; /** * Class to get gettext strings from json files. */ class Jed extends Extractor implements ExtractorInterface { /** * {@inheritdoc} */ public static function fromString($string, Translations $translations, array $options = []) { static::extract(json_decode($string, true), $translations); } /** * Handle an array of translations and append to the Translations instance. * * @param array $content * @param Translations $translations */ public static function extract(array $content, Translations $translations) { $messages = current($content); $headers = isset($messages['']) ? $messages[''] : null; unset($messages['']); if (!empty($headers['domain'])) { $translations->setDomain($headers['domain']); } if (!empty($headers['lang'])) { $translations->setLanguage($headers['lang']); } if (!empty($headers['plural-forms'])) { $translations->setHeader(Translations::HEADER_PLURAL, $headers['plural-forms']); } $context_glue = '\u0004'; foreach ($messages as $key => $translation) { $key = explode($context_glue, $key); $context = isset($key[1]) ? array_shift($key) : ''; $translations->insert($context, array_shift($key)) ->setTranslation(array_shift($translation)) ->setPluralTranslations($translation); } } } <?php namespace Gettext\Extractors; use Gettext\Translations; use Gettext\Utils\MultidimensionalArrayTrait; /** * Class to get gettext strings from json. */ class Json extends Extractor implements ExtractorInterface { use MultidimensionalArrayTrait; /** * {@inheritdoc} */ public static function fromString($string, Translations $translations, array $options = []) { $messages = json_decode($string, true); if (is_array($messages)) { static::fromArray($messages, $translations); } } } <?php namespace Gettext\Extractors; use Exception; use InvalidArgumentException; use Gettext\Translations; abstract class Extractor implements ExtractorInterface { /** * {@inheritdoc} */ public static function fromFile($file, Translations $translations, array $options = []) { foreach (static::getFiles($file) as $file) { $options['file'] = $file; static::fromString(static::readFile($file), $translations, $options); } } /** * Checks and returns all files. * * @param string|array $file The file/s * * @return array The file paths */ protected static function getFiles($file) { if (empty($file)) { throw new InvalidArgumentException('There is not any file defined'); } if (is_string($file)) { if (!is_file($file)) { throw new InvalidArgumentException("'$file' is not a valid file"); } if (!is_readable($file)) { throw new InvalidArgumentException("'$file' is not a readable file"); } return [$file]; } if (is_array($file)) { $files = []; foreach ($file as $f) { $files = array_merge($files, static::getFiles($f)); } return $files; } throw new InvalidArgumentException('The first argument must be string or array'); } /** * Reads and returns the content of a file. * * @param string $file * * @return string */ protected static function readFile($file) { $length = filesize($file); if (!($fd = fopen($file, 'rb'))) { throw new Exception("Cannot read the file '$file', probably permissions"); } $content = $length ? fread($fd, $length) : ''; fclose($fd); return $content; } } <?php namespace Gettext\Extractors; use Gettext\Translations; interface ExtractorInterface { /** * Extract the translations from a file. * * @param array|string $file A path of a file or files * @param Translations $translations The translations instance to append the new translations. * @param array $options */ public static function fromFile($file, Translations $translations, array $options = []); /** * Parses a string and append the translations found in the Translations instance. * * @param string $string * @param Translations $translations * @param array $options */ public static function fromString($string, Translations $translations, array $options = []); } <?php namespace Gettext\Extractors; use Gettext\Translations; use Twig_Loader_Array; use Twig_Environment; use Twig_Source; use Twig_Extensions_Extension_I18n; /** * Class to get gettext strings from twig files returning arrays. */ class Twig extends Extractor implements ExtractorInterface { public static $options = [ 'extractComments' => 'notes:', 'twig' => null, ]; /** * {@inheritdoc} */ public static function fromString($string, Translations $translations, array $options = []) { $options += static::$options; $twig = $options['twig'] ?: static::createTwig(); PhpCode::fromString($twig->compileSource(new Twig_Source($string, '')), $translations, $options); } /** * Returns a Twig instance. * * @return Twig_Environment */ protected static function createTwig() { $twig = new Twig_Environment(new Twig_Loader_Array(['' => ''])); $twig->addExtension(new Twig_Extensions_Extension_I18n()); return static::$options['twig'] = $twig; } } <?php namespace Gettext\Extractors; use Exception; use Gettext\Translations; use Gettext\Utils\FunctionsScanner; /** * Class to get gettext strings from php files returning arrays. */ class PhpCode extends Extractor implements ExtractorInterface, ExtractorMultiInterface { public static $options = [ // - false: to not extract comments // - empty string: to extract all comments // - non-empty string: to extract comments that start with that string // - array with strings to extract comments format. 'extractComments' => false, 'constants' => [], 'functions' => [ 'gettext' => 'gettext', '__' => 'gettext', 'ngettext' => 'ngettext', 'n__' => 'ngettext', 'pgettext' => 'pgettext', 'p__' => 'pgettext', 'dgettext' => 'dgettext', 'd__' => 'dgettext', 'dngettext' => 'dngettext', 'dn__' => 'dngettext', 'dpgettext' => 'dpgettext', 'dp__' => 'dpgettext', 'npgettext' => 'npgettext', 'np__' => 'npgettext', 'dnpgettext' => 'dnpgettext', 'dnp__' => 'dnpgettext', 'noop' => 'noop', 'noop__' => 'noop', ], ]; protected static $functionsScannerClass = 'Gettext\Utils\PhpFunctionsScanner'; /** * {@inheritdoc} * @throws Exception */ public static function fromString($string, Translations $translations, array $options = []) { static::fromStringMultiple($string, [$translations], $options); } /** * @inheritDoc * @throws Exception */ public static function fromStringMultiple($string, array $translations, array $options = []) { $options += static::$options; /** @var FunctionsScanner $functions */ $functions = new static::$functionsScannerClass($string); if ($options['extractComments'] !== false) { $functions->enableCommentsExtraction($options['extractComments']); } $functions->saveGettextFunctions($translations, $options); } /** * @inheritDoc */ public static function fromFileMultiple($file, array $translations, array $options = []) { foreach (static::getFiles($file) as $file) { $options['file'] = $file; static::fromStringMultiple(static::readFile($file), $translations, $options); } } /** * Decodes a T_CONSTANT_ENCAPSED_STRING string. * * @param string $value * * @return string */ public static function convertString($value) { if (strpos($value, '\\') === false) { return substr($value, 1, -1); } if ($value[0] === "'") { return strtr(substr($value, 1, -1), ['\\\\' => '\\', '\\\'' => '\'']); } $value = substr($value, 1, -1); return preg_replace_callback( '/\\\(n|r|t|v|e|f|\$|"|\\\|x[0-9A-Fa-f]{1,2}|u{[0-9a-f]{1,6}}|[0-7]{1,3})/', function ($match) { switch ($match[1][0]) { case 'n': return "\n"; case 'r': return "\r"; case 't': return "\t"; case 'v': return "\v"; case 'e': return "\e"; case 'f': return "\f"; case '$': return '$'; case '"': return '"'; case '\\': return '\\'; case 'x': return chr(hexdec(substr($match[1], 1))); case 'u': return static::unicodeChar(hexdec(substr($match[1], 1))); default: return chr(octdec($match[1])); } }, $value ); } /** * @param $dec * @return string|null * @see http://php.net/manual/en/function.chr.php#118804 */ protected static function unicodeChar($dec) { if ($dec < 0x80) { return chr($dec); } if ($dec < 0x0800) { return chr(0xC0 + ($dec >> 6)) . chr(0x80 + ($dec & 0x3f)); } if ($dec < 0x010000) { return chr(0xE0 + ($dec >> 12)) . chr(0x80 + (($dec >> 6) & 0x3f)) . chr(0x80 + ($dec & 0x3f)); } if ($dec < 0x200000) { return chr(0xF0 + ($dec >> 18)) . chr(0x80 + (($dec >> 12) & 0x3f)) . chr(0x80 + (($dec >> 6) & 0x3f)) . chr(0x80 + ($dec & 0x3f)); } return null; } } <?php namespace Gettext\Extractors; use Gettext\Translations; use Illuminate\Filesystem\Filesystem; use Illuminate\View\Compilers\BladeCompiler; /** * Class to get gettext strings from blade.php files returning arrays. */ class Blade extends Extractor implements ExtractorInterface { /** * {@inheritdoc} */ public static function fromString($string, Translations $translations, array $options = []) { if (empty($options['facade'])) { $cachePath = empty($options['cachePath']) ? sys_get_temp_dir() : $options['cachePath']; $bladeCompiler = new BladeCompiler(new Filesystem(), $cachePath); if (method_exists($bladeCompiler, 'withoutComponentTags')) { $bladeCompiler->withoutComponentTags(); } $string = $bladeCompiler->compileString($string); } else { $string = $options['facade']::compileString($string); } PhpCode::fromString($string, $translations, $options); } } <?php namespace Gettext\Extractors; use Gettext\Translations; use Gettext\Utils\HeadersExtractorTrait; use Gettext\Utils\CsvTrait; /** * Class to get gettext strings from csv. */ class Csv extends Extractor implements ExtractorInterface { use HeadersExtractorTrait; use CsvTrait; public static $options = [ 'delimiter' => ",", 'enclosure' => '"', 'escape_char' => "\\" ]; /** * {@inheritdoc} */ public static function fromString($string, Translations $translations, array $options = []) { $options += static::$options; $handle = fopen('php://memory', 'w'); fputs($handle, $string); rewind($handle); while ($row = static::fgetcsv($handle, $options)) { $context = array_shift($row); $original = array_shift($row); if ($context === '' && $original === '') { static::extractHeaders(array_shift($row), $translations); continue; } $translation = $translations->insert($context, $original); if (!empty($row)) { $translation->setTranslation(array_shift($row)); $translation->setPluralTranslations($row); } } fclose($handle); } } <?php /** @noinspection PhpComposerExtensionStubsInspection */ namespace Gettext\Extractors; use DOMAttr; use DOMDocument; use DOMElement; use DOMNode; use Exception; use Gettext\Translations; use Gettext\Utils\FunctionsScanner; /** * Class to get gettext strings from VueJS template files. */ class VueJs extends Extractor implements ExtractorInterface, ExtractorMultiInterface { public static $options = [ 'constants' => [], 'functions' => [ 'gettext' => 'gettext', '__' => 'gettext', 'ngettext' => 'ngettext', 'n__' => 'ngettext', 'pgettext' => 'pgettext', 'p__' => 'pgettext', 'dgettext' => 'dgettext', 'd__' => 'dgettext', 'dngettext' => 'dngettext', 'dn__' => 'dngettext', 'dpgettext' => 'dpgettext', 'dp__' => 'dpgettext', 'npgettext' => 'npgettext', 'np__' => 'npgettext', 'dnpgettext' => 'dnpgettext', 'dnp__' => 'dnpgettext', 'noop' => 'noop', 'noop__' => 'noop', ], ]; protected static $functionsScannerClass = 'Gettext\Utils\JsFunctionsScanner'; /** * @inheritDoc * @throws Exception */ public static function fromFileMultiple($file, array $translations, array $options = []) { foreach (static::getFiles($file) as $file) { $options['file'] = $file; static::fromStringMultiple(static::readFile($file), $translations, $options); } } /** * @inheritdoc * @throws Exception */ public static function fromString($string, Translations $translations, array $options = []) { static::fromStringMultiple($string, [$translations], $options); } /** * @inheritDoc * @throws Exception */ public static function fromStringMultiple($string, array $translations, array $options = []) { $options += static::$options; $options += [ // HTML attribute prefixes we parse as JS which could contain translations (are JS expressions) 'attributePrefixes' => [ ':', 'v-bind:', 'v-on:', 'v-text', ], // HTML Tags to parse 'tagNames' => [ 'translate', ], // HTML tags to parse when attribute exists 'tagAttributes' => [ 'v-translate', ], // Comments 'commentAttributes' => [ 'translate-comment', ], 'contextAttributes' => [ 'translate-context', ], // Attribute with plural content 'pluralAttributes' => [ 'translate-plural', ], ]; // Ok, this is the weirdest hack, but let me explain: // On Linux (Mac is fine), when converting HTML to DOM, new lines get trimmed after the first tag. // So if there are new lines between <template> and next element, they are lost // So we insert a "." which is a text node, and it will prevent that newlines are stripped between elements. // Same thing happens between template and script tag. $string = str_replace('<template>', '<template>.', $string); $string = str_replace('</template>', '</template>.', $string); // Normalize newlines $string = str_replace(["\r\n", "\n\r", "\r"], "\n", $string); // VueJS files are valid HTML files, we will operate with the DOM here $dom = static::convertHtmlToDom($string); $script = static::extractScriptTag($string); // Parse the script part as a regular JS code if ($script) { $scriptLineNumber = $dom->getElementsByTagName('script')->item(0)->getLineNo(); static::getScriptTranslationsFromString( $script, $translations, $options, $scriptLineNumber - 1 ); } // Template part is parsed separately, all variables will be extracted // and handled as a regular JS code $template = $dom->getElementsByTagName('template')->item(0); if ($template) { static::getTemplateTranslations( $template, $translations, $options, $template->getLineNo() - 1 ); } } /** * Extracts script tag contents using regex instead of DOM operations. * If we parse using DOM, some contents may change, for example, tags within strings will be stripped * * @param $string * @return bool|string */ protected static function extractScriptTag($string) { if (preg_match('#<\s*?script\b[^>]*>(.*?)</script\b[^>]*>#s', $string, $matches)) { return $matches[1]; } return ''; } /** * @param string $html * @return DOMDocument */ protected static function convertHtmlToDom($html) { $dom = new DOMDocument; libxml_use_internal_errors(true); // Prepend xml encoding so DOMDocument document handles UTF8 correctly. // Assuming that vue template files will not have any xml encoding tags, because duplicate tags may be ignored. $dom->loadHTML('<?xml encoding="utf-8"?>' . $html); libxml_clear_errors(); return $dom; } /** * Extract translations from script part * * @param string $scriptContents Only script tag contents, not the whole template * @param Translations|Translations[] $translations One or multiple domain Translation objects * @param array $options * @param int $lineOffset Number of lines the script is offset in the vue template file * @throws Exception */ protected static function getScriptTranslationsFromString( $scriptContents, $translations, array $options = [], $lineOffset = 0 ) { /** @var FunctionsScanner $functions */ $functions = new static::$functionsScannerClass($scriptContents); $options['lineOffset'] = $lineOffset; $functions->saveGettextFunctions($translations, $options); } /** * Parse template to extract all translations (element content and dynamic element attributes) * * @param DOMNode $dom * @param Translations|Translations[] $translations One or multiple domain Translation objects * @param array $options * @param int $lineOffset Line number where the template part starts in the vue file * @throws Exception */ protected static function getTemplateTranslations( DOMNode $dom, $translations, array $options, $lineOffset = 0 ) { // Build a JS string from all template attribute expressions $fakeAttributeJs = static::getTemplateAttributeFakeJs($options, $dom); // 1 line offset is necessary because parent template element was ignored when converting to DOM static::getScriptTranslationsFromString($fakeAttributeJs, $translations, $options, $lineOffset); // Build a JS string from template element content expressions $fakeTemplateJs = static::getTemplateFakeJs($dom); static::getScriptTranslationsFromString($fakeTemplateJs, $translations, $options, $lineOffset); static::getTagTranslations($options, $dom, $translations); } /** * @param array $options * @param DOMNode $dom * @param Translations|Translations[] $translations */ protected static function getTagTranslations(array $options, DOMNode $dom, $translations) { // Since tag scanning does not support domains, we always use the first translation given $translations = is_array($translations) ? reset($translations) : $translations; $children = $dom->childNodes; for ($i = 0; $i < $children->length; $i++) { $node = $children->item($i); if (!($node instanceof DOMElement)) { continue; } $translatable = false; if (in_array($node->tagName, $options['tagNames'], true)) { $translatable = true; } $attrList = $node->attributes; $context = null; $plural = ""; $comment = null; for ($j = 0; $j < $attrList->length; $j++) { /** @var DOMAttr $domAttr */ $domAttr = $attrList->item($j); // Check if this is a dynamic vue attribute if (in_array($domAttr->name, $options['tagAttributes'])) { $translatable = true; } if (in_array($domAttr->name, $options['contextAttributes'])) { $context = $domAttr->value; } if (in_array($domAttr->name, $options['pluralAttributes'])) { $plural = $domAttr->value; } if (in_array($domAttr->name, $options['commentAttributes'])) { $comment = $domAttr->value; } } if ($translatable) { $translation = $translations->insert($context, trim($node->textContent), $plural); $translation->addReference($options['file'], $node->getLineNo()); if ($comment) { $translation->addExtractedComment($comment); } } if ($node->hasChildNodes()) { static::getTagTranslations($options, $node, $translations); } } } /** * Extract JS expressions from element attribute bindings (excluding text within elements) * For example: <span :title="__('extract this')"> skip element content </span> * * @param array $options * @param DOMNode $dom * @return string JS code */ protected static function getTemplateAttributeFakeJs(array $options, DOMNode $dom) { $expressionsByLine = static::getVueAttributeExpressions($options['attributePrefixes'], $dom); if (empty($expressionsByLine)) { return ''; } $maxLines = max(array_keys($expressionsByLine)); $fakeJs = ''; for ($line = 1; $line <= $maxLines; $line++) { if (isset($expressionsByLine[$line])) { $fakeJs .= implode("; ", $expressionsByLine[$line]); } $fakeJs .= "\n"; } return $fakeJs; } /** * Loop DOM element recursively and parse out all dynamic vue attributes which are basically JS expressions * * @param array $attributePrefixes List of attribute prefixes we parse as JS (may contain translations) * @param DOMNode $dom * @param array $expressionByLine [lineNumber => [jsExpression, ..], ..] * @return array [lineNumber => [jsExpression, ..], ..] */ protected static function getVueAttributeExpressions( array $attributePrefixes, DOMNode $dom, array &$expressionByLine = [] ) { $children = $dom->childNodes; for ($i = 0; $i < $children->length; $i++) { $node = $children->item($i); if (!($node instanceof DOMElement)) { continue; } $attrList = $node->attributes; for ($j = 0; $j < $attrList->length; $j++) { /** @var DOMAttr $domAttr */ $domAttr = $attrList->item($j); // Check if this is a dynamic vue attribute if (static::isAttributeMatching($domAttr->name, $attributePrefixes)) { $line = $domAttr->getLineNo(); $expressionByLine += [$line => []]; $expressionByLine[$line][] = $domAttr->value; } } if ($node->hasChildNodes()) { $expressionByLine = static::getVueAttributeExpressions($attributePrefixes, $node, $expressionByLine); } } return $expressionByLine; } /** * Check if this attribute name should be parsed for translations * * @param string $attributeName * @param string[] $attributePrefixes * @return bool */ protected static function isAttributeMatching($attributeName, $attributePrefixes) { foreach ($attributePrefixes as $prefix) { if (strpos($attributeName, $prefix) === 0) { return true; } } return false; } /** * Extract JS expressions from within template elements (excluding attributes) * For example: <span :title="skip attributes"> {{__("extract element content")}} </span> * * @param DOMNode $dom * @return string JS code */ protected static function getTemplateFakeJs(DOMNode $dom) { $fakeJs = ''; $lines = explode("\n", $dom->textContent); // Build a fake JS file from template by extracting JS expressions within each template line foreach ($lines as $line) { $expressionMatched = static::parseOneTemplateLine($line); $fakeJs .= implode("; ", $expressionMatched) . "\n"; } return $fakeJs; } /** * Match JS expressions in a template line * * @param string $line * @return string[] */ protected static function parseOneTemplateLine($line) { $line = trim($line); if (!$line) { return []; } $regex = '#\{\{(.*?)\}\}#'; preg_match_all($regex, $line, $matches); $matched = array_map(function ($v) { return trim($v, '\'"{}'); }, $matches[1]); return $matched; } } <?php namespace Gettext\Extractors; use Gettext\Translations; use Gettext\Utils\MultidimensionalArrayTrait; use Symfony\Component\Yaml\Yaml as YamlParser; /** * Class to get gettext strings from yaml. */ class Yaml extends Extractor implements ExtractorInterface { use MultidimensionalArrayTrait; /** * {@inheritdoc} */ public static function fromString($string, Translations $translations, array $options = []) { $messages = YamlParser::parse($string); if (is_array($messages)) { static::fromArray($messages, $translations); } } } <?php namespace Gettext\Extractors; use Gettext\Translations; use Gettext\Translation; use SimpleXMLElement; /** * Class to get gettext strings from xliff format. */ class Xliff extends Extractor implements ExtractorInterface { public static $options = [ 'unitid_as_id' => false ]; /** * {@inheritdoc} */ public static function fromString($string, Translations $translations, array $options = []) { $options += static::$options; $xml = new SimpleXMLElement($string, null, false); foreach ($xml->file as $file) { if (isset($file->notes)) { foreach ($file->notes->note as $note) { $translations->setHeader($note['id'], (string) $note); } } foreach ($file->unit as $unit) { foreach ($unit->segment as $segment) { $targets = []; foreach ($segment->target as $target) { $targets[] = (string) $target; } $translation = $translations->createNewTranslation(null, (string) $segment->source); if (isset($unit['id'])) { $unitId = (string) $unit['id']; $translation->addComment("XLIFF_UNIT_ID: $unitId"); if ($options['unitid_as_id']) { $translation->setId($unitId); } } $translation->setTranslation(array_shift($targets)); $translation->setPluralTranslations($targets); if (isset($unit->notes)) { foreach ($unit->notes->note as $note) { switch ($note['category']) { case 'context': $translation = $translation->getClone((string) $note); break; case 'extracted-comment': $translation->addExtractedComment((string) $note); break; case 'flag': $translation->addFlag((string) $note); break; case 'reference': $ref = explode(':', (string) $note, 2); $translation->addReference($ref[0], isset($ref[1]) ? $ref[1] : null); break; default: $translation->addComment((string) $note); break; } } } $translations[] = $translation; } } } } } <?php namespace Gettext\Extractors; use Gettext\Translations; interface ExtractorMultiInterface { /** * Parses a string and append the translations found in the Translations instance. * Allows scanning for multiple domains at a time (each Translation has to have a different domain) * * @param string $string * @param Translations[] $translations * @param array $options */ public static function fromStringMultiple($string, array $translations, array $options = []); /** * Parses a string and append the translations found in the Translations instance. * Allows scanning for multiple domains at a time (each Translation has to have a different domain) * * @param $file * @param Translations[] $translations * @param array $options */ public static function fromFileMultiple($file, array $translations, array $options = []); } <?php namespace Gettext\Extractors; use BadMethodCallException; use Gettext\Translations; use Gettext\Utils\MultidimensionalArrayTrait; /** * Class to get gettext strings from php files returning arrays. */ class PhpArray extends Extractor implements ExtractorInterface { use MultidimensionalArrayTrait; /** * {@inheritdoc} */ public static function fromFile($file, Translations $translations, array $options = []) { foreach (static::getFiles($file) as $file) { static::fromArray(include($file), $translations); } } /** * {@inheritdoc} */ public static function fromString($string, Translations $translations, array $options = []) { throw new BadMethodCallException('PhpArray::fromString() cannot be called. Use PhpArray::fromFile()'); } } <?php namespace Gettext\Extractors; use Gettext\Translations; use Gettext\Utils\HeadersExtractorTrait; use Gettext\Utils\CsvTrait; /** * Class to get gettext strings from csv. */ class CsvDictionary extends Extractor implements ExtractorInterface { use HeadersExtractorTrait; use CsvTrait; public static $options = [ 'delimiter' => ",", 'enclosure' => '"', 'escape_char' => "\\" ]; /** * {@inheritdoc} */ public static function fromString($string, Translations $translations, array $options = []) { $options += static::$options; $handle = fopen('php://memory', 'w'); fputs($handle, $string); rewind($handle); while ($row = static::fgetcsv($handle, $options)) { list($original, $translation) = $row + ['', '']; if ($original === '') { static::extractHeaders($translation, $translations); continue; } $translations->insert(null, $original)->setTranslation($translation); } fclose($handle); } } <?php namespace Gettext\Extractors; use Gettext\Translations; use Gettext\Utils\DictionaryTrait; use Symfony\Component\Yaml\Yaml as YamlParser; /** * Class to get gettext strings from yaml. */ class YamlDictionary extends Extractor implements ExtractorInterface { use DictionaryTrait; /** * {@inheritdoc} */ public static function fromString($string, Translations $translations, array $options = []) { $messages = YamlParser::parse($string); if (is_array($messages)) { static::fromArray($messages, $translations); } } } <?php namespace Gettext\Extractors; use Exception; use Gettext\Translations; use Gettext\Utils\FunctionsScanner; /** * Class to get gettext strings from javascript files. */ class JsCode extends Extractor implements ExtractorInterface, ExtractorMultiInterface { public static $options = [ 'constants' => [], 'functions' => [ 'gettext' => 'gettext', '__' => 'gettext', 'ngettext' => 'ngettext', 'n__' => 'ngettext', 'pgettext' => 'pgettext', 'p__' => 'pgettext', 'dgettext' => 'dgettext', 'd__' => 'dgettext', 'dngettext' => 'dngettext', 'dn__' => 'dngettext', 'dpgettext' => 'dpgettext', 'dp__' => 'dpgettext', 'npgettext' => 'npgettext', 'np__' => 'npgettext', 'dnpgettext' => 'dnpgettext', 'dnp__' => 'dnpgettext', 'noop' => 'noop', 'noop__' => 'noop', ], ]; protected static $functionsScannerClass = 'Gettext\Utils\JsFunctionsScanner'; /** * @inheritdoc * @throws Exception */ public static function fromString($string, Translations $translations, array $options = []) { static::fromStringMultiple($string, [$translations], $options); } /** * @inheritDoc * @throws Exception */ public static function fromStringMultiple($string, array $translations, array $options = []) { $options += static::$options; /** @var FunctionsScanner $functions */ $functions = new static::$functionsScannerClass($string); $functions->saveGettextFunctions($translations, $options); } /** * @inheritDoc * @throws Exception */ public static function fromFileMultiple($file, array $translations, array $options = []) { foreach (static::getFiles($file) as $file) { $options['file'] = $file; static::fromStringMultiple(static::readFile($file), $translations, $options); } } } <?php namespace Gettext\Extractors; use Gettext\Translations; use Gettext\Utils\DictionaryTrait; /** * Class to get gettext strings from plain json. */ class JsonDictionary extends Extractor implements ExtractorInterface { use DictionaryTrait; /** * {@inheritdoc} */ public static function fromString($string, Translations $translations, array $options = []) { $messages = json_decode($string, true); if (is_array($messages)) { static::fromArray($messages, $translations); } } } <?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Formatter; /** * Compact formatter. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Compact extends Base { /** * New line character * * @var string */ protected $newLine = ""; /** * Indentation character * * @var string */ protected $indentation = ""; /** * Boolean that indicates if operators must be surrounded by spaces * * @var bool */ protected $spacesAroundOperators = false; /** * Boolean that indicates if blocks of code must be wrapped in curly * brackets also if they contain only one instruction * * @var bool */ protected $alwaysWrapBlocks = false; /** * Boolean that indicates if comments must be rendered * * @var bool */ protected $renderComments = false; }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Formatter; /** * Pretty print formatter. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class PrettyPrint extends Base { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Formatter; /** * Compact formatter. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Expanded extends Base { /** * Boolean that indicates if open curly brackets in code blocks must be * on a new line * * @var bool */ protected $newLineBeforeCurlyBracket = true; /** * Boolean that indicates if content inside round brackets must be * surrounded by spaces * * @var bool */ protected $spacesInsideRoundBrackets = true; }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Formatter; /** * Base class for formatters, all the formatters must extend this class. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @abstract */ abstract class Base { /** * New line character * * @var string */ protected $newLine = "\n"; /** * Indentation character * * @var string */ protected $indentation = "\t"; /** * Boolean that indicates if open curly brackets in code blocks must be * on a new line * * @var bool */ protected $newLineBeforeCurlyBracket = false; /** * Boolean that indicates if blocks of code must be wrapped in curly * brackets also if they contain only one instruction * * @var bool */ protected $alwaysWrapBlocks = true; /** * Boolean that indicates if operators must be surrounded by spaces * * @var bool */ protected $spacesAroundOperators = true; /** * Boolean that indicates if content inside round brackets must be * surrounded by spaces * * @var bool */ protected $spacesInsideRoundBrackets = false; /** * Boolean that indicates if comments must be rendered * * @var bool */ protected $renderComments = true; /** * Boolean that indicates if multiline documentation comments * (for example JSDoc syntax) must be manipulated to match the * right indentation * * @var bool */ protected $recalcCommentsIndent = true; /** * Class constructor * * @param bool $renderComments True to render the comments if * the parser has collected them * and the formatter allows their * rendering */ public function __construct($renderComments = false) { if ($this->renderComments) { $this->renderComments = $renderComments; } } /** * Returns the new line character * * @return string */ public function getNewLine() { return $this->newLine; } /** * Returns the indentation character * * @return string */ public function getIndentation() { return $this->indentation; } /** * Returns a boolean that indicates if open curly brackets in code blocks * must be on a new line * * @return bool */ public function getNewLineBeforeCurlyBracket() { return $this->newLineBeforeCurlyBracket; } /** * Returns a boolean that indicates if blocks of code must be wrapped in * curly brackets also if they contain only one instruction * * @return bool */ public function getAlwaysWrapBlocks() { return $this->alwaysWrapBlocks; } /** * Returns a boolean that indicates if operators must be surrounded by * spaces * * @return bool */ public function getSpacesAroundOperator() { return $this->spacesAroundOperators; } /** * Returns a boolean that indicates if content inside round brackets must be * surrounded by spaces * * @return bool */ public function getSpacesInsideRoundBrackets() { return $this->spacesInsideRoundBrackets; } /** * Returns a boolean that indicates if comments must be rendered * * @return bool */ public function getRenderComments() { return $this->renderComments; } /** * Returns a boolean that indicates if multiline documentation comments * (for example JSDoc syntax) must be manipulated to match the * right indentation * * @return bool */ public function getRecalcCommentsIndent() { return $this->recalcCommentsIndent; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast; use Peast\Syntax\Node\Comment; /** * Nodes renderer class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Renderer { /** * Formatter to use for the rendering * * @var Formatter\Base */ protected $formatter; /** * Rendering options taken from the formatter * * @var object */ protected $renderOpts; /** * Node types that does not require semicolon insertion * * @var array */ protected $noSemicolon = array( "ClassDeclaration", "ExportDefaultDeclaration", "ForInStatement", "ForOfStatement", "ForStatement", "FunctionDeclaration", "IfStatement", "LabeledStatement", "StaticBlock", "SwitchStatement", "TryStatement", "WhileStatement", "WithStatement", "MethodDefinition" ); /** * Sets the formatter to use for the rendering * * @param Formatter\Base $formatter Formatter * * @return $this */ public function setFormatter(Formatter\Base $formatter) { $this->formatter = $formatter; $this->renderOpts = (object) array( "nl" => $this->formatter->getNewLine(), "ind" => $this->formatter->getIndentation(), "nlbc" => $this->formatter->getNewLineBeforeCurlyBracket(), "sao" => $this->formatter->getSpacesAroundOperator() ? " " : "", "sirb" => $this->formatter->getSpacesInsideRoundBrackets() ? " " : "", "awb" => $this->formatter->getAlwaysWrapBlocks(), "com" => $this->formatter->getRenderComments(), "rci" => $this->formatter->getRecalcCommentsIndent() ); return $this; } /** * Returns the formatter to use for the rendering * * @return Formatter\Base */ public function getFormatter() { return $this->formatter; } /** * Renders the given node * * @param Syntax\Node\Node $node Node to render * * @return string * * @throws \Exception */ public function render(Syntax\Node\Node $node) { //Throw exception if no formatter has been specified if (!$this->formatter) { throw new \Exception("Formatter not set"); } //Reset indentation level $this->renderOpts->indLevel = 0; //Start rendering return $this->renderNode($node); } /** * Renders a node * * @param Syntax\Node\Node $node Node to render * @param bool $addSemicolon True to add semicolon after node * rendered code * * @return string */ protected function renderNode(Syntax\Node\Node $node, $addSemicolon = false) { $code = ""; if ($this->renderOpts->com) { $code .= $this->renderComments($node); } $type = $node->getType(); switch ($type) { case "ArrayExpression": case "ArrayPattern": $code .= "[" . $this->joinNodes( $node->getElements(), "," . $this->renderOpts->sao ) . "]"; break; case "ArrowFunctionExpression": if ($node->getAsync()) { $code .= "async" . $this->renderOpts->sao; } $code .= "(" . $this->renderOpts->sirb . $this->joinNodes( $node->getParams(), "," . $this->renderOpts->sao ) . $this->renderOpts->sirb . ")" . $this->renderOpts->sao . "=>"; $body = $node->getBody(); if ($body->getType() !== "BlockStatement") { $code .= $this->renderOpts->sao . $this->renderNode($body); } else { $code .= $this->renderStatementBlock($node, $body, true); } break; case "AwaitExpression": $code .= "await " . $this->renderNode($node->getArgument()); break; case "AssignmentExpression": case "AssignmentPattern": case "BinaryExpression": case "LogicalExpression": $operator = $type === "AssignmentPattern" ? "=" : $node->getOperator(); $code .= $this->renderNode($node->getLeft()); $codeRight = $this->renderNode($node->getRight()); if (preg_match("#^[a-z]+$#i", $operator)) { $code .= " " . $operator . " "; } else { //If there's no space around the operator, additional checks must //be performed to prevent errors when rendering unary and update //expressions inside binary expressions $checkSpace = !$this->renderOpts->sao && $type === "BinaryExpression"; //The space is mandatory if the left part ends with the same //character used as operator if ($checkSpace && $code && substr($code, -1) === $operator) { $code .= " "; } $code .= $this->renderOpts->sao . $operator . $this->renderOpts->sao; //The space is mandatory if the right part begins with the same //character used as operator if ($checkSpace && $codeRight && $codeRight[0] === $operator) { $code .= " "; } } $code .= $codeRight; break; case "BlockStatement": case "ClassBody": case "Program": $code .= $this->renderStatementBlock( $node, $node->getBody(), false, false, true, false ); break; case "BreakStatement": case "ContinueStatement": $code .= $type === "BreakStatement" ? "break" : "continue"; if ($label = $node->getLabel()) { $code .= " " . $this->renderNode($label); } break; case "CallExpression": case "NewExpression": if ($type === "NewExpression") { $code .= "new "; $optional = false; } else { $optional = $node->getOptional(); } $code .= $this->renderNode($node->getCallee()) . ($optional ? "?." : "") . "(" . $this->renderOpts->sirb . $this->joinNodes( $node->getArguments(), "," . $this->renderOpts->sao ) . $this->renderOpts->sirb . ")"; break; case "CatchClause": $code .= "catch"; if ($params = $node->getParam()) { $code .= $this->renderOpts->sao . "(" . $this->renderOpts->sirb . $this->renderNode($params) . $this->renderOpts->sirb . ")"; } $code .= $this->renderStatementBlock($node, $node->getBody(), true); break; case "ChainExpression": case "ExpressionStatement": $code .= $this->renderNode($node->getExpression()); break; case "ClassExpression": case "ClassDeclaration": $code .= "class"; if ($id = $node->getId()) { $code .= " " . $this->renderNode($id); } if ($superClass = $node->getSuperClass()) { $code .= " extends " . $this->renderNode($superClass); } $code .= $this->renderStatementBlock( $node, $node->getBody(), true ); break; case "ConditionalExpression": $code .= $this->renderNode($node->getTest()) . $this->renderOpts->sao . "?" . $this->renderOpts->sao . $this->renderNode($node->getConsequent()) . $this->renderOpts->sao . ":" . $this->renderOpts->sao . $this->renderNode($node->getAlternate()); break; case "DebuggerStatement": $code .= "debugger"; break; case "DoWhileStatement": $code .= "do" . $this->renderStatementBlock( $node, $node->getBody(), null, true ) . $this->renderOpts->sao . "while" . $this->renderOpts->sao . "(" . $this->renderOpts->sirb . $this->renderNode($node->getTest()) . $this->renderOpts->sirb . ")"; break; case "JSXEmptyExpression": case "EmptyStatement": break; case "ExportAllDeclaration": $code .= "export *"; $exported = $node->getExported(); if ($exported) { $code .= " as " . $this->renderNode($exported); } $code .= " from " . $this->renderNode($node->getSource()); $code .= $this->renderImportAttributes($node); break; case "ExportDefaultDeclaration": $declaration = $node->getDeclaration(); $code .= "export default " . $this->renderNode($declaration); if ($this->requiresSemicolon($declaration)) { $code .= ";"; } break; case "ExportNamedDeclaration": $code .= "export"; if ($dec = $node->getDeclaration()) { $code .= " " . $this->renderNode($dec); } else { $code .= $this->renderOpts->sao . "{" . $this->joinNodes( $node->getSpecifiers(), "," . $this->renderOpts->sao ) . "}"; if ($source = $node->getSource()) { $code .= $this->renderOpts->sao . "from " . $this->renderNode($source); } $code .= $this->renderImportAttributes($node); } break; case "ExportSpecifier": $local = $this->renderNode($node->getLocal()); $ref = $this->renderNode($node->getExported()); $code .= $local === $ref ? $local : $local . " as " . $ref; break; case "ForInStatement": case "ForOfStatement": //Force single line mode for substatements $this->renderOpts->forceSingleLine = true; $code .= "for" . ($type === "ForOfStatement" && $node->getAwait() ? " await" : "") . $this->renderOpts->sao . "(" . $this->renderOpts->sirb . $this->renderNode($node->getLeft()) . " " . ($type === "ForInStatement" ? "in" : "of") . " " . $this->renderNode($node->getRight()) . $this->renderOpts->sirb . ")" . $this->renderStatementBlock($node, $node->getBody()); unset($this->renderOpts->forceSingleLine); break; case "ForStatement": //Force single line mode for substatements $this->renderOpts->forceSingleLine = true; $code .= "for" . $this->renderOpts->sao . "(" . $this->renderOpts->sirb; if ($init = $node->getInit()) { $code .= $this->renderNode($init); } $code .= ";" . $this->renderOpts->sao; if ($test = $node->getTest()) { $code .= $this->renderNode($test); } $code .= ";" . $this->renderOpts->sao; if ($update = $node->getUpdate()) { $code .= $this->renderNode($update); } $code .= $this->renderOpts->sirb . ")" . $this->renderStatementBlock($node, $node->getBody()); unset($this->renderOpts->forceSingleLine); break; case "FunctionDeclaration": case "FunctionExpression": $id = $node->getId(); if ($node->getAsync()) { $code .= "async "; } $code .= "function"; if ($node->getGenerator()) { $code .= $this->renderOpts->sao . "*"; } elseif ($id) { $code .= " "; } if ($id) { if ($node->getGenerator()) { $code .= $this->renderOpts->sao; } $code .= $this->renderNode($id); } $code .= $this->renderOpts->sao . "(" . $this->renderOpts->sirb . $this->joinNodes( $node->getParams(), "," . $this->renderOpts->sao ) . $this->renderOpts->sirb . ")" . $this->renderStatementBlock($node, $node->getBody(), true); break; case "ImportExpression": $options = $node->getOptions(); $code .= "import(" . $this->renderOpts->sirb . $this->renderNode($node->getSource()) . ( $options ? "," . $this->renderOpts->sao . $this->renderNode($options) : "" ) . $this->renderOpts->sirb . ")"; break; case "JSXIdentifier": case "Identifier": $code .= $node->getRawName(); break; case "IfStatement": $code .= "if" . $this->renderOpts->sao . "(" . $this->renderOpts->sirb . $this->renderNode($node->getTest()) . $this->renderOpts->sirb . ")"; $code .= $this->renderStatementBlock( $node, $node->getConsequent() ); if ($alternate = $node->getAlternate()) { $code .= $this->renderOpts->sao . "else" . $this->renderStatementBlock( $node, $alternate, null, true ); } break; case "ImportAttribute": $code .= $this->renderNode($node->getKey()) . ":" . $this->renderOpts->sao . $this->renderNode($node->getValue()); break; case "ImportDeclaration": $code .= "import "; $specifiers = $node->getSpecifiers(); if (count($specifiers)) { $sep = "," . $this->renderOpts->sao; $groups = $parts = array(); foreach ($specifiers as $spec) { $specType = $spec->getType(); if (!isset($groups[$specType])) { $groups[$specType] = array(); } $groups[$specType][] = $spec; } if (isset($groups["ImportDefaultSpecifier"])) { foreach ($groups["ImportDefaultSpecifier"] as $s) { $parts[] = $this->renderNode($s); } } if (isset($groups["ImportNamespaceSpecifier"])) { foreach ($groups["ImportNamespaceSpecifier"] as $s) { $parts[] = $this->renderNode($s); } } if (isset($groups["ImportSpecifier"])) { $impSpec = array(); foreach ($groups["ImportSpecifier"] as $s) { $impSpec[] = $this->renderNode($s); } $parts[] = "{" . implode($sep, $impSpec) . "}"; } $code .= implode($sep, $parts) . " from "; } $code .= $this->renderNode($node->getSource()); $code .= $this->renderImportAttributes($node); break; case "ImportDefaultSpecifier": $code .= $this->renderNode($node->getLocal()); break; case "ImportNamespaceSpecifier": $code .= "* as " . $this->renderNode($node->getLocal()); break; case "ImportSpecifier": $local = $this->renderNode($node->getLocal()); $ref = $this->renderNode($node->getImported()); $code .= $local === $ref ? $local : $ref . " as " . $local; break; case "JSXAttribute": $code .= $this->renderNode($node->getName()); if ($value = $node->getValue()) { $code .= "=" . $this->renderNode($value); } break; case "JSXClosingElement": $code .= "</" . $this->renderNode($node->getName()) . ">"; break; case "JSXClosingFragment": $code .= "</>"; break; case "JSXElement": $code .= $this->renderNode($node->getOpeningElement()) . $this->joinNodes($node->getChildren(), ""); if ($closing = $node->getClosingElement()) { $code .= $this->renderNode($closing); } break; case "JSXExpressionContainer": $code .= "{" . $this->renderNode($node->getExpression()) . "}"; break; case "JSXFragment": $code .= $this->renderNode($node->getOpeningFragment()) . $this->joinNodes($node->getChildren(), "") . $this->renderNode($node->getClosingFragment()); break; case "JSXNamespacedName": $code .= $this->renderNode($node->getNamespace()) . ":" . $this->renderNode($node->getName()); break; case "JSXOpeningElement": $code .= "<" . $this->renderNode($node->getName()); $attributes = $node->getAttributes(); if (count($attributes)) { $code .= " " . $this->joinNodes($attributes, " "); } if ($node->getSelfClosing()) { $code .= "/"; } $code .= ">"; break; case "JSXOpeningFragment": $code .= "<>"; break; case "JSXSpreadAttribute": $code .= "{..." . $this->renderNode($node->getArgument()) . "}"; break; case "JSXSpreadChild": $code .= "{..." . $this->renderNode($node->getExpression()) . "}"; break; case "LabeledStatement": $body = $node->getBody(); $code .= $this->renderNode($node->getLabel()) . ":"; if ($body->getType() === "BlockStatement") { $code .= $this->renderStatementBlock($node, $body, true); } else { $code .= $this->renderOpts->nl . $this->getIndentation() . $this->renderNode($body); } if ($this->requiresSemicolon($body)) { $code .= ";"; } break; case "JSXText": case "Literal": case "RegExpLiteral": $code .= $node->getRaw(); break; case "JSXMemberExpression": case "MemberExpression": $property = $node->getProperty(); $compiledProperty = $this->renderNode($property); $code .= $this->renderNode($node->getObject()); $optional = false; if ($type === "MemberExpression") { $optional = $node->getOptional(); } $propertyType = $property->getType(); if ($type === "MemberExpression" && ($node->getComputed() || ($propertyType !== "Identifier" && $propertyType !== "PrivateIdentifier"))) { $code .= ($optional ? "?." : "") . "[" . $compiledProperty . "]"; } else { $code .= ($optional ? "?." : ".") . $compiledProperty; } break; case "MetaProperty": $code .= $node->getMeta() . "." . $node->getProperty(); break; case "MethodDefinition": if ($node->getStatic()) { $code .= "static "; } $value = $node->getValue(); $key = $node->getKey(); $kind = $node->getKind(); if ($kind === $node::KIND_GET || $kind === $node::KIND_SET) { $code .= $kind . " "; } else { if ($value->getAsync()) { $code .= "async "; } if ($value->getGenerator()) { $code .= "*" . $this->renderOpts->sao; } } if ($node->getComputed()) { $code .= "[" . $this->renderNode($key) . "]"; } else { $code .= $this->renderNode($key); } $code .= $this->renderOpts->sao . preg_replace("/^[^(]+/", "", $this->renderNode($value)); break; case "ObjectExpression": $currentIndentation = $this->getIndentation(); $this->renderOpts->indLevel++; $indentation = $this->getIndentation(); //Handle single line mode if (isset($this->renderOpts->forceSingleLine)) { $start = $end = ""; $separator = "," . $this->renderOpts->sao; } else { $end = $this->renderOpts->nl . $currentIndentation; $start = $this->renderOpts->nl . $indentation; $separator = "," . $this->renderOpts->nl . $indentation; } $code .= "{"; $properties = $node->getProperties(); if (count($properties)) { $code .= $start . $this->joinNodes( $properties, $separator ) . $end; } $code .= "}"; $this->renderOpts->indLevel--; break; case "ObjectPattern": $code .= "{" . $this->joinNodes( $node->getProperties(), "," . $this->renderOpts->sao ) . "}"; break; case "ParenthesizedExpression": $code .= "(" . $this->renderOpts->sirb . $this->renderNode($node->getExpression()) . $this->renderOpts->sirb . ")"; break; case "PrivateIdentifier": $code .= "#" . $node->getName(); break; case "Property": $value = $node->getValue(); $key = $node->getKey(); $compiledKey = $this->renderNode($key); $compiledValue = $this->renderNode($value); $keyType = $key->getType(); $valueType = $value->getType(); if ($valueType === "AssignmentPattern" && $compiledKey === $this->renderNode($value->getLeft())) { $code .= $compiledValue; } else { $kind = $node->getKind(); $getterSetter = $kind === $node::KIND_GET || $kind === $node::KIND_SET; if ($getterSetter) { $code .= $kind . " "; } elseif ($value->getType() === "FunctionExpression" && $value->getGenerator()) { $code .= "*" . $this->renderOpts->sao; } if ($node->getMethod() && $value->getAsync()) { $code .= "async "; } if ($node->getComputed()) { $code .= "[" . $compiledKey . "]"; } else { $code .= $compiledKey; } if ($node->getMethod() || $getterSetter) { $code .= $this->renderOpts->sao . preg_replace("/^[^(]+/", "", $compiledValue); } elseif ($keyType !== "Identifier" || $valueType !== "Identifier" || $compiledKey !== $compiledValue ) { $code .= ($node->getShorthand() ? "=" : ":") . $this->renderOpts->sao . $compiledValue; } } break; case "PropertyDefinition": if ($node->getStatic()) { $code .= "static "; } $compiledKey = $this->renderNode($node->getKey()); if ($node->getComputed()) { $code .= "[" . $compiledKey . "]"; } else { $code .= $compiledKey; } if ($value = $node->getValue()) { $code .= $this->renderOpts->sao . "=" . $this->renderOpts->sao . $this->renderNode($value); } break; case "RestElement": case "SpreadElement": $code .= "..." . $this->renderNode($node->getArgument()); break; case "ReturnStatement": $code .= "return"; if ($argument = $node->getArgument()) { $code .= " " . $this->renderNode($argument); } break; case "SequenceExpression": $code .= $this->joinNodes( $node->getExpressions(), "," . $this->renderOpts->sao ); break; case "StaticBlock": $code .= "static"; $code .= $this->renderStatementBlock($node, $node->getBody(), true); break; case "Super": $code .= "super"; break; case "SwitchCase": if ($test = $node->getTest()) { $code .= "case " . $this->renderNode($test); } else { $code .= "default"; } $code .= ":"; if (count($node->getConsequent())) { $code .= $this->renderStatementBlock( $node, $node->getConsequent() ); } break; case "SwitchStatement": $code .= "switch" . $this->renderOpts->sao . "(" . $this->renderOpts->sirb . $this->renderNode($node->getDiscriminant()) . $this->renderOpts->sirb . ")" . $this->renderStatementBlock( $node, $node->getCases(), true, false, false ); break; case "TaggedTemplateExpression": $code .= $this->renderNode($node->getTag()) . $this->renderNode($node->getQuasi()); break; case "TemplateElement": $code .= $node->getRawValue(); break; case "TemplateLiteral": $code .= "`"; foreach ($node->getParts() as $part) { if ($part->getType() === "TemplateElement") { $code .= $this->renderNode($part); } else { $code .= "$" . "{" . $this->renderNode($part) . "}"; } } $code .= "`"; break; case "ThisExpression": $code .= "this"; break; case "ThrowStatement": $code .= "throw " . $this->renderNode($node->getArgument()); break; case "TryStatement": $code .= "try" . $this->renderStatementBlock($node, $node->getBlock(), true); if ($handler = $node->getHandler()) { $code .= $this->renderOpts->sao . $this->renderNode($handler); } if ($finalizer = $node->getFinalizer()) { $code .= $this->renderOpts->sao . "finally" . $this->renderStatementBlock($node, $finalizer, true); } break; case "UnaryExpression": case "UpdateExpression": $prefix = $node->getPrefix(); if ($prefix) { $code .= $node->getOperator(); if (preg_match("#^[a-z]+$#i", $node->getOperator())) { $code .= " "; } } $code .= $this->renderNode($node->getArgument()); if (!$prefix) { $code .= $node->getOperator(); } break; case "VariableDeclaration": $this->renderOpts->indLevel++; $indentation = $this->getIndentation(); //Handle single line mode if (isset($this->renderOpts->forceSingleLine)) { $separator = "," . $this->renderOpts->sao; } else { $separator = "," . $this->renderOpts->nl . $indentation; } $code .= $node->getKind() . " " . $this->joinNodes( $node->getDeclarations(), $separator ); $this->renderOpts->indLevel--; break; case "VariableDeclarator": $code .= $this->renderNode($node->getId()); if ($init = $node->getInit()) { $code .= $this->renderOpts->sao . "=" . $this->renderOpts->sao . $this->renderNode($init); } break; case "WhileStatement": $code .= "while" . $this->renderOpts->sao . "(" . $this->renderOpts->sirb . $this->renderNode($node->getTest()) . $this->renderOpts->sirb . ")" . $this->renderStatementBlock($node, $node->getBody()); break; case "WithStatement": $code .= "with" . $this->renderOpts->sao . "(" . $this->renderOpts->sirb . $this->renderNode($node->getObject()) . $this->renderOpts->sirb . ")" . $this->renderStatementBlock($node, $node->getBody()); break; case "YieldExpression": $code .= "yield"; if ($node->getDelegate()) { $code .= " *"; } if ($argument = $node->getArgument()) { $code .= " " . $this->renderNode($argument); } break; } if ($addSemicolon) { $code .= ";"; } if ($this->renderOpts->com) { $code .= $this->renderComments($node, false); } return $code; } /** * Renders a node as a block statement * * @param Syntax\Node\Node $parent Parent node * @param Syntax\Node\Node|array $node Node or array of * nodes to render * @param bool $forceBrackets Overrides brackets * inserting rules * @param bool $mandatorySeparator True if a starting * separator is * mandatory * @param bool $addSemicolons Semicolons are * inserted automatically * if this parameter is * not false * @param bool $incIndent If false indentation * level won't be * incremented * * @return string */ protected function renderStatementBlock( $parent, $node, $forceBrackets = null, $mandatorySeparator = false, $addSemicolons = true, $incIndent = true ) { $code = ""; //If node is an array with only one element, handle it as a single node if (is_array($node) && count($node) === 1) { $node = $node[0]; } //Special handling of BlockStatement and ClassBody nodes by rendering //their child nodes $origNode = null; if (!is_array($node) && in_array($node->getType(), array("BlockStatement", "ClassBody"))) { $origNode = $node; $node = $node->getBody(); } //If $forceBrackets is not null use its value to override curly brackets //insertion rules if ($forceBrackets !== null) { $hasBrackets = $forceBrackets; } else { //Insert curly brackets if needed $hasBrackets = $this->needsBrackets($parent, $node); } $currentIndentation = $this->getIndentation(); //If the node must be wrapped in curly braces a separator defined by formatter //must be inserted if ($hasBrackets) { if ($this->renderOpts->nlbc) { $code .= $this->renderOpts->nl . $currentIndentation; } else { $code .= $this->renderOpts->sao; } } //Move the content of the SwitchCase content to a new line if brackets won't //be inserted, in this way it's not rendered on the same line of the "case" elseif ($parent->getType() === "SwitchCase") { $code .= $this->renderOpts->nl; } $emptyBody = is_array($node) && !count($node); if ($this->renderOpts->com && $origNode) { $code .= $this->renderComments($origNode, true, !$emptyBody); } //Insert open curly bracket if required if ($hasBrackets) { $code .= "{" . $this->renderOpts->nl; } elseif ($mandatorySeparator) { //If bracket is not inserted but a separator is still required //a space is added $code .= " "; } //Increase indentation level if ($incIndent) { $this->renderOpts->indLevel++; } $subIndentation = $this->getIndentation(); //Render the node or the array of nodes if (is_array($node)) { if (!$emptyBody) { $code .= $subIndentation . $this->joinNodes( $node, $this->renderOpts->nl . $subIndentation, $addSemicolons ); } } else { $code .= $subIndentation . $this->renderNode( $node, $addSemicolons && $this->requiresSemicolon($node) ); } if ($this->renderOpts->com) { //Strip last new line and indentations added by comments rendering if (!$emptyBody) { $code = $this->trimEmptyLine($code); } if ($origNode) { $code .= $this->renderComments($origNode, false, !$emptyBody); if (!$emptyBody) { $code = $this->trimEmptyLine($code); } } } //Reset the indentation level if ($incIndent) { $this->renderOpts->indLevel--; } //Insert closing curly bracket if required if ($hasBrackets) { //Add a new line if something was rendered if (!$emptyBody) { $code .= $this->renderOpts->nl; } $code .= $currentIndentation . "}"; } return $code; } /** * Joins an array of nodes with the given separator * * @param array $nodes Nodes * @param string $separator Separator * @param bool $addSemicolons True to add semicolons after each node * * @return string */ protected function joinNodes($nodes, $separator, $addSemicolons=false) { $parts = array(); foreach ($nodes as $node) { if (!$node) { $code = ""; } else { $code = $this->renderNode( $node, $addSemicolons && $this->requiresSemicolon($node) ); } $parts[] = $code; } return implode($separator, $parts); } /** * Check if the node or the array of nodes need brackets to be rendered * * @param Syntax\Node\Node $parent Parent node * @param Syntax\Node\Node|array $node Node or array of * nodes to render * * @return bool */ protected function needsBrackets($parent, $node) { $parentType = $parent->getType(); //The SwitchCase content needs brackets if it contains let or const declarations $inSwitchCase = $parentType === "SwitchCase"; //Except for SwitchCase, brackets are needed if the formatter requires them or whenever //there are 0 or multiple nodes to render if (!$inSwitchCase && ($this->renderOpts->awb || (is_array($node) && count($node) !== 1))) { return true; } if (!is_array($node)) { $node = array($node); } $addBrackets = false; $optBracketNodes = array( "DoWhileStatement", "ForInStatement", "ForOfStatement", "ForStatement", "WhileStatement", "WithStatement" ); //An IfStatement requires brackets if it contains let or const declarations and if it has the "else" part //and contains another IfStatement with "else" $inIfWithElse = $parentType === "IfStatement" && $parent->getAlternate(); $checkFn = function ($n) use ($inIfWithElse, $optBracketNodes, &$addBrackets) { $type = $n->getType(); if ($inIfWithElse && $type === "IfStatement") { if (!$n->getAlternate()) { $addBrackets = true; } return Traverser::DONT_TRAVERSE_CHILD_NODES; } elseif ($type === "BlockStatement") { if (count($n->getBody()) !== 1) { return Traverser::DONT_TRAVERSE_CHILD_NODES; } } elseif ($inIfWithElse && $type === "LabeledStatement") { if ($n->getBody()->getType() === "BlockStatement") { $addBrackets = true; } return Traverser::DONT_TRAVERSE_CHILD_NODES; } elseif ($type === "VariableDeclaration") { if (in_array($n->getKind(), array($n::KIND_LET, $n::KIND_CONST))) { $addBrackets = true; } return Traverser::DONT_TRAVERSE_CHILD_NODES; } elseif (!in_array($type, $optBracketNodes)) { return Traverser::DONT_TRAVERSE_CHILD_NODES; } }; //Traverse every node but stop whenever the $addBrackets variable becomes true foreach ($node as $n) { $n->traverse($checkFn); if ($addBrackets) { break; } } return $addBrackets; } /** * Render node's comments * * @param Syntax\Node\Node $node Node * @param bool $leading False to render trailing comments * @param bool|null $blockContent This paramater can have 3 values: * - null: the node is not a block * - false: the node is an empty block * - true: the node is a block with content * * @return string */ protected function renderComments($node, $leading = true, $blockContent = null) { $code = ""; $fn = $leading ? "getLeadingComments" : "getTrailingComments"; $comments = $node ? $node->$fn() : array(); $numComments = count($comments); if ($numComments) { $lastFormatted = $blockContent === false ? true : $leading; $refNode = $node; $refKey = $leading ? "end" : "start"; $refNodeKey = $leading ? "start" : "end"; $indent = $this->getIndentation(); foreach ($comments as $k => $comment) { $lastComment = $k === $numComments - 1; $isMultilineComment = $comment->getKind() === Comment::KIND_MULTILINE; // Check if the comment must be formatted with new line and indentations $format = true; if ( $refNode && $isMultilineComment && $comment->location && $refNode->location && $comment->location->$refKey->getLine() === $refNode->location->$refNodeKey->getLine() ) { $format = false; } //If the last comment wasn't formatted but this one must be formatted, add the new //line and the indentation if ($format && !$lastFormatted) { $code .= $this->renderOpts->nl . $indent; } //Leading comments on empty blocks must render the initial indentation if format //is enabled if ($format && $blockContent === false && !$k) { $code .= $indent; } $commentRaw = $comment->getRawText(); //Reindent multiline comments if necessary if ($isMultilineComment && $indent && $this->renderOpts->rci) { $commentRaw = preg_replace("/^\s+\*/m", $indent . " *", $commentRaw); } $code .= $commentRaw; //If format is enabled, add the new line character and the indentation if the node //is not an empty block or the it's not the last comment if ($format && ($blockContent !== true || !$lastComment || !$isMultilineComment)) { //For non multiline comments the new line is mandatory, even if the formatter //disables it $code .= !$isMultilineComment && !$this->renderOpts->nl ? "\n" : $this->renderOpts->nl; //Last comment on blocks must not render indentation if ($blockContent === null || !$lastComment) { $code .= $indent; } } $refNode = $comment; $lastFormatted = $format; } } return $code; } /** * Render import attributes of the given node * * @param Syntax\Node\Node $node Node * * @return string */ protected function renderImportAttributes($node) { $code = ""; if (count($node->getAttributes())) { $code .= " with" . $this->renderOpts->sao . "{" . $this->joinNodes( $node->getAttributes(), "," . $this->renderOpts->sao ) . "}"; } return $code; } /** * Removes an empty line at the end of the given code, if present * * @param string $code Code * * @return string */ protected function trimEmptyLine($code) { if ($this->renderOpts->nl) { $nl = preg_quote($this->renderOpts->nl, "/"); $indent = preg_quote($this->getIndentation(), "/"); $code = preg_replace("/$nl(?:$indent)?$/", "", $code); } return $code; } /** * Check if the given node requires semicolons insertion * * @param Syntax\Node\Node $node Node * * @return bool */ protected function requiresSemicolon($node) { return !in_array($node->getType(), $this->noSemicolon); } /** * Returns the current indentation string * * @return string */ protected function getIndentation() { return str_repeat( $this->renderOpts->ind, $this->renderOpts->indLevel ); } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Selector; /** * Selector exception class. Syntax errors in selectors are thrown * using this exception class. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Exception extends \Exception { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Selector; /** * Selector parser class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Parser { /** * Selector string * * @var string */ protected $selector; /** * Current parser index * * @var int */ protected $index = 0; /** * Selector length * * @var int */ protected $length; /** * Whitespaces * * @var array */ protected $whitespaces = array(" ", "\t", "\n", "\r", "\f"); /** * Combinators * * @var array */ protected $combinators = array(">", "+", "~"); /** * Attribute selector operator characters * * @var array */ protected $attrOperatorChars = array("=", "<", ">", "^", "$", "*"); /** * Attribute selector operators * * @var array */ protected $attrOperators = array("=", "<", ">", "<=", ">=", "^=", "$=", "*="); /** * Valid pseudo selectors. The value indicates the argument type: * - 0: no arguments * - 1: index formula (An+B syntax) * - 2: selector * @var array */ protected $validPseudo = array( "pattern" => 0, "statement" => 0, "expression" => 0, "declaration" => 0, "first-child" => 0, "last-child" => 0, "nth-child" => 1, "nth-last-child" => 1, "has" => 2, "is" => 2, "not" => 2 ); /** * Class constructor * * @param string $selector Selector string * @param array $options Options array. See Query class * documentation for available options */ public function __construct($selector, $options = array()) { $encoding = isset($options["encoding"]) ? $options["encoding"] : null; if ($encoding && !preg_match("/UTF-?8/i", $encoding)) { $selector = mb_convert_encoding($selector, "UTF-8", $encoding); } $this->selector = $selector; $this->length = strlen($selector); } /** * Starts the parsing and returns the parsed selector * * @param bool $filter True if the selector must be used for a filter * * @return Node\Selector * * @throws Exception */ public function parse($filter = false) { $selector = $this->parseSelector($filter); //Throw an exception if the end has not been reached if (($char = $this->getChar()) !== null) { throw new Exception("Invalid syntax '$char'"); } return $selector; } /** * Parses a selector * * @param bool $filter True if the selector must be used for a filter * * @return Node\Selector * * @throws Exception */ public function parseSelector($filter = false) { $selector = new Node\Selector; do { $first = true; $group = new Node\Group; while (true) { $combinator = $this->consumeCombinator(); if (!$first && !$combinator) { break; } $parts = $this->parseSelectorParts(); if (!count($parts)) { throw new Exception("Missing selector after combinator"); } $first = false; $selCombinator = new Node\Combinator; $selCombinator->setOperator( $combinator ?: ($filter ? null : " ") ); foreach ($parts as $part) { $selCombinator->addPart($part); } $group->addCombinator($selCombinator); } $selector->addGroup($group); $this->consumeWhitespaces(); } while ($this->consume(",")); return $selector; } /** * Parses a set of selector pats * * @return array * * @throws Exception */ protected function parseSelectorParts() { $parts = array(); while (true) { if ( ($part = $this->parseSelectorPartType()) || ($part = $this->parseSelectorPartAttribute()) || ($part = $this->parseSelectorPartPseudo()) ) { $parts[] = $part; } else { break; } } return $parts; } /** * Parses a type selector part * * @return Node\Part\Type|null */ protected function parseSelectorPartType() { $type = $this->consumeWord(); if ($type) { $part = new Node\Part\Type; $part->setType($type); return $part; } return null; } /** * Parses an attribute selector part * * @return Node\Part\Attribute|null * * @throws Exception */ protected function parseSelectorPartAttribute() { if (!$this->consume("[")) { return null; } $this->consumeWhitespaces(); $part = new Node\Part\Attribute; if (!($name = $this->consumeWord())) { throw new Exception("Missing attribute name"); } $part->addName($name); while ($this->consume(".")) { if (!($name = $this->consumeWord())) { throw new Exception("Missing attribute name after dot"); } $part->addName($name); } $this->consumeWhitespaces(); $operator = $this->consumeAny($this->attrOperatorChars); if ($operator) { if (!in_array($operator, $this->attrOperators)) { throw new Exception("Invalid attribute operator '$operator'"); } $part->setOperator($operator); $this->consumeWhitespaces(); if (!($value = $this->parseLiteral())) { throw new Exception("Missing attribute value"); } $part->setValue($value[0]); if ($value[1]) { if ($operator != "=") { throw new Exception( "Only '=' operator is valid for attribute regex match" ); } $part->setRegex(true); } $this->consumeWhitespaces(); if ($this->consume("i")) { if (!is_string($value[0]) || $value[1]) { throw new Exception( "Case insensitive flag can be used only for string values" ); } $part->setCaseInsensitive(true); $this->consumeWhitespaces(); } } if (!$this->consume("]")) { throw new Exception("Unterminated attribute selector"); } return $part; } /** * Parses a pseudo selector part * * @return Node\Part\Pseudo|null * * @throws Exception */ protected function parseSelectorPartPseudo() { if (!$this->consume(":")) { return null; } $name = $this->consumeWord("-"); if (!isset($this->validPseudo[$name])) { throw new Exception("Unsupported pseudo selector '$name'"); } $argsType = $this->validPseudo[$name]; $error = false; if ($argsType === 1) { $part = new Node\Part\PseudoIndex; if (!$this->consume("(")) { $error = true; } if (!$error) { $this->consumeWhitespaces(); if ($indices = $this->consumeRegex("-?\d*n(?:\+\d+)?|\d+")) { $indices = explode("n", $indices); if (count($indices) === 1) { $part->setOffset((int) $indices[0]); } else { switch ($indices[0]) { case "": $part->setStep(1); break; case "-": $part->setStep(-1); break; default: $part->setStep((int) $indices[0]); break; } if ($indices[1] !== "") { $part->setOffset((int) $indices[1]); } } } elseif ( ($word = $this->consumeWord()) && ($word === "even" || $word === "odd") ) { $part->setStep(2); if ($word === "odd") { $part->setOffset(1); } } else { $error = true; } $this->consumeWhitespaces(); if (!$error && !$this->consume(")")) { $error = true; } } } elseif ($argsType === 2) { $part = new Node\Part\PseudoSelector; if ( $this->consume("(") && ($selector = $this->parseSelector($name !== "has")) && $this->consume(")") ) { $part->setSelector($selector); } else { $error = true; } } else { $part = new Node\Part\PseudoSimple; } if ($error) { throw new Exception( "Invalid argument for pseudo selector '$name'" ); } $part->setName($name); return $part; } /** * Parses a literal value * * @return array|null * * @throws Exception */ protected function parseLiteral() { if ( ($literal = $this->parseLiteralBoolNull()) !== 0 || ($literal = $this->parseLiteralString()) !== null || ($literal = $this->parseLiteralNumber()) !== null ) { return array($literal, false); } elseif ($literal = $this->parseLiteralRegex()) { return array($literal, true); } return null; } /** * Parses a literal boolean or null value * * @return int|bool|null * * @throws Exception */ protected function parseLiteralBoolNull() { $word = $this->consumeWord(); if (!$word) { return 0; } elseif ($word === "true") { return true; } elseif ($word === "false") { return false; } elseif ($word === "null") { return null; } throw new Exception("Invalid attribute value '$word'"); } /** * Parses a literal string * * @return string|null * * @throws Exception */ protected function parseLiteralString() { if (!($quote = $this->consumeAny(array("'", '"'), true))) { return null; } if (($str = $this->consumeUntil($quote)) === null) { throw new Exception("Unterminated string in attribute value"); } return $str; } /** * Parses a literal number * * @return int|float|null */ protected function parseLiteralNumber() { if ( $this->getChar() === "0" && ($val = $this->consumeRegex("0[xX][a-fA-F]+|0[bB][01]+|0[oO][0-7]+")) ) { $form = strtolower($val[1]); $val = substr($val, 2); if ($form === "x") { return hexdec($val); } elseif ($form === "o") { return octdec($val); } return bindec($val); } $reg = "-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?|-?\.\d+(?:[eE][+-]?\d+)?"; if (!($val = $this->consumeRegex($reg))) { return null; } return (float) $val; } /** * Parses a literal regex * * @return string|null * * @throws Exception */ protected function parseLiteralRegex() { if (!($sep = $this->consume("/"))) { return null; } if (($reg = $this->consumeUntil($sep, false, true)) === null) { throw new Exception("Unterminated regex in attribute value"); } $modifiers = $this->consumeWord(); return $sep . $reg . ($modifiers ?: ""); } /** * Consumes the given regex * * @param string $regex Regex to consume * * @return mixed|null */ protected function consumeRegex($regex) { if ($this->getChar() === null) { return null; } if (!preg_match("#^($regex)#", substr($this->selector, $this->index), $matches)) { return null; } $this->index += strlen($matches[1]); return $matches[1]; } /** * Consumes all the characters until the given one is reached * * @param string $stop Stop character * @param bool $removeEscapes If false escape characters won't be removed * @param false $includeStop If true stop character will be returned * * @return string|null */ protected function consumeUntil($stop, $removeEscapes = true, $includeStop = false) { $buffer = ""; $escaped = false; while (($char = $this->getChar()) !== null) { $this->index += 1; if (!$escaped) { if ($char === "\\") { $escaped = true; if (!$removeEscapes) { $buffer .= $char; } continue; } elseif ($char === $stop) { if ($includeStop) { $buffer .= $char; } return $buffer; } } $buffer .= $char; $escaped = false; } return null; } /** * Consumes a word composed by characters a-z * * @param null|string $extraChar Extra character to match * * @return string */ protected function consumeWord($extraChar = null) { $buffer = ""; while ($char = $this->getChar()) { if ( ($char >= "a" && $char <= "z") || ($char >= "A" && $char <= "Z") || ($extraChar !== null && $char === $extraChar) ) { $buffer .= $char; $this->index += 1; } else { break; } } return $buffer; } /** * Consumes a combinator * * @return string|null */ protected function consumeCombinator() { //Initial ws can be trimmed if followed by another combinator $ws = $this->consumeWhitespaces(); if ($combinator = $this->consumeAny($this->combinators, true)) { $this->consumeWhitespaces(); } elseif ($ws) { //If there's no other combinators use the space $combinator = " "; } else { $combinator = null; } return $combinator; } /** * Consumes as much whitespaces as possible * * @return string */ protected function consumeWhitespaces() { return $this->consumeAny($this->whitespaces); } /** * Consumes the given characters * * @param array $chars Characters to consume * @param false $stopAtFirst If true only the first matching character * is consumed * * @return string */ protected function consumeAny($chars, $stopAtFirst = false) { $buffer = ""; while (($char = $this->getChar()) !== null) { if (in_array($char, $chars)) { $buffer .= $char; $this->index++; if ($stopAtFirst) { break; } } else { break; } } return $buffer; } /** * Consumes the current character if it is equal to the * given one * * @param string $char Character to compare * * @return string|null */ protected function consume($char) { if ($this->getChar() === $char) { $this->index++; return $char; } return null; } /** * Returns the current character or null if the end * have been reached * * @return string|null */ protected function getChar() { if ($this->index < $this->length) { return $this->selector[$this->index]; } return null; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Selector; use Peast\Syntax\Node\Node; /** * Selector matches class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Matches { /** * Matches array * * @var array */ protected $matches; /** * Class constructor * * @param array $matches Matches */ public function __construct($matches = array()) { $this->matches = $matches; } /** * Adds a new match * * @param Node $node * @param Node|null $parent */ public function addMatch(Node $node, $parent = null) { $this->matches[] = array($node, $parent); } /** * Returns the matches * * @returns array */ public function getMatches() { return $this->matches; } /** * Returns the matched nodes * * @return array */ public function getNodes() { return array_map(function ($m) { return $m[0]; }, $this->matches); } /** * Filters the matches using the given function, if it returns * a false value the match will be removed. The function will * receive the node and its parent as arguments. * * @param callable $fn Filter function * @return $this */ public function filter(callable $fn) { $newMatches = array(); foreach ($this->matches as $match) { if ($fn($match[0], $match[1])) { $newMatches[] = $match; } } $this->matches = $newMatches; return $this; } /** * Replaces all the matches with the result of the given function. * The function will receive the node and its parent as arguments * and must return an array of matches * * @param callable $fn Map function * * @return $this */ public function map(callable $fn) { $newMatches = array(); foreach ($this->matches as $match) { $res = $fn($match[0], $match[1]); if ($res) { $newMatches = array_merge($newMatches, $res); } } $this->matches = $newMatches; return $this->unique(); } /** * Merges the current object with the other given Matches objects * * @param Matches[] $matchesArr Array of Matches to merge * * @return $this */ public function merge($matchesArr) { foreach ($matchesArr as $matches) { foreach ($matches->getMatches() as $match) { $this->addMatch($match[0], $match[1]); } } return $this->unique(); } /** * Remove all duplicated matches * * @return $this */ public function unique() { $newMatches = array(); $newNodes = array(); foreach ($this->matches as $match) { if (!in_array($match[0], $newNodes, true)) { $newMatches[] = $match; $newNodes[] = $match[0]; } } $this->matches = $newMatches; return $this; } /** * Returns a clone of the current object * * @return Matches */ public function createClone() { return new self($this->matches); } /** * Returns the number of matches * * @return int */ public function count() { return count($this->matches); } /** * Returns the match at the given index * * @param int $index Index * * @return array * * @throws \Exception */ public function get($index) { $index = (int) $index; if (!isset($this->matches[$index])) { throw new \Exception("Invalid index $index"); } return $this->matches[$index]; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Selector\Node; use Peast\Selector\Matches; /** * Selector class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Selector { /** * Selector groups * * @var Group[] */ protected $groups = array(); /** * Adds a new group * * @param Group $group Group * * @return $this */ public function addGroup(Group $group) { $this->groups[] = $group; return $this; } /** * Executes the current selector on the given matches * * @param Matches $matches Matches * * @return Matches */ public function exec(Matches $matches) { $retMatches = array(); foreach ($this->groups as $group) { $clonedMatches = $matches->createClone(); $group->exec($clonedMatches); $retMatches[] = $clonedMatches; } if (count($retMatches) > 1) { $retMatches[0]->merge(array_slice($retMatches, 1)); } return $retMatches[0]; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Selector\Node; use Peast\Selector\Matches; use Peast\Syntax\Utils; use Peast\Traverser; /** * Selector combinator class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Combinator { /** * Operator * * @var string|null */ protected $operator; /** * Selector parts * * @var Part\Part[] */ protected $parts = array(); /** * Sets the operator * * @param string $operator Operator * @return $this */ public function setOperator($operator) { $this->operator = $operator; return $this; } /** * Adds a new selector part * * @param Part\Part $part Part * @return $this */ public function addPart(Part\Part $part) { $this->parts[] = $part; return $this; } /** * Executes the current group on the given matches * * @param Matches $matches Matches */ public function exec(Matches $matches) { $parts = $this->parts; //Sort the parts by priority to execute faster checks first usort($parts, function ($p1, $p2) { $pr1 = $p1->getPriority(); $pr2 = $p2->getPriority(); if ($pr1 === $pr2) { return 0; } elseif ($pr1 < $pr2) { return -1; } else { return 1; } }); $filter = function ($node, $parent) use ($parts) { foreach ($parts as $part) { if (!$part->check($node, $parent)) { return false; } } return true; }; switch ($this->operator) { case " ": case ">": $children = $this->operator === ">"; $matches->map(function ($curNode) use ($filter, $children) { $ret = array(); $curNode->traverse( function ($node, $parent) use ($filter, $children, &$ret) { if ($filter($node, $parent)) { $ret[] = array($node, $parent); } if ($children) { return Traverser::DONT_TRAVERSE_CHILD_NODES; } }, array( "skipStartingNode" => true, "passParentNode" => true ) ); return $ret; }); break; case "~": case "+": $adjacent = $this->operator === "+"; $matches->map(function ($node, $parent) use ($filter, $adjacent) { $ret = array(); $evaluate = false; $props = $parent ? Utils::getExpandedNodeProperties($parent) : array(); foreach ($props as $propNode) { if ($evaluate) { if ($propNode && $filter($propNode, $parent)) { $ret[] = array($propNode, $parent); } if ($adjacent) { break; } } elseif ($propNode === $node) { $evaluate = true; } } return $ret; }); break; default: $matches->filter($filter); break; } } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Selector\Node; use Peast\Selector\Matches; /** * Selector group class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Group { /** * Selector combinators * * @var Combinator[] */ protected $combinators = array(); /** * Adds a combinator * * @param Combinator $combinators Combinator * * @return $this */ public function addCombinator(Combinator $combinators) { $this->combinators[] = $combinators; return $this; } /** * Executes the current group on the given matches * * @param Matches $matches Matches */ public function exec(Matches $matches) { foreach ($this->combinators as $combinator) { $combinator->exec($matches); } } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Selector\Node\Part; use Peast\Syntax\Node\Node; /** * Selector part type class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Type extends Part { /** * Selector type * * @var string */ protected $type; /** * Sets the selector type * * @param string $type Type * * @return $this */ public function setType($type) { $this->type = $type; return $this; } /** * Returns true if the selector part matches the given node, * false otherwise * * @param Node $node Node * @param Node $parent Parent node * * @return bool */ public function check(Node $node, $parent = null) { return $node->getType() === $this->type; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Selector\Node\Part; use Peast\Selector\Matches; use Peast\Selector\Node\Selector; use Peast\Syntax\Node\Node; /** * Selector part selector pseudo class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class PseudoSelector extends Pseudo { /** * Priority * * @var int */ protected $priority = 1; /** * Selector * * @var Selector */ protected $selector; /** * Sets the selector * * @param Selector $selector Selector * * @return $this */ public function setSelector(Selector $selector) { $this->selector = $selector; return $this; } /** * Returns true if the selector part matches the given node, * false otherwise * * @param Node $node Node * @param Node $parent Parent node * * @return bool */ public function check(Node $node, $parent = null) { $match = new Matches(); $match->addMatch($node, $parent); $res = $this->selector->exec($match)->count(); return $this->name === "not" ? $res === 0 : $res !== 0; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Selector\Node\Part; use Peast\Syntax\Node\Node; /** * Selector part base class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @abstract */ abstract class Part { /** * Priority * * @var int */ protected $priority = 5; public function getPriority() { return $this->priority; } /** * Returns true if the selector part matches the given node, * false otherwise * * @param Node $node Node * @param Node $parent Parent node * * @return bool * * @abstract */ abstract public function check(Node $node, $parent = null); }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Selector\Node\Part; use Peast\Syntax\Node\Node; use Peast\Syntax\Utils; /** * Selector part index pseudo class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class PseudoIndex extends Pseudo { /** * Priority * * @var int */ protected $priority = 2; /** * Step * * @var int */ protected $step = 0; /** * Offset * * @var int */ protected $offset = 0; /** * Sets the step * * @param int $step Step * * @return $this */ public function setStep($step) { $this->step = $step; return $this; } /** * Sets the offset * * @param int $offset Offset * * @return $this */ public function setOffset($offset) { $this->offset = $offset; return $this; } /** * Returns true if the selector part matches the given node, * false otherwise * * @param Node $node Node * @param Node $parent Parent node * * @return bool */ public function check(Node $node, $parent = null) { $props = Utils::getExpandedNodeProperties($parent); $count = count($props); $reverse = $this->name === "nth-last-child"; if ($reverse) { $start = $count - 1 - ($this->offset - 1); $step = $this->step * -1; if ($step > 0) { $reverse = false; } } else { $start = $this->offset - 1; $step = $this->step; if ($step < 0) { $reverse = true; } } //Step 0 will cause an infinite loop, so it must be set to the //number of props so that it will execute only one iteration if (!$step) { $step = $reverse ? -$count : $count; } for ($i = $start; ($reverse && $i >= 0) || (!$reverse && $i < $count); $i += $step) { if (isset($props[$i]) && $props[$i] === $node) { return true; } } return false; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Selector\Node\Part; use Peast\Syntax\Node\Node; use Peast\Syntax\Node\Pattern; use Peast\Syntax\Node\Statement; use Peast\Syntax\Node\Expression; use Peast\Syntax\Node\Declaration; use Peast\Syntax\Utils; /** * Selector part simple pseudo class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class PseudoSimple extends Pseudo { /** * Priority * * @var int */ protected $priority = 3; /** * Returns true if the selector part matches the given node, * false otherwise * * @param Node $node Node * @param Node $parent Parent node * * @return bool */ public function check(Node $node, $parent = null) { switch ($this->name) { case "pattern": return $node instanceof Pattern; case "statement": return $node instanceof Statement; case "expression": return $node instanceof Expression; case "declaration": return $node instanceof Declaration; case "last-child": case "first-child": $first = $this->name === "first-child"; $props = Utils::getExpandedNodeProperties($parent); return count($props) > 0 && ( $first ? $props[0] === $node : array_pop($props) === $node ); } } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Selector\Node\Part; use Peast\Syntax\Node\Node; use Peast\Syntax\Utils; /** * Selector part attribute class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Attribute extends Part { /** * Priority * * @var int */ protected $priority = 4; /** * Attribute names * * @var array */ protected $names = array(); /** * Attribute match operator * * @var array */ protected $operator = null; /** * Attribute value * * @var mixed */ protected $value = null; /** * Case insensitive flag * * @var bool */ protected $caseInsensitive = false; /** * Regex flag * * @var bool */ protected $regex = false; /** * Adds a name * * @param string $name Name * * @return $this */ public function addName($name) { $this->names[] = $name; return $this; } /** * Sets the operator * * @param string $operator Operator * * @return $this */ public function setOperator($operator) { $this->operator = $operator; return $this; } /** * Sets the value * * @param mixed $value Value * * @return $this */ public function setValue($value) { $this->value = $value; return $this; } /** * Sets the case insensitive flag * * @param bool $caseInsensitive Case insensitive flag * * @return $this */ public function setCaseInsensitive($caseInsensitive) { $this->caseInsensitive = $caseInsensitive; return $this; } /** * Sets the regex flag * * @param bool $regex Regex flag * * @return $this */ public function setRegex($regex) { $this->regex = $regex; return $this; } /** * Returns true if the selector part matches the given node, * false otherwise * * @param Node $node Node * @param Node $parent Parent node * * @return bool */ public function check(Node $node, $parent = null) { $attr = $node; foreach ($this->names as $name) { $attrFound = false; if ($attr instanceof Node) { $props = Utils::getNodeProperties($attr); foreach ($props as $prop) { if ($prop["name"] === $name) { $attrFound = true; $attr = $attr->{$prop["getter"]}(); break; } } } if (!$attrFound) { return false; } } $bothStrings = is_string($attr) && is_string($this->value); switch ($this->operator) { case "=": if ($bothStrings) { if ($this->regex) { return preg_match($this->value, $attr); } return $this->compareStr( $this->value, $attr, $this->caseInsensitive, true, true ); } if (is_int($attr) && is_float($this->value)) { return (float) $attr === $this->value; } return $attr === $this->value; case "<": if (is_float($this->value) && !is_float($attr) && !is_int($attr) && !is_string($attr)) { return false; } return $attr < $this->value; case ">": if (is_float($this->value) && !is_float($attr) && !is_int($attr) && !is_string($attr)) { return false; } return $attr > $this->value; case "<=": if (is_float($this->value) && !is_float($attr) && !is_int($attr) && !is_string($attr)) { return false; } return $attr <= $this->value; case ">=": if (is_float($this->value) && !is_float($attr) && !is_int($attr) && !is_string($attr)) { return false; } return $attr >= $this->value; case "^=": case "$=": case "*=": return $this->compareStr( $this->value, $attr, $this->caseInsensitive, $this->operator === "^=", $this->operator === "$=" ); default: return true; } } /** * Compares two strings * * @param string $v1 Search value * @param string $v2 Compare value * @param bool $caseInsensitive True if the search must be case insensitive * @param bool $matchStart True if the search must be executed from the * beginning of the string * @param bool $matchEnd True if the search must be executed from the * end of the string * * @return bool */ protected function compareStr($v1, $v2, $caseInsensitive, $matchStart, $matchEnd) { $regex = "#" . ($matchStart ? "^" : "") . preg_quote($v1) . ($matchEnd ? "$" : "") . "#u" . ($caseInsensitive ? "i" : ""); return (bool) preg_match($regex, $v2); } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Selector\Node\Part; /** * Selector pseudo part base class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @abstract */ abstract class Pseudo extends Part { /** * Selector name * * @var string */ protected $name; /** * Sets the name * * @param string $name Name * * @return $this */ public function setName($name) { $this->name = $name; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast; /** * Nodes traverser class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Traverser { /** * If a function return this value, the current node will be removed */ const REMOVE_NODE = 1; /** * If a function return this value, the current node's children won't be * traversed */ const DONT_TRAVERSE_CHILD_NODES = 2; /** * If a function return this value, the traverser will stop running */ const STOP_TRAVERSING = 4; /** * Array of functions to call on each node * * @var array */ protected $functions = array(); /** * Pass parent node flag * * @var bool */ protected $passParentNode = false; /** * Skip starting node flag * * @var bool */ protected $skipStartingNode = false; /** * Class constructor. Available options are: * - skipStartingNode: if true the starting node will be skipped * - passParentNode: if true the parent node of each node will be * passed as second argument when the functions are called. Note * that the parent node is calculated during traversing, so for * the starting node it will always be null. * * @param array $options Options array */ public function __construct($options = array()) { if (isset($options["passParentNode"])) { $this->passParentNode = (bool) $options["passParentNode"]; } if (isset($options["skipStartingNode"])) { $this->skipStartingNode = (bool) $options["skipStartingNode"]; } } /** * Adds a function that will be called for each node in the tree. The * function will receive the current node as argument. The action that will * be executed on the node by the traverser depends on the returned value * of the function: * - a node: it will replace the node with the returned one * - a numeric value that is a combination of the constants defined in this * class: it will execute the function related to each constant * - an array where the first element is a node and the second element is a * numeric value that is a combination of the constants defined in this * class: it will replace the node with the returned one and it will * execute the function related to each constant (REMOVE_NODE will be * ignored since it does not make any sense in this case) * - other: nothing * * @param callable $fn Function to add * * @return $this */ public function addFunction(callable $fn) { $this->functions[] = $fn; return $this; } /** * Starts the traversing * * @param Syntax\Node\Node $node Starting node * * @return Syntax\Node\Node */ public function traverse(Syntax\Node\Node $node) { if ($this->skipStartingNode) { $this->traverseChildren($node); } else { $this->execFunctions($node); } return $node; } /** * Executes all functions on the given node and, if required, starts * traversing its children. The returned value is an array where the first * value is the node or null if it has been removed and the second value is * a boolean indicating if the traverser must continue the traversing or not * * @param Syntax\Node\Node $node Node * @param Syntax\Node\Node|null $parent Parent node * * @return array */ protected function execFunctions($node, $parent = null) { $traverseChildren = true; $continueTraversing = true; foreach ($this->functions as $fn) { $ret = $this->passParentNode ? $fn($node, $parent) : $fn($node); if ($ret) { if (is_array($ret) && $ret[0] instanceof Syntax\Node\Node) { $node = $ret[0]; if (isset($ret[1]) && is_numeric($ret[1])) { if ($ret[1] & self::DONT_TRAVERSE_CHILD_NODES) { $traverseChildren = false; } if ($ret[1] & self::STOP_TRAVERSING) { $continueTraversing = false; } } } elseif ($ret instanceof Syntax\Node\Node) { $node = $ret; } elseif (is_numeric($ret)) { if ($ret & self::DONT_TRAVERSE_CHILD_NODES) { $traverseChildren = false; } if ($ret & self::STOP_TRAVERSING) { $continueTraversing = false; } if ($ret & self::REMOVE_NODE) { $node = null; $traverseChildren = false; break; } } } } if ($traverseChildren && $continueTraversing) { $continueTraversing = $this->traverseChildren($node); } return array($node, $continueTraversing); } /** * Traverses node children. It returns a boolean indicating if the * traversing must continue or not * * @param Syntax\Node\Node $node Node * * @return bool */ protected function traverseChildren(Syntax\Node\Node $node) { $continue = true; foreach (Syntax\Utils::getNodeProperties($node, true) as $prop) { $getter = $prop["getter"]; $setter = $prop["setter"]; $child = $node->$getter(); if (!$child) { continue; } elseif (is_array($child)) { $newChildren = array(); foreach ($child as $c) { if (!$c || !$continue) { $newChildren[] = $c; } else { list($c, $continue) = $this->execFunctions($c, $node); if ($c) { $newChildren[] = $c; } } } $node->$setter($newChildren); } else { list($child, $continue) = $this->execFunctions($child, $node); $node->$setter($child); } if (!$continue) { break; } } return $continue; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast; /** * Nodes query class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Query implements \IteratorAggregate, \Countable { /** * Current matches * * @var Selector\Matches */ protected $matches; /** * Options array * * @var array */ protected $options; /** * Class constructor. Available options are: * - encoding: selectors encoding. If not specified the * parser will assume UTF-8. * * @param Syntax\Node\Program $root Root node * @param array $options Options array */ public function __construct(Syntax\Node\Program $root, $options = array()) { $this->matches = new Selector\Matches(); $this->matches->addMatch($root); $this->options = $options; } /** * Finds nodes matching the given selector starting from the * current matched nodes, if any, or from the root * * @param string $selector Selector * * @return $this * * @throws Selector\Exception */ public function find($selector) { $parser = new Selector\Parser($selector, $this->options); $selector = $parser->parse(); $this->matches = $selector->exec($this->matches); return $this; } /** * Executes the given selector on the current nodes and filters * out the nodes which don't match * * @param string $selector Selector * * @return $this * * @throws Selector\Exception */ public function filter($selector) { $parser = new Selector\Parser($selector, $this->options); $selector = $parser->parse(true); $this->matches->filter(function ($node, $parent) use ($selector) { $newMatch = new Selector\Matches(); $newMatch->addMatch($node, $parent); return $selector->exec($newMatch)->getMatches(); }); return $this; } /** * Returns the number of matched nodes * * @return int */ #[\ReturnTypeWillChange] public function count() { return $this->matches->count(); } /** * Returns the node at the given index * * @param int $index Index * * @return array * * @throws \Exception */ public function get($index) { return $this->matches->get($index)[0]; } /** * Returns the nodes iterator * * @return \ArrayIterator */ #[\ReturnTypeWillChange] public function getIterator() { return new \ArrayIterator($this->matches->getNodes()); } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax; /** * Syntax exception class. Syntax errors in the source are thrown using this * using this exception class. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Exception extends \Exception { /** * Error position * * @var Position */ protected $position; /** * Class constructor * * @param string $message Error message * @param Position $position Error position */ public function __construct($message, Position $position) { parent::__construct($message); $this->position = $position; } /** * Returns the error position * * @return Position */ public function getPosition() { return $this->position; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\ES2019; /** * ES2019 features class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Features extends \Peast\Syntax\ES2018\Features { /** * Optional catch binding * * @var bool */ public $optionalCatchBinding = true; /** * Paragraph and line separator in strings * * @var bool */ public $paragraphLineSepInStrings = true; }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax; /** * Parser class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Parser extends ParserAbstract { use JSX\Parser; //Identifier parsing mode constants /** * Everything is allowed as identifier, including keywords, null and booleans */ const ID_ALLOW_ALL = 1; /** * Keywords, null and booleans are not allowed in any situation */ const ID_ALLOW_NOTHING = 2; /** * Keywords, null and booleans are not allowed in any situation, future * reserved words are allowed if not in strict mode. Keywords that depend on * parser context are evaluated only if the parser context allows them. */ const ID_MIXED = 3; /** * Binding identifier parsing rule * * @var int */ protected static $bindingIdentifier = self::ID_MIXED; /** * Labelled identifier parsing rule * * @var int */ protected static $labelledIdentifier = self::ID_MIXED; /** * Identifier reference parsing rule * * @var int */ protected static $identifierReference = self::ID_MIXED; /** * Identifier name parsing rule * * @var int */ protected static $identifierName = self::ID_ALLOW_ALL; /** * Imported binding parsing rule * * @var int */ protected static $importedBinding = self::ID_ALLOW_NOTHING; /** * Assignment operators * * @var array */ protected $assignmentOperators = array( "=", "+=", "-=", "*=", "/=", "%=", "<<=", ">>=", ">>>=", "&=", "^=", "|=", "**=", "&&=", "||=", "??=" ); /** * Logical and binary operators * * @var array */ protected $logicalBinaryOperators = array( "??" => 0, "||" => 0, "&&" => 1, "|" => 2, "^" => 3, "&" => 4, "===" => 5, "!==" => 5, "==" => 5, "!=" => 5, "<=" => 6, ">=" => 6, "<" => 6, ">" => 6, "instanceof" => 6, "in" => 6, ">>>" => 7, "<<" => 7, ">>" => 7, "+" => 8, "-" => 8, "*" => 9, "/" => 9, "%" => 9, "**" => 10 ); /** * Unary operators * * @var array */ protected $unaryOperators = array( "delete", "void", "typeof", "++", "--", "+", "-", "~", "!" ); /** * Postfix operators * * @var array */ protected $postfixOperators = array("--", "++"); /** * Array of keywords that depends on a context property * * @var array */ protected $contextKeywords = array( "yield" => "allowYield", "await" => "allowAwait" ); /** * Initializes parser context * * @return void */ protected function initContext() { $context = array( "allowReturn" => false, "allowIn" => false, "allowYield" => false, "allowAwait" => false ); //If async/await is not enabled remove the //relative context properties if (!$this->features->asyncAwait) { unset($context["allowAwait"]); unset($this->contextKeywords["await"]); } $this->context = (object) $context; } /** * Post initialize operations * * @return void */ protected function postInit() { //Remove exponentiation operator if the feature //is not enabled if (!$this->features->exponentiationOperator) { Utils::removeArrayValue( $this->assignmentOperators, "**=" ); unset($this->logicalBinaryOperators["**"]); } //Remove coalescing operator if the feature //is not enabled if (!$this->features->coalescingOperator) { unset($this->logicalBinaryOperators["??"]); } //Remove logical assignment operators if the //feature is not enabled if (!$this->features->logicalAssignmentOperators) { foreach (array("&&=", "||=", "??=") as $op) { Utils::removeArrayValue( $this->assignmentOperators, $op ); } } } /** * Parses the source * * @return Node\Program */ public function parse() { if ($this->sourceType === \Peast\Peast::SOURCE_TYPE_MODULE) { $this->scanner->setStrictMode(true); $body = $this->parseModuleItemList(); } else { $body = $this->parseStatementList(true); } $node = $this->createNode( "Program", $body ?: $this->scanner->getPosition() ); $node->setSourceType($this->sourceType); if ($body) { $node->setBody($body); } $program = $this->completeNode($node); if ($this->scanner->getToken()) { $this->error(); } //Execute scanner end operations $this->scanner->consumeEnd(); //Emit the EndParsing event and pass the resulting program node as //event data $this->eventsEmitter && $this->eventsEmitter->fire( "EndParsing", array($program) ); return $program; } /** * Converts an expression node to a pattern node * * @param Node\Node $node The node to convert * * @return Node\Node */ protected function expressionToPattern($node) { if ($node instanceof Node\ArrayExpression) { $loc = $node->location; $elems = array(); foreach ($node->getElements() as $elem) { $elems[] = $this->expressionToPattern($elem); } $retNode = $this->createNode("ArrayPattern", $loc->start); $retNode->setElements($elems); $this->completeNode($retNode, $loc->end); } elseif ($node instanceof Node\ObjectExpression) { $loc = $node->location; $props = array(); foreach ($node->getProperties() as $prop) { $props[] = $this->expressionToPattern($prop); } $retNode = $this->createNode("ObjectPattern", $loc->start); $retNode->setProperties($props); $this->completeNode($retNode, $loc->end); } elseif ($node instanceof Node\Property) { $loc = $node->location; $retNode = $this->createNode( "AssignmentProperty", $loc->start ); // If it's a shorthand property convert the value to an assignment // pattern if necessary $value = $node->getValue(); $key = $node->getKey(); if ($value && $node->getShorthand() && !$value instanceof Node\AssignmentExpression && (!$value instanceof Node\Identifier || ( $key instanceof Node\Identifier && $key->getName() !== $value->getName() ))) { $loc = $node->location; $valNode = $this->createNode("AssignmentPattern", $loc->start); $valNode->setLeft($key); $valNode->setRight($value); $this->completeNode($valNode, $loc->end); $value = $valNode; } else { $value = $this->expressionToPattern($value); } $retNode->setValue($value); $retNode->setKey($key); $retNode->setMethod($node->getMethod()); $retNode->setShorthand($node->getShorthand()); $retNode->setComputed($node->getComputed()); $this->completeNode($retNode, $loc->end); } elseif ($node instanceof Node\SpreadElement) { $loc = $node->location; $retNode = $this->createNode("RestElement", $loc->start); $retNode->setArgument( $this->expressionToPattern($node->getArgument()) ); $this->completeNode($retNode, $loc->end); } elseif ($node instanceof Node\AssignmentExpression) { $loc = $node->location; $retNode = $this->createNode("AssignmentPattern", $loc->start); $retNode->setLeft($this->expressionToPattern($node->getLeft())); $retNode->setRight($node->getRight()); $this->completeNode($retNode, $loc->end); } else { $retNode = $node; } return $retNode; } /** * Parses a statement list * * @param bool $parseDirectivePrologues True to parse directive prologues * * @return Node\Node[]|null */ protected function parseStatementList( $parseDirectivePrologues = false ) { $items = array(); //Get directive prologues and check if strict mode is present if ($parseDirectivePrologues) { $oldStrictMode = $this->scanner->getStrictMode(); if ($directives = $this->parseDirectivePrologues()) { $items = array_merge($items, $directives[0]); //If "use strict" is present enable scanner strict mode if (in_array("use strict", $directives[1])) { $this->scanner->setStrictMode(true); } } } while ($item = $this->parseStatementListItem()) { $items[] = $item; } //Apply previous strict mode if ($parseDirectivePrologues) { $this->scanner->setStrictMode($oldStrictMode); } return count($items) ? $items : null; } /** * Parses a statement list item * * @return Node\Statement|Node\Declaration|null */ protected function parseStatementListItem() { if ($declaration = $this->parseDeclaration()) { return $declaration; } elseif ($statement = $this->parseStatement()) { return $statement; } return null; } /** * Parses a statement * * @return Node\Statement|null */ protected function parseStatement() { //Here the token value is checked for performance so that functions won't be //called if not necessary $token = $this->scanner->getToken(); if (!$token) { return null; } $val = $token->value; if ($val === "{" && $statement = $this->parseBlock()) { return $statement; } elseif ($val === "var" && $statement = $this->parseVariableStatement()) { return $statement; } elseif ($val === ";" && $statement = $this->parseEmptyStatement()) { return $statement; } elseif ($val === "if" && $statement = $this->parseIfStatement()) { return $statement; } elseif ( ($val === "for" || $val === "while" || $val === "do" || $val === "switch") && $statement = $this->parseBreakableStatement() ) { return $statement; } elseif ($val == "continue" && $statement = $this->parseContinueStatement()) { return $statement; } elseif ($val === "break" && $statement = $this->parseBreakStatement()) { return $statement; } elseif ( $this->context->allowReturn && $val === "return" && $statement = $this->parseReturnStatement() ) { return $statement; } elseif ($val === "with" && $statement = $this->parseWithStatement()) { return $statement; } elseif ($val === "throw" && $statement = $this->parseThrowStatement()) { return $statement; } elseif ($val === "try" && $statement = $this->parseTryStatement()) { return $statement; } elseif ($val === "debugger" && $statement = $this->parseDebuggerStatement()) { return $statement; } elseif ($statement = $this->parseLabelledStatement()) { return $statement; } elseif ($statement = $this->parseExpressionStatement()) { return $statement; } return null; } /** * Parses a declaration * * @return Node\Declaration|null */ protected function parseDeclaration() { //Here the token value is checked for performance so that functions won't be //called if not necessary $token = $this->scanner->getToken(); if (!$token) { return null; } $val = $token->value; if ($declaration = $this->parseFunctionOrGeneratorDeclaration()) { return $declaration; } elseif ($val === "class" && $declaration = $this->parseClassDeclaration()) { return $declaration; } elseif ( ($val === "let" || $val === "const") && $declaration = $this->isolateContext( array("allowIn" => true), "parseLexicalDeclaration" ) ) { return $declaration; } return null; } /** * Parses a breakable statement * * @return Node\Node|null */ protected function parseBreakableStatement() { if ($statement = $this->parseIterationStatement()) { return $statement; } elseif ($statement = $this->parseSwitchStatement()) { return $statement; } return null; } /** * Parses a block statement * * @return Node\BlockStatement|null */ protected function parseBlock() { if ($token = $this->scanner->consume("{")) { $statements = $this->parseStatementList(); if ($this->scanner->consume("}")) { $node = $this->createNode("BlockStatement", $token); if ($statements) { $node->setBody($statements); } return $this->completeNode($node); } $this->error(); } return null; } /** * Parses a module item list * * @return Node\Node[]|null */ protected function parseModuleItemList() { $items = array(); while ($item = $this->parseModuleItem()) { $items[] = $item; } return count($items) ? $items : null; } /** * Parses an empty statement * * @return Node\EmptyStatement|null */ protected function parseEmptyStatement() { if ($token = $this->scanner->consume(";")) { $node = $this->createNode("EmptyStatement", $token); return $this->completeNode($node); } return null; } /** * Parses a debugger statement * * @return Node\DebuggerStatement|null */ protected function parseDebuggerStatement() { if ($token = $this->scanner->consume("debugger")) { $node = $this->createNode("DebuggerStatement", $token); $this->assertEndOfStatement(); return $this->completeNode($node); } return null; } /** * Parses an if statement * * @return Node\IfStatement|null */ protected function parseIfStatement() { if ($token = $this->scanner->consume("if")) { if ($this->scanner->consume("(") && ($test = $this->isolateContext( array("allowIn" => true), "parseExpression" )) && $this->scanner->consume(")") && ( ($consequent = $this->parseStatement()) || (!$this->scanner->getStrictMode() && $consequent = $this->parseFunctionOrGeneratorDeclaration( false, false )) ) ) { $node = $this->createNode("IfStatement", $token); $node->setTest($test); $node->setConsequent($consequent); if ($this->scanner->consume("else")) { if (($alternate = $this->parseStatement()) || (!$this->scanner->getStrictMode() && $alternate = $this->parseFunctionOrGeneratorDeclaration( false, false )) ) { $node->setAlternate($alternate); return $this->completeNode($node); } } else { return $this->completeNode($node); } } $this->error(); } return null; } /** * Parses a try-catch statement * * @return Node\TryStatement|null */ protected function parseTryStatement() { if ($token = $this->scanner->consume("try")) { if ($block = $this->parseBlock()) { $node = $this->createNode("TryStatement", $token); $node->setBlock($block); if ($handler = $this->parseCatch()) { $node->setHandler($handler); } if ($finalizer = $this->parseFinally()) { $node->setFinalizer($finalizer); } if ($handler || $finalizer) { return $this->completeNode($node); } } $this->error(); } return null; } /** * Parses the catch block of a try-catch statement * * @return Node\CatchClause|null */ protected function parseCatch() { if ($token = $this->scanner->consume("catch")) { $node = $this->createNode("CatchClause", $token); if ($this->scanner->consume("(")) { if (!($param = $this->parseCatchParameter()) || !$this->scanner->consume(")")) { $this->error(); } $node->setParam($param); } elseif (!$this->features->optionalCatchBinding) { $this->error(); } if (!($body = $this->parseBlock())) { $this->error(); } $node->setBody($body); return $this->completeNode($node); } return null; } /** * Parses the catch parameter of a catch block in a try-catch statement * * @return Node\Node|null */ protected function parseCatchParameter() { if ($param = $this->parseIdentifier(static::$bindingIdentifier)) { return $param; } elseif ($param = $this->parseBindingPattern()) { return $param; } return null; } /** * Parses a finally block in a try-catch statement * * @return Node\BlockStatement|null */ protected function parseFinally() { if ($this->scanner->consume("finally")) { if ($block = $this->parseBlock()) { return $block; } $this->error(); } return null; } /** * Parses a continue statement * * @return Node\ContinueStatement|null */ protected function parseContinueStatement() { if ($token = $this->scanner->consume("continue")) { $node = $this->createNode("ContinueStatement", $token); if ($this->scanner->noLineTerminators() && ($label = $this->parseIdentifier(static::$labelledIdentifier)) ) { $node->setLabel($label); $this->assertEndOfStatement(); } else { $this->scanner->consume(";"); } return $this->completeNode($node); } return null; } /** * Parses a break statement * * @return Node\BreakStatement|null */ protected function parseBreakStatement() { if ($token = $this->scanner->consume("break")) { $node = $this->createNode("BreakStatement", $token); if ($this->scanner->noLineTerminators() && ($label = $this->parseIdentifier(static::$labelledIdentifier))) { $node->setLabel($label); $this->assertEndOfStatement(); } else { $this->scanner->consume(";"); } return $this->completeNode($node); } return null; } /** * Parses a return statement * * @return Node\ReturnStatement|null */ protected function parseReturnStatement() { if ($token = $this->scanner->consume("return")) { $node = $this->createNode("ReturnStatement", $token); if ($this->scanner->noLineTerminators()) { $argument = $this->isolateContext( array("allowIn" => true), "parseExpression" ); if ($argument) { $node->setArgument($argument); } } $this->assertEndOfStatement(); return $this->completeNode($node); } return null; } /** * Parses a labelled statement * * @return Node\LabeledStatement|null */ protected function parseLabelledStatement() { if ($label = $this->parseIdentifier(static::$labelledIdentifier, ":")) { $this->scanner->consume(":"); if (($body = $this->parseStatement()) || ($body = $this->parseFunctionOrGeneratorDeclaration( false, false )) ) { //Labelled functions are not allowed in strict mode if ($body instanceof Node\FunctionDeclaration && $this->scanner->getStrictMode()) { $this->error( "Labelled functions are not allowed in strict mode" ); } $node = $this->createNode("LabeledStatement", $label); $node->setLabel($label); $node->setBody($body); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses a throw statement * * @return Node\ThrowStatement|null */ protected function parseThrowStatement() { if ($token = $this->scanner->consume("throw")) { if ($this->scanner->noLineTerminators() && ($argument = $this->isolateContext( array("allowIn" => true), "parseExpression" )) ) { $this->assertEndOfStatement(); $node = $this->createNode("ThrowStatement", $token); $node->setArgument($argument); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses a with statement * * @return Node\WithStatement|null */ protected function parseWithStatement() { if ($token = $this->scanner->consume("with")) { if ($this->scanner->consume("(") && ($object = $this->isolateContext( array("allowIn" => true), "parseExpression" )) && $this->scanner->consume(")") && $body = $this->parseStatement() ) { $node = $this->createNode("WithStatement", $token); $node->setObject($object); $node->setBody($body); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses a switch statement * * @return Node\SwitchStatement|null */ protected function parseSwitchStatement() { if ($token = $this->scanner->consume("switch")) { if ($this->scanner->consume("(") && ($discriminant = $this->isolateContext( array("allowIn" => true), "parseExpression" )) && $this->scanner->consume(")") && ($cases = $this->parseCaseBlock()) !== null ) { $node = $this->createNode("SwitchStatement", $token); $node->setDiscriminant($discriminant); $node->setCases($cases); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses the content of a switch statement * * @return Node\SwitchCase[]|null */ protected function parseCaseBlock() { if ($this->scanner->consume("{")) { $parsedCasesAll = array( $this->parseCaseClauses(), $this->parseDefaultClause(), $this->parseCaseClauses() ); if ($this->scanner->consume("}")) { $cases = array(); foreach ($parsedCasesAll as $parsedCases) { if ($parsedCases) { if (is_array($parsedCases)) { $cases = array_merge($cases, $parsedCases); } else { $cases[] = $parsedCases; } } } return $cases; } elseif ($this->parseDefaultClause()) { $this->error( "Multiple default clause in switch statement" ); } else { $this->error(); } } return null; } /** * Parses cases in a switch statement * * @return Node\SwitchCase[]|null */ protected function parseCaseClauses() { $cases = array(); while ($case = $this->parseCaseClause()) { $cases[] = $case; } return count($cases) ? $cases : null; } /** * Parses a case in a switch statement * * @return Node\SwitchCase|null */ protected function parseCaseClause() { if ($token = $this->scanner->consume("case")) { if (($test = $this->isolateContext( array("allowIn" => true), "parseExpression" )) && $this->scanner->consume(":") ) { $node = $this->createNode("SwitchCase", $token); $node->setTest($test); if ($consequent = $this->parseStatementList()) { $node->setConsequent($consequent); } return $this->completeNode($node); } $this->error(); } return null; } /** * Parses default case in a switch statement * * @return Node\SwitchCase|null */ protected function parseDefaultClause() { if ($token = $this->scanner->consume("default")) { if ($this->scanner->consume(":")) { $node = $this->createNode("SwitchCase", $token); if ($consequent = $this->parseStatementList()) { $node->setConsequent($consequent); } return $this->completeNode($node); } $this->error(); } return null; } /** * Parses an expression statement * * @return Node\ExpressionStatement|null */ protected function parseExpressionStatement() { $lookaheadTokens = array("{", "function", "class", array("let", "[")); if ($this->features->asyncAwait) { array_splice( $lookaheadTokens, 3, 0, array(array("async", true)) ); } if (!$this->scanner->isBefore($lookaheadTokens, true) && $expression = $this->isolateContext( array("allowIn" => true), "parseExpression" ) ) { $this->assertEndOfStatement(); $node = $this->createNode("ExpressionStatement", $expression); $node->setExpression($expression); return $this->completeNode($node); } return null; } /** * Parses a do-while statement * * @return Node\DoWhileStatement|null */ protected function parseDoWhileStatement() { if ($token = $this->scanner->consume("do")) { if (($body = $this->parseStatement()) && $this->scanner->consume("while") && $this->scanner->consume("(") && ($test = $this->isolateContext( array("allowIn" => true), "parseExpression" )) && $this->scanner->consume(")") ) { $node = $this->createNode("DoWhileStatement", $token); $node->setBody($body); $node->setTest($test); $node = $this->completeNode($node); $this->scanner->consume(";"); return $node; } $this->error(); } return null; } /** * Parses a while statement * * @return Node\WhileStatement|null */ protected function parseWhileStatement() { if ($token = $this->scanner->consume("while")) { if ($this->scanner->consume("(") && ($test = $this->isolateContext( array("allowIn" => true), "parseExpression" )) && $this->scanner->consume(")") && $body = $this->parseStatement() ) { $node = $this->createNode("WhileStatement", $token); $node->setTest($test); $node->setBody($body); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses a for(var ...) statement * * @param Token $forToken Token that corresponds to the "for" keyword * * @return Node\Node|null */ protected function parseForVarStatement($forToken) { if (!($varToken = $this->scanner->consume("var"))) { return null; } $state = $this->scanner->getState(); if (($decl = $this->isolateContext( array("allowIn" => false), "parseVariableDeclarationList" )) && ($varEndPosition = $this->scanner->getPosition()) && $this->scanner->consume(";") ) { $init = $this->createNode( "VariableDeclaration", $varToken ); $init->setKind($init::KIND_VAR); $init->setDeclarations($decl); $init = $this->completeNode($init, $varEndPosition); $test = $this->isolateContext( array("allowIn" => true), "parseExpression" ); if ($this->scanner->consume(";")) { $update = $this->isolateContext( array("allowIn" => true), "parseExpression" ); if ($this->scanner->consume(")") && $body = $this->parseStatement() ) { $node = $this->createNode("ForStatement", $forToken); $node->setInit($init); $node->setTest($test); $node->setUpdate($update); $node->setBody($body); return $this->completeNode($node); } } } else { $this->scanner->setState($state); if ($decl = $this->parseForBinding()) { $init = null; if ($this->features->forInInitializer && $decl->getId()->getType() === "Identifier") { $init = $this->parseInitializer(); } if ($init) { $decl->setInit($init); $decl->location->end = $init->location->end; } $left = $this->createNode("VariableDeclaration", $varToken); $left->setKind($left::KIND_VAR); $left->setDeclarations(array($decl)); $left = $this->completeNode($left); if ($this->scanner->consume("in")) { if ($init && $this->scanner->getStrictMode()) { $this->error( "For-in variable initializer not allowed in " . "strict mode" ); } if (($right = $this->isolateContext( array("allowIn" => true), "parseExpression" )) && $this->scanner->consume(")") && $body = $this->parseStatement() ) { $node = $this->createNode( "ForInStatement", $forToken ); $node->setLeft($left); $node->setRight($right); $node->setBody($body); return $this->completeNode($node); } } elseif (!$init && $this->scanner->consume("of")) { if (($right = $this->isolateContext( array("allowIn" => true), "parseAssignmentExpression" )) && $this->scanner->consume(")") && $body = $this->parseStatement() ) { $node = $this->createNode( "ForOfStatement", $forToken ); $node->setLeft($left); $node->setRight($right); $node->setBody($body); return $this->completeNode($node); } } } } $this->error(); } /** * Parses a for(let ...) or for(const ...) statement * * @param Token $forToken Token that corresponds to the "for" keyword * * @return Node\Node|null */ protected function parseForLetConstStatement($forToken) { $afterBracketState = $this->scanner->getState(); if (!($init = $this->parseForDeclaration())) { return null; } if ($this->scanner->consume("in")) { if (($right = $this->isolateContext( array("allowIn" => true), "parseExpression" )) && $this->scanner->consume(")") && $body = $this->parseStatement() ) { $node = $this->createNode("ForInStatement", $forToken); $node->setLeft($init); $node->setRight($right); $node->setBody($body); return $this->completeNode($node); } } elseif ($this->scanner->consume("of")) { if (($right = $this->isolateContext( array("allowIn" => true), "parseAssignmentExpression" )) && $this->scanner->consume(")") && $body = $this->parseStatement() ) { $node = $this->createNode("ForOfStatement", $forToken); $node->setLeft($init); $node->setRight($right); $node->setBody($body); return $this->completeNode($node); } } else { $this->scanner->setState($afterBracketState); if ($init = $this->isolateContext( array("allowIn" => false), "parseLexicalDeclaration" ) ) { $test = $this->isolateContext( array("allowIn" => true), "parseExpression" ); if ($this->scanner->consume(";")) { $update = $this->isolateContext( array("allowIn" => true), "parseExpression" ); if ($this->scanner->consume(")") && $body = $this->parseStatement() ) { $node = $this->createNode("ForStatement", $forToken); $node->setInit($init); $node->setTest($test); $node->setUpdate($update); $node->setBody($body); return $this->completeNode($node); } } } } $this->error(); } /** * Parses a for statement that does not start with var, let or const * * @param Token $forToken Token that corresponds to the "for" keyword * @param bool $hasAwait True if "for" is followed by "await" * * @return Node\Node|null */ protected function parseForNotVarLetConstStatement($forToken, $hasAwait) { $state = $this->scanner->getState(); $notBeforeSB = !$this->scanner->isBefore(array(array("let", "[")), true); if ($notBeforeSB && (($init = $this->isolateContext( array("allowIn" => false), "parseExpression" )) || true) && $this->scanner->consume(";") ) { $test = $this->isolateContext( array("allowIn" => true), "parseExpression" ); if ($this->scanner->consume(";")) { $update = $this->isolateContext( array("allowIn" => true), "parseExpression" ); if ($this->scanner->consume(")") && $body = $this->parseStatement() ) { $node = $this->createNode("ForStatement", $forToken); $node->setInit($init); $node->setTest($test); $node->setUpdate($update); $node->setBody($body); return $this->completeNode($node); } } } else { $this->scanner->setState($state); $beforeLetAsyncOf = $this->scanner->isBefore(array("let", array("async", "of")), true); $left = $this->parseLeftHandSideExpression(); if ($left && $left->getType() === "ChainExpression") { $this->error( "Optional chain can't appear in left-hand side" ); } $left = $this->expressionToPattern($left); if ($notBeforeSB && $left && $this->scanner->consume("in")) { if (($right = $this->isolateContext( array("allowIn" => true), "parseExpression" )) && $this->scanner->consume(")") && $body = $this->parseStatement() ) { $node = $this->createNode("ForInStatement", $forToken); $node->setLeft($left); $node->setRight($right); $node->setBody($body); return $this->completeNode($node); } } elseif (($hasAwait || !$beforeLetAsyncOf) && $left && $this->scanner->consume("of") ) { if (($right = $this->isolateContext( array("allowIn" => true), "parseAssignmentExpression" )) && $this->scanner->consume(")") && $body = $this->parseStatement() ) { $node = $this->createNode("ForOfStatement", $forToken); $node->setLeft($left); $node->setRight($right); $node->setBody($body); return $this->completeNode($node); } } } $this->error(); } /** * Parses do-while, while, for, for-in and for-of statements * * @return Node\Node|null */ protected function parseIterationStatement() { if ($node = $this->parseWhileStatement()) { return $node; } elseif ($node = $this->parseDoWhileStatement()) { return $node; } elseif ($startForToken = $this->scanner->consume("for")) { $forAwait = false; if ($this->features->asyncIterationGenerators && $this->context->allowAwait && $this->scanner->consume("await") ) { $forAwait = true; } if ($this->scanner->consume("(") && ( ($node = $this->parseForVarStatement($startForToken)) || ($node = $this->parseForLetConstStatement($startForToken)) || ($node = $this->parseForNotVarLetConstStatement($startForToken, $forAwait))) ) { if ($forAwait) { if (!$node instanceof Node\ForOfStatement) { $this->error( "Async iteration is allowed only with for-of statements", $startForToken->location->start ); } $node->setAwait(true); } return $node; } $this->error(); } return null; } /** * Checks if an async function can start from the current position. Returns * the async token or null if not found * * @param bool $checkFn If false it won't check if the async keyword is * followed by "function" * * @return Token */ protected function checkAsyncFunctionStart($checkFn = true) { return ($asyncToken = $this->scanner->getToken()) && $asyncToken->value === "async" && ( !$checkFn || (($nextToken = $this->scanner->getNextToken()) && $nextToken->value === "function") ) && $this->scanner->noLineTerminators(true) ? $asyncToken : null; } /** * Parses function or generator declaration * * @param bool $default Default mode * @param bool $allowGenerator True to allow parsing of generators * * @return Node\FunctionDeclaration|null */ protected function parseFunctionOrGeneratorDeclaration( $default = false, $allowGenerator = true ) { $async = null; if ($this->features->asyncAwait && ($async = $this->checkAsyncFunctionStart())) { $this->scanner->consumeToken(); if (!$this->features->asyncIterationGenerators) { $allowGenerator = false; } } if ($token = $this->scanner->consume("function")) { $generator = $allowGenerator && $this->scanner->consume("*"); $id = $this->parseIdentifier(static::$bindingIdentifier); if ($generator || $async) { $flags = array(null); if ($generator) { $flags["allowYield"] = true; } if ($async) { $flags["allowAwait"] = true; } } else { $flags = null; } if (($default || $id) && $this->scanner->consume("(") && ($params = $this->isolateContext( $flags, "parseFormalParameterList" )) !== null && $this->scanner->consume(")") && ($tokenBodyStart = $this->scanner->consume("{")) && (($body = $this->isolateContext( $flags, "parseFunctionBody" )) || true) && $this->scanner->consume("}") ) { $body->location->start = $tokenBodyStart->location->start; $body->location->end = $this->scanner->getPosition(); $node = $this->createNode( "FunctionDeclaration", $async ?: $token ); if ($id) { $node->setId($id); } $node->setParams($params); $node->setBody($body); $node->setGenerator($generator); $node->setAsync((bool) $async); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses function or generator expression * * @return Node\FunctionExpression|null */ protected function parseFunctionOrGeneratorExpression() { $allowGenerator = true; $async = false; if ($this->features->asyncAwait && ($async = $this->checkAsyncFunctionStart())) { $this->scanner->consumeToken(); if (!$this->features->asyncIterationGenerators) { $allowGenerator = false; } } if ($token = $this->scanner->consume("function")) { $generator = $allowGenerator && $this->scanner->consume("*"); if ($generator || $async) { $flags = array(null); if ($generator) { $flags["allowYield"] = true; } if ($async) { $flags["allowAwait"] = true; } } else { $flags = null; } $id = $this->isolateContext( $flags, "parseIdentifier", array(static::$bindingIdentifier) ); if ($this->scanner->consume("(") && ($params = $this->isolateContext( $flags, "parseFormalParameterList" )) !== null && $this->scanner->consume(")") && ($tokenBodyStart = $this->scanner->consume("{")) && (($body = $this->isolateContext( $flags, "parseFunctionBody" )) || true) && $this->scanner->consume("}") ) { $body->location->start = $tokenBodyStart->location->start; $body->location->end = $this->scanner->getPosition(); $node = $this->createNode( "FunctionExpression", $async ?: $token ); $node->setId($id); $node->setParams($params); $node->setBody($body); $node->setGenerator($generator); $node->setAsync((bool) $async); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses yield statement * * @return Node\YieldExpression|null */ protected function parseYieldExpression() { if ($token = $this->scanner->consume("yield")) { $node = $this->createNode("YieldExpression", $token); if ($this->scanner->noLineTerminators()) { $delegate = $this->scanner->consume("*"); $argument = $this->isolateContext( array("allowYield" => true), "parseAssignmentExpression" ); if ($argument) { $node->setArgument($argument); $node->setDelegate($delegate); } } return $this->completeNode($node); } return null; } /** * Parses a parameter list * * @return Node\Node[]|null */ protected function parseFormalParameterList() { $hasComma = false; $list = array(); while ( ($param = $this->parseBindingRestElement()) || $param = $this->parseBindingElement() ) { $hasComma = false; $list[] = $param; if ($param->getType() === "RestElement") { break; } elseif ($this->scanner->consume(",")) { $hasComma = true; } else { break; } } //Check if it ends with a comma, then check if the comma is a trailing comma, //in that case throw an error if the trailing comma feature is not enabled if ($hasComma && !$this->features->trailingCommaFunctionCallDeclaration) { $token = $this->scanner->getToken(); if ($token && $token->value === ")") { $this->error(); } } return $list; } /** * Parses a function body * * @return Node\BlockStatement[]|null */ protected function parseFunctionBody() { $body = $this->isolateContext( array("allowReturn" => true), "parseStatementList", array(true) ); $node = $this->createNode( "BlockStatement", $body ?: $this->scanner->getPosition() ); if ($body) { $node->setBody($body); } return $this->completeNode($node); } /** * Parses a class declaration * * @param bool $default Default mode * * @return Node\ClassDeclaration|null */ protected function parseClassDeclaration($default = false) { if ($token = $this->scanner->consume("class")) { //Class declarations are strict mode by default $prevStrict = $this->scanner->getStrictMode(); $this->scanner->setStrictMode(true); $id = $this->parseIdentifier(static::$bindingIdentifier); if (($default || $id) && $tail = $this->parseClassTail() ) { $node = $this->createNode("ClassDeclaration", $token); if ($id) { $node->setId($id); } if ($tail[0]) { $node->setSuperClass($tail[0]); } $node->setBody($tail[1]); $this->scanner->setStrictMode($prevStrict); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses a class expression * * @return Node\ClassExpression|null */ protected function parseClassExpression() { if ($token = $this->scanner->consume("class")) { //Class expressions are strict mode by default $prevStrict = $this->scanner->getStrictMode(); $this->scanner->setStrictMode(true); $id = $this->parseIdentifier(static::$bindingIdentifier); $tail = $this->parseClassTail(); $node = $this->createNode("ClassExpression", $token); if ($id) { $node->setId($id); } if ($tail[0]) { $node->setSuperClass($tail[0]); } $node->setBody($tail[1]); $this->scanner->setStrictMode($prevStrict); return $this->completeNode($node); } return null; } /** * Parses the code that comes after the class keyword and class name. The * return value is an array where the first item is the extended class, if * any, and the second value is the class body * * @return array|null */ protected function parseClassTail() { $heritage = $this->parseClassHeritage(); if ($token = $this->scanner->consume("{")) { $body = $this->parseClassBody(); if ($this->scanner->consume("}")) { $body->location->start = $token->location->start; $body->location->end = $this->scanner->getPosition(); return array($heritage, $body); } } $this->error(); } /** * Parses the class extends part * * @return Node\Node|null */ protected function parseClassHeritage() { if ($this->scanner->consume("extends")) { if ($superClass = $this->parseLeftHandSideExpression()) { return $superClass; } $this->error(); } return null; } /** * Parses the class body * * @return Node\ClassBody|null */ protected function parseClassBody() { $body = $this->parseClassElementList(); $node = $this->createNode( "ClassBody", $body ?: $this->scanner->getPosition() ); if ($body) { $node->setBody($body); } return $this->completeNode($node); } /** * Parses class elements list * * @return Node\MethodDefinition[]|null */ protected function parseClassElementList() { $items = array(); while ($item = $this->parseClassElement()) { if ($item !== true) { $items[] = $item; } } return count($items) ? $items : null; } /** * Parses a class elements * * @return Node\MethodDefinition|Node\PropertyDefinition|Node\StaticBlock|bool|null */ protected function parseClassElement() { if ($this->scanner->consume(";")) { return true; } if ($this->features->classStaticBlock && $this->scanner->isBefore(array(array("static", "{")), true) ) { return $this->parseClassStaticBlock(); } $staticToken = null; $state = $this->scanner->getState(); //This code handles the case where "static" is the method name if (!$this->scanner->isBefore(array(array("static", "(")), true)) { $staticToken = $this->scanner->consume("static"); } if ($def = $this->parseMethodDefinition()) { if ($staticToken) { $def->setStatic(true); $def->location->start = $staticToken->location->start; } return $def; } else { if ($this->features->classFields) { if ($field = $this->parseFieldDefinition()) { if ($staticToken) { $field->setStatic(true); $field->location->start = $staticToken->location->start; } } elseif ($staticToken) { //Handle the case when "static" is the field name $this->scanner->setState($state); $field = $this->parseFieldDefinition(); } return $field; } elseif ($staticToken) { $this->error(); } } return null; } /** * Parses a let or const declaration * * @return Node\VariableDeclaration|null */ protected function parseLexicalDeclaration() { $state = $this->scanner->getState(); if ($token = $this->scanner->consumeOneOf(array("let", "const"))) { $declarations = $this->charSeparatedListOf( "parseVariableDeclaration" ); if ($declarations) { $this->assertEndOfStatement(); $node = $this->createNode("VariableDeclaration", $token); $node->setKind($token->value); $node->setDeclarations($declarations); return $this->completeNode($node); } // "let" can be used as variable name in non-strict mode if ($this->scanner->getStrictMode() || $token->value !== "let") { $this->error(); } else { $this->scanner->setState($state); } } return null; } /** * Parses a var declaration * * @return Node\VariableDeclaration|null */ protected function parseVariableStatement() { if ($token = $this->scanner->consume("var")) { $declarations = $this->isolateContext( array("allowIn" => true), "parseVariableDeclarationList" ); if ($declarations) { $this->assertEndOfStatement(); $node = $this->createNode("VariableDeclaration", $token); $node->setKind($node::KIND_VAR); $node->setDeclarations($declarations); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses an variable declarations * * @return Node\VariableDeclarator[]|null */ protected function parseVariableDeclarationList() { return $this->charSeparatedListOf( "parseVariableDeclaration" ); } /** * Parses a variable declarations * * @return Node\VariableDeclarator|null */ protected function parseVariableDeclaration() { if ($id = $this->parseIdentifier(static::$bindingIdentifier)) { $node = $this->createNode("VariableDeclarator", $id); $node->setId($id); if ($init = $this->parseInitializer()) { $node->setInit($init); } return $this->completeNode($node); } elseif ($id = $this->parseBindingPattern()) { if ($init = $this->parseInitializer()) { $node = $this->createNode("VariableDeclarator", $id); $node->setId($id); $node->setInit($init); return $this->completeNode($node); } } return null; } /** * Parses a let or const declaration in a for statement definition * * @return Node\VariableDeclaration|null */ protected function parseForDeclaration() { $state = $this->scanner->getState(); if ($token = $this->scanner->consumeOneOf(array("let", "const"))) { if ($declaration = $this->parseForBinding()) { $node = $this->createNode("VariableDeclaration", $token); $node->setKind($token->value); $node->setDeclarations(array($declaration)); return $this->completeNode($node); } // "let" can be used as variable name in non-strict mode if ($this->scanner->getStrictMode() || $token->value !== "let") { $this->error(); } else { $this->scanner->setState($state); } } return null; } /** * Parses a binding pattern or an identifier that come after a const or let * declaration in a for statement definition * * @return Node\VariableDeclarator|null */ protected function parseForBinding() { if (($id = $this->parseIdentifier(static::$bindingIdentifier)) || ($id = $this->parseBindingPattern()) ) { $node = $this->createNode("VariableDeclarator", $id); $node->setId($id); return $this->completeNode($node); } return null; } /** * Parses a module item * * @return Node\Node|null */ protected function parseModuleItem() { if ($item = $this->parseImportDeclaration()) { return $item; } elseif ($item = $this->parseExportDeclaration()) { return $item; } elseif ( $item = $this->isolateContext( array( "allowYield" => false, "allowReturn" => false, "allowAwait" => $this->features->topLevelAwait ), "parseStatementListItem" ) ) { return $item; } return null; } /** * Parses the from keyword and the following string in import and export * declarations * * @return Node\StringLiteral|null */ protected function parseFromClause() { if ($this->scanner->consume("from")) { if ($spec = $this->parseStringLiteral()) { return $spec; } $this->error(); } return null; } /** * Parses an export declaration * * @return Node\ModuleDeclaration|null */ protected function parseExportDeclaration() { if ($token = $this->scanner->consume("export")) { if ($this->scanner->consume("*")) { $exported = null; if ($this->features->exportedNameInExportAll && $this->scanner->consume("as")) { $exported = $this->parseModuleExportName(); if (!$exported) { $this->error(); } } if ($source = $this->parseFromClause()) { $node = $this->createNode("ExportAllDeclaration", $token); $node->setSource($source); $node->setExported($exported); if ($this->features->importAttributes && ($attrs = $this->parseWithClause())) { $node->setAttributes($attrs); } $this->assertEndOfStatement(); return $this->completeNode($node); } } elseif ($this->scanner->consume("default")) { $lookaheadTokens = array("function", "class"); if ($this->features->asyncAwait) { $lookaheadTokens[] = array("async", true); } if (($declaration = $this->isolateContext( array("allowAwait" => $this->features->topLevelAwait), "parseFunctionOrGeneratorDeclaration", array(true) )) || ($declaration = $this->isolateContext( array("allowAwait" => $this->features->topLevelAwait), "parseClassDeclaration", array(true) )) ) { $node = $this->createNode("ExportDefaultDeclaration", $token); $node->setDeclaration($declaration); return $this->completeNode($node); } elseif (!$this->scanner->isBefore( $lookaheadTokens, $this->features->asyncAwait ) && ($declaration = $this->isolateContext( array("allowIn" => true, "allowAwait" => $this->features->topLevelAwait), "parseAssignmentExpression" )) ) { $this->assertEndOfStatement(); $node = $this->createNode( "ExportDefaultDeclaration", $token ); $node->setDeclaration($declaration); return $this->completeNode($node); } } elseif (($specifiers = $this->parseExportClause()) !== null) { $node = $this->createNode("ExportNamedDeclaration", $token); $node->setSpecifiers($specifiers); if ($source = $this->parseFromClause()) { $node->setSource($source); } if ($this->features->importAttributes && ($attrs = $this->parseWithClause())) { $node->setAttributes($attrs); } $this->assertEndOfStatement(); return $this->completeNode($node); } elseif ( ($dec = $this->isolateContext( array("allowAwait" => $this->features->topLevelAwait), "parseVariableStatement" )) || $dec = $this->isolateContext( array("allowAwait" => $this->features->topLevelAwait), "parseDeclaration" ) ) { $node = $this->createNode("ExportNamedDeclaration", $token); $node->setDeclaration($dec); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses an export clause * * @return Node\ExportSpecifier[]|null */ protected function parseExportClause() { if ($this->scanner->consume("{")) { $list = array(); while ($spec = $this->parseExportSpecifier()) { $list[] = $spec; if (!$this->scanner->consume(",")) { break; } } if ($this->scanner->consume("}")) { return $list; } $this->error(); } return null; } /** * Parses an export specifier * * @return Node\ExportSpecifier|null */ protected function parseExportSpecifier() { if ($local = $this->parseModuleExportName()) { $node = $this->createNode("ExportSpecifier", $local); $node->setLocal($local); if ($this->scanner->consume("as")) { if ($exported = $this->parseModuleExportName()) { $node->setExported($exported); return $this->completeNode($node); } $this->error(); } else { $node->setExported($local); return $this->completeNode($node); } } return null; } /** * Parses an export name * * @return Node\Identifier|Node\StringLiteral|null */ protected function parseModuleExportName() { if ($name = $this->parseIdentifier(static::$identifierName)) { return $name; } elseif ($this->features->arbitraryModuleNSNames && ($name = $this->parseStringLiteral()) ) { return $name; } return null; } /** * Parses an import declaration * * @return Node\ModuleDeclaration|null */ protected function parseImportDeclaration() { //Delay parsing of dynamic import so that it is handled //by the relative method if ($this->features->dynamicImport && $this->scanner->isBefore(array(array("import", "(")), true)) { return null; } //Delay parsing of import.meta so that it is handled //by the relative method if ($this->features->importMeta && $this->scanner->isBefore(array(array("import", ".")), true)) { return null; } if ($token = $this->scanner->consume("import")) { if ($source = $this->parseStringLiteral()) { $attrs = $this->features->importAttributes ? $this->parseWithClause() : null; $this->assertEndOfStatement(); $node = $this->createNode("ImportDeclaration", $token); $node->setSource($source); if ($attrs) { $node->setAttributes($attrs); } return $this->completeNode($node); } elseif (($specifiers = $this->parseImportClause()) !== null && $source = $this->parseFromClause() ) { $attrs = $this->features->importAttributes ? $this->parseWithClause() : null; $this->assertEndOfStatement(); $node = $this->createNode("ImportDeclaration", $token); $node->setSpecifiers($specifiers); $node->setSource($source); if ($attrs) { $node->setAttributes($attrs); } return $this->completeNode($node); } $this->error(); } return null; } /** * Parses an import clause * * @return array|null */ protected function parseImportClause() { if ($spec = $this->parseNameSpaceImport()) { return array($spec); } elseif (($specs = $this->parseNamedImports()) !== null) { return $specs; } elseif ($spec = $this->parseIdentifier(static::$importedBinding)) { $node = $this->createNode("ImportDefaultSpecifier", $spec); $node->setLocal($spec); $ret = array($this->completeNode($node)); if ($this->scanner->consume(",")) { if ($spec = $this->parseNameSpaceImport()) { $ret[] = $spec; return $ret; } elseif (($specs = $this->parseNamedImports()) !== null) { return array_merge($ret, $specs); } $this->error(); } else { return $ret; } } return null; } /** * Parses a namespace import * * @return Node\ImportNamespaceSpecifier|null */ protected function parseNameSpaceImport() { if ($token = $this->scanner->consume("*")) { if ($this->scanner->consume("as") && $local = $this->parseIdentifier(static::$identifierReference) ) { $node = $this->createNode("ImportNamespaceSpecifier", $token); $node->setLocal($local); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses a named imports * * @return Node\ImportSpecifier[]|null */ protected function parseNamedImports() { if ($this->scanner->consume("{")) { $list = array(); while ($spec = $this->parseImportSpecifier()) { $list[] = $spec; if (!$this->scanner->consume(",")) { break; } } if ($this->scanner->consume("}")) { return $list; } $this->error(); } return null; } /** * Parses an import specifier * * @return Node\ImportSpecifier|null */ protected function parseImportSpecifier() { $requiredAs = false; $imported = $this->parseIdentifier(static::$importedBinding); if (!$imported) { $imported = $this->parseModuleExportName(); if (!$imported) { return null; } $requiredAs = true; } $node = $this->createNode("ImportSpecifier", $imported); $node->setImported($imported); if ($this->scanner->consume("as")) { if (!($local = $this->parseIdentifier(static::$importedBinding))) { $this->error(); } $node->setLocal($local); } elseif ($requiredAs) { $this->error(); } else { $node->setLocal($imported); } return $this->completeNode($node); } /** * Parses a with clause * * @return array|null */ protected function parseWithClause() { if ($this->scanner->consume("with")) { if (!$this->scanner->consume("{")) { $this->error(); } else { $list = array(); while (true) { if ($entry = $this->parseWithEntries()) { $list[] = $entry; if (!$this->scanner->consume(",")) { break; } } else { break; } } if (!$this->scanner->consume("}")) { $this->error(); } return $list; } } return null; } /** * Parses a with entry * * @return ImportAttribute |null */ protected function parseWithEntries() { if (($key = $this->parseIdentifier(static::$identifierName)) || ($key = $this->parseStringLiteral())) { if ($this->scanner->consume(":") && ($value = $this->parseStringLiteral())) { $node = $this->createNode("ImportAttribute", $key); $node->setKey($key); $node->setValue($value); return $this->completeNode($node); } else { $this->error(); } } return null; } /** * Parses a binding pattern * * @return Node\ArrayPattern|Node\ObjectPattern|null */ protected function parseBindingPattern() { if ($pattern = $this->parseObjectBindingPattern()) { return $pattern; } elseif ($pattern = $this->parseArrayBindingPattern()) { return $pattern; } return null; } /** * Parses an elisions sequence. It returns the number of elisions or null * if no elision has been found * * @return int */ protected function parseElision() { $count = 0; while ($this->scanner->consume(",")) { $count ++; } return $count ?: null; } /** * Parses an array binding pattern * * @return Node\ArrayPattern|null */ protected function parseArrayBindingPattern() { if ($token = $this->scanner->consume("[")) { $elements = array(); while (true) { if ($elision = $this->parseElision()) { $elements = array_merge( $elements, array_fill(0, $elision, null) ); } if ($element = $this->parseBindingElement()) { $elements[] = $element; if (!$this->scanner->consume(",")) { break; } } elseif ($rest = $this->parseBindingRestElement()) { $elements[] = $rest; break; } else { break; } } if ($this->scanner->consume("]")) { $node = $this->createNode("ArrayPattern", $token); $node->setElements($elements); return $this->completeNode($node); } } return null; } /** * Parses a rest element * * @return Node\RestElement|null */ protected function parseBindingRestElement() { if ($token = $this->scanner->consume("...")) { if (($argument = $this->parseIdentifier(static::$bindingIdentifier)) || ($argument = $this->parseBindingPattern())) { $node = $this->createNode("RestElement", $token); $node->setArgument($argument); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses a binding element * * @return Node\AssignmentPattern|Node\Identifier|null */ protected function parseBindingElement() { if ($el = $this->parseSingleNameBinding()) { return $el; } elseif ($left = $this->parseBindingPattern()) { $right = $this->isolateContext( array("allowIn" => true), "parseInitializer" ); if ($right) { $node = $this->createNode("AssignmentPattern", $left); $node->setLeft($left); $node->setRight($right); return $this->completeNode($node); } else { return $left; } } return null; } /** * Parses single name binding * * @return Node\AssignmentPattern|Node\Identifier|null */ protected function parseSingleNameBinding() { if ($left = $this->parseIdentifier(static::$bindingIdentifier)) { $right = $this->isolateContext( array("allowIn" => true), "parseInitializer" ); if ($right) { $node = $this->createNode("AssignmentPattern", $left); $node->setLeft($left); $node->setRight($right); return $this->completeNode($node); } else { return $left; } } return null; } /** * Parses a property name. The returned value is an array where there first * element is the property name and the second element is a boolean * indicating if it's a computed property * * @return array|null */ protected function parsePropertyName() { if ($token = $this->scanner->consume("[")) { if (($name = $this->isolateContext( array("allowIn" => true), "parseAssignmentExpression" )) && $this->scanner->consume("]") ) { return array($name, true, $token); } $this->error(); } elseif ($name = $this->parseIdentifier(static::$identifierName)) { return array($name, false); } elseif ($name = $this->parseStringLiteral()) { return array($name, false); } elseif ($name = $this->parseNumericLiteral()) { return array($name, false); } return null; } /** * Parses a property name. The returned value is an array where there first * element is the property name and the second element is a boolean * indicating if it's a computed property * * @return array|null */ protected function parseClassElementName() { if ( $this->features->privateMethodsAndFields && ($name = $this->parsePrivateIdentifier()) ) { return array($name, false); } return $this->parsePropertyName(); } /** * Parses a field definition * * @return Node\StaticBlock */ protected function parseClassStaticBlock() { $staticToken = $this->scanner->consume("static"); $this->scanner->consume("{"); $statements = $this->isolateContext( array("allowAwait" => true), "parseStatementList" ); if ($this->scanner->consume("}")) { $node = $this->createNode("StaticBlock", $staticToken); if ($statements) { $node->setBody($statements); } return $this->completeNode($node); } $this->error(); } /** * Parses a field definition * * @return Node\PropertyDefinition|null */ protected function parseFieldDefinition() { $state = $this->scanner->getState(); if ($prop = $this->parseClassElementName()) { $value = $this->isolateContext( array("allowIn" => true), "parseInitializer" ); $this->assertEndOfStatement(); $node = $this->createNode("PropertyDefinition", $prop); $node->setKey($prop[0]); if ($value) { $node->setValue($value); } $node->setComputed($prop[1]); return $this->completeNode($node); } $this->scanner->setState($state); return null; } /** * Parses a method definition * * @return Node\MethodDefinition|null */ protected function parseMethodDefinition() { $state = $this->scanner->getState(); $generator = $error = $async = false; $position = null; $kind = Node\MethodDefinition::KIND_METHOD; if ($token = $this->scanner->consume("get")) { $position = $token; $kind = Node\MethodDefinition::KIND_GET; } elseif ($token = $this->scanner->consume("set")) { $position = $token; $kind = Node\MethodDefinition::KIND_SET; } elseif ($token = $this->scanner->consume("*")) { $position = $token; $error = true; $generator = true; } elseif ($this->features->asyncAwait && ($token = $this->checkAsyncFunctionStart(false))) { $this->scanner->consumeToken(); $position = $token; $error = true; $async = true; if ($this->features->asyncIterationGenerators && ($this->scanner->consume("*"))) { $generator = true; } } //Handle the case where get, set and async are methods name and not the //definition of a getter/setter or the start of an async function if (($kind !== Node\MethodDefinition::KIND_METHOD || ($async && !$generator)) && $this->scanner->consume("(") ) { $this->scanner->setState($state); $kind = Node\MethodDefinition::KIND_METHOD; $error = $async = false; } if ($prop = $this->parseClassElementName()) { if (!$position) { $position = isset($prop[2]) ? $prop[2] : $prop[0]; } if ($tokenFn = $this->scanner->consume("(")) { if ($generator || $async) { $flags = array(null); if ($generator) { $flags["allowYield"] = true; } if ($async) { $flags["allowAwait"] = true; } } else { $flags = null; } $error = true; $params = array(); if ($kind === Node\MethodDefinition::KIND_SET) { $params = $this->isolateContext( null, "parseBindingElement" ); if ($params) { $params = array($params); } } elseif ($kind === Node\MethodDefinition::KIND_METHOD) { $params = $this->isolateContext( $flags, "parseFormalParameterList" ); } if ($params !== null && $this->scanner->consume(")") && ($tokenBodyStart = $this->scanner->consume("{")) && (($body = $this->isolateContext( $flags, "parseFunctionBody" )) || true) && $this->scanner->consume("}") ) { if ($prop[0] instanceof Node\Identifier && $prop[0]->getName() === "constructor" ) { $kind = Node\MethodDefinition::KIND_CONSTRUCTOR; } $body->location->start = $tokenBodyStart->location->start; $body->location->end = $this->scanner->getPosition(); $nodeFn = $this->createNode("FunctionExpression", $tokenFn); $nodeFn->setParams($params); $nodeFn->setBody($body); $nodeFn->setGenerator($generator); $nodeFn->setAsync($async); $node = $this->createNode("MethodDefinition", $position); $node->setKey($prop[0]); $node->setValue($this->completeNode($nodeFn)); $node->setKind($kind); $node->setComputed($prop[1]); return $this->completeNode($node); } } } //Handle the case where "async" is a class field name elseif ($this->features->classFields && $async && !$generator) { $this->scanner->setState($state); $error = $async = false; } if ($error) { $this->error(); } else { $this->scanner->setState($state); } return null; } /** * Parses parameters in an arrow function. If the parameters are wrapped in * round brackets, the returned value is an array where the first element * is the parameters list and the second element is the open round brackets, * this is needed to know the start position * * @return Node\Identifier|array|null */ protected function parseArrowParameters() { if ($param = $this->parseIdentifier(static::$bindingIdentifier, "=>")) { return $param; } elseif ($token = $this->scanner->consume("(")) { $params = $this->parseFormalParameterList(); if ($params !== null && $this->scanner->consume(")")) { return array($params, $token); } } return null; } /** * Parses the body of an arrow function. The returned value is an array * where the first element is the function body and the second element is * a boolean indicating if the body is wrapped in curly braces * * @param bool $async Async body mode * * @return array|null */ protected function parseConciseBody($async = false) { if ($token = $this->scanner->consume("{")) { if (($body = $this->isolateContext( $async ? array(null, "allowAwait" => true) : null, "parseFunctionBody" )) && $this->scanner->consume("}") ) { $body->location->start = $token->location->start; $body->location->end = $this->scanner->getPosition(); return array($body, false); } $this->error(); } elseif (!$this->scanner->isBefore(array("{")) && $body = $this->isolateContext( $this->features->asyncAwait ? array("allowYield" => false, "allowAwait" => $async) : array("allowYield" => false), "parseAssignmentExpression" ) ) { return array($body, true); } return null; } /** * Parses an arrow function * * @return Node\ArrowFunctionExpression|null */ protected function parseArrowFunction() { $state = $this->scanner->getState(); $async = false; if ($this->features->asyncAwait && ($async = $this->checkAsyncFunctionStart(false))) { $this->scanner->consumeToken(); } if (($params = $this->parseArrowParameters()) !== null) { if ($this->scanner->noLineTerminators() && $this->scanner->consume("=>") ) { if ($body = $this->parseConciseBody((bool) $async)) { if (is_array($params)) { $pos = $params[1]; $params = $params[0]; } else { $pos = $params; $params = array($params); } if ($async) { $pos = $async; } $node = $this->createNode("ArrowFunctionExpression", $pos); $node->setParams($params); $node->setBody($body[0]); $node->setExpression($body[1]); $node->setAsync((bool) $async); return $this->completeNode($node); } $this->error(); } } $this->scanner->setState($state); return null; } /** * Parses an object literal * * @return Node\ObjectExpression|null */ protected function parseObjectLiteral() { if ($token = $this->scanner->consume("{")) { $properties = array(); while ($prop = $this->parsePropertyDefinition()) { $properties[] = $prop; if (!$this->scanner->consume(",")) { break; } } if ($this->scanner->consume("}")) { $node = $this->createNode("ObjectExpression", $token); if ($properties) { $node->setProperties($properties); } return $this->completeNode($node); } $this->error(); } return null; } /** * Parses a property in an object literal * * @return Node\Property|null */ protected function parsePropertyDefinition() { if ($this->features->restSpreadProperties && ($prop = $this->parseSpreadElement())) { return $prop; } $state = $this->scanner->getState(); if (($property = $this->parsePropertyName()) && $this->scanner->consume(":") ) { $value = $this->isolateContext( array("allowIn" => true), "parseAssignmentExpression" ); if ($value) { $startPos = isset($property[2]) ? $property[2] : $property[0]; $node = $this->createNode("Property", $startPos); $node->setKey($property[0]); $node->setValue($value); $node->setComputed($property[1]); return $this->completeNode($node); } $this->error(); } $this->scanner->setState($state); if ($property = $this->parseMethodDefinition()) { $node = $this->createNode("Property", $property); $node->setKey($property->getKey()); $node->setValue($property->getValue()); $node->setComputed($property->getComputed()); $kind = $property->getKind(); if ($kind !== Node\MethodDefinition::KIND_GET && $kind !== Node\MethodDefinition::KIND_SET ) { $node->setMethod(true); $node->setKind(Node\Property::KIND_INIT); } else { $node->setKind($kind); } return $this->completeNode($node); } elseif ($key = $this->parseIdentifier(static::$identifierReference)) { $node = $this->createNode("Property", $key); $node->setShorthand(true); $node->setKey($key); $value = $this->isolateContext( array("allowIn" => true), "parseInitializer" ); $node->setValue($value ?: $key); return $this->completeNode($node); } return null; } /** * Parses an initializer * * @return Node\Node|null */ protected function parseInitializer() { if ($this->scanner->consume("=")) { if ($value = $this->parseAssignmentExpression()) { return $value; } $this->error(); } return null; } /** * Parses an object binding pattern * * @return Node\ObjectPattern|null */ protected function parseObjectBindingPattern() { $state = $this->scanner->getState(); if ($token = $this->scanner->consume("{")) { $properties = array(); while ($prop = $this->parseBindingProperty()) { $properties[] = $prop; if (!$this->scanner->consume(",")) { break; } } if ($this->features->restSpreadProperties && ($rest = $this->parseRestProperty())) { $properties[] = $rest; } if ($this->scanner->consume("}")) { $node = $this->createNode("ObjectPattern", $token); if ($properties) { $node->setProperties($properties); } return $this->completeNode($node); } $this->scanner->setState($state); } return null; } /** * Parses a rest property * * @return Node\RestElement|null */ protected function parseRestProperty() { $state = $this->scanner->getState(); if ($token = $this->scanner->consume("...")) { if ($argument = $this->parseIdentifier(static::$bindingIdentifier)) { $node = $this->createNode("RestElement", $token); $node->setArgument($argument); return $this->completeNode($node); } $this->scanner->setState($state); } return null; } /** * Parses a property in an object binding pattern * * @return Node\AssignmentProperty|null */ protected function parseBindingProperty() { $state = $this->scanner->getState(); if (($key = $this->parsePropertyName()) && $this->scanner->consume(":") ) { if ($value = $this->parseBindingElement()) { $startPos = isset($key[2]) ? $key[2] : $key[0]; $node = $this->createNode("AssignmentProperty", $startPos); $node->setKey($key[0]); $node->setComputed($key[1]); $node->setValue($value); return $this->completeNode($node); } $this->scanner->setState($state); return null; } $this->scanner->setState($state); if ($property = $this->parseSingleNameBinding()) { $node = $this->createNode("AssignmentProperty", $property); $node->setShorthand(true); if ($property instanceof Node\AssignmentPattern) { $node->setKey($property->getLeft()); } else { $node->setKey($property); } $node->setValue($property); return $this->completeNode($node); } return null; } /** * Parses an expression * * @return Node\Node|null */ protected function parseExpression() { $list = $this->charSeparatedListOf("parseAssignmentExpression"); if (!$list) { return null; } elseif (count($list) === 1) { return $list[0]; } else { $node = $this->createNode("SequenceExpression", $list); $node->setExpressions($list); return $this->completeNode($node); } } /** * Parses an assignment expression * * @return Node\Node|null */ protected function parseAssignmentExpression() { if ($expr = $this->parseArrowFunction()) { return $expr; } elseif ($this->context->allowYield && $expr = $this->parseYieldExpression()) { return $expr; } elseif ($expr = $this->parseConditionalExpression()) { $exprTypes = array( "ConditionalExpression", "LogicalExpression", "BinaryExpression", "UpdateExpression", "UnaryExpression" ); if (!in_array($expr->getType(), $exprTypes)) { $operators = $this->assignmentOperators; if ($operator = $this->scanner->consumeOneOf($operators)) { if ($expr->getType() === "ChainExpression") { $this->error( "Optional chain can't appear in left-hand side" ); } $right = $this->parseAssignmentExpression(); if ($right) { $node = $this->createNode( "AssignmentExpression", $expr ); $node->setLeft($this->expressionToPattern($expr)); $node->setOperator($operator->value); $node->setRight($right); return $this->completeNode($node); } $this->error(); } } return $expr; } return null; } /** * Parses a conditional expression * * @return Node\Node|null */ protected function parseConditionalExpression() { if ($test = $this->parseLogicalBinaryExpression()) { if ($this->scanner->consume("?")) { $consequent = $this->isolateContext( array("allowIn" => true), "parseAssignmentExpression" ); if ($consequent && $this->scanner->consume(":") && $alternate = $this->parseAssignmentExpression() ) { $node = $this->createNode("ConditionalExpression", $test); $node->setTest($test); $node->setConsequent($consequent); $node->setAlternate($alternate); return $this->completeNode($node); } $this->error(); } else { return $test; } } return null; } /** * Parses a logical or a binary expression * * @return Node\Node|null */ protected function parseLogicalBinaryExpression() { $operators = $this->logicalBinaryOperators; if (!$this->context->allowIn) { unset($operators["in"]); } if (!($exp = $this->parseUnaryExpression())) { if ( !$this->features->classFieldsPrivateIn || !$this->context->allowIn ) { return null; } //Support "#private in x" syntax $state = $this->scanner->getState(); if ( !($exp = $this->parsePrivateIdentifier()) || !$this->scanner->isBefore(array("in")) ) { if ($exp) { $this->scanner->setState($state); } return null; } } $list = array($exp); $coalescingFound = $andOrFound = false; while ($token = $this->scanner->consumeOneOf(array_keys($operators))) { $op = $token->value; // Coalescing and logical expressions can't be used together if ($op === "??") { $coalescingFound = true; } elseif ($op === "&&" || $op === "||") { $andOrFound = true; } if ($coalescingFound && $andOrFound) { $this->error( "Logical expressions must be wrapped in parentheses when " . "inside coalesce expressions" ); } if (!($exp = $this->parseUnaryExpression())) { $this->error(); } $list[] = $op; $list[] = $exp; } $len = count($list); if ($len > 1) { $maxGrade = max($operators); for ($grade = $maxGrade; $grade >= 0; $grade--) { $class = $grade < 2 ? "LogicalExpression" : "BinaryExpression"; $r2l = $grade === 10; //Exponentiation operator must be parsed right to left if ($r2l) { $i = $len - 2; $step = -2; } else { $i = 1; $step = 2; } for (; ($r2l && $i > 0) || (!$r2l && $i < $len); $i += $step) { if ($operators[$list[$i]] === $grade) { $node = $this->createNode($class, $list[$i - 1]); $node->setLeft($list[$i - 1]); $node->setOperator($list[$i]); $node->setRight($list[$i + 1]); $node = $this->completeNode( $node, $list[$i + 1]->location->end ); array_splice($list, $i - 1, 3, array($node)); if (!$r2l) { $i -= $step; } $len = count($list); } } } } return $list[0]; } /** * Parses a unary expression * * @return Node\Node|null */ protected function parseUnaryExpression() { $operators = $this->unaryOperators; if ($this->features->asyncAwait && $this->context->allowAwait) { $operators[] = "await"; } if ($expr = $this->parsePostfixExpression()) { return $expr; } elseif ($token = $this->scanner->consumeOneOf($operators)) { if ($argument = $this->parseUnaryExpression()) { $op = $token->value; //Deleting a variable without accessing its properties is a //syntax error in strict mode if ($op === "delete" && $this->scanner->getStrictMode() && $argument instanceof Node\Identifier) { $this->error( "Deleting an unqualified identifier is not allowed in strict mode" ); } if ($this->features->asyncAwait && $op === "await") { $node = $this->createNode("AwaitExpression", $token); } else { if ($op === "++" || $op === "--") { if ($argument->getType() === "ChainExpression") { $this->error( "Optional chain can't appear in left-hand side" ); } $node = $this->createNode("UpdateExpression", $token); $node->setPrefix(true); } else { $node = $this->createNode("UnaryExpression", $token); } $node->setOperator($op); } $node->setArgument($argument); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses a postfix expression * * @return Node\Node|null */ protected function parsePostfixExpression() { if ($argument = $this->parseLeftHandSideExpression()) { if ($this->scanner->noLineTerminators() && $token = $this->scanner->consumeOneOf($this->postfixOperators) ) { if ($argument->getType() === "ChainExpression") { $this->error( "Optional chain can't appear in left-hand side" ); } $node = $this->createNode("UpdateExpression", $argument); $node->setOperator($token->value); $node->setArgument($argument); return $this->completeNode($node); } return $argument; } return null; } /** * Parses a left hand side expression * * @return Node\Node|null */ protected function parseLeftHandSideExpression() { $object = null; $newTokens = array(); //Parse all occurrences of "new" if ($this->scanner->isBefore(array("new"))) { while ($newToken = $this->scanner->consume("new")) { if ($this->scanner->consume(".")) { //new.target if (!$this->scanner->consume("target")) { $this->error(); } $node = $this->createNode("MetaProperty", $newToken); $node->setMeta("new"); $node->setProperty("target"); $object = $this->completeNode($node); break; } $newTokens[] = $newToken; } } elseif ($this->features->importMeta && $this->sourceType === \Peast\Peast::SOURCE_TYPE_MODULE && $this->scanner->isBefore(array(array("import", ".")), true) ) { //import.meta $importToken = $this->scanner->consume("import"); $this->scanner->consume("."); if (!$this->scanner->consume("meta")) { $this->error(); } $node = $this->createNode("MetaProperty", $importToken); $node->setMeta("import"); $node->setProperty("meta"); $object = $this->completeNode($node); } $newTokensCount = count($newTokens); if (!$object && !($object = $this->parseSuperPropertyOrCall()) && !($this->features->dynamicImport && ($object = $this->parseImportCall()) ) && !($object = $this->parsePrimaryExpression()) ) { if ($newTokensCount) { $this->error(); } return null; } $valid = true; $optionalChain = false; $properties = array(); while (true) { $optional = false; if ($opToken = $this->scanner->consumeOneOf(array("?.", "."))) { $isOptChain = $opToken->value == "?."; if ($isOptChain) { $optionalChain = $optional = true; } if ( ($this->features->privateMethodsAndFields && ($property = $this->parsePrivateIdentifier())) || ($property = $this->parseIdentifier(static::$identifierName)) ) { $valid = true; $properties[] = array( "type"=> "id", "info" => $property, "optional" => $optional ); continue; } else { $valid = false; if (!$isOptChain) { break; } } } if ($this->scanner->consume("[")) { if (($property = $this->isolateContext( array("allowIn" => true), "parseExpression" )) && $this->scanner->consume("]") ) { $valid = true; $properties[] = array( "type" => "computed", "info" => array( $property, $this->scanner->getPosition() ), "optional" => $optional ); } else { $valid = false; break; } } elseif ($property = $this->parseTemplateLiteral(true)) { if ($optionalChain) { $this->error( "Optional chain can't appear in tagged template expressions" ); } $valid = true; $properties[] = array( "type"=> "template", "info" => $property, "optional" => $optional ); } elseif (($args = $this->parseArguments()) !== null) { $valid = true; $properties[] = array( "type"=> "args", "info" => array($args, $this->scanner->getPosition()), "optional" => $optional ); } else { break; } } $propCount = count($properties); if (!$valid) { $this->error(); } elseif (!$propCount && !$newTokensCount) { return $object; } $node = null; $endPos = $object->location->end; $optionalChainStarted = false; foreach ($properties as $i => $property) { $lastNode = $node ?: $object; if ($property["optional"]) { $optionalChainStarted = true; } if ($property["type"] === "args") { if ($newTokensCount) { if ($optionalChainStarted) { $this->error( "Optional chain can't appear in new expressions" ); } $node = $this->createNode( "NewExpression", array_pop($newTokens) ); $newTokensCount--; } else { $node = $this->createNode("CallExpression", $lastNode); $node->setOptional($property["optional"]); } $node->setCallee($lastNode); $node->setArguments($property["info"][0]); $endPos = $property["info"][1]; } elseif ($property["type"] === "id") { $node = $this->createNode("MemberExpression", $lastNode); $node->setObject($lastNode); $node->setOptional($property["optional"]); $node->setProperty($property["info"]); $endPos = $property["info"]->location->end; } elseif ($property["type"] === "computed") { $node = $this->createNode("MemberExpression", $lastNode); $node->setObject($lastNode); $node->setProperty($property["info"][0]); $node->setOptional($property["optional"]); $node->setComputed(true); $endPos = $property["info"][1]; } elseif ($property["type"] === "template") { $node = $this->createNode("TaggedTemplateExpression", $object); $node->setTag($lastNode); $node->setQuasi($property["info"]); $endPos = $property["info"]->location->end; } $node = $this->completeNode($node, $endPos); } //Wrap the result in multiple NewExpression if there are "new" tokens if ($newTokensCount) { for ($i = $newTokensCount - 1; $i >= 0; $i--) { $lastNode = $node ?: $object; $node = $this->createNode("NewExpression", $newTokens[$i]); $node->setCallee($lastNode); $node = $this->completeNode($node); } } //Wrap the result in a chain expression if required if ($optionalChain) { $prevNode = $node; $node = $this->createNode("ChainExpression", $prevNode); $node->setExpression($prevNode); $node = $this->completeNode($node); } return $node; } /** * Parses a spread element * * @return Node\SpreadElement|null */ protected function parseSpreadElement() { if ($token = $this->scanner->consume("...")) { $argument = $this->isolateContext( array("allowIn" => true), "parseAssignmentExpression" ); if ($argument) { $node = $this->createNode("SpreadElement", $token); $node->setArgument($argument); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses an array literal * * @return Node\ArrayExpression|null */ protected function parseArrayLiteral() { if ($token = $this->scanner->consume("[")) { $elements = array(); while (true) { if ($elision = $this->parseElision()) { $elements = array_merge( $elements, array_fill(0, $elision, null) ); } if (($element = $this->parseSpreadElement()) || ($element = $this->isolateContext( array("allowIn" => true), "parseAssignmentExpression" )) ) { $elements[] = $element; if (!$this->scanner->consume(",")) { break; } } else { break; } } if ($this->scanner->consume("]")) { $node = $this->createNode("ArrayExpression", $token); $node->setElements($elements); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses an arguments list wrapped in round brackets * * @return array|null */ protected function parseArguments() { if ($this->scanner->consume("(")) { if (($args = $this->parseArgumentList()) !== null && $this->scanner->consume(")") ) { return $args; } $this->error(); } return null; } /** * Parses an arguments list * * @return array|null */ protected function parseArgumentList() { $list = array(); $hasComma = false; while (true) { $spread = $this->scanner->consume("..."); $exp = $this->isolateContext( array("allowIn" => true), "parseAssignmentExpression" ); if (!$exp) { //If there's no expression and the spread dots have been found //or there is a trailing comma that is not allowed, throw an //error if ($spread || ($hasComma && !$this->features->trailingCommaFunctionCallDeclaration)) { $this->error(); } break; } if ($spread) { $node = $this->createNode("SpreadElement", $spread); $node->setArgument($exp); $list[] = $this->completeNode($node); } else { $list[] = $exp; } if (!$this->scanner->consume(",")) { break; } $hasComma = true; } return $list; } /** * Parses a super call or a super property * * @return Node\Node|null */ protected function parseSuperPropertyOrCall() { if ($token = $this->scanner->consume("super")) { $super = $this->completeNode($this->createNode("Super", $token)); if (($args = $this->parseArguments()) !== null) { $node = $this->createNode("CallExpression", $token); $node->setArguments($args); $node->setCallee($super); return $this->completeNode($node); } $node = $this->createNode("MemberExpression", $token); $node->setObject($super); if ($this->scanner->consume(".")) { if ($property = $this->parseIdentifier(static::$identifierName)) { $node->setProperty($property); return $this->completeNode($node); } } elseif ($this->scanner->consume("[") && ($property = $this->isolateContext( array("allowIn" => true), "parseExpression" )) && $this->scanner->consume("]") ) { $node->setProperty($property); $node->setComputed(true); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses a primary expression * * @return Node\Node|null */ protected function parsePrimaryExpression() { if ($token = $this->scanner->consume("this")) { $node = $this->createNode("ThisExpression", $token); return $this->completeNode($node); } elseif ($exp = $this->parseFunctionOrGeneratorExpression()) { return $exp; } elseif ($exp = $this->parseClassExpression()) { return $exp; } elseif ($exp = $this->parseIdentifier(static::$identifierReference)) { return $exp; } elseif ($exp = $this->parseLiteral()) { return $exp; } elseif ($exp = $this->parseArrayLiteral()) { return $exp; } elseif ($exp = $this->parseObjectLiteral()) { return $exp; } elseif ($exp = $this->parseRegularExpressionLiteral()) { return $exp; } elseif ($exp = $this->parseTemplateLiteral()) { return $exp; } elseif ($this->jsx && ($exp = $this->parseJSXFragment())) { return $exp; } elseif ($this->jsx && ($exp = $this->parseJSXElement())) { return $exp; } elseif ($token = $this->scanner->consume("(")) { if (($exp = $this->isolateContext( array("allowIn" => true), "parseExpression" )) && $this->scanner->consume(")") ) { $node = $this->createNode("ParenthesizedExpression", $token); $node->setExpression($exp); return $this->completeNode($node); } $this->error(); } return null; } /** * Parses a private identifier * * @return Node\PrivateIdentifier|null */ protected function parsePrivateIdentifier() { $token = $this->scanner->getToken(); if (!$token || $token->type !== Token::TYPE_PRIVATE_IDENTIFIER) { return null; } $this->scanner->consumeToken(); $node = $this->createNode("PrivateIdentifier", $token); $node->setName(substr($token->value, 1)); return $this->completeNode($node); } /** * Parses an identifier * * @param int $mode Parsing mode, one of the id parsing mode * constants * @param string $after If a string is passed in this parameter, the * identifier is parsed only if precedes this string * * @return Node\Identifier|null */ protected function parseIdentifier($mode, $after = null) { $token = $this->scanner->getToken(); if (!$token) { return null; } if ($after !== null) { $next = $this->scanner->getNextToken(); if (!$next || $next->value !== $after) { return null; } } $type = $token->type; switch ($type) { case Token::TYPE_BOOLEAN_LITERAL: case Token::TYPE_NULL_LITERAL: if ($mode !== self::ID_ALLOW_ALL) { return null; } break; case Token::TYPE_KEYWORD: if ($mode === self::ID_ALLOW_NOTHING) { return null; } elseif ($mode === self::ID_MIXED && $this->scanner->isStrictModeKeyword($token) ) { return null; } break; default: if ($type !== Token::TYPE_IDENTIFIER) { return null; } break; } //Exclude keywords that depend on parser context $value = $token->value; if ($mode === self::ID_MIXED && isset($this->contextKeywords[$value]) && $this->context->{$this->contextKeywords[$value]} ) { return null; } $this->scanner->consumeToken(); $node = $this->createNode("Identifier", $token); $node->setRawName($value); return $this->completeNode($node); } /** * Parses a literal * * @return Node\Literal|null */ protected function parseLiteral() { if ($token = $this->scanner->getToken()) { if ($token->type === Token::TYPE_NULL_LITERAL) { $this->scanner->consumeToken(); $node = $this->createNode("NullLiteral", $token); return $this->completeNode($node); } elseif ($token->type === Token::TYPE_BOOLEAN_LITERAL) { $this->scanner->consumeToken(); $node = $this->createNode("BooleanLiteral", $token); $node->setRaw($token->value); return $this->completeNode($node); } elseif ($literal = $this->parseStringLiteral()) { return $literal; } elseif ($literal = $this->parseNumericLiteral()) { return $literal; } } return null; } /** * Parses a string literal * * @return Node\StringLiteral|null */ protected function parseStringLiteral() { $token = $this->scanner->getToken(); if ($token && $token->type === Token::TYPE_STRING_LITERAL) { $val = $token->value; $this->checkInvalidEscapeSequences($val); $this->scanner->consumeToken(); $node = $this->createNode("StringLiteral", $token); $node->setRaw($val); return $this->completeNode($node); } return null; } /** * Parses a numeric literal * * @return Node\NumericLiteral|Node\BigIntLiteral|null */ protected function parseNumericLiteral() { $token = $this->scanner->getToken(); if ($token && $token->type === Token::TYPE_NUMERIC_LITERAL) { $val = $token->value; $this->checkInvalidEscapeSequences($val, true); $this->scanner->consumeToken(); $node = $this->createNode("NumericLiteral", $token); $node->setRaw($val); return $this->completeNode($node); } elseif ($token && $token->type === Token::TYPE_BIGINT_LITERAL) { $val = $token->value; $this->checkInvalidEscapeSequences($val, true); $this->scanner->consumeToken(); $node = $this->createNode("BigIntLiteral", $token); $node->setRaw($val); return $this->completeNode($node); } return null; } /** * Parses a template literal * * @param bool $tagged True if the template is tagged * * @return Node\Literal|null */ protected function parseTemplateLiteral($tagged = false) { $token = $this->scanner->getToken(); if (!$token || $token->type !== Token::TYPE_TEMPLATE) { return null; } //Do not parse templates parts $val = $token->value; if ($val[0] !== "`") { return null; } $quasis = $expressions = array(); $valid = false; do { $this->scanner->consumeToken(); $val = $token->value; $this->checkInvalidEscapeSequences($val, false, true, $tagged); $lastChar = substr($val, -1); $quasi = $this->createNode("TemplateElement", $token); $quasi->setRawValue($val); if ($lastChar === "`") { $quasi->setTail(true); $quasis[] = $this->completeNode($quasi); $valid = true; break; } else { $quasis[] = $this->completeNode($quasi); $exp = $this->isolateContext( array("allowIn" => true), "parseExpression" ); if ($exp) { $expressions[] = $exp; } else { $valid = false; break; } } $token = $this->scanner->getToken(); } while ($token && $token->type === Token::TYPE_TEMPLATE); if ($valid) { $node = $this->createNode("TemplateLiteral", $quasis[0]); $node->setQuasis($quasis); $node->setExpressions($expressions); return $this->completeNode($node); } $this->error(); } /** * Parses a regular expression literal * * @return Node\Literal|null */ protected function parseRegularExpressionLiteral() { if ($token = $this->scanner->reconsumeCurrentTokenAsRegexp()) { $this->scanner->consumeToken(); $node = $this->createNode("RegExpLiteral", $token); $node->setRaw($token->value); return $this->completeNode($node); } return null; } /** * Parse directive prologues. The result is an array where the first element * is the array of parsed nodes and the second element is the array of * directive prologues values * * @return array|null */ protected function parseDirectivePrologues() { $directives = $nodes = array(); while (($token = $this->scanner->getToken()) && $token->type === Token::TYPE_STRING_LITERAL ) { $directive = substr($token->value, 1, -1); if ($directive === "use strict") { $directives[] = $directive; $directiveNode = $this->parseStringLiteral(); $this->assertEndOfStatement(); $node = $this->createNode("ExpressionStatement", $directiveNode); $node->setExpression($directiveNode); $nodes[] = $this->completeNode($node); } else { break; } } return count($nodes) ? array($nodes, $directives) : null; } /** * Parses an import call * * @return Node\Node|null */ protected function parseImportCall() { if (($token = $this->scanner->consume("import")) && $this->scanner->consume("(")) { $source = $this->isolateContext( array("allowIn" => true), "parseAssignmentExpression" ); if ($source) { $options = null; if ($this->features->importAttributes && $this->scanner->consume(",")) { $options = $this->isolateContext( array("allowIn" => true), "parseAssignmentExpression" ); $this->scanner->consume(","); } if ($this->scanner->consume(")")) { $node = $this->createNode("ImportExpression", $token); $node->setSource($source); $node->setOptions($options); return $this->completeNode($node); } } $this->error(); } return null; } /** * Checks if the given string or number contains invalid escape sequences * * @param string $val Value to check * @param bool $number True if the value is a number * @param bool $forceLegacyOctalCheck True to force legacy octal * form check * @param bool $taggedTemplate True if the value is a tagged * template * * @return void */ protected function checkInvalidEscapeSequences( $val, $number = false, $forceLegacyOctalCheck = false, $taggedTemplate = false ) { if ($this->features->skipEscapeSeqCheckInTaggedTemplates && $taggedTemplate) { return; } $checkLegacyOctal = $forceLegacyOctalCheck || $this->scanner->getStrictMode(); if ($number) { if ($val && $val[0] === "0" && preg_match("#^0[0-9_]+$#", $val)) { if ($checkLegacyOctal) { $this->error( "Octal literals are not allowed in strict mode" ); } if ($this->features->numericLiteralSeparator && strpos($val, '_') !== false ) { $this->error( "Numeric separators are not allowed in legacy octal numbers" ); } } } elseif (strpos($val, "\\") !== false) { $hex = "0-9a-fA-F"; $invalidSyntax = array( "x[$hex]?[^$hex]", "x[$hex]?$", "u\{\}", "u\{(?:[$hex]*[^$hex\}]+)+[$hex]*\}", "u\{[^\}]*$", "u(?!{)[$hex]{0,3}[^$hex\{]", "u[$hex]{0,3}$" ); if ($checkLegacyOctal) { $invalidSyntax[] = "\d{2}"; $invalidSyntax[] = "[1-7]"; $invalidSyntax[] = "0[89]"; } $reg = "#(\\\\+)(" . implode("|", $invalidSyntax) . ")#"; if (preg_match_all($reg, $val, $matches, PREG_SET_ORDER)) { foreach ($matches as $match) { if (strlen($match[1]) % 2) { $first = $match[2][0]; if ($first === "u") { $err = "Malformed unicode escape sequence"; } elseif ($first === "x") { $err = "Malformed hexadecimal escape sequence"; } else { $err = "Octal literals are not allowed in strict mode"; } $this->error($err); } } } } } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\ES2023; /** * ES2023 features class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Features extends \Peast\Syntax\ES2022\Features { /** * Hashbang comments * * @var bool */ public $hashbangComments = true; }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax; /** * Parser features class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Features { /** * Exponentiation operator * * @var bool */ public $exponentiationOperator = false; /** * Async/await * * @var bool */ public $asyncAwait = false; /** * Trailing comma in function calls and declarations * * @var bool */ public $trailingCommaFunctionCallDeclaration = false; /** * For-in initializer * * @var bool */ public $forInInitializer = false; /** * Async iteration and generators * * @var bool */ public $asyncIterationGenerators = false; /** * Rest/spread properties * * @var bool */ public $restSpreadProperties = false; /** * Skip escape sequences checks in tagged template * * @var bool */ public $skipEscapeSeqCheckInTaggedTemplates = false; /** * Optional catch binding * * @var bool */ public $optionalCatchBinding = false; /** * Paragraph and line separator in strings * * @var bool */ public $paragraphLineSepInStrings = false; /** * Dynamic import * * @var bool */ public $dynamicImport = false; /** * BigInt literals * * @var bool */ public $bigInt = false; /** * Exported name for export all declarations * * @var bool */ public $exportedNameInExportAll = false; /** * Import.meta * * @var bool */ public $importMeta = false; /** * Coalescing operator * * @var bool */ public $coalescingOperator = false; /** * Optional chaining * * @var bool */ public $optionalChaining = false; /** * Logical assignment operators * * @var bool */ public $logicalAssignmentOperators = false; /** * Numeric literal separator * * @var bool */ public $numericLiteralSeparator = false; /** * Private methods and fields * * @var bool */ public $privateMethodsAndFields = false; /** * Class fields * * @var bool */ public $classFields = false; /** * "in" operator for private fields * * @var bool */ public $classFieldsPrivateIn = false; /** * Top level await * * @var bool */ public $topLevelAwait = false; /** * Class static block * * @var bool */ public $classStaticBlock = false; /** * Arbitrary module namespace identifier names * * @var bool */ public $arbitraryModuleNSNames = false; /** * Hashbang comments * * @var bool */ public $hashbangComments = false; /** * Import attributes * * @var bool */ public $importAttributes = false; }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax; /** * Base class for parsers. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @abstract */ abstract class ParserAbstract { /** * Associated scanner * * @var Scanner */ protected $scanner; /** * Parser features * * @var Features */ protected $features; /** * Parser context * * @var \stdClass */ protected $context; /** * Source type * * @var string */ protected $sourceType; /** * Comments handling * * @var bool */ protected $comments; /** * JSX syntax handling * * @var bool */ protected $jsx; /** * Events emitter * * @var EventsEmitter */ protected $eventsEmitter; /** * Class constructor * * @param string $source Source code * @param Features $features Parser features * @param array $options Parsing options */ public function __construct( $source, Features $features, $options = array() ) { $this->features = $features; $this->sourceType = isset($options["sourceType"]) ? $options["sourceType"] : \Peast\Peast::SOURCE_TYPE_SCRIPT; //Create the scanner $this->scanner = new Scanner($source, $features, $options); //Enable module scanning if required if ($this->sourceType === \Peast\Peast::SOURCE_TYPE_MODULE) { $this->scanner->enableModuleMode(); } //Enable comments scanning $this->comments = isset($options["comments"]) && $options["comments"]; if ($this->comments) { $this->scanner->enableComments(); //Create the comments registry new CommentsRegistry($this); } // Enable jsx syntax if required $this->jsx = isset($options["jsx"]) && $options["jsx"]; $this->initContext(); $this->postInit(); } /** * Initializes parser context * * @return void */ abstract protected function initContext(); /** * Post initialize operations * * @return void */ abstract protected function postInit(); /** * Parses the source * * @return Node\Node * * @abstract */ abstract public function parse(); /** * Returns parsed tokens from the source code * * @return Token[] */ public function tokenize() { $this->scanner->enableTokenRegistration(); $this->parse(); return $this->scanner->getTokens(); } /** * Returns the scanner associated with the parser * * @return Scanner */ public function getScanner() { return $this->scanner; } /** * Returns the parser features class * * @return Features */ public function getFeatures() { return $this->features; } /** * Returns the parser's events emitter * * @return EventsEmitter */ public function getEventsEmitter() { if (!$this->eventsEmitter) { //The event emitter is created here so that it won't exist if not //necessary $this->eventsEmitter = new EventsEmitter; } return $this->eventsEmitter; } /** * Calls a method with an isolated parser context, applying the given flags, * but restoring their values after the execution. * * @param array|null $flags Key/value array of changes to apply to the * context flags. If it's null or the first * element of the array is null the context will * be reset before applying new values. * @param string $fn Method to call * @param array|null $args Method arguments * * @return mixed */ protected function isolateContext($flags, $fn, $args = null) { //Store the current context $oldContext = clone $this->context; //If flag argument is null reset the context if ($flags === null) { $this->initContext(); } else { //Apply new values to the flags foreach ($flags as $k => $v) { // If null reset the context if ($v === null) { $this->initContext(); } else { $this->context->$k = $v; } } } //Call the method with the given arguments $ret = $args ? call_user_func_array(array($this, $fn), $args) : $this->$fn(); //Restore previous context $this->context = $oldContext; return $ret; } /** * Creates a node * * @param string $nodeType Node's type * @param mixed $position Node's start position * * @return Node\Node * * @codeCoverageIgnore */ protected function createNode($nodeType, $position) { //Use the right class to get an instance of the node $nodeClass = "\\Peast\\Syntax\\Node\\" . $nodeType; $node = new $nodeClass; //Add the node start position if ($position instanceof Node\Node || $position instanceof Token) { $position = $position->location->start; } elseif (is_array($position)) { if (count($position)) { $position = $position[0]->location->start; } else { $position = $this->scanner->getPosition(); } } $node->location->start = $position; //Emit the NodeCreated event for the node $this->eventsEmitter && $this->eventsEmitter->fire( "NodeCreated", array($node) ); return $node; } /** * Completes a node by adding the end position * * @param Node\Node $node Node to complete * @param Position $position Node's end position * * @return mixed It actually returns a Node but mixed solves * a lot of PHPDoc problems * * @codeCoverageIgnore */ protected function completeNode(Node\Node $node, $position = null) { //Add the node end position $node->location->end = $position ?: $this->scanner->getPosition(); //Emit the NodeCompleted event for the node $this->eventsEmitter && $this->eventsEmitter->fire( "NodeCompleted", array($node) ); return $node; } /** * Throws a syntax error * * @param string $message Error message * @param Position $position Error position * * @return void * * @throws Exception */ protected function error($message = "", $position = null) { if (!$message) { $token = $this->scanner->getToken(); if ($token === null) { $message = "Unexpected end of input"; } else { $position = $token->location->start; $message = "Unexpected: " . $token->value; } } if (!$position) { $position = $this->scanner->getPosition(); } throw new Exception($message, $position); } /** * Asserts that a valid end of statement follows the current position * * @return boolean * * @throws Exception */ protected function assertEndOfStatement() { //The end of statement is reached when it is followed by line //terminators, end of source, "}" or ";". In the last case the token //must be consumed if (!$this->scanner->noLineTerminators()) { return true; } else { if ($this->scanner->consume(";")) { return true; } $token = $this->scanner->getToken(); if (!$token || $token->value === "}") { return true; } } $this->error(); } /** * Parses a character separated list of instructions or null if the * sequence is not valid * * @param callable $fn Parsing instruction function * @param string $char Separator * * @return array * * @throws Exception */ protected function charSeparatedListOf($fn, $char = ",") { $list = array(); $valid = true; while ($param = $this->$fn()) { $list[] = $param; $valid = true; if (!$this->scanner->consume($char)) { break; } else { $valid = false; } } if (!$valid) { $this->error(); } return $list; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax; /** * Encoding exception class. Encoding errors while scanning the source are * thrown using this using this exception class. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class EncodingException extends \Exception { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\JSX; use Peast\Syntax\Token; /** * JSX parser trait * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ trait Parser { /** * Creates a JSX node * * @param string $nodeType Node's type * @param mixed $position Node's start position * * @return \Peast\Syntax\Node\Node */ protected function createJSXNode($nodeType, $position) { return $this->createNode("JSX\\$nodeType", $position); } /** * Parses a jsx fragment * * @return \Peast\Syntax\Node\JSX\JSXFragment|null */ protected function parseJSXFragment() { $startOpeningToken = $this->scanner->getToken(); if (!$startOpeningToken || $startOpeningToken->value !== "<") { return null; } $endOpeningToken = $this->scanner->getNextToken(); if (!$endOpeningToken || $endOpeningToken->value !== ">") { return null; } $this->scanner->consumeToken(); $this->scanner->consumeToken(); $children = $this->parseJSXChildren(); if (!($startClosingToken = $this->scanner->consume("<")) || !$this->scanner->consume("/") || !$this->scanner->reconsumeCurrentTokenInJSXMode() || $endOpeningToken->value !== ">") { $this->error(); } $this->scanner->consumeToken(); //Opening tag $openingNode = $this->createJSXNode( "JSXOpeningFragment", $startOpeningToken ); $this->completeNode( $openingNode, $endOpeningToken->location->end ); //Closing tag $closingNode = $this->createJSXNode( "JSXClosingFragment", $startClosingToken ); $this->completeNode($closingNode); //Fragment $node = $this->createJSXNode("JSXFragment", $startOpeningToken); $node->setOpeningFragment($openingNode); $node->setClosingFragment($closingNode); if ($children) { $node->setChildren($children); } return $this->completeNode($node); } /** * Parses a group of jsx children * * @return \Peast\Syntax\Node\Node[]|null */ protected function parseJSXChildren() { $children = array(); while ($child = $this->parseJSXChild()) { $children[] = $child; } return count($children) ? $children : null; } /** * Parses a jsx child * * @return \Peast\Syntax\Node\Node|null */ protected function parseJSXChild() { if ($node = $this->parseJSXText()) { return $node; } elseif ($node = $this->parseJSXFragment()) { return $node; } elseif($node = $this->parseJSXElement()) { return $node; } elseif ($startToken = $this->scanner->consume("{")) { $spread = $this->scanner->consume("..."); $exp = $this->parseAssignmentExpression(); $midPos = $this->scanner->getPosition(); if (($spread && !$exp) || !$this->scanner->consume("}")) { $this->error(); } $node = $this->createJSXNode( $spread ? "JSXSpreadChild" : "JSXExpressionContainer", $startToken ); if (!$exp) { $exp = $this->createJSXNode("JSXEmptyExpression", $midPos); $this->completeNode($exp, $midPos); } $node->setExpression($exp); return $this->completeNode($node); } return null; } /** * Parses a jsx text * * @return \Peast\Syntax\Node\JSX\JSXText|null */ protected function parseJSXText() { if (!($token = $this->scanner->reconsumeCurrentTokenAsJSXText())) { return null; } $this->scanner->consumeToken(); $node = $this->createJSXNode("JSXText", $token); $node->setRaw($token->value); return $this->completeNode($node, $token->location->end); } /** * Parses a jsx element * * @return \Peast\Syntax\Node\JSX\JSXElement|null */ protected function parseJSXElement() { $startOpeningToken = $this->scanner->getToken(); if (!$startOpeningToken || $startOpeningToken->value !== "<") { return null; } $nextToken = $this->scanner->getNextToken(); if ($nextToken && $nextToken->value === "/") { return null; } $this->scanner->consumeToken(); if (!($name = $this->parseJSXIdentifierOrMemberExpression())) { $this->error(); } $attributes = $this->parseJSXAttributes(); $selfClosing = $this->scanner->consume("/"); $endOpeningToken = $this->scanner->reconsumeCurrentTokenInJSXMode(); if (!$endOpeningToken || $endOpeningToken->value !== ">") { $this->error(); } $this->scanner->consumeToken(); if (!$selfClosing) { $children = $this->parseJSXChildren(); if ( ($startClosingToken = $this->scanner->consume("<")) && $this->scanner->consume("/") && ($closingName = $this->parseJSXIdentifierOrMemberExpression()) && ($endClosingToken = $this->scanner->reconsumeCurrentTokenInJSXMode()) && ($endClosingToken->value === ">") ) { $this->scanner->consumeToken(); if (!$this->isSameJSXElementName($name, $closingName)) { $this->error("Closing tag does not match opening tag"); } } else { $this->error(); } } //Opening tag $openingNode = $this->createJSXNode( "JSXOpeningElement", $startOpeningToken ); $openingNode->setName($name); $openingNode->setSelfClosing($selfClosing); if ($attributes) { $openingNode->setAttributes($attributes); } $this->completeNode( $openingNode, $endOpeningToken->location->end ); //Closing tag $closingNode = null; if (!$selfClosing) { $closingNode = $this->createJSXNode( "JSXClosingElement", $startClosingToken ); $closingNode->setName($closingName); $this->completeNode($closingNode); } //Element $node = $this->createJSXNode("JSXElement", $startOpeningToken); $node->setOpeningElement($openingNode); if ($closingNode) { $node->setClosingElement($closingNode); if ($children) { $node->setChildren($children); } } return $this->completeNode($node); } /** * Parses a jsx identifier, namespaced identifier or member expression * * @param bool $allowMember True to allow member expressions * * @return \Peast\Syntax\Node\Node|null */ protected function parseJSXIdentifierOrMemberExpression($allowMember = true) { $idToken = $this->scanner->reconsumeCurrentTokenInJSXMode(); if (!$idToken || $idToken->type !== Token::TYPE_JSX_IDENTIFIER) { return null; } $this->scanner->consumeToken(); $idNode = $this->createJSXNode("JSXIdentifier", $idToken); $idNode->setName($idToken->value); $idNode = $this->completeNode($idNode); //Namespaced identifier if ($this->scanner->consume(":")) { $idToken2 = $this->scanner->reconsumeCurrentTokenInJSXMode(); if (!$idToken2 || $idToken2->type !== Token::TYPE_JSX_IDENTIFIER) { $this->error(); } $this->scanner->consumeToken(); $idNode2 = $this->createJSXNode("JSXIdentifier", $idToken2); $idNode2->setName($idToken2->value); $idNode2 = $this->completeNode($idNode2); $node = $this->createJSXNode("JSXNamespacedName", $idToken); $node->setNamespace($idNode); $node->setName($idNode2); return $this->completeNode($node); } //Get following identifiers $nextIds = array(); if ($allowMember) { while ($this->scanner->consume(".")) { $nextId = $this->scanner->reconsumeCurrentTokenInJSXMode(); if (!$nextId || $nextId->type !== Token::TYPE_JSX_IDENTIFIER) { $this->error(); } $this->scanner->consumeToken(); $nextIds[] = $nextId; } } //Create the member expression if required $objectNode = $idNode; foreach ($nextIds as $nid) { $propEnd = $nid->location->end; $propNode = $this->createJSXNode("JSXIdentifier", $nid); $propNode->setName($nid->value); $propNode = $this->completeNode($propNode, $propEnd); $node = $this->createJSXNode("JSXMemberExpression", $objectNode); $node->setObject($objectNode); $node->setProperty($propNode); $objectNode = $this->completeNode($node, $propEnd); } return $objectNode; } /** * Parses a jsx attributes list * * @return \Peast\Syntax\Node\Node[]|null */ protected function parseJSXAttributes() { $attributes = array(); while ( ($attr = $this->parseJSXSpreadAttribute()) || ($attr = $this->parseJSXAttribute()) ) { $attributes[] = $attr; } return count($attributes) ? $attributes : null; } /** * Parses a jsx spread attribute * * @return \Peast\Syntax\Node\JSX\JSXSpreadAttribute|null */ protected function parseJSXSpreadAttribute() { if (!($openToken = $this->scanner->consume("{"))) { return null; } if ( $this->scanner->consume("...") && ($exp = $this->parseAssignmentExpression()) && $this->scanner->consume("}") ) { $node = $this->createJSXNode("JSXSpreadAttribute", $openToken); $node->setArgument($exp); return $this->completeNode($node); } $this->error(); } /** * Parses a jsx spread attribute * * @return \Peast\Syntax\Node\JSX\JSXSpreadAttribute|null */ protected function parseJSXAttribute() { if (!($name = $this->parseJSXIdentifierOrMemberExpression(false))) { return null; } $value = null; if ($this->scanner->consume("=")) { $strToken = $this->scanner->reconsumeCurrentTokenInJSXMode(); if ($strToken && $strToken->type === Token::TYPE_STRING_LITERAL) { $this->scanner->consumeToken(); $value = $this->createNode("StringLiteral", $strToken); $value->setRaw($strToken->value); $value = $this->completeNode($value); } elseif ($startExp = $this->scanner->consume("{")) { if ( ($exp = $this->parseAssignmentExpression()) && $this->scanner->consume("}") ) { $value = $this->createJSXNode( "JSXExpressionContainer", $startExp ); $value->setExpression($exp); $value = $this->completeNode($value); } else { $this->error(); } } elseif ( !($value = $this->parseJSXFragment()) && !($value = $this->parseJSXElement()) ) { $this->error(); } } $node = $this->createJSXNode("JSXAttribute", $name); $node->setName($name); if ($value) { $node->setValue($value); } return $this->completeNode($node); } /** * Checks that 2 tag names are equal * * @param \Peast\Syntax\Node\Node $n1 First name * @param \Peast\Syntax\Node\Node $n2 Second name * * @return bool */ protected function isSameJSXElementName($n1, $n2) { $type = $n1->getType(); if ($type !== $n2->getType()) { return false; } elseif ($type === "JSXNamespacedName") { return $this->isSameJSXElementName( $n1->getNamespace(), $n2->getNamespace() ) && $this->isSameJSXElementName( $n1->getName(), $n2->getName() ); } elseif ($type === "JSXMemberExpression") { return $this->isSameJSXElementName( $n1->getObject(), $n2->getObject() ) && $this->isSameJSXElementName( $n1->getProperty(), $n2->getProperty() ); } return $type === "JSXIdentifier" && $n1->getName() === $n2->getName(); } } <?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\JSX; use Peast\Syntax\Token; /** * JSX scanner trait * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ trait Scanner { /** * Tries to reconsume the current token as a jsx text if possible * * @return Token|null */ public function reconsumeCurrentTokenAsJSXText() { //Current and next tokens must be reset and the open brackets count must be correct //like they were never scanned foreach (array($this->currentToken, $this->nextToken) as $token) { if ($token && isset($this->brackets[$token->value])) { if ($refBracket = $this->brackets[$token->value]) { $this->openBrackets[$refBracket]++; } else { $this->openBrackets[$token->value]--; } } } $this->nextToken = null; $this->currentToken = null; $startPosition = $this->getPosition(); $this->setScanPosition($startPosition); $result = $this->consumeUntil(array("{", "<"), false, false); if ($result) { $this->currentToken = new Token(Token::TYPE_JSX_TEXT, $result[0]); $this->currentToken->location->start = $startPosition; $this->currentToken->location->end = $this->getPosition(true); } return $this->currentToken; } /** * Reconsumes the current token in jsx mode * * @return Token|null */ public function reconsumeCurrentTokenInJSXMode() { $this->jsx = true; $this->nextToken = null; $this->currentToken = null; $startPosition = $this->getPosition(); $this->setScanPosition($startPosition); $token = $this->getToken(); $this->jsx = false; return $token; } /** * String scanning method in jsx mode * * @return Token|null */ public function scanJSXString() { return $this->scanString(false); } /** * String punctuator method in jsx mode * * @return Token|null */ public function scanJSXPunctuator() { //The ">" character in jsx mode must be emitted in its own token //without matching longer sequences like ">>" $char = $this->charAt(); if ($char === ">") { $this->index++; $this->column++; return new Token(Token::TYPE_PUNCTUATOR, $char); } return $this->scanPunctuator(); } /** * Identifier scanning method in jsx mode * * @return Token|null */ public function scanJSXIdentifier() { $buffer = ""; $char = $this->charAt(); if ($char !== null && $this->isIdentifierChar($char)) { do { $buffer .= $char; $this->index++; $this->column++; $char = $this->charAt(); } while ( $char !== null && ($this->isIdentifierChar($char, false) || $char === "-") ); } return $buffer === "" ? null : new Token(Token::TYPE_JSX_IDENTIFIER, $buffer); } } <?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax; /** * This class represents the position in the source code. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Position implements \JSONSerializable { /** * Source line * * @var int */ protected $line; /** * Source column * * @var int */ protected $column; /** * Source index * * @var int */ protected $index; /** * Class constructor * * @param int $line Source line * @param int $column Source column * @param int $index Source index */ function __construct($line, $column, $index) { $this->line = $line; $this->column = $column; $this->index = $index; } /** * Returns the source line * * @return int */ public function getLine() { return $this->line; } /** * Returns the source column * * @return int */ public function getColumn() { return $this->column; } /** * Returns the source index * * @return int */ public function getIndex() { return $this->index; } /** * Returns a serializable version of the object * * @return array */ #[\ReturnTypeWillChange] public function jsonSerialize() { return array( "line" => $this->getLine(), "column" => $this->getColumn(), "index" => $this->getIndex() ); } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax; /** * Comments registry class. Internal class used to manage comments * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class CommentsRegistry { /** * Map of the indices where nodes start * * @var int */ protected $nodesStartMap = array(); /** * Map of the indices where nodes end * * @var int */ protected $nodesEndMap = array(); /** * Comments buffer * * @var array */ protected $buffer = null; /** * Last token index * * @var int */ protected $lastTokenIndex = null; /** * Comments registry * * @var array */ protected $registry = array(); /** * Class constructor * * @param Parser $parser Parser */ public function __construct(Parser $parser) { $parser->getEventsEmitter() ->addListener("NodeCompleted", array($this, "onNodeCompleted")) ->addListener("EndParsing", array($this, "onEndParsing")); $parser->getScanner()->getEventsEmitter() ->addListener("TokenConsumed", array($this, "onTokenConsumed")) ->addListener("EndReached", array($this, "onTokenConsumed")) ->addListener("FreezeState", array($this, "onScannerFreezeState")) ->addListener("ResetState", array($this, "onScannerResetState")); } /** * Listener called every time the scanner compose the array that represents * its current state * * @param array $state State * * @return void */ public function onScannerFreezeState(&$state) { //Register the current last token index $state["commentsLastTokenIndex"] = $this->lastTokenIndex; } /** * Listener called every time the scanner reset its state using the given * array * * @param array $state State * * @return void */ public function onScannerResetState(&$state) { //Reset the last token index and delete it from the state array $this->lastTokenIndex = $state["commentsLastTokenIndex"]; unset($state["commentsLastTokenIndex"]); } /** * Listener called every time a token is consumed and when the scanner * reaches the end of the source * * @param Token|null $token Consumed token or null if the end has * been reached * * @return void */ public function onTokenConsumed($token = null) { //Check if it's a comment if ($token && $token->type === Token::TYPE_COMMENT) { //If there is not an open comments buffer, create it if (!$this->buffer) { $this->buffer = array( "prev" => $this->lastTokenIndex, "next" => null, "comments" => array() ); } //Add the comment token to the buffer $this->buffer["comments"][] = $token; } else { if ($token) { $loc = $token->location; //Store the token end position $this->lastTokenIndex = $loc->end->getIndex(); if ($this->buffer) { //Fill the "next" key on the comments buffer with the token //start position $this->buffer["next"] = $loc->start->getIndex(); } } //If there is an open comment buffer, close it and move it to the //registry if ($buffer = $this->buffer) { //Use the location as key to add the group of comments to the //registry, in this way if comments are reprocessed they won't //be duplicated $key = implode("-", array( $buffer["prev"] !== null ? $buffer["prev"] : "", $buffer["next"] !== null ? $buffer["next"] : "" )); $this->registry[$key] = $this->buffer; $this->buffer = null; } } } /** * Listener called every time a node is completed by the parser * * @param Node\Node $node Completed node * * @return void */ public function onNodeCompleted(Node\Node $node) { //Every time a node is completed, register its start and end indices //in the relative properties $loc = $node->location; foreach (array("Start", "End") as $pos) { $val = $loc->{"get$pos"}()->getIndex(); $map = &$this->{"nodes{$pos}Map"}; if (!isset($map[$val])) { $map[$val] = array(); } $map[$val][] = $node; } } /** * Listener called when parsing process ends * * @return void */ public function onEndParsing() { //Return if there are no comments to process if ($this->registry) { //Make sure nodes start indices map is sorted ksort($this->nodesStartMap); //Loop all comment groups in the registry foreach ($this->registry as $group) { $this->findNodeForCommentsGroup($group); } } } /** * Finds the node to attach the given comments group * * @param array $group Comments group * * @return void */ public function findNodeForCommentsGroup($group) { $next = $group["next"]; $prev = $group["prev"]; $comments = $group["comments"]; $leading = true; //If the group of comments has a next token index that appears //in the map of start node indices, add the group to the //corresponding node's leading comments. This associates //comments that appear immediately before a node. //For example: /*comment*/ for (;;){} if (isset($this->nodesStartMap[$next])) { $nodes = $this->nodesStartMap[$next]; } //If the group of comments has a previous token index that appears //in the map of end node indices, add the group to the //corresponding node's trailing comments. This associates //comments that appear immediately after a node. //For example: for (;;){} /*comment*/ elseif (isset($this->nodesEndMap[$prev])) { $nodes = $this->nodesEndMap[$prev]; $leading = false; } //Otherwise, find a node that wraps the comments position. //This associates inner comments: //For example: for /*comment*/ (;;){} else { //Calculate comments group boundaries $start = $comments[0]->location->start->getIndex(); $end = $comments[count($comments) -1]->location->end->getIndex(); $nodes = array(); //Loop all the entries in the start index map foreach ($this->nodesStartMap as $idx => $ns) { //If the index is higher than the start index of the comments //group, stop if ($idx > $start) { break; } foreach ($ns as $node) { //Check if the comments group is inside node indices range if ($node->location->end->getIndex() >= $end) { $nodes[] = $node; } } } //If comments can't be associated with any node, associate it as //leading comments of the program, this happens when the source is //empty if (!$nodes) { $firstNode = array_values($this->nodesStartMap); $nodes = array($firstNode[0][0]); } } //If there are multiple possible nodes to associate the comments to, //find the shortest one if (count($nodes) > 1) { usort($nodes, array($this, "compareNodesLength")); } $this->associateComments($nodes[0], $comments, $leading); } /** * Compares node length * * @param Node\Node $node1 First node * @param Node\Node $node2 Second node * * @return int * * @codeCoverageIgnore */ public function compareNodesLength($node1, $node2) { $loc1 = $node1->location; $length1 = $loc1->end->getIndex() - $loc1->start->getIndex(); $loc2 = $node2->location; $length2 = $loc2->end->getIndex() - $loc2->start->getIndex(); //If the nodes have the same length make sure to choose nodes //different from Program nodes if ($length1 === $length2) { if ($node1 instanceof Node\Program) { $length1 += 1000; } elseif ($node2 instanceof Node\Program) { $length2 += 1000; } } return $length1 < $length2 ? -1 : 1; } /** * Adds comments to the given node * * @param Node\Node $node Node * @param array $comments Array of comments to add * @param bool $leading True to add comments as leading comments * or false to add them as trailing comments * * @return void */ public function associateComments($node, $comments, $leading) { $fn = ($leading ? "Leading" : "Trailing") . "Comments"; $currentComments = $node->{"get$fn"}(); foreach ($comments as $comment) { $loc = $comment->location; $commentNode = new Node\Comment; $commentNode->location->start = $loc->start; $commentNode->location->end = $loc->end; $commentNode->setRawText($comment->value); $currentComments[] = $commentNode; } $node->{"set$fn"}($currentComments); } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\ES2021; /** * ES2021 features class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Features extends \Peast\Syntax\ES2020\Features { /** * Logical assignment operators * * @var bool */ public $logicalAssignmentOperators = true; /** * Numeric literal separator * * @var bool */ public $numericLiteralSeparator = true; }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\ES2018; /** * ES2018 features class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Features extends \Peast\Syntax\ES2017\Features { /** * Async iteration and generators * * @var bool */ public $asyncIterationGenerators = true; /** * Rest/spread properties * * @var bool */ public $restSpreadProperties = true; /** * Skip escape sequences checks in tagged template * * @var bool */ public $skipEscapeSeqCheckInTaggedTemplates = true; }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\ES2015; /** * ES2015 features class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Features extends \Peast\Syntax\Features { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\ES2020; /** * ES2020 features class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Features extends \Peast\Syntax\ES2019\Features { /** * Dynamic import * * @var bool */ public $dynamicImport = true; /** * BigInt literals * * @var bool */ public $bigInt = true; /** * Exported name for export all declarations * * @var bool */ public $exportedNameInExportAll = true; /** * Import.meta * * @var bool */ public $importMeta = true; /** * Coalescing operator * * @var bool */ public $coalescingOperator = true; /** * Optional chaining * * @var bool */ public $optionalChaining = true; }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax; /** * A token emitted by the tokenizer. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Token implements \JSONSerializable { //Type constants /** * Boolean literal */ const TYPE_BOOLEAN_LITERAL = "Boolean"; /** * Identifier */ const TYPE_IDENTIFIER = "Identifier"; /** * Private identifier */ const TYPE_PRIVATE_IDENTIFIER = "PrivateIdentifier"; /** * Keyword */ const TYPE_KEYWORD = "Keyword"; /** * Null literal */ const TYPE_NULL_LITERAL = "Null"; /** * Numeric literal */ const TYPE_NUMERIC_LITERAL = "Numeric"; /** * BigInt literal */ const TYPE_BIGINT_LITERAL = "BigInt"; /** * Punctuator */ const TYPE_PUNCTUATOR = "Punctuator"; //This constant is kept only for backward compatibility since it was //first written with a typo const TYPE_PUNCTUTATOR = "Punctuator"; /** * String literal */ const TYPE_STRING_LITERAL = "String"; /** * Regular expression */ const TYPE_REGULAR_EXPRESSION = "RegularExpression"; /** * Template */ const TYPE_TEMPLATE = "Template"; /** * Comment */ const TYPE_COMMENT = "Comment"; /** * JSX text */ const TYPE_JSX_TEXT = "JSXText"; /** * JSX identifier */ const TYPE_JSX_IDENTIFIER = "JSXIdentifier"; /** * Tokens' type that is one of the type constants * * @var string */ public $type; /** * Token's value * * @var string */ public $value; /** * Token's location in the source code * * @var SourceLocation */ public $location; /** * Class constructor * * @param string $type Token's type * @param string $value Token's value */ public function __construct($type, $value) { $this->type = $type; $this->value = $value; $this->location = new SourceLocation(); } /** * Returns the token's type * * @return string */ public function getType() { return $this->type; } /** * Returns the token's value * * @return string */ public function getValue() { return $this->value; } /** * Returns the token's location in the source code * * @return SourceLocation */ public function getLocation() { return $this->location; } /** * Sets the start position of the token in the source code * * @param Position $position Start position * * @return $this */ public function setStartPosition(Position $position) { $this->location->start = $position; return $this; } /** * Sets the end position of the token in the source code * * @param Position $position End position * * @return $this */ public function setEndPosition(Position $position) { $this->location->end = $position; return $this; } /** * Returns a serializable version of the node * * @return array */ #[\ReturnTypeWillChange] public function jsonSerialize() { return array( "type" => $this->type, "value" => $this->value, "location" => $this->location ); } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax; /** * Events emitter class. An instance of this class is used by Parser and Scanner * to emit events and attach listeners to them * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class EventsEmitter { /** * Events registry array * * @var array */ protected $eventsRegistry = array(); /** * Attaches a listener function to the given event * * @param string $event Event name * @param callable $listener Listener function * * @return $this */ public function addListener($event, $listener) { if (!isset($this->eventsRegistry[$event])) { $this->eventsRegistry[$event] = array(); } $this->eventsRegistry[$event][] = $listener; return $this; } /** * Fires an event * * @param string $event Event name * @param array $args Arguments to pass to functions attached to the * event * * @return $this */ public function fire($event, $args = array()) { if (isset($this->eventsRegistry[$event])) { foreach ($this->eventsRegistry[$event] as $listener) { call_user_func_array($listener, $args); } } return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax; /** * Base class for scanners. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Scanner { use JSX\Scanner; /** * Scanner features * * @var Features */ protected $features; /** * Current column * * @var int */ protected $column = 0; /** * Current line * * @var int */ protected $line = 1; /** * Current index * * @var int */ protected $index = 0; /** * Source length * * @var int */ protected $length; /** * Source characters * * @var array */ protected $source; /** * Consumed position * * @var Position */ protected $position; /** * Current token * * @var Token */ protected $currentToken; /** * Next token * * @var Token */ protected $nextToken; /** * Strict mode flag * * @var bool */ protected $strictMode = false; /** * True to register tokens in the tokens array * * @var bool */ protected $registerTokens = false; /** * Module mode * * @var bool */ protected $isModule = false; /** * Comments handling * * @var bool */ protected $comments = false; /** * Internal JSX scan flag * * @var bool */ protected $jsx = false; /** * Registered tokens array * * @var array */ protected $tokens = array(); /** * Comments to tokens map * * @var array */ protected $commentsMap = array(); /** * Events emitter * * @var EventsEmitter */ protected $eventsEmitter; /** * Regex to match identifiers starts * * @var string */ protected $idStartRegex = "/[\p{Lu}\p{Ll}\p{Lt}\p{Lm}\p{Lo}\p{Nl}\x{1885}\x{1886}\x{2118}\x{212E}\x{309B}\x{309C}]/u"; /** * Regex to match identifiers parts * * @var string */ protected $idPartRegex = "/[\p{Lu}\p{Ll}\p{Lt}\p{Lm}\p{Lo}\p{Nl}\x{1885}\x{1886}\x{2118}\x{212E}\x{309B}\x{309C}\p{Mn}\p{Mc}\p{Nd}\p{Pc}\x{00B7}\x{0387}\x{1369}\x{136A}\x{136B}\x{136C}\x{136D}\x{136E}\x{136F}\x{1370}\x{1371}\x{19DA}\x{200C}\x{200D}]/u"; /** * Keywords array * * @var array */ protected $keywords = array( "break", "do", "in", "typeof", "case", "else", "instanceof", "var", "catch", "export", "new", "void", "class", "extends", "return", "while", "const", "finally", "super", "with", "continue", "for", "switch", "debugger", "function", "this", "default", "if", "throw", "delete", "import", "try", "enum", "await" ); /** * Array of words that are keywords only in strict mode * * @var array */ protected $strictModeKeywords = array( "implements", "interface", "package", "private", "protected", "public", "static", "let", "yield" ); /** * Punctuators array * * @var array */ protected $punctuators = array( ".", ";", ",", "<", ">", "<=", ">=", "==", "!=", "===", "!==", "+", "-", "*", "%", "++", "--", "<<", ">>", ">>>", "&", "|", "^", "!", "~", "&&", "||", "?", ":", "=", "+=", "-=", "*=", "%=", "<<=", ">>=", ">>>=", "&=", "|=", "^=", "=>", "...", "/", "/=", "**", "**=", "??", "?.", "&&=", "||=", "??=" ); /** * Punctuators LSM * * @var LSM */ protected $punctuatorsLSM; /** * Strings stops LSM * * @var LSM */ protected $stringsStopsLSM; /** * Brackets array * * @var array */ protected $brackets = array( "(" => "", "[" => "", "{" => "", ")" => "(", "]" => "[", "}" => "{" ); /** * Open brackets array * * @var array */ protected $openBrackets = array(); /** * Open templates array * * @var array */ protected $openTemplates = array(); /** * Whitespaces array * * @var array */ protected $whitespaces = array( " ", "\t", "\n", "\r", "\f", "\v", 0x00A0, 0xFEFF, 0x00A0, 0x1680, 0x2000, 0x2001, 0x2002, 0x2003, 0x2004, 0x2005, 0x2006, 0x2007, 0x2008, 0x2009, 0x200A, 0x202F, 0x205F, 0x3000, 0x2028, 0x2029 ); /** * Line terminators characters array * * @var array * * @static */ public static $lineTerminatorsChars = array("\n", "\r", 0x2028, 0x2029); /** * Line terminators sequences array * * @var array * * @static */ public static $lineTerminatorsSequences = array("\r\n"); /** * Regex to split texts using valid ES line terminators * * @var array */ protected $linesSplitter; /** * Concatenation of line terminators characters and line terminators * sequences * * @var array */ protected $lineTerminators; /** * Properties to copy when getting the scanner state * * @var array */ protected $stateProps = array("position", "index", "column", "line", "currentToken", "nextToken", "strictMode", "openBrackets", "openTemplates", "commentsMap"); /** * Decimal numbers * * @var array */ protected $numbers = array("0", "1", "2", "3", "4", "5", "6", "7", "8", "9"); /** * Hexadecimal numbers * * @var array */ protected $xnumbers = array("0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "a", "b", "c", "d", "e", "f", "A", "B", "C", "D", "E", "F"); /** * Octal numbers * * @var array */ protected $onumbers = array("0", "1", "2", "3", "4", "5", "6", "7"); /** * Binary numbers * * @var array */ protected $bnumbers = array("0", "1"); /** * Class constructor * * @param string $source Source code * @param Features $features Scanner features * @param array $options Parsing options */ function __construct( $source, Features $features, $options ) { $this->features = $features; $encoding = isset($options["sourceEncoding"]) ? $options["sourceEncoding"] : null; //Strip BOM characters from the source $this->stripBOM($source, $encoding); //Convert to UTF8 if needed if ($encoding && !preg_match("/UTF-?8/i", $encoding)) { $source = mb_convert_encoding($source, "UTF-8", $encoding); } //Instead of using mb_substr for each character, split the source //into an array of UTF8 characters for performance reasons $this->source = Utils::stringToUTF8Array( $source, !isset($options["strictEncoding"]) || $options["strictEncoding"] ); $this->length = count($this->source); //Convert character codes to UTF8 characters in whitespaces and line //terminators $this->lineTerminators = array_merge( self::$lineTerminatorsSequences, self::$lineTerminatorsChars ); foreach (array("whitespaces", "lineTerminators") as $key) { foreach ($this->$key as $i => $char) { if (is_int($char)) { $this->{$key}[$i] = Utils::unicodeToUtf8($char); } } } //Remove exponentiation operator if the feature //is not enabled if (!$this->features->exponentiationOperator) { Utils::removeArrayValue($this->punctuators, "**"); Utils::removeArrayValue($this->punctuators, "**="); } if (!$this->features->optionalChaining) { Utils::removeArrayValue($this->punctuators, "?."); } //Remove logical assignment operators if the feature //is not enabled if (!$this->features->logicalAssignmentOperators) { Utils::removeArrayValue($this->punctuators, "&&="); Utils::removeArrayValue($this->punctuators, "||="); Utils::removeArrayValue($this->punctuators, "??="); } //Create a LSM for punctuators array $this->punctuatorsLSM = new LSM($this->punctuators); //Create a LSM for strings stops $this->stringsStopsLSM = new LSM($this->lineTerminators, true); //Allow paragraph and line separators in strings if ($this->features->paragraphLineSepInStrings) { $this->stringsStopsLSM->remove(Utils::unicodeToUtf8(0x2028)); $this->stringsStopsLSM->remove(Utils::unicodeToUtf8(0x2029)); } //Remove await as keyword if async/await is enabled if ($this->features->asyncAwait) { Utils::removeArrayValue($this->keywords, "await"); } $this->linesSplitter = "/" . implode("|", $this->lineTerminators) . "/uS"; $this->position = new Position(0, 0, 0); } /** * Strips BOM characters from the source and detects source encoding if not * given by the user * * @param string $source Source * @param string $encoding User specified encoding */ public function stripBOM(&$source, &$encoding) { $boms = array( "\xEF" => array(array("\xBB", "\xBF"), "UTF-8"), "\xFE" => array(array("\xFF"), "UTF-16BE"), "\xFF" => array(array("\xFE"), "UTF-16LE"), ); if (!isset($source[0]) || !isset($boms[$source[0]])) { return; } $bom = $boms[$source[0]]; $l = count($bom[0]); for ($i = 0; $i < $l; $i++) { if (!isset($source[$i + 1]) || $source[$i + 1] !== $bom[0][$i]) { return; } } $source = substr($source, $l + 1); if (!$encoding) { $encoding = $bom[1]; } } /** * Enables or disables module scanning mode * * @param bool $enable True to enable module scanning mode, false to disable it * * @return $this */ public function enableModuleMode($enable = true) { $this->isModule = $enable; return $this; } /** * Enables or disables comments handling * * @param bool $enable True to enable comments handling, false to disable it * * @return $this */ public function enableComments($enable = true) { $this->comments = $enable; return $this; } /** * Enables or disables tokens registration in the token array * * @param bool $enable True to enable token registration, false to disable it * * @return $this */ public function enableTokenRegistration($enable = true) { $this->registerTokens = $enable; return $this; } /** * Return registered tokens * * @return array */ public function getTokens() { return $this->tokens; } /** * Returns the scanner's event emitter * * @return EventsEmitter */ public function getEventsEmitter() { if (!$this->eventsEmitter) { //The event emitter is created here so that it won't exist if not //necessary $this->eventsEmitter = new EventsEmitter; } return $this->eventsEmitter; } /** * Enables or disables strict mode * * @param bool $strictMode Strict mode state * * @return $this */ public function setStrictMode($strictMode) { $this->strictMode = $strictMode; return $this; } /** * Return strict mode state * * @return bool */ public function getStrictMode() { return $this->strictMode; } /** * Checks if the given token is a keyword in the current strict mode state * * @param Token $token Token to checks * * @return bool */ public function isStrictModeKeyword($token) { return $token->type === Token::TYPE_KEYWORD && (in_array($token->value, $this->keywords) || ( $this->strictMode && in_array($token->value, $this->strictModeKeywords))); } /** * Returns the current scanner state * * @return array */ public function getState() { //Consume current and next tokens so that they wont' be parsed again //if the state is restored. If the current token is a slash the next //token isn't parsed, this prevents some edge cases where a regexp //that contains something that can be interpreted as a comment causes //the content to be parsed as a real comment too $token = $this->currentToken ?: $this->getToken(); if ($token && $token->value !== "/") { $this->getNextToken(); } $state = array(); foreach ($this->stateProps as $prop) { $state[$prop] = $this->$prop; } if ($this->registerTokens) { $state["tokensNum"] = count($this->tokens); } //Emit the FreezeState event and pass the given state so that listeners //attached to this event can add data $this->eventsEmitter && $this->eventsEmitter->fire( "FreezeState", array(&$state) ); return $state; } /** * Sets the current scanner state * * @param array $state State * * @return $this */ public function setState($state) { if ($this->registerTokens) { //Check if tokens have been added if (isset($this->tokens[$state["tokensNum"]])) { //Remove all added tokens for ($i = count($this->tokens) - 1; $i >= $state["tokensNum"]; $i--) { array_pop($this->tokens); } } unset($state["tokensNum"]); } //Emit the ResetState event and pass the given state $this->eventsEmitter && $this->eventsEmitter->fire( "ResetState", array(&$state) ); foreach ($state as $key => $value) { $this->$key = $value; } return $this; } /** * Returns current scanner state * * @param bool $scanPosition By default this method returns the scanner * consumed position, if this parameter is true * the scanned position will be returned * * @return Position */ public function getPosition($scanPosition = false) { if ($scanPosition) { return new Position($this->line, $this->column, $this->index); } else { return $this->position; } } /** * Sets the current scan position at the given one * * @param Position $position Position at which the scan position will be set * * @return $this */ public function setScanPosition(Position $position) { $this->line = $position->getLine(); $this->column = $position->getColumn(); $this->index = $position->getIndex(); return $this; } /** * Return the character at the given index in the source code or null if the * end is reached. * * @param int $index Index, if not given it will use the current index * * @return string|null */ public function charAt($index = null) { if ($index === null) { $index = $this->index; } return $index < $this->length ? $this->source[$index] : null; } /** * Throws a syntax error * * @param string $message Error message * * @return void * * @throws Exception */ protected function error($message = null) { if (!$message) { $message = "Unexpected " . $this->charAt(); } throw new Exception($message, $this->getPosition(true)); } /** * Consumes the current token * * @return $this */ public function consumeToken() { //Move the scanner position to the end of the current position $this->position = $this->currentToken->location->end; //Before consume the token, consume comments associated with it if ($this->comments) { $this->consumeCommentsForCurrentToken(); } //Register the token if required if ($this->registerTokens) { $this->tokens[] = $this->currentToken; } //Emit the TokenConsumed event for the consumed token $this->eventsEmitter && $this->eventsEmitter->fire( "TokenConsumed", array($this->currentToken) ); $this->currentToken = $this->nextToken; $this->nextToken = null; return $this; } /** * Checks if the given string is matched, if so it consumes the token * * @param string $expected String to check * * @return Token|null */ public function consume($expected) { //Do not call getToken if there's already a pending token for //performance reasons $token = $this->currentToken ?: $this->getToken(); if ($token && $token->value === $expected) { $this->consumeToken(); return $token; } return null; } /** * Checks if one of the given strings is matched, if so it consumes the * token * * @param array $expected Strings to check * * @return Token|null */ public function consumeOneOf($expected) { //Do not call getToken if there's already a pending token for //performance reasons $token = $this->currentToken ?: $this->getToken(); if ($token && in_array($token->value, $expected)) { $this->consumeToken(); return $token; } return null; } /** * Checks that there are not line terminators following the current scan * position before next token * * @param bool $nextToken By default it checks the current token position * relative to the current position, if this * parameter is true the check will be done relative * to the next token * * @return bool */ public function noLineTerminators($nextToken = false) { if ($nextToken) { $nextToken = $this->getNextToken(); $refLine = !$nextToken ? null : $nextToken->location->end->getLine(); } else { $refLine = $this->getPosition()->getLine(); } $token = $this->currentToken ?: $this->getToken(); return $token && $token->location->start->getLine() === $refLine; } /** * Checks if one of the given strings follows the current scan position * * @param string|array $expected String or array of strings to check * @param bool $nextToken This parameter must be true if the first * parameter is an array so that it will * check also next tokens * * @return bool */ public function isBefore($expected, $nextToken = false) { $token = $this->currentToken ?: $this->getToken(); if (!$token) { return false; } elseif (in_array($token->value, $expected)) { return true; } elseif (!$nextToken) { return false; } if (!$this->getNextToken()) { return false; } foreach ($expected as $val) { if (!is_array($val) || $val[0] !== $token->value) { continue; } //If the second value in the array is true check that the current //token is not followed by line terminators, otherwise compare its //value to the next token if (($val[1] === true && $this->noLineTerminators(true)) || ($val[1] !== true && $val[1] === $this->nextToken->value)) { return true; } } return false; } /** * Returns the next token * * @return Token|null */ public function getNextToken() { if (!$this->nextToken) { $token = $this->currentToken ?: $this->getToken(); $this->currentToken = null; $this->nextToken = $this->getToken(true); $this->currentToken = $token; } return $this->nextToken; } /** * Returns the current token * * @param bool $skipEOFChecks True to skip end of file checks * even if the end is reached * * @return Token|null */ public function getToken($skipEOFChecks = false) { //The current token is returned until consumed if ($this->currentToken) { return $this->currentToken; } $comments = $this->skipWhitespacesAndComments(); //Emit the TokenCreated event for all the comments found if ($comments) { foreach ($comments as $comment) { $this->eventsEmitter && $this->eventsEmitter->fire( "TokenCreated", array($comment) ); } } //When the end of the source is reached if ($this->index >= $this->length) { //Check if there are open brackets if (!$skipEOFChecks) { foreach ($this->openBrackets as $bracket => $num) { if ($num) { $this->error("Unclosed $bracket"); } } //Check if there are open templates if (count($this->openTemplates)) { $this->error("Unterminated template"); } } //Register comments and consume them if ($this->comments && $comments) { $this->commentsForCurrentToken($comments); } //Emit the EndReached event when at the end of the source $this->eventsEmitter && $this->eventsEmitter->fire( "EndReached" ); return null; } $startPosition = $this->getPosition(true); $origException = null; try { //Try to match a token if ( ($this->jsx && ($token = $this->scanJSXIdentifier())) || ($token = $this->scanTemplate()) || ($token = $this->scanNumber()) || ($this->jsx && ($token = $this->scanJSXPunctuator())) || ($token = $this->scanPunctuator()) || ($token = $this->scanKeywordOrIdentifier()) || ($this->jsx && ($token = $this->scanJSXString())) || ($token = $this->scanString()) ) { //Set the token start and end positions $token->location->start = $startPosition; $token->location->end = $this->getPosition(true); $this->currentToken = $token; //Register comments if required if ($this->comments && $comments) { $this->commentsForCurrentToken($comments); } //Emit the TokenCreated event for the token just created $this->eventsEmitter && $this->eventsEmitter->fire( "TokenCreated", array($this->currentToken) ); return $this->currentToken; } } catch (Exception $e) { $origException = $e; } //If last token was "/" do not throw an error if the token has not be //recognized since it can be the first character in a regexp and it will //be consumed when the current token will be reconsumed as a regexp if ($this->isAfterSlash($startPosition)) { $this->setScanPosition($startPosition); return null; } //No valid token found. If there was a scan error, throw the same //exception again, otherwise throw a new error if ($origException) { throw $origException; } $this->error(); } /** * Executes the operations to handle the end of the source scanning * * @return $this */ public function consumeEnd() { //Consume final comments if ($this->comments) { $this->consumeCommentsForCurrentToken(); } //Emit the EndReached event when at the end of the source $this->eventsEmitter && $this->eventsEmitter->fire( "EndReached" ); return $this; } /** * Gets or sets comments for the current token. If the parameter is an * array it associates the given comments array to the current node, * otherwise comments for the current token are returned * * @param array $comments Comments array * * @return array */ protected function commentsForCurrentToken($comments = null) { $id = $this->currentToken ? spl_object_hash($this->currentToken) : ""; if ($comments !== null) { $this->commentsMap[$id] = $comments; } elseif (isset($this->commentsMap[$id])) { $comments = $this->commentsMap[$id]; unset($this->commentsMap[$id]); } return $comments; } /** * Consumes comment tokens associated with the current token * * @return $this */ protected function consumeCommentsForCurrentToken() { $comments = $this->commentsForCurrentToken(); if ($comments && ($this->registerTokens || $this->eventsEmitter)) { foreach ($comments as $comment) { //Register the token if required if ($this->registerTokens) { $this->tokens[] = $comment; } //Emit the TokenConsumed event for the comment $this->eventsEmitter && $this->eventsEmitter->fire( "TokenConsumed", array($comment) ); } } return $this; } /** * Checks if the given position follows a slash. * * @param Position $position Position to check * * @return bool */ protected function isAfterSlash($position) { //Start from the previous index and loop until the begin of the file is reached $idx = $position->getIndex() - 1; while ($idx >= 0) { //Get the char at the index to check $char = $this->charAt($idx); //If the char is actually a slash check that it's not a multiline comment closing slash if ($char === "/") { return $idx === 0 || $this->charAt($idx - 1) !== "*"; } //Skip whitespaces but not line terminators since regexps can't be multiline elseif (in_array($char, $this->whitespaces) && !in_array($char, $this->lineTerminators)) { $idx--; } //If "/=" is found, return true, this is the only operator that needs a special treatment //since it can be also the start of a regex elseif ($char === "=" && $this->charAt($idx - 1) === "/") { return true; } //Different character, return else { break; } } return false; } /** * Tries to reconsume the current token as a regexp if possible * * @return Token|null */ public function reconsumeCurrentTokenAsRegexp() { $token = $this->currentToken ?: $this->getToken(); $value = $token ? $token->value : null; //Check if the token starts with "/" if (!$value || $value[0] !== "/") { return null; } //Reset the scanner position to the token's start position $startPosition = $token->location->start; $this->setScanPosition($startPosition); $buffer = "/"; $this->index++; $this->column++; $inClass = false; while (true) { //In a characters class the delimiter "/" is allowed without escape, //so the characters class must be closed before closing the regexp $stops = $inClass ? array("]") : array("/", "["); $tempBuffer = $this->consumeUntil($stops); if ($tempBuffer === null) { if ($inClass) { $this->error( "Unterminated character class in regexp" ); } else { $this->error("Unterminated regexp"); } } $buffer .= $tempBuffer[0]; if ($tempBuffer[1] === "/") { break; } else { $inClass = $tempBuffer[1] === "["; } } //Flags while (($char = $this->charAt()) !== null) { $lower = strtolower($char); if ($lower >= "a" && $lower <= "z") { $buffer .= $char; $this->index++; $this->column++; } else { break; } } //If next token has already been parsed and it's a bracket exclude it //from the count of open brackets if ($this->nextToken) { $nextVal = $this->nextToken->value; if (isset($this->brackets[$nextVal]) && isset($this->openBrackets[$nextVal]) ) { if ($this->brackets[$nextVal]) { $this->openBrackets[$nextVal]++; } else { $this->openBrackets[$nextVal]--; } } $this->nextToken = null; } //If comments handling is enabled, get the comments associated with the //current token $comments = $this->comments ? $this->commentsForCurrentToken() : null; //Replace the current token with a regexp token $token = new Token(Token::TYPE_REGULAR_EXPRESSION, $buffer); $token->location->start = $startPosition; $token->location->end = $this->getPosition(true); $this->currentToken = $token; if ($comments) { //Attach the comments to the new current token $this->commentsForCurrentToken($comments); } return $this->currentToken; } /** * Skips whitespaces and comments from the current scan position. If * comments handling is enabled, the array of parsed comments * * @return array */ protected function skipWhitespacesAndComments() { $comments = []; $content = ""; $secStartIdx = $this->index; while (($char = $this->charAt()) !== null) { //Whitespace if (in_array($char, $this->whitespaces)) { $content .= $char; $this->index++; } elseif ($char === "/" || $char === "#") { $nextChar = $this->charAt($this->index + 1); if ($char === "#") { //Hashbang comment. This will be parsed only if hashbang comments are enabled //and if it appears at the beginning of the code $valid = $nextChar === "!" && $this->features->hashbangComments && !$this->index; } else { $valid = $nextChar === "/" || $nextChar === "*"; } //Comment if ($valid) { //If comments must be handled, empty the current content too //and get the comment start position if ($this->comments) { if ($content !== "") { $this->adjustColumnAndLine($content); $content = ""; } $start = $this->getPosition(true); } $inline = $nextChar !== "*"; $this->index += 2; $content .= $char . $nextChar; while (true) { $char = $this->charAt(); if ($char === null) { if (!$inline) { //If the end of the source has been reached and //a multiline comment is still open, it's an //error $this->error("Unterminated comment"); } $isEnd = true; } else { $content .= $char; $this->index++; $isEnd = $inline ? //Inline comment in_array($char, $this->lineTerminators) : //Multiline comment $char === "*" && $this->charAt() === "/"; } if ($isEnd) { if (!$inline) { $content .= "/"; $this->index++; } if ($this->comments) { //For inline comments the closing line //terminator must be excluded from comment text if ($inline && $char !== null) { $this->index--; $content = substr($content, 0, -strlen($char)); } $this->adjustColumnAndLine($content); $token = new Token(Token::TYPE_COMMENT, $content); $token->location->start = $start; $token->location->end = $this->getPosition(true); $comments[] = $token; //For inline comments the new content contains //the closing line terminator since the char has //already been processed $content = ""; if ($inline && $char !== null) { $content = $char; $this->index++; } } break; } } } else { break; } } elseif (!$this->isModule && $char === "<" && $this->charAt($this->index + 1) === "!" && $this->charAt($this->index + 2) === "-" && $this->charAt($this->index + 3) === "-" ) { //If comments must be handled, empty the current content too //and get the comment start position if ($this->comments) { if ($content !== "") { $this->adjustColumnAndLine($content); $content = ""; } $start = $this->getPosition(true); } //Open html comment $this->index += 4; $content .= ""; while (true) { $char = $this->charAt(); if ($char === null) { $isEnd = true; } else { $content .= $char; $this->index++; $isEnd = in_array($char, $this->lineTerminators); } if ($isEnd) { if ($this->comments) { //Remove the closing line terminator from the //comment text if ($char !== null) { $this->index--; $content = substr($content, 0, -strlen($char)); } $this->adjustColumnAndLine($content); $token = new Token(Token::TYPE_COMMENT, $content); $token->location->start = $start; $token->location->end = $this->getPosition(true); $comments[] = $token; $content = ""; if ($char !== null) { $content = $char; $this->index++; } } break; } } } else { break; } } else { break; } } if ($content !== "") { $this->adjustColumnAndLine($content); } return $comments; } /** * String scanning method * * @param bool $handleEscape True to handle escaping * * @return Token|null */ protected function scanString($handleEscape = true) { $char = $this->charAt(); if ($char === "'" || $char === '"') { $this->index++; $this->column++; //Add the quote to the LSM and then remove it after consuming $this->stringsStopsLSM->add($char); $buffer = $this->consumeUntil($this->stringsStopsLSM, $handleEscape); $this->stringsStopsLSM->remove($char); if ($buffer === null || $buffer[1] !== $char) { $this->error("Unterminated string"); } return new Token(Token::TYPE_STRING_LITERAL, $char . $buffer[0]); } return null; } /** * Template scanning method * * @return Token|null */ protected function scanTemplate() { $char = $this->charAt(); //Get the current number of open curly brackets $openCurly = isset($this->openBrackets["{"]) ? $this->openBrackets["{"] : 0; //If the character is a curly bracket check and the number of open //curly brackets matches the last number in the open templates stack, //then the bracket closes the open template expression $endExpression = false; if ($char === "}") { $len = count($this->openTemplates); if ($len && $this->openTemplates[$len - 1] === $openCurly) { $endExpression = true; array_pop($this->openTemplates); } } if ($char === "`" || $endExpression) { $this->index++; $this->column++; $buffer = $char; while (true) { $tempBuffer = $this->consumeUntil(array("`", "$")); if (!$tempBuffer) { $this->error("Unterminated template"); } $buffer .= $tempBuffer[0]; if ($tempBuffer[1] !== "$" || $this->charAt() === "{") { //If "${" is found it's a new template expression, register //the current number of open curly brackets in the open //templates stack if ($tempBuffer[1] === "$") { $this->index++; $this->column++; $buffer .= "{"; $this->openTemplates[] = $openCurly; } break; } } return new Token(Token::TYPE_TEMPLATE, $buffer); } return null; } /** * Number scanning method * * @return Token|null */ protected function scanNumber() { //Numbers can start with a decimal number or with a dot (.5) $char = $this->charAt(); if (!(($char >= "0" && $char <= "9") || $char === ".")) { return null; } $buffer = ""; $allowedDecimals = true; //Parse the integer part if ($char !== ".") { //Consume all decimal numbers $buffer = $this->consumeNumbers(); $char = $this->charAt(); if ($this->features->bigInt && $char === "n") { $this->index++; $this->column++; return new Token(Token::TYPE_BIGINT_LITERAL, $buffer . $char); } $lower = $char !== null ? strtolower($char) : null; //Handle hexadecimal (0x), octal (0o) and binary (0b) forms if ($buffer === "0" && $lower !== null && isset($this->{$lower . "numbers"}) ) { $this->index++; $this->column++; $tempBuffer = $this->consumeNumbers($lower); if ($tempBuffer === null) { $this->error("Missing numbers after 0$char"); } $buffer .= $char . $tempBuffer; //Check that there are not numbers left if ($this->consumeNumbers() !== null) { $this->error(); } if ($this->features->bigInt && $this->charAt() === "n") { $this->index++; $this->column++; return new Token(Token::TYPE_BIGINT_LITERAL, $buffer . $char); } return new Token(Token::TYPE_NUMERIC_LITERAL, $buffer); } //Consume exponent part if present if ($tempBuffer = $this->consumeExponentPart()) { $buffer .= $tempBuffer; $allowedDecimals = false; } } //Parse the decimal part if ($allowedDecimals && $this->charAt() === ".") { //Consume the dot $this->index++; $this->column++; $buffer .= "."; //Consume all decimal numbers $tempBuffer = $this->consumeNumbers(); $buffer .= $tempBuffer; //If the buffer contains only the dot it should be parsed as //punctuator if ($buffer === ".") { $this->index--; $this->column--; return null; } //Consume exponent part if present if (($tempBuffer = $this->consumeExponentPart()) !== null) { $buffer .= $tempBuffer; } } return new Token(Token::TYPE_NUMERIC_LITERAL, $buffer); } /** * Consumes the maximum number of digits * * @param string $type Digits type (decimal, hexadecimal, etc...) * @param int $max Maximum number of digits to match * * @return string|null */ protected function consumeNumbers($type = "", $max = null) { $buffer = ""; $char = $this->charAt(); $count = 0; $extra = $this->features->numericLiteralSeparator ? "_" : ""; while ( in_array($char, $this->{$type . "numbers"}) || ($count && $char === $extra) ) { $buffer .= $char; $this->index++; $this->column++; $count ++; if ($count === $max) { break; } $char = $this->charAt(); } if ($count && substr($buffer, -1) === "_") { $this->error( "Numeric separators are not allowed at the end of a number" ); } return $count ? $buffer : null; } /** * Consumes the exponent part of a number * * @return string|null */ protected function consumeExponentPart() { $buffer = ""; $char = $this->charAt(); if ($char !== null && strtolower($char) === "e") { $this->index++; $this->column++; $buffer .= $char; $char = $this->charAt(); if ($char === "+" || $char === "-") { $this->index++; $this->column++; $buffer .= $char; } $tempBuffer = $this->consumeNumbers(); if ($tempBuffer === null) { $this->error("Missing exponent"); } $buffer .= $tempBuffer; } return $buffer; } /** * Punctuator scanning method * * @return Token|null */ protected function scanPunctuator() { $token = null; $char = $this->charAt(); //Check if the next char is a bracket if (isset($this->brackets[$char])) { //Check if it is a closing bracket if ($this->brackets[$char]) { $openBracket = $this->brackets[$char]; //Check if there is a corresponding open bracket if (!isset($this->openBrackets[$openBracket]) || !$this->openBrackets[$openBracket] ) { if (!$this->isAfterSlash($this->getPosition(true))) { $this->error(); } } else { $this->openBrackets[$openBracket]--; } } else { if (!isset($this->openBrackets[$char])) { $this->openBrackets[$char] = 0; } $this->openBrackets[$char]++; } $this->index++; $this->column++; $token = new Token(Token::TYPE_PUNCTUATOR, $char); } elseif ( //Try to match the longest punctuator $match = $this->punctuatorsLSM->match($this, $this->index, $char) ) { //Optional chaining punctuator cannot appear before a number, in this //case only the question mark must be consumed if ($match[1] === "?." && ($nextChar = $this->charAt($this->index + $match[0])) !== null && $nextChar >= "0" && $nextChar <= "9" ) { $match = array(1, "?"); } $this->index += $match[0]; $this->column += $match[0]; $token = new Token(Token::TYPE_PUNCTUATOR, $match[1]); } return $token; } /** * Keywords and identifiers scanning method * * @return Token|null */ protected function scanKeywordOrIdentifier() { //Check private identifier start character if ($private = $this->features->privateMethodsAndFields && $this->charAt() === "#") { $this->index++; $this->column++; } //Consume the maximum number of characters that are unicode escape //sequences or valid identifier starts (only the first character) or //parts $buffer = ""; $start = true; while (($char = $this->charAt()) !== null) { if ( ($char >= "a" && $char <= "z") || ($char >= "A" && $char <= "Z") || $char === "_" || $char === "$" || (!$start && $char >= "0" && $char <= "9") || $this->isIdentifierChar($char, $start) ) { $buffer .= $char; $this->index++; $this->column++; } elseif ($char === "\\" && ($seq = $this->consumeUnicodeEscapeSequence())) { //Verify that it's a valid character if (!$this->isIdentifierChar($seq[1], $start)) { break; } $buffer .= $seq[0]; } else { break; } $start = false; } //Identify token type if ($buffer === "") { //Unconsume the hash if nothing was found after that if ($private) { $this->index--; $this->column--; } return null; } elseif ($private) { $type = Token::TYPE_PRIVATE_IDENTIFIER; $buffer = "#" . $buffer; } elseif ($buffer === "null") { $type = Token::TYPE_NULL_LITERAL; } elseif ($buffer === "true" || $buffer === "false") { $type = Token::TYPE_BOOLEAN_LITERAL; } elseif (in_array($buffer, $this->keywords) || in_array($buffer, $this->strictModeKeywords) ) { $type = Token::TYPE_KEYWORD; } else { $type = Token::TYPE_IDENTIFIER; } return new Token($type, $buffer); } /** * Consumes an unicode escape sequence * * @return array|null */ protected function consumeUnicodeEscapeSequence() { if ($this->charAt() !== "\\" || $this->charAt($this->index + 1) !== "u" ) { return null; } $startIndex = $this->index; $startColumn = $this->column; $this->index += 2; $this->column += 2; $brackets = false; if ($this->charAt() === "{") { //\u{FFF} $brackets = true; $this->index++; $this->column++; $code = $this->consumeNumbers("x"); if ($code && $this->charAt() !== "}") { $code = null; } else { $this->index++; $this->column++; } } else { //\uFFFF $code = $this->consumeNumbers("x", 4); if ($code && strlen($code) !== 4) { $code = null; } } //Unconsume everything if the format is invalid if ($code === null) { $this->index = $startIndex; $this->column = $startColumn; return null; } //Return an array where the first element is the matched sequence //and the second one is the decoded character return array( $brackets ? "\\u{" . $code . "}" : "\\u" . $code, Utils::unicodeToUtf8(hexdec($code)) ); } /** * Checks if the given character is valid for an identifier * * @param string $char Character to check * @param bool $start If true it will check that the character is * valid to start an identifier * * @return bool */ protected function isIdentifierChar($char, $start = true) { return ($char >= "a" && $char <= "z") || ($char >= "A" && $char <= "Z") || $char === "_" || $char === "$" || (!$start && $char >= "0" && $char <= "9") || preg_match($start ? $this->idStartRegex : $this->idPartRegex, $char); } /** * Increases columns and lines count according to the given string * * @param string $buffer String to analyze * * @return void */ protected function adjustColumnAndLine($buffer) { $lines = preg_split($this->linesSplitter, $buffer); $linesCount = count($lines) - 1; $this->line += $linesCount; $columns = mb_strlen($lines[$linesCount], "UTF-8"); if ($linesCount) { $this->column = $columns; } else { $this->column += $columns; } } /** * Consumes characters until one of the given characters is found * * @param array|LSM $stops Characters to search * @param bool $handleEscape True to handle escaping * @param bool $collectStop True to include the stop character * * @return array|null */ protected function consumeUntil( $stops, $handleEscape = true, $collectStop = true ) { $isLSM = $stops instanceof LSM; $buffer = ""; $escaped = false; while (($char = $this->charAt()) !== null) { $incrIndex = 1; $isStop = false; if ($isLSM) { $m = $stops->match($this, $this->index, $char); if ($m) { $isStop = true; $incrIndex = $m[0]; $char = $m[1]; } } else { $isStop = in_array($char, $stops); } $validStop = $isStop && !$escaped; if (!$validStop || $collectStop) { $this->index += $incrIndex; $buffer .= $char; } if ($validStop) { if (!$collectStop && $buffer === "") { return null; } $this->adjustColumnAndLine($buffer); return array($buffer, $char); } elseif (!$escaped && $char === "\\" && $handleEscape) { $escaped = true; } else { $escaped = false; } } return null; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax; /** * Utilities class. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Utils { /** * Converts a string to an array of UTF-8 characters * * @param string $str String to convert * @param bool $strictEncoding If false and the string contains invalid * UTF-8 characters, it will replace those * characters with the one defined in the * mbstring.substitute_character setting * * @return array * * @throws EncodingException */ static public function stringToUTF8Array($str, $strictEncoding = true) { if ($str === "") { return array(); } $ret = preg_split('//u', $str, -1, PREG_SPLIT_NO_EMPTY); if (preg_last_error() === PREG_BAD_UTF8_ERROR) { if (!$strictEncoding) { $str = mb_convert_encoding($str, 'UTF-8', 'UTF-8'); $ret = self::stringToUTF8Array($str, false); } else { throw new EncodingException("String contains invalid UTF-8"); } } return $ret; } /** * Converts an unicode code point to UTF-8 * * @param int $num Unicode code point * * @return string * * @codeCoverageIgnore */ static public function unicodeToUtf8($num) { //From: http://stackoverflow.com/questions/1805802/php-convert-unicode-codepoint-to-utf-8#answer-7153133 if ($num <= 0x7F) { return chr($num); } elseif ($num <= 0x7FF) { return chr(($num >> 6) + 192) . chr(($num & 63) + 128); } elseif ($num <= 0xFFFF) { return chr(($num >> 12) + 224) . chr((($num >> 6) & 63) + 128) . chr(($num & 63) + 128); } elseif ($num <= 0x1FFFFF) { return chr(($num >> 18) + 240) . chr((($num >> 12) & 63) + 128) . chr((($num >> 6) & 63) + 128) . chr(($num & 63) + 128); } return ''; } /** * Compiled line terminators cache * * @var array */ protected static $lineTerminatorsCache; /** * Returns line terminators array * * @return array */ protected static function getLineTerminators() { if (!self::$lineTerminatorsCache) { self::$lineTerminatorsCache = array(); foreach (Scanner::$lineTerminatorsChars as $char) { self::$lineTerminatorsCache[] = is_int($char) ? self::unicodeToUtf8($char) : $char; } } return self::$lineTerminatorsCache; } /** * Converts a surrogate pair of Unicode code points to UTF-8 * * @param string $first First Unicode code point * @param string $second Second Unicode code point * * @return string * * @codeCoverageIgnore */ static public function surrogatePairToUtf8($first, $second) { //From: https://stackoverflow.com/questions/39226593/how-to-convert-utf16-surrogate-pairs-to-equivalent-hex-codepoint-in-php $value = ((hexdec($first) & 0x3ff) << 10) | (hexdec($second) & 0x3ff); return self::unicodeToUtf8($value + 0x10000); } /** * This function takes a string as it appears in the source code and returns * an unquoted version of it * * @param string $str The string to unquote * * @return string */ static public function unquoteLiteralString($str) { //Remove quotes $str = substr($str, 1, -1); //Return immediately if the escape character is missing if (strpos($str, "\\") === false) { return $str; } $lineTerminators = self::getLineTerminators(); //Surrogate pairs regex $surrogatePairsReg = sprintf( 'u(?:%1$s|\{%1$s\})\\\\u(?:%2$s|\{%2$s\})', "[dD][89abAB][0-9a-fA-F]{2}", "[dD][c-fC-F][0-9a-fA-F]{2}" ); //Handle escapes $patterns = array( $surrogatePairsReg, "u\{[a-fA-F0-9]+\}", "u[a-fA-F0-9]{4}", "x[a-fA-F0-9]{2}", "0[0-7]{2}", "[1-7][0-7]", "." ); $reg = "/\\\\(" . implode("|", $patterns) . ")/s"; $simpleSequence = array( "n" => "\n", "f" => "\f", "r" => "\r", "t" => "\t", "v" => "\v", "b" => "\x8" ); $replacement = function ($m) use ($simpleSequence, $lineTerminators) { $type = $m[1][0]; if (isset($simpleSequence[$type])) { // \n, \r, \t ... return $simpleSequence[$type]; } elseif ($type === "u" || $type === "x") { //Invalid unicode or hexadecimal sequences if (strlen($m[1]) === 1) { return "\\$type"; } // Surrogate pair if ($type === "u" && strpos($m[1], "\\") !== false) { $points = explode("\\", $m[1]); return Utils::surrogatePairToUtf8( str_replace(array("{", "}", "u"), "", $points[0]), str_replace(array("{", "}", "u"), "", $points[1]) ); } // \uFFFF, \u{FFFF}, \xFF $code = substr($m[1], 1); $code = str_replace(array("{", "}"), "", $code); return Utils::unicodeToUtf8(hexdec($code)); } elseif ($type >= "0" && $type <= "7") { //Invalid octal sequences if (strlen($m[1]) === 1) { return "\\$type"; } // \123 return Utils::unicodeToUtf8(octdec($m[1])); } elseif (in_array($m[1], $lineTerminators)) { // Escaped line terminators return ""; } else { // Escaped characters return $m[1]; } }; return preg_replace_callback($reg, $replacement, $str); } /** * This function converts a string to a quoted javascript string * * @param string $str String to quote * @param string $quote Quote character * * @return string */ static public function quoteLiteralString($str, $quote) { $escape = self::getLineTerminators(); $escape[] = $quote; $escape[] = "\\\\"; $reg = "/(" . implode("|", $escape) . ")/"; $str = preg_replace($reg, "\\\\$1", $str); return $quote . $str . $quote; } /** * Returns the properties map for the given node * * @param mixed $node Node or class to consider * * @return array */ static protected function getPropertiesMap($node) { static $cache = array(); if ($node instanceof \ReflectionClass) { $className = $node->getName(); } else { $className = get_class($node); } if (!isset($cache[$className])) { $class = new \ReflectionClass($className); $parent = $class->getParentClass(); $props = $parent ? self::getPropertiesMap($parent) : array(); $defaults = $class->getDefaultProperties(); if (isset($defaults["propertiesMap"])) { $props = array_merge($props, $defaults["propertiesMap"]); } $cache[$className] = $props; } return $cache[$className]; } /** * Returns the properties list for the given node * * @param Node\Node $node Node to consider * @param bool $traversable If true it returns only traversable properties * * @return array */ static public function getNodeProperties(Node\Node $node, $traversable = false) { $props = self::getPropertiesMap($node); return array_map( function ($prop) { $ucProp = ucfirst($prop); return array( "name" => $prop, "getter" => "get$ucProp", "setter" => "set$ucProp" ); }, array_keys($traversable ? array_filter($props) : $props) ); } /** * Returns an expanded version of the traversable node properties. * The return of the function is an array of node properties * values with arrays flattened * * @param Node\Node $node Node * * @return array */ static public function getExpandedNodeProperties(Node\Node $node) { $ret = array(); $props = self::getNodeProperties($node, true); foreach ($props as $prop) { $val = $node->{$prop["getter"]}(); if (is_array($val)) { $ret = array_merge($ret, $val); } else { $ret[] = $val; } } return $ret; } /** * Delete an array element by value * * @param array $array Array * @param mixed $val Value to remove * * @return void */ static public function removeArrayValue(&$array, $val) { array_splice($array, array_search($val, $array), 1); } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\ES2025; /** * ES2025 features class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Features extends \Peast\Syntax\ES2024\Features { /** * Import attributes * * @var bool */ public $importAttributes = true; }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\ES2024; /** * ES2024 features class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Features extends \Peast\Syntax\ES2023\Features { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\ES2017; /** * ES2017 features class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Features extends \Peast\Syntax\ES2016\Features { /** * Async/await * * @var bool */ public $asyncAwait = true; /** * Trailing comma in function calls and declarations * * @var bool */ public $trailingCommaFunctionCallDeclaration = true; /** * For-in initializer * * @var bool */ public $forInInitializer = true; }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax; /** * Longest Sequence Matcher. Utility class used by the scanner to consume * the longest sequence of character given a set of allowed characters sequences. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class LSM { /** * Internal sequences map * * @var array */ protected $map = array(); /** * Encoding handle flag * * @var bool */ protected $handleEncoding = false; /** * Class constructor * * @param array $sequences Allowed characters sequences * @param bool $handleEncoding True to handle encoding when matching */ function __construct($sequences, $handleEncoding = false) { $this->handleEncoding = $handleEncoding; foreach ($sequences as $s) { $this->add($s); } } /** * Adds a sequence * * @param string $sequence Sequence to add * * @return $this */ public function add($sequence) { if ($this->handleEncoding) { $s = Utils::stringToUTF8Array($sequence); $first = $s[0]; $len = count($s); } else { $first = $sequence[0]; $len = strlen($sequence); } if (!isset($this->map[$first])) { $this->map[$first] = array( "maxLen" => $len, "map" => array($sequence) ); } else { $this->map[$first]["map"][] = $sequence; $this->map[$first]["maxLen"] = max($this->map[$first]["maxLen"], $len); } return $this; } /** * Removes a sequence * * @param string $sequence Sequence to remove * * @return $this */ public function remove($sequence) { if ($this->handleEncoding) { $s = Utils::stringToUTF8Array($sequence); $first = $s[0]; } else { $first = $sequence[0]; } if (isset($this->map[$first])) { $len = $this->handleEncoding ? count($s) : strlen($sequence); $this->map[$first]["map"] = array_diff( $this->map[$first]["map"], array($sequence) ); if (!count($this->map[$first]["map"])) { unset($this->map[$first]); } elseif ($this->map[$first]["maxLen"] === $len) { // Recalculate the max length if necessary foreach ($this->map[$first]["map"] as $m) { $this->map[$first]["maxLen"] = max( $this->map[$first]["maxLen"], strlen($m) ); } } } return $this; } /** * Executes the match. It returns an array where the first element is the * number of consumed characters and the second element is the match. If * no match is found it returns null. * * @param Scanner $scanner Scanner instance * @param int $index Current index * @param string $char Current character * * @return array|null */ public function match($scanner, $index, $char) { $consumed = 1; $bestMatch = null; if (isset($this->map[$char])) { //If the character is present in the map and it has a max length of //1, match immediately if ($this->map[$char]["maxLen"] === 1) { $bestMatch = array($consumed, $char); } else { //Otherwise consume a number of characters equal to the max //length and find the longest match $buffer = $char; $map = $this->map[$char]["map"]; $maxLen = $this->map[$char]["maxLen"]; do { if (in_array($buffer, $map)) { $bestMatch = array($consumed, $buffer); } $nextChar = $scanner->charAt($index + $consumed); if ($nextChar === null) { break; } $buffer .= $nextChar; $consumed++; } while ($consumed <= $maxLen); } } return $bestMatch; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax; /** * This class represents a location in the source code with start and end * position. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class SourceLocation implements \JSONSerializable { /** * Start position * * @var Position */ public $start; /** * End position * * @var Position */ public $end; /** * Returns the start position * * @return Position */ public function getStart() { return $this->start; } /** * Sets the start position * * @param Position $position Start position * * @return $this */ public function setStart(Position $position) { $this->start = $position; return $this; } /** * Returns the end position * * @return Position */ public function getEnd() { return $this->end; } /** * Sets the end position * * @param Position $position End position * * @return $this */ public function setEnd(Position $position) { $this->end = $position; return $this; } /** * Returns a serializable version of the object * * @return array */ #[\ReturnTypeWillChange] public function jsonSerialize() { return array( "start" => $this->start, "end" => $this->end ); } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\ES2022; /** * ES2022 features class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Features extends \Peast\Syntax\ES2021\Features { /** * Private methods and fields * * @var bool */ public $privateMethodsAndFields = true; /** * Class fields * * @var bool */ public $classFields = true; /** * "in" operator for private fields * * @var bool */ public $classFieldsPrivateIn = true; /** * Top level await * * @var bool */ public $topLevelAwait = true; /** * Class static block * * @var bool */ public $classStaticBlock = true; /** * Arbitrary module namespace identifier names * * @var bool */ public $arbitraryModuleNSNames = true; }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\ES2016; /** * ES2016 features class * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @codeCoverageIgnore */ class Features extends \Peast\Syntax\ES2015\Features { /** * Exponentiation operator * * @var bool */ public $exponentiationOperator = true; }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a declaration in a VariableDeclaration node. * For example "a=1" in: var a = 1 * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class VariableDeclarator extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "id" => true, "init" => true ); /** * Declaration identifier or pattern * * @var Pattern */ protected $id; /** * Optional initializer * * @var Expression */ protected $init; /** * Returns the declaration identifier or pattern * * @return Pattern */ public function getId() { return $this->id; } /** * Sets the declaration identifier or pattern * * @param Pattern $id Declaration identifier or pattern * * @return $this */ public function setId(Pattern $id) { $this->id = $id; return $this; } /** * Returns the initializer * * @return Expression */ public function getInit() { return $this->init; } /** * Sets the initializer * * @param Expression $init Initializer * * @return $this */ public function setInit($init) { $this->assertType($init, "Expression", true); $this->init = $init; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a specifier in an import declaration. * For example "{a}" in: import {a} from "test" * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ImportSpecifier extends ModuleSpecifier { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "imported" => true ); /** * Imported identifier * * @var Identifier|StringLiteral */ protected $imported; /** * Returns the imported identifier * * @return Identifier|StringLiteral */ public function getImported() { return $this->imported; } /** * Sets the imported identifier * * @param Identifier|StringLiteral $imported Imported identifier * * @return $this */ public function setImported($imported) { $this->assertType($imported, array("Identifier", "StringLiteral")); $this->imported = $imported; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents the "this" keyword. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ThisExpression extends Node implements Expression { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an array binding pattern. * For example: [a, b, c] = d * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ArrayPattern extends Node implements Pattern { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "elements" => true ); /** * Array elements * * @var Pattern[] */ protected $elements = array(); /** * Returns array elements * * @return Pattern[] */ public function getElements() { return $this->elements; } /** * Sets array elements * * @param Pattern[] $elements Array elements to set * * @return $this */ public function setElements($elements) { $this->assertArrayOf($elements, "Pattern", true); $this->elements = $elements; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a case in a switch statement. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class SwitchCase extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "test" => true, "consequent" => true ); /** * Test expression that is null in the "default" case * * @var Expression */ protected $test; /** * Consequent statements array * * @var Statement[] */ protected $consequent = array(); /** * Returns the test expression that is null in the "default" case * * @return Expression */ public function getTest() { return $this->test; } /** * Sets the test expression that is null in the "default" case * * @param Expression $test Test expression * * @return $this */ public function setTest($test) { $this->assertType($test, "Expression", true); $this->test = $test; return $this; } /** * Returns the consequent statements array * * @return Statement[] */ public function getConsequent() { return $this->consequent; } /** * Sets the consequent statements array * * @param Expression[] $consequent Consequent statements array * * @return $this */ public function setConsequent($consequent) { $this->assertArrayOf($consequent, "Statement"); $this->consequent = $consequent; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * Interface that every statement node must implement. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ interface Statement { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an object literal. * For example: {a: 1, b: 2, c: 3} * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ObjectExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "properties" => true ); /** * Object properties * * @var Property[] */ protected $properties = array(); /** * Returns object properties * * @return Property[] */ public function getProperties() { return $this->properties; } /** * Sets object properties * * @param Property[] $properties Object properties * * @return $this */ public function setProperties($properties) { $this->assertArrayOf($properties, array("Property", "SpreadElement")); $this->properties = $properties; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an update expression. * For example: a++ * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class UpdateExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "argument" => true, "operator" => false, "prefix" => false ); /** * Expression's operator * * @var string */ protected $operator; /** * Prefix flag that is true when the operator precedes the argument * * @var bool */ protected $prefix = false; /** * Expression's argument * * @var Expression */ protected $argument; /** * Returns the expression's operator * * @return string */ public function getOperator() { return $this->operator; } /** * Sets the expression's operator * * @param string $operator Operator * * @return $this */ public function setOperator($operator) { $this->operator = $operator; return $this; } /** * Returns the prefix flag that is true when the operator precedes the * argument * * @return bool */ public function getPrefix() { return $this->prefix; } /** * Sets the prefix flag that is true when the operator precedes the * argument * * @param bool $prefix Prefix flag * * @return $this */ public function setPrefix($prefix) { $this->prefix = $prefix; return $this; } /** * Returns the expression's argument * * @return Expression */ public function getArgument() { return $this->argument; } /** * Sets the expression's argument * * @param Expression $argument Argument * * @return $this */ public function setArgument(Expression $argument) { $this->argument = $argument; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an await expression. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class AwaitExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "argument" => true ); /** * Expression's argument * * @var Expression */ protected $argument; /** * Returns the expression's argument * * @return Expression */ public function getArgument() { return $this->argument; } /** * Sets the expression's argument * * @param Expression $argument Argument * * @return $this */ public function setArgument(Expression $argument) { $this->argument = $argument; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a logical expression. * For example: a && b * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class LogicalExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "left" => true, "operator" => false, "right" => true ); /** * Operator * * @var string */ protected $operator; /** * Left expression * * @var Expression */ protected $left; /** * Right expression * * @var Expression */ protected $right; /** * Returns the operator * * @return string */ public function getOperator() { return $this->operator; } /** * Sets the operator * * @param string $operator Operator * * @return $this */ public function setOperator($operator) { $this->operator = $operator; return $this; } /** * Returns the left expression * * @return Expression */ public function getLeft() { return $this->left; } /** * Sets the left expression * * @param Expression $left Left expression * * @return $this */ public function setLeft(Expression $left) { $this->left = $left; return $this; } /** * Returns the right expression * * @return Expression */ public function getRight() { return $this->right; } /** * Sets the right expression * * @param Expression $right Right expression * * @return $this */ public function setRight(Expression $right) { $this->right = $right; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a binary expression. * For example: a + b * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class BinaryExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "left" => true, "operator" => false, "right" => true ); /** * Operator * * @var string */ protected $operator; /** * Left expression * * @var Expression|PrivateIdentifier */ protected $left; /** * Right expression * * @var Expression */ protected $right; /** * Returns the operator * * @return string */ public function getOperator() { return $this->operator; } /** * Sets the operator * * @param string $operator Operator * * @return $this */ public function setOperator($operator) { $this->operator = $operator; return $this; } /** * Returns the left expression * * @return Expression|PrivateIdentifier */ public function getLeft() { return $this->left; } /** * Sets the left expression * * @param Expression|PrivateIdentifier $left Left expression * * @return $this */ public function setLeft($left) { $this->assertType($left, array("Expression", "PrivateIdentifier")); $this->left = $left; return $this; } /** * Returns the right expression * * @return Expression */ public function getRight() { return $this->right; } /** * Sets the right expression * * @param Expression $right Right expression * * @return $this */ public function setRight(Expression $right) { $this->right = $right; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; use Peast\Syntax\Utils; /** * A node that represents an identifier. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Identifier extends Node implements Expression, Pattern { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "name" => false, "rawName" => false, ); /** * The identifier's name * * @var string */ protected $name; /** * The identifier's raw name * * @var string */ protected $rawName; /** * Returns the identifier's name * * @return string */ public function getName() { return $this->name; } /** * Sets the identifier's name * * @param string $name The name to set * * @return $this */ public function setName($name) { $this->name = $this->rawName = $name; return $this; } /** * Returns the identifier's raw name * * @return string */ public function getRawName() { return $this->rawName; } /** * Sets the identifier's raw name * * @param string $name The raw name to set * * @return $this */ public function setRawName($name) { $this->rawName = $name; if (strpos($name, "\\") !== false) { $this->name = preg_replace_callback( "#\\\\u(?:\{([a-fA-F0-9]+)\}|([a-fA-F0-9]{4}))#", function ($match) { return Utils::unicodeToUtf8(hexdec($match[1] ? : $match[2])); }, $name ); } else { $this->name = $name; } return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents the export default declaration. * For example: export default a * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ExportDefaultDeclaration extends Node implements ModuleDeclaration { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "declaration" => true ); /** * The exported declaration * * @var Declaration|Expression */ protected $declaration; /** * Returns the exported declaration * * @return Declaration|Expression */ public function getDeclaration() { return $this->declaration; } /** * Sets the exported declaration * * @param Declaration|Expression $declaration The exported declaration * * @return $this */ public function setDeclaration($declaration) { $this->assertType($declaration, array("Declaration", "Expression")); $this->declaration = $declaration; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a method declaration in classes and object literals. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class MethodDefinition extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "key" => true, "value" => true, "kind" => false, "computed" => false, "static" => false ); //Kind constants /** * Constructor method */ const KIND_CONSTRUCTOR = "constructor"; /** * Standard method */ const KIND_METHOD = "method"; /** * Getter method */ const KIND_GET = "get"; /** * Setter method */ const KIND_SET = "set"; /** * Method's key * * @var Expression|PrivateIdentifier */ protected $key; /** * Method's value * * @var FunctionExpression */ protected $value; /** * Method's kind that is one of the kind constants * * @var string */ protected $kind = self::KIND_METHOD; /** * Computed flag that is true if method's key is declared using square * brackets syntax * * @var bool */ protected $computed = false; /** * Static flag that is true if the method is static * * @var bool */ protected $static = false; /** * Returns the method's key * * @return Expression|PrivateIdentifier */ public function getKey() { return $this->key; } /** * Sets the method's key * * @param Expression|PrivateIdentifier $key Method's key * * @return $this */ public function setKey($key) { $this->assertType($key, array("Expression", "PrivateIdentifier")); $this->key = $key; return $this; } /** * Returns the method's value * * @return FunctionExpression */ public function getValue() { return $this->value; } /** * Sets the method's value * * @param FunctionExpression $value Method's value * * @return $this */ public function setValue(FunctionExpression $value) { $this->value = $value; return $this; } /** * Returns the method's kind that is one of the kind constants * * @return string */ public function getKind() { return $this->kind; } /** * Sets the method's kind that is one of the kind constants * * @param string $kind Method's kind * * @return $this */ public function setKind($kind) { $this->kind = $kind; return $this; } /** * Returns the computed flag that is true if method's key is declared using * square brackets syntax * * @return bool */ public function getComputed() { return $this->computed; } /** * Sets the computed flag that is true if method's key is declared using * square brackets syntax * * @param bool $computed Computed flag * * @return $this */ public function setComputed($computed) { $this->computed = (bool) $computed; return $this; } /** * Returns the static flag that is true if the method is static * * @return bool */ public function getStatic() { return $this->{"static"}; } /** * Sets the static flag that is true if the method is static * * @param bool $static Static flag * * @return $this */ public function setStatic($static) { $this->{"static"} = (bool) $static; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents the "break" statement inside loops. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class BreakStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "label" => true ); /** * The optional label of the break statement * * @var Identifier */ protected $label; /** * Returns the node's label * * @return Identifier */ public function getLabel() { return $this->label; } /** * Sets the node's label * * @param Identifier $label Node's label * * @return $this */ public function setLabel($label) { $this->assertType($label, "Identifier", true); $this->label = $label; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an empty statement (;). * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class EmptyStatement extends Node implements Statement { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a class expression * For example: test = class {} * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ClassExpression extends Class_ implements Expression { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; /** * A node that represents a JSX opening element tag. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXOpeningElement extends JSXBoundaryElement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "attributes" => true, "selfClosing" => false ); /** * Children nodes array * * @var JSXAttribute[]|JSXSpreadAttribute[] */ protected $attributes = array(); /** * Self closing tag mode * * @var bool */ protected $selfClosing = false; /** * Returns the children attributes array * * @return JSXAttribute[]|JSXSpreadAttribute[] */ public function getAttributes() { return $this->attributes; } /** * Sets the attributes nodes array * * @param JSXAttribute[]|JSXSpreadAttribute[] $attributes Attributes nodes * array * * @return $this */ public function setAttributes($attributes) { $this->assertArrayOf($attributes, array( "JSX\\JSXAttribute", "JSX\\JSXSpreadAttribute" )); $this->attributes = $attributes; return $this; } /** * Returns the self closing tag mode * * @return bool */ public function getSelfClosing() { return $this->selfClosing; } /** * Sets the self closing tag mode * * @param bool $selfClosing Self closing tag mode * * @return $this */ public function setSelfClosing($selfClosing) { $this->selfClosing = (bool) $selfClosing; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\Node; /** * A node that represents a JSX attribute. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXAttribute extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "name" => true, "value" => true ); /** * Attribute name * * @var JSXIdentifier|JSXNamespacedName */ protected $name; /** * Attribute value * * @var Node|null */ protected $value; /** * Returns the attribute name * * @return Node */ public function getName() { return $this->name; } /** * Sets the attribute name * * @param JSXIdentifier|JSXNamespacedName $name Attribute name * * @return $this */ public function setName($name) { $this->assertType($name, array("JSX\\JSXIdentifier", "JSX\\JSXNamespacedName")); $this->name = $name; return $this; } /** * Returns the attribute value * * @return Node|null */ public function getValue() { return $this->value; } /** * Sets the attribute value * * @param Node|null $value Attribute value * * @return $this */ public function setValue($value) { $this->assertType( $value, array( "Literal", "JSX\\JSXExpressionContainer", "JSX\\JSXElement", "JSX\\JSXFragment" ), true ); $this->value = $value; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; /** * A node that represents a JSX closing element tag. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXClosingElement extends JSXBoundaryElement { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\Node; use Peast\Syntax\Node\Expression; /** * A node that represents a JSX fragment. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXFragment extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "openingFragment" => true, "children" => true, "closingFragment" => true ); /** * Opening fragment node * * @var JSXOpeningFragment */ protected $openingFragment; /** * Children nodes array * * @var Node[] */ protected $children = array(); /** * Closing fragment node * * @var JSXClosingFragment */ protected $closingFragment; /** * Returns the opening fragment node * * @return JSXOpeningFragment */ public function getOpeningFragment() { return $this->openingFragment; } /** * Sets the opening fragment node * * @param JSXOpeningFragment $openingFragment Opening fragment node * * @return $this */ public function setOpeningFragment(JSXOpeningFragment $openingFragment) { $this->openingFragment = $openingFragment; return $this; } /** * Returns the children nodes array * * @return Node[] */ public function getChildren() { return $this->children; } /** * Sets the children nodes array * * @param Node[] $children Children nodes array * * @return $this */ public function setChildren($children) { $this->assertArrayOf($children, array( "JSX\\JSXText", "JSX\\JSXExpressionContainer", "JSX\\JSXSpreadChild", "JSX\\JSXElement", "JSX\\JSXFragment" )); $this->children = $children; return $this; } /** * Returns the closing fragment node * * @return JSXClosingFragment */ public function getClosingFragment() { return $this->closingFragment; } /** * Sets the closing fragment node * * @param JSXClosingFragment $closingFragment Closing fragment node * * @return $this */ public function setClosingFragment(JSXClosingFragment $closingFragment) { $this->closingFragment = $closingFragment; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\Node; /** * A node that represents an expression container in JSX. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXExpressionContainer extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "expression" => true ); /** * The wrapped expression * * @var \Peast\Syntax\Node\Expression|JSXEmptyExpression */ protected $expression; /** * Returns the wrapped expression * * @return \Peast\Syntax\Node\Expression|JSXEmptyExpression */ public function getExpression() { return $this->expression; } /** * Sets the wrapped expression * * @param \Peast\Syntax\Node\Expression|JSXEmptyExpression $expression Wrapped * expression * * @return $this */ public function setExpression($expression) { $this->assertType( $expression, array("Expression", "JSX\\JSXEmptyExpression") ); $this->expression = $expression; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\Node; /** * A node that represents a JSX closing fragment tag. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXText extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "value" => false, "raw" => false ); /** * Node's value * * @var mixed */ protected $value; /** * Node's raw value * * @var string */ protected $raw; /** * Returns node's value * * @return mixed */ public function getValue() { return $this->value; } /** * Sets node's value * * @param mixed $value Value * * @return $this */ public function setValue($value) { $this->value = $value; $this->raw = $value; return $this; } /** * Return node's raw value * * @return string */ public function getRaw() { return $this->raw; } /** * Sets node's raw value * * @param mixed $raw Raw value * * @return $this */ public function setRaw($raw) { return $this->setValue($raw); } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\Node; use Peast\Syntax\Node\Expression; /** * A node that represents a spread child expression in JSX. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXSpreadChild extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "expression" => true ); /** * The wrapped expression * * @var Expression */ protected $expression; /** * Returns the wrapped expression * * @return Expression */ public function getExpression() { return $this->expression; } /** * Sets the wrapped expression * * @param Expression $expression Wrapped expression * * @return $this */ public function setExpression(Expression $expression) { $this->expression = $expression; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\SpreadElement; /** * A node that represents a JSX spread attribute. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXSpreadAttribute extends SpreadElement { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\Node; /** * A base class for boundary elements. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @abstract */ abstract class JSXBoundaryElement extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "name" => true ); /** * Element name * * @var JSXIdentifier|JSXMemberExpression|JSXNamespacedName */ protected $name; /** * Returns the element name * * @return JSXIdentifier|JSXMemberExpression|JSXNamespacedName */ public function getName() { return $this->name; } /** * Sets the element name * * @param JSXIdentifier|JSXMemberExpression|JSXNamespacedName $name Element * name * * @return $this */ public function setName($name) { $this->assertType( $name, array("JSX\\JSXIdentifier", "JSX\\JSXMemberExpression", "JSX\\JSXNamespacedName") ); $this->name = $name; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\Node; use Peast\Syntax\Node\Expression; /** * A node that represents a JSX element. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXElement extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "openingElement" => true, "children" => true, "closingElement" => true ); /** * Opening element node * * @var JSXOpeningElement */ protected $openingElement; /** * Children nodes array * * @var Node[] */ protected $children = array(); /** * Closing element node * * @var JSXClosingElement|null */ protected $closingElement; /** * Returns the opening element node * * @return JSXOpeningElement */ public function getOpeningElement() { return $this->openingElement; } /** * Sets the opening element node * * @param JSXOpeningElement $openingElement Opening element node * * @return $this */ public function setOpeningElement(JSXOpeningElement $openingElement) { $this->openingElement = $openingElement; return $this; } /** * Returns the children nodes array * * @return Node[] */ public function getChildren() { return $this->children; } /** * Sets the children nodes array * * @param Node[] $children Children nodes array * * @return $this */ public function setChildren($children) { $this->assertArrayOf($children, array( "JSX\\JSXText", "JSX\\JSXExpressionContainer", "JSX\\JSXSpreadChild", "JSX\\JSXElement", "JSX\\JSXFragment" )); $this->children = $children; return $this; } /** * Returns the closing element node * * @return JSXClosingElement|null */ public function getClosingElement() { return $this->closingElement; } /** * Sets the closing element node * * @param JSXClosingElement|null $closingElement Closing element node * * @return $this */ public function setClosingElement($closingElement) { $this->assertType($closingElement, "JSX\\JSXClosingElement", true); $this->closingElement = $closingElement; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\Node; /** * A node that represents a JSX opening fragment tag. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXOpeningFragment extends Node { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\Node; use Peast\Syntax\Node\Expression; /** * A node that represents a JSX namespaced name. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXNamespacedName extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "namespace" => false, "name" => false ); /** * Node's namespace * * @var JSXIdentifier */ protected $namespace; /** * Node's name * * @var JSXIdentifier */ protected $name; /** * Returns node's namespace * * @return JSXIdentifier */ public function getNamespace() { return $this->namespace; } /** * Sets node's namespace * * @param JSXIdentifier $namespace Namespace * * @return $this */ public function setNamespace($namespace) { $this->namespace = $namespace; return $this; } /** * Return node's name * * @return JSXIdentifier */ public function getName() { return $this->name; } /** * Sets node's name * * @param JSXIdentifier $name Name * * @return $this */ public function setName($name) { $this->name = $name; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\Node; use Peast\Syntax\Node\Expression; /** * A node that represents a JSX member expression. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXMemberExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "object" => true, "property" => true ); /** * Expression's object * * @var JSXMemberExpression|JSXIdentifier */ protected $object; /** * Expression's property * * @var JSXIdentifier */ protected $property; /** * Returns the expression's object * * @return JSXMemberExpression|JSXIdentifier */ public function getObject() { return $this->object; } /** * Sets the expression's object * * @param JSXMemberExpression|JSXIdentifier $object Object * * @return $this */ public function setObject($object) { $this->assertType($object, array("JSX\\JSXMemberExpression", "JSX\\JSXIdentifier")); $this->object = $object; return $this; } /** * Returns the expression's property * * @return JSXIdentifier */ public function getProperty() { return $this->property; } /** * Sets the expression's property * * @param JSXIdentifier $property Property * * @return $this */ public function setProperty(JSXIdentifier $property) { $this->property = $property; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\Node; /** * A node that represents a JSX closing fragment tag. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXClosingFragment extends Node { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\Identifier; /** * A node that represents a JSX identifier. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXIdentifier extends Identifier { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node\JSX; use Peast\Syntax\Node\Node; /** * A node that represents a JSX empty expression. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class JSXEmptyExpression extends Node { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents the catch clause in a try-catch statement. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class CatchClause extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "param" => true, "body" => true ); /** * The catch clause parameter * * @var Pattern */ protected $param; /** * The body of the catch clause * * @var BlockStatement */ protected $body; /** * Returns the catch clause parameter * * @return Pattern */ public function getParam() { return $this->param; } /** * Sets the catch clause parameter * * @param Pattern $param Catch clause parameter * * @return $this */ public function setParam($param) { $this->assertType($param, "Pattern", true); $this->param = $param; return $this; } /** * Returns the body of the catch clause * * @return BlockStatement */ public function getBody() { return $this->body; } /** * Sets the body of the catch clause * * @param BlockStatement $body The block of code inside the catch clause * * @return $this */ public function setBody(BlockStatement $body) { $this->body = $body; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * Abstract class that export and import specifiers nodes must extend. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @abstract */ abstract class ModuleSpecifier extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "local" => true ); /** * Local identifier * * @var Identifier|StringLiteral */ protected $local; /** * Returns the local identifier * * @return Identifier|StringLiteral */ public function getLocal() { return $this->local; } /** * Sets the local identifier * * @param Identifier|StringLiteral $local Local identifier * * @return $this */ public function setLocal($local) { $this->assertType($local, array("Identifier", "StringLiteral")); $this->local = $local; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a class static block * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class StaticBlock extends BlockStatement { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a labeled statement. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class LabeledStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "label" => true, "body" => true ); /** * Label * * @var Identifier */ protected $label; /** * Body * * @var Statement */ protected $body; /** * Returns the label * * @return Identifier */ public function getLabel() { return $this->label; } /** * Sets the label * * @param Identifier $label Label * * @return $this */ public function setLabel(Identifier $label) { $this->label = $label; return $this; } /** * Returns the body * * @return Statement */ public function getBody() { return $this->body; } /** * Sets the body * * @param Statement $body Body * * @return $this */ public function setBody(Statement $body) { $this->body = $body; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a template literal. * For example: `this is a ${test()} template` * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class TemplateLiteral extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "parts" => true, "quasis" => false, "expressions" => false ); /** * Array of quasis that are the literal parts of the template * * @var TemplateElement[] */ protected $quasis = array(); /** * Array of expressions inside the template * * @var Expression[] */ protected $expressions = array(); /** * Returns the array of quasis that are the literal parts of the template * * @return TemplateElement[] */ public function getQuasis() { return $this->quasis; } /** * Sets the array of quasis that are the literal parts of the template * * @param TemplateElement[] $quasis Quasis * * @return $this */ public function setQuasis($quasis) { $this->assertArrayOf($quasis, "TemplateElement"); $this->quasis = $quasis; return $this; } /** * Returns the array of expressions inside the template * * @return Expression[] */ public function getExpressions() { return $this->expressions; } /** * Sets the array of expressions inside the template * * @param Expression[] $expressions Expressions * * @return $this */ public function setExpressions($expressions) { $this->assertArrayOf($expressions, "Expression"); $this->expressions = $expressions; return $this; } /** * Returns an array of the template parts (quasis and expressions) * * @return array */ public function getParts() { // It must be a list of quasis and expressions alternated $parts = array(); foreach ($this->quasis as $k => $val) { $parts[] = $val; if (isset($this->expressions[$k])) { $parts[] = $this->expressions[$k]; } } return $parts; } /** * Sets the array of the template parts (quasis and expressions) * * @param array Template parts * * @return $this */ public function setParts($parts) { $this->assertArrayOf($parts, array("Expression", "TemplateElement")); $quasis = $expressions = array(); foreach ($parts as $part) { if ($part instanceof TemplateElement) { $quasis[] = $part; } else { $expressions[] = $part; } } return $this->setQuasis($quasis)->setExpressions($expressions); } /** * Returns a serializable version of the node * * @return array */ #[\ReturnTypeWillChange] public function jsonSerialize() { $ret = parent::jsonSerialize(); unset($ret["parts"]); return $ret; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a numeric literal. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class NumericLiteral extends Literal { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "format" => false ); //Format constants /** * Decimal number format */ const DECIMAL = "decimal"; /** * Hexadecimal number format */ const HEXADECIMAL = "hexadecimal"; /** * Octal number format */ const OCTAL = "octal"; /** * Binary number format */ const BINARY = "binary"; /** * Node's numeric format * * @var string */ protected $format = self::DECIMAL; /** * Numeric forms conversion rules * * @var array */ protected $forms = array( "b" => array( "check" => "/^0b[01]+[01_]*$/i", "conv" => "bindec", "format" => self::BINARY ), "o" => array( "check" => "/^0o[0-7]+[0-7_]*$/i", "conv" => "octdec", "format" => self::OCTAL ), "x" => array( "check" => "/^0x[0-9a-f]+[0-9a-f_]*$/i", "conv" => "hexdec", "format" => self::HEXADECIMAL ), ); /** * Sets node's value * * @param float $value Value * * @return $this */ public function setValue($value) { $value = (float) $value; $intValue = (int) $value; if ($value == $intValue) { $value = $intValue; } $this->value = $value; //Force recalculation of the raw value return $this->setFormat($this->format); } /** * Sets node's raw value * * @param mixed $raw Raw value * * @return $this * * @throws \Exception */ public function setRaw($raw) { $value = $raw; $format = self::DECIMAL; if (is_string($value) && $value !== "") { //Hexadecimal, binary or octal $startZero = $value[0] === "0"; $form = $startZero && isset($value[1]) ? strtolower($value[1]) : null; //Numeric separator cannot appear at the beginning or at the end of the number if (preg_match("/^_|_$/", $value)) { throw new \Exception("Invalid numeric value"); } elseif (isset($this->forms[$form])) { $formDef = $this->forms[$form]; if (!preg_match($formDef["check"], $value)) { throw new \Exception("Invalid " . $formDef["format"]); } $value = str_replace("_", "", $value); $value = $formDef["conv"]($value); $format = $formDef["format"]; } elseif ($startZero && preg_match("/^0[0-7_]+$/", $value)) { //Legacy octal form $value = str_replace("_", "", $value); $value = octdec($value); $format = self::OCTAL; } elseif ( preg_match("/^([\d_]*\.?[\d_]*)(?:e[+\-]?[\d_]+)?$/i", $value, $match) && $match[1] !== "" && $match[1] !== "." && !preg_match("/_e|e[+-]?_|_$/", $value) ) { $value = str_replace("_", "", $value); } else { throw new \Exception("Invalid numeric value"); } } elseif (!is_int($value) && !is_float($value)) { throw new \Exception("Invalid numeric value"); } $value = (float) $value; $intValue = (int) $value; if ($value == $intValue) { $value = $intValue; } $this->format = $format; $this->value = $value; $this->raw = $raw; return $this; } /** * Returns node's numeric format * * @return string */ public function getFormat() { return $this->format; } /** * Sets node's numeric format * * @param string $format Format, one of the format constants * * @return $this */ public function setFormat($format) { $this->format = $format; switch ($format) { case self::BINARY: $this->raw = "0b" . decbin($this->value); break; case self::OCTAL: $this->raw = "0o" . decoct($this->value); break; case self::HEXADECIMAL: $this->raw = "0x" . dechex($this->value); break; default: $this->raw = (string) $this->value; break; } return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a conditional expression. * For example: test() ? ok() : fail() * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ConditionalExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "test" => true, "consequent" => true, "alternate" => true ); /** * The test expression * * @var Expression */ protected $test; /** * The consequent expression * * @var Expression */ protected $consequent; /** * The alternate expression * * @var Expression */ protected $alternate; /** * Returns the test expression * * @return Expression */ public function getTest() { return $this->test; } /** * Sets the test expression * * @param Expression $test Test expression * * @return $this */ public function setTest(Expression $test) { $this->test = $test; return $this; } /** * Returns the consequent expression * * @return Expression */ public function getConsequent() { return $this->consequent; } /** * Sets the consequent expression * * @param Expression $consequent Consequent expression * * @return $this */ public function setConsequent(Expression $consequent) { $this->consequent = $consequent; return $this; } /** * Returns the alternate expression * * @return Expression */ public function getAlternate() { return $this->alternate; } /** * Sets the alternate expression * * @param Expression $alternate Alternate expression * * @return $this */ public function setAlternate(Expression $alternate) { $this->alternate = $alternate; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a for statement. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ForStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "init" => true, "test" => true, "update" => true, "body" => true ); /** * Initializer * * @var VariableDeclaration|Expression */ protected $init; /** * Test expression * * @var Expression */ protected $test; /** * Update expression * * @var Expression */ protected $update; /** * Loop body * * @var Statement */ protected $body; /** * Returns the initializer * * @return VariableDeclaration|Expression */ public function getInit() { return $this->init; } /** * Sets the initializer * * @param VariableDeclaration|Expression $init Initializer * * @return $this */ public function setInit($init) { $this->assertType( $init, array("VariableDeclaration", "Expression"), true ); $this->init = $init; return $this; } /** * Returns the test expression * * @return Expression */ public function getTest() { return $this->test; } /** * Sets the test expression * * @param Expression $test Test expression * * @return $this */ public function setTest($test) { $this->assertType($test, "Expression", true); $this->test = $test; return $this; } /** * Returns the update expression * * @return Expression */ public function getUpdate() { return $this->update; } /** * Sets the update expression * * @param Expression $update Update expression * * @return $this */ public function setUpdate($update) { $this->assertType($update, "Expression", true); $this->update = $update; return $this; } /** * Returns the loop body * * @return Statement */ public function getBody() { return $this->body; } /** * Sets the loop body * * @param Statement $body Loop body * * @return $this */ public function setBody(Statement $body) { $this->body = $body; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a "new" expression. * For example: new test() * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class NewExpression extends CallExpression { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a class body. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ClassBody extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "body" => true ); /** * Class methods and properties * * @var MethodDefinition[]|PropertyDefinition[]|StaticBlock[] */ protected $body = array(); /** * Returns class methods and properties * * @return MethodDefinition[]|PropertyDefinition[]|StaticBlock[] */ public function getBody() { return $this->body; } /** * Sets class methods and properties * * @param MethodDefinition[]|PropertyDefinition[]|StaticBlock[] $body Class methods array * * @return $this */ public function setBody($body) { $this->assertArrayOf( $body, array("MethodDefinition", "PropertyDefinition", "StaticBlock") ); $this->body = $body; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a switch statement. * For example: switch (test) {} * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class SwitchStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "discriminant" => true, "cases" => true ); /** * Discriminant expression * * @var Expression */ protected $discriminant; /** * Cases array * * @var SwitchCase[] */ protected $cases = array(); /** * Returns the discriminant expression * * @return Expression */ public function getDiscriminant() { return $this->discriminant; } /** * Sets the discriminant expression * * @param Expression $discriminant Discriminant expression * * @return $this */ public function setDiscriminant(Expression $discriminant) { $this->discriminant = $discriminant; return $this; } /** * Returns the cases array * * @return SwitchCase[] */ public function getCases() { return $this->cases; } /** * Sets the cases array * * @param SwitchCase[] $cases Cases array * * @return $this */ public function setCases($cases) { $this->assertArrayOf($cases, "SwitchCase"); $this->cases = $cases; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a with statement. * For example: with (test) {} * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class WithStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "object" => true, "body" => true ); /** * The statement subject * * @var Expression */ protected $object; /** * The statement body * * @var Expression */ protected $body; /** * Returns the statement subject * * @return Expression */ public function getObject() { return $this->object; } /** * Sets the statement subject * * @param Expression $object Statement subject * * @return $this */ public function setObject(Expression $object) { $this->object = $object; return $this; } /** * Returns the statement body * * @return Expression */ public function getBody() { return $this->body; } /** * Sets the statement body * * @param Statement $body Statement body * * @return $this */ public function setBody(Statement $body) { $this->body = $body; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a regular expression literal. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class RegExpLiteral extends Literal { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "flags" => false, "pattern" => false ); /** * Regex flags * * @var string */ protected $flags = ""; /** * Regex pattern * * @var string */ protected $pattern = ""; /** * Returns node's type * * @return string */ public function getType() { return "RegExpLiteral"; } /** * Returns regex pattern * * @return string */ public function getPattern() { return $this->pattern; } /** * Sets regex pattern * * @param string $pattern Regex pattern * * @return $this */ public function setPattern($pattern) { $this->pattern = $pattern; return $this; } /** * Returns regex flags * * @return string */ public function getFlags() { return $this->flags; } /** * Sets regex flags * * @param string $flags Regex flags * * @return $this */ public function setFlags($flags) { $this->flags = $flags; return $this; } /** * Returns node's raw value * * @return string */ public function getRaw() { return "/" . $this->getPattern() . "/" . $this->getFlags(); } /** * Sets node's raw value that must include delimiters * * @param string $raw Raw value * * @return $this */ public function setRaw($raw) { $parts = explode("/", substr($raw, 1)); $flags = array_pop($parts); $this->setPattern(implode("/", $parts)); $this->setFlags($flags); return $this; } /** * Returns node's value * * @return string */ public function getValue() { return $this->getRaw(); } /** * Sets node's value * * @param mixed $value Value * * @return $this */ public function setValue($value) { return $this->setRaw($value); } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a chain expression. * For example: test?.test?.() * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ChainExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "expression" => true ); /** * The wrapped expression * * @var Expression */ protected $expression; /** * Returns the wrapped expression * * @return Expression */ public function getExpression() { return $this->expression; } /** * Sets the wrapped expression * * @param Expression $expression Wrapped expression * * @return $this */ public function setExpression(Expression $expression) { $this->expression = $expression; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents the rest element in array binding patterns or function * parameters. * For example "...rest" in: [a, ...rest] = b * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class RestElement extends Node implements Pattern { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "argument" => true ); /** * The node's argument * * @var Pattern */ protected $argument; /** * Returns the node's argument * * @return Pattern */ public function getArgument() { return $this->argument; } /** * Sets the node's argument * * @param Pattern $argument Node's argument * * @return $this */ public function setArgument(Pattern $argument) { $this->argument = $argument; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; use Peast\Syntax\Utils; /** * A node that represents a template element. * For example `foo` and `bar` in: `foo${exp}bar` * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class TemplateElement extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "value" => false, "tail" => false, "rawValue" => false ); /** * Node's value * * @var string */ protected $value; /** * Tail flag that is true when the element is the tail element in a template * * @var bool */ protected $tail = false; /** * Node's raw value * * @var string */ protected $rawValue; /** * Return node's value * * @return string */ public function getValue() { return $this->value; } /** * Sets node's value * * @param mixed $value Value * * @return $this */ public function setValue($value) { $this->value = $value; $this->rawValue = Utils::quoteLiteralString($value, "`"); return $this; } /** * Returns the tail flag that is true when the element is the tail element * in a template * * @return bool */ public function getTail() { return $this->tail; } /** * Sets the tail flag that is true when the element is the tail element * in a template * * @param bool $tail Tail flag * * @return $this */ public function setTail($tail) { $this->tail = (bool) $tail; return $this; } /** * Returns node's raw value * * @return string */ public function getRawValue() { return $this->rawValue; } /** * Sets node's raw value that must be wrapped in templates quotes. * * @param string $rawValue Raw value * * @return $this */ public function setRawValue($rawValue) { $rawValue = preg_replace("#^[`}]|(?:`|\\\$\{)$#", "", $rawValue); $this->setValue(Utils::unquoteLiteralString("`$rawValue`")); $this->rawValue = $rawValue; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a for-in statement. * For example: for (var a in b) {} * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ForInStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "left" => true, "right" => true, "body" => true ); /** * Iteration variable * * @var VariableDeclaration|Expression|Pattern */ protected $left; /** * Iterated object * * @var Expression */ protected $right; /** * Loop body * * @var Statement */ protected $body; /** * Returns the iteration variable * * @return VariableDeclaration|Expression|Pattern */ public function getLeft() { return $this->left; } /** * Sets the iteration variable * * @param VariableDeclaration|Expression|Pattern $left Iteration variable * * @return $this */ public function setLeft($left) { $this->assertType( $left, array("VariableDeclaration", "Expression", "Pattern") ); $this->left = $left; return $this; } /** * Returns the iterated object * * @return Expression */ public function getRight() { return $this->right; } /** * Sets the iterated object * * @param Expression $right Iterated object * * @return $this */ public function setRight(Expression $right) { $this->right = $right; return $this; } /** * Returns the loop body * * @return Statement */ public function getBody() { return $this->body; } /** * Sets the loop body * * @param Statement $body Loop body * * @return $this */ public function setBody(Statement $body) { $this->body = $body; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; use Peast\Syntax\Utils; /** * A node that represents a string literal. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class StringLiteral extends Literal { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "format" => false ); //Format constants /** * Double quoted string */ const DOUBLE_QUOTED = "double"; /** * Single quoted string */ const SINGLE_QUOTED = "single"; /** * String format * * @var string */ protected $format = self::DOUBLE_QUOTED; /** * Sets node's value * * @param string $value Value * * @return $this */ public function setValue($value) { $this->value = (string) $value; //Force recalculation of the raw value return $this->setFormat($this->format); } /** * Sets node's raw value * * @param mixed $raw Raw value * * @return $this * * @throws \Exception */ public function setRaw($raw) { if (!is_string($raw) || strlen($raw) < 2) { throw new \Exception("Invalid string"); } $startQuote = $raw[0]; $endQuote = substr($raw, -1); if (($startQuote !== "'" && $startQuote !== '"') || $startQuote !== $endQuote ) { throw new \Exception("Invalid string"); } $this->value = Utils::unquoteLiteralString($raw); $this->setFormat($raw[0] === "'" ? self::SINGLE_QUOTED : self::DOUBLE_QUOTED ); $this->raw = $raw; return $this; } /** * Returns string format * * @return string */ public function getFormat() { return $this->format; } /** * Sets string format * * @param string $format Format, one of the format constants * * @return $this */ public function setFormat($format) { $this->format = $format; $quote = $format === self::SINGLE_QUOTED ? "'" : '"'; $this->raw = Utils::quoteLiteralString($this->value, $quote); return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents the spread element in array literals or function * calls. * For example "...params" in: test(...params) * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class SpreadElement extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "argument" => true ); /** * The node's argument * * @var Expression */ protected $argument; /** * Returns the node's argument * * @return Expression */ public function getArgument() { return $this->argument; } /** * Sets the node's argument * * @param Expression $argument Node's argument * * @return $this */ public function setArgument(Expression $argument) { $this->argument = $argument; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a BigInt literal. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class BigIntLiteral extends Literal { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "bigint" => false ); /** * Node's value * * @var mixed */ protected $bigint; /** * Sets node's value * * @param float $value Value * * @return $this */ public function setValue($value) { //Value, Raw and Bigint are always the same value $this->value = $this->raw = $this->bigint = $value; return $this; } /** * Returns node's value * * @return string */ public function getBigint() { return $this->bigint; } /** * Sets node's value * * @param string $bigint Value * * @return $this */ public function setBigint($bigint) { return $this->setValue($bigint); } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents the "continue" statement inside loops. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ContinueStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "label" => true ); /** * The optional label of the continue statement * * @var Identifier */ protected $label; /** * Returns the node's label * * @return Identifier */ public function getLabel() { return $this->label; } /** * Sets the node's label * * @param Identifier $label Node's label * * @return $this */ public function setLabel($label) { $this->assertType($label, "Identifier", true); $this->label = $label; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a meta property. * For example: new.target * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class MetaProperty extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "meta" => false, "property" => false ); /** * Subject * * @var string */ protected $meta; /** * Property * * @var string */ protected $property; /** * Returns the subject * * @return string */ public function getMeta() { return $this->meta; } /** * Sets the subject * * @param string $meta Subject * * @return $this */ public function setMeta($meta) { $this->meta = $meta; return $this; } /** * Returns the property * * @return string */ public function getProperty() { return $this->property; } /** * Sets the property * * @param string $property Property * * @return $this */ public function setProperty($property) { $this->property = $property; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an assignment expression. * For example: a = b * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class AssignmentExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "left" => true, "operator" => false, "right" => true ); /** * The assignment operator * * @var string */ protected $operator; /** * The left node of the assignment * * @var Pattern|Expression */ protected $left; /** * The right node of the assignment * * @var Expression */ protected $right; /** * Returns the assignment operator * * @return string */ public function getOperator() { return $this->operator; } /** * Sets the assignment operator * * @param string $operator Assignment operator * * @return $this */ public function setOperator($operator) { $this->operator = $operator; return $this; } /** * Returns the left node of the assignment * * @return Pattern|Expression */ public function getLeft() { return $this->left; } /** * Sets the left node of the assignment * * @param Pattern|Expression $left The node to set * * @return $this */ public function setLeft($left) { $this->assertType($left, array("Pattern", "Expression")); $this->left = $left; return $this; } /** * Returns the right node of the assignment * * @return Expression */ public function getRight() { return $this->right; } /** * Sets the right node of the assignment * * @param Expression $right The node to set * * @return $this */ public function setRight(Expression $right) { $this->right = $right; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a block of code wrapped in curly braces. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class BlockStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "body" => true ); /** * Block's body * * @var Statement[] */ protected $body = array(); /** * Returns block's body * * @return Statement[] */ public function getBody() { return $this->body; } /** * Sets block's body * * @param Statement[] $body Array of Statements that are the body of the * block * * @return $this */ public function setBody($body) { $this->assertArrayOf($body, "Statement"); $this->body = $body; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a comment. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Comment extends Node { //Comment kind constants /** * Inline comment */ const KIND_INLINE = "inline"; /** * Multiline comment */ const KIND_MULTILINE = "multiline"; /** * Html open comment */ const KIND_HTML_OPEN = "html-open"; /** * Html close comment */ const KIND_HTML_CLOSE = "html-close"; /** * Hashbang comment */ const KIND_HASHBANG = "hashbang"; /** * Map of node properties * * @var array */ protected $propertiesMap = array( "kind" => false, "text" => false ); /** * The comment kind * * @var string */ protected $kind; /** * The comment text * * @var string */ protected $text; /** * Returns the comment kind * * @return string */ public function getKind() { return $this->kind; } /** * Sets the comment kind * * @param string $kind Comment kind * * @return $this */ public function setKind($kind) { $this->kind = $kind; return $this; } /** * Returns the comment text * * @return string */ public function getText() { return $this->text; } /** * Sets the comment text * * @param string $text Comment text * * @return $this */ public function setText($text) { $this->text = $text; return $this; } /** * Returns the comment raw text * * @return string */ public function getRawText() { $text = $this->getText(); $kind = $this->getKind(); if ($kind === self::KIND_MULTILINE) { $sanitize = "*/"; } else { $sanitize = array("\n", "\r"); } $text = str_replace($sanitize, "", $text); if ($kind === self::KIND_INLINE) { return "//" . $text; } elseif ($kind === self::KIND_HASHBANG) { return "#!" . $text; } elseif ($kind === self::KIND_HTML_OPEN) { return "" . $text; } else { return "/*" . $text . "*/"; } } /** * Sets the comment raw text * * @param string $rawText Comment raw text * * @return $this */ public function setRawText($rawText) { $start = substr($rawText, 0, 2); if ($start === "//") { $kind = self::KIND_INLINE; $text = substr($rawText, 2); } elseif ($start === "/*" && substr($rawText, -2) === "*/") { $kind = self::KIND_MULTILINE; $text = substr($rawText, 2, -2); } elseif ($start === "#!") { $kind = self::KIND_HASHBANG; $text = substr($rawText, 2); } elseif ($start === "<!" && substr($rawText, 2, 2) === "--") { $kind = self::KIND_HTML_OPEN; $text = substr($rawText, 4); } elseif ($start === "--" && substr($rawText, 2, 1) === ">") { $kind = self::KIND_HTML_CLOSE; $text = substr($rawText, 3); } else { throw new \Exception("Invalid comment"); } return $this->setKind($kind)->setText($text); } /** * Sets leading comments array * * @param Comment[] $comments Comments array * * @return $this */ public function setLeadingComments($comments) { //Comments cannot be attached to other comments return $this; } /** * Sets trailing comments array * * @param Comment[] $comments Comments array * * @return $this */ public function setTrailingComments($comments) { //Comments cannot be attached to other comments return $this; } /** * Returns a serializable version of the node * * @return array */ #[\ReturnTypeWillChange] public function jsonSerialize() { $ret = parent::jsonSerialize(); unset($ret["leadingComments"]); unset($ret["trailingComments"]); return $ret; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a specifier in an export declaration. * For example "{a}" in: export {a} * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ExportSpecifier extends ModuleSpecifier { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "exported" => true ); /** * Exported identifier * * @var Identifier|StringLiteral */ protected $exported; /** * Returns the exported identifier * * @return Identifier|StringLiteral */ public function getExported() { return $this->exported; } /** * Sets the exported identifier * * @param Identifier|StringLiteral $exported Exported identifier * * @return $this */ public function setExported($exported) { $this->assertType($exported, array("Identifier", "StringLiteral")); $this->exported = $exported; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a null literal. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class NullLiteral extends Literal { /** * Node's value * * @var mixed */ protected $value = null; /** * Node's raw value * * @var string */ protected $raw = "null"; /** * Sets node's value * * @param mixed $value Value * * @return $this */ public function setValue($value) { return $this; } }<?php /** @noinspection PhpElementIsNotAvailableInCurrentPhpVersionInspection */ /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; use Peast\Syntax\SourceLocation; use Peast\Syntax\Position; /** * Base class for all the nodes generated by Peast. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> * * @abstract */ abstract class Node implements \JSONSerializable { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "type" => false, "location" => false, "leadingComments" => false, "trailingComments" => false ); /** * Node location in the source code * * @var SourceLocation */ public $location; /** * Leading comments array * * @var Comment[] */ protected $leadingComments = array(); /** * Trailing comments array * * @var Comment[] */ protected $trailingComments = array(); /** * Class constructor */ public function __construct() { $this->location = new SourceLocation; } /** * Returns node type * * @return string */ public function getType() { $class = explode("\\", get_class($this)); return array_pop($class); } /** * Sets leading comments array * * @param Comment[] $comments Comments array * * @return $this */ public function setLeadingComments($comments) { $this->assertArrayOf($comments, "Comment"); $this->leadingComments = $comments; return $this; } /** * Returns leading comments array * * @return Comment[] */ public function getLeadingComments() { return $this->leadingComments; } /** * Sets trailing comments array * * @param Comment[] $comments Comments array * * @return $this */ public function setTrailingComments($comments) { $this->assertArrayOf($comments, "Comment"); $this->trailingComments = $comments; return $this; } /** * Returns trailing comments array * * @return Comment[] */ public function getTrailingComments() { return $this->trailingComments; } /** * Returns node location in the source code * * @return SourceLocation */ public function getLocation() { return $this->location; } /** * Sets the start position of the node in the source code * * @param Position $position Start position * * @return $this */ public function setStartPosition(Position $position) { $this->location->start = $position; return $this; } /** * Sets the end position of the node in the source code * * @param Position $position Start position * * @return $this */ public function setEndPosition(Position $position) { $this->location->end = $position; return $this; } /** * Traverses the current node and all its child nodes using the given * function * * @param callable $fn Function that will be called on each node * @param array $options Options array. See Traverser class * documentation for available options * * @return $this */ public function traverse(callable $fn, $options = array()) { $traverser = new \Peast\Traverser($options); $traverser->addFunction($fn)->traverse($this); return $this; } /** * Returns a serializable version of the node * * @return array */ #[\ReturnTypeWillChange] public function jsonSerialize() { $ret = array(); $props = \Peast\Syntax\Utils::getNodeProperties($this); foreach ($props as $prop) { $ret[$prop["name"]] = $this->{$prop["getter"]}(); } return $ret; } /** * Renders the current node * * @param \Peast\Formatter\Base $formatter Formatter to use for the * rendering * * @return string */ public function render(\Peast\Formatter\Base $formatter) { $renderer = new \Peast\Renderer(); return $renderer->setFormatter($formatter)->render($this); } /** * Asserts that the given value is an array of defined type * * @param mixed $params Value to check * @param string|array $classes Class or array of classes to check against * @param bool $allowNull If true, null values are allowed * * @return void * * @codeCoverageIgnore */ protected function assertArrayOf($params, $classes, $allowNull = false) { if (!is_array($classes)) { $classes = array($classes); } if (!is_array($params)) { $this->typeError($params, $classes, $allowNull, true); } else { foreach ($params as $param) { foreach ($classes as $class) { if ($param === null && $allowNull) { continue 2; } else { $c = "Peast\\Syntax\\Node\\$class"; if ($param instanceof $c) { continue 2; } } } $this->typeError($param, $classes, $allowNull, true, true); } } } /** * Asserts that the given value respects the defined type * * @param mixed $param Value to check * @param string|array $classes Class or array of classes to check against * @param bool $allowNull If true, null values are allowed * * @return void * * @codeCoverageIgnore */ protected function assertType($param, $classes, $allowNull = false) { if (!is_array($classes)) { $classes = array($classes); } if ($param === null) { if (!$allowNull) { $this->typeError($param, $classes, $allowNull); } } else { foreach ($classes as $class) { $c = "Peast\\Syntax\\Node\\$class"; if ($param instanceof $c) { return; } } $this->typeError($param, $classes, $allowNull); } } /** * Throws an error if the defined type is not supported b * * @param mixed $param The value to check * @param mixed $allowedTypes Class or array of classes to check against * @param bool $allowNull If true, null values are allowed * @param bool $array If true, the value must be an array * @param bool $inArray If true, the value is an array but the content * does not respects the type * * @return void * * @throws \TypeError * * @codeCoverageIgnore */ protected function typeError( $param, $allowedTypes, $allowNull = false, $array = false, $inArray = false ) { $backtrace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS); $method = $backtrace[2]["class"] . "::" . $backtrace[2]["function"]; $msg = "Argument 0 passed to $method must be "; if ($array) { $msg .= "an array of "; } $msg .= implode(" or ", $allowedTypes); if ($allowNull) { $msg .= " or null"; } if (is_object($param)) { $parts = explode("\\", get_class($param)); $type = array_pop($parts); } else { $type = gettype($param); } if ($inArray) { $type = "array of $type"; } $msg .= ", $type given"; if (version_compare(phpversion(), '7', '>=')) { throw new \TypeError($msg); } else { trigger_error($msg, E_USER_ERROR); } } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an if statement. * For example: if (test) {} else {} * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class IfStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "test" => true, "consequent" => true, "alternate" => true ); /** * The test expression * * @var Expression */ protected $test; /** * The statement that is activated if the test expression is true * * @var Statement|FunctionDeclaration */ protected $consequent; /** * The "else" statement * * @var Statement */ protected $alternate; /** * Returns the test expression * * @return Expression */ public function getTest() { return $this->test; } /** * Sets the test expression * * @param Expression $test Test expression * * @return $this */ public function setTest(Expression $test) { $this->test = $test; return $this; } /** * Returns the statement that is activated if the test expression is true * * @return Statement|FunctionDeclaration */ public function getConsequent() { return $this->consequent; } /** * Sets the statement that is activated if the test expression is true * * @param Statement|FunctionDeclaration $consequent The consequent expression * * @return $this */ public function setConsequent($consequent) { $this->assertType( $consequent, array("Statement", "FunctionDeclaration"), true ); $this->consequent = $consequent; return $this; } /** * Returns the "else" statement * * @return Statement */ public function getAlternate() { return $this->alternate; } /** * Sets the "else" statement * * @param Statement|FunctionDeclaration $alternate The "else" statement * * @return $this */ public function setAlternate($alternate) { $this->assertType( $alternate, array("Statement", "FunctionDeclaration"), true ); $this->alternate = $alternate; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a private identifier. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class PrivateIdentifier extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "name" => false ); /** * The identifier's name * * @var string */ protected $name; /** * Returns the identifier's name * * @return string */ public function getName() { return $this->name; } /** * Sets the identifier's name * * @param string $name The name to set * * @return $this */ public function setName($name) { $this->name = $name; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a boolean literal. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class BooleanLiteral extends Literal { /** * Sets node's value * * @param mixed $value Value * * @return $this */ public function setValue($value) { if ($value === "true") { $this->value = true; } elseif ($value === "false") { $this->value = false; } else { $this->value = (bool) $value; } $this->raw = $this->value ? "true" : "false"; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * Interface that every expression node must implement. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ interface Expression { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an import expression (dynamic import). * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ImportExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "source" => true, "options" => true ); /** * The import source * * @var Expression */ protected $source; /** * Optional import options * * @var Expression|null */ protected $options; /** * Returns the import source * * @return Expression */ public function getSource() { return $this->source; } /** * Sets the import source * * @param Expression $source Import source * * @return $this */ public function setSource(Expression $source) { $this->source = $source; return $this; } /** * Returns the import options * * @return Expression|null */ public function getOptions() { return $this->options; } /** * Sets the import options * * @param Expression|null $options Import options * * @return $this */ public function setOptions($options) { $this->assertType($options, "Expression", true); $this->options = $options; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a "var", "const" or "let" declaration. * For example: var a = 1 * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class VariableDeclaration extends Node implements Declaration { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "declarations" => true, "kind" => false ); //Kind constants /** * "var" kind */ const KIND_VAR = "var"; /** * "let" kind */ const KIND_LET = "let"; /** * "const" kind */ const KIND_CONST = "const"; /** * Declarations array * * @var VariableDeclarator[] */ protected $declarations = array(); /** * Declaration kind that is one of the kind constants * * @var string */ protected $kind = self::KIND_VAR; /** * Returns the declarations array * * @return VariableDeclarator[] */ public function getDeclarations() { return $this->declarations; } /** * Sets the declarations array * * @param VariableDeclarator[] $declarations Declarations array * * @return $this */ public function setDeclarations($declarations) { $this->assertArrayOf($declarations, "VariableDeclarator"); $this->declarations = $declarations; return $this; } /** * Returns the declaration kind that is one of the kind constants * * @return string */ public function getKind() { return $this->kind; } /** * Sets the declaration kind that is one of the kind constants * * @param string $kind Declaration kind * * @return $this */ public function setKind($kind) { $this->kind = $kind; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * Abstract class for functions. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ abstract class Function_ extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "id" => true, "params" => true, "body" => true, "generator" => false, "async" => false ); /** * Function name * * @var Identifier */ protected $id; /** * Function parameters array * * @var Pattern[] */ protected $params = array(); /** * Function body * * @var BlockStatement */ protected $body; /** * Generator flag that is true when the function is a generator * * @var bool */ protected $generator = false; /** * Async flag that is true when it is an async function * * @var bool */ protected $async = false; /** * Returns function name * * @return Identifier */ public function getId() { return $this->id; } /** * Sets function name * * @param Identifier $id Function name * * @return $this */ public function setId($id) { $this->assertType($id, "Identifier", true); $this->id = $id; return $this; } /** * Returns function parameters array * * @return Pattern[] */ public function getParams() { return $this->params; } /** * Sets function parameters array * * @param Pattern[] $params Function parameters array * * @return $this */ public function setParams($params) { $this->assertArrayOf($params, "Pattern"); $this->params = $params; return $this; } /** * Returns function body * * @return BlockStatement */ public function getBody() { return $this->body; } /** * Sets function body * * @param BlockStatement $body Function body * * @return $this */ public function setBody($body) { $this->assertType($body, "BlockStatement"); $this->body = $body; return $this; } /** * Returns the generator flag that is true when the function is a generator * * @return bool */ public function getGenerator() { return $this->generator; } /** * Sets the generator flag that is true when the function is a generator * * @param bool $generator Generator flag * * @return $this */ public function setGenerator($generator) { $this->generator = (bool) $generator; return $this; } /** * Returns the async flag that is true when it is an async function * * @return bool */ public function getAsync() { return $this->async; } /** * Sets the async flag that is true when it is an async function * * @param bool $async Async flag * * @return $this */ public function setAsync($async) { $this->async = (bool) $async; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a property definition in class body. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class PropertyDefinition extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "key" => true, "value" => true, "computed" => false, "static" => false ); /** * Property key * * @var Expression|PrivateIdentifier */ protected $key; /** * Optional property value * * @var Expression|null */ protected $value; /** * Property computed flag that is true when the property is declared using * the square brackets syntax * * @var bool */ protected $computed = false; /** * Property static flag that is true when the property is declared static * * @var bool */ protected $static = false; /** * Returns the property key * * @return Expression|PrivateIdentifier */ public function getKey() { return $this->key; } /** * Sets the property key * * @param Expression|PrivateIdentifier $key Property key * * @return $this */ public function setKey($key) { $this->assertType($key, array("Expression", "PrivateIdentifier")); $this->key = $key; return $this; } /** * Returns the property value * * @return Expression|null */ public function getValue() { return $this->value; } /** * Sets the property value * * @param Expression|null $value Property value * * @return $this */ public function setValue($value) { $this->assertType($value, "Expression", true); $this->value = $value; return $this; } /** * Returns the property computed flag that is true when the property is * declared using the square brackets syntax * * @return bool */ public function getComputed() { return $this->computed; } /** * Sets the property computed flag that is true when the property is * declared using the square brackets syntax * * @param bool $computed Property computed flag * * @return $this */ public function setComputed($computed) { $this->computed = (bool) $computed; return $this; } /** * Returns the property static flag that is true when the property is * declared static * * @return bool */ public function getStatic() { return $this->static; } /** * Sets the property static flag that is true when the property is * declared static * * @param bool $static Property static flag * * @return $this */ public function setStatic($static) { $this->static = (bool) $static; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a yield statement. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class YieldExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "argument" => true, "delegate" => false ); /** * Yield argument * * @var Expression */ protected $argument; /** * Delegate flag that is true when the yield keyword is preceded by * * * @var bool */ protected $delegate = false; /** * Returns yield argument * * @return Expression */ public function getArgument() { return $this->argument; } /** * Sets yield argument * * @param Expression $argument Argument * * @return $this */ public function setArgument($argument) { $this->assertType($argument, "Expression", true); $this->argument = $argument; return $this; } /** * Returns the delegate flag that is true when the yield keyword is * preceded by * * * @return bool */ public function getDelegate() { return $this->delegate; } /** * Sets the delegate flag that is true when the yield keyword is * preceded by * * * @param bool $delegate Delegate flag * * @return $this */ public function setDelegate($delegate) { $this->delegate = (bool) $delegate; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * Interface that every pattern node must implement. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ interface Pattern { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a try-catch statement. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class TryStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "block" => true, "handler" => true, "finalizer" => true ); /** * Wrapped block * * @var BlockStatement */ protected $block; /** * Catch clause * * @var CatchClause */ protected $handler; /** * "finally" block * * @var BlockStatement */ protected $finalizer; /** * Returns the wrapped block * * @return BlockStatement */ public function getBlock() { return $this->block; } /** * Sets the wrapped block * * @param BlockStatement $block Wrapped block * * @return $this */ public function setBlock(BlockStatement $block) { $this->block = $block; return $this; } /** * Returns the catch clause * * @return CatchClause */ public function getHandler() { return $this->handler; } /** * Sets the catch clause * * @param CatchClause $handler Catch clause * * @return $this */ public function setHandler($handler) { $this->assertType($handler, "CatchClause", true); $this->handler = $handler; return $this; } /** * Returns the "finally" block * * @return BlockStatement */ public function getFinalizer() { return $this->finalizer; } /** * Sets the "finally" block * * @param BlockStatement $finalizer The "finally" block * * @return $this */ public function setFinalizer($finalizer) { $this->assertType($finalizer, "BlockStatement", true); $this->finalizer = $finalizer; return $this; } } <?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a unary expression. * For example: !a * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class UnaryExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "argument" => true, "operator" => false, "prefix" => false ); /** * Expression's operator * * @var string */ protected $operator; /** * Prefix flag that is always true since the operator precedes the argument * * @var bool */ protected $prefix = true; /** * Expression's argument * * @var Expression */ protected $argument; /** * Returns the expression's operator * * @return string */ public function getOperator() { return $this->operator; } /** * Sets the expression's operator * * @param string $operator Operator * * @return $this */ public function setOperator($operator) { $this->operator = $operator; return $this; } /** * Returns the prefix flag that is always true since the operator precedes * the argument * * @return bool */ public function getPrefix() { return $this->prefix; } /** * This method does nothing since the prefix flag is always true for * unary expressions * * @param bool $prefix Prefix flag * * @return $this * * @codeCoverageIgnore */ public function setPrefix($prefix) { return $this; } /** * Returns the expression's argument * * @return Expression */ public function getArgument() { return $this->argument; } /** * Sets the expression's argument * * @param Expression $argument Argument * * @return $this */ public function setArgument(Expression $argument) { $this->argument = $argument; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * Interface that every declaration node must implement. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ interface Declaration extends Statement { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a key value pair for an import attribute. * For example: return a + 1 * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ImportAttribute extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "key" => true, "value" => true ); /** * Import attribute key * * @var Identifier|Literal */ protected $key; /** * Import attribute value * * @var Literal */ protected $value; /** * Returns the import attribute key * * @return Identifier|Literal */ public function getKey() { return $this->key; } /** * Sets the import attribute key * * @param Identifier|Literal $key The import attribute key * * @return $this */ public function setKey($key) { $this->assertType($key, array("Identifier", "Literal")); $this->key = $key; return $this; } /** * Returns the import attribute value * * @return Literal */ public function getValue() { return $this->value; } /** * Sets the import attribute value * * @param Literal $value The import attribute value * * @return $this */ public function setValue(Literal $value) { $this->value = $value; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; use Peast\Query; use Peast\Selector; /** * Root node for scripts and modules. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Program extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "body" => true, "sourceType" => false ); /** * Source type that is one of the source type constants in the Peast class * * @var string */ protected $sourceType = \Peast\Peast::SOURCE_TYPE_SCRIPT; /** * Program's body * * @var Statement[]|ModuleDeclaration[] */ protected $body = array(); /** * Returns the source type that is one of the source type constants in the * Peast class * * @return string */ public function getSourceType() { return $this->sourceType; } /** * Sets the source type that is one of the source type constants in the * Peast class * * @param string $sourceType Source type * * @return $this */ public function setSourceType($sourceType) { $this->sourceType = $sourceType; return $this; } /** * Returns the program's body * * @return Statement[]|ModuleDeclaration[] */ public function getBody() { return $this->body; } /** * Sets the program's body * * @param Statement[]|ModuleDeclaration[] $body Program's body * * @return $this */ public function setBody($body) { $this->assertArrayOf($body, array("Statement", "ModuleDeclaration")); $this->body = $body; return $this; } /** * Finds nodes matching the given selector. * * @param string $selector Selector * @param array $options Options array. See Query class * documentation for available options * * @return Query * * @throws Selector\Exception */ public function query($selector, $options = array()) { $query = new Query($this, $options); return $query->find($selector); } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an arrow function. * For example: var fn = (a, b) => console.log(a, b) * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ArrowFunctionExpression extends Function_ implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "expression" => false ); /** * This flag is true when function body is wrapped in curly braces * * @var bool */ protected $expression = false; /** * Sets the function body * * @param BlockStatement|Expression $body Function body * * @return $this */ public function setBody($body) { $this->assertType($body, array("BlockStatement", "Expression")); $this->body = $body; return $this; } /** * Returns the expression flag * * @return bool */ public function getExpression() { return $this->expression; } /** * Sets the expression flag * * @param bool $expression Expression flag * * @return $this */ public function setExpression($expression) { $this->expression = (bool) $expression; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a function declaration * For example: function test () {} * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class FunctionDeclaration extends Function_ implements Declaration { /** * Sets the function identifier * * @param Identifier $id Function identifier * * @return $this */ public function setId($id) { $this->assertType($id, "Identifier"); $this->id = $id; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents the "super" keyword. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Super extends Node { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an object binding pattern. * For example: var {a, b, c} = d * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ObjectPattern extends Node implements Pattern { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "properties" => true ); /** * Object properties * * @var Property[] */ protected $properties = array(); /** * Returns object properties * * @return Property[] */ public function getProperties() { return $this->properties; } /** * Sets object properties * * @param Property[] $properties Object properties * * @return $this */ public function setProperties($properties) { $this->assertArrayOf($properties, array("AssignmentProperty", "RestElement")); $this->properties = $properties; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a chain element. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ abstract class ChainElement extends Node implements Expression { protected $propertiesMap = array( "optional" => false ); /** * Optional flag that is true if the node is in the optional * part of a chain expression * * @var bool */ protected $optional = false; /** * Returns the optional flag that is true if the node is in * the optional part of a chain expression * * @return bool */ public function getOptional() { return $this->optional; } /** * Sets the optional flag that is true if the node is in * the optional part of a chain expression * * @param bool $optional Optional flag * * @return $this */ public function setOptional($optional) { $this->optional = (bool) $optional; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * Abstract class for classes. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ abstract class Class_ extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "id" => true, "superClass" => true, "body" => true ); /** * Class name * * @var Identifier */ protected $id; /** * Extended class * * @var Expression */ protected $superClass; /** * Class body * * @var ClassBody */ protected $body; /** * Returns class name * * @return Identifier */ public function getId() { return $this->id; } /** * Sets class name * * @param Identifier $id Class name * * @return $this */ public function setId($id) { $this->assertType($id, "Identifier", true); $this->id = $id; return $this; } /** * Returns extended class * * @return Expression */ public function getSuperClass() { return $this->superClass; } /** * Sets extended class * * @param Expression $superClass Extended class * * @return $this */ public function setSuperClass($superClass) { $this->assertType($superClass, "Expression", true); $this->superClass = $superClass; return $this; } /** * Returns class body * * @return ClassBody */ public function getBody() { return $this->body; } /** * Sets class body * * @param ClassBody $body Class body * * @return $this */ public function setBody($body) { $this->assertType($body, "ClassBody"); $this->body = $body; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents the "for...of" statement. * For example: for (var a of b) {} * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ForOfStatement extends ForInStatement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "left" => true, "right" => true, "body" => true, "await" => false ); /** * Async iteration flag * * @var bool */ protected $await = false; /** * Returns the async iteration flag * * @return bool */ public function getAwait() { return $this->await; } /** * Sets the async iteration flag * * @param bool $await Async iteration flag * * @return $this */ public function setAwait($await) { $this->await = (bool) $await; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents the return statement inside functions. * For example: return a + 1 * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ReturnStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "argument" => true ); /** * Optional expression after the return keyword * * @var Expression */ protected $argument; /** * Returns the expression after the return keyword * * @return Expression */ public function getArgument() { return $this->argument; } /** * Sets the expression after the return keyword * * @param Expression $argument The expression to return * * @return $this */ public function setArgument($argument) { $this->assertType($argument, "Expression", true); $this->argument = $argument; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a tagged template expression. * For example: fn`template` * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class TaggedTemplateExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "tag" => true, "quasi" => true ); /** * Tag expression * * @var Expression */ protected $tag; /** * Template * * @var TemplateLiteral */ protected $quasi; /** * Returns the tag expression * * @return Expression */ public function getTag() { return $this->tag; } /** * Sets the tag expression * * @param Expression $tag Tag expression * * @return $this */ public function setTag(Expression $tag) { $this->tag = $tag; return $this; } /** * Returns the template * * @return TemplateLiteral */ public function getQuasi() { return $this->quasi; } /** * Sets the the template * * @param TemplateLiteral $quasi Template * * @return $this */ public function setQuasi(TemplateLiteral $quasi) { $this->quasi = $quasi; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * Common interface for function import and export nodes. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ interface ModuleDeclaration { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a default import specifier. * For example "test" in: import test from "test.js". * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ImportNamespaceSpecifier extends ModuleSpecifier { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an expression statement and wraps another expression. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ExpressionStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "expression" => true ); /** * Wrapped expression * * @var Expression */ protected $expression; /** * Returns the wrapped expression * * @return Expression */ public function getExpression() { return $this->expression; } /** * Sets the wrapped expression * * @param Expression $expression Wrapped expression * * @return $this */ public function setExpression(Expression $expression) { $this->expression = $expression; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an export named declaration. * For example: export {foo} from "bar" * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ExportNamedDeclaration extends Node implements ModuleDeclaration { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "declaration" => true, "specifiers" => true, "source" => true, "attributes" => true ); /** * Exported declaration * * @var Declaration */ protected $declaration; /** * Exported specifiers * * @var ExportSpecifier[] */ protected $specifiers = array(); /** * Attributes array * * @var array */ protected $attributes = array(); /** * The export source * * @var Literal */ protected $source; /** * Returns the exported declaration * * @return Declaration */ public function getDeclaration() { return $this->declaration; } /** * Sets the exported declaration * * @param Declaration $declaration Exported declaration * * @return $this */ public function setDeclaration($declaration) { $this->assertType($declaration, "Declaration", true); $this->declaration = $declaration; return $this; } /** * Return the exported specifiers * * @return ExportSpecifier[] */ public function getSpecifiers() { return $this->specifiers; } /** * Sets the exported specifiers * * @param ExportSpecifier[] $specifiers Exported specifiers * * @return $this */ public function setSpecifiers($specifiers) { $this->assertArrayOf($specifiers, "ExportSpecifier"); $this->specifiers = $specifiers; return $this; } /** * Returns the export source * * @return Literal */ public function getSource() { return $this->source; } /** * Sets the export source * * @param Literal $source Export source * * @return $this */ public function setSource($source) { $this->assertType($source, "Literal", true); $this->source = $source; return $this; } /** * Returns the attributes array * * @return array */ public function getAttributes() { return $this->attributes; } /** * Sets the attributes array * * @param array $attributes Attributes array * * @return $this */ public function setAttributes($attributes) { $this->assertArrayOf($attributes, "ImportAttribute"); $this->attributes = $attributes; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a property in an object binding pattern. * For example "a" in: var {a} = b * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class AssignmentProperty extends Property { /** * Returns node's type * * @return string */ public function getType() { return "Property"; } /** * Sets the property value * * @param Pattern $value Property value * * @return $this */ public function setValue($value) { $this->assertType($value, "Pattern"); $this->value = $value; return $this; } /** * Sets the property kind that is one of the kind constants * * @param string $kind Property kind * * @return $this * * @codeCoverageIgnore */ public function setKind($kind) { return $this; } /** * Sets the property method flag that is true when the property is a method * * @param bool $method Method flag * * @return $this * * @codeCoverageIgnore */ public function setMethod($method) { return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a sequence of expressions. * For example: a, b * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class SequenceExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "expressions" => true ); /** * Expressions array * * @var Expression[] */ protected $expressions = array(); /** * Returns the expressions array * * @return Expression[] */ public function getExpressions() { return $this->expressions; } /** * Sets the expressions array * * @param Expression[] $expressions Expressions array * * @return $this */ public function setExpressions($expressions) { $this->assertArrayOf($expressions, "Expression"); $this->expressions = $expressions; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a property in an object literal. * For example "b" in: a = {b: 1} * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Property extends Node { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "key" => true, "value" => true, "kind" => false, "method" => false, "shorthand" => false, "computed" => false ); //Kind constants /** * The default kind for properties */ const KIND_INIT = "init"; /** * Getter property */ const KIND_GET = "get"; /** * Setter property */ const KIND_SET = "set"; /** * Property key * * @var Expression */ protected $key; /** * Property value * * @var Expression */ protected $value; /** * Property kind that is one of the kind constants * * @var string */ protected $kind = self::KIND_INIT; /** * Property method flag that is true when the property is a method * * @var bool */ protected $method = false; /** * Property shorthand flag that is true when the property is declared * using an identifier and without a value * * @var bool */ protected $shorthand = false; /** * Property computed flag that is true when the property is declared using * the square brackets syntax * * @var bool */ protected $computed = false; /** * Returns the property key * * @return Expression */ public function getKey() { return $this->key; } /** * Sets the property key * * @param Expression $key Property key * * @return $this */ public function setKey(Expression $key) { $this->key = $key; return $this; } /** * Returns the property value * * @return Expression */ public function getValue() { return $this->value; } /** * Sets the property value * * @param Expression $value Property value * * @return $this */ public function setValue($value) { $this->assertType($value, "Expression"); $this->value = $value; return $this; } /** * Returns the property kind that is one of the kind constants * * @return string */ public function getKind() { return $this->kind; } /** * Sets the property kind that is one of the kind constants * * @param string $kind Property kind * * @return $this */ public function setKind($kind) { $this->kind = $kind; return $this; } /** * Returns the property method flag that is true when the property is a * method * * @return bool */ public function getMethod() { return $this->method; } /** * Sets the property method flag that is true when the property is a method * * @param bool $method Method flag * * @return $this */ public function setMethod($method) { $this->method = (bool) $method; return $this; } /** * Returns the property shorthand flag that is true when the property * is declared using an identifier and without a value * * @return bool */ public function getShorthand() { return $this->shorthand; } /** * Sets the property shorthand flag that is true when the property * is declared using an identifier and without a value * * @param bool $shorthand Property shorthand flag * * @return $this */ public function setShorthand($shorthand) { $this->shorthand = (bool) $shorthand; return $this; } /** * Returns the property computed flag that is true when the property is * declared using the square brackets syntax * * @return bool */ public function getComputed() { return $this->computed; } /** * Sets the property computed flag that is true when the property is * declared using the square brackets syntax * * @param bool $computed Property computed flag * * @return $this */ public function setComputed($computed) { $this->computed = (bool) $computed; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an expression wrapped in round brackets. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ParenthesizedExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "expression" => true ); /** * The wrapped expression * * @var Expression */ protected $expression; /** * Returns the wrapped expression * * @return Expression */ public function getExpression() { return $this->expression; } /** * Sets the wrapped expression * * @param Expression $expression Wrapped expression * * @return $this */ public function setExpression(Expression $expression) { $this->expression = $expression; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a call expression. * For example: test() * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class CallExpression extends ChainElement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "callee" => true, "arguments" => true ); /** * The callee expression * * @var Expression|Super */ protected $callee; /** * The arguments array * * @var Expression[]|SpreadElement[] */ protected $arguments = array(); /** * Returns the callee expression * * @return Expression|Super */ public function getCallee() { return $this->callee; } /** * Sets the callee expression * * @param Expression|Super $callee Callee expression * * @return $this */ public function setCallee($callee) { $this->assertType($callee, array("Expression", "Super")); $this->callee = $callee; return $this; } /** * Returns the arguments array * * @return Expression[]|SpreadElement[] */ public function getArguments() { return $this->arguments; } /** * Sets the arguments array * * @param Expression[]|SpreadElement[] $arguments Arguments array * * @return $this */ public function setArguments($arguments) { $this->assertArrayOf($arguments, array("Expression", "SpreadElement")); $this->arguments = $arguments; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a class declaration. * For example: class test {} * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ClassDeclaration extends Class_ implements Declaration { /** * Sets the class identifier * * @param Identifier $id Class identifier * * @return $this */ public function setId($id) { $this->assertType($id, "Identifier"); $this->id = $id; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents in import declaration. * For example: import a from "mod" * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ImportDeclaration extends Node implements ModuleDeclaration { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "specifiers" => true, "source" => true, "attributes" => true ); /** * Import specifiers array * * @var array */ protected $specifiers = array(); /** * Import source * * @var Literal */ protected $source; /** * Attributes array * * @var array */ protected $attributes = array(); /** * Returns the import specifiers array * * @return array */ public function getSpecifiers() { return $this->specifiers; } /** * Sets the import specifiers array * * @param array $specifiers Import specifiers array * * @return $this */ public function setSpecifiers($specifiers) { $this->assertArrayOf( $specifiers, array( "ImportSpecifier", "ImportDefaultSpecifier", "ImportNamespaceSpecifier" ) ); $this->specifiers = $specifiers; return $this; } /** * Returns the import source * * @return Literal */ public function getSource() { return $this->source; } /** * Sets the import source * * @param Literal $source Import source * * @return $this */ public function setSource(Literal $source) { $this->source = $source; return $this; } /** * Returns the attributes array * * @return array */ public function getAttributes() { return $this->attributes; } /** * Sets the attributes array * * @param array $attributes Attributes array * * @return $this */ public function setAttributes($attributes) { $this->assertArrayOf($attributes, "ImportAttribute"); $this->attributes = $attributes; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * Abstract class for literals. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ abstract class Literal extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "value" => false, "raw" => false ); /** * Node's value * * @var mixed */ protected $value; /** * Node's raw value * * @var string */ protected $raw; /** * Returns node's type * * @return string */ public function getType() { return "Literal"; } /** * Returns node's value * * @return mixed */ public function getValue() { return $this->value; } /** * Sets node's value * * @param mixed $value Value * * @return $this */ abstract public function setValue($value); /** * Return node's raw value * * @return string */ public function getRaw() { return $this->raw; } /** * Sets node's raw value * * @param mixed $raw Raw value * * @return $this */ public function setRaw($raw) { return $this->setValue($raw); } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a function expression * For example: var test = function () {} * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class FunctionExpression extends Function_ implements Expression { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a while loop. * For example: while (test) {} * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class WhileStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "test" => true, "body" => true ); /** * The loop condition * * @var Expression */ protected $test; /** * The loop body * * @var Statement */ protected $body; /** * Returns the loop condition * * @return Expression */ public function getTest() { return $this->test; } /** * Sets the loop condition * * @param Expression $test Loop * * @return $this */ public function setTest(Expression $test) { $this->test = $test; return $this; } /** * Returns the loop body * * @return Statement */ public function getBody() { return $this->body; } /** * Sets the loop body * * @param Statement $body Loop body * * @return $this */ public function setBody(Statement $body) { $this->body = $body; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an assignment in a binding context. * For example "a = b" in: var {a = b} = c * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class AssignmentPattern extends Node implements Pattern { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "left" => true, "right" => true ); /** * The left node of the assignment * * @var Pattern */ protected $left; /** * The right node of the assignment * * @var Expression */ protected $right; /** * Returns the left node of the assignment * * @return Pattern */ public function getLeft() { return $this->left; } /** * Sets the left node of the assignment * * @param Pattern $left Left node * * @return $this */ public function setLeft(Pattern $left) { $this->left = $left; return $this; } /** * Returns the right node of the assignment * * @return Expression */ public function getRight() { return $this->right; } /** * Sets the right node of the assignment * * @param Expression $right Right node * * @return $this */ public function setRight(Expression $right) { $this->right = $right; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an array literal. * For example: [a, b, c] * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ArrayExpression extends Node implements Expression { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "elements" => true ); /** * Array elements * * @var Expression[]|SpreadElement[] */ protected $elements = array(); /** * Returns array elements * * @return Expression[]|SpreadElement[] */ public function getElements() { return $this->elements; } /** * Sets array elements * * @param Expression[]|SpreadElement[] $elements Array elements to set * * @return $this */ public function setElements($elements) { $this->assertArrayOf( $elements, array("Expression", "SpreadElement"), true ); $this->elements = $elements; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a do-while loop. * For example: do {} while (test) * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class DoWhileStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "body" => true, "test" => true ); /** * The loop body * * @var Statement */ protected $body; /** * The loop condition * * @var Expression */ protected $test; /** * Returns the loop body * * @return Statement */ public function getBody() { return $this->body; } /** * Sets the loop body * * @param Statement $body Loop body * * @return $this */ public function setBody(Statement $body) { $this->body = $body; return $this; } /** * Returns the loop condition * * @return Expression */ public function getTest() { return $this->test; } /** * Sets the loop condition * * @param Expression $test Loop * * @return $this */ public function setTest(Expression $test) { $this->test = $test; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a debugger statement. * For example: debugger; * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class DebuggerStatement extends Node implements Statement { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a member expression. * For example: foo.bar * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class MemberExpression extends ChainElement implements Pattern { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "object" => true, "property" => true, "computed" => false ); /** * Expression's object * * @var Expression|Super */ protected $object; /** * Expression's property * * @var Expression|PrivateIdentifier */ protected $property; /** * Computed flag that is true if the property is declared using square * brackets syntax * * @var bool */ protected $computed = false; /** * Returns the expression's object * * @return Expression|Super */ public function getObject() { return $this->object; } /** * Sets the expression's object * * @param Expression|Super $object Object * * @return $this */ public function setObject($object) { $this->assertType($object, array("Expression", "Super")); $this->object = $object; return $this; } /** * Returns the expression's property * * @return Expression|PrivateIdentifier */ public function getProperty() { return $this->property; } /** * Sets the expression's property * * @param Expression|PrivateIdentifier $property Property * * @return $this */ public function setProperty($property) { $this->assertType($property, array("Expression", "PrivateIdentifier")); $this->property = $property; return $this; } /** * Returns the computed flag that is true if the property is declared * using square brackets syntax * * @return bool */ public function getComputed() { return $this->computed; } /** * Sets the computed flag that is true if the property is declared * using square brackets syntax * * @param bool $computed Computed flag * * @return $this */ public function setComputed($computed) { $this->computed = (bool) $computed; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents the throw statement. * For example: throw err * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ThrowStatement extends Node implements Statement { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "argument" => true ); /** * The thrown expression * * @var Expression */ protected $argument; /** * Returns the thrown expression * * @return Expression */ public function getArgument() { return $this->argument; } /** * Sets the thrown expression * * @param Expression $argument The node to set * * @return $this */ public function setArgument(Expression $argument) { $this->argument = $argument; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents a namespace import specifier. * For example "* as test" in: import * as test from "test.js". * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ImportDefaultSpecifier extends ModuleSpecifier { }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast\Syntax\Node; /** * A node that represents an "export all" declaration. * For example: export * from "test" * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class ExportAllDeclaration extends Node implements ModuleDeclaration { /** * Map of node properties * * @var array */ protected $propertiesMap = array( "source" => true, "exported" => true, "attributes" => true ); /** * The export source * * @var Literal */ protected $source; /** * The exported name * * @var Identifier|StringLiteral */ protected $exported; /** * Attributes array * * @var array */ protected $attributes = array(); /** * Returns the export source * * @return Literal */ public function getSource() { return $this->source; } /** * Sets the export source * * @param Literal $source Export source * * @return $this */ public function setSource(Literal $source) { $this->source = $source; return $this; } /** * Returns the exported name * * @return Identifier|StringLiteral */ public function getExported() { return $this->exported; } /** * Sets the exported name *W * @param Identifier|StringLiteral $exported Exported name * * @return $this */ public function setExported($exported) { $this->assertType($exported, array("Identifier", "StringLiteral"), true); $this->exported = $exported; return $this; } /** * Returns the attributes array * * @return array */ public function getAttributes() { return $this->attributes; } /** * Sets the attributes array * * @param array $attributes Attributes array * * @return $this */ public function setAttributes($attributes) { $this->assertArrayOf($attributes, "ImportAttribute"); $this->attributes = $attributes; return $this; } }<?php /** * This file is part of the Peast package * * (c) Marco MarchiÃ² <marco.mm89@gmail.com> * * For the full copyright and license information refer to the LICENSE file * distributed with this source code */ namespace Peast; /** * Main class of Peast library. * Every function of this class takes two arguments: * - The source code to parse * - The options array that is an associative array of parser settings. * Available options are: * - "sourceType": one of the source type constants declared in this class. * This option tells the parser to parse the source in script or module * mode. If this option is not provided the parser will work in script * mode. * - "sourceEncoding": the encoding of the source. If not specified the * parser will assume UTF-8. * - "strictEncoding": if false the parser will handle invalid UTF8 * characters in the source code by replacing them with the character * defined in the "mbstring.substitute_character" ini setting, otherwise * it will throw an exception. * - "comments": if true it enables comments parsing. * - "jsx": if true it enables parsing of JSX syntax. * * @method static Syntax\Parser ES2015(string $source, array $options = array()) * Returns a parser instance with ES2015 features for the given source. See Peast * class documentation to understand the function arguments. * * @method static Syntax\Parser ES6(string $source, array $options = array()) * Returns a parser instance with ES2015 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES2016(string $source, array $options = array()) * Returns a parser instance with ES2016 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES7(string $source, array $options = array()) * Returns a parser instance with ES2016 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES2017(string $source, array $options = array()) * Returns a parser instance with ES2017 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES8(string $source, array $options = array()) * Returns a parser instance with ES2017 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES2018(string $source, array $options = array()) * Returns a parser instance with ES2018 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES9(string $source, array $options = array()) * Returns a parser instance with ES2018 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES2019(string $source, array $options = array()) * Returns a parser instance with ES2019 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES10(string $source, array $options = array()) * Returns a parser instance with ES2019 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES2020(string $source, array $options = array()) * Returns a parser instance with ES2020 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES11(string $source, array $options = array()) * Returns a parser instance with ES2020 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES2021(string $source, array $options = array()) * Returns a parser instance with ES2021 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES12(string $source, array $options = array()) * Returns a parser instance with ES2021 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES2022(string $source, array $options = array()) * Returns a parser instance with ES2022 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES13(string $source, array $options = array()) * Returns a parser instance with ES2022 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES2023(string $source, array $options = array()) * Returns a parser instance with ES2023 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES14(string $source, array $options = array()) * Returns a parser instance with ES2023 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES2024(string $source, array $options = array()) * Returns a parser instance with ES2024 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES15(string $source, array $options = array()) * Returns a parser instance with ES2024 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES2025(string $source, array $options = array()) * Returns a parser instance with ES2025 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser ES16(string $source, array $options = array()) * Returns a parser instance with ES2025 features for the given source. See Peast * class documentation to understand function arguments. * * @method static Syntax\Parser latest(string $source, array $options = array()) * Returns an instance of the latest parser version for the given source. See * Peast class documentation to understand function arguments. * * @author Marco MarchiÃ² <marco.mm89@gmail.com> */ class Peast { //Source type constants /** * This source type indicates that the source is a script and import * and export keywords are not parsed. */ const SOURCE_TYPE_SCRIPT = "script"; /** * This source type indicates that the source is a module, this enables * the parsing of import and export keywords. */ const SOURCE_TYPE_MODULE = "module"; /** * Valid versions and aliases * * @var array */ static protected $versions = array( "ES6" => "ES2015", "ES7" => "ES2016", "ES8" => "ES2017", "ES9" => "ES2018", "ES10" => "ES2019", "ES11" => "ES2020", "ES12" => "ES2021", "ES13" => "ES2022", "ES14" => "ES2023", "ES15" => "ES2024", "ES16" => "ES2025" ); /** * Magic method that exposes all the functions to access parser with * specific features * * @param string $version Parser version * @param array $args Parser arguments * * @return Syntax\Parser * * @throws \Exception */ public static function __callStatic($version, $args) { $source = $args[0]; $options = isset($args[1]) ? $args[1] : array(); if (!in_array($version, self::$versions)) { if ($version === "latest") { $version = end(self::$versions); } elseif (isset(self::$versions[$version])) { $version = self::$versions[$version]; } else { throw new \Exception("Invalid version $version"); } } $featuresClass = "\\Peast\\Syntax\\$version\\Features"; return new Syntax\Parser( $source, new $featuresClass, $options ); } }{{#is_subcommand}} {{/is_subcommand}} {{#has_subcommands}} {{/has_subcommands}} {{#has_parameters}} ## GLOBAL PARAMETERS {{#parameters}} {{synopsis}} {{desc}} {{/parameters}} {{/has_parameters}} {{#root_command}} Run 'wp help <command>' to get more information on a specific command. {{/root_command}} ## NAME {{name}} {{#shortdesc}} ## DESCRIPTION {{shortdesc}} {{/shortdesc}} ## SYNOPSIS {{synopsis}} {{#alias}} ## ALIAS {{alias}} {{/alias}} {{#has-subcommands}} ## SUBCOMMANDS {{#subcommands}} {{.}} {{/subcommands}} {{/has-subcommands}} <?php /** * The base configuration for WordPress * * The wp-config.php creation script uses this file during the installation. * You don't have to use the web site, you can copy this file to "wp-config.php" * and fill in the values. * * This file contains the following configurations: * * * Database settings * * Secret keys * * Database table prefix * * Localized language * * ABSPATH * * @link https://wordpress.org/support/article/editing-wp-config-php/ * * @package WordPress */ // ** Database settings - You can get this info from your web host ** // /** The name of the database for WordPress */ define( 'DB_NAME', '{{dbname}}' ); /** Database username */ define( 'DB_USER', '{{dbuser}}' ); /** Database password */ define( 'DB_PASSWORD', '{{dbpass}}' ); /** Database hostname */ define( 'DB_HOST', '{{dbhost}}' ); /** Database charset to use in creating database tables. */ define( 'DB_CHARSET', '{{dbcharset}}' ); /** The database collate type. Don't change this if in doubt. */ define( 'DB_COLLATE', '{{dbcollate}}' ); /**#@+ * Authentication unique keys and salts. * * Change these to different unique phrases! You can generate these using * the {@link https://api.wordpress.org/secret-key/1.1/salt/ WordPress.org secret-key service}. * * You can change these at any point in time to invalidate all existing cookies. * This will force all users to have to log in again. * * @since 2.6.0 */ {{#keys-and-salts}} define( 'AUTH_KEY', '{{auth-key}}' ); define( 'SECURE_AUTH_KEY', '{{secure-auth-key}}' ); define( 'LOGGED_IN_KEY', '{{logged-in-key}}' ); define( 'NONCE_KEY', '{{nonce-key}}' ); define( 'AUTH_SALT', '{{auth-salt}}' ); define( 'SECURE_AUTH_SALT', '{{secure-auth-salt}}' ); define( 'LOGGED_IN_SALT', '{{logged-in-salt}}' ); define( 'NONCE_SALT', '{{nonce-salt}}' ); define( 'WP_CACHE_KEY_SALT', '{{wp-cache-key-salt}}' ); {{/keys-and-salts}} {{keys-and-salts-alt}} /**#@-*/ /** * WordPress database table prefix. * * You can have multiple installations in one database if you give each * a unique prefix. Only numbers, letters, and underscores please! */ $table_prefix = '{{dbprefix}}'; {{#add-wplang}} /** * WordPress localized language, defaults to English. * * Change this to localize WordPress. A corresponding MO file for the chosen * language must be installed to wp-content/languages. For example, install * de_DE.mo to wp-content/languages and set WPLANG to 'de_DE' to enable German * language support. */ define( 'WPLANG', '{{locale}}' ); {{/add-wplang}} /* Add any custom values between this line and the "stop editing" line. */ {{extra-php}} /** * For developers: WordPress debugging mode. * * Change this to true to enable the display of notices during development. * It is strongly recommended that plugin and theme developers use WP_DEBUG * in their development environments. * * For information on other constants that can be used for debugging, * visit the documentation. * * @link https://wordpress.org/support/article/debugging-in-wordpress/ */ if ( ! defined( 'WP_DEBUG' ) ) { define( 'WP_DEBUG', false ); } /* That's all, stop editing! Happy publishing. */ /** Absolute path to the WordPress directory. */ if ( ! defined( 'ABSPATH' ) ) { define( 'ABSPATH', __DIR__ . '/' ); } /** Sets up WordPress vars and included files. */ require_once ABSPATH . 'wp-settings.php'; WordPress version: {{wp-version}} Database revision: {{db-version}} TinyMCE version: {{mce-version}} Package language: {{local-package}} Theme %9{{slug}}%n details: Name: {{name}} Status: {{status}}%n Version: {{version}} Author: {{author}} Plugin %9{{slug}}%n details: Name: {{name}} Status: {{status}}%n Version: {{version}} Author: {{author}} Description: {{description}} # A set of files you probably don't want in your WordPress.org distribution .babelrc .deployignore .distignore .editorconfig .eslintignore .eslintrc .git .gitignore .github .gitlab-ci.yml .travis.yml .DS_Store .*~ Thumbs.db behat.yml bitbucket-pipelines.yml bin .circleci/config.yml composer.json composer.lock dependencies.yml Gruntfile.js package.json package-lock.json phpunit.xml phpunit.xml.dist multisite.xml multisite.xml.dist .phpcs.xml phpcs.xml .phpcs.xml.dist phpcs.xml.dist README.md webpack.config.js wp-cli.local.yml yarn.lock tests vendor node_modules *.sql *.tar.gz *.zip variables: # Configure mysql service (https://hub.docker.com/_/mysql/) MYSQL_DATABASE: wordpress_tests MYSQL_ROOT_PASSWORD: mysql before_script: # Install dependencies # Update the docker - apt-get -yqq update - apt-get -yqqf install zip unzip subversion default-mysql-client default-libmysqlclient-dev --fix-missing # PHP extensions - docker-php-ext-install -j$(nproc) mysqli pdo_mysql # Setup WordPress tests - bash bin/install-wp-tests.sh wordpress_tests root mysql mysql latest true # Install Composer - php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" - php composer-setup.php --install-dir=/usr/local/bin --filename=composer - php -r "unlink('composer-setup.php');" - export PATH="$PATH:$HOME/.composer/vendor/bin" # Install PHPUnit - PHPUNIT_VERSION=9.6.19 - curl -o /usr/local/bin/phpunit "https://phar.phpunit.de/phpunit-${PHPUNIT_VERSION}.phar" && chmod +x /usr/local/bin/phpunit - composer global require yoast/phpunit-polyfills - export WP_TESTS_PHPUNIT_POLYFILLS_PATH="$HOME/.composer/vendor/yoast/phpunit-polyfills" - phpunit --version # Install PHPCS and WPCS - composer global config allow-plugins.dealerdirect/phpcodesniffer-composer-installer true - composer global require "wp-coding-standards/wpcs" - composer global require "phpcompatibility/phpcompatibility-wp" - phpcs --version PHPunit:PHP7.4:MySQL: image: php:7.4-bullseye services: - mysql:5.7 script: - phpcs - phpunit PHPunit:PHP8.0:MySQL: image: php:8.0-bullseye services: - mysql:5.7 script: - phpcs - phpunit PHPunit:PHP8.2:MySQL: image: php:8.2-bullseye services: - mysql:5.7 script: - phpcs - phpunit <?php /** * Plugin Name: {{plugin_name}} * Plugin URI: {{plugin_uri}} * Description: {{plugin_description}} * Author: {{plugin_author}} * Author URI: {{plugin_author_uri}} * Text Domain: {{textdomain}} * Domain Path: /languages * Version: 0.1.0 * * @package {{plugin_package}} */ // Your code starts here. <?php /** * Class SampleTest * * @package {{plugin_package}} */ /** * Sample test case. */ class SampleTest extends WP_UnitTestCase { /** * A single example test. */ public function test_sample() { // Replace this with some actual testing code. $this->assertTrue( true ); } } /** * The following styles get applied both on the front of your site and in the editor. * * Replace them with your own styles or remove the file completely. */ .wp-block-{{namespace}}-{{slug}} { background-color: #000; color: #fff; padding: 2px; } <?php /** * Custom taxonomy * * @package {{prefix}} */ /** * Registers the `{{machine_name}}` taxonomy, * for use with {{post_types}}. */ function {{prefix}}_init() { {{output}} } add_action( 'init', '{{prefix}}_init' ); /** * Sets the post updated messages for the `{{machine_name}}` taxonomy. * * @param array $messages Post updated messages. * @return array Messages for the `{{machine_name}}` taxonomy. */ function {{prefix}}_updated_messages( $messages ) { $messages['{{slug}}'] = array( 0 => '', // Unused. Messages start at index 1. 1 => __( '{{label_ucfirst}} added.', '{{textdomain}}' ), 2 => __( '{{label_ucfirst}} deleted.', '{{textdomain}}' ), 3 => __( '{{label_ucfirst}} updated.', '{{textdomain}}' ), 4 => __( '{{label_ucfirst}} not added.', '{{textdomain}}' ), 5 => __( '{{label_ucfirst}} not updated.', '{{textdomain}}' ), 6 => __( '{{label_plural_ucfirst}} deleted.', '{{textdomain}}' ), ); return $messages; } add_filter( 'term_updated_messages', '{{prefix}}_updated_messages' ); /** * The following styles get applied inside the editor only. * * Replace them with your own styles or remove the file completely. */ .wp-block-{{namespace}}-{{slug}} { border: 1px dotted #f00; } Theme %9{{slug}}%n details: Name: {{name}} Status: {{status}}%n Version: {{version}} Author: {{author}} /* Theme Name: {{theme_name}} Theme URI: {{theme_uri}} Description: {{description}} Author: {{author}} Author URI: {{author_uri}} Template: {{parent_theme}} Version: 0.1.0 */ name: Testing on: pull_request: branches: - main - master jobs: phpunit: name: Run tests runs-on: ubuntu-latest strategy: matrix: php-version: ['8.2', '8.0', '7.4'] services: database: image: mysql:latest env: MYSQL_DATABASE: wordpress_tests MYSQL_ROOT_PASSWORD: root ports: - 3306:3306 steps: - name: Check out source code uses: actions/checkout@v4 - name: Setup PHP uses: shivammathur/setup-php@v2 with: php-version: ${{ matrix.php-version }} tools: phpunit-polyfills:1.1 - name: Setup tests run: bash bin/install-wp-tests.sh wordpress_tests root root 127.0.0.1 latest true - name: Run tests run: phpunit register_post_type( '{{slug}}', array( 'labels' => array( 'name' => __( '{{label_plural_ucfirst}}', '{{textdomain}}' ), 'singular_name' => __( '{{label_ucfirst}}', '{{textdomain}}' ), 'all_items' => __( 'All {{label_plural_ucfirst}}', '{{textdomain}}' ), 'archives' => __( '{{label_ucfirst}} Archives', '{{textdomain}}' ), 'attributes' => __( '{{label_ucfirst}} Attributes', '{{textdomain}}' ), 'insert_into_item' => __( 'Insert into {{label}}', '{{textdomain}}' ), 'uploaded_to_this_item' => __( 'Uploaded to this {{label}}', '{{textdomain}}' ), 'featured_image' => _x( 'Featured Image', '{{slug}}', '{{textdomain}}' ), 'set_featured_image' => _x( 'Set featured image', '{{slug}}', '{{textdomain}}' ), 'remove_featured_image' => _x( 'Remove featured image', '{{slug}}', '{{textdomain}}' ), 'use_featured_image' => _x( 'Use as featured image', '{{slug}}', '{{textdomain}}' ), 'filter_items_list' => __( 'Filter {{label_plural}} list', '{{textdomain}}' ), 'items_list_navigation' => __( '{{label_plural_ucfirst}} list navigation', '{{textdomain}}' ), 'items_list' => __( '{{label_plural_ucfirst}} list', '{{textdomain}}' ), 'new_item' => __( 'New {{label_ucfirst}}', '{{textdomain}}' ), 'add_new' => __( 'Add New', '{{textdomain}}' ), 'add_new_item' => __( 'Add New {{label_ucfirst}}', '{{textdomain}}' ), 'edit_item' => __( 'Edit {{label_ucfirst}}', '{{textdomain}}' ), 'view_item' => __( 'View {{label_ucfirst}}', '{{textdomain}}' ), 'view_items' => __( 'View {{label_plural_ucfirst}}', '{{textdomain}}' ), 'search_items' => __( 'Search {{label_plural}}', '{{textdomain}}' ), 'not_found' => __( 'No {{label_plural}} found', '{{textdomain}}' ), 'not_found_in_trash' => __( 'No {{label_plural}} found in trash', '{{textdomain}}' ), 'parent_item_colon' => __( 'Parent {{label_ucfirst}}:', '{{textdomain}}' ), 'menu_name' => __( '{{label_plural_ucfirst}}', '{{textdomain}}' ), ), 'public' => true, 'hierarchical' => false, 'show_ui' => true, 'show_in_nav_menus' => true, 'supports' => array( 'title', 'editor' ), 'has_archive' => true, 'rewrite' => true, 'query_var' => true, 'menu_position' => null, 'menu_icon' => 'dashicons-{{dashicon}}', 'show_in_rest' => true, 'rest_base' => '{{slug}}', 'rest_controller_class' => 'WP_REST_Posts_Controller', ) ); workflows: version: 2 main: jobs: - php56-build - php70-build - php71-build - php72-build - php73-build - php74-build version: 2 job-references: mysql_image: &mysql_image circleci/mysql:5.6 setup_environment: &setup_environment name: "Setup Environment Variables" command: | echo "export PATH=$HOME/.composer/vendor/bin:$PATH" >> $BASH_ENV source /home/circleci/.bashrc install_dependencies: &install_dependencies name: "Install Dependencies" command: | sudo apt-get update && sudo apt-get install subversion sudo -E docker-php-ext-install mysqli sudo sh -c "printf '\ndeb http://ftp.us.debian.org/debian sid main\n' >> /etc/apt/sources.list" sudo apt-get update && sudo apt-get install mysql-client-5.7 php_job: &php_job environment: - WP_TESTS_DIR: "/tmp/wordpress-tests-lib" - WP_CORE_DIR: "/tmp/wordpress/" steps: - checkout - run: *setup_environment - run: *install_dependencies - run: name: "Run Tests" command: | composer global require "phpunit/phpunit=5.7.*" composer global require wp-coding-standards/wpcs phpcs --config-set installed_paths $HOME/.composer/vendor/wp-coding-standards/wpcs phpcs rm -rf $WP_TESTS_DIR $WP_CORE_DIR bash bin/install-wp-tests.sh wordpress_test root '' 127.0.0.1 latest phpunit WP_MULTISITE=1 phpunit jobs: php56-build: <<: *php_job docker: - image: circleci/php:5.6 - image: *mysql_image steps: - checkout - run: *setup_environment - run: *install_dependencies - run: name: "Run Tests" command: | composer global require "phpunit/phpunit=5.7.*" composer global require wp-coding-standards/wpcs phpcs --config-set installed_paths $HOME/.composer/vendor/wp-coding-standards/wpcs phpcs SKIP_DB_CREATE=false {{#wp_versions_to_test}} rm -rf $WP_TESTS_DIR $WP_CORE_DIR bash bin/install-wp-tests.sh wordpress_test root '' 127.0.0.1 {{.}} $SKIP_DB_CREATE phpunit WP_MULTISITE=1 phpunit SKIP_DB_CREATE=true {{/wp_versions_to_test}} php70-build: <<: *php_job docker: - image: circleci/php:7.0 - image: *mysql_image php71-build: <<: *php_job docker: - image: circleci/php:7.1 - image: *mysql_image php72-build: <<: *php_job docker: - image: circleci/php:7.2 - image: *mysql_image php73-build: <<: *php_job docker: - image: circleci/php:7.3 - image: *mysql_image php74-build: <<: *php_job docker: - image: circleci/php:7.4 - image: *mysql_image # This file is for unifying the coding style for different editors and IDEs # editorconfig.org # WordPress Coding Standards # https://make.wordpress.org/core/handbook/coding-standards/ root = true [*] charset = utf-8 end_of_line = lf insert_final_newline = true trim_trailing_whitespace = true indent_style = tab indent_size = 4 [{.jshintrc,*.json,*.yml}] indent_style = space indent_size = 2 [{*.txt,wp-config-sample.php}] end_of_line = crlf { "require-dev": { "wp-cli/i18n-command": "^2" }, "scripts": { "makepot": "wp i18n make-pot ." } } #!/usr/bin/env bash if [ $# -lt 3 ]; then echo "usage: $0 <db-name> <db-user> <db-pass> [db-host] [wp-version] [skip-database-creation]" exit 1 fi DB_NAME=$1 DB_USER=$2 DB_PASS=$3 DB_HOST=${4-localhost} WP_VERSION=${5-latest} SKIP_DB_CREATE=${6-false} TMPDIR=${TMPDIR-/tmp} TMPDIR=$(echo $TMPDIR | sed -e "s/\/$//") WP_TESTS_DIR=${WP_TESTS_DIR-$TMPDIR/wordpress-tests-lib} WP_CORE_DIR=${WP_CORE_DIR-$TMPDIR/wordpress} download() { if [ `which curl` ]; then curl -s "$1" > "$2"; elif [ `which wget` ]; then wget -nv -O "$2" "$1" else echo "Error: Neither curl nor wget is installed." exit 1 fi } # Check if svn is installed check_svn_installed() { if ! command -v svn > /dev/null; then echo "Error: svn is not installed. Please install svn and try again." exit 1 fi } if [[ $WP_VERSION =~ ^[0-9]+\.[0-9]+\-(beta|RC)[0-9]+$ ]]; then WP_BRANCH=${WP_VERSION%\-*} WP_TESTS_TAG="branches/$WP_BRANCH" elif [[ $WP_VERSION =~ ^[0-9]+\.[0-9]+$ ]]; then WP_TESTS_TAG="branches/$WP_VERSION" elif [[ $WP_VERSION =~ [0-9]+\.[0-9]+\.[0-9]+ ]]; then if [[ $WP_VERSION =~ [0-9]+\.[0-9]+\.[0] ]]; then # version x.x.0 means the first release of the major version, so strip off the .0 and download version x.x WP_TESTS_TAG="tags/${WP_VERSION%??}" else WP_TESTS_TAG="tags/$WP_VERSION" fi elif [[ $WP_VERSION == 'nightly' || $WP_VERSION == 'trunk' ]]; then WP_TESTS_TAG="trunk" else # http serves a single offer, whereas https serves multiple. we only want one download http://api.wordpress.org/core/version-check/1.7/ /tmp/wp-latest.json grep '[0-9]+\.[0-9]+(\.[0-9]+)?' /tmp/wp-latest.json LATEST_VERSION=$(grep -o '"version":"[^"]*' /tmp/wp-latest.json | sed 's/"version":"//') if [[ -z "$LATEST_VERSION" ]]; then echo "Latest WordPress version could not be found" exit 1 fi WP_TESTS_TAG="tags/$LATEST_VERSION" fi set -ex install_wp() { if [ -d $WP_CORE_DIR ]; then return; fi mkdir -p $WP_CORE_DIR if [[ $WP_VERSION == 'nightly' || $WP_VERSION == 'trunk' ]]; then mkdir -p $TMPDIR/wordpress-trunk rm -rf $TMPDIR/wordpress-trunk/* check_svn_installed svn export --quiet https://core.svn.wordpress.org/trunk $TMPDIR/wordpress-trunk/wordpress mv $TMPDIR/wordpress-trunk/wordpress/* $WP_CORE_DIR else if [ $WP_VERSION == 'latest' ]; then local ARCHIVE_NAME='latest' elif [[ $WP_VERSION =~ [0-9]+\.[0-9]+ ]]; then # https serves multiple offers, whereas http serves single. download https://api.wordpress.org/core/version-check/1.7/ $TMPDIR/wp-latest.json if [[ $WP_VERSION =~ [0-9]+\.[0-9]+\.[0] ]]; then # version x.x.0 means the first release of the major version, so strip off the .0 and download version x.x LATEST_VERSION=${WP_VERSION%??} else # otherwise, scan the releases and get the most up to date minor version of the major release local VERSION_ESCAPED=`echo $WP_VERSION | sed 's/\./\\\\./g'` LATEST_VERSION=$(grep -o '"version":"'$VERSION_ESCAPED'[^"]*' $TMPDIR/wp-latest.json | sed 's/"version":"//' | head -1) fi if [[ -z "$LATEST_VERSION" ]]; then local ARCHIVE_NAME="wordpress-$WP_VERSION" else local ARCHIVE_NAME="wordpress-$LATEST_VERSION" fi else local ARCHIVE_NAME="wordpress-$WP_VERSION" fi download https://wordpress.org/${ARCHIVE_NAME}.tar.gz $TMPDIR/wordpress.tar.gz tar --strip-components=1 -zxmf $TMPDIR/wordpress.tar.gz -C $WP_CORE_DIR fi download https://raw.githubusercontent.com/markoheijnen/wp-mysqli/master/db.php $WP_CORE_DIR/wp-content/db.php } install_test_suite() { # portable in-place argument for both GNU sed and Mac OSX sed if [[ $(uname -s) == 'Darwin' ]]; then local ioption='-i.bak' else local ioption='-i' fi # set up testing suite if it doesn't yet exist if [ ! -d $WP_TESTS_DIR ]; then # set up testing suite mkdir -p $WP_TESTS_DIR rm -rf $WP_TESTS_DIR/{includes,data} check_svn_installed svn export --quiet --ignore-externals https://develop.svn.wordpress.org/${WP_TESTS_TAG}/tests/phpunit/includes/ $WP_TESTS_DIR/includes svn export --quiet --ignore-externals https://develop.svn.wordpress.org/${WP_TESTS_TAG}/tests/phpunit/data/ $WP_TESTS_DIR/data fi if [ ! -f wp-tests-config.php ]; then download https://develop.svn.wordpress.org/${WP_TESTS_TAG}/wp-tests-config-sample.php "$WP_TESTS_DIR"/wp-tests-config.php # remove all forward slashes in the end WP_CORE_DIR=$(echo $WP_CORE_DIR | sed "s:/\+$::") sed $ioption "s:dirname( __FILE__ ) . '/src/':'$WP_CORE_DIR/':" "$WP_TESTS_DIR"/wp-tests-config.php sed $ioption "s:__DIR__ . '/src/':'$WP_CORE_DIR/':" "$WP_TESTS_DIR"/wp-tests-config.php sed $ioption "s/youremptytestdbnamehere/$DB_NAME/" "$WP_TESTS_DIR"/wp-tests-config.php sed $ioption "s/yourusernamehere/$DB_USER/" "$WP_TESTS_DIR"/wp-tests-config.php sed $ioption "s/yourpasswordhere/$DB_PASS/" "$WP_TESTS_DIR"/wp-tests-config.php sed $ioption "s|localhost|${DB_HOST}|" "$WP_TESTS_DIR"/wp-tests-config.php fi } recreate_db() { shopt -s nocasematch if [[ $1 =~ ^(y|yes)$ ]] then mysqladmin drop $DB_NAME -f --user="$DB_USER" --password="$DB_PASS"$EXTRA create_db echo "Recreated the database ($DB_NAME)." else echo "Leaving the existing database ($DB_NAME) in place." fi shopt -u nocasematch } create_db() { mysqladmin create $DB_NAME --user="$DB_USER" --password="$DB_PASS"$EXTRA } install_db() { if [ ${SKIP_DB_CREATE} = "true" ]; then return 0 fi # parse DB_HOST for port or socket references local PARTS=(${DB_HOST//\:/ }) local DB_HOSTNAME=${PARTS[0]}; local DB_SOCK_OR_PORT=${PARTS[1]}; local EXTRA="" if ! [ -z $DB_HOSTNAME ] ; then if [ $(echo $DB_SOCK_OR_PORT | grep -e '^[0-9]\{1,\}$') ]; then EXTRA=" --host=$DB_HOSTNAME --port=$DB_SOCK_OR_PORT --protocol=tcp" elif ! [ -z $DB_SOCK_OR_PORT ] ; then EXTRA=" --socket=$DB_SOCK_OR_PORT" elif ! [ -z $DB_HOSTNAME ] ; then EXTRA=" --host=$DB_HOSTNAME --protocol=tcp" fi fi # create database if [ $(mysql --user="$DB_USER" --password="$DB_PASS"$EXTRA --execute='show databases;' | grep ^$DB_NAME$) ] then echo "Reinstalling will delete the existing test database ($DB_NAME)" read -p 'Are you sure you want to proceed? [y/N]: ' DELETE_EXISTING_DB recreate_db $DELETE_EXISTING_DB else create_db fi } install_wp install_test_suite install_db ( function( wp ) { /** * Registers a new block provided a unique name and an object defining its behavior. * @see https://wordpress.org/gutenberg/handbook/designers-developers/developers/block-api/#registering-a-block */ var registerBlockType = wp.blocks.registerBlockType; /** * Returns a new element of given type. Element is an abstraction layer atop React. * @see https://wordpress.org/gutenberg/handbook/designers-developers/developers/packages/packages-element/ */ var el = wp.element.createElement; /** * Retrieves the translation of text. * @see https://wordpress.org/gutenberg/handbook/designers-developers/developers/packages/packages-i18n/ */ var __ = wp.i18n.__; /** * Every block starts by registering a new block type definition. * @see https://wordpress.org/gutenberg/handbook/designers-developers/developers/block-api/#registering-a-block */ registerBlockType( '{{namespace}}/{{slug}}', { /** * This is the display title for your block, which can be translated with `i18n` functions. * The block inserter will show this name. */ title: __( '{{title_ucfirst_js}}', '{{namespace}}' ), {{#dashicon}} /** * An icon property should be specified to make it easier to identify a block. * These can be any of WordPressâ€™ Dashicons, or a custom svg element. */ icon: '{{dashicon}}', {{/dashicon}} /** * Blocks are grouped into categories to help users browse and discover them. * The categories provided by core are `common`, `embed`, `formatting`, `layout` and `widgets`. */ category: '{{category}}', /** * Optional block extended support features. */ supports: { // Removes support for an HTML mode. html: false, }, /** * The edit function describes the structure of your block in the context of the editor. * This represents what the editor will render when the block is used. * @see https://wordpress.org/gutenberg/handbook/designers-developers/developers/block-api/block-edit-save/#edit * * @param {Object} [props] Properties passed from the editor. * @return {Element} Element to render. */ edit: function( props ) { return el( 'p', { className: props.className }, __( 'Hello from the editor!', '{{namespace}}' ) ); }, /** * The save function defines the way in which the different attributes should be combined * into the final markup, which is then serialized by Gutenberg into `post_content`. * @see https://wordpress.org/gutenberg/handbook/designers-developers/developers/block-api/block-edit-save/#save * * @return {Element} Element to render. */ save: function() { return el( 'p', {}, __( 'Hello from the saved content!', '{{namespace}}' ) ); } } ); } )( window.wp ); <?php /** * {{theme_name}} Theme functions and definitions. * * @link https://developer.wordpress.org/themes/basics/theme-functions/ * * @package {{slug}} */ add_action( 'wp_enqueue_scripts', '{{prefix_safe}}_parent_theme_enqueue_styles' ); /** * Enqueue scripts and styles. */ function {{prefix_safe}}_parent_theme_enqueue_styles() { wp_enqueue_style( '{{parent_theme}}-style', get_template_directory_uri() . '/style.css', array(), '0.1.0' ); wp_enqueue_style( '{{slug}}-style', get_stylesheet_directory_uri() . '/style.css', array( '{{parent_theme}}-style' ), '0.1.0' ); } <?xml version="1.0"?> <ruleset name="WordPress Coding Standards based custom ruleset for your plugin"> <description>Generally-applicable sniffs for WordPress plugins.</description>  <file>.</file> <exclude-pattern>/vendor/</exclude-pattern> <exclude-pattern>/node_modules/</exclude-pattern>    <arg value="sp"/>  <arg name="basepath" value="./"/> <arg name="colors"/> <arg name="extensions" value="php"/> <arg name="parallel" value="8"/>   <config name="testVersion" value="5.6-"/>  <rule ref="PHPCompatibilityWP"/>    <config name="minimum_supported_wp_version" value="4.6"/> <rule ref="WordPress"/> <rule ref="WordPress.NamingConventions.PrefixAllGlobals"> <properties>  <property name="prefixes" type="array" value="my-plugin"/> </properties> </rule> <rule ref="WordPress.WP.I18n"> <properties>  <property name="text_domain" type="array" value="my-plugin"/> </properties> </rule> <rule ref="WordPress.WhiteSpace.ControlStructureSpacing"> <properties> <property name="blank_line_check" value="true"/> </properties> </rule> </ruleset> pipelines: default: - step: image: php:7.4 name: "PHP 7.4" script: # Install Dependencies - apt-get update && apt-get install -y subversion git zip libzip-dev --no-install-recommends # PHP extensions - docker-php-ext-install -j$(nproc) mysqli pdo_mysql zip # Setup WordPress tests - bash bin/install-wp-tests.sh wordpress_tests root root 127.0.0.1 latest true # Install Composer - php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" - php composer-setup.php --install-dir=/usr/local/bin --filename=composer - php -r "unlink('composer-setup.php');" - export PATH="$PATH:$HOME/.composer/vendor/bin" - export COMPOSER_ALLOW_SUPERUSER=1 # Install PHPUnit - PHPUNIT_VERSION=9.6.19 - curl -o /usr/local/bin/phpunit "https://phar.phpunit.de/phpunit-${PHPUNIT_VERSION}.phar" && chmod +x /usr/local/bin/phpunit - composer global require yoast/phpunit-polyfills - export WP_TESTS_PHPUNIT_POLYFILLS_PATH="$HOME/.composer/vendor/yoast/phpunit-polyfills" - phpunit --version # Install PHPCS and WPCS - composer global config allow-plugins.dealerdirect/phpcodesniffer-composer-installer true - composer global require "wp-coding-standards/wpcs" - composer global require "phpcompatibility/phpcompatibility-wp" - phpcs --version # Run PHPCS - phpcs # Run PHPUnit - phpunit services: - database - step: image: php:8.0 name: "PHP 8.0" script: # Install Dependencies - apt-get update && apt-get install -y subversion git zip libzip-dev --no-install-recommends # PHP extensions - docker-php-ext-install -j$(nproc) mysqli pdo_mysql zip # Setup WordPress tests - bash bin/install-wp-tests.sh wordpress_tests root root 127.0.0.1 latest true # Install Composer - php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" - php composer-setup.php --install-dir=/usr/local/bin --filename=composer - php -r "unlink('composer-setup.php');" - export PATH="$PATH:$HOME/.composer/vendor/bin" - export COMPOSER_ALLOW_SUPERUSER=1 # Install PHPUnit - PHPUNIT_VERSION=9.6.19 - curl -o /usr/local/bin/phpunit "https://phar.phpunit.de/phpunit-${PHPUNIT_VERSION}.phar" && chmod +x /usr/local/bin/phpunit - composer global require yoast/phpunit-polyfills - export WP_TESTS_PHPUNIT_POLYFILLS_PATH="$HOME/.composer/vendor/yoast/phpunit-polyfills" - phpunit --version # Install PHPCS and WPCS - composer global config allow-plugins.dealerdirect/phpcodesniffer-composer-installer true - composer global require "wp-coding-standards/wpcs" - composer global require "phpcompatibility/phpcompatibility-wp" - phpcs --version # Run PHPCS - phpcs # Run PHPUnit - phpunit services: - database - step: image: php:8.2 name: "PHP 8.2" script: # Install Dependencies - apt-get update && apt-get install -y subversion git zip libzip-dev --no-install-recommends # PHP extensions - docker-php-ext-install -j$(nproc) mysqli pdo_mysql zip # Setup WordPress tests - bash bin/install-wp-tests.sh wordpress_tests root root 127.0.0.1 latest true # Install Composer - php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" - php composer-setup.php --install-dir=/usr/local/bin --filename=composer - php -r "unlink('composer-setup.php');" - export PATH="$PATH:$HOME/.composer/vendor/bin" - export COMPOSER_ALLOW_SUPERUSER=1 # Install PHPUnit - PHPUNIT_VERSION=9.6.19 - curl -o /usr/local/bin/phpunit "https://phar.phpunit.de/phpunit-${PHPUNIT_VERSION}.phar" && chmod +x /usr/local/bin/phpunit - composer global require yoast/phpunit-polyfills - export WP_TESTS_PHPUNIT_POLYFILLS_PATH="$HOME/.composer/vendor/yoast/phpunit-polyfills" - phpunit --version # Install PHPCS and WPCS - composer global config allow-plugins.dealerdirect/phpcodesniffer-composer-installer true - composer global require "wp-coding-standards/wpcs" - composer global require "phpcompatibility/phpcompatibility-wp" - phpcs --version # Run PHPCS - phpcs # Run PHPUnit - phpunit services: - database definitions: services: database: image: mysql:latest environment: MYSQL_DATABASE: 'wordpress_tests' MYSQL_ROOT_PASSWORD: 'root' <?php /** * PHPUnit bootstrap file. * * @package {{theme_package}} */ $_tests_dir = getenv( 'WP_TESTS_DIR' ); if ( ! $_tests_dir ) { $_tests_dir = rtrim( sys_get_temp_dir(), '/\\' ) . '/wordpress-tests-lib'; } if ( ! file_exists( $_tests_dir . '/includes/functions.php' ) ) { echo "Could not find {$_tests_dir}/includes/functions.php, have you run bin/install-wp-tests.sh ?" . PHP_EOL; exit( 1 ); } // Give access to tests_add_filter() function. require_once "{$_tests_dir}/includes/functions.php"; /** * Registers theme. */ function _register_theme() { $theme_dir = dirname( __DIR__ ); $current_theme = basename( $theme_dir ); $theme_root = dirname( $theme_dir ); add_filter( 'theme_root', function () use ( $theme_root ) { return $theme_root; } ); register_theme_directory( $theme_root ); add_filter( 'pre_option_template', function () use ( $current_theme ) { return $current_theme; } ); add_filter( 'pre_option_stylesheet', function () use ( $current_theme ) { return $current_theme; } ); } tests_add_filter( 'muplugins_loaded', '_register_theme' ); // Start up the WP testing environment. require "{$_tests_dir}/includes/bootstrap.php"; .DS_Store phpcs.xml phpunit.xml Thumbs.db wp-cli.local.yml node_modules/ vendor/ *.sql *.tar.gz *.zip <?php /** * Class SampleTest * * @package {{theme_package}} */ /** * Sample test case. */ class SampleTest extends WP_UnitTestCase { /** * A single example test. */ public function test_sample() { // Replace this with some actual testing code. $this->assertTrue( true ); } } <?xml version="1.0"?> <phpunit bootstrap="tests/bootstrap.php" backupGlobals="false" colors="true" convertErrorsToExceptions="true" convertWarningsToExceptions="true" convertNoticesToExceptions="true" convertDeprecationsToExceptions="true" > <testsuites> <testsuite name="testing"> <directory prefix="test-" suffix=".php">./tests/</directory> <exclude>./tests/test-sample.php</exclude> </testsuite> </testsuites> </phpunit> === {{plugin_name}} === Contributors: (this should be a list of wordpress.org userid's) Donate link: https://example.com/ Tags: comments, spam Requires at least: 4.5 Tested up to: {{plugin_tested_up_to}} Requires PHP: 5.6 Stable tag: 0.1.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Here is a short description of the plugin. This should be no more than 150 characters. No markup here. == Description == This is the long description. No limit, and you can use Markdown (as well as in the following sections). For backwards compatibility, if this section is missing, the full length of the short description will be used, and Markdown parsed. A few notes about the sections above: * "Contributors" is a comma separated list of wp.org/wp-plugins.org usernames * "Tags" is a comma separated list of tags that apply to the plugin * "Requires at least" is the lowest version that the plugin will work on * "Tested up to" is the highest version that you've *successfully used to test the plugin*. Note that it might work on higher versions... this is just the highest one you've verified. * Stable tag should indicate the Subversion "tag" of the latest stable version, or "trunk," if you use `/trunk/` for stable. Note that the `readme.txt` of the stable tag is the one that is considered the defining one for the plugin, so if the `/trunk/readme.txt` file says that the stable tag is `4.3`, then it is `/tags/4.3/readme.txt` that'll be used for displaying information about the plugin. In this situation, the only thing considered from the trunk `readme.txt` is the stable tag pointer. Thus, if you develop in trunk, you can update the trunk `readme.txt` to reflect changes in your in-development version, without having that information incorrectly disclosed about the current stable version that lacks those changes -- as long as the trunk's `readme.txt` points to the correct stable tag. If no stable tag is provided, it is assumed that trunk is stable, but you should specify "trunk" if that's where you put the stable version, in order to eliminate any doubt. == Installation == This section describes how to install the plugin and get it working. e.g. 1. Upload `plugin-name.php` to the `/wp-content/plugins/` directory 1. Activate the plugin through the 'Plugins' menu in WordPress 1. Place `<?php do_action('plugin_name_hook'); ?>` in your templates == Frequently Asked Questions == = A question that someone might have = An answer to that question. = What about foo bar? = Answer to foo bar dilemma. == Screenshots == 1. This screen shot description corresponds to screenshot-1.(png|jpg|jpeg|gif). Note that the screenshot is taken from the /assets directory or the directory that contains the stable readme.txt (tags or trunk). Screenshots in the /assets directory take precedence. For example, `/assets/screenshot-1.png` would win over `/tags/4.3/screenshot-1.png` (or jpg, jpeg, gif). 2. This is the second screen shot == Changelog == = 1.0 = * A change since the previous version. * Another change. = 0.5 = * List versions from most recent at top to oldest at bottom. == Upgrade Notice == = 1.0 = Upgrade notices describe the reason a user should upgrade. No more than 300 characters. = 0.5 = This version fixes a security related bug. Upgrade immediately. == Arbitrary section == You may provide arbitrary sections, in the same format as the ones above. This may be of use for extremely complicated plugins where more information needs to be conveyed that doesn't fit into the categories of "description" or "installation." Arbitrary sections will be shown below the built-in sections outlined above. == A brief Markdown Example == Ordered list: 1. Some feature 1. Another feature 1. Something else about the plugin Unordered list: * something * something else * third thing Here's a link to [WordPress](https://wordpress.org/ "Your favorite software") and one to [Markdown's Syntax Documentation][markdown syntax]. Titles are optional, naturally. [markdown syntax]: https://daringfireball.net/projects/markdown/syntax "Markdown is what the parser uses to process much of the readme file" Markdown uses email style notation for blockquotes and I've been told: > Asterisks for *emphasis*. Double it up for **strong**. `<?php code(); // goes in backticks ?>` <?php /** * PHPUnit bootstrap file. * * @package {{plugin_package}} */ $_tests_dir = getenv( 'WP_TESTS_DIR' ); if ( ! $_tests_dir ) { $_tests_dir = rtrim( sys_get_temp_dir(), '/\\' ) . '/wordpress-tests-lib'; } // Forward custom PHPUnit Polyfills configuration to PHPUnit bootstrap file. $_phpunit_polyfills_path = getenv( 'WP_TESTS_PHPUNIT_POLYFILLS_PATH' ); if ( false !== $_phpunit_polyfills_path ) { define( 'WP_TESTS_PHPUNIT_POLYFILLS_PATH', $_phpunit_polyfills_path ); } if ( ! file_exists( "{$_tests_dir}/includes/functions.php" ) ) { echo "Could not find {$_tests_dir}/includes/functions.php, have you run bin/install-wp-tests.sh ?" . PHP_EOL; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped exit( 1 ); } // Give access to tests_add_filter() function. require_once "{$_tests_dir}/includes/functions.php"; /** * Manually load the plugin being tested. */ function _manually_load_plugin() { require dirname( dirname( __FILE__ ) ) . '/{{plugin_main_file}}'; } tests_add_filter( 'muplugins_loaded', '_manually_load_plugin' ); // Start up the WP testing environment. require "{$_tests_dir}/includes/bootstrap.php"; register_taxonomy( '{{slug}}', array( {{post_types}} ), array( 'hierarchical' => false, 'public' => true, 'show_in_nav_menus' => true, 'show_ui' => true, 'show_admin_column' => false, 'query_var' => true, 'rewrite' => true, 'capabilities' => array( 'manage_terms' => 'edit_posts', 'edit_terms' => 'edit_posts', 'delete_terms' => 'edit_posts', 'assign_terms' => 'edit_posts', ), 'labels' => array( 'name' => __( '{{label_plural_ucfirst}}', '{{textdomain}}' ), 'singular_name' => _x( '{{label_ucfirst}}', 'taxonomy general name', '{{textdomain}}' ), 'search_items' => __( 'Search {{label_plural_ucfirst}}', '{{textdomain}}' ), 'popular_items' => __( 'Popular {{label_plural_ucfirst}}', '{{textdomain}}' ), 'all_items' => __( 'All {{label_plural_ucfirst}}', '{{textdomain}}' ), 'parent_item' => __( 'Parent {{label_ucfirst}}', '{{textdomain}}' ), 'parent_item_colon' => __( 'Parent {{label_ucfirst}}:', '{{textdomain}}' ), 'edit_item' => __( 'Edit {{label_ucfirst}}', '{{textdomain}}' ), 'update_item' => __( 'Update {{label_ucfirst}}', '{{textdomain}}' ), 'view_item' => __( 'View {{label_ucfirst}}', '{{textdomain}}' ), 'add_new_item' => __( 'Add New {{label_ucfirst}}', '{{textdomain}}' ), 'new_item_name' => __( 'New {{label_ucfirst}}', '{{textdomain}}' ), 'separate_items_with_commas' => __( 'Separate {{label_plural}} with commas', '{{textdomain}}' ), 'add_or_remove_items' => __( 'Add or remove {{label_plural}}', '{{textdomain}}' ), 'choose_from_most_used' => __( 'Choose from the most used {{label_plural}}', '{{textdomain}}' ), 'not_found' => __( 'No {{label_plural}} found.', '{{textdomain}}' ), 'no_terms' => __( 'No {{label_plural}}', '{{textdomain}}' ), 'menu_name' => __( '{{label_plural_ucfirst}}', '{{textdomain}}' ), 'items_list_navigation' => __( '{{label_plural_ucfirst}} list navigation', '{{textdomain}}' ), 'items_list' => __( '{{label_plural_ucfirst}} list', '{{textdomain}}' ), 'most_used' => _x( 'Most Used', '{{slug}}', '{{textdomain}}' ), 'back_to_items' => __( '← Back to {{label_plural_ucfirst}}', '{{textdomain}}' ), ), 'show_in_rest' => true, 'rest_base' => '{{slug}}', 'rest_controller_class' => 'WP_REST_Terms_Controller', ) ); <?php /** * Custom post type * * @package {{prefix}} */ /** * Registers the `{{machine_name}}` post type. */ function {{prefix}}_init() { {{output}} } add_action( 'init', '{{prefix}}_init' ); /** * Sets the post updated messages for the `{{machine_name}}` post type. * * @param array $messages Post updated messages. * @return array Messages for the `{{machine_name}}` post type. */ function {{prefix}}_updated_messages( $messages ) { global $post; $permalink = get_permalink( $post ); $messages['{{slug}}'] = array( 0 => '', // Unused. Messages start at index 1. /* translators: %s: post permalink */ 1 => sprintf( __( '{{label_ucfirst}} updated. <a target="_blank" href="%s">View {{label}}</a>', '{{textdomain}}' ), esc_url( $permalink ) ), 2 => __( 'Custom field updated.', '{{textdomain}}' ), 3 => __( 'Custom field deleted.', '{{textdomain}}' ), 4 => __( '{{label_ucfirst}} updated.', '{{textdomain}}' ), /* translators: %s: date and time of the revision */ 5 => isset( $_GET['revision'] ) ? sprintf( __( '{{label_ucfirst}} restored to revision from %s', '{{textdomain}}' ), wp_post_revision_title( (int) $_GET['revision'], false ) ) : false, // phpcs:ignore WordPress.Security.NonceVerification.Recommended /* translators: %s: post permalink */ 6 => sprintf( __( '{{label_ucfirst}} published. <a href="%s">View {{label}}</a>', '{{textdomain}}' ), esc_url( $permalink ) ), 7 => __( '{{label_ucfirst}} saved.', '{{textdomain}}' ), /* translators: %s: post permalink */ 8 => sprintf( __( '{{label_ucfirst}} submitted. <a target="_blank" href="%s">Preview {{label}}</a>', '{{textdomain}}' ), esc_url( add_query_arg( 'preview', 'true', $permalink ) ) ), /* translators: 1: Publish box date format, see https://secure.php.net/date 2: Post permalink */ 9 => sprintf( __( '{{label_ucfirst}} scheduled for: <strong>%1$s</strong>. <a target="_blank" href="%2$s">Preview {{label}}</a>', '{{textdomain}}' ), date_i18n( __( 'M j, Y @ G:i', '{{textdomain}}' ), strtotime( $post->post_date ) ), esc_url( $permalink ) ), /* translators: %s: post permalink */ 10 => sprintf( __( '{{label_ucfirst}} draft updated. <a target="_blank" href="%s">Preview {{label}}</a>', '{{textdomain}}' ), esc_url( add_query_arg( 'preview', 'true', $permalink ) ) ), ); return $messages; } add_filter( 'post_updated_messages', '{{prefix}}_updated_messages' ); /** * Sets the bulk post updated messages for the `{{machine_name}}` post type. * * @param array $bulk_messages Arrays of messages, each keyed by the corresponding post type. Messages are * keyed with 'updated', 'locked', 'deleted', 'trashed', and 'untrashed'. * @param int[] $bulk_counts Array of item counts for each message, used to build internationalized strings. * @return array Bulk messages for the `{{machine_name}}` post type. */ function {{prefix}}_bulk_updated_messages( $bulk_messages, $bulk_counts ) { global $post; $bulk_messages['{{slug}}'] = array( /* translators: %s: Number of {{label_plural}}. */ 'updated' => _n( '%s {{label}} updated.', '%s {{label_plural}} updated.', $bulk_counts['updated'], '{{textdomain}}' ), 'locked' => ( 1 === $bulk_counts['locked'] ) ? __( '1 {{label}} not updated, somebody is editing it.', '{{textdomain}}' ) : /* translators: %s: Number of {{label_plural}}. */ _n( '%s {{label}} not updated, somebody is editing it.', '%s {{label_plural}} not updated, somebody is editing them.', $bulk_counts['locked'], '{{textdomain}}' ), /* translators: %s: Number of {{label_plural}}. */ 'deleted' => _n( '%s {{label}} permanently deleted.', '%s {{label_plural}} permanently deleted.', $bulk_counts['deleted'], '{{textdomain}}' ), /* translators: %s: Number of {{label_plural}}. */ 'trashed' => _n( '%s {{label}} moved to the Trash.', '%s {{label_plural}} moved to the Trash.', $bulk_counts['trashed'], '{{textdomain}}' ), /* translators: %s: Number of {{label_plural}}. */ 'untrashed' => _n( '%s {{label}} restored from the Trash.', '%s {{label_plural}} restored from the Trash.', $bulk_counts['untrashed'], '{{textdomain}}' ), ); return $bulk_messages; } add_filter( 'bulk_post_updated_messages', '{{prefix}}_bulk_updated_messages', 10, 2 ); <?php // autoload.php @generated by Composer require_once __DIR__ . '/composer/autoload_real.php'; return ComposerAutoloaderInit9dd0c065773dc69783f4ccefde7239ca::getLoader(); Copyright (c) Nils Adermann, Jordi Boggiano Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. { "$schema": "https://json-schema.org/draft-04/schema#", "title": "Package", "type": "object", "properties": { "name": { "type": "string", "description": "Package name, including 'vendor-name/' prefix.", "pattern": "^[a-z0-9]([_.-]?[a-z0-9]+)*\/[a-z0-9](([_.]|-{1,2})?[a-z0-9]+)*$" }, "description": { "type": "string", "description": "Short package description." }, "license": { "type": ["string", "array"], "description": "License name. Or an array of license names." }, "type": { "description": "Package type, either 'library' for common packages, 'composer-plugin' for plugins, 'metapackage' for empty packages, or a custom type ([a-z0-9-]+) defined by whatever project this package applies to.", "type": "string", "pattern": "^[a-z0-9-]+$" }, "abandoned": { "type": ["boolean", "string"], "description": "Indicates whether this package has been abandoned, it can be boolean or a package name/URL pointing to a recommended alternative. Defaults to false." }, "version": { "type": "string", "description": "Package version, see https://getcomposer.org/doc/04-schema.md#version for more info on valid schemes.", "pattern": "^v?\\d+(\\.\\d+){0,3}|^dev-" }, "default-branch": { "type": ["boolean"], "description": "Internal use only, do not specify this in composer.json. Indicates whether this version is the default branch of the linked VCS repository. Defaults to false." }, "non-feature-branches": { "type": ["array"], "description": "A set of string or regex patterns for non-numeric branch names that will not be handled as feature branches.", "items": { "type": "string" } }, "keywords": { "type": "array", "items": { "type": "string", "description": "A tag/keyword that this package relates to." } }, "readme": { "type": "string", "description": "Relative path to the readme document." }, "time": { "type": "string", "description": "Package release date, in 'YYYY-MM-DD', 'YYYY-MM-DD HH:MM:SS' or 'YYYY-MM-DDTHH:MM:SSZ' format." }, "authors": { "$ref": "#/definitions/authors" }, "homepage": { "type": "string", "description": "Homepage URL for the project.", "format": "uri" }, "support": { "type": "object", "properties": { "email": { "type": "string", "description": "Email address for support.", "format": "email" }, "issues": { "type": "string", "description": "URL to the issue tracker.", "format": "uri" }, "forum": { "type": "string", "description": "URL to the forum.", "format": "uri" }, "wiki": { "type": "string", "description": "URL to the wiki.", "format": "uri" }, "irc": { "type": "string", "description": "IRC channel for support, as irc://server/channel.", "format": "uri" }, "chat": { "type": "string", "description": "URL to the support chat.", "format": "uri" }, "source": { "type": "string", "description": "URL to browse or download the sources.", "format": "uri" }, "docs": { "type": "string", "description": "URL to the documentation.", "format": "uri" }, "rss": { "type": "string", "description": "URL to the RSS feed.", "format": "uri" } } }, "funding": { "type": "array", "description": "A list of options to fund the development and maintenance of the package.", "items": { "type": "object", "properties": { "type": { "type": "string", "description": "Type of funding or platform through which funding is possible." }, "url": { "type": "string", "description": "URL to a website with details on funding and a way to fund the package.", "format": "uri" } } } }, "source": { "$ref": "#/definitions/source" }, "dist": { "$ref": "#/definitions/dist" }, "_comment": { "type": ["array", "string"], "description": "A key to store comments in" }, "require": { "type": "object", "description": "This is an object of package name (keys) and version constraints (values) that are required to run this package.", "additionalProperties": { "type": "string" } }, "require-dev": { "type": "object", "description": "This is an object of package name (keys) and version constraints (values) that this package requires for developing it (testing tools and such).", "additionalProperties": { "type": "string" } }, "replace": { "type": "object", "description": "This is an object of package name (keys) and version constraints (values) that can be replaced by this package.", "additionalProperties": { "type": "string" } }, "conflict": { "type": "object", "description": "This is an object of package name (keys) and version constraints (values) that conflict with this package.", "additionalProperties": { "type": "string" } }, "provide": { "type": "object", "description": "This is an object of package name (keys) and version constraints (values) that this package provides in addition to this package's name.", "additionalProperties": { "type": "string" } }, "suggest": { "type": "object", "description": "This is an object of package name (keys) and descriptions (values) that this package suggests work well with it (this will be suggested to the user during installation).", "additionalProperties": { "type": "string" } }, "repositories": { "type": ["object", "array"], "description": "A set of additional repositories where packages can be found.", "additionalProperties": { "anyOf": [ { "$ref": "#/definitions/repository" }, { "type": "boolean", "enum": [false] } ] }, "items": { "anyOf": [ { "$ref": "#/definitions/repository" }, { "type": "object", "additionalProperties": { "type": "boolean", "enum": [false] }, "minProperties": 1, "maxProperties": 1 } ] } }, "minimum-stability": { "type": ["string"], "description": "The minimum stability the packages must have to be install-able. Possible values are: dev, alpha, beta, RC, stable.", "enum": ["dev", "alpha", "beta", "rc", "RC", "stable"] }, "prefer-stable": { "type": ["boolean"], "description": "If set to true, stable packages will be preferred to dev packages when possible, even if the minimum-stability allows unstable packages." }, "autoload": { "$ref": "#/definitions/autoload" }, "autoload-dev": { "type": "object", "description": "Description of additional autoload rules for development purpose (eg. a test suite).", "properties": { "psr-0": { "type": "object", "description": "This is an object of namespaces (keys) and the directories they can be found into (values, can be arrays of paths) by the autoloader.", "additionalProperties": { "type": ["string", "array"], "items": { "type": "string" } } }, "psr-4": { "type": "object", "description": "This is an object of namespaces (keys) and the PSR-4 directories they can map to (values, can be arrays of paths) by the autoloader.", "additionalProperties": { "type": ["string", "array"], "items": { "type": "string" } } }, "classmap": { "type": "array", "description": "This is an array of paths that contain classes to be included in the class-map generation process." }, "files": { "type": "array", "description": "This is an array of files that are always required on every request." } } }, "target-dir": { "description": "DEPRECATED: Forces the package to be installed into the given subdirectory path. This is used for autoloading PSR-0 packages that do not contain their full path. Use forward slashes for cross-platform compatibility.", "type": "string" }, "include-path": { "type": ["array"], "description": "DEPRECATED: A list of directories which should get added to PHP's include path. This is only present to support legacy projects, and all new code should preferably use autoloading.", "items": { "type": "string" } }, "bin": { "type": ["string", "array"], "description": "A set of files, or a single file, that should be treated as binaries and symlinked into bin-dir (from config).", "items": { "type": "string" } }, "archive": { "type": ["object"], "description": "Options for creating package archives for distribution.", "properties": { "name": { "type": "string", "description": "A base name for archive." }, "exclude": { "type": "array", "description": "A list of patterns for paths to exclude or include if prefixed with an exclamation mark." } } }, "config": { "type": "object", "description": "Composer options.", "properties": { "platform": { "type": "object", "description": "This is an object of package name (keys) and version (values) that will be used to mock the platform packages on this machine.", "additionalProperties": { "type": ["string", "boolean"] } }, "allow-plugins": { "type": ["object", "boolean"], "description": "This is an object of {\"pattern\": true|false} with packages which are allowed to be loaded as plugins, or true to allow all, false to allow none. Defaults to {} which prompts when an unknown plugin is added.", "additionalProperties": { "type": ["boolean"] } }, "process-timeout": { "type": "integer", "description": "The timeout in seconds for process executions, defaults to 300 (5mins)." }, "use-include-path": { "type": "boolean", "description": "If true, the Composer autoloader will also look for classes in the PHP include path." }, "use-parent-dir": { "type": ["string", "boolean"], "description": "When running Composer in a directory where there is no composer.json, if there is one present in a directory above Composer will by default ask you whether you want to use that directory's composer.json instead. One of: true (always use parent if needed), false (never ask or use it) or \"prompt\" (ask every time), defaults to prompt." }, "preferred-install": { "type": ["string", "object"], "description": "The install method Composer will prefer to use, defaults to auto and can be any of source, dist, auto, or an object of {\"pattern\": \"preference\"}.", "additionalProperties": { "type": ["string"] } }, "notify-on-install": { "type": "boolean", "description": "Composer allows repositories to define a notification URL, so that they get notified whenever a package from that repository is installed. This option allows you to disable that behaviour, defaults to true." }, "github-protocols": { "type": "array", "description": "A list of protocols to use for github.com clones, in priority order, defaults to [\"git\", \"https\", \"http\"].", "items": { "type": "string" } }, "github-oauth": { "type": "object", "description": "An object of domain name => github API oauth tokens, typically {\"github.com\":\"<token>\"}.", "additionalProperties": { "type": "string" } }, "gitlab-oauth": { "type": "object", "description": "An object of domain name => gitlab API oauth tokens, typically {\"gitlab.com\":\"<token>\"}.", "additionalProperties": { "type": "string" } }, "gitlab-token": { "type": "object", "description": "An object of domain name => gitlab private tokens, typically {\"gitlab.com\":\"<token>\"}.", "additionalProperties": { "type": ["string", "object"], "required": ["username", "token"], "properties": { "username": { "type": "string", "description": "The username used for GitLab authentication" }, "token": { "type": "string", "description": "The token used for GitLab authentication" } } } }, "gitlab-protocol": { "enum": ["git", "http", "https"], "description": "A protocol to force use of when creating a repository URL for the `source` value of the package metadata. One of `git` or `http`. By default, Composer will generate a git URL for private repositories and http one for public repos." }, "bearer": { "type": "object", "description": "An object of domain name => bearer authentication token, for example {\"example.com\":\"<token>\"}.", "additionalProperties": { "type": "string" } }, "disable-tls": { "type": "boolean", "description": "Defaults to `false`. If set to true all HTTPS URLs will be tried with HTTP instead and no network level encryption is performed. Enabling this is a security risk and is NOT recommended. The better way is to enable the php_openssl extension in php.ini." }, "secure-http": { "type": "boolean", "description": "Defaults to `true`. If set to true only HTTPS URLs are allowed to be downloaded via Composer. If you really absolutely need HTTP access to something then you can disable it, but using \"Let's Encrypt\" to get a free SSL certificate is generally a better alternative." }, "secure-svn-domains": { "type": "array", "description": "A list of domains which should be trusted/marked as using a secure Subversion/SVN transport. By default svn:// protocol is seen as insecure and will throw. This is a better/safer alternative to disabling `secure-http` altogether.", "items": { "type": "string" } }, "cafile": { "type": "string", "description": "A way to set the path to the openssl CA file. In PHP 5.6+ you should rather set this via openssl.cafile in php.ini, although PHP 5.6+ should be able to detect your system CA file automatically." }, "capath": { "type": "string", "description": "If cafile is not specified or if the certificate is not found there, the directory pointed to by capath is searched for a suitable certificate. capath must be a correctly hashed certificate directory." }, "http-basic": { "type": "object", "description": "An object of domain name => {\"username\": \"...\", \"password\": \"...\"}.", "additionalProperties": { "type": "object", "required": ["username", "password"], "properties": { "username": { "type": "string", "description": "The username used for HTTP Basic authentication" }, "password": { "type": "string", "description": "The password used for HTTP Basic authentication" } } } }, "store-auths": { "type": ["string", "boolean"], "description": "What to do after prompting for authentication, one of: true (store), false (do not store) or \"prompt\" (ask every time), defaults to prompt." }, "vendor-dir": { "type": "string", "description": "The location where all packages are installed, defaults to \"vendor\"." }, "bin-dir": { "type": "string", "description": "The location where all binaries are linked, defaults to \"vendor/bin\"." }, "data-dir": { "type": "string", "description": "The location where old phar files are stored, defaults to \"$home\" except on XDG Base Directory compliant unixes." }, "cache-dir": { "type": "string", "description": "The location where all caches are located, defaults to \"~/.composer/cache\" on *nix and \"%LOCALAPPDATA%\\Composer\" on windows." }, "cache-files-dir": { "type": "string", "description": "The location where files (zip downloads) are cached, defaults to \"{$cache-dir}/files\"." }, "cache-repo-dir": { "type": "string", "description": "The location where repo (git/hg repo clones) are cached, defaults to \"{$cache-dir}/repo\"." }, "cache-vcs-dir": { "type": "string", "description": "The location where vcs infos (git clones, github api calls, etc. when reading vcs repos) are cached, defaults to \"{$cache-dir}/vcs\"." }, "cache-ttl": { "type": "integer", "description": "The default cache time-to-live, defaults to 15552000 (6 months)." }, "cache-files-ttl": { "type": "integer", "description": "The cache time-to-live for files, defaults to the value of cache-ttl." }, "cache-files-maxsize": { "type": ["string", "integer"], "description": "The cache max size for the files cache, defaults to \"300MiB\"." }, "cache-read-only": { "type": ["boolean"], "description": "Whether to use the Composer cache in read-only mode." }, "bin-compat": { "enum": ["auto", "full", "proxy", "symlink"], "description": "The compatibility of the binaries, defaults to \"auto\" (automatically guessed), can be \"full\" (compatible with both Windows and Unix-based systems) and \"proxy\" (only bash-style proxy)." }, "discard-changes": { "type": ["string", "boolean"], "description": "The default style of handling dirty updates, defaults to false and can be any of true, false or \"stash\"." }, "autoloader-suffix": { "type": "string", "description": "Optional string to be used as a suffix for the generated Composer autoloader. When null a random one will be generated." }, "optimize-autoloader": { "type": "boolean", "description": "Always optimize when dumping the autoloader." }, "prepend-autoloader": { "type": "boolean", "description": "If false, the composer autoloader will not be prepended to existing autoloaders, defaults to true." }, "classmap-authoritative": { "type": "boolean", "description": "If true, the composer autoloader will not scan the filesystem for classes that are not found in the class map, defaults to false." }, "apcu-autoloader": { "type": "boolean", "description": "If true, the Composer autoloader will check for APCu and use it to cache found/not-found classes when the extension is enabled, defaults to false." }, "github-domains": { "type": "array", "description": "A list of domains to use in github mode. This is used for GitHub Enterprise setups, defaults to [\"github.com\"].", "items": { "type": "string" } }, "github-expose-hostname": { "type": "boolean", "description": "Defaults to true. If set to false, the OAuth tokens created to access the github API will have a date instead of the machine hostname." }, "gitlab-domains": { "type": "array", "description": "A list of domains to use in gitlab mode. This is used for custom GitLab setups, defaults to [\"gitlab.com\"].", "items": { "type": "string" } }, "bitbucket-oauth": { "type": "object", "description": "An object of domain name => {\"consumer-key\": \"...\", \"consumer-secret\": \"...\"}.", "additionalProperties": { "type": "object", "required": ["consumer-key", "consumer-secret"], "properties": { "consumer-key": { "type": "string", "description": "The consumer-key used for OAuth authentication" }, "consumer-secret": { "type": "string", "description": "The consumer-secret used for OAuth authentication" } } } }, "use-github-api": { "type": "boolean", "description": "Defaults to true. If set to false, globally disables the use of the GitHub API for all GitHub repositories and clones the repository as it would for any other repository." }, "archive-format": { "type": "string", "description": "The default archiving format when not provided on cli, defaults to \"tar\"." }, "archive-dir": { "type": "string", "description": "The default archive path when not provided on cli, defaults to \".\"." }, "htaccess-protect": { "type": "boolean", "description": "Defaults to true. If set to false, Composer will not create .htaccess files in the composer home, cache, and data directories." }, "sort-packages": { "type": "boolean", "description": "Defaults to false. If set to true, Composer will sort packages when adding/updating a new dependency." }, "lock": { "type": "boolean", "description": "Defaults to true. If set to false, Composer will not create a composer.lock file." }, "platform-check": { "type": ["boolean", "string"], "description": "Defaults to \"php-only\" which checks only the PHP version. Setting to true will also check the presence of required PHP extensions. If set to false, Composer will not create and require a platform_check.php file as part of the autoloader bootstrap." } } }, "extra": { "type": ["object", "array"], "description": "Arbitrary extra data that can be used by plugins, for example, package of type composer-plugin may have a 'class' key defining an installer class name.", "additionalProperties": true }, "scripts": { "type": ["object"], "description": "Script listeners that will be executed before/after some events.", "properties": { "pre-install-cmd": { "type": ["array", "string"], "description": "Occurs before the install command is executed, contains one or more Class::method callables or shell commands." }, "post-install-cmd": { "type": ["array", "string"], "description": "Occurs after the install command is executed, contains one or more Class::method callables or shell commands." }, "pre-update-cmd": { "type": ["array", "string"], "description": "Occurs before the update command is executed, contains one or more Class::method callables or shell commands." }, "post-update-cmd": { "type": ["array", "string"], "description": "Occurs after the update command is executed, contains one or more Class::method callables or shell commands." }, "pre-status-cmd": { "type": ["array", "string"], "description": "Occurs before the status command is executed, contains one or more Class::method callables or shell commands." }, "post-status-cmd": { "type": ["array", "string"], "description": "Occurs after the status command is executed, contains one or more Class::method callables or shell commands." }, "pre-package-install": { "type": ["array", "string"], "description": "Occurs before a package is installed, contains one or more Class::method callables or shell commands." }, "post-package-install": { "type": ["array", "string"], "description": "Occurs after a package is installed, contains one or more Class::method callables or shell commands." }, "pre-package-update": { "type": ["array", "string"], "description": "Occurs before a package is updated, contains one or more Class::method callables or shell commands." }, "post-package-update": { "type": ["array", "string"], "description": "Occurs after a package is updated, contains one or more Class::method callables or shell commands." }, "pre-package-uninstall": { "type": ["array", "string"], "description": "Occurs before a package has been uninstalled, contains one or more Class::method callables or shell commands." }, "post-package-uninstall": { "type": ["array", "string"], "description": "Occurs after a package has been uninstalled, contains one or more Class::method callables or shell commands." }, "pre-autoload-dump": { "type": ["array", "string"], "description": "Occurs before the autoloader is dumped, contains one or more Class::method callables or shell commands." }, "post-autoload-dump": { "type": ["array", "string"], "description": "Occurs after the autoloader is dumped, contains one or more Class::method callables or shell commands." }, "post-root-package-install": { "type": ["array", "string"], "description": "Occurs after the root-package is installed, contains one or more Class::method callables or shell commands." }, "post-create-project-cmd": { "type": ["array", "string"], "description": "Occurs after the create-project command is executed, contains one or more Class::method callables or shell commands." } } }, "scripts-descriptions": { "type": ["object"], "description": "Descriptions for custom commands, shown in console help.", "additionalProperties": { "type": "string" } } }, "definitions": { "authors": { "type": "array", "description": "List of authors that contributed to the package. This is typically the main maintainers, not the full list.", "items": { "type": "object", "additionalProperties": false, "required": [ "name"], "properties": { "name": { "type": "string", "description": "Full name of the author." }, "email": { "type": "string", "description": "Email address of the author.", "format": "email" }, "homepage": { "type": "string", "description": "Homepage URL for the author.", "format": "uri" }, "role": { "type": "string", "description": "Author's role in the project." } } } }, "autoload": { "type": "object", "description": "Description of how the package can be autoloaded.", "properties": { "psr-0": { "type": "object", "description": "This is an object of namespaces (keys) and the directories they can be found in (values, can be arrays of paths) by the autoloader.", "additionalProperties": { "type": ["string", "array"], "items": { "type": "string" } } }, "psr-4": { "type": "object", "description": "This is an object of namespaces (keys) and the PSR-4 directories they can map to (values, can be arrays of paths) by the autoloader.", "additionalProperties": { "type": ["string", "array"], "items": { "type": "string" } } }, "classmap": { "type": "array", "description": "This is an array of paths that contain classes to be included in the class-map generation process." }, "files": { "type": "array", "description": "This is an array of files that are always required on every request." }, "exclude-from-classmap": { "type": "array", "description": "This is an array of patterns to exclude from autoload classmap generation. (e.g. \"exclude-from-classmap\": [\"/test/\", \"/tests/\", \"/Tests/\"]" } } }, "repository": { "type": "object", "anyOf": [ { "$ref": "#/definitions/composer-repository" }, { "$ref": "#/definitions/vcs-repository" }, { "$ref": "#/definitions/path-repository" }, { "$ref": "#/definitions/artifact-repository" }, { "$ref": "#/definitions/pear-repository" }, { "$ref": "#/definitions/package-repository" } ] }, "composer-repository": { "type": "object", "required": ["type", "url"], "properties": { "type": { "type": "string", "enum": ["composer"] }, "url": { "type": "string" }, "canonical": { "type": "boolean" }, "only": { "type": "array", "items": { "type": "string" } }, "exclude": { "type": "array", "items": { "type": "string" } }, "options": { "type": "object", "additionalProperties": true }, "allow_ssl_downgrade": { "type": "boolean" }, "force-lazy-providers": { "type": "boolean" } } }, "vcs-repository": { "type": "object", "required": ["type", "url"], "properties": { "type": { "type": "string", "enum": ["vcs", "github", "git", "gitlab", "bitbucket", "git-bitbucket", "hg", "fossil", "perforce", "svn"] }, "url": { "type": "string" }, "canonical": { "type": "boolean" }, "only": { "type": "array", "items": { "type": "string" } }, "exclude": { "type": "array", "items": { "type": "string" } }, "no-api": { "type": "boolean" }, "secure-http": { "type": "boolean" }, "svn-cache-credentials": { "type": "boolean" }, "trunk-path": { "type": ["string", "boolean"] }, "branches-path": { "type": ["string", "boolean"] }, "tags-path": { "type": ["string", "boolean"] }, "package-path": { "type": "string" }, "depot": { "type": "string" }, "branch": { "type": "string" }, "unique_perforce_client_name": { "type": "string" }, "p4user": { "type": "string" }, "p4password": { "type": "string" } } }, "path-repository": { "type": "object", "required": ["type", "url"], "properties": { "type": { "type": "string", "enum": ["path"] }, "url": { "type": "string" }, "canonical": { "type": "boolean" }, "only": { "type": "array", "items": { "type": "string" } }, "exclude": { "type": "array", "items": { "type": "string" } }, "options": { "type": "object", "properties": { "symlink": { "type": ["boolean", "null"] } }, "additionalProperties": true } } }, "artifact-repository": { "type": "object", "required": ["type", "url"], "properties": { "type": { "type": "string", "enum": ["artifact"] }, "url": { "type": "string" }, "canonical": { "type": "boolean" }, "only": { "type": "array", "items": { "type": "string" } }, "exclude": { "type": "array", "items": { "type": "string" } } } }, "pear-repository": { "type": "object", "required": ["type", "url"], "properties": { "type": { "type": "string", "enum": ["pear"] }, "url": { "type": "string" }, "canonical": { "type": "boolean" }, "only": { "type": "array", "items": { "type": "string" } }, "exclude": { "type": "array", "items": { "type": "string" } }, "vendor-alias": { "type": "string" } } }, "package-repository": { "type": "object", "required": ["type", "package"], "properties": { "type": { "type": "string", "enum": ["package"] }, "canonical": { "type": "boolean" }, "only": { "type": "array", "items": { "type": "string" } }, "exclude": { "type": "array", "items": { "type": "string" } }, "package": { "oneOf": [ { "$ref": "#/definitions/inline-package" }, { "type": "array", "items": { "$ref": "#/definitions/inline-package" } } ] } } }, "inline-package": { "type": "object", "required": ["name", "version"], "properties": { "name": { "type": "string", "description": "Package name, including 'vendor-name/' prefix." }, "type": { "type": "string" }, "target-dir": { "description": "DEPRECATED: Forces the package to be installed into the given subdirectory path. This is used for autoloading PSR-0 packages that do not contain their full path. Use forward slashes for cross-platform compatibility.", "type": "string" }, "description": { "type": "string" }, "keywords": { "type": "array", "items": { "type": "string" } }, "homepage": { "type": "string", "format": "uri" }, "version": { "type": "string" }, "time": { "type": "string" }, "license": { "type": [ "string", "array" ] }, "authors": { "$ref": "#/definitions/authors" }, "require": { "type": "object", "additionalProperties": { "type": "string" } }, "replace": { "type": "object", "additionalProperties": { "type": "string" } }, "conflict": { "type": "object", "additionalProperties": { "type": "string" } }, "provide": { "type": "object", "additionalProperties": { "type": "string" } }, "require-dev": { "type": "object", "additionalProperties": { "type": "string" } }, "suggest": { "type": "object", "additionalProperties": { "type": "string" } }, "extra": { "type": ["object", "array"], "additionalProperties": true }, "autoload": { "$ref": "#/definitions/autoload" }, "archive": { "type": ["object"], "properties": { "exclude": { "type": "array" } } }, "bin": { "type": ["string", "array"], "description": "A set of files, or a single file, that should be treated as binaries and symlinked into bin-dir (from config).", "items": { "type": "string" } }, "include-path": { "type": ["array"], "description": "DEPRECATED: A list of directories which should get added to PHP's include path. This is only present to support legacy projects, and all new code should preferably use autoloading.", "items": { "type": "string" } }, "source": { "$ref": "#/definitions/source" }, "dist": { "$ref": "#/definitions/dist" } }, "additionalProperties": true }, "source": { "type": "object", "required": ["type", "url", "reference"], "properties": { "type": { "type": "string" }, "url": { "type": "string" }, "reference": { "type": "string" }, "mirrors": { "type": "array" } } }, "dist": { "type": "object", "required": ["type", "url"], "properties": { "type": { "type": "string" }, "url": { "type": "string" }, "reference": { "type": "string" }, "shasum": { "type": "string" }, "mirrors": { "type": "array" } } } } } ## ## Bundle of CA Root Certificates ## ## Certificate data from Mozilla as of: Tue Jul 2 03:12:04 2024 GMT ## ## This is a bundle of X.509 certificates of public Certificate Authorities ## (CA). These were automatically extracted from Mozilla's root certificates ## file (certdata.txt). This file can be found in the mozilla source tree: ## https://hg.mozilla.org/releases/mozilla-release/raw-file/default/security/nss/lib/ckfw/builtins/certdata.txt ## ## It contains the certificates in PEM format and therefore ## can be directly used with curl / libcurl / php_curl, or with ## an Apache+mod_ssl webserver for SSL client authentication. ## Just configure this file as the SSLCACertificateFile. ## ## Conversion done with mk-ca-bundle.pl version 1.29. ## SHA256: 456ff095dde6dd73354c5c28c73d9c06f53b61a803963414cb91a1d92945cdd3 ## GlobalSign Root CA ================== -----BEGIN CERTIFICATE----- MIIDdTCCAl2gAwIBAgILBAAAAAABFUtaw5QwDQYJKoZIhvcNAQEFBQAwVzELMAkGA1UEBhMCQkUx GTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExEDAOBgNVBAsTB1Jvb3QgQ0ExGzAZBgNVBAMTEkds b2JhbFNpZ24gUm9vdCBDQTAeFw05ODA5MDExMjAwMDBaFw0yODAxMjgxMjAwMDBaMFcxCzAJBgNV BAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRAwDgYDVQQLEwdSb290IENBMRswGQYD VQQDExJHbG9iYWxTaWduIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDa DuaZjc6j40+Kfvvxi4Mla+pIH/EqsLmVEQS98GPR4mdmzxzdzxtIK+6NiY6arymAZavpxy0Sy6sc THAHoT0KMM0VjU/43dSMUBUc71DuxC73/OlS8pF94G3VNTCOXkNz8kHp1Wrjsok6Vjk4bwY8iGlb Kk3Fp1S4bInMm/k8yuX9ifUSPJJ4ltbcdG6TRGHRjcdGsnUOhugZitVtbNV4FpWi6cgKOOvyJBNP c1STE4U6G7weNLWLBYy5d4ux2x8gkasJU26Qzns3dLlwR5EiUWMWea6xrkEmCMgZK9FGqkjWZCrX gzT/LCrBbBlDSgeF59N89iFo7+ryUp9/k5DPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV HRMBAf8EBTADAQH/MB0GA1UdDgQWBBRge2YaRQ2XyolQL30EzTSo//z9SzANBgkqhkiG9w0BAQUF AAOCAQEA1nPnfE920I2/7LqivjTFKDK1fPxsnCwrvQmeU79rXqoRSLblCKOzyj1hTdNGCbM+w6Dj Y1Ub8rrvrTnhQ7k4o+YviiY776BQVvnGCv04zcQLcFGUl5gE38NflNUVyRRBnMRddWQVDf9VMOyG j/8N7yy5Y0b2qvzfvGn9LhJIZJrglfCm7ymPAbEVtQwdpf5pLGkkeB6zpxxxYu7KyJesF12KwvhH hm4qxFYxldBniYUr+WymXUadDKqC5JlR3XC321Y9YeRq4VzW9v493kHMB65jUr9TU/Qr6cf9tveC X4XSQRjbgbMEHMUfpIBvFSDJ3gyICh3WZlXi/EjJKSZp4A== -----END CERTIFICATE----- Entrust.net Premium 2048 Secure Server CA ========================================= -----BEGIN CERTIFICATE----- MIIEKjCCAxKgAwIBAgIEOGPe+DANBgkqhkiG9w0BAQUFADCBtDEUMBIGA1UEChMLRW50cnVzdC5u ZXQxQDA+BgNVBAsUN3d3dy5lbnRydXN0Lm5ldC9DUFNfMjA0OCBpbmNvcnAuIGJ5IHJlZi4gKGxp bWl0cyBsaWFiLikxJTAjBgNVBAsTHChjKSAxOTk5IEVudHJ1c3QubmV0IExpbWl0ZWQxMzAxBgNV BAMTKkVudHJ1c3QubmV0IENlcnRpZmljYXRpb24gQXV0aG9yaXR5ICgyMDQ4KTAeFw05OTEyMjQx NzUwNTFaFw0yOTA3MjQxNDE1MTJaMIG0MRQwEgYDVQQKEwtFbnRydXN0Lm5ldDFAMD4GA1UECxQ3 d3d3LmVudHJ1c3QubmV0L0NQU18yMDQ4IGluY29ycC4gYnkgcmVmLiAobGltaXRzIGxpYWIuKTEl MCMGA1UECxMcKGMpIDE5OTkgRW50cnVzdC5uZXQgTGltaXRlZDEzMDEGA1UEAxMqRW50cnVzdC5u ZXQgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgKDIwNDgpMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A MIIBCgKCAQEArU1LqRKGsuqjIAcVFmQqK0vRvwtKTY7tgHalZ7d4QMBzQshowNtTK91euHaYNZOL Gp18EzoOH1u3Hs/lJBQesYGpjX24zGtLA/ECDNyrpUAkAH90lKGdCCmziAv1h3edVc3kw37XamSr hRSGlVuXMlBvPci6Zgzj/L24ScF2iUkZ/cCovYmjZy/Gn7xxGWC4LeksyZB2ZnuU4q941mVTXTzW nLLPKQP5L6RQstRIzgUyVYr9smRMDuSYB3Xbf9+5CFVghTAp+XtIpGmG4zU/HoZdenoVve8AjhUi VBcAkCaTvA5JaJG/+EfTnZVCwQ5N328mz8MYIWJmQ3DW1cAH4QIDAQABo0IwQDAOBgNVHQ8BAf8E BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUVeSB0RGAvtiJuQijMfmhJAkWuXAwDQYJ KoZIhvcNAQEFBQADggEBADubj1abMOdTmXx6eadNl9cZlZD7Bh/KM3xGY4+WZiT6QBshJ8rmcnPy T/4xmf3IDExoU8aAghOY+rat2l098c5u9hURlIIM7j+VrxGrD9cv3h8Dj1csHsm7mhpElesYT6Yf zX1XEC+bBAlahLVu2B064dae0Wx5XnkcFMXj0EyTO2U87d89vqbllRrDtRnDvV5bu/8j72gZyxKT J1wDLW8w0B62GqzeWvfRqqgnpv55gcR5mTNXuhKwqeBCbJPKVt7+bYQLCIt+jerXmCHG8+c8eS9e nNFMFY3h7CI3zJpDC5fcgJCNs2ebb0gIFVbPv/ErfF6adulZkMV8gzURZVE= -----END CERTIFICATE----- Baltimore CyberTrust Root ========================= -----BEGIN CERTIFICATE----- MIIDdzCCAl+gAwIBAgIEAgAAuTANBgkqhkiG9w0BAQUFADBaMQswCQYDVQQGEwJJRTESMBAGA1UE ChMJQmFsdGltb3JlMRMwEQYDVQQLEwpDeWJlclRydXN0MSIwIAYDVQQDExlCYWx0aW1vcmUgQ3li ZXJUcnVzdCBSb290MB4XDTAwMDUxMjE4NDYwMFoXDTI1MDUxMjIzNTkwMFowWjELMAkGA1UEBhMC SUUxEjAQBgNVBAoTCUJhbHRpbW9yZTETMBEGA1UECxMKQ3liZXJUcnVzdDEiMCAGA1UEAxMZQmFs dGltb3JlIEN5YmVyVHJ1c3QgUm9vdDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKME uyKrmD1X6CZymrV51Cni4eiVgLGw41uOKymaZN+hXe2wCQVt2yguzmKiYv60iNoS6zjrIZ3AQSsB UnuId9Mcj8e6uYi1agnnc+gRQKfRzMpijS3ljwumUNKoUMMo6vWrJYeKmpYcqWe4PwzV9/lSEy/C G9VwcPCPwBLKBsua4dnKM3p31vjsufFoREJIE9LAwqSuXmD+tqYF/LTdB1kC1FkYmGP1pWPgkAx9 XbIGevOF6uvUA65ehD5f/xXtabz5OTZydc93Uk3zyZAsuT3lySNTPx8kmCFcB5kpvcY67Oduhjpr l3RjM71oGDHweI12v/yejl0qhqdNkNwnGjkCAwEAAaNFMEMwHQYDVR0OBBYEFOWdWTCCR1jMrPoI VDaGezq1BE3wMBIGA1UdEwEB/wQIMAYBAf8CAQMwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEB BQUAA4IBAQCFDF2O5G9RaEIFoN27TyclhAO992T9Ldcw46QQF+vaKSm2eT929hkTI7gQCvlYpNRh cL0EYWoSihfVCr3FvDB81ukMJY2GQE/szKN+OMY3EU/t3WgxjkzSswF07r51XgdIGn9w/xZchMB5 hbgF/X++ZRGjD8ACtPhSNzkE1akxehi/oCr0Epn3o0WC4zxe9Z2etciefC7IpJ5OCBRLbf1wbWsa Y71k5h+3zvDyny67G7fyUIhzksLi4xaNmjICq44Y3ekQEe5+NauQrz4wlHrQMz2nZQ/1/I6eYs9H RCwBXbsdtTLSR9I4LtD+gdwyah617jzV/OeBHRnDJELqYzmp -----END CERTIFICATE----- Entrust Root Certification Authority ==================================== -----BEGIN CERTIFICATE----- MIIEkTCCA3mgAwIBAgIERWtQVDANBgkqhkiG9w0BAQUFADCBsDELMAkGA1UEBhMCVVMxFjAUBgNV BAoTDUVudHJ1c3QsIEluYy4xOTA3BgNVBAsTMHd3dy5lbnRydXN0Lm5ldC9DUFMgaXMgaW5jb3Jw b3JhdGVkIGJ5IHJlZmVyZW5jZTEfMB0GA1UECxMWKGMpIDIwMDYgRW50cnVzdCwgSW5jLjEtMCsG A1UEAxMkRW50cnVzdCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA2MTEyNzIwMjM0 MloXDTI2MTEyNzIwNTM0MlowgbAxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMu MTkwNwYDVQQLEzB3d3cuZW50cnVzdC5uZXQvQ1BTIGlzIGluY29ycG9yYXRlZCBieSByZWZlcmVu Y2UxHzAdBgNVBAsTFihjKSAyMDA2IEVudHJ1c3QsIEluYy4xLTArBgNVBAMTJEVudHJ1c3QgUm9v dCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB ALaVtkNC+sZtKm9I35RMOVcF7sN5EUFoNu3s/poBj6E4KPz3EEZmLk0eGrEaTsbRwJWIsMn/MYsz A9u3g3s+IIRe7bJWKKf44LlAcTfFy0cOlypowCKVYhXbR9n10Cv/gkvJrT7eTNuQgFA/CYqEAOww Cj0Yzfv9KlmaI5UXLEWeH25DeW0MXJj+SKfFI0dcXv1u5x609mhF0YaDW6KKjbHjKYD+JXGIrb68 j6xSlkuqUY3kEzEZ6E5Nn9uss2rVvDlUccp6en+Q3X0dgNmBu1kmwhH+5pPi94DkZfs0Nw4pgHBN rziGLp5/V6+eF67rHMsoIV+2HNjnogQi+dPa2MsCAwEAAaOBsDCBrTAOBgNVHQ8BAf8EBAMCAQYw DwYDVR0TAQH/BAUwAwEB/zArBgNVHRAEJDAigA8yMDA2MTEyNzIwMjM0MlqBDzIwMjYxMTI3MjA1 MzQyWjAfBgNVHSMEGDAWgBRokORnpKZTgMeGZqTx90tD+4S9bTAdBgNVHQ4EFgQUaJDkZ6SmU4DH hmak8fdLQ/uEvW0wHQYJKoZIhvZ9B0EABBAwDhsIVjcuMTo0LjADAgSQMA0GCSqGSIb3DQEBBQUA A4IBAQCT1DCw1wMgKtD5Y+iRDAUgqV8ZyntyTtSx29CW+1RaGSwMCPeyvIWonX9tO1KzKtvn1ISM Y/YPyyYBkVBs9F8U4pN0wBOeMDpQ47RgxRzwIkSNcUesyBrJ6ZuaAGAT/3B+XxFNSRuzFVJ7yVTa v52Vr2ua2J7p8eRDjeIRRDq/r72DQnNSi6q7pynP9WQcCk3RvKqsnyrQ/39/2n3qse0wJcGE2jTS W3iDVuycNsMm4hH2Z0kdkquM++v/eu6FSqdQgPCnXEqULl8FmTxSQeDNtGPPAUO6nIPcj2A781q0 tHuu2guQOHXvgR1m0vdXcDazv/wor3ElhVsT/h5/WrQ8 -----END CERTIFICATE----- Comodo AAA Services root ======================== -----BEGIN CERTIFICATE----- MIIEMjCCAxqgAwIBAgIBATANBgkqhkiG9w0BAQUFADB7MQswCQYDVQQGEwJHQjEbMBkGA1UECAwS R3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHDAdTYWxmb3JkMRowGAYDVQQKDBFDb21vZG8gQ0Eg TGltaXRlZDEhMB8GA1UEAwwYQUFBIENlcnRpZmljYXRlIFNlcnZpY2VzMB4XDTA0MDEwMTAwMDAw MFoXDTI4MTIzMTIzNTk1OVowezELMAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hl c3RlcjEQMA4GA1UEBwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQxITAfBgNV BAMMGEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC ggEBAL5AnfRu4ep2hxxNRUSOvkbIgwadwSr+GB+O5AL686tdUIoWMQuaBtDFcCLNSS1UY8y2bmhG C1Pqy0wkwLxyTurxFa70VJoSCsN6sjNg4tqJVfMiWPPe3M/vg4aijJRPn2jymJBGhCfHdr/jzDUs i14HZGWCwEiwqJH5YZ92IFCokcdmtet4YgNW8IoaE+oxox6gmf049vYnMlhvB/VruPsUK6+3qszW Y19zjNoFmag4qMsXeDZRrOme9Hg6jc8P2ULimAyrL58OAd7vn5lJ8S3frHRNG5i1R8XlKdH5kBjH Ypy+g8cmez6KJcfA3Z3mNWgQIJ2P2N7Sw4ScDV7oL8kCAwEAAaOBwDCBvTAdBgNVHQ4EFgQUoBEK Iz6W8Qfs4q8p74Klf9AwpLQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wewYDVR0f BHQwcjA4oDagNIYyaHR0cDovL2NybC5jb21vZG9jYS5jb20vQUFBQ2VydGlmaWNhdGVTZXJ2aWNl cy5jcmwwNqA0oDKGMGh0dHA6Ly9jcmwuY29tb2RvLm5ldC9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2Vz LmNybDANBgkqhkiG9w0BAQUFAAOCAQEACFb8AvCb6P+k+tZ7xkSAzk/ExfYAWMymtrwUSWgEdujm 7l3sAg9g1o1QGE8mTgHj5rCl7r+8dFRBv/38ErjHT1r0iWAFf2C3BUrz9vHCv8S5dIa2LX1rzNLz Rt0vxuBqw8M0Ayx9lt1awg6nCpnBBYurDC/zXDrPbDdVCYfeU0BsWO/8tqtlbgT2G9w84FoVxp7Z 8VlIMCFlA2zs6SFz7JsDoeA3raAVGI/6ugLOpyypEBMs1OUIJqsil2D4kF501KKaU73yqWjgom7C 12yxow+ev+to51byrvLjKzg6CYG1a4XXvi3tPxq3smPi9WIsgtRqAEFQ8TmDn5XpNpaYbg== -----END CERTIFICATE----- QuoVadis Root CA 2 ================== -----BEGIN CERTIFICATE----- MIIFtzCCA5+gAwIBAgICBQkwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0xGTAXBgNVBAoT EFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJvb3QgQ0EgMjAeFw0wNjExMjQx ODI3MDBaFw0zMTExMjQxODIzMzNaMEUxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM aW1pdGVkMRswGQYDVQQDExJRdW9WYWRpcyBSb290IENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4IC DwAwggIKAoICAQCaGMpLlA0ALa8DKYrwD4HIrkwZhR0In6spRIXzL4GtMh6QRr+jhiYaHv5+HBg6 XJxgFyo6dIMzMH1hVBHL7avg5tKifvVrbxi3Cgst/ek+7wrGsxDp3MJGF/hd/aTa/55JWpzmM+Yk lvc/ulsrHHo1wtZn/qtmUIttKGAr79dgw8eTvI02kfN/+NsRE8Scd3bBrrcCaoF6qUWD4gXmuVbB lDePSHFjIuwXZQeVikvfj8ZaCuWw419eaxGrDPmF60Tp+ARz8un+XJiM9XOva7R+zdRcAitMOeGy lZUtQofX1bOQQ7dsE/He3fbE+Ik/0XX1ksOR1YqI0JDs3G3eicJlcZaLDQP9nL9bFqyS2+r+eXyt 66/3FsvbzSUr5R/7mp/iUcw6UwxI5g69ybR2BlLmEROFcmMDBOAENisgGQLodKcftslWZvB1Jdxn wQ5hYIizPtGo/KPaHbDRsSNU30R2be1B2MGyIrZTHN81Hdyhdyox5C315eXbyOD/5YDXC2Og/zOh D7osFRXql7PSorW+8oyWHhqPHWykYTe5hnMz15eWniN9gqRMgeKh0bpnX5UHoycR7hYQe7xFSkyy BNKr79X9DFHOUGoIMfmR2gyPZFwDwzqLID9ujWc9Otb+fVuIyV77zGHcizN300QyNQliBJIWENie J0f7OyHj+OsdWwIDAQABo4GwMIGtMA8GA1UdEwEB/wQFMAMBAf8wCwYDVR0PBAQDAgEGMB0GA1Ud DgQWBBQahGK8SEwzJQTU7tD2A8QZRtGUazBuBgNVHSMEZzBlgBQahGK8SEwzJQTU7tD2A8QZRtGU a6FJpEcwRTELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMT ElF1b1ZhZGlzIFJvb3QgQ0EgMoICBQkwDQYJKoZIhvcNAQEFBQADggIBAD4KFk2fBluornFdLwUv Z+YTRYPENvbzwCYMDbVHZF34tHLJRqUDGCdViXh9duqWNIAXINzng/iN/Ae42l9NLmeyhP3ZRPx3 UIHmfLTJDQtyU/h2BwdBR5YM++CCJpNVjP4iH2BlfF/nJrP3MpCYUNQ3cVX2kiF495V5+vgtJodm VjB3pjd4M1IQWK4/YY7yarHvGH5KWWPKjaJW1acvvFYfzznB4vsKqBUsfU16Y8Zsl0Q80m/DShcK +JDSV6IZUaUtl0HaB0+pUNqQjZRG4T7wlP0QADj1O+hA4bRuVhogzG9Yje0uRY/W6ZM/57Es3zrW IozchLsib9D45MY56QSIPMO661V6bYCZJPVsAfv4l7CUW+v90m/xd2gNNWQjrLhVoQPRTUIZ3Ph1 WVaj+ahJefivDrkRoHy3au000LYmYjgahwz46P0u05B/B5EqHdZ+XIWDmbA4CD/pXvk1B+TJYm5X f6dQlfe6yJvmjqIBxdZmv3lh8zwc4bmCXF2gw+nYSL0ZohEUGW6yhhtoPkg3Goi3XZZenMfvJ2II 4pEZXNLxId26F0KCl3GBUzGpn/Z9Yr9y4aOTHcyKJloJONDO1w2AFrR4pTqHTI2KpdVGl/IsELm8 VCLAAVBpQ570su9t+Oza8eOx79+Rj1QqCyXBJhnEUhAFZdWCEOrCMc0u -----END CERTIFICATE----- QuoVadis Root CA 3 ================== -----BEGIN CERTIFICATE----- MIIGnTCCBIWgAwIBAgICBcYwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0xGTAXBgNVBAoT EFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJvb3QgQ0EgMzAeFw0wNjExMjQx OTExMjNaFw0zMTExMjQxOTA2NDRaMEUxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM aW1pdGVkMRswGQYDVQQDExJRdW9WYWRpcyBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4IC DwAwggIKAoICAQDMV0IWVJzmmNPTTe7+7cefQzlKZbPoFog02w1ZkXTPkrgEQK0CSzGrvI2RaNgg DhoB4hp7Thdd4oq3P5kazethq8Jlph+3t723j/z9cI8LoGe+AaJZz3HmDyl2/7FWeUUrH556VOij KTVopAFPD6QuN+8bv+OPEKhyq1hX51SGyMnzW9os2l2ObjyjPtr7guXd8lyyBTNvijbO0BNO/79K DDRMpsMhvVAEVeuxu537RR5kFd5VAYwCdrXLoT9CabwvvWhDFlaJKjdhkf2mrk7AyxRllDdLkgbv BNDInIjbC3uBr7E9KsRlOni27tyAsdLTmZw67mtaa7ONt9XOnMK+pUsvFrGeaDsGb659n/je7Mwp p5ijJUMv7/FfJuGITfhebtfZFG4ZM2mnO4SJk8RTVROhUXhA+LjJou57ulJCg54U7QVSWllWp5f8 nT8KKdjcT5EOE7zelaTfi5m+rJsziO+1ga8bxiJTyPbH7pcUsMV8eFLI8M5ud2CEpukqdiDtWAEX MJPpGovgc2PZapKUSU60rUqFxKMiMPwJ7Wgic6aIDFUhWMXhOp8q3crhkODZc6tsgLjoC2SToJyM Gf+z0gzskSaHirOi4XCPLArlzW1oUevaPwV/izLmE1xr/l9A4iLItLRkT9a6fUg+qGkM17uGcclz uD87nSVL2v9A6wIDAQABo4IBlTCCAZEwDwYDVR0TAQH/BAUwAwEB/zCB4QYDVR0gBIHZMIHWMIHT BgkrBgEEAb5YAAMwgcUwgZMGCCsGAQUFBwICMIGGGoGDQW55IHVzZSBvZiB0aGlzIENlcnRpZmlj YXRlIGNvbnN0aXR1dGVzIGFjY2VwdGFuY2Ugb2YgdGhlIFF1b1ZhZGlzIFJvb3QgQ0EgMyBDZXJ0 aWZpY2F0ZSBQb2xpY3kgLyBDZXJ0aWZpY2F0aW9uIFByYWN0aWNlIFN0YXRlbWVudC4wLQYIKwYB BQUHAgEWIWh0dHA6Ly93d3cucXVvdmFkaXNnbG9iYWwuY29tL2NwczALBgNVHQ8EBAMCAQYwHQYD VR0OBBYEFPLAE+CCQz777i9nMpY1XNu4ywLQMG4GA1UdIwRnMGWAFPLAE+CCQz777i9nMpY1XNu4 ywLQoUmkRzBFMQswCQYDVQQGEwJCTTEZMBcGA1UEChMQUXVvVmFkaXMgTGltaXRlZDEbMBkGA1UE AxMSUXVvVmFkaXMgUm9vdCBDQSAzggIFxjANBgkqhkiG9w0BAQUFAAOCAgEAT62gLEz6wPJv92ZV qyM07ucp2sNbtrCD2dDQ4iH782CnO11gUyeim/YIIirnv6By5ZwkajGxkHon24QRiSemd1o417+s hvzuXYO8BsbRd2sPbSQvS3pspweWyuOEn62Iix2rFo1bZhfZFvSLgNLd+LJ2w/w4E6oM3kJpK27z POuAJ9v1pkQNn1pVWQvVDVJIxa6f8i+AxeoyUDUSly7B4f/xI4hROJ/yZlZ25w9Rl6VSDE1JUZU2 Pb+iSwwQHYaZTKrzchGT5Or2m9qoXadNt54CrnMAyNojA+j56hl0YgCUyyIgvpSnWbWCar6ZeXqp 8kokUvd0/bpO5qgdAm6xDYBEwa7TIzdfu4V8K5Iu6H6li92Z4b8nby1dqnuH/grdS/yO9SbkbnBC bjPsMZ57k8HkyWkaPcBrTiJt7qtYTcbQQcEr6k8Sh17rRdhs9ZgC06DYVYoGmRmioHfRMJ6szHXu g/WwYjnPbFfiTNKRCw51KBuav/0aQ/HKd/s7j2G4aSgWQgRecCocIdiP4b0jWy10QJLZYxkNc91p vGJHvOB0K7Lrfb5BG7XARsWhIstfTsEokt4YutUqKLsRixeTmJlglFwjz1onl14LBQaTNx47aTbr qZ5hHY8y2o4M1nQ+ewkk2gF3R8Q7zTSMmfXK4SVhM7JZG+Ju1zdXtg2pEto= -----END CERTIFICATE----- XRamp Global CA Root ==================== -----BEGIN CERTIFICATE----- MIIEMDCCAxigAwIBAgIQUJRs7Bjq1ZxN1ZfvdY+grTANBgkqhkiG9w0BAQUFADCBgjELMAkGA1UE BhMCVVMxHjAcBgNVBAsTFXd3dy54cmFtcHNlY3VyaXR5LmNvbTEkMCIGA1UEChMbWFJhbXAgU2Vj dXJpdHkgU2VydmljZXMgSW5jMS0wKwYDVQQDEyRYUmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBB dXRob3JpdHkwHhcNMDQxMTAxMTcxNDA0WhcNMzUwMTAxMDUzNzE5WjCBgjELMAkGA1UEBhMCVVMx HjAcBgNVBAsTFXd3dy54cmFtcHNlY3VyaXR5LmNvbTEkMCIGA1UEChMbWFJhbXAgU2VjdXJpdHkg U2VydmljZXMgSW5jMS0wKwYDVQQDEyRYUmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBBdXRob3Jp dHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCYJB69FbS638eMpSe2OAtp87ZOqCwu IR1cRN8hXX4jdP5efrRKt6atH67gBhbim1vZZ3RrXYCPKZ2GG9mcDZhtdhAoWORlsH9KmHmf4MMx foArtYzAQDsRhtDLooY2YKTVMIJt2W7QDxIEM5dfT2Fa8OT5kavnHTu86M/0ay00fOJIYRyO82FE zG+gSqmUsE3a56k0enI4qEHMPJQRfevIpoy3hsvKMzvZPTeL+3o+hiznc9cKV6xkmxnr9A8ECIqs AxcZZPRaJSKNNCyy9mgdEm3Tih4U2sSPpuIjhdV6Db1q4Ons7Be7QhtnqiXtRYMh/MHJfNViPvry xS3T/dRlAgMBAAGjgZ8wgZwwEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0PBAQDAgGGMA8GA1Ud EwEB/wQFMAMBAf8wHQYDVR0OBBYEFMZPoj0GY4QJnM5i5ASsjVy16bYbMDYGA1UdHwQvMC0wK6Ap oCeGJWh0dHA6Ly9jcmwueHJhbXBzZWN1cml0eS5jb20vWEdDQS5jcmwwEAYJKwYBBAGCNxUBBAMC AQEwDQYJKoZIhvcNAQEFBQADggEBAJEVOQMBG2f7Shz5CmBbodpNl2L5JFMn14JkTpAuw0kbK5rc /Kh4ZzXxHfARvbdI4xD2Dd8/0sm2qlWkSLoC295ZLhVbO50WfUfXN+pfTXYSNrsf16GBBEYgoyxt qZ4Bfj8pzgCT3/3JknOJiWSe5yvkHJEs0rnOfc5vMZnT5r7SHpDwCRR5XCOrTdLaIR9NmXmd4c8n nxCbHIgNsIpkQTG4DmyQJKSbXHGPurt+HBvbaoAPIbzp26a3QPSyi6mx5O+aGtA9aZnuqCij4Tyz 8LIRnM98QObd50N9otg6tamN8jSZxNQQ4Qb9CYQQO+7ETPTsJ3xCwnR8gooJybQDJbw= -----END CERTIFICATE----- Go Daddy Class 2 CA =================== -----BEGIN CERTIFICATE----- MIIEADCCAuigAwIBAgIBADANBgkqhkiG9w0BAQUFADBjMQswCQYDVQQGEwJVUzEhMB8GA1UEChMY VGhlIEdvIERhZGR5IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBEYWRkeSBDbGFzcyAyIENlcnRp ZmljYXRpb24gQXV0aG9yaXR5MB4XDTA0MDYyOTE3MDYyMFoXDTM0MDYyOTE3MDYyMFowYzELMAkG A1UEBhMCVVMxITAfBgNVBAoTGFRoZSBHbyBEYWRkeSBHcm91cCwgSW5jLjExMC8GA1UECxMoR28g RGFkZHkgQ2xhc3MgMiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASAwDQYJKoZIhvcNAQEBBQAD ggENADCCAQgCggEBAN6d1+pXGEmhW+vXX0iG6r7d/+TvZxz0ZWizV3GgXne77ZtJ6XCAPVYYYwhv 2vLM0D9/AlQiVBDYsoHUwHU9S3/Hd8M+eKsaA7Ugay9qK7HFiH7Eux6wwdhFJ2+qN1j3hybX2C32 qRe3H3I2TqYXP2WYktsqbl2i/ojgC95/5Y0V4evLOtXiEqITLdiOr18SPaAIBQi2XKVlOARFmR6j YGB0xUGlcmIbYsUfb18aQr4CUWWoriMYavx4A6lNf4DD+qta/KFApMoZFv6yyO9ecw3ud72a9nmY vLEHZ6IVDd2gWMZEewo+YihfukEHU1jPEX44dMX4/7VpkI+EdOqXG68CAQOjgcAwgb0wHQYDVR0O BBYEFNLEsNKR1EwRcbNhyz2h/t2oatTjMIGNBgNVHSMEgYUwgYKAFNLEsNKR1EwRcbNhyz2h/t2o atTjoWekZTBjMQswCQYDVQQGEwJVUzEhMB8GA1UEChMYVGhlIEdvIERhZGR5IEdyb3VwLCBJbmMu MTEwLwYDVQQLEyhHbyBEYWRkeSBDbGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5ggEAMAwG A1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEBADJL87LKPpH8EsahB4yOd6AzBhRckB4Y9wim PQoZ+YeAEW5p5JYXMP80kWNyOO7MHAGjHZQopDH2esRU1/blMVgDoszOYtuURXO1v0XJJLXVggKt I3lpjbi2Tc7PTMozI+gciKqdi0FuFskg5YmezTvacPd+mSYgFFQlq25zheabIZ0KbIIOqPjCDPoQ HmyW74cNxA9hi63ugyuV+I6ShHI56yDqg+2DzZduCLzrTia2cyvk0/ZM/iZx4mERdEr/VxqHD3VI Ls9RaRegAhJhldXRQLIQTO7ErBBDpqWeCtWVYpoNz4iCxTIM5CufReYNnyicsbkqWletNw+vHX/b vZ8= -----END CERTIFICATE----- Starfield Class 2 CA ==================== -----BEGIN CERTIFICATE----- MIIEDzCCAvegAwIBAgIBADANBgkqhkiG9w0BAQUFADBoMQswCQYDVQQGEwJVUzElMCMGA1UEChMc U3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMpU3RhcmZpZWxkIENsYXNzIDIg Q2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQwNjI5MTczOTE2WhcNMzQwNjI5MTczOTE2WjBo MQswCQYDVQQGEwJVUzElMCMGA1UEChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAG A1UECxMpU3RhcmZpZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEgMA0GCSqG SIb3DQEBAQUAA4IBDQAwggEIAoIBAQC3Msj+6XGmBIWtDBFk385N78gDGIc/oav7PKaf8MOh2tTY bitTkPskpD6E8J7oX+zlJ0T1KKY/e97gKvDIr1MvnsoFAZMej2YcOadN+lq2cwQlZut3f+dZxkqZ JRRU6ybH838Z1TBwj6+wRir/resp7defqgSHo9T5iaU0X9tDkYI22WY8sbi5gv2cOj4QyDvvBmVm epsZGD3/cVE8MC5fvj13c7JdBmzDI1aaK4UmkhynArPkPw2vCHmCuDY96pzTNbO8acr1zJ3o/WSN F4Azbl5KXZnJHoe0nRrA1W4TNSNe35tfPe/W93bC6j67eA0cQmdrBNj41tpvi/JEoAGrAgEDo4HF MIHCMB0GA1UdDgQWBBS/X7fRzt0fhvRbVazc1xDCDqmI5zCBkgYDVR0jBIGKMIGHgBS/X7fRzt0f hvRbVazc1xDCDqmI56FspGowaDELMAkGA1UEBhMCVVMxJTAjBgNVBAoTHFN0YXJmaWVsZCBUZWNo bm9sb2dpZXMsIEluYy4xMjAwBgNVBAsTKVN0YXJmaWVsZCBDbGFzcyAyIENlcnRpZmljYXRpb24g QXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEBAAWdP4id0ckaVaGs afPzWdqbAYcaT1epoXkJKtv3L7IezMdeatiDh6GX70k1PncGQVhiv45YuApnP+yz3SFmH8lU+nLM PUxA2IGvd56Deruix/U0F47ZEUD0/CwqTRV/p2JdLiXTAAsgGh1o+Re49L2L7ShZ3U0WixeDyLJl xy16paq8U4Zt3VekyvggQQto8PT7dL5WXXp59fkdheMtlb71cZBDzI0fmgAKhynpVSJYACPq4xJD KVtHCN2MQWplBqjlIapBtJUhlbl90TSrE9atvNziPTnNvT51cKEYWQPJIrSPnNVeKtelttQKbfi3 QBFGmh95DmK/D5fs4C8fF5Q= -----END CERTIFICATE----- DigiCert Assured ID Root CA =========================== -----BEGIN CERTIFICATE----- MIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0BAQUFADBlMQswCQYDVQQG EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSQw IgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0EwHhcNMDYxMTEwMDAwMDAwWhcNMzEx MTEwMDAwMDAwWjBlMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQL ExB3d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0Ew ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCtDhXO5EOAXLGH87dg+XESpa7cJpSIqvTO 9SA5KFhgDPiA2qkVlTJhPLWxKISKityfCgyDF3qPkKyK53lTXDGEKvYPmDI2dsze3Tyoou9q+yHy UmHfnyDXH+Kx2f4YZNISW1/5WBg1vEfNoTb5a3/UsDg+wRvDjDPZ2C8Y/igPs6eD1sNuRMBhNZYW /lmci3Zt1/GiSw0r/wty2p5g0I6QNcZ4VYcgoc/lbQrISXwxmDNsIumH0DJaoroTghHtORedmTpy oeb6pNnVFzF1roV9Iq4/AUaG9ih5yLHa5FcXxH4cDrC0kqZWs72yl+2qp/C3xag/lRbQ/6GW6whf GHdPAgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRF 66Kv9JLLgjEtUYunpyGd823IDzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYunpyGd823IDzANBgkq hkiG9w0BAQUFAAOCAQEAog683+Lt8ONyc3pklL/3cmbYMuRCdWKuh+vy1dneVrOfzM4UKLkNl2Bc EkxY5NM9g0lFWJc1aRqoR+pWxnmrEthngYTffwk8lOa4JiwgvT2zKIn3X/8i4peEH+ll74fg38Fn SbNd67IJKusm7Xi+fT8r87cmNW1fiQG2SVufAQWbqz0lwcy2f8Lxb4bG+mRo64EtlOtCt/qMHt1i 8b5QZ7dsvfPxH2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu838fYxAe +o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw8g== -----END CERTIFICATE----- DigiCert Global Root CA ======================= -----BEGIN CERTIFICATE----- MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBhMQswCQYDVQQG EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSAw HgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBDQTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAw MDAwMDBaMGExCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3 dy5kaWdpY2VydC5jb20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkq hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsBCSDMAZOn TjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97nh6Vfe63SKMI2tavegw5 BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt43C/dxC//AH2hdmoRBBYMql1GNXRor5H 4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7PT19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y 7vrTC0LUq7dBMtoM1O/4gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQAB o2MwYTAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbRTLtm 8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUwDQYJKoZIhvcNAQEF BQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/EsrhMAtudXH/vTBH1jLuG2cenTnmCmr EbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIt tep3Sp+dWOIrWcBAI+0tKIJFPnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886 UAb3LujEV0lsYSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4= -----END CERTIFICATE----- DigiCert High Assurance EV Root CA ================================== -----BEGIN CERTIFICATE----- MIIDxTCCAq2gAwIBAgIQAqxcJmoLQJuPC3nyrkYldzANBgkqhkiG9w0BAQUFADBsMQswCQYDVQQG EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSsw KQYDVQQDEyJEaWdpQ2VydCBIaWdoIEFzc3VyYW5jZSBFViBSb290IENBMB4XDTA2MTExMDAwMDAw MFoXDTMxMTExMDAwMDAwMFowbDELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZ MBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTErMCkGA1UEAxMiRGlnaUNlcnQgSGlnaCBBc3N1cmFu Y2UgRVYgUm9vdCBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMbM5XPm+9S75S0t Mqbf5YE/yc0lSbZxKsPVlDRnogocsF9ppkCxxLeyj9CYpKlBWTrT3JTWPNt0OKRKzE0lgvdKpVMS OO7zSW1xkX5jtqumX8OkhPhPYlG++MXs2ziS4wblCJEMxChBVfvLWokVfnHoNb9Ncgk9vjo4UFt3 MRuNs8ckRZqnrG0AFFoEt7oT61EKmEFBIk5lYYeBQVCmeVyJ3hlKV9Uu5l0cUyx+mM0aBhakaHPQ NAQTXKFx01p8VdteZOE3hzBWBOURtCmAEvF5OYiiAhF8J2a3iLd48soKqDirCmTCv2ZdlYTBoSUe h10aUAsgEsxBu24LUTi4S8sCAwEAAaNjMGEwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMB Af8wHQYDVR0OBBYEFLE+w2kD+L9HAdSYJhoIAu9jZCvDMB8GA1UdIwQYMBaAFLE+w2kD+L9HAdSY JhoIAu9jZCvDMA0GCSqGSIb3DQEBBQUAA4IBAQAcGgaX3NecnzyIZgYIVyHbIUf4KmeqvxgydkAQ V8GK83rZEWWONfqe/EW1ntlMMUu4kehDLI6zeM7b41N5cdblIZQB2lWHmiRk9opmzN6cN82oNLFp myPInngiK3BD41VHMWEZ71jFhS9OMPagMRYjyOfiZRYzy78aG6A9+MpeizGLYAiJLQwGXFK3xPkK mNEVX58Svnw2Yzi9RKR/5CYrCsSXaQ3pjOLAEFe4yHYSkVXySGnYvCoCWw9E1CAx2/S6cCZdkGCe vEsXCS+0yx5DaMkHJ8HSXPfqIbloEpw8nL+e/IBcm2PN7EeqJSdnoDfzAIJ9VNep+OkuE6N36B9K -----END CERTIFICATE----- SwissSign Gold CA - G2 ====================== -----BEGIN CERTIFICATE----- MIIFujCCA6KgAwIBAgIJALtAHEP1Xk+wMA0GCSqGSIb3DQEBBQUAMEUxCzAJBgNVBAYTAkNIMRUw EwYDVQQKEwxTd2lzc1NpZ24gQUcxHzAdBgNVBAMTFlN3aXNzU2lnbiBHb2xkIENBIC0gRzIwHhcN MDYxMDI1MDgzMDM1WhcNMzYxMDI1MDgzMDM1WjBFMQswCQYDVQQGEwJDSDEVMBMGA1UEChMMU3dp c3NTaWduIEFHMR8wHQYDVQQDExZTd2lzc1NpZ24gR29sZCBDQSAtIEcyMIICIjANBgkqhkiG9w0B AQEFAAOCAg8AMIICCgKCAgEAr+TufoskDhJuqVAtFkQ7kpJcyrhdhJJCEyq8ZVeCQD5XJM1QiyUq t2/876LQwB8CJEoTlo8jE+YoWACjR8cGp4QjK7u9lit/VcyLwVcfDmJlD909Vopz2q5+bbqBHH5C jCA12UNNhPqE21Is8w4ndwtrvxEvcnifLtg+5hg3Wipy+dpikJKVyh+c6bM8K8vzARO/Ws/BtQpg vd21mWRTuKCWs2/iJneRjOBiEAKfNA+k1ZIzUd6+jbqEemA8atufK+ze3gE/bk3lUIbLtK/tREDF ylqM2tIrfKjuvqblCqoOpd8FUrdVxyJdMmqXl2MT28nbeTZ7hTpKxVKJ+STnnXepgv9VHKVxaSvR AiTysybUa9oEVeXBCsdtMDeQKuSeFDNeFhdVxVu1yzSJkvGdJo+hB9TGsnhQ2wwMC3wLjEHXuend jIj3o02yMszYF9rNt85mndT9Xv+9lz4pded+p2JYryU0pUHHPbwNUMoDAw8IWh+Vc3hiv69yFGkO peUDDniOJihC8AcLYiAQZzlG+qkDzAQ4embvIIO1jEpWjpEA/I5cgt6IoMPiaG59je883WX0XaxR 7ySArqpWl2/5rX3aYT+YdzylkbYcjCbaZaIJbcHiVOO5ykxMgI93e2CaHt+28kgeDrpOVG2Y4OGi GqJ3UM/EY5LsRxmd6+ZrzsECAwEAAaOBrDCBqTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUw AwEB/zAdBgNVHQ4EFgQUWyV7lqRlUX64OfPAeGZe6Drn8O4wHwYDVR0jBBgwFoAUWyV7lqRlUX64 OfPAeGZe6Drn8O4wRgYDVR0gBD8wPTA7BglghXQBWQECAQEwLjAsBggrBgEFBQcCARYgaHR0cDov L3JlcG9zaXRvcnkuc3dpc3NzaWduLmNvbS8wDQYJKoZIhvcNAQEFBQADggIBACe645R88a7A3hfm 5djV9VSwg/S7zV4Fe0+fdWavPOhWfvxyeDgD2StiGwC5+OlgzczOUYrHUDFu4Up+GC9pWbY9ZIEr 44OE5iKHjn3g7gKZYbge9LgriBIWhMIxkziWMaa5O1M/wySTVltpkuzFwbs4AOPsF6m43Md8AYOf Mke6UiI0HTJ6CVanfCU2qT1L2sCCbwq7EsiHSycR+R4tx5M/nttfJmtS2S6K8RTGRI0Vqbe/vd6m Gu6uLftIdxf+u+yvGPUqUfA5hJeVbG4bwyvEdGB5JbAKJ9/fXtI5z0V9QkvfsywexcZdylU6oJxp mo/a77KwPJ+HbBIrZXAVUjEaJM9vMSNQH4xPjyPDdEFjHFWoFN0+4FFQz/EbMFYOkrCChdiDyyJk vC24JdVUorgG6q2SpCSgwYa1ShNqR88uC1aVVMvOmttqtKay20EIhid392qgQmwLOM7XdVAyksLf KzAiSNDVQTglXaTpXZ/GlHXQRf0wl0OPkKsKx4ZzYEppLd6leNcG2mqeSz53OiATIgHQv2ieY2Br NU0LbbqhPcCT4H8js1WtciVORvnSFu+wZMEBnunKoGqYDs/YYPIvSbjkQuE4NRb0yG5P94FW6Lqj viOvrv1vA+ACOzB2+httQc8Bsem4yWb02ybzOqR08kkkW8mw0FfB+j564ZfJ -----END CERTIFICATE----- SwissSign Silver CA - G2 ======================== -----BEGIN CERTIFICATE----- MIIFvTCCA6WgAwIBAgIITxvUL1S7L0swDQYJKoZIhvcNAQEFBQAwRzELMAkGA1UEBhMCQ0gxFTAT BgNVBAoTDFN3aXNzU2lnbiBBRzEhMB8GA1UEAxMYU3dpc3NTaWduIFNpbHZlciBDQSAtIEcyMB4X DTA2MTAyNTA4MzI0NloXDTM2MTAyNTA4MzI0NlowRzELMAkGA1UEBhMCQ0gxFTATBgNVBAoTDFN3 aXNzU2lnbiBBRzEhMB8GA1UEAxMYU3dpc3NTaWduIFNpbHZlciBDQSAtIEcyMIICIjANBgkqhkiG 9w0BAQEFAAOCAg8AMIICCgKCAgEAxPGHf9N4Mfc4yfjDmUO8x/e8N+dOcbpLj6VzHVxumK4DV644 N0MvFz0fyM5oEMF4rhkDKxD6LHmD9ui5aLlV8gREpzn5/ASLHvGiTSf5YXu6t+WiE7brYT7QbNHm +/pe7R20nqA1W6GSy/BJkv6FCgU+5tkL4k+73JU3/JHpMjUi0R86TieFnbAVlDLaYQ1HTWBCrpJH 6INaUFjpiou5XaHc3ZlKHzZnu0jkg7Y360g6rw9njxcH6ATK72oxh9TAtvmUcXtnZLi2kUpCe2Uu MGoM9ZDulebyzYLs2aFK7PayS+VFheZteJMELpyCbTapxDFkH4aDCyr0NQp4yVXPQbBH6TCfmb5h qAaEuSh6XzjZG6k4sIN/c8HDO0gqgg8hm7jMqDXDhBuDsz6+pJVpATqJAHgE2cn0mRmrVn5bi4Y5 FZGkECwJMoBgs5PAKrYYC51+jUnyEEp/+dVGLxmSo5mnJqy7jDzmDrxHB9xzUfFwZC8I+bRHHTBs ROopN4WSaGa8gzj+ezku01DwH/teYLappvonQfGbGHLy9YR0SslnxFSuSGTfjNFusB3hB48IHpmc celM2KX3RxIfdNFRnobzwqIjQAtz20um53MGjMGg6cFZrEb65i/4z3GcRm25xBWNOHkDRUjvxF3X CO6HOSKGsg0PWEP3calILv3q1h8CAwEAAaOBrDCBqTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/ BAUwAwEB/zAdBgNVHQ4EFgQUF6DNweRBtjpbO8tFnb0cwpj6hlgwHwYDVR0jBBgwFoAUF6DNweRB tjpbO8tFnb0cwpj6hlgwRgYDVR0gBD8wPTA7BglghXQBWQEDAQEwLjAsBggrBgEFBQcCARYgaHR0 cDovL3JlcG9zaXRvcnkuc3dpc3NzaWduLmNvbS8wDQYJKoZIhvcNAQEFBQADggIBAHPGgeAn0i0P 4JUw4ppBf1AsX19iYamGamkYDHRJ1l2E6kFSGG9YrVBWIGrGvShpWJHckRE1qTodvBqlYJ7YH39F kWnZfrt4csEGDyrOj4VwYaygzQu4OSlWhDJOhrs9xCrZ1x9y7v5RoSJBsXECYxqCsGKrXlcSH9/L 3XWgwF15kIwb4FDm3jH+mHtwX6WQ2K34ArZv02DdQEsixT2tOnqfGhpHkXkzuoLcMmkDlm4fS/Bx /uNncqCxv1yL5PqZIseEuRuNI5c/7SXgz2W79WEE790eslpBIlqhn10s6FvJbakMDHiqYMZWjwFa DGi8aRl5xB9+lwW/xekkUV7U1UtT7dkjWjYDZaPBA61BMPNGG4WQr2W11bHkFlt4dR2Xem1ZqSqP e97Dh4kQmUlzeMg9vVE1dCrV8X5pGyq7O70luJpaPXJhkGaH7gzWTdQRdAtq/gsD/KNVV4n+Ssuu WxcFyPKNIzFTONItaj+CuY0IavdeQXRuwxF+B6wpYJE/OMpXEA29MC/HpeZBoNquBYeaoKRlbEwJ DIm6uNO5wJOKMPqN5ZprFQFOZ6raYlY+hAhm0sQ2fac+EPyI4NSA5QC9qvNOBqN6avlicuMJT+ub DgEj8Z+7fNzcbBGXJbLytGMU0gYqZ4yD9c7qB9iaah7s5Aq7KkzrCWA5zspi2C5u -----END CERTIFICATE----- SecureTrust CA ============== -----BEGIN CERTIFICATE----- MIIDuDCCAqCgAwIBAgIQDPCOXAgWpa1Cf/DrJxhZ0DANBgkqhkiG9w0BAQUFADBIMQswCQYDVQQG EwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24xFzAVBgNVBAMTDlNlY3VyZVRy dXN0IENBMB4XDTA2MTEwNzE5MzExOFoXDTI5MTIzMTE5NDA1NVowSDELMAkGA1UEBhMCVVMxIDAe BgNVBAoTF1NlY3VyZVRydXN0IENvcnBvcmF0aW9uMRcwFQYDVQQDEw5TZWN1cmVUcnVzdCBDQTCC ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKukgeWVzfX2FI7CT8rU4niVWJxB4Q2ZQCQX OZEzZum+4YOvYlyJ0fwkW2Gz4BERQRwdbvC4u/jep4G6pkjGnx29vo6pQT64lO0pGtSO0gMdA+9t DWccV9cGrcrI9f4Or2YlSASWC12juhbDCE/RRvgUXPLIXgGZbf2IzIaowW8xQmxSPmjL8xk037uH GFaAJsTQ3MBv396gwpEWoGQRS0S8Hvbn+mPeZqx2pHGj7DaUaHp3pLHnDi+BeuK1cobvomuL8A/b 01k/unK8RCSc43Oz969XL0Imnal0ugBS8kvNU3xHCzaFDmapCJcWNFfBZveA4+1wVMeT4C4oFVmH ursCAwEAAaOBnTCBmjATBgkrBgEEAYI3FAIEBh4EAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/ BAUwAwEB/zAdBgNVHQ4EFgQUQjK2FvoE/f5dS3rD/fdMQB1aQ68wNAYDVR0fBC0wKzApoCegJYYj aHR0cDovL2NybC5zZWN1cmV0cnVzdC5jb20vU1RDQS5jcmwwEAYJKwYBBAGCNxUBBAMCAQAwDQYJ KoZIhvcNAQEFBQADggEBADDtT0rhWDpSclu1pqNlGKa7UTt36Z3q059c4EVlew3KW+JwULKUBRSu SceNQQcSc5R+DCMh/bwQf2AQWnL1mA6s7Ll/3XpvXdMc9P+IBWlCqQVxyLesJugutIxq/3HcuLHf mbx8IVQr5Fiiu1cprp6poxkmD5kuCLDv/WnPmRoJjeOnnyvJNjR7JLN4TJUXpAYmHrZkUjZfYGfZ nMUFdAvnZyPSCPyI6a6Lf+Ew9Dd+/cYy2i2eRDAwbO4H3tI0/NL/QPZL9GZGBlSm8jIKYyYwa5vR 3ItHuuG51WLQoqD0ZwV4KWMabwTW+MZMo5qxN7SN5ShLHZ4swrhovO0C7jE= -----END CERTIFICATE----- Secure Global CA ================ -----BEGIN CERTIFICATE----- MIIDvDCCAqSgAwIBAgIQB1YipOjUiolN9BPI8PjqpTANBgkqhkiG9w0BAQUFADBKMQswCQYDVQQG EwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24xGTAXBgNVBAMTEFNlY3VyZSBH bG9iYWwgQ0EwHhcNMDYxMTA3MTk0MjI4WhcNMjkxMjMxMTk1MjA2WjBKMQswCQYDVQQGEwJVUzEg MB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24xGTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwg Q0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCvNS7YrGxVaQZx5RNoJLNP2MwhR/jx YDiJiQPpvepeRlMJ3Fz1Wuj3RSoC6zFh1ykzTM7HfAo3fg+6MpjhHZevj8fcyTiW89sa/FHtaMbQ bqR8JNGuQsiWUGMu4P51/pinX0kuleM5M2SOHqRfkNJnPLLZ/kG5VacJjnIFHovdRIWCQtBJwB1g 8NEXLJXr9qXBkqPFwqcIYA1gBBCWeZ4WNOaptvolRTnIHmX5k/Wq8VLcmZg9pYYaDDUz+kulBAYV HDGA76oYa8J719rO+TMg1fW9ajMtgQT7sFzUnKPiXB3jqUJ1XnvUd+85VLrJChgbEplJL4hL/VBi 0XPnj3pDAgMBAAGjgZ0wgZowEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0PBAQDAgGGMA8GA1Ud EwEB/wQFMAMBAf8wHQYDVR0OBBYEFK9EBMJBfkiD2045AuzshHrmzsmkMDQGA1UdHwQtMCswKaAn oCWGI2h0dHA6Ly9jcmwuc2VjdXJldHJ1c3QuY29tL1NHQ0EuY3JsMBAGCSsGAQQBgjcVAQQDAgEA MA0GCSqGSIb3DQEBBQUAA4IBAQBjGghAfaReUw132HquHw0LURYD7xh8yOOvaliTFGCRsoTciE6+ OYo68+aCiV0BN7OrJKQVDpI1WkpEXk5X+nXOH0jOZvQ8QCaSmGwb7iRGDBezUqXbpZGRzzfTb+cn CDpOGR86p1hcF895P4vkp9MmI50mD1hp/Ed+stCNi5O/KU9DaXR2Z0vPB4zmAve14bRDtUstFJ/5 3CYNv6ZHdAbYiNE6KTCEztI5gGIbqMdXSbxqVVFnFUq+NQfk1XWYN3kwFNspnWzFacxHVaIw98xc f8LDmBxrThaA63p4ZUWiABqvDA1VZDRIuJK58bRQKfJPIx/abKwfROHdI3hRW8cW -----END CERTIFICATE----- COMODO Certification Authority ============================== -----BEGIN CERTIFICATE----- MIIEHTCCAwWgAwIBAgIQToEtioJl4AsC7j41AkblPTANBgkqhkiG9w0BAQUFADCBgTELMAkGA1UE BhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgG A1UEChMRQ09NT0RPIENBIExpbWl0ZWQxJzAlBgNVBAMTHkNPTU9ETyBDZXJ0aWZpY2F0aW9uIEF1 dGhvcml0eTAeFw0wNjEyMDEwMDAwMDBaFw0yOTEyMzEyMzU5NTlaMIGBMQswCQYDVQQGEwJHQjEb MBkGA1UECBMSR3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRowGAYDVQQKExFD T01PRE8gQ0EgTGltaXRlZDEnMCUGA1UEAxMeQ09NT0RPIENlcnRpZmljYXRpb24gQXV0aG9yaXR5 MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0ECLi3LjkRv3UcEbVASY06m/weaKXTuH +7uIzg3jLz8GlvCiKVCZrts7oVewdFFxze1CkU1B/qnI2GqGd0S7WWaXUF601CxwRM/aN5VCaTww xHGzUvAhTaHYujl8HJ6jJJ3ygxaYqhZ8Q5sVW7euNJH+1GImGEaaP+vB+fGQV+useg2L23IwambV 4EajcNxo2f8ESIl33rXp+2dtQem8Ob0y2WIC8bGoPW43nOIv4tOiJovGuFVDiOEjPqXSJDlqR6sA 1KGzqSX+DT+nHbrTUcELpNqsOO9VUCQFZUaTNE8tja3G1CEZ0o7KBWFxB3NH5YoZEr0ETc5OnKVI rLsm9wIDAQABo4GOMIGLMB0GA1UdDgQWBBQLWOWLxkwVN6RAqTCpIb5HNlpW/zAOBgNVHQ8BAf8E BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zBJBgNVHR8EQjBAMD6gPKA6hjhodHRwOi8vY3JsLmNvbW9k b2NhLmNvbS9DT01PRE9DZXJ0aWZpY2F0aW9uQXV0aG9yaXR5LmNybDANBgkqhkiG9w0BAQUFAAOC AQEAPpiem/Yb6dc5t3iuHXIYSdOH5EOC6z/JqvWote9VfCFSZfnVDeFs9D6Mk3ORLgLETgdxb8CP OGEIqB6BCsAvIC9Bi5HcSEW88cbeunZrM8gALTFGTO3nnc+IlP8zwFboJIYmuNg4ON8qa90SzMc/ RxdMosIGlgnW2/4/PEZB31jiVg88O8EckzXZOFKs7sjsLjBOlDW0JB9LeGna8gI4zJVSk/BwJVmc IGfE7vmLV2H0knZ9P4SNVbfo5azV8fUZVqZa+5Acr5Pr5RzUZ5ddBA6+C4OmF4O5MBKgxTMVBbkN +8cFduPYSo38NBejxiEovjBFMR7HeL5YYTisO+IBZQ== -----END CERTIFICATE----- COMODO ECC Certification Authority ================================== -----BEGIN CERTIFICATE----- MIICiTCCAg+gAwIBAgIQH0evqmIAcFBUTAGem2OZKjAKBggqhkjOPQQDAzCBhTELMAkGA1UEBhMC R0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UE ChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlvbiBB dXRob3JpdHkwHhcNMDgwMzA2MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0Ix GzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMR Q09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRo b3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQDR3svdcmCFYX7deSRFtSrYpn1PlILBs5BAH+X 4QokPB0BBO490o0JlwzgdeT6+3eKKvUDYEs2ixYjFq0JcfRK9ChQtP6IHG4/bC8vCVlbpVsLM5ni wz2J+Wos77LTBumjQjBAMB0GA1UdDgQWBBR1cacZSBm8nZ3qQUfflMRId5nTeTAOBgNVHQ8BAf8E BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjEA7wNbeqy3eApyt4jf/7VG FAkK+qDmfQjGGoe9GKhzvSbKYAydzpmfz1wPMOG+FDHqAjAU9JM8SaczepBGR7NjfRObTrdvGDeA U/7dIOA1mjbRxwG55tzd8/8dLDoWV9mSOdY= -----END CERTIFICATE----- Certigna ======== -----BEGIN CERTIFICATE----- MIIDqDCCApCgAwIBAgIJAP7c4wEPyUj/MA0GCSqGSIb3DQEBBQUAMDQxCzAJBgNVBAYTAkZSMRIw EAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hMB4XDTA3MDYyOTE1MTMwNVoXDTI3 MDYyOTE1MTMwNVowNDELMAkGA1UEBhMCRlIxEjAQBgNVBAoMCURoaW15b3RpczERMA8GA1UEAwwI Q2VydGlnbmEwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDIaPHJ1tazNHUmgh7stL7q XOEm7RFHYeGifBZ4QCHkYJ5ayGPhxLGWkv8YbWkj4Sti993iNi+RB7lIzw7sebYs5zRLcAglozyH GxnygQcPOJAZ0xH+hrTy0V4eHpbNgGzOOzGTtvKg0KmVEn2lmsxryIRWijOp5yIVUxbwzBfsV1/p ogqYCd7jX5xv3EjjhQsVWqa6n6xI4wmy9/Qy3l40vhx4XUJbzg4ij02Q130yGLMLLGq/jj8UEYkg DncUtT2UCIf3JR7VsmAA7G8qKCVuKj4YYxclPz5EIBb2JsglrgVKtOdjLPOMFlN+XPsRGgjBRmKf Irjxwo1p3Po6WAbfAgMBAAGjgbwwgbkwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUGu3+QTmQ tCRZvgHyUtVF9lo53BEwZAYDVR0jBF0wW4AUGu3+QTmQtCRZvgHyUtVF9lo53BGhOKQ2MDQxCzAJ BgNVBAYTAkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hggkA/tzjAQ/J SP8wDgYDVR0PAQH/BAQDAgEGMBEGCWCGSAGG+EIBAQQEAwIABzANBgkqhkiG9w0BAQUFAAOCAQEA hQMeknH2Qq/ho2Ge6/PAD/Kl1NqV5ta+aDY9fm4fTIrv0Q8hbV6lUmPOEvjvKtpv6zf+EwLHyzs+ ImvaYS5/1HI93TDhHkxAGYwP15zRgzB7mFncfca5DClMoTOi62c6ZYTTluLtdkVwj7Ur3vkj1klu PBS1xp81HlDQwY9qcEQCYsuuHWhBp6pX6FOqB9IG9tUUBguRA3UsbHK1YZWaDYu5Def131TN3ubY 1gkIl2PlwS6wt0QmwCbAr1UwnjvVNioZBPRcHv/PLLf/0P2HQBHVESO7SMAhqaQoLf0V+LBOK/Qw WyH8EZE0vkHve52Xdf+XlcCWWC/qu0bXu+TZLg== -----END CERTIFICATE----- ePKI Root Certification Authority ================================= -----BEGIN CERTIFICATE----- MIIFsDCCA5igAwIBAgIQFci9ZUdcr7iXAF7kBtK8nTANBgkqhkiG9w0BAQUFADBeMQswCQYDVQQG EwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0ZC4xKjAoBgNVBAsMIWVQS0kg Um9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wNDEyMjAwMjMxMjdaFw0zNDEyMjAwMjMx MjdaMF4xCzAJBgNVBAYTAlRXMSMwIQYDVQQKDBpDaHVuZ2h3YSBUZWxlY29tIENvLiwgTHRkLjEq MCgGA1UECwwhZVBLSSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIICIjANBgkqhkiG9w0B AQEFAAOCAg8AMIICCgKCAgEA4SUP7o3biDN1Z82tH306Tm2d0y8U82N0ywEhajfqhFAHSyZbCUNs IZ5qyNUD9WBpj8zwIuQf5/dqIjG3LBXy4P4AakP/h2XGtRrBp0xtInAhijHyl3SJCRImHJ7K2RKi lTza6We/CKBk49ZCt0Xvl/T29de1ShUCWH2YWEtgvM3XDZoTM1PRYfl61dd4s5oz9wCGzh1NlDiv qOx4UXCKXBCDUSH3ET00hl7lSM2XgYI1TBnsZfZrxQWh7kcT1rMhJ5QQCtkkO7q+RBNGMD+XPNjX 12ruOzjjK9SXDrkb5wdJfzcq+Xd4z1TtW0ado4AOkUPB1ltfFLqfpo0kR0BZv3I4sjZsN/+Z0V0O WQqraffAsgRFelQArr5T9rXn4fg8ozHSqf4hUmTFpmfwdQcGlBSBVcYn5AGPF8Fqcde+S/uUWH1+ ETOxQvdibBjWzwloPn9s9h6PYq2lY9sJpx8iQkEeb5mKPtf5P0B6ebClAZLSnT0IFaUQAS2zMnao lQ2zepr7BxB4EW/hj8e6DyUadCrlHJhBmd8hh+iVBmoKs2pHdmX2Os+PYhcZewoozRrSgx4hxyy/ vv9haLdnG7t4TY3OZ+XkwY63I2binZB1NJipNiuKmpS5nezMirH4JYlcWrYvjB9teSSnUmjDhDXi Zo1jDiVN1Rmy5nk3pyKdVDECAwEAAaNqMGgwHQYDVR0OBBYEFB4M97Zn8uGSJglFwFU5Lnc/Qkqi MAwGA1UdEwQFMAMBAf8wOQYEZyoHAAQxMC8wLQIBADAJBgUrDgMCGgUAMAcGBWcqAwAABBRFsMLH ClZ87lt4DJX5GFPBphzYEDANBgkqhkiG9w0BAQUFAAOCAgEACbODU1kBPpVJufGBuvl2ICO1J2B0 1GqZNF5sAFPZn/KmsSQHRGoqxqWOeBLoR9lYGxMqXnmbnwoqZ6YlPwZpVnPDimZI+ymBV3QGypzq KOg4ZyYr8dW1P2WT+DZdjo2NQCCHGervJ8A9tDkPJXtoUHRVnAxZfVo9QZQlUgjgRywVMRnVvwdV xrsStZf0X4OFunHB2WyBEXYKCrC/gpf36j36+uwtqSiUO1bd0lEursC9CBWMd1I0ltabrNMdjmEP NXubrjlpC2JgQCA2j6/7Nu4tCEoduL+bXPjqpRugc6bY+G7gMwRfaKonh+3ZwZCc7b3jajWvY9+r GNm65ulK6lCKD2GTHuItGeIwlDWSXQ62B68ZgI9HkFFLLk3dheLSClIKF5r8GrBQAuUBo2M3IUxE xJtRmREOc5wGj1QupyheRDmHVi03vYVElOEMSyycw5KFNGHLD7ibSkNS/jQ6fbjpKdx2qcgw+BRx gMYeNkh0IkFch4LoGHGLQYlE535YW6i4jRPpp2zDR+2zGp1iro2C6pSe3VkQw63d4k3jMdXH7Ojy sP6SHhYKGvzZ8/gntsm+HbRsZJB/9OTEW9c3rkIO3aQab3yIVMUWbuF6aC74Or8NpDyJO3inTmOD BCEIZ43ygknQW/2xzQ+DhNQ+IIX3Sj0rnP0qCglN6oH4EZw= -----END CERTIFICATE----- certSIGN ROOT CA ================ -----BEGIN CERTIFICATE----- MIIDODCCAiCgAwIBAgIGIAYFFnACMA0GCSqGSIb3DQEBBQUAMDsxCzAJBgNVBAYTAlJPMREwDwYD VQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBDQTAeFw0wNjA3MDQxNzIwMDRa Fw0zMTA3MDQxNzIwMDRaMDsxCzAJBgNVBAYTAlJPMREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UE CxMQY2VydFNJR04gUk9PVCBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALczuX7I JUqOtdu0KBuqV5Do0SLTZLrTk+jUrIZhQGpgV2hUhE28alQCBf/fm5oqrl0Hj0rDKH/v+yv6efHH rfAQUySQi2bJqIirr1qjAOm+ukbuW3N7LBeCgV5iLKECZbO9xSsAfsT8AzNXDe3i+s5dRdY4zTW2 ssHQnIFKquSyAVwdj1+ZxLGt24gh65AIgoDzMKND5pCCrlUoSe1b16kQOA7+j0xbm0bqQfWwCHTD 0IgztnzXdN/chNFDDnU5oSVAKOp4yw4sLjmdjItuFhwvJoIQ4uNllAoEwF73XVv4EOLQunpL+943 AAAaWyjj0pxzPjKHmKHJUS/X3qwzs08CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8B Af8EBAMCAcYwHQYDVR0OBBYEFOCMm9slSbPxfIbWskKHC9BroNnkMA0GCSqGSIb3DQEBBQUAA4IB AQA+0hyJLjX8+HXd5n9liPRyTMks1zJO890ZeUe9jjtbkw9QSSQTaxQGcu8J06Gh40CEyecYMnQ8 SG4Pn0vU9x7Tk4ZkVJdjclDVVc/6IJMCopvDI5NOFlV2oHB5bc0hH88vLbwZ44gx+FkagQnIl6Z0 x2DEW8xXjrJ1/RsCCdtZb3KTafcxQdaIOL+Hsr0Wefmq5L6IJd1hJyMctTEHBDa0GpC9oHRxUIlt vBTjD4au8as+x6AJzKNI0eDbZOeStc+vckNwi/nDhDwTqn6Sm1dTk/pwwpEOMfmbZ13pljheX7Nz TogVZ96edhBiIL5VaZVDADlN9u6wWk5JRFRYX0KD -----END CERTIFICATE----- NetLock Arany (Class Gold) FÅ‘tanÃºsÃtvÃ¡ny ======================================== -----BEGIN CERTIFICATE----- MIIEFTCCAv2gAwIBAgIGSUEs5AAQMA0GCSqGSIb3DQEBCwUAMIGnMQswCQYDVQQGEwJIVTERMA8G A1UEBwwIQnVkYXBlc3QxFTATBgNVBAoMDE5ldExvY2sgS2Z0LjE3MDUGA1UECwwuVGFuw7pzw610 dsOhbnlraWFkw7NrIChDZXJ0aWZpY2F0aW9uIFNlcnZpY2VzKTE1MDMGA1UEAwwsTmV0TG9jayBB cmFueSAoQ2xhc3MgR29sZCkgRsWRdGFuw7pzw610dsOhbnkwHhcNMDgxMjExMTUwODIxWhcNMjgx MjA2MTUwODIxWjCBpzELMAkGA1UEBhMCSFUxETAPBgNVBAcMCEJ1ZGFwZXN0MRUwEwYDVQQKDAxO ZXRMb2NrIEtmdC4xNzA1BgNVBAsMLlRhbsO6c8OtdHbDoW55a2lhZMOzayAoQ2VydGlmaWNhdGlv biBTZXJ2aWNlcykxNTAzBgNVBAMMLE5ldExvY2sgQXJhbnkgKENsYXNzIEdvbGQpIEbFkXRhbsO6 c8OtdHbDoW55MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxCRec75LbRTDofTjl5Bu 0jBFHjzuZ9lk4BqKf8owyoPjIMHj9DrTlF8afFttvzBPhCf2nx9JvMaZCpDyD/V/Q4Q3Y1GLeqVw /HpYzY6b7cNGbIRwXdrzAZAj/E4wqX7hJ2Pn7WQ8oLjJM2P+FpD/sLj916jAwJRDC7bVWaaeVtAk H3B5r9s5VA1lddkVQZQBr17s9o3x/61k/iCa11zr/qYfCGSji3ZVrR47KGAuhyXoqq8fxmRGILdw fzzeSNuWU7c5d+Qa4scWhHaXWy+7GRWF+GmF9ZmnqfI0p6m2pgP8b4Y9VHx2BJtr+UBdADTHLpl1 neWIA6pN+APSQnbAGwIDAKiLo0UwQzASBgNVHRMBAf8ECDAGAQH/AgEEMA4GA1UdDwEB/wQEAwIB BjAdBgNVHQ4EFgQUzPpnk/C2uNClwB7zU/2MU9+D15YwDQYJKoZIhvcNAQELBQADggEBAKt/7hwW qZw8UQCgwBEIBaeZ5m8BiFRhbvG5GK1Krf6BQCOUL/t1fC8oS2IkgYIL9WHxHG64YTjrgfpioTta YtOUZcTh5m2C+C8lcLIhJsFyUR+MLMOEkMNaj7rP9KdlpeuY0fsFskZ1FSNqb4VjMIDw1Z4fKRzC bLBQWV2QWzuoDTDPv31/zvGdg73JRm4gpvlhUbohL3u+pRVjodSVh/GeufOJ8z2FuLjbvrW5Kfna NwUASZQDhETnv0Mxz3WLJdH0pmT1kvarBes96aULNmLazAZfNou2XjG4Kvte9nHfRCaexOYNkbQu dZWAUWpLMKawYqGT8ZvYzsRjdT9ZR7E= -----END CERTIFICATE----- SecureSign RootCA11 =================== -----BEGIN CERTIFICATE----- MIIDbTCCAlWgAwIBAgIBATANBgkqhkiG9w0BAQUFADBYMQswCQYDVQQGEwJKUDErMCkGA1UEChMi SmFwYW4gQ2VydGlmaWNhdGlvbiBTZXJ2aWNlcywgSW5jLjEcMBoGA1UEAxMTU2VjdXJlU2lnbiBS b290Q0ExMTAeFw0wOTA0MDgwNDU2NDdaFw0yOTA0MDgwNDU2NDdaMFgxCzAJBgNVBAYTAkpQMSsw KQYDVQQKEyJKYXBhbiBDZXJ0aWZpY2F0aW9uIFNlcnZpY2VzLCBJbmMuMRwwGgYDVQQDExNTZWN1 cmVTaWduIFJvb3RDQTExMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA/XeqpRyQBTvL TJszi1oURaTnkBbR31fSIRCkF/3frNYfp+TbfPfs37gD2pRY/V1yfIw/XwFndBWW4wI8h9uuywGO wvNmxoVF9ALGOrVisq/6nL+k5tSAMJjzDbaTj6nU2DbysPyKyiyhFTOVMdrAG/LuYpmGYz+/3ZMq g6h2uRMft85OQoWPIucuGvKVCbIFtUROd6EgvanyTgp9UK31BQ1FT0Zx/Sg+U/sE2C3XZR1KG/rP O7AxmjVuyIsG0wCR8pQIZUyxNAYAeoni8McDWc/V1uinMrPmmECGxc0nEovMe863ETxiYAcjPitA bpSACW22s293bzUIUPsCh8U+iQIDAQABo0IwQDAdBgNVHQ4EFgQUW/hNT7KlhtQ60vFjmqC+CfZX t94wDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEBAKCh OBZmLqdWHyGcBvod7bkixTgm2E5P7KN/ed5GIaGHd48HCJqypMWvDzKYC3xmKbabfSVSSUOrTC4r bnpwrxYO4wJs+0LmGJ1F2FXI6Dvd5+H0LgscNFxsWEr7jIhQX5Ucv+2rIrVls4W6ng+4reV6G4pQ Oh29Dbx7VFALuUKvVaAYga1lme++5Jy/xIWrQbJUb9wlze144o4MjQlJ3WN7WmmWAiGovVJZ6X01 y8hSyn+B/tlr0/cR7SXf+Of5pPpyl4RTDaXQMhhRdlkUbA/r7F+AjHVDg8OFmP9Mni0N5HeDk061 lgeLKBObjBmNQSdJQO7e5iNEOdyhIta6A/I= -----END CERTIFICATE----- Microsec e-Szigno Root CA 2009 ============================== -----BEGIN CERTIFICATE----- MIIECjCCAvKgAwIBAgIJAMJ+QwRORz8ZMA0GCSqGSIb3DQEBCwUAMIGCMQswCQYDVQQGEwJIVTER MA8GA1UEBwwIQnVkYXBlc3QxFjAUBgNVBAoMDU1pY3Jvc2VjIEx0ZC4xJzAlBgNVBAMMHk1pY3Jv c2VjIGUtU3ppZ25vIFJvb3QgQ0EgMjAwOTEfMB0GCSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5o dTAeFw0wOTA2MTYxMTMwMThaFw0yOTEyMzAxMTMwMThaMIGCMQswCQYDVQQGEwJIVTERMA8GA1UE BwwIQnVkYXBlc3QxFjAUBgNVBAoMDU1pY3Jvc2VjIEx0ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUt U3ppZ25vIFJvb3QgQ0EgMjAwOTEfMB0GCSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5odTCCASIw DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAOn4j/NjrdqG2KfgQvvPkd6mJviZpWNwrZuuyjNA fW2WbqEORO7hE52UQlKavXWFdCyoDh2Tthi3jCyoz/tccbna7P7ofo/kLx2yqHWH2Leh5TvPmUpG 0IMZfcChEhyVbUr02MelTTMuhTlAdX4UfIASmFDHQWe4oIBhVKZsTh/gnQ4H6cm6M+f+wFUoLAKA pxn1ntxVUwOXewdI/5n7N4okxFnMUBBjjqqpGrCEGob5X7uxUG6k0QrM1XF+H6cbfPVTbiJfyyvm 1HxdrtbCxkzlBQHZ7Vf8wSN5/PrIJIOV87VqUQHQd9bpEqH5GoP7ghu5sJf0dgYzQ0mg/wu1+rUC AwEAAaOBgDB+MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBTLD8bf QkPMPcu1SCOhGnqmKrs0aDAfBgNVHSMEGDAWgBTLD8bfQkPMPcu1SCOhGnqmKrs0aDAbBgNVHREE FDASgRBpbmZvQGUtc3ppZ25vLmh1MA0GCSqGSIb3DQEBCwUAA4IBAQDJ0Q5eLtXMs3w+y/w9/w0o lZMEyL/azXm4Q5DwpL7v8u8hmLzU1F0G9u5C7DBsoKqpyvGvivo/C3NqPuouQH4frlRheesuCDfX I/OMn74dseGkddug4lQUsbocKaQY9hK6ohQU4zE1yED/t+AFdlfBHFny+L/k7SViXITwfn4fs775 tyERzAMBVnCnEJIeGzSBHq2cGsMEPO0CYdYeBvNfOofyK/FFh+U9rNHHV4S9a67c2Pm2G2JwCz02 yULyMtd6YebS2z3PyKnJm9zbWETXbzivf3jTo60adbocwTZ8jx5tHMN1Rq41Bab2XD0h7lbwyYIi LXpUq3DDfSJlgnCW -----END CERTIFICATE----- GlobalSign Root CA - R3 ======================= -----BEGIN CERTIFICATE----- MIIDXzCCAkegAwIBAgILBAAAAAABIVhTCKIwDQYJKoZIhvcNAQELBQAwTDEgMB4GA1UECxMXR2xv YmFsU2lnbiBSb290IENBIC0gUjMxEzARBgNVBAoTCkdsb2JhbFNpZ24xEzARBgNVBAMTCkdsb2Jh bFNpZ24wHhcNMDkwMzE4MTAwMDAwWhcNMjkwMzE4MTAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxT aWduIFJvb3QgQ0EgLSBSMzETMBEGA1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2ln bjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMwldpB5BngiFvXAg7aEyiie/QV2EcWt iHL8RgJDx7KKnQRfJMsuS+FggkbhUqsMgUdwbN1k0ev1LKMPgj0MK66X17YUhhB5uzsTgHeMCOFJ 0mpiLx9e+pZo34knlTifBtc+ycsmWQ1z3rDI6SYOgxXG71uL0gRgykmmKPZpO/bLyCiR5Z2KYVc3 rHQU3HTgOu5yLy6c+9C7v/U9AOEGM+iCK65TpjoWc4zdQQ4gOsC0p6Hpsk+QLjJg6VfLuQSSaGjl OCZgdbKfd/+RFO+uIEn8rUAVSNECMWEZXriX7613t2Saer9fwRPvm2L7DWzgVGkWqQPabumDk3F2 xmmFghcCAwEAAaNCMEAwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYE FI/wS3+oLkUkrk1Q+mOai97i3Ru8MA0GCSqGSIb3DQEBCwUAA4IBAQBLQNvAUKr+yAzv95ZURUm7 lgAJQayzE4aGKAczymvmdLm6AC2upArT9fHxD4q/c2dKg8dEe3jgr25sbwMpjjM5RcOO5LlXbKr8 EpbsU8Yt5CRsuZRj+9xTaGdWPoO4zzUhw8lo/s7awlOqzJCK6fBdRoyV3XpYKBovHd7NADdBj+1E bddTKJd+82cEHhXXipa0095MJ6RMG3NzdvQXmcIfeg7jLQitChws/zyrVQ4PkX4268NXSb7hLi18 YIvDQVETI53O9zJrlAGomecsMx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7r kpeDMdmztcpHWD9f -----END CERTIFICATE----- Izenpe.com ========== -----BEGIN CERTIFICATE----- MIIF8TCCA9mgAwIBAgIQALC3WhZIX7/hy/WL1xnmfTANBgkqhkiG9w0BAQsFADA4MQswCQYDVQQG EwJFUzEUMBIGA1UECgwLSVpFTlBFIFMuQS4xEzARBgNVBAMMCkl6ZW5wZS5jb20wHhcNMDcxMjEz MTMwODI4WhcNMzcxMjEzMDgyNzI1WjA4MQswCQYDVQQGEwJFUzEUMBIGA1UECgwLSVpFTlBFIFMu QS4xEzARBgNVBAMMCkl6ZW5wZS5jb20wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDJ 03rKDx6sp4boFmVqscIbRTJxldn+EFvMr+eleQGPicPK8lVx93e+d5TzcqQsRNiekpsUOqHnJJAK ClaOxdgmlOHZSOEtPtoKct2jmRXagaKH9HtuJneJWK3W6wyyQXpzbm3benhB6QiIEn6HLmYRY2xU +zydcsC8Lv/Ct90NduM61/e0aL6i9eOBbsFGb12N4E3GVFWJGjMxCrFXuaOKmMPsOzTFlUFpfnXC PCDFYbpRR6AgkJOhkEvzTnyFRVSa0QUmQbC1TR0zvsQDyCV8wXDbO/QJLVQnSKwv4cSsPsjLkkxT OTcj7NMB+eAJRE1NZMDhDVqHIrytG6P+JrUV86f8hBnp7KGItERphIPzidF0BqnMC9bC3ieFUCbK F7jJeodWLBoBHmy+E60QrLUk9TiRodZL2vG70t5HtfG8gfZZa88ZU+mNFctKy6lvROUbQc/hhqfK 0GqfvEyNBjNaooXlkDWgYlwWTvDjovoDGrQscbNYLN57C9saD+veIR8GdwYDsMnvmfzAuU8Lhij+ 0rnq49qlw0dpEuDb8PYZi+17cNcC1u2HGCgsBCRMd+RIihrGO5rUD8r6ddIBQFqNeb+Lz0vPqhbB leStTIo+F5HUsWLlguWABKQDfo2/2n+iD5dPDNMN+9fR5XJ+HMh3/1uaD7euBUbl8agW7EekFwID AQABo4H2MIHzMIGwBgNVHREEgagwgaWBD2luZm9AaXplbnBlLmNvbaSBkTCBjjFHMEUGA1UECgw+ SVpFTlBFIFMuQS4gLSBDSUYgQTAxMzM3MjYwLVJNZXJjLlZpdG9yaWEtR2FzdGVpeiBUMTA1NSBG NjIgUzgxQzBBBgNVBAkMOkF2ZGEgZGVsIE1lZGl0ZXJyYW5lbyBFdG9yYmlkZWEgMTQgLSAwMTAx MCBWaXRvcmlhLUdhc3RlaXowDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0O BBYEFB0cZQ6o8iV7tJHP5LGx5r1VdGwFMA0GCSqGSIb3DQEBCwUAA4ICAQB4pgwWSp9MiDrAyw6l Fn2fuUhfGI8NYjb2zRlrrKvV9pF9rnHzP7MOeIWblaQnIUdCSnxIOvVFfLMMjlF4rJUT3sb9fbga kEyrkgPH7UIBzg/YsfqikuFgba56awmqxinuaElnMIAkejEWOVt+8Rwu3WwJrfIxwYJOubv5vr8q hT/AQKM6WfxZSzwoJNu0FXWuDYi6LnPAvViH5ULy617uHjAimcs30cQhbIHsvm0m5hzkQiCeR7Cs g1lwLDXWrzY0tM07+DKo7+N4ifuNRSzanLh+QBxh5z6ikixL8s36mLYp//Pye6kfLqCTVyvehQP5 aTfLnnhqBbTFMXiJ7HqnheG5ezzevh55hM6fcA5ZwjUukCox2eRFekGkLhObNA5me0mrZJfQRsN5 nXJQY6aYWwa9SG3YOYNw6DXwBdGqvOPbyALqfP2C2sJbUjWumDqtujWTI6cfSN01RpiyEGjkpTHC ClguGYEQyVB1/OpaFs4R1+7vUIgtYf8/QnMFlEPVjjxOAToZpR9GTnfQXeWBIiGH/pR9hNiTrdZo Q0iy2+tzJOeRf1SktoA+naM8THLCV8Sg1Mw4J87VBp6iSNnpn86CcDaTmjvfliHjWbcM2pE38P1Z WrOZyGlsQyYBNWNgVYkDOnXYukrZVP/u3oDYLdE41V4tC5h9Pmzb/CaIxw== -----END CERTIFICATE----- Go Daddy Root Certificate Authority - G2 ======================================== -----BEGIN CERTIFICATE----- MIIDxTCCAq2gAwIBAgIBADANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMCVVMxEDAOBgNVBAgT B0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxGjAYBgNVBAoTEUdvRGFkZHkuY29tLCBJbmMu MTEwLwYDVQQDEyhHbyBEYWRkeSBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5 MDkwMTAwMDAwMFoXDTM3MTIzMTIzNTk1OVowgYMxCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6 b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMRowGAYDVQQKExFHb0RhZGR5LmNvbSwgSW5jLjExMC8G A1UEAxMoR28gRGFkZHkgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZI hvcNAQEBBQADggEPADCCAQoCggEBAL9xYgjx+lk09xvJGKP3gElY6SKDE6bFIEMBO4Tx5oVJnyfq 9oQbTqC023CYxzIBsQU+B07u9PpPL1kwIuerGVZr4oAH/PMWdYA5UXvl+TW2dE6pjYIT5LY/qQOD +qK+ihVqf94Lw7YZFAXK6sOoBJQ7RnwyDfMAZiLIjWltNowRGLfTshxgtDj6AozO091GB94KPutd fMh8+7ArU6SSYmlRJQVhGkSBjCypQ5Yj36w6gZoOKcUcqeldHraenjAKOc7xiID7S13MMuyFYkMl NAJWJwGRtDtwKj9useiciAF9n9T521NtYJ2/LOdYq7hfRvzOxBsDPAnrSTFcaUaz4EcCAwEAAaNC MEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFDqahQcQZyi27/a9 BUFuIMGU2g/eMA0GCSqGSIb3DQEBCwUAA4IBAQCZ21151fmXWWcDYfF+OwYxdS2hII5PZYe096ac vNjpL9DbWu7PdIxztDhC2gV7+AJ1uP2lsdeu9tfeE8tTEH6KRtGX+rcuKxGrkLAngPnon1rpN5+r 5N9ss4UXnT3ZJE95kTXWXwTrgIOrmgIttRD02JDHBHNA7XIloKmf7J6raBKZV8aPEjoJpL1E/QYV N8Gb5DKj7Tjo2GTzLH4U/ALqn83/B2gX2yKQOC16jdFU8WnjXzPKej17CuPKf1855eJ1usV2GDPO LPAvTK33sefOT6jEm0pUBsV/fdUID+Ic/n4XuKxe9tQWskMJDE32p2u0mYRlynqI4uJEvlz36hz1 -----END CERTIFICATE----- Starfield Root Certificate Authority - G2 ========================================= -----BEGIN CERTIFICATE----- MIID3TCCAsWgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBjzELMAkGA1UEBhMCVVMxEDAOBgNVBAgT B0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoTHFN0YXJmaWVsZCBUZWNobm9s b2dpZXMsIEluYy4xMjAwBgNVBAMTKVN0YXJmaWVsZCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0 eSAtIEcyMB4XDTA5MDkwMTAwMDAwMFoXDTM3MTIzMTIzNTk1OVowgY8xCzAJBgNVBAYTAlVTMRAw DgYDVQQIEwdBcml6b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFyZmllbGQg VGVjaG5vbG9naWVzLCBJbmMuMTIwMAYDVQQDEylTdGFyZmllbGQgUm9vdCBDZXJ0aWZpY2F0ZSBB dXRob3JpdHkgLSBHMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL3twQP89o/8ArFv W59I2Z154qK3A2FWGMNHttfKPTUuiUP3oWmb3ooa/RMgnLRJdzIpVv257IzdIvpy3Cdhl+72WoTs bhm5iSzchFvVdPtrX8WJpRBSiUZV9Lh1HOZ/5FSuS/hVclcCGfgXcVnrHigHdMWdSL5stPSksPNk N3mSwOxGXn/hbVNMYq/NHwtjuzqd+/x5AJhhdM8mgkBj87JyahkNmcrUDnXMN/uLicFZ8WJ/X7Nf ZTD4p7dNdloedl40wOiWVpmKs/B/pM293DIxfJHP4F8R+GuqSVzRmZTRouNjWwl2tVZi4Ut0HZbU JtQIBFnQmA4O5t78w+wfkPECAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC AQYwHQYDVR0OBBYEFHwMMh+n2TB/xH1oo2Kooc6rB1snMA0GCSqGSIb3DQEBCwUAA4IBAQARWfol TwNvlJk7mh+ChTnUdgWUXuEok21iXQnCoKjUsHU48TRqneSfioYmUeYs0cYtbpUgSpIB7LiKZ3sx 4mcujJUDJi5DnUox9g61DLu34jd/IroAow57UvtruzvE03lRTs2Q9GcHGcg8RnoNAX3FWOdt5oUw F5okxBDgBPfg8n/Uqgr/Qh037ZTlZFkSIHc40zI+OIF1lnP6aI+xy84fxez6nH7PfrHxBy22/L/K pL/QlwVKvOoYKAKQvVR4CSFx09F9HdkWsKlhPdAKACL8x3vLCWRFCztAgfd9fDL1mMpYjn0q7pBZ c2T5NnReJaH1ZgUufzkVqSr7UIuOhWn0 -----END CERTIFICATE----- Starfield Services Root Certificate Authority - G2 ================================================== -----BEGIN CERTIFICATE----- MIID7zCCAtegAwIBAgIBADANBgkqhkiG9w0BAQsFADCBmDELMAkGA1UEBhMCVVMxEDAOBgNVBAgT B0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoTHFN0YXJmaWVsZCBUZWNobm9s b2dpZXMsIEluYy4xOzA5BgNVBAMTMlN0YXJmaWVsZCBTZXJ2aWNlcyBSb290IENlcnRpZmljYXRl IEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAwMFoXDTM3MTIzMTIzNTk1OVowgZgxCzAJBgNV BAYTAlVTMRAwDgYDVQQIEwdBcml6b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxT dGFyZmllbGQgVGVjaG5vbG9naWVzLCBJbmMuMTswOQYDVQQDEzJTdGFyZmllbGQgU2VydmljZXMg Um9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCC AQoCggEBANUMOsQq+U7i9b4Zl1+OiFOxHz/Lz58gE20pOsgPfTz3a3Y4Y9k2YKibXlwAgLIvWX/2 h/klQ4bnaRtSmpDhcePYLQ1Ob/bISdm28xpWriu2dBTrz/sm4xq6HZYuajtYlIlHVv8loJNwU4Pa hHQUw2eeBGg6345AWh1KTs9DkTvnVtYAcMtS7nt9rjrnvDH5RfbCYM8TWQIrgMw0R9+53pBlbQLP LJGmpufehRhJfGZOozptqbXuNC66DQO4M99H67FrjSXZm86B0UVGMpZwh94CDklDhbZsc7tk6mFB rMnUVN+HL8cisibMn1lUaJ/8viovxFUcdUBgF4UCVTmLfwUCAwEAAaNCMEAwDwYDVR0TAQH/BAUw AwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFJxfAN+qAdcwKziIorhtSpzyEZGDMA0GCSqG SIb3DQEBCwUAA4IBAQBLNqaEd2ndOxmfZyMIbw5hyf2E3F/YNoHN2BtBLZ9g3ccaaNnRbobhiCPP E95Dz+I0swSdHynVv/heyNXBve6SbzJ08pGCL72CQnqtKrcgfU28elUSwhXqvfdqlS5sdJ/PHLTy xQGjhdByPq1zqwubdQxtRbeOlKyWN7Wg0I8VRw7j6IPdj/3vQQF3zCepYoUz8jcI73HPdwbeyBkd iEDPfUYd/x7H4c7/I9vG+o1VTqkC50cRRj70/b17KSa7qWFiNyi2LSr2EIZkyXCn0q23KXB56jza YyWf/Wi3MOxw+3WKt21gZ7IeyLnp2KhvAotnDU0mV3HaIPzBSlCNsSi6 -----END CERTIFICATE----- AffirmTrust Commercial ====================== -----BEGIN CERTIFICATE----- MIIDTDCCAjSgAwIBAgIId3cGJyapsXwwDQYJKoZIhvcNAQELBQAwRDELMAkGA1UEBhMCVVMxFDAS BgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVzdCBDb21tZXJjaWFsMB4XDTEw MDEyOTE0MDYwNloXDTMwMTIzMTE0MDYwNlowRDELMAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmly bVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVzdCBDb21tZXJjaWFsMIIBIjANBgkqhkiG9w0BAQEF AAOCAQ8AMIIBCgKCAQEA9htPZwcroRX1BiLLHwGy43NFBkRJLLtJJRTWzsO3qyxPxkEylFf6Eqdb DuKPHx6GGaeqtS25Xw2Kwq+FNXkyLbscYjfysVtKPcrNcV/pQr6U6Mje+SJIZMblq8Yrba0F8PrV C8+a5fBQpIs7R6UjW3p6+DM/uO+Zl+MgwdYoic+U+7lF7eNAFxHUdPALMeIrJmqbTFeurCA+ukV6 BfO9m2kVrn1OIGPENXY6BwLJN/3HR+7o8XYdcxXyl6S1yHp52UKqK39c/s4mT6NmgTWvRLpUHhww MmWd5jyTXlBOeuM61G7MGvv50jeuJCqrVwMiKA1JdX+3KNp1v47j3A55MQIDAQABo0IwQDAdBgNV HQ4EFgQUnZPGU4teyq8/nx4P5ZmVvCT2lI8wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC AQYwDQYJKoZIhvcNAQELBQADggEBAFis9AQOzcAN/wr91LoWXym9e2iZWEnStB03TX8nfUYGXUPG hi4+c7ImfU+TqbbEKpqrIZcUsd6M06uJFdhrJNTxFq7YpFzUf1GO7RgBsZNjvbz4YYCanrHOQnDi qX0GJX0nof5v7LMeJNrjS1UaADs1tDvZ110w/YETifLCBivtZ8SOyUOyXGsViQK8YvxO8rUzqrJv 0wqiUOP2O+guRMLbZjipM1ZI8W0bM40NjD9gN53Tym1+NH4Nn3J2ixufcv1SNUFFApYvHLKac0kh sUlHRUe072o0EclNmsxZt9YCnlpOZbWUrhvfKbAW8b8Angc6F2S1BLUjIZkKlTuXfO8= -----END CERTIFICATE----- AffirmTrust Networking ====================== -----BEGIN CERTIFICATE----- MIIDTDCCAjSgAwIBAgIIfE8EORzUmS0wDQYJKoZIhvcNAQEFBQAwRDELMAkGA1UEBhMCVVMxFDAS BgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVzdCBOZXR3b3JraW5nMB4XDTEw MDEyOTE0MDgyNFoXDTMwMTIzMTE0MDgyNFowRDELMAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmly bVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVzdCBOZXR3b3JraW5nMIIBIjANBgkqhkiG9w0BAQEF AAOCAQ8AMIIBCgKCAQEAtITMMxcua5Rsa2FSoOujz3mUTOWUgJnLVWREZY9nZOIG41w3SfYvm4SE Hi3yYJ0wTsyEheIszx6e/jarM3c1RNg1lho9Nuh6DtjVR6FqaYvZ/Ls6rnla1fTWcbuakCNrmreI dIcMHl+5ni36q1Mr3Lt2PpNMCAiMHqIjHNRqrSK6mQEubWXLviRmVSRLQESxG9fhwoXA3hA/Pe24 /PHxI1Pcv2WXb9n5QHGNfb2V1M6+oF4nI979ptAmDgAp6zxG8D1gvz9Q0twmQVGeFDdCBKNwV6gb h+0t+nvujArjqWaJGctB+d1ENmHP4ndGyH329JKBNv3bNPFyfvMMFr20FQIDAQABo0IwQDAdBgNV HQ4EFgQUBx/S55zawm6iQLSwelAQUHTEyL0wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC AQYwDQYJKoZIhvcNAQEFBQADggEBAIlXshZ6qML91tmbmzTCnLQyFE2npN/svqe++EPbkTfOtDIu UFUaNU52Q3Eg75N3ThVwLofDwR1t3Mu1J9QsVtFSUzpE0nPIxBsFZVpikpzuQY0x2+c06lkh1QF6 12S4ZDnNye2v7UsDSKegmQGA3GWjNq5lWUhPgkvIZfFXHeVZLgo/bNjR9eUJtGxUAArgFU2HdW23 WJZa3W3SAKD0m0i+wzekujbgfIeFlxoVot4uolu9rxj5kFDNcFn4J2dHy8egBzp90SxdbBk6ZrV9 /ZFvgrG+CJPbFEfxojfHRZ48x3evZKiT3/Zpg4Jg8klCNO1aAFSFHBY2kgxc+qatv9s= -----END CERTIFICATE----- AffirmTrust Premium =================== -----BEGIN CERTIFICATE----- MIIFRjCCAy6gAwIBAgIIbYwURrGmCu4wDQYJKoZIhvcNAQEMBQAwQTELMAkGA1UEBhMCVVMxFDAS BgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1UcnVzdCBQcmVtaXVtMB4XDTEwMDEy OTE0MTAzNloXDTQwMTIzMTE0MTAzNlowQTELMAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRy dXN0MRwwGgYDVQQDDBNBZmZpcm1UcnVzdCBQcmVtaXVtMIICIjANBgkqhkiG9w0BAQEFAAOCAg8A MIICCgKCAgEAxBLfqV/+Qd3d9Z+K4/as4Tx4mrzY8H96oDMq3I0gW64tb+eT2TZwamjPjlGjhVtn BKAQJG9dKILBl1fYSCkTtuG+kU3fhQxTGJoeJKJPj/CihQvL9Cl/0qRY7iZNyaqoe5rZ+jjeRFcV 5fiMyNlI4g0WJx0eyIOFJbe6qlVBzAMiSy2RjYvmia9mx+n/K+k8rNrSs8PhaJyJ+HoAVt70VZVs +7pk3WKL3wt3MutizCaam7uqYoNMtAZ6MMgpv+0GTZe5HMQxK9VfvFMSF5yZVylmd2EhMQcuJUmd GPLu8ytxjLW6OQdJd/zvLpKQBY0tL3d770O/Nbua2Plzpyzy0FfuKE4mX4+QaAkvuPjcBukumj5R p9EixAqnOEhss/n/fauGV+O61oV4d7pD6kh/9ti+I20ev9E2bFhc8e6kGVQa9QPSdubhjL08s9NI S+LI+H+SqHZGnEJlPqQewQcDWkYtuJfzt9WyVSHvutxMAJf7FJUnM7/oQ0dG0giZFmA7mn7S5u04 6uwBHjxIVkkJx0w3AJ6IDsBz4W9m6XJHMD4Q5QsDyZpCAGzFlH5hxIrff4IaC1nEWTJ3s7xgaVY5 /bQGeyzWZDbZvUjthB9+pSKPKrhC9IK31FOQeE4tGv2Bb0TXOwF0lkLgAOIua+rF7nKsu7/+6qqo +Nz2snmKtmcCAwEAAaNCMEAwHQYDVR0OBBYEFJ3AZ6YMItkm9UWrpmVSESfYRaxjMA8GA1UdEwEB /wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBDAUAA4ICAQCzV00QYk465KzquByv MiPIs0laUZx2KI15qldGF9X1Uva3ROgIRL8YhNILgM3FEv0AVQVhh0HctSSePMTYyPtwni94loMg Nt58D2kTiKV1NpgIpsbfrM7jWNa3Pt668+s0QNiigfV4Py/VpfzZotReBA4Xrf5B8OWycvpEgjNC 6C1Y91aMYj+6QrCcDFx+LmUmXFNPALJ4fqENmS2NuB2OosSw/WDQMKSOyARiqcTtNd56l+0OOF6S L5Nwpamcb6d9Ex1+xghIsV5n61EIJenmJWtSKZGc0jlzCFfemQa0W50QBuHCAKi4HEoCChTQwUHK +4w1IX2COPKpVJEZNZOUbWo6xbLQu4mGk+ibyQ86p3q4ofB4Rvr8Ny/lioTz3/4E2aFooC8k4gmV BtWVyuEklut89pMFu+1z6S3RdTnX5yTb2E5fQ4+e0BQ5v1VwSJlXMbSc7kqYA5YwH2AG7hsj/oFg IxpHYoWlzBk0gG+zrBrjn/B7SK3VAdlntqlyk+otZrWyuOQ9PLLvTIzq6we/qzWaVYa8GKa1qF60 g2xraUDTn9zxw2lrueFtCfTxqlB2Cnp9ehehVZZCmTEJ3WARjQUwfuaORtGdFNrHF+QFlozEJLUb zxQHskD4o55BhrwE0GuWyCqANP2/7waj3VjFhT0+j/6eKeC2uAloGRwYQw== -----END CERTIFICATE----- AffirmTrust Premium ECC ======================= -----BEGIN CERTIFICATE----- MIIB/jCCAYWgAwIBAgIIdJclisc/elQwCgYIKoZIzj0EAwMwRTELMAkGA1UEBhMCVVMxFDASBgNV BAoMC0FmZmlybVRydXN0MSAwHgYDVQQDDBdBZmZpcm1UcnVzdCBQcmVtaXVtIEVDQzAeFw0xMDAx MjkxNDIwMjRaFw00MDEyMzExNDIwMjRaMEUxCzAJBgNVBAYTAlVTMRQwEgYDVQQKDAtBZmZpcm1U cnVzdDEgMB4GA1UEAwwXQWZmaXJtVHJ1c3QgUHJlbWl1bSBFQ0MwdjAQBgcqhkjOPQIBBgUrgQQA IgNiAAQNMF4bFZ0D0KF5Nbc6PJJ6yhUczWLznCZcBz3lVPqj1swS6vQUX+iOGasvLkjmrBhDeKzQ N8O9ss0s5kfiGuZjuD0uL3jET9v0D6RoTFVya5UdThhClXjMNzyR4ptlKymjQjBAMB0GA1UdDgQW BBSaryl6wBE1NSZRMADDav5A1a7WPDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAK BggqhkjOPQQDAwNnADBkAjAXCfOHiFBar8jAQr9HX/VsaobgxCd05DhT1wV/GzTjxi+zygk8N53X 57hG8f2h4nECMEJZh0PUUd+60wkyWs6Iflc9nF9Ca/UHLbXwgpP5WW+uZPpY5Yse42O+tYHNbwKM eQ== -----END CERTIFICATE----- Certum Trusted Network CA ========================= -----BEGIN CERTIFICATE----- MIIDuzCCAqOgAwIBAgIDBETAMA0GCSqGSIb3DQEBBQUAMH4xCzAJBgNVBAYTAlBMMSIwIAYDVQQK ExlVbml6ZXRvIFRlY2hub2xvZ2llcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlv biBBdXRob3JpdHkxIjAgBgNVBAMTGUNlcnR1bSBUcnVzdGVkIE5ldHdvcmsgQ0EwHhcNMDgxMDIy MTIwNzM3WhcNMjkxMjMxMTIwNzM3WjB+MQswCQYDVQQGEwJQTDEiMCAGA1UEChMZVW5pemV0byBU ZWNobm9sb2dpZXMgUy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRpZmljYXRpb24gQXV0aG9yaXR5 MSIwIAYDVQQDExlDZXJ0dW0gVHJ1c3RlZCBOZXR3b3JrIENBMIIBIjANBgkqhkiG9w0BAQEFAAOC AQ8AMIIBCgKCAQEA4/t9o3K6wvDJFIf1awFO4W5AB7ptJ11/91sts1rHUV+rpDKmYYe2bg+G0jAC l/jXaVehGDldamR5xgFZrDwxSjh80gTSSyjoIF87B6LMTXPb865Px1bVWqeWifrzq2jUI4ZZJ88J J7ysbnKDHDBy3+Ci6dLhdHUZvSqeexVUBBvXQzmtVSjF4hq79MDkrjhJM8x2hZ85RdKknvISjFH4 fOQtf/WsX+sWn7Et0brMkUJ3TCXJkDhv2/DM+44el1k+1WBO5gUo7Ul5E0u6SNsv+XLTOcr+H9g0 cvW0QM8xAcPs3hEtF10fuFDRXhmnad4HMyjKUJX5p1TLVIZQRan5SQIDAQABo0IwQDAPBgNVHRMB Af8EBTADAQH/MB0GA1UdDgQWBBQIds3LB/8k9sXN7buQvOKEN0Z19zAOBgNVHQ8BAf8EBAMCAQYw DQYJKoZIhvcNAQEFBQADggEBAKaorSLOAT2mo/9i0Eidi15ysHhE49wcrwn9I0j6vSrEuVUEtRCj jSfeC4Jj0O7eDDd5QVsisrCaQVymcODU0HfLI9MA4GxWL+FpDQ3Zqr8hgVDZBqWo/5U30Kr+4rP1 mS1FhIrlQgnXdAIv94nYmem8J9RHjboNRhx3zxSkHLmkMcScKHQDNP8zGSal6Q10tz6XxnboJ5aj Zt3hrvJBW8qYVoNzcOSGGtIxQbovvi0TWnZvTuhOgQ4/WwMioBK+ZlgRSssDxLQqKi2WF+A5VLxI 03YnnZotBqbJ7DnSq9ufmgsnAjUpsUCV5/nonFWIGUbWtzT1fs45mtk48VH3Tyw= -----END CERTIFICATE----- TWCA Root Certification Authority ================================= -----BEGIN CERTIFICATE----- MIIDezCCAmOgAwIBAgIBATANBgkqhkiG9w0BAQUFADBfMQswCQYDVQQGEwJUVzESMBAGA1UECgwJ VEFJV0FOLUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFUV0NBIFJvb3QgQ2VydGlmaWNh dGlvbiBBdXRob3JpdHkwHhcNMDgwODI4MDcyNDMzWhcNMzAxMjMxMTU1OTU5WjBfMQswCQYDVQQG EwJUVzESMBAGA1UECgwJVEFJV0FOLUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFUV0NB IFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK AoIBAQCwfnK4pAOU5qfeCTiRShFAh6d8WWQUe7UREN3+v9XAu1bihSX0NXIP+FPQQeFEAcK0HMMx QhZHhTMidrIKbw/lJVBPhYa+v5guEGcevhEFhgWQxFnQfHgQsIBct+HHK3XLfJ+utdGdIzdjp9xC oi2SBBtQwXu4PhvJVgSLL1KbralW6cH/ralYhzC2gfeXRfwZVzsrb+RH9JlF/h3x+JejiB03HFyP 4HYlmlD4oFT/RJB2I9IyxsOrBr/8+7/zrX2SYgJbKdM1o5OaQ2RgXbL6Mv87BK9NQGr5x+PvI/1r y+UPizgN7gr8/g+YnzAx3WxSZfmLgb4i4RxYA7qRG4kHAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIB BjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqOFsmjd6LWvJPelSDGRjjCDWmujANBgkqhkiG 9w0BAQUFAAOCAQEAPNV3PdrfibqHDAhUaiBQkr6wQT25JmSDCi/oQMCXKCeCMErJk/9q56YAf4lC mtYR5VPOL8zy2gXE/uJQxDqGfczafhAJO5I1KlOy/usrBdlsXebQ79NqZp4VKIV66IIArB6nCWlW QtNoURi+VJq/REG6Sb4gumlc7rh3zc5sH62Dlhh9DrUUOYTxKOkto557HnpyWoOzeW/vtPzQCqVY T0bf+215WfKEIlKuD8z7fDvnaspHYcN6+NOSBB+4IIThNlQWx0DeO4pz3N/GCUzf7Nr/1FNCocny Yh0igzyXxfkZYiesZSLX0zzG5Y6yU8xJzrww/nsOM5D77dIUkR8Hrw== -----END CERTIFICATE----- Security Communication RootCA2 ============================== -----BEGIN CERTIFICATE----- MIIDdzCCAl+gAwIBAgIBADANBgkqhkiG9w0BAQsFADBdMQswCQYDVQQGEwJKUDElMCMGA1UEChMc U0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UECxMeU2VjdXJpdHkgQ29tbXVuaWNh dGlvbiBSb290Q0EyMB4XDTA5MDUyOTA1MDAzOVoXDTI5MDUyOTA1MDAzOVowXTELMAkGA1UEBhMC SlAxJTAjBgNVBAoTHFNFQ09NIFRydXN0IFN5c3RlbXMgQ08uLExURC4xJzAlBgNVBAsTHlNlY3Vy aXR5IENvbW11bmljYXRpb24gUm9vdENBMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB ANAVOVKxUrO6xVmCxF1SrjpDZYBLx/KWvNs2l9amZIyoXvDjChz335c9S672XewhtUGrzbl+dp++ +T42NKA7wfYxEUV0kz1XgMX5iZnK5atq1LXaQZAQwdbWQonCv/Q4EpVMVAX3NuRFg3sUZdbcDE3R 3n4MqzvEFb46VqZab3ZpUql6ucjrappdUtAtCms1FgkQhNBqyjoGADdH5H5XTz+L62e4iKrFvlNV spHEfbmwhRkGeC7bYRr6hfVKkaHnFtWOojnflLhwHyg/i/xAXmODPIMqGplrz95Zajv8bxbXH/1K EOtOghY6rCcMU/Gt1SSwawNQwS08Ft1ENCcadfsCAwEAAaNCMEAwHQYDVR0OBBYEFAqFqXdlBZh8 QIH4D5csOPEK7DzPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3DQEB CwUAA4IBAQBMOqNErLlFsceTfsgLCkLfZOoc7llsCLqJX2rKSpWeeo8HxdpFcoJxDjrSzG+ntKEj u/Ykn8sX/oymzsLS28yN/HH8AynBbF0zX2S2ZTuJbxh2ePXcokgfGT+Ok+vx+hfuzU7jBBJV1uXk 3fs+BXziHV7Gp7yXT2g69ekuCkO2r1dcYmh8t/2jioSgrGK+KwmHNPBqAbubKVY8/gA3zyNs8U6q tnRGEmyR7jTV7JqR50S+kDFy1UkC9gLl9B/rfNmWVan/7Ir5mUf/NVoCqgTLiluHcSmRvaS0eg29 mvVXIwAHIRc/SjnRBUkLp7Y3gaVdjKozXoEofKd9J+sAro03 -----END CERTIFICATE----- Actalis Authentication Root CA ============================== -----BEGIN CERTIFICATE----- MIIFuzCCA6OgAwIBAgIIVwoRl0LE48wwDQYJKoZIhvcNAQELBQAwazELMAkGA1UEBhMCSVQxDjAM BgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8wMzM1ODUyMDk2NzEnMCUGA1UE AwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290IENBMB4XDTExMDkyMjExMjIwMloXDTMwMDky MjExMjIwMlowazELMAkGA1UEBhMCSVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlz IFMucC5BLi8wMzM1ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290 IENBMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAp8bEpSmkLO/lGMWwUKNvUTufClrJ wkg4CsIcoBh/kbWHuUA/3R1oHwiD1S0eiKD4j1aPbZkCkpAW1V8IbInX4ay8IMKx4INRimlNAJZa by/ARH6jDuSRzVju3PvHHkVH3Se5CAGfpiEd9UEtL0z9KK3giq0itFZljoZUj5NDKd45RnijMCO6 zfB9E1fAXdKDa0hMxKufgFpbOr3JpyI/gCczWw63igxdBzcIy2zSekciRDXFzMwujt0q7bd9Zg1f YVEiVRvjRuPjPdA1YprbrxTIW6HMiRvhMCb8oJsfgadHHwTrozmSBp+Z07/T6k9QnBn+locePGX2 oxgkg4YQ51Q+qDp2JE+BIcXjDwL4k5RHILv+1A7TaLndxHqEguNTVHnd25zS8gebLra8Pu2Fbe8l EfKXGkJh90qX6IuxEAf6ZYGyojnP9zz/GPvG8VqLWeICrHuS0E4UT1lF9gxeKF+w6D9Fz8+vm2/7 hNN3WpVvrJSEnu68wEqPSpP4RCHiMUVhUE4Q2OM1fEwZtN4Fv6MGn8i1zeQf1xcGDXqVdFUNaBr8 EBtiZJ1t4JWgw5QHVw0U5r0F+7if5t+L4sbnfpb2U8WANFAoWPASUHEXMLrmeGO89LKtmyuy/uE5 jF66CyCU3nuDuP/jVo23Eek7jPKxwV2dpAtMK9myGPW1n0sCAwEAAaNjMGEwHQYDVR0OBBYEFFLY iDrIn3hm7YnzezhwlMkCAjbQMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUUtiIOsifeGbt ifN7OHCUyQICNtAwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBCwUAA4ICAQALe3KHwGCmSUyI WOYdiPcUZEim2FgKDk8TNd81HdTtBjHIgT5q1d07GjLukD0R0i70jsNjLiNmsGe+b7bAEzlgqqI0 JZN1Ut6nna0Oh4lScWoWPBkdg/iaKWW+9D+a2fDzWochcYBNy+A4mz+7+uAwTc+G02UQGRjRlwKx K3JCaKygvU5a2hi/a5iB0P2avl4VSM0RFbnAKVy06Ij3Pjaut2L9HmLecHgQHEhb2rykOLpn7VU+ Xlff1ANATIGk0k9jpwlCCRT8AKnCgHNPLsBA2RF7SOp6AsDT6ygBJlh0wcBzIm2Tlf05fbsq4/aC 4yyXX04fkZT6/iyj2HYauE2yOE+b+h1IYHkm4vP9qdCa6HCPSXrW5b0KDtst842/6+OkfcvHlXHo 2qN8xcL4dJIEG4aspCJTQLas/kx2z/uUMsA1n3Y/buWQbqCmJqK4LL7RK4X9p2jIugErsWx0Hbhz lefut8cl8ABMALJ+tguLHPPAUJ4lueAI3jZm/zel0btUZCzJJ7VLkn5l/9Mt4blOvH+kQSGQQXem OR/qnuOf0GZvBeyqdn6/axag67XH/JJULysRJyU3eExRarDzzFhdFPFqSBX/wge2sY0PjlxQRrM9 vwGYT7JZVEc+NHt4bVaTLnPqZih4zR0Uv6CPLy64Lo7yFIrM6bV8+2ydDKXhlg== -----END CERTIFICATE----- Buypass Class 2 Root CA ======================= -----BEGIN CERTIFICATE----- MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEdMBsGA1UECgwU QnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3MgQ2xhc3MgMiBSb290IENBMB4X DTEwMTAyNjA4MzgwM1oXDTQwMTAyNjA4MzgwM1owTjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1 eXBhc3MgQVMtOTgzMTYzMzI3MSAwHgYDVQQDDBdCdXlwYXNzIENsYXNzIDIgUm9vdCBDQTCCAiIw DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANfHXvfBB9R3+0Mh9PT1aeTuMgHbo4Yf5FkNuud1 g1Lr6hxhFUi7HQfKjK6w3Jad6sNgkoaCKHOcVgb/S2TwDCo3SbXlzwx87vFKu3MwZfPVL4O2fuPn 9Z6rYPnT8Z2SdIrkHJasW4DptfQxh6NR/Md+oW+OU3fUl8FVM5I+GC911K2GScuVr1QGbNgGE41b /+EmGVnAJLqBcXmQRFBoJJRfuLMR8SlBYaNByyM21cHxMlAQTn/0hpPshNOOvEu/XAFOBz3cFIqU CqTqc/sLUegTBxj6DvEr0VQVfTzh97QZQmdiXnfgolXsttlpF9U6r0TtSsWe5HonfOV116rLJeff awrbD02TTqigzXsu8lkBarcNuAeBfos4GzjmCleZPe4h6KP1DBbdi+w0jpwqHAAVF41og9JwnxgI zRFo1clrUs3ERo/ctfPYV3Me6ZQ5BL/T3jjetFPsaRyifsSP5BtwrfKi+fv3FmRmaZ9JUaLiFRhn Bkp/1Wy1TbMz4GHrXb7pmA8y1x1LPC5aAVKRCfLf6o3YBkBjqhHk/sM3nhRSP/TizPJhk9H9Z2vX Uq6/aKtAQ6BXNVN48FP4YUIHZMbXb5tMOA1jrGKvNouicwoN9SG9dKpN6nIDSdvHXx1iY8f93ZHs M+71bbRuMGjeyNYmsHVee7QHIJihdjK4TWxPAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYD VR0OBBYEFMmAd+BikoL1RpzzuvdMw964o605MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsF AAOCAgEAU18h9bqwOlI5LJKwbADJ784g7wbylp7ppHR/ehb8t/W2+xUbP6umwHJdELFx7rxP462s A20ucS6vxOOto70MEae0/0qyexAQH6dXQbLArvQsWdZHEIjzIVEpMMpghq9Gqx3tOluwlN5E40EI osHsHdb9T7bWR9AUC8rmyrV7d35BH16Dx7aMOZawP5aBQW9gkOLo+fsicdl9sz1Gv7SEr5AcD48S aq/v7h56rgJKihcrdv6sVIkkLE8/trKnToyokZf7KcZ7XC25y2a2t6hbElGFtQl+Ynhw/qlqYLYd DnkM/crqJIByw5c/8nerQyIKx+u2DISCLIBrQYoIwOula9+ZEsuK1V6ADJHgJgg2SMX6OBE1/yWD LfJ6v9r9jv6ly0UsH8SIU653DtmadsWOLB2jutXsMq7Aqqz30XpN69QH4kj3Io6wpJ9qzo6ysmD0 oyLQI+uUWnpp3Q+/QFesa1lQ2aOZ4W7+jQF5JyMV3pKdewlNWudLSDBaGOYKbeaP4NK75t98biGC wWg5TbSYWGZizEqQXsP6JwSxeRV0mcy+rSDeJmAc61ZRpqPq5KM/p/9h3PFaTWwyI0PurKju7koS CTxdccK+efrCh2gdC/1cacwG0Jp9VJkqyTkaGa9LKkPzY11aWOIv4x3kqdbQCtCev9eBCfHJxyYN rJgWVqA= -----END CERTIFICATE----- Buypass Class 3 Root CA ======================= -----BEGIN CERTIFICATE----- MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEdMBsGA1UECgwU QnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3MgQ2xhc3MgMyBSb290IENBMB4X DTEwMTAyNjA4Mjg1OFoXDTQwMTAyNjA4Mjg1OFowTjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1 eXBhc3MgQVMtOTgzMTYzMzI3MSAwHgYDVQQDDBdCdXlwYXNzIENsYXNzIDMgUm9vdCBDQTCCAiIw DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKXaCpUWUOOV8l6ddjEGMnqb8RB2uACatVI2zSRH sJ8YZLya9vrVediQYkwiL944PdbgqOkcLNt4EemOaFEVcsfzM4fkoF0LXOBXByow9c3EN3coTRiR 5r/VUv1xLXA+58bEiuPwKAv0dpihi4dVsjoT/Lc+JzeOIuOoTyrvYLs9tznDDgFHmV0ST9tD+leh 7fmdvhFHJlsTmKtdFoqwNxxXnUX/iJY2v7vKB3tvh2PX0DJq1l1sDPGzbjniazEuOQAnFN44wOwZ ZoYS6J1yFhNkUsepNxz9gjDthBgd9K5c/3ATAOux9TN6S9ZV+AWNS2mw9bMoNlwUxFFzTWsL8TQH 2xc519woe2v1n/MuwU8XKhDzzMro6/1rqy6any2CbgTUUgGTLT2G/H783+9CHaZr77kgxve9oKeV /afmiSTYzIw0bOIjL9kSGiG5VZFvC5F5GQytQIgLcOJ60g7YaEi7ghM5EFjp2CoHxhLbWNvSO1UQ RwUVZ2J+GGOmRj8JDlQyXr8NYnon74Do29lLBlo3WiXQCBJ31G8JUJc9yB3D34xFMFbG02SrZvPA Xpacw8Tvw3xrizp5f7NJzz3iiZ+gMEuFuZyUJHmPfWupRWgPK9Dx2hzLabjKSWJtyNBjYt1gD1iq j6G8BaVmos8bdrKEZLFMOVLAMLrwjEsCsLa3AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYD VR0OBBYEFEe4zf/lb+74suwvTg75JbCOPGvDMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsF AAOCAgEAACAjQTUEkMJAYmDv4jVM1z+s4jSQuKFvdvoWFqRINyzpkMLyPPgKn9iB5btb2iUspKdV cSQy9sgL8rxq+JOssgfCX5/bzMiKqr5qb+FJEMwx14C7u8jYog5kV+qi9cKpMRXSIGrs/CIBKM+G uIAeqcwRpTzyFrNHnfzSgCHEy9BHcEGhyoMZCCxt8l13nIoUE9Q2HJLw5QY33KbmkJs4j1xrG0aG Q0JfPgEHU1RdZX33inOhmlRaHylDFCfChQ+1iHsaO5S3HWCntZznKWlXWpuTekMwGwPXYshApqr8 ZORK15FTAaggiG6cX0S5y2CBNOxv033aSF/rtJC8LakcC6wc1aJoIIAE1vyxjy+7SjENSoYc6+I2 KSb12tjE8nVhz36udmNKekBlk4f4HoCMhuWG1o8O/FMsYOgWYRqiPkN7zTlgVGr18okmAWiDSKIz 6MkEkbIRNBE+6tBDGR8Dk5AM/1E9V/RBbuHLoL7ryWPNbczk+DaqaJ3tvV2XcEQNtg413OEMXbug UZTLfhbrES+jkkXITHHZvMmZUldGL1DPvTVp9D0VzgalLA8+9oG6lLvDu79leNKGef9JOxqDDPDe eOzI8k1MGt6CKfjBWtrt7uYnXuhF0J0cUahoq0Tj0Itq4/g7u9xN12TyUb7mqqta6THuBrxzvxNi Cp/HuZc= -----END CERTIFICATE----- T-TeleSec GlobalRoot Class 3 ============================ -----BEGIN CERTIFICATE----- MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoM IlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBU cnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDMwHhcNMDgx MDAxMTAyOTU2WhcNMzMxMDAxMjM1OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lz dGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBD ZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDMwggEiMA0GCSqGSIb3 DQEBAQUAA4IBDwAwggEKAoIBAQC9dZPwYiJvJK7genasfb3ZJNW4t/zN8ELg63iIVl6bmlQdTQyK 9tPPcPRStdiTBONGhnFBSivwKixVA9ZIw+A5OO3yXDw/RLyTPWGrTs0NvvAgJ1gORH8EGoel15YU NpDQSXuhdfsaa3Ox+M6pCSzyU9XDFES4hqX2iys52qMzVNn6chr3IhUciJFrf2blw2qAsCTz34ZF iP0Zf3WHHx+xGwpzJFu5ZeAsVMhg02YXP+HMVDNzkQI6pn97djmiH5a2OK61yJN0HZ65tOVgnS9W 0eDrXltMEnAMbEQgqxHY9Bn20pxSN+f6tsIxO0rUFJmtxxr1XV/6B7h8DR/Wgx6zAgMBAAGjQjBA MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS1A/d2O2GCahKqGFPr AyGUv/7OyjANBgkqhkiG9w0BAQsFAAOCAQEAVj3vlNW92nOyWL6ukK2YJ5f+AbGwUgC4TeQbIXQb fsDuXmkqJa9c1h3a0nnJ85cp4IaH3gRZD/FZ1GSFS5mvJQQeyUapl96Cshtwn5z2r3Ex3XsFpSzT ucpH9sry9uetuUg/vBa3wW306gmv7PO15wWeph6KU1HWk4HMdJP2udqmJQV0eVp+QD6CSyYRMG7h P0HHRwA11fXT91Q+gT3aSWqas+8QPebrb9HIIkfLzM8BMZLZGOMivgkeGj5asuRrDFR6fUNOuIml e9eiPZaGzPImNC1qkp2aGtAw4l1OBLBfiyB+d8E9lYLRRpo7PHi4b6HQDWSieB4pTpPDpFQUWw== -----END CERTIFICATE----- D-TRUST Root Class 3 CA 2 2009 ============================== -----BEGIN CERTIFICATE----- MIIEMzCCAxugAwIBAgIDCYPzMA0GCSqGSIb3DQEBCwUAME0xCzAJBgNVBAYTAkRFMRUwEwYDVQQK DAxELVRydXN0IEdtYkgxJzAlBgNVBAMMHkQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgMjAwOTAe Fw0wOTExMDUwODM1NThaFw0yOTExMDUwODM1NThaME0xCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxE LVRydXN0IEdtYkgxJzAlBgNVBAMMHkQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgMjAwOTCCASIw DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANOySs96R+91myP6Oi/WUEWJNTrGa9v+2wBoqOAD ER03UAifTUpolDWzU9GUY6cgVq/eUXjsKj3zSEhQPgrfRlWLJ23DEE0NkVJD2IfgXU42tSHKXzlA BF9bfsyjxiupQB7ZNoTWSPOSHjRGICTBpFGOShrvUD9pXRl/RcPHAY9RySPocq60vFYJfxLLHLGv KZAKyVXMD9O0Gu1HNVpK7ZxzBCHQqr0ME7UAyiZsxGsMlFqVlNpQmvH/pStmMaTJOKDfHR+4CS7z p+hnUquVH+BGPtikw8paxTGA6Eian5Rp/hnd2HN8gcqW3o7tszIFZYQ05ub9VxC1X3a/L7AQDcUC AwEAAaOCARowggEWMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFP3aFMSfMN4hvR5COfyrYyNJ 4PGEMA4GA1UdDwEB/wQEAwIBBjCB0wYDVR0fBIHLMIHIMIGAoH6gfIZ6bGRhcDovL2RpcmVjdG9y eS5kLXRydXN0Lm5ldC9DTj1ELVRSVVNUJTIwUm9vdCUyMENsYXNzJTIwMyUyMENBJTIwMiUyMDIw MDksTz1ELVRydXN0JTIwR21iSCxDPURFP2NlcnRpZmljYXRlcmV2b2NhdGlvbmxpc3QwQ6BBoD+G PWh0dHA6Ly93d3cuZC10cnVzdC5uZXQvY3JsL2QtdHJ1c3Rfcm9vdF9jbGFzc18zX2NhXzJfMjAw OS5jcmwwDQYJKoZIhvcNAQELBQADggEBAH+X2zDI36ScfSF6gHDOFBJpiBSVYEQBrLLpME+bUMJm 2H6NMLVwMeniacfzcNsgFYbQDfC+rAF1hM5+n02/t2A7nPPKHeJeaNijnZflQGDSNiH+0LS4F9p0 o3/U37CYAqxva2ssJSRyoWXuJVrl5jLn8t+rSfrzkGkj2wTZ51xY/GXUl77M/C4KzCUqNQT4YJEV dT1B/yMfGchs64JTBKbkTCJNjYy6zltz7GRUUG3RnFX7acM2w4y8PIWmawomDeCTmGCufsYkl4ph X5GOZpIJhzbNi5stPvZR1FDUWSi9g/LMKHtThm3YJohw1+qRzT65ysCQblrGXnRl11z+o+I= -----END CERTIFICATE----- D-TRUST Root Class 3 CA 2 EV 2009 ================================= -----BEGIN CERTIFICATE----- MIIEQzCCAyugAwIBAgIDCYP0MA0GCSqGSIb3DQEBCwUAMFAxCzAJBgNVBAYTAkRFMRUwEwYDVQQK DAxELVRydXN0IEdtYkgxKjAoBgNVBAMMIUQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgRVYgMjAw OTAeFw0wOTExMDUwODUwNDZaFw0yOTExMDUwODUwNDZaMFAxCzAJBgNVBAYTAkRFMRUwEwYDVQQK DAxELVRydXN0IEdtYkgxKjAoBgNVBAMMIUQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgRVYgMjAw OTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJnxhDRwui+3MKCOvXwEz75ivJn9gpfS egpnljgJ9hBOlSJzmY3aFS3nBfwZcyK3jpgAvDw9rKFs+9Z5JUut8Mxk2og+KbgPCdM03TP1YtHh zRnp7hhPTFiu4h7WDFsVWtg6uMQYZB7jM7K1iXdODL/ZlGsTl28So/6ZqQTMFexgaDbtCHu39b+T 7WYxg4zGcTSHThfqr4uRjRxWQa4iN1438h3Z0S0NL2lRp75mpoo6Kr3HGrHhFPC+Oh25z1uxav60 sUYgovseO3Dvk5h9jHOW8sXvhXCtKSb8HgQ+HKDYD8tSg2J87otTlZCpV6LqYQXY+U3EJ/pure35 11H3a6UCAwEAAaOCASQwggEgMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFNOUikxiEyoZLsyv cop9NteaHNxnMA4GA1UdDwEB/wQEAwIBBjCB3QYDVR0fBIHVMIHSMIGHoIGEoIGBhn9sZGFwOi8v ZGlyZWN0b3J5LmQtdHJ1c3QubmV0L0NOPUQtVFJVU1QlMjBSb290JTIwQ2xhc3MlMjAzJTIwQ0El MjAyJTIwRVYlMjAyMDA5LE89RC1UcnVzdCUyMEdtYkgsQz1ERT9jZXJ0aWZpY2F0ZXJldm9jYXRp b25saXN0MEagRKBChkBodHRwOi8vd3d3LmQtdHJ1c3QubmV0L2NybC9kLXRydXN0X3Jvb3RfY2xh c3NfM19jYV8yX2V2XzIwMDkuY3JsMA0GCSqGSIb3DQEBCwUAA4IBAQA07XtaPKSUiO8aEXUHL7P+ PPoeUSbrh/Yp3uDx1MYkCenBz1UbtDDZzhr+BlGmFaQt77JLvyAoJUnRpjZ3NOhk31KxEcdzes05 nsKtjHEh8lprr988TlWvsoRlFIm5d8sqMb7Po23Pb0iUMkZv53GMoKaEGTcH8gNFCSuGdXzfX2lX ANtu2KZyIktQ1HWYVt+3GP9DQ1CuekR78HlR10M9p9OB0/DJT7naxpeG0ILD5EJt/rDiZE4OJudA NCa1CInXCGNjOCd1HjPqbqjdn5lPdE2BiYBL3ZqXKVwvvoFBuYz/6n1gBp7N1z3TLqMVvKjmJuVv w9y4AyHqnxbxLFS1 -----END CERTIFICATE----- CA Disig Root R2 ================ -----BEGIN CERTIFICATE----- MIIFaTCCA1GgAwIBAgIJAJK4iNuwisFjMA0GCSqGSIb3DQEBCwUAMFIxCzAJBgNVBAYTAlNLMRMw EQYDVQQHEwpCcmF0aXNsYXZhMRMwEQYDVQQKEwpEaXNpZyBhLnMuMRkwFwYDVQQDExBDQSBEaXNp ZyBSb290IFIyMB4XDTEyMDcxOTA5MTUzMFoXDTQyMDcxOTA5MTUzMFowUjELMAkGA1UEBhMCU0sx EzARBgNVBAcTCkJyYXRpc2xhdmExEzARBgNVBAoTCkRpc2lnIGEucy4xGTAXBgNVBAMTEENBIERp c2lnIFJvb3QgUjIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCio8QACdaFXS1tFPbC w3OeNcJxVX6B+6tGUODBfEl45qt5WDza/3wcn9iXAng+a0EE6UG9vgMsRfYvZNSrXaNHPWSb6Wia xswbP7q+sos0Ai6YVRn8jG+qX9pMzk0DIaPY0jSTVpbLTAwAFjxfGs3Ix2ymrdMxp7zo5eFm1tL7 A7RBZckQrg4FY8aAamkw/dLukO8NJ9+flXP04SXabBbeQTg06ov80egEFGEtQX6sx3dOy1FU+16S GBsEWmjGycT6txOgmLcRK7fWV8x8nhfRyyX+hk4kLlYMeE2eARKmK6cBZW58Yh2EhN/qwGu1pSqV g8NTEQxzHQuyRpDRQjrOQG6Vrf/GlK1ul4SOfW+eioANSW1z4nuSHsPzwfPrLgVv2RvPN3YEyLRa 5Beny912H9AZdugsBbPWnDTYltxhh5EF5EQIM8HauQhl1K6yNg3ruji6DOWbnuuNZt2Zz9aJQfYE koopKW1rOhzndX0CcQ7zwOe9yxndnWCywmZgtrEE7snmhrmaZkCo5xHtgUUDi/ZnWejBBhG93c+A Ak9lQHhcR1DIm+YfgXvkRKhbhZri3lrVx/k6RGZL5DJUfORsnLMOPReisjQS1n6yqEm70XooQL6i Fh/f5DcfEXP7kAplQ6INfPgGAVUzfbANuPT1rqVCV3w2EYx7XsQDnYx5nQIDAQABo0IwQDAPBgNV HRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUtZn4r7CU9eMg1gqtzk5WpC5u Qu0wDQYJKoZIhvcNAQELBQADggIBACYGXnDnZTPIgm7ZnBc6G3pmsgH2eDtpXi/q/075KMOYKmFM tCQSin1tERT3nLXK5ryeJ45MGcipvXrA1zYObYVybqjGom32+nNjf7xueQgcnYqfGopTpti72TVV sRHFqQOzVju5hJMiXn7B9hJSi+osZ7z+Nkz1uM/Rs0mSO9MpDpkblvdhuDvEK7Z4bLQjb/D907Je dR+Zlais9trhxTF7+9FGs9K8Z7RiVLoJ92Owk6Ka+elSLotgEqv89WBW7xBci8QaQtyDW2QOy7W8 1k/BfDxujRNt+3vrMNDcTa/F1balTFtxyegxvug4BkihGuLq0t4SOVga/4AOgnXmt8kHbA7v/zjx mHHEt38OFdAlab0inSvtBfZGR6ztwPDUO+Ls7pZbkBNOHlY667DvlruWIxG68kOGdGSVyCh13x01 utI3gzhTODY7z2zp+WsO0PsE6E9312UBeIYMej4hYvF/Y3EMyZ9E26gnonW+boE+18DrG5gPcFw0 sorMwIUY6256s/daoQe/qUKS82Ail+QUoQebTnbAjn39pCXHR+3/H3OszMOl6W8KjptlwlCFtaOg UxLMVYdh84GuEEZhvUQhuMI9dM9+JDX6HAcOmz0iyu8xL4ysEr3vQCj8KWefshNPZiTEUxnpHikV 7+ZtsH8tZ/3zbBt1RqPlShfppNcL -----END CERTIFICATE----- ACCVRAIZ1 ========= -----BEGIN CERTIFICATE----- MIIH0zCCBbugAwIBAgIIXsO3pkN/pOAwDQYJKoZIhvcNAQEFBQAwQjESMBAGA1UEAwwJQUNDVlJB SVoxMRAwDgYDVQQLDAdQS0lBQ0NWMQ0wCwYDVQQKDARBQ0NWMQswCQYDVQQGEwJFUzAeFw0xMTA1 MDUwOTM3MzdaFw0zMDEyMzEwOTM3MzdaMEIxEjAQBgNVBAMMCUFDQ1ZSQUlaMTEQMA4GA1UECwwH UEtJQUNDVjENMAsGA1UECgwEQUNDVjELMAkGA1UEBhMCRVMwggIiMA0GCSqGSIb3DQEBAQUAA4IC DwAwggIKAoICAQCbqau/YUqXry+XZpp0X9DZlv3P4uRm7x8fRzPCRKPfmt4ftVTdFXxpNRFvu8gM jmoYHtiP2Ra8EEg2XPBjs5BaXCQ316PWywlxufEBcoSwfdtNgM3802/J+Nq2DoLSRYWoG2ioPej0 RGy9ocLLA76MPhMAhN9KSMDjIgro6TenGEyxCQ0jVn8ETdkXhBilyNpAlHPrzg5XPAOBOp0KoVdD aaxXbXmQeOW1tDvYvEyNKKGno6e6Ak4l0Squ7a4DIrhrIA8wKFSVf+DuzgpmndFALW4ir50awQUZ 0m/A8p/4e7MCQvtQqR0tkw8jq8bBD5L/0KIV9VMJcRz/RROE5iZe+OCIHAr8Fraocwa48GOEAqDG WuzndN9wrqODJerWx5eHk6fGioozl2A3ED6XPm4pFdahD9GILBKfb6qkxkLrQaLjlUPTAYVtjrs7 8yM2x/474KElB0iryYl0/wiPgL/AlmXz7uxLaL2diMMxs0Dx6M/2OLuc5NF/1OVYm3z61PMOm3WR 5LpSLhl+0fXNWhn8ugb2+1KoS5kE3fj5tItQo05iifCHJPqDQsGH+tUtKSpacXpkatcnYGMN285J 9Y0fkIkyF/hzQ7jSWpOGYdbhdQrqeWZ2iE9x6wQl1gpaepPluUsXQA+xtrn13k/c4LOsOxFwYIRK Q26ZIMApcQrAZQIDAQABo4ICyzCCAscwfQYIKwYBBQUHAQEEcTBvMEwGCCsGAQUFBzAChkBodHRw Oi8vd3d3LmFjY3YuZXMvZmlsZWFkbWluL0FyY2hpdm9zL2NlcnRpZmljYWRvcy9yYWl6YWNjdjEu Y3J0MB8GCCsGAQUFBzABhhNodHRwOi8vb2NzcC5hY2N2LmVzMB0GA1UdDgQWBBTSh7Tj3zcnk1X2 VuqB5TbMjB4/vTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNKHtOPfNyeTVfZW6oHlNsyM Hj+9MIIBcwYDVR0gBIIBajCCAWYwggFiBgRVHSAAMIIBWDCCASIGCCsGAQUFBwICMIIBFB6CARAA QQB1AHQAbwByAGkAZABhAGQAIABkAGUAIABDAGUAcgB0AGkAZgBpAGMAYQBjAGkA8wBuACAAUgBh AO0AegAgAGQAZQAgAGwAYQAgAEEAQwBDAFYAIAAoAEEAZwBlAG4AYwBpAGEAIABkAGUAIABUAGUA YwBuAG8AbABvAGcA7QBhACAAeQAgAEMAZQByAHQAaQBmAGkAYwBhAGMAaQDzAG4AIABFAGwAZQBj AHQAcgDzAG4AaQBjAGEALAAgAEMASQBGACAAUQA0ADYAMAAxADEANQA2AEUAKQAuACAAQwBQAFMA IABlAG4AIABoAHQAdABwADoALwAvAHcAdwB3AC4AYQBjAGMAdgAuAGUAczAwBggrBgEFBQcCARYk aHR0cDovL3d3dy5hY2N2LmVzL2xlZ2lzbGFjaW9uX2MuaHRtMFUGA1UdHwROMEwwSqBIoEaGRGh0 dHA6Ly93d3cuYWNjdi5lcy9maWxlYWRtaW4vQXJjaGl2b3MvY2VydGlmaWNhZG9zL3JhaXphY2N2 MV9kZXIuY3JsMA4GA1UdDwEB/wQEAwIBBjAXBgNVHREEEDAOgQxhY2N2QGFjY3YuZXMwDQYJKoZI hvcNAQEFBQADggIBAJcxAp/n/UNnSEQU5CmH7UwoZtCPNdpNYbdKl02125DgBS4OxnnQ8pdpD70E R9m+27Up2pvZrqmZ1dM8MJP1jaGo/AaNRPTKFpV8M9xii6g3+CfYCS0b78gUJyCpZET/LtZ1qmxN YEAZSUNUY9rizLpm5U9EelvZaoErQNV/+QEnWCzI7UiRfD+mAM/EKXMRNt6GGT6d7hmKG9Ww7Y49 nCrADdg9ZuM8Db3VlFzi4qc1GwQA9j9ajepDvV+JHanBsMyZ4k0ACtrJJ1vnE5Bc5PUzolVt3OAJ TS+xJlsndQAJxGJ3KQhfnlmstn6tn1QwIgPBHnFk/vk4CpYY3QIUrCPLBhwepH2NDd4nQeit2hW3 sCPdK6jT2iWH7ehVRE2I9DZ+hJp4rPcOVkkO1jMl1oRQQmwgEh0q1b688nCBpHBgvgW1m54ERL5h I6zppSSMEYCUWqKiuUnSwdzRp+0xESyeGabu4VXhwOrPDYTkF7eifKXeVSUG7szAh1xA2syVP1Xg Nce4hL60Xc16gwFy7ofmXx2utYXGJt/mwZrpHgJHnyqobalbz+xFd3+YJ5oyXSrjhO7FmGYvliAd 3djDJ9ew+f7Zfc3Qn48LFFhRny+Lwzgt3uiP1o2HpPVWQxaZLPSkVrQ0uGE3ycJYgBugl6H8WY3p EfbRD0tVNEYqi4Y7 -----END CERTIFICATE----- TWCA Global Root CA =================== -----BEGIN CERTIFICATE----- MIIFQTCCAymgAwIBAgICDL4wDQYJKoZIhvcNAQELBQAwUTELMAkGA1UEBhMCVFcxEjAQBgNVBAoT CVRBSVdBTi1DQTEQMA4GA1UECxMHUm9vdCBDQTEcMBoGA1UEAxMTVFdDQSBHbG9iYWwgUm9vdCBD QTAeFw0xMjA2MjcwNjI4MzNaFw0zMDEyMzExNTU5NTlaMFExCzAJBgNVBAYTAlRXMRIwEAYDVQQK EwlUQUlXQU4tQ0ExEDAOBgNVBAsTB1Jvb3QgQ0ExHDAaBgNVBAMTE1RXQ0EgR2xvYmFsIFJvb3Qg Q0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCwBdvI64zEbooh745NnHEKH1Jw7W2C nJfF10xORUnLQEK1EjRsGcJ0pDFfhQKX7EMzClPSnIyOt7h52yvVavKOZsTuKwEHktSz0ALfUPZV r2YOy+BHYC8rMjk1Ujoog/h7FsYYuGLWRyWRzvAZEk2tY/XTP3VfKfChMBwqoJimFb3u/Rk28OKR Q4/6ytYQJ0lM793B8YVwm8rqqFpD/G2Gb3PpN0Wp8DbHzIh1HrtsBv+baz4X7GGqcXzGHaL3SekV tTzWoWH1EfcFbx39Eb7QMAfCKbAJTibc46KokWofwpFFiFzlmLhxpRUZyXx1EcxwdE8tmx2RRP1W KKD+u4ZqyPpcC1jcxkt2yKsi2XMPpfRaAok/T54igu6idFMqPVMnaR1sjjIsZAAmY2E2TqNGtz99 sy2sbZCilaLOz9qC5wc0GZbpuCGqKX6mOL6OKUohZnkfs8O1CWfe1tQHRvMq2uYiN2DLgbYPoA/p yJV/v1WRBXrPPRXAb94JlAGD1zQbzECl8LibZ9WYkTunhHiVJqRaCPgrdLQABDzfuBSO6N+pjWxn kjMdwLfS7JLIvgm/LCkFbwJrnu+8vyq8W8BQj0FwcYeyTbcEqYSjMq+u7msXi7Kx/mzhkIyIqJdI zshNy/MGz19qCkKxHh53L46g5pIOBvwFItIm4TFRfTLcDwIDAQABoyMwITAOBgNVHQ8BAf8EBAMC AQYwDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOCAgEAXzSBdu+WHdXltdkCY4QWwa6g cFGn90xHNcgL1yg9iXHZqjNB6hQbbCEAwGxCGX6faVsgQt+i0trEfJdLjbDorMjupWkEmQqSpqsn LhpNgb+E1HAerUf+/UqdM+DyucRFCCEK2mlpc3INvjT+lIutwx4116KD7+U4x6WFH6vPNOw/KP4M 8VeGTslV9xzU2KV9Bnpv1d8Q34FOIWWxtuEXeZVFBs5fzNxGiWNoRI2T9GRwoD2dKAXDOXC4Ynsg /eTb6QihuJ49CcdP+yz4k3ZB3lLg4VfSnQO8d57+nile98FRYB/e2guyLXW3Q0iT5/Z5xoRdgFlg lPx4mI88k1HtQJAH32RjJMtOcQWh15QaiDLxInQirqWm2BJpTGCjAu4r7NRjkgtevi92a6O2JryP A9gK8kxkRr05YuWW6zRjESjMlfGt7+/cgFhI6Uu46mWs6fyAtbXIRfmswZ/ZuepiiI7E8UuDEq3m i4TWnsLrgxifarsbJGAzcMzs9zLzXNl5fe+epP7JI8Mk7hWSsT2RTyaGvWZzJBPqpK5jwa19hAM8 EHiGG3njxPPyBJUgriOCxLM6AGK/5jYk4Ve6xx6QddVfP5VhK8E7zeWzaGHQRiapIVJpLesux+t3 zqY6tQMzT3bR51xUAV3LePTJDL/PEo4XLSNolOer/qmyKwbQBM0= -----END CERTIFICATE----- TeliaSonera Root CA v1 ====================== -----BEGIN CERTIFICATE----- MIIFODCCAyCgAwIBAgIRAJW+FqD3LkbxezmCcvqLzZYwDQYJKoZIhvcNAQEFBQAwNzEUMBIGA1UE CgwLVGVsaWFTb25lcmExHzAdBgNVBAMMFlRlbGlhU29uZXJhIFJvb3QgQ0EgdjEwHhcNMDcxMDE4 MTIwMDUwWhcNMzIxMDE4MTIwMDUwWjA3MRQwEgYDVQQKDAtUZWxpYVNvbmVyYTEfMB0GA1UEAwwW VGVsaWFTb25lcmEgUm9vdCBDQSB2MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMK+ 6yfwIaPzaSZVfp3FVRaRXP3vIb9TgHot0pGMYzHw7CTww6XScnwQbfQ3t+XmfHnqjLWCi65ItqwA 3GV17CpNX8GH9SBlK4GoRz6JI5UwFpB/6FcHSOcZrr9FZ7E3GwYq/t75rH2D+1665I+XZ75Ljo1k B1c4VWk0Nj0TSO9P4tNmHqTPGrdeNjPUtAa9GAH9d4RQAEX1jF3oI7x+/jXh7VB7qTCNGdMJjmhn Xb88lxhTuylixcpecsHHltTbLaC0H2kD7OriUPEMPPCs81Mt8Bz17Ww5OXOAFshSsCPN4D7c3TxH oLs1iuKYaIu+5b9y7tL6pe0S7fyYGKkmdtwoSxAgHNN/Fnct7W+A90m7UwW7XWjH1Mh1Fj+JWov3 F0fUTPHSiXk+TT2YqGHeOh7S+F4D4MHJHIzTjU3TlTazN19jY5szFPAtJmtTfImMMsJu7D0hADnJ oWjiUIMusDor8zagrC/kb2HCUQk5PotTubtn2txTuXZZNp1D5SDgPTJghSJRt8czu90VL6R4pgd7 gUY2BIbdeTXHlSw7sKMXNeVzH7RcWe/a6hBle3rQf5+ztCo3O3CLm1u5K7fsslESl1MpWtTwEhDc TwK7EpIvYtQ/aUN8Ddb8WHUBiJ1YFkveupD/RwGJBmr2X7KQarMCpgKIv7NHfirZ1fpoeDVNAgMB AAGjPzA9MA8GA1UdEwEB/wQFMAMBAf8wCwYDVR0PBAQDAgEGMB0GA1UdDgQWBBTwj1k4ALP1j5qW DNXr+nuqF+gTEjANBgkqhkiG9w0BAQUFAAOCAgEAvuRcYk4k9AwI//DTDGjkk0kiP0Qnb7tt3oNm zqjMDfz1mgbldxSR651Be5kqhOX//CHBXfDkH1e3damhXwIm/9fH907eT/j3HEbAek9ALCI18Bmx 0GtnLLCo4MBANzX2hFxc469CeP6nyQ1Q6g2EdvZR74NTxnr/DlZJLo961gzmJ1TjTQpgcmLNkQfW pb/ImWvtxBnmq0wROMVvMeJuScg/doAmAyYp4Db29iBT4xdwNBedY2gea+zDTYa4EzAvXUYNR0PV G6pZDrlcjQZIrXSHX8f8MVRBE+LHIQ6e4B4N4cB7Q4WQxYpYxmUKeFfyxiMPAdkgS94P+5KFdSpc c41teyWRyu5FrgZLAMzTsVlQ2jqIOylDRl6XK1TOU2+NSueW+r9xDkKLfP0ooNBIytrEgUy7onOT JsjrDNYmiLbAJM+7vVvrdX3pCI6GMyx5dwlppYn8s3CQh3aP0yK7Qs69cwsgJirQmz1wHiRszYd2 qReWt88NkvuOGKmYSdGe/mBEciG5Ge3C9THxOUiIkCR1VBatzvT4aRRkOfujuLpwQMcnHL/EVlP6 Y2XQ8xwOFvVrhlhNGNTkDY6lnVuR3HYkUD/GKvvZt5y11ubQ2egZixVxSK236thZiNSQvxaz2ems WWFUyBy6ysHK4bkgTI86k4mloMy/0/Z1pHWWbVY= -----END CERTIFICATE----- T-TeleSec GlobalRoot Class 2 ============================ -----BEGIN CERTIFICATE----- MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoM IlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBU cnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDIwHhcNMDgx MDAxMTA0MDE0WhcNMzMxMDAxMjM1OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lz dGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBD ZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDIwggEiMA0GCSqGSIb3 DQEBAQUAA4IBDwAwggEKAoIBAQCqX9obX+hzkeXaXPSi5kfl82hVYAUdAqSzm1nzHoqvNK38DcLZ SBnuaY/JIPwhqgcZ7bBcrGXHX+0CfHt8LRvWurmAwhiCFoT6ZrAIxlQjgeTNuUk/9k9uN0goOA/F vudocP05l03Sx5iRUKrERLMjfTlH6VJi1hKTXrcxlkIF+3anHqP1wvzpesVsqXFP6st4vGCvx970 2cu+fjOlbpSD8DT6IavqjnKgP6TeMFvvhk1qlVtDRKgQFRzlAVfFmPHmBiiRqiDFt1MmUUOyCxGV WOHAD3bZwI18gfNycJ5v/hqO2V81xrJvNHy+SE/iWjnX2J14np+GPgNeGYtEotXHAgMBAAGjQjBA MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS/WSA2AHmgoCJrjNXy YdK4LMuCSjANBgkqhkiG9w0BAQsFAAOCAQEAMQOiYQsfdOhyNsZt+U2e+iKo4YFWz827n+qrkRk4 r6p8FU3ztqONpfSO9kSpp+ghla0+AGIWiPACuvxhI+YzmzB6azZie60EI4RYZeLbK4rnJVM3YlNf vNoBYimipidx5joifsFvHZVwIEoHNN/q/xWA5brXethbdXwFeilHfkCoMRN3zUA7tFFHei4R40cR 3p1m0IvVVGb6g1XqfMIpiRvpb7PO4gWEyS8+eIVibslfwXhjdFjASBgMmTnrpMwatXlajRWc2BQN 9noHV8cigwUtPJslJj0Ys6lDfMjIq2SPDqO/nBudMNva0Bkuqjzx+zOAduTNrRlPBSeOE6Fuwg== -----END CERTIFICATE----- Atos TrustedRoot 2011 ===================== -----BEGIN CERTIFICATE----- MIIDdzCCAl+gAwIBAgIIXDPLYixfszIwDQYJKoZIhvcNAQELBQAwPDEeMBwGA1UEAwwVQXRvcyBU cnVzdGVkUm9vdCAyMDExMQ0wCwYDVQQKDARBdG9zMQswCQYDVQQGEwJERTAeFw0xMTA3MDcxNDU4 MzBaFw0zMDEyMzEyMzU5NTlaMDwxHjAcBgNVBAMMFUF0b3MgVHJ1c3RlZFJvb3QgMjAxMTENMAsG A1UECgwEQXRvczELMAkGA1UEBhMCREUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCV hTuXbyo7LjvPpvMpNb7PGKw+qtn4TaA+Gke5vJrf8v7MPkfoepbCJI419KkM/IL9bcFyYie96mvr 54rMVD6QUM+A1JX76LWC1BTFtqlVJVfbsVD2sGBkWXppzwO3bw2+yj5vdHLqqjAqc2K+SZFhyBH+ DgMq92og3AIVDV4VavzjgsG1xZ1kCWyjWZgHJ8cblithdHFsQ/H3NYkQ4J7sVaE3IqKHBAUsR320 HLliKWYoyrfhk/WklAOZuXCFteZI6o1Q/NnezG8HDt0Lcp2AMBYHlT8oDv3FdU9T1nSatCQujgKR z3bFmx5VdJx4IbHwLfELn8LVlhgf8FQieowHAgMBAAGjfTB7MB0GA1UdDgQWBBSnpQaxLKYJYO7R l+lwrrw7GWzbITAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFKelBrEspglg7tGX6XCuvDsZ bNshMBgGA1UdIAQRMA8wDQYLKwYBBAGwLQMEAQEwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEB CwUAA4IBAQAmdzTblEiGKkGdLD4GkGDEjKwLVLgfuXvTBznk+j57sj1O7Z8jvZfza1zv7v1Apt+h k6EKhqzvINB5Ab149xnYJDE0BAGmuhWawyfc2E8PzBhj/5kPDpFrdRbhIfzYJsdHt6bPWHJxfrrh TZVHO8mvbaG0weyJ9rQPOLXiZNwlz6bb65pcmaHFCN795trV1lpFDMS3wrUU77QR/w4VtfX128a9 61qn8FYiqTxlVMYVqL2Gns2Dlmh6cYGJ4Qvh6hEbaAjMaZ7snkGeRDImeuKHCnE96+RapNLbxc3G 3mB/ufNPRJLvKrcYPqcZ2Qt9sTdBQrC6YB3y/gkRsPCHe6ed -----END CERTIFICATE----- QuoVadis Root CA 1 G3 ===================== -----BEGIN CERTIFICATE----- MIIFYDCCA0igAwIBAgIUeFhfLq0sGUvjNwc1NBMotZbUZZMwDQYJKoZIhvcNAQELBQAwSDELMAkG A1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAcBgNVBAMTFVF1b1ZhZGlzIFJv b3QgQ0EgMSBHMzAeFw0xMjAxMTIxNzI3NDRaFw00MjAxMTIxNzI3NDRaMEgxCzAJBgNVBAYTAkJN MRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDEg RzMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCgvlAQjunybEC0BJyFuTHK3C3kEakE PBtVwedYMB0ktMPvhd6MLOHBPd+C5k+tR4ds7FtJwUrVu4/sh6x/gpqG7D0DmVIB0jWerNrwU8lm PNSsAgHaJNM7qAJGr6Qc4/hzWHa39g6QDbXwz8z6+cZM5cOGMAqNF34168Xfuw6cwI2H44g4hWf6 Pser4BOcBRiYz5P1sZK0/CPTz9XEJ0ngnjybCKOLXSoh4Pw5qlPafX7PGglTvF0FBM+hSo+LdoIN ofjSxxR3W5A2B4GbPgb6Ul5jxaYA/qXpUhtStZI5cgMJYr2wYBZupt0lwgNm3fME0UDiTouG9G/l g6AnhF4EwfWQvTA9xO+oabw4m6SkltFi2mnAAZauy8RRNOoMqv8hjlmPSlzkYZqn0ukqeI1RPToV 7qJZjqlc3sX5kCLliEVx3ZGZbHqfPT2YfF72vhZooF6uCyP8Wg+qInYtyaEQHeTTRCOQiJ/GKubX 9ZqzWB4vMIkIG1SitZgj7Ah3HJVdYdHLiZxfokqRmu8hqkkWCKi9YSgxyXSthfbZxbGL0eUQMk1f iyA6PEkfM4VZDdvLCXVDaXP7a3F98N/ETH3Goy7IlXnLc6KOTk0k+17kBL5yG6YnLUlamXrXXAkg t3+UuU/xDRxeiEIbEbfnkduebPRq34wGmAOtzCjvpUfzUwIDAQABo0IwQDAPBgNVHRMBAf8EBTAD AQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUo5fW816iEOGrRZ88F2Q87gFwnMwwDQYJKoZI hvcNAQELBQADggIBABj6W3X8PnrHX3fHyt/PX8MSxEBd1DKquGrX1RUVRpgjpeaQWxiZTOOtQqOC MTaIzen7xASWSIsBx40Bz1szBpZGZnQdT+3Btrm0DWHMY37XLneMlhwqI2hrhVd2cDMT/uFPpiN3 GPoajOi9ZcnPP/TJF9zrx7zABC4tRi9pZsMbj/7sPtPKlL92CiUNqXsCHKnQO18LwIE6PWThv6ct Tr1NxNgpxiIY0MWscgKCP6o6ojoilzHdCGPDdRS5YCgtW2jgFqlmgiNR9etT2DGbe+m3nUvriBbP +V04ikkwj+3x6xn0dxoxGE1nVGwvb2X52z3sIexe9PSLymBlVNFxZPT5pqOBMzYzcfCkeF9OrYMh 3jRJjehZrJ3ydlo28hP0r+AJx2EqbPfgna67hkooby7utHnNkDPDs3b69fBsnQGQ+p6Q9pxyz0fa wx/kNSBT8lTR32GDpgLiJTjehTItXnOQUl1CxM49S+H5GYQd1aJQzEH7QRTDvdbJWqNjZgKAvQU6 O0ec7AAmTPWIUb+oI38YB7AL7YsmoWTTYUrrXJ/es69nA7Mf3W1daWhpq1467HxpvMc7hU6eFbm0 FU/DlXpY18ls6Wy58yljXrQs8C097Vpl4KlbQMJImYFtnh8GKjwStIsPm6Ik8KaN1nrgS7ZklmOV hMJKzRwuJIczYOXD -----END CERTIFICATE----- QuoVadis Root CA 2 G3 ===================== -----BEGIN CERTIFICATE----- MIIFYDCCA0igAwIBAgIURFc0JFuBiZs18s64KztbpybwdSgwDQYJKoZIhvcNAQELBQAwSDELMAkG A1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAcBgNVBAMTFVF1b1ZhZGlzIFJv b3QgQ0EgMiBHMzAeFw0xMjAxMTIxODU5MzJaFw00MjAxMTIxODU5MzJaMEgxCzAJBgNVBAYTAkJN MRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDIg RzMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQChriWyARjcV4g/Ruv5r+LrI3HimtFh ZiFfqq8nUeVuGxbULX1QsFN3vXg6YOJkApt8hpvWGo6t/x8Vf9WVHhLL5hSEBMHfNrMWn4rjyduY NM7YMxcoRvynyfDStNVNCXJJ+fKH46nafaF9a7I6JaltUkSs+L5u+9ymc5GQYaYDFCDy54ejiK2t oIz/pgslUiXnFgHVy7g1gQyjO/Dh4fxaXc6AcW34Sas+O7q414AB+6XrW7PFXmAqMaCvN+ggOp+o MiwMzAkd056OXbxMmO7FGmh77FOm6RQ1o9/NgJ8MSPsc9PG/Srj61YxxSscfrf5BmrODXfKEVu+l V0POKa2Mq1W/xPtbAd0jIaFYAI7D0GoT7RPjEiuA3GfmlbLNHiJuKvhB1PLKFAeNilUSxmn1uIZo L1NesNKqIcGY5jDjZ1XHm26sGahVpkUG0CM62+tlXSoREfA7T8pt9DTEceT/AFr2XK4jYIVz8eQQ sSWu1ZK7E8EM4DnatDlXtas1qnIhO4M15zHfeiFuuDIIfR0ykRVKYnLP43ehvNURG3YBZwjgQQvD 6xVu+KQZ2aKrr+InUlYrAoosFCT5v0ICvybIxo/gbjh9Uy3l7ZizlWNof/k19N+IxWA1ksB8aRxh lRbQ694Lrz4EEEVlWFA4r0jyWbYW8jwNkALGcC4BrTwV1wIDAQABo0IwQDAPBgNVHRMBAf8EBTAD AQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQU7edvdlq/YOxJW8ald7tyFnGbxD0wDQYJKoZI hvcNAQELBQADggIBAJHfgD9DCX5xwvfrs4iP4VGyvD11+ShdyLyZm3tdquXK4Qr36LLTn91nMX66 AarHakE7kNQIXLJgapDwyM4DYvmL7ftuKtwGTTwpD4kWilhMSA/ohGHqPHKmd+RCroijQ1h5fq7K pVMNqT1wvSAZYaRsOPxDMuHBR//47PERIjKWnML2W2mWeyAMQ0GaW/ZZGYjeVYg3UQt4XAoeo0L9 x52ID8DyeAIkVJOviYeIyUqAHerQbj5hLja7NQ4nlv1mNDthcnPxFlxHBlRJAHpYErAK74X9sbgz dWqTHBLmYF5vHX/JHyPLhGGfHoJE+V+tYlUkmlKY7VHnoX6XOuYvHxHaU4AshZ6rNRDbIl9qxV6X U/IyAgkwo1jwDQHVcsaxfGl7w/U2Rcxhbl5MlMVerugOXou/983g7aEOGzPuVBj+D77vfoRrQ+Nw mNtddbINWQeFFSM51vHfqSYP1kjHs6Yi9TM3WpVHn3u6GBVv/9YUZINJ0gpnIdsPNWNgKCLjsZWD zYWm3S8P52dSbrsvhXz1SnPnxT7AvSESBT/8twNJAlvIJebiVDj1eYeMHVOyToV7BjjHLPj4sHKN JeV3UvQDHEimUF+IIDBu8oJDqz2XhOdT+yHBTw8imoa4WSr2Rz0ZiC3oheGe7IUIarFsNMkd7Egr O3jtZsSOeWmD3n+M -----END CERTIFICATE----- QuoVadis Root CA 3 G3 ===================== -----BEGIN CERTIFICATE----- MIIFYDCCA0igAwIBAgIULvWbAiin23r/1aOp7r0DoM8Sah0wDQYJKoZIhvcNAQELBQAwSDELMAkG A1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAcBgNVBAMTFVF1b1ZhZGlzIFJv b3QgQ0EgMyBHMzAeFw0xMjAxMTIyMDI2MzJaFw00MjAxMTIyMDI2MzJaMEgxCzAJBgNVBAYTAkJN MRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDMg RzMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCzyw4QZ47qFJenMioKVjZ/aEzHs286 IxSR/xl/pcqs7rN2nXrpixurazHb+gtTTK/FpRp5PIpM/6zfJd5O2YIyC0TeytuMrKNuFoM7pmRL Mon7FhY4futD4tN0SsJiCnMK3UmzV9KwCoWdcTzeo8vAMvMBOSBDGzXRU7Ox7sWTaYI+FrUoRqHe 6okJ7UO4BUaKhvVZR74bbwEhELn9qdIoyhA5CcoTNs+cra1AdHkrAj80//ogaX3T7mH1urPnMNA3 I4ZyYUUpSFlob3emLoG+B01vr87ERRORFHAGjx+f+IdpsQ7vw4kZ6+ocYfx6bIrc1gMLnia6Et3U VDmrJqMz6nWB2i3ND0/kA9HvFZcba5DFApCTZgIhsUfei5pKgLlVj7WiL8DWM2fafsSntARE60f7 5li59wzweyuxwHApw0BiLTtIadwjPEjrewl5qW3aqDCYz4ByA4imW0aucnl8CAMhZa634RylsSqi Md5mBPfAdOhx3v89WcyWJhKLhZVXGqtrdQtEPREoPHtht+KPZ0/l7DxMYIBpVzgeAVuNVejH38DM dyM0SXV89pgR6y3e7UEuFAUCf+D+IOs15xGsIs5XPd7JMG0QA4XN8f+MFrXBsj6IbGB/kE+V9/Yt rQE5BwT6dYB9v0lQ7e/JxHwc64B+27bQ3RP+ydOc17KXqQIDAQABo0IwQDAPBgNVHRMBAf8EBTAD AQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUxhfQvKjqAkPyGwaZXSuQILnXnOQwDQYJKoZI hvcNAQELBQADggIBADRh2Va1EodVTd2jNTFGu6QHcrxfYWLopfsLN7E8trP6KZ1/AvWkyaiTt3px KGmPc+FSkNrVvjrlt3ZqVoAh313m6Tqe5T72omnHKgqwGEfcIHB9UqM+WXzBusnIFUBhynLWcKzS t/Ac5IYp8M7vaGPQtSCKFWGafoaYtMnCdvvMujAWzKNhxnQT5WvvoxXqA/4Ti2Tk08HS6IT7SdEQ TXlm66r99I0xHnAUrdzeZxNMgRVhvLfZkXdxGYFgu/BYpbWcC/ePIlUnwEsBbTuZDdQdm2NnL9Du DcpmvJRPpq3t/O5jrFc/ZSXPsoaP0Aj/uHYUbt7lJ+yreLVTubY/6CD50qi+YUbKh4yE8/nxoGib Ih6BJpsQBJFxwAYf3KDTuVan45gtf4Od34wrnDKOMpTwATwiKp9Dwi7DmDkHOHv8XgBCH/MyJnmD hPbl8MFREsALHgQjDFSlTC9JxUrRtm5gDWv8a4uFJGS3iQ6rJUdbPM9+Sb3H6QrG2vd+DhcI00iX 0HGS8A85PjRqHH3Y8iKuu2n0M7SmSFXRDw4m6Oy2Cy2nhTXN/VnIn9HNPlopNLk9hM6xZdRZkZFW dSHBd575euFgndOtBBj0fOtek49TSiIp+EgrPk2GrFt/ywaZWWDYWGWVjUTR939+J399roD1B0y2 PpxxVJkES/1Y+Zj0 -----END CERTIFICATE----- DigiCert Assured ID Root G2 =========================== -----BEGIN CERTIFICATE----- MIIDljCCAn6gAwIBAgIQC5McOtY5Z+pnI7/Dr5r0SzANBgkqhkiG9w0BAQsFADBlMQswCQYDVQQG EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSQw IgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzIwHhcNMTMwODAxMTIwMDAwWhcNMzgw MTE1MTIwMDAwWjBlMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQL ExB3d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzIw ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDZ5ygvUj82ckmIkzTz+GoeMVSAn61UQbVH 35ao1K+ALbkKz3X9iaV9JPrjIgwrvJUXCzO/GU1BBpAAvQxNEP4HteccbiJVMWWXvdMX0h5i89vq bFCMP4QMls+3ywPgym2hFEwbid3tALBSfK+RbLE4E9HpEgjAALAcKxHad3A2m67OeYfcgnDmCXRw VWmvo2ifv922ebPynXApVfSr/5Vh88lAbx3RvpO704gqu52/clpWcTs/1PPRCv4o76Pu2ZmvA9OP YLfykqGxvYmJHzDNw6YuYjOuFgJ3RFrngQo8p0Quebg/BLxcoIfhG69Rjs3sLPr4/m3wOnyqi+Rn lTGNAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBTO w0q5mVXyuNtgv6l+vVa1lzan1jANBgkqhkiG9w0BAQsFAAOCAQEAyqVVjOPIQW5pJ6d1Ee88hjZv 0p3GeDgdaZaikmkuOGybfQTUiaWxMTeKySHMq2zNixya1r9I0jJmwYrA8y8678Dj1JGG0VDjA9tz d29KOVPt3ibHtX2vK0LRdWLjSisCx1BL4GnilmwORGYQRI+tBev4eaymG+g3NJ1TyWGqolKvSnAW hsI6yLETcDbYz+70CjTVW0z9B5yiutkBclzzTcHdDrEcDcRjvq30FPuJ7KJBDkzMyFdA0G4Dqs0M jomZmWzwPDCvON9vvKO+KSAnq3T/EyJ43pdSVR6DtVQgA+6uwE9W3jfMw3+qBCe703e4YtsXfJwo IhNzbM8m9Yop5w== -----END CERTIFICATE----- DigiCert Assured ID Root G3 =========================== -----BEGIN CERTIFICATE----- MIICRjCCAc2gAwIBAgIQC6Fa+h3foLVJRK/NJKBs7DAKBggqhkjOPQQDAzBlMQswCQYDVQQGEwJV UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSQwIgYD VQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzMwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1 MTIwMDAwWjBlMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzMwdjAQ BgcqhkjOPQIBBgUrgQQAIgNiAAQZ57ysRGXtzbg/WPuNsVepRC0FFfLvC/8QdJ+1YlJfZn4f5dwb RXkLzMZTCp2NXQLZqVneAlr2lSoOjThKiknGvMYDOAdfVdp+CW7if17QRSAPWXYQ1qAk8C3eNvJs KTmjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBTL0L2p4ZgF UaFNN6KDec6NHSrkhDAKBggqhkjOPQQDAwNnADBkAjAlpIFFAmsSS3V0T8gj43DydXLefInwz5Fy YZ5eEJJZVrmDxxDnOOlYJjZ91eQ0hjkCMHw2U/Aw5WJjOpnitqM7mzT6HtoQknFekROn3aRukswy 1vUhZscv6pZjamVFkpUBtA== -----END CERTIFICATE----- DigiCert Global Root G2 ======================= -----BEGIN CERTIFICATE----- MIIDjjCCAnagAwIBAgIQAzrx5qcRqaC7KGSxHQn65TANBgkqhkiG9w0BAQsFADBhMQswCQYDVQQG EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSAw HgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBHMjAeFw0xMzA4MDExMjAwMDBaFw0zODAxMTUx MjAwMDBaMGExCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3 dy5kaWdpY2VydC5jb20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEcyMIIBIjANBgkq hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuzfNNNx7a8myaJCtSnX/RrohCgiN9RlUyfuI2/Ou8jqJ kTx65qsGGmvPrC3oXgkkRLpimn7Wo6h+4FR1IAWsULecYxpsMNzaHxmx1x7e/dfgy5SDN67sH0NO 3Xss0r0upS/kqbitOtSZpLYl6ZtrAGCSYP9PIUkY92eQq2EGnI/yuum06ZIya7XzV+hdG82MHauV BJVJ8zUtluNJbd134/tJS7SsVQepj5WztCO7TG1F8PapspUwtP1MVYwnSlcUfIKdzXOS0xZKBgyM UNGPHgm+F6HmIcr9g+UQvIOlCsRnKPZzFBQ9RnbDhxSJITRNrw9FDKZJobq7nMWxM4MphQIDAQAB o0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUTiJUIBiV5uNu 5g/6+rkS7QYXjzkwDQYJKoZIhvcNAQELBQADggEBAGBnKJRvDkhj6zHd6mcY1Yl9PMWLSn/pvtsr F9+wX3N3KjITOYFnQoQj8kVnNeyIv/iPsGEMNKSuIEyExtv4NeF22d+mQrvHRAiGfzZ0JFrabA0U WTW98kndth/Jsw1HKj2ZL7tcu7XUIOGZX1NGFdtom/DzMNU+MeKNhJ7jitralj41E6Vf8PlwUHBH QRFXGU7Aj64GxJUTFy8bJZ918rGOmaFvE7FBcf6IKshPECBV1/MUReXgRPTqh5Uykw7+U0b6LJ3/ iyK5S9kJRaTepLiaWN0bfVKfjllDiIGknibVb63dDcY3fe0Dkhvld1927jyNxF1WW6LZZm6zNTfl MrY= -----END CERTIFICATE----- DigiCert Global Root G3 ======================= -----BEGIN CERTIFICATE----- MIICPzCCAcWgAwIBAgIQBVVWvPJepDU1w6QP1atFcjAKBggqhkjOPQQDAzBhMQswCQYDVQQGEwJV UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSAwHgYD VQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBHMzAeFw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAw MDBaMGExCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5k aWdpY2VydC5jb20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEczMHYwEAYHKoZIzj0C AQYFK4EEACIDYgAE3afZu4q4C/sLfyHS8L6+c/MzXRq8NOrexpu80JX28MzQC7phW1FGfp4tn+6O YwwX7Adw9c+ELkCDnOg/QW07rdOkFFk2eJ0DQ+4QE2xy3q6Ip6FrtUPOZ9wj/wMco+I+o0IwQDAP BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUs9tIpPmhxdiuNkHMEWNp Yim8S8YwCgYIKoZIzj0EAwMDaAAwZQIxAK288mw/EkrRLTnDCgmXc/SINoyIJ7vmiI1Qhadj+Z4y 3maTD/HMsQmP3Wyr+mt/oAIwOWZbwmSNuJ5Q3KjVSaLtx9zRSX8XAbjIho9OjIgrqJqpisXRAL34 VOKa5Vt8sycX -----END CERTIFICATE----- DigiCert Trusted Root G4 ======================== -----BEGIN CERTIFICATE----- MIIFkDCCA3igAwIBAgIQBZsbV56OITLiOQe9p3d1XDANBgkqhkiG9w0BAQwFADBiMQswCQYDVQQG EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSEw HwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1 MTIwMDAwWjBiMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwggIiMA0G CSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC/5pBzaN675F1KPDAiMGkz7MKnJS7JIT3yithZwuEp pz1Yq3aaza57G4QNxDAf8xukOBbrVsaXbR2rsnnyyhHS5F/WBTxSD1Ifxp4VpX6+n6lXFllVcq9o k3DCsrp1mWpzMpTREEQQLt+C8weE5nQ7bXHiLQwb7iDVySAdYyktzuxeTsiT+CFhmzTrBcZe7Fsa vOvJz82sNEBfsXpm7nfISKhmV1efVFiODCu3T6cw2Vbuyntd463JT17lNecxy9qTXtyOj4DatpGY QJB5w3jHtrHEtWoYOAMQjdjUN6QuBX2I9YI+EJFwq1WCQTLX2wRzKm6RAXwhTNS8rhsDdV14Ztk6 MUSaM0C/CNdaSaTC5qmgZ92kJ7yhTzm1EVgX9yRcRo9k98FpiHaYdj1ZXUJ2h4mXaXpI8OCiEhtm mnTK3kse5w5jrubU75KSOp493ADkRSWJtppEGSt+wJS00mFt6zPZxd9LBADMfRyVw4/3IbKyEbe7 f/LVjHAsQWCqsWMYRJUadmJ+9oCw++hkpjPRiQfhvbfmQ6QYuKZ3AeEPlAwhHbJUKSWJbOUOUlFH dL4mrLZBdd56rF+NP8m800ERElvlEFDrMcXKchYiCd98THU/Y+whX8QgUWtvsauGi0/C1kVfnSD8 oR7FwI+isX4KJpn15GkvmB0t9dmpsh3lGwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1Ud DwEB/wQEAwIBhjAdBgNVHQ4EFgQU7NfjgtJxXWRM3y5nP+e6mK4cD08wDQYJKoZIhvcNAQEMBQAD ggIBALth2X2pbL4XxJEbw6GiAI3jZGgPVs93rnD5/ZpKmbnJeFwMDF/k5hQpVgs2SV1EY+CtnJYY ZhsjDT156W1r1lT40jzBQ0CuHVD1UvyQO7uYmWlrx8GnqGikJ9yd+SeuMIW59mdNOj6PWTkiU0Tr yF0Dyu1Qen1iIQqAyHNm0aAFYF/opbSnr6j3bTWcfFqK1qI4mfN4i/RN0iAL3gTujJtHgXINwBQy 7zBZLq7gcfJW5GqXb5JQbZaNaHqasjYUegbyJLkJEVDXCLG4iXqEI2FCKeWjzaIgQdfRnGTZ6iah ixTXTBmyUEFxPT9NcCOGDErcgdLMMpSEDQgJlxxPwO5rIHQw0uA5NBCFIRUBCOhVMt5xSdkoF1BN 5r5N0XWs0Mr7QbhDparTwwVETyw2m+L64kW4I1NsBm9nVX9GtUw/bihaeSbSpKhil9Ie4u1Ki7wb /UdKDd9nZn6yW0HQO+T0O/QEY+nvwlQAUaCKKsnOeMzV6ocEGLPOr0mIr/OSmbaz5mEP0oUA51Aa 5BuVnRmhuZyxm7EAHu/QD09CbMkKvO5D+jpxpchNJqU1/YldvIViHTLSoCtU7ZpXwdv6EM8Zt4tK G48BtieVU+i2iW1bvGjUI+iLUaJW+fCmgKDWHrO8Dw9TdSmq6hN35N6MgSGtBxBHEa2HPQfRdbzP 82Z+ -----END CERTIFICATE----- COMODO RSA Certification Authority ================================== -----BEGIN CERTIFICATE----- MIIF2DCCA8CgAwIBAgIQTKr5yttjb+Af907YWwOGnTANBgkqhkiG9w0BAQwFADCBhTELMAkGA1UE BhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgG A1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNhdGlv biBBdXRob3JpdHkwHhcNMTAwMTE5MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMC R0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UE ChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNhdGlvbiBB dXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCR6FSS0gpWsawNJN3Fz0Rn dJkrN6N9I3AAcbxT38T6KhKPS38QVr2fcHK3YX/JSw8Xpz3jsARh7v8Rl8f0hj4K+j5c+ZPmNHrZ FGvnnLOFoIJ6dq9xkNfs/Q36nGz637CC9BR++b7Epi9Pf5l/tfxnQ3K9DADWietrLNPtj5gcFKt+ 5eNu/Nio5JIk2kNrYrhV/erBvGy2i/MOjZrkm2xpmfh4SDBF1a3hDTxFYPwyllEnvGfDyi62a+pG x8cgoLEfZd5ICLqkTqnyg0Y3hOvozIFIQ2dOciqbXL1MGyiKXCJ7tKuY2e7gUYPDCUZObT6Z+pUX 2nwzV0E8jVHtC7ZcryxjGt9XyD+86V3Em69FmeKjWiS0uqlWPc9vqv9JWL7wqP/0uK3pN/u6uPQL OvnoQ0IeidiEyxPx2bvhiWC4jChWrBQdnArncevPDt09qZahSL0896+1DSJMwBGB7FY79tOi4lu3 sgQiUpWAk2nojkxl8ZEDLXB0AuqLZxUpaVICu9ffUGpVRr+goyhhf3DQw6KqLCGqR84onAZFdr+C GCe01a60y1Dma/RMhnEw6abfFobg2P9A3fvQQoh/ozM6LlweQRGBY84YcWsr7KaKtzFcOmpH4MN5 WdYgGq/yapiqcrxXStJLnbsQ/LBMQeXtHT1eKJ2czL+zUdqnR+WEUwIDAQABo0IwQDAdBgNVHQ4E FgQUu69+Aj36pvE8hI6t7jiY7NkyMtQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8w DQYJKoZIhvcNAQEMBQADggIBAArx1UaEt65Ru2yyTUEUAJNMnMvlwFTPoCWOAvn9sKIN9SCYPBMt rFaisNZ+EZLpLrqeLppysb0ZRGxhNaKatBYSaVqM4dc+pBroLwP0rmEdEBsqpIt6xf4FpuHA1sj+ nq6PK7o9mfjYcwlYRm6mnPTXJ9OV2jeDchzTc+CiR5kDOF3VSXkAKRzH7JsgHAckaVd4sjn8OoSg tZx8jb8uk2IntznaFxiuvTwJaP+EmzzV1gsD41eeFPfR60/IvYcjt7ZJQ3mFXLrrkguhxuhoqEwW sRqZCuhTLJK7oQkYdQxlqHvLI7cawiiFwxv/0Cti76R7CZGYZ4wUAc1oBmpjIXUDgIiKboHGhfKp pC3n9KUkEEeDys30jXlYsQab5xoq2Z0B15R97QNKyvDb6KkBPvVWmckejkk9u+UJueBPSZI9FoJA zMxZxuY67RIuaTxslbH9qh17f4a+Hg4yRvv7E491f0yLS0Zj/gA0QHDBw7mh3aZw4gSzQbzpgJHq ZJx64SIDqZxubw5lT2yHh17zbqD5daWbQOhTsiedSrnAdyGN/4fy3ryM7xfft0kL0fJuMAsaDk52 7RH89elWsn2/x20Kk4yl0MC2Hb46TpSi125sC8KKfPog88Tk5c0NqMuRkrF8hey1FGlmDoLnzc7I LaZRfyHBNVOFBkpdn627G190 -----END CERTIFICATE----- USERTrust RSA Certification Authority ===================================== -----BEGIN CERTIFICATE----- MIIF3jCCA8agAwIBAgIQAf1tMPyjylGoG7xkDjUDLTANBgkqhkiG9w0BAQwFADCBiDELMAkGA1UE BhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQK ExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBSU0EgQ2VydGlmaWNh dGlvbiBBdXRob3JpdHkwHhcNMTAwMjAxMDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UE BhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQK ExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBSU0EgQ2VydGlmaWNh dGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCAEmUXNg7D2wiz 0KxXDXbtzSfTTK1Qg2HiqiBNCS1kCdzOiZ/MPans9s/B3PHTsdZ7NygRK0faOca8Ohm0X6a9fZ2j Y0K2dvKpOyuR+OJv0OwWIJAJPuLodMkYtJHUYmTbf6MG8YgYapAiPLz+E/CHFHv25B+O1ORRxhFn RghRy4YUVD+8M/5+bJz/Fp0YvVGONaanZshyZ9shZrHUm3gDwFA66Mzw3LyeTP6vBZY1H1dat//O +T23LLb2VN3I5xI6Ta5MirdcmrS3ID3KfyI0rn47aGYBROcBTkZTmzNg95S+UzeQc0PzMsNT79uq /nROacdrjGCT3sTHDN/hMq7MkztReJVni+49Vv4M0GkPGw/zJSZrM233bkf6c0Plfg6lZrEpfDKE Y1WJxA3Bk1QwGROs0303p+tdOmw1XNtB1xLaqUkL39iAigmTYo61Zs8liM2EuLE/pDkP2QKe6xJM lXzzawWpXhaDzLhn4ugTncxbgtNMs+1b/97lc6wjOy0AvzVVdAlJ2ElYGn+SNuZRkg7zJn0cTRe8 yexDJtC/QV9AqURE9JnnV4eeUB9XVKg+/XRjL7FQZQnmWEIuQxpMtPAlR1n6BB6T1CZGSlCBst6+ eLf8ZxXhyVeEHg9j1uliutZfVS7qXMYoCAQlObgOK6nyTJccBz8NUvXt7y+CDwIDAQABo0IwQDAd BgNVHQ4EFgQUU3m/WqorSs9UgOHYm8Cd8rIDZsswDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQF MAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAFzUfA3P9wF9QZllDHPFUp/L+M+ZBn8b2kMVn54CVVeW FPFSPCeHlCjtHzoBN6J2/FNQwISbxmtOuowhT6KOVWKR82kV2LyI48SqC/3vqOlLVSoGIG1VeCkZ 7l8wXEskEVX/JJpuXior7gtNn3/3ATiUFJVDBwn7YKnuHKsSjKCaXqeYalltiz8I+8jRRa8YFWSQ Eg9zKC7F4iRO/Fjs8PRF/iKz6y+O0tlFYQXBl2+odnKPi4w2r78NBc5xjeambx9spnFixdjQg3IM 8WcRiQycE0xyNN+81XHfqnHd4blsjDwSXWXavVcStkNr/+XeTWYRUc+ZruwXtuhxkYzeSf7dNXGi FSeUHM9h4ya7b6NnJSFd5t0dCy5oGzuCr+yDZ4XUmFF0sbmZgIn/f3gZXHlKYC6SQK5MNyosycdi yA5d9zZbyuAlJQG03RoHnHcAP9Dc1ew91Pq7P8yF1m9/qS3fuQL39ZeatTXaw2ewh0qpKJ4jjv9c J2vhsE/zB+4ALtRZh8tSQZXq9EfX7mRBVXyNWQKV3WKdwrnuWih0hKWbt5DHDAff9Yk2dDLWKMGw sAvgnEzDHNb842m1R0aBL6KCq9NjRHDEjf8tM7qtj3u1cIiuPhnPQCjY/MiQu12ZIvVS5ljFH4gx Q+6IHdfGjjxDah2nGN59PRbxYvnKkKj9 -----END CERTIFICATE----- USERTrust ECC Certification Authority ===================================== -----BEGIN CERTIFICATE----- MIICjzCCAhWgAwIBAgIQXIuZxVqUxdJxVt7NiYDMJjAKBggqhkjOPQQDAzCBiDELMAkGA1UEBhMC VVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVU aGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBFQ0MgQ2VydGlmaWNhdGlv biBBdXRob3JpdHkwHhcNMTAwMjAxMDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMC VVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVU aGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBFQ0MgQ2VydGlmaWNhdGlv biBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQarFRaqfloI+d61SRvU8Za2EurxtW2 0eZzca7dnNYMYf3boIkDuAUU7FfO7l0/4iGzzvfUinngo4N+LZfQYcTxmdwlkWOrfzCjtHDix6Ez nPO/LlxTsV+zfTJ/ijTjeXmjQjBAMB0GA1UdDgQWBBQ64QmG1M8ZwpZ2dEl23OA1xmNjmjAOBgNV HQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjA2Z6EWCNzklwBB HU6+4WMBzzuqQhFkoJ2UOQIReVx7Hfpkue4WQrO/isIJxOzksU0CMQDpKmFHjFJKS04YcPbWRNZu 9YO6bVi9JNlWSOrvxKJGgYhqOkbRqZtNyWHa0V1Xahg= -----END CERTIFICATE----- GlobalSign ECC Root CA - R5 =========================== -----BEGIN CERTIFICATE----- MIICHjCCAaSgAwIBAgIRYFlJ4CYuu1X5CneKcflK2GwwCgYIKoZIzj0EAwMwUDEkMCIGA1UECxMb R2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI1MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQD EwpHbG9iYWxTaWduMB4XDTEyMTExMzAwMDAwMFoXDTM4MDExOTAzMTQwN1owUDEkMCIGA1UECxMb R2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI1MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQD EwpHbG9iYWxTaWduMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAER0UOlvt9Xb/pOdEh+J8LttV7HpI6 SFkc8GIxLcB6KP4ap1yztsyX50XUWPrRd21DosCHZTQKH3rd6zwzocWdTaRvQZU4f8kehOvRnkmS h5SHDDqFSmafnVmTTZdhBoZKo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAd BgNVHQ4EFgQUPeYpSJvqB8ohREom3m7e0oPQn1kwCgYIKoZIzj0EAwMDaAAwZQIxAOVpEslu28Yx uglB4Zf4+/2a4n0Sye18ZNPLBSWLVtmg515dTguDnFt2KaAJJiFqYgIwcdK1j1zqO+F4CYWodZI7 yFz9SO8NdCKoCOJuxUnOxwy8p2Fp8fc74SrL+SvzZpA3 -----END CERTIFICATE----- IdenTrust Commercial Root CA 1 ============================== -----BEGIN CERTIFICATE----- MIIFYDCCA0igAwIBAgIQCgFCgAAAAUUjyES1AAAAAjANBgkqhkiG9w0BAQsFADBKMQswCQYDVQQG EwJVUzESMBAGA1UEChMJSWRlblRydXN0MScwJQYDVQQDEx5JZGVuVHJ1c3QgQ29tbWVyY2lhbCBS b290IENBIDEwHhcNMTQwMTE2MTgxMjIzWhcNMzQwMTE2MTgxMjIzWjBKMQswCQYDVQQGEwJVUzES MBAGA1UEChMJSWRlblRydXN0MScwJQYDVQQDEx5JZGVuVHJ1c3QgQ29tbWVyY2lhbCBSb290IENB IDEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCnUBneP5k91DNG8W9RYYKyqU+PZ4ld hNlT3Qwo2dfw/66VQ3KZ+bVdfIrBQuExUHTRgQ18zZshq0PirK1ehm7zCYofWjK9ouuU+ehcCuz/ mNKvcbO0U59Oh++SvL3sTzIwiEsXXlfEU8L2ApeN2WIrvyQfYo3fw7gpS0l4PJNgiCL8mdo2yMKi 1CxUAGc1bnO/AljwpN3lsKImesrgNqUZFvX9t++uP0D1bVoE/c40yiTcdCMbXTMTEl3EASX2MN0C XZ/g1Ue9tOsbobtJSdifWwLziuQkkORiT0/Br4sOdBeo0XKIanoBScy0RnnGF7HamB4HWfp1IYVl 3ZBWzvurpWCdxJ35UrCLvYf5jysjCiN2O/cz4ckA82n5S6LgTrx+kzmEB/dEcH7+B1rlsazRGMzy NeVJSQjKVsk9+w8YfYs7wRPCTY/JTw436R+hDmrfYi7LNQZReSzIJTj0+kuniVyc0uMNOYZKdHzV WYfCP04MXFL0PfdSgvHqo6z9STQaKPNBiDoT7uje/5kdX7rL6B7yuVBgwDHTc+XvvqDtMwt0viAg xGds8AgDelWAf0ZOlqf0Hj7h9tgJ4TNkK2PXMl6f+cB7D3hvl7yTmvmcEpB4eoCHFddydJxVdHix uuFucAS6T6C6aMN7/zHwcz09lCqxC0EOoP5NiGVreTO01wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMC AQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU7UQZwNPwBovupHu+QucmVMiONnYwDQYJKoZI hvcNAQELBQADggIBAA2ukDL2pkt8RHYZYR4nKM1eVO8lvOMIkPkp165oCOGUAFjvLi5+U1KMtlwH 6oi6mYtQlNeCgN9hCQCTrQ0U5s7B8jeUeLBfnLOic7iPBZM4zY0+sLj7wM+x8uwtLRvM7Kqas6pg ghstO8OEPVeKlh6cdbjTMM1gCIOQ045U8U1mwF10A0Cj7oV+wh93nAbowacYXVKV7cndJZ5t+qnt ozo00Fl72u1Q8zW/7esUTTHHYPTa8Yec4kjixsU3+wYQ+nVZZjFHKdp2mhzpgq7vmrlR94gjmmmV YjzlVYA211QC//G5Xc7UI2/YRYRKW2XviQzdFKcgyxilJbQN+QHwotL0AMh0jqEqSI5l2xPE4iUX feu+h1sXIFRRk0pTAwvsXcoz7WL9RccvW9xYoIA55vrX/hMUpu09lEpCdNTDd1lzzY9GvlU47/ro kTLql1gEIt44w8y8bckzOmoKaT+gyOpyj4xjhiO9bTyWnpXgSUyqorkqG5w2gXjtw+hG4iZZRHUe 2XWJUc0QhJ1hYMtd+ZciTY6Y5uN/9lu7rs3KSoFrXgvzUeF0K+l+J6fZmUlO+KWA2yUPHGNiiskz Z2s8EIPGrd6ozRaOjfAHN3Gf8qv8QfXBi+wAN10J5U6A7/qxXDgGpRtK4dw4LTzcqx+QGtVKnO7R cGzM7vRX+Bi6hG6H -----END CERTIFICATE----- IdenTrust Public Sector Root CA 1 ================================= -----BEGIN CERTIFICATE----- MIIFZjCCA06gAwIBAgIQCgFCgAAAAUUjz0Z8AAAAAjANBgkqhkiG9w0BAQsFADBNMQswCQYDVQQG EwJVUzESMBAGA1UEChMJSWRlblRydXN0MSowKAYDVQQDEyFJZGVuVHJ1c3QgUHVibGljIFNlY3Rv ciBSb290IENBIDEwHhcNMTQwMTE2MTc1MzMyWhcNMzQwMTE2MTc1MzMyWjBNMQswCQYDVQQGEwJV UzESMBAGA1UEChMJSWRlblRydXN0MSowKAYDVQQDEyFJZGVuVHJ1c3QgUHVibGljIFNlY3RvciBS b290IENBIDEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC2IpT8pEiv6EdrCvsnduTy P4o7ekosMSqMjbCpwzFrqHd2hCa2rIFCDQjrVVi7evi8ZX3yoG2LqEfpYnYeEe4IFNGyRBb06tD6 Hi9e28tzQa68ALBKK0CyrOE7S8ItneShm+waOh7wCLPQ5CQ1B5+ctMlSbdsHyo+1W/CD80/HLaXI rcuVIKQxKFdYWuSNG5qrng0M8gozOSI5Cpcu81N3uURF/YTLNiCBWS2ab21ISGHKTN9T0a9SvESf qy9rg3LvdYDaBjMbXcjaY8ZNzaxmMc3R3j6HEDbhuaR672BQssvKplbgN6+rNBM5Jeg5ZuSYeqoS mJxZZoY+rfGwyj4GD3vwEUs3oERte8uojHH01bWRNszwFcYr3lEXsZdMUD2xlVl8BX0tIdUAvwFn ol57plzy9yLxkA2T26pEUWbMfXYD62qoKjgZl3YNa4ph+bz27nb9cCvdKTz4Ch5bQhyLVi9VGxyh LrXHFub4qjySjmm2AcG1hp2JDws4lFTo6tyePSW8Uybt1as5qsVATFSrsrTZ2fjXctscvG29ZV/v iDUqZi/u9rNl8DONfJhBaUYPQxxp+pu10GFqzcpL2UyQRqsVWaFHVCkugyhfHMKiq3IXAAaOReyL 4jM9f9oZRORicsPfIsbyVtTdX5Vy7W1f90gDW/3FKqD2cyOEEBsB5wIDAQABo0IwQDAOBgNVHQ8B Af8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU43HgntinQtnbcZFrlJPrw6PRFKMw DQYJKoZIhvcNAQELBQADggIBAEf63QqwEZE4rU1d9+UOl1QZgkiHVIyqZJnYWv6IAcVYpZmxI1Qj t2odIFflAWJBF9MJ23XLblSQdf4an4EKwt3X9wnQW3IV5B4Jaj0z8yGa5hV+rVHVDRDtfULAj+7A mgjVQdZcDiFpboBhDhXAuM/FSRJSzL46zNQuOAXeNf0fb7iAaJg9TaDKQGXSc3z1i9kKlT/YPyNt GtEqJBnZhbMX73huqVjRI9PHE+1yJX9dsXNw0H8GlwmEKYBhHfpe/3OsoOOJuBxxFcbeMX8S3OFt m6/n6J91eEyrRjuazr8FGF1NFTwWmhlQBJqymm9li1JfPFgEKCXAZmExfrngdbkaqIHWchezxQMx NRF4eKLg6TCMf4DfWN88uieW4oA0beOY02QnrEh+KHdcxiVhJfiFDGX6xDIvpZgF5PgLZxYWxoK4 Mhn5+bl53B/N66+rDt0b20XkeucC4pVd/GnwU2lhlXV5C15V5jgclKlZM57IcXR5f1GJtshquDDI ajjDbp7hNxbqBWJMWxJH7ae0s1hWx0nzfxJoCTFx8G34Tkf71oXuxVhAGaQdp/lLQzfcaFpPz+vC ZHTetBXZ9FRUGi8c15dxVJCO2SCdUyt/q4/i6jC8UDfv8Ue1fXwsBOxonbRJRBD0ckscZOf85muQ 3Wl9af0AVqW3rLatt8o+Ae+c -----END CERTIFICATE----- Entrust Root Certification Authority - G2 ========================================= -----BEGIN CERTIFICATE----- MIIEPjCCAyagAwIBAgIESlOMKDANBgkqhkiG9w0BAQsFADCBvjELMAkGA1UEBhMCVVMxFjAUBgNV BAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50cnVzdC5uZXQvbGVnYWwtdGVy bXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3QsIEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ug b25seTEyMDAGA1UEAxMpRW50cnVzdCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRzIw HhcNMDkwNzA3MTcyNTU0WhcNMzAxMjA3MTc1NTU0WjCBvjELMAkGA1UEBhMCVVMxFjAUBgNVBAoT DUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50cnVzdC5uZXQvbGVnYWwtdGVybXMx OTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3QsIEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25s eTEyMDAGA1UEAxMpRW50cnVzdCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRzIwggEi MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC6hLZy254Ma+KZ6TABp3bqMriVQRrJ2mFOWHLP /vaCeb9zYQYKpSfYs1/TRU4cctZOMvJyig/3gxnQaoCAAEUesMfnmr8SVycco2gvCoe9amsOXmXz HHfV1IWNcCG0szLni6LVhjkCsbjSR87kyUnEO6fe+1R9V77w6G7CebI6C1XiUJgWMhNcL3hWwcKU s/Ja5CeanyTXxuzQmyWC48zCxEXFjJd6BmsqEZ+pCm5IO2/b1BEZQvePB7/1U1+cPvQXLOZprE4y TGJ36rfo5bs0vBmLrpxR57d+tVOxMyLlbc9wPBr64ptntoP0jaWvYkxN4FisZDQSA/i2jZRjJKRx AgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqciZ6 0B7vfec7aVHUbI2fkBJmqzANBgkqhkiG9w0BAQsFAAOCAQEAeZ8dlsa2eT8ijYfThwMEYGprmi5Z iXMRrEPR9RP/jTkrwPK9T3CMqS/qF8QLVJ7UG5aYMzyorWKiAHarWWluBh1+xLlEjZivEtRh2woZ Rkfz6/djwUAFQKXSt/S1mja/qYh2iARVBCuch38aNzx+LaUa2NSJXsq9rD1s2G2v1fN2D807iDgi nWyTmsQ9v4IbZT+mD12q/OWyFcq1rca8PdCE6OoGcrBNOTJ4vz4RnAuknZoh8/CbCzB428Hch0P+ vGOaysXCHMnHjf87ElgI5rY97HosTvuDls4MPGmHVHOkc8KT/1EQrBVUAdj8BbGJoX90g5pJ19xO e4pIb4tF9g== -----END CERTIFICATE----- Entrust Root Certification Authority - EC1 ========================================== -----BEGIN CERTIFICATE----- MIIC+TCCAoCgAwIBAgINAKaLeSkAAAAAUNCR+TAKBggqhkjOPQQDAzCBvzELMAkGA1UEBhMCVVMx FjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50cnVzdC5uZXQvbGVn YWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDEyIEVudHJ1c3QsIEluYy4gLSBmb3IgYXV0aG9yaXpl ZCB1c2Ugb25seTEzMDEGA1UEAxMqRW50cnVzdCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5 IC0gRUMxMB4XDTEyMTIxODE1MjUzNloXDTM3MTIxODE1NTUzNlowgb8xCzAJBgNVBAYTAlVTMRYw FAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1c3QubmV0L2xlZ2Fs LXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxMiBFbnRydXN0LCBJbmMuIC0gZm9yIGF1dGhvcml6ZWQg dXNlIG9ubHkxMzAxBgNVBAMTKkVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAt IEVDMTB2MBAGByqGSM49AgEGBSuBBAAiA2IABIQTydC6bUF74mzQ61VfZgIaJPRbiWlH47jCffHy AsWfoPZb1YsGGYZPUxBtByQnoaD41UcZYUx9ypMn6nQM72+WCf5j7HBdNq1nd67JnXxVRDqiY1Ef 9eNi1KlHBz7MIKNCMEAwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYE FLdj5xrdjekIplWDpOBqUEFlEUJJMAoGCCqGSM49BAMDA2cAMGQCMGF52OVCR98crlOZF7ZvHH3h vxGU0QOIdeSNiaSKd0bebWHvAvX7td/M/k7//qnmpwIwW5nXhTcGtXsI/esni0qU+eH6p44mCOh8 kmhtc9hvJqwhAriZtyZBWyVgrtBIGu4G -----END CERTIFICATE----- CFCA EV ROOT ============ -----BEGIN CERTIFICATE----- MIIFjTCCA3WgAwIBAgIEGErM1jANBgkqhkiG9w0BAQsFADBWMQswCQYDVQQGEwJDTjEwMC4GA1UE CgwnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRUwEwYDVQQDDAxDRkNB IEVWIFJPT1QwHhcNMTIwODA4MDMwNzAxWhcNMjkxMjMxMDMwNzAxWjBWMQswCQYDVQQGEwJDTjEw MC4GA1UECgwnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRUwEwYDVQQD DAxDRkNBIEVWIFJPT1QwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDXXWvNED8fBVnV BU03sQ7smCuOFR36k0sXgiFxEFLXUWRwFsJVaU2OFW2fvwwbwuCjZ9YMrM8irq93VCpLTIpTUnrD 7i7es3ElweldPe6hL6P3KjzJIx1qqx2hp/Hz7KDVRM8Vz3IvHWOX6Jn5/ZOkVIBMUtRSqy5J35DN uF++P96hyk0g1CXohClTt7GIH//62pCfCqktQT+x8Rgp7hZZLDRJGqgG16iI0gNyejLi6mhNbiyW ZXvKWfry4t3uMCz7zEasxGPrb382KzRzEpR/38wmnvFyXVBlWY9ps4deMm/DGIq1lY+wejfeWkU7 xzbh72fROdOXW3NiGUgthxwG+3SYIElz8AXSG7Ggo7cbcNOIabla1jj0Ytwli3i/+Oh+uFzJlU9f py25IGvPa931DfSCt/SyZi4QKPaXWnuWFo8BGS1sbn85WAZkgwGDg8NNkt0yxoekN+kWzqotaK8K gWU6cMGbrU1tVMoqLUuFG7OA5nBFDWteNfB/O7ic5ARwiRIlk9oKmSJgamNgTnYGmE69g60dWIol hdLHZR4tjsbftsbhf4oEIRUpdPA+nJCdDC7xij5aqgwJHsfVPKPtl8MeNPo4+QgO48BdK4PRVmrJ tqhUUy54Mmc9gn900PvhtgVguXDbjgv5E1hvcWAQUhC5wUEJ73IfZzF4/5YFjQIDAQABo2MwYTAf BgNVHSMEGDAWgBTj/i39KNALtbq2osS/BqoFjJP7LzAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB /wQEAwIBBjAdBgNVHQ4EFgQU4/4t/SjQC7W6tqLEvwaqBYyT+y8wDQYJKoZIhvcNAQELBQADggIB ACXGumvrh8vegjmWPfBEp2uEcwPenStPuiB/vHiyz5ewG5zz13ku9Ui20vsXiObTej/tUxPQ4i9q ecsAIyjmHjdXNYmEwnZPNDatZ8POQQaIxffu2Bq41gt/UP+TqhdLjOztUmCypAbqTuv0axn96/Ua 4CUqmtzHQTb3yHQFhDmVOdYLO6Qn+gjYXB74BGBSESgoA//vU2YApUo0FmZ8/Qmkrp5nGm9BC2sG E5uPhnEFtC+NiWYzKXZUmhH4J/qyP5Hgzg0b8zAarb8iXRvTvyUFTeGSGn+ZnzxEk8rUQElsgIfX BDrDMlI1Dlb4pd19xIsNER9Tyx6yF7Zod1rg1MvIB671Oi6ON7fQAUtDKXeMOZePglr4UeWJoBjn aH9dCi77o0cOPaYjesYBx4/IXr9tgFa+iiS6M+qf4TIRnvHST4D2G0CvOJ4RUHlzEhLN5mydLIhy PDCBBpEi6lmt2hkuIsKNuYyH4Ga8cyNfIWRjgEj1oDwYPZTISEEdQLpe/v5WOaHIz16eGWRGENoX kbcFgKyLmZJ956LYBws2J+dIeWCKw9cTXPhyQN9Ky8+ZAAoACxGV2lZFA4gKn2fQ1XmxqI1AbQ3C ekD6819kR5LLU7m7Wc5P/dAVUwHY3+vZ5nbv0CO7O6l5s9UCKc2Jo5YPSjXnTkLAdc0Hz+Ys63su -----END CERTIFICATE----- OISTE WISeKey Global Root GB CA =============================== -----BEGIN CERTIFICATE----- MIIDtTCCAp2gAwIBAgIQdrEgUnTwhYdGs/gjGvbCwDANBgkqhkiG9w0BAQsFADBtMQswCQYDVQQG EwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUgRm91bmRhdGlvbiBFbmRvcnNl ZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9iYWwgUm9vdCBHQiBDQTAeFw0xNDEyMDExNTAw MzJaFw0zOTEyMDExNTEwMzFaMG0xCzAJBgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYD VQQLExlPSVNURSBGb3VuZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEds b2JhbCBSb290IEdCIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2Be3HEokKtaX scriHvt9OO+Y9bI5mE4nuBFde9IllIiCFSZqGzG7qFshISvYD06fWvGxWuR51jIjK+FTzJlFXHtP rby/h0oLS5daqPZI7H17Dc0hBt+eFf1Biki3IPShehtX1F1Q/7pn2COZH8g/497/b1t3sWtuuMlk 9+HKQUYOKXHQuSP8yYFfTvdv37+ErXNku7dCjmn21HYdfp2nuFeKUWdy19SouJVUQHMD9ur06/4o Qnc/nSMbsrY9gBQHTC5P99UKFg29ZkM3fiNDecNAhvVMKdqOmq0NpQSHiB6F4+lT1ZvIiwNjeOvg GUpuuy9rM2RYk61pv48b74JIxwIDAQABo1EwTzALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB /zAdBgNVHQ4EFgQUNQ/INmNe4qPs+TtmFc5RUuORmj0wEAYJKwYBBAGCNxUBBAMCAQAwDQYJKoZI hvcNAQELBQADggEBAEBM+4eymYGQfp3FsLAmzYh7KzKNbrghcViXfa43FK8+5/ea4n32cZiZBKpD dHij40lhPnOMTZTg+XHEthYOU3gf1qKHLwI5gSk8rxWYITD+KJAAjNHhy/peyP34EEY7onhCkRd0 VQreUGdNZtGn//3ZwLWoo4rOZvUPQ82nK1d7Y0Zqqi5S2PTt4W2tKZB4SLrhI6qjiey1q5bAtEui HZeeevJuQHHfaPFlTc58Bd9TZaml8LGXBHAVRgOY1NK/VLSgWH1Sb9pWJmLU2NuJMW8c8CLC02Ic Nc1MaRVUGpCY3useX8p3x8uOPUNpnJpY0CQ73xtAln41rYHHTnG6iBM= -----END CERTIFICATE----- SZAFIR ROOT CA2 =============== -----BEGIN CERTIFICATE----- MIIDcjCCAlqgAwIBAgIUPopdB+xV0jLVt+O2XwHrLdzk1uQwDQYJKoZIhvcNAQELBQAwUTELMAkG A1UEBhMCUEwxKDAmBgNVBAoMH0tyYWpvd2EgSXpiYSBSb3psaWN6ZW5pb3dhIFMuQS4xGDAWBgNV BAMMD1NaQUZJUiBST09UIENBMjAeFw0xNTEwMTkwNzQzMzBaFw0zNTEwMTkwNzQzMzBaMFExCzAJ BgNVBAYTAlBMMSgwJgYDVQQKDB9LcmFqb3dhIEl6YmEgUm96bGljemVuaW93YSBTLkEuMRgwFgYD VQQDDA9TWkFGSVIgUk9PVCBDQTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC3vD5Q qEvNQLXOYeeWyrSh2gwisPq1e3YAd4wLz32ohswmUeQgPYUM1ljj5/QqGJ3a0a4m7utT3PSQ1hNK DJA8w/Ta0o4NkjrcsbH/ON7Dui1fgLkCvUqdGw+0w8LBZwPd3BucPbOw3gAeqDRHu5rr/gsUvTaE 2g0gv/pby6kWIK05YO4vdbbnl5z5Pv1+TW9NL++IDWr63fE9biCloBK0TXC5ztdyO4mTp4CEHCdJ ckm1/zuVnsHMyAHs6A6KCpbns6aH5db5BSsNl0BwPLqsdVqc1U2dAgrSS5tmS0YHF2Wtn2yIANwi ieDhZNRnvDF5YTy7ykHNXGoAyDw4jlivAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0P AQH/BAQDAgEGMB0GA1UdDgQWBBQuFqlKGLXLzPVvUPMjX/hd56zwyDANBgkqhkiG9w0BAQsFAAOC AQEAtXP4A9xZWx126aMqe5Aosk3AM0+qmrHUuOQn/6mWmc5G4G18TKI4pAZw8PRBEew/R40/cof5 O/2kbytTAOD/OblqBw7rHRz2onKQy4I9EYKL0rufKq8h5mOGnXkZ7/e7DDWQw4rtTw/1zBLZpD67 oPwglV9PJi8RI4NOdQcPv5vRtB3pEAT+ymCPoky4rc/hkA/NrgrHXXu3UNLUYfrVFdvXn4dRVOul 4+vJhaAlIDf7js4MNIThPIGyd05DpYhfhmehPea0XGG2Ptv+tyjFogeutcrKjSoS75ftwjCkySp6 +/NNIxuZMzSgLvWpCz/UXeHPhJ/iGcJfitYgHuNztw== -----END CERTIFICATE----- Certum Trusted Network CA 2 =========================== -----BEGIN CERTIFICATE----- MIIF0jCCA7qgAwIBAgIQIdbQSk8lD8kyN/yqXhKN6TANBgkqhkiG9w0BAQ0FADCBgDELMAkGA1UE BhMCUEwxIjAgBgNVBAoTGVVuaXpldG8gVGVjaG5vbG9naWVzIFMuQS4xJzAlBgNVBAsTHkNlcnR1 bSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEkMCIGA1UEAxMbQ2VydHVtIFRydXN0ZWQgTmV0d29y ayBDQSAyMCIYDzIwMTExMDA2MDgzOTU2WhgPMjA0NjEwMDYwODM5NTZaMIGAMQswCQYDVQQGEwJQ TDEiMCAGA1UEChMZVW5pemV0byBUZWNobm9sb2dpZXMgUy5BLjEnMCUGA1UECxMeQ2VydHVtIENl cnRpZmljYXRpb24gQXV0aG9yaXR5MSQwIgYDVQQDExtDZXJ0dW0gVHJ1c3RlZCBOZXR3b3JrIENB IDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC9+Xj45tWADGSdhhuWZGc/IjoedQF9 7/tcZ4zJzFxrqZHmuULlIEub2pt7uZld2ZuAS9eEQCsn0+i6MLs+CRqnSZXvK0AkwpfHp+6bJe+o CgCXhVqqndwpyeI1B+twTUrWwbNWuKFBOJvR+zF/j+Bf4bE/D44WSWDXBo0Y+aomEKsq09DRZ40b Rr5HMNUuctHFY9rnY3lEfktjJImGLjQ/KUxSiyqnwOKRKIm5wFv5HdnnJ63/mgKXwcZQkpsCLL2p uTRZCr+ESv/f/rOf69me4Jgj7KZrdxYq28ytOxykh9xGc14ZYmhFV+SQgkK7QtbwYeDBoz1mo130 GO6IyY0XRSmZMnUCMe4pJshrAua1YkV/NxVaI2iJ1D7eTiew8EAMvE0Xy02isx7QBlrd9pPPV3WZ 9fqGGmd4s7+W/jTcvedSVuWz5XV710GRBdxdaeOVDUO5/IOWOZV7bIBaTxNyxtd9KXpEulKkKtVB Rgkg/iKgtlswjbyJDNXXcPiHUv3a76xRLgezTv7QCdpw75j6VuZt27VXS9zlLCUVyJ4ueE742pye hizKV/Ma5ciSixqClnrDvFASadgOWkaLOusm+iPJtrCBvkIApPjW/jAux9JG9uWOdf3yzLnQh1vM BhBgu4M1t15n3kfsmUjxpKEV/q2MYo45VU85FrmxY53/twIDAQABo0IwQDAPBgNVHRMBAf8EBTAD AQH/MB0GA1UdDgQWBBS2oVQ5AsOgP46KvPrU+Bym0ToO/TAOBgNVHQ8BAf8EBAMCAQYwDQYJKoZI hvcNAQENBQADggIBAHGlDs7k6b8/ONWJWsQCYftMxRQXLYtPU2sQF/xlhMcQSZDe28cmk4gmb3DW Al45oPePq5a1pRNcgRRtDoGCERuKTsZPpd1iHkTfCVn0W3cLN+mLIMb4Ck4uWBzrM9DPhmDJ2vuA L55MYIR4PSFk1vtBHxgP58l1cb29XN40hz5BsA72udY/CROWFC/emh1auVbONTqwX3BNXuMp8SMo clm2q8KMZiYcdywmdjWLKKdpoPk79SPdhRB0yZADVpHnr7pH1BKXESLjokmUbOe3lEu6LaTaM4tM pkT/WjzGHWTYtTHkpjx6qFcL2+1hGsvxznN3Y6SHb0xRONbkX8eftoEq5IVIeVheO/jbAoJnwTnb w3RLPTYe+SmTiGhbqEQZIfCn6IENLOiTNrQ3ssqwGyZ6miUfmpqAnksqP/ujmv5zMnHCnsZy4Ypo J/HkD7TETKVhk/iXEAcqMCWpuchxuO9ozC1+9eB+D4Kob7a6bINDd82Kkhehnlt4Fj1F4jNy3eFm ypnTycUm/Q1oBEauttmbjL4ZvrHG8hnjXALKLNhvSgfZyTXaQHXyxKcZb55CEJh15pWLYLztxRLX is7VmFxWlgPF7ncGNf/P5O4/E2Hu29othfDNrp2yGAlFw5Khchf8R7agCyzxxN5DaAhqXzvwdmP7 zAYspsbiDrW5viSP -----END CERTIFICATE----- Hellenic Academic and Research Institutions RootCA 2015 ======================================================= -----BEGIN CERTIFICATE----- MIIGCzCCA/OgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBpjELMAkGA1UEBhMCR1IxDzANBgNVBAcT BkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0 aW9ucyBDZXJ0LiBBdXRob3JpdHkxQDA+BgNVBAMTN0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNl YXJjaCBJbnN0aXR1dGlvbnMgUm9vdENBIDIwMTUwHhcNMTUwNzA3MTAxMTIxWhcNNDAwNjMwMTAx MTIxWjCBpjELMAkGA1UEBhMCR1IxDzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMg QWNhZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxQDA+BgNV BAMTN0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgUm9vdENBIDIw MTUwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDC+Kk/G4n8PDwEXT2QNrCROnk8Zlrv bTkBSRq0t89/TSNTt5AA4xMqKKYx8ZEA4yjsriFBzh/a/X0SWwGDD7mwX5nh8hKDgE0GPt+sr+eh iGsxr/CL0BgzuNtFajT0AoAkKAoCFZVedioNmToUW/bLy1O8E00BiDeUJRtCvCLYjqOWXjrZMts+ 6PAQZe104S+nfK8nNLspfZu2zwnI5dMK/IhlZXQK3HMcXM1AsRzUtoSMTFDPaI6oWa7CJ06CojXd FPQf/7J31Ycvqm59JCfnxssm5uX+Zwdj2EUN3TpZZTlYepKZcj2chF6IIbjV9Cz82XBST3i4vTwr i5WY9bPRaM8gFH5MXF/ni+X1NYEZN9cRCLdmvtNKzoNXADrDgfgXy5I2XdGj2HUb4Ysn6npIQf1F GQatJ5lOwXBH3bWfgVMS5bGMSF0xQxfjjMZ6Y5ZLKTBOhE5iGV48zpeQpX8B653g+IuJ3SWYPZK2 fu/Z8VFRfS0myGlZYeCsargqNhEEelC9MoS+L9xy1dcdFkfkR2YgP/SWxa+OAXqlD3pk9Q0Yh9mu iNX6hME6wGkoLfINaFGq46V3xqSQDqE3izEjR8EJCOtu93ib14L8hCCZSRm2Ekax+0VVFqmjZayc Bw/qa9wfLgZy7IaIEuQt218FL+TwA9MmM+eAws1CoRc0CwIDAQABo0IwQDAPBgNVHRMBAf8EBTAD AQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUcRVnyMjJvXVdctA4GGqd83EkVAswDQYJKoZI hvcNAQELBQADggIBAHW7bVRLqhBYRjTyYtcWNl0IXtVsyIe9tC5G8jH4fOpCtZMWVdyhDBKg2mF+ D1hYc2Ryx+hFjtyp8iY/xnmMsVMIM4GwVhO+5lFc2JsKT0ucVlMC6U/2DWDqTUJV6HwbISHTGzrM d/K4kPFox/la/vot9L/J9UUbzjgQKjeKeaO04wlshYaT/4mWJ3iBj2fjRnRUjtkNaeJK9E10A/+y d+2VZ5fkscWrv2oj6NSU4kQoYsRL4vDY4ilrGnB+JGGTe08DMiUNRSQrlrRGar9KC/eaj8GsGsVn 82800vpzY4zvFrCopEYq+OsS7HK07/grfoxSwIuEVPkvPuNVqNxmsdnhX9izjFk0WaSrT2y7Hxjb davYy5LNlDhhDgcGH0tGEPEVvo2FXDtKK4F5D7Rpn0lQl033DlZdwJVqwjbDG2jJ9SrcR5q+ss7F Jej6A7na+RZukYT1HCjI/CbM1xyQVqdfbzoEvM14iQuODy+jqk+iGxI9FghAD/FGTNeqewjBCvVt J94Cj8rDtSvK6evIIVM4pcw72Hc3MKJP2W/R8kCtQXoXxdZKNYm3QdV8hn9VTYNKpXMgwDqvkPGa JI7ZjnHKe7iG2rKPmT4dEw0SEe7Uq/DpFXYC5ODfqiAeW2GFZECpkJcNrVPSWh2HagCXZWK0vm9q p/UsQu0yrbYhnr68 -----END CERTIFICATE----- Hellenic Academic and Research Institutions ECC RootCA 2015 =========================================================== -----BEGIN CERTIFICATE----- MIICwzCCAkqgAwIBAgIBADAKBggqhkjOPQQDAjCBqjELMAkGA1UEBhMCR1IxDzANBgNVBAcTBkF0 aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9u cyBDZXJ0LiBBdXRob3JpdHkxRDBCBgNVBAMTO0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJj aCBJbnN0aXR1dGlvbnMgRUNDIFJvb3RDQSAyMDE1MB4XDTE1MDcwNzEwMzcxMloXDTQwMDYzMDEw MzcxMlowgaoxCzAJBgNVBAYTAkdSMQ8wDQYDVQQHEwZBdGhlbnMxRDBCBgNVBAoTO0hlbGxlbmlj IEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ2VydC4gQXV0aG9yaXR5MUQwQgYD VQQDEztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0dXRpb25zIEVDQyBSb290 Q0EgMjAxNTB2MBAGByqGSM49AgEGBSuBBAAiA2IABJKgQehLgoRc4vgxEZmGZE4JJS+dQS8KrjVP dJWyUWRrjWvmP3CV8AVER6ZyOFB2lQJajq4onvktTpnvLEhvTCUp6NFxW98dwXU3tNf6e3pCnGoK Vlp8aQuqgAkkbH7BRqNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0O BBYEFLQiC4KZJAEOnLvkDv2/+5cgk5kqMAoGCCqGSM49BAMCA2cAMGQCMGfOFmI4oqxiRaeplSTA GiecMjvAwNW6qef4BENThe5SId6d9SWDPp5YSy/XZxMOIQIwBeF1Ad5o7SofTUwJCA3sS61kFyjn dc5FZXIhF8siQQ6ME5g4mlRtm8rifOoCWCKR -----END CERTIFICATE----- ISRG Root X1 ============ -----BEGIN CERTIFICATE----- MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAwTzELMAkGA1UE BhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2VhcmNoIEdyb3VwMRUwEwYDVQQD EwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQG EwJVUzEpMCcGA1UEChMgSW50ZXJuZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMT DElTUkcgUm9vdCBYMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54r Vygch77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+0TM8ukj1 3Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6UA5/TR5d8mUgjU+g4rk8K b4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sWT8KOEUt+zwvo/7V3LvSye0rgTBIlDHCN Aymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyHB5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ 4Q7e2RCOFvu396j3x+UCB5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf 1b0SHzUvKBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWnOlFu hjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTnjh8BCNAw1FtxNrQH usEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbwqHyGO0aoSCqI3Haadr8faqU9GY/r OPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CIrU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4G A1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY 9umbbjANBgkqhkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ3BebYhtF8GaV 0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KKNFtY2PwByVS5uCbMiogziUwt hDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJw TdwJx4nLCgdNbOhdjsnvzqvHu7UrTkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nx e5AW0wdeRlN8NwdCjNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZA JzVcoyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq4RgqsahD YVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPAmRGunUHBcnWEvgJBQl9n JEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57demyPxgcYxn/eR44/KJ4EBs+lVDR3veyJ m+kXQ99b21/+jh5Xos1AnX5iItreGCc= -----END CERTIFICATE----- AC RAIZ FNMT-RCM ================ -----BEGIN CERTIFICATE----- MIIFgzCCA2ugAwIBAgIPXZONMGc2yAYdGsdUhGkHMA0GCSqGSIb3DQEBCwUAMDsxCzAJBgNVBAYT AkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJWiBGTk1ULVJDTTAeFw0wODEw MjkxNTU5NTZaFw0zMDAxMDEwMDAwMDBaMDsxCzAJBgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJD TTEZMBcGA1UECwwQQUMgUkFJWiBGTk1ULVJDTTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC ggIBALpxgHpMhm5/yBNtwMZ9HACXjywMI7sQmkCpGreHiPibVmr75nuOi5KOpyVdWRHbNi63URcf qQgfBBckWKo3Shjf5TnUV/3XwSyRAZHiItQDwFj8d0fsjz50Q7qsNI1NOHZnjrDIbzAzWHFctPVr btQBULgTfmxKo0nRIBnuvMApGGWn3v7v3QqQIecaZ5JCEJhfTzC8PhxFtBDXaEAUwED653cXeuYL j2VbPNmaUtu1vZ5Gzz3rkQUCwJaydkxNEJY7kvqcfw+Z374jNUUeAlz+taibmSXaXvMiwzn15Cou 08YfxGyqxRxqAQVKL9LFwag0Jl1mpdICIfkYtwb1TplvqKtMUejPUBjFd8g5CSxJkjKZqLsXF3mw WsXmo8RZZUc1g16p6DULmbvkzSDGm0oGObVo/CK67lWMK07q87Hj/LaZmtVC+nFNCM+HHmpxffnT tOmlcYF7wk5HlqX2doWjKI/pgG6BU6VtX7hI+cL5NqYuSf+4lsKMB7ObiFj86xsc3i1w4peSMKGJ 47xVqCfWS+2QrYv6YyVZLag13cqXM7zlzced0ezvXg5KkAYmY6252TUtB7p2ZSysV4999AeU14EC ll2jB0nVetBX+RvnU0Z1qrB5QstocQjpYL05ac70r8NWQMetUqIJ5G+GR4of6ygnXYMgrwTJbFaa i0b1AgMBAAGjgYMwgYAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE FPd9xf3E6Jobd2Sn9R2gzL+HYJptMD4GA1UdIAQ3MDUwMwYEVR0gADArMCkGCCsGAQUFBwIBFh1o dHRwOi8vd3d3LmNlcnQuZm5tdC5lcy9kcGNzLzANBgkqhkiG9w0BAQsFAAOCAgEAB5BK3/MjTvDD nFFlm5wioooMhfNzKWtN/gHiqQxjAb8EZ6WdmF/9ARP67Jpi6Yb+tmLSbkyU+8B1RXxlDPiyN8+s D8+Nb/kZ94/sHvJwnvDKuO+3/3Y3dlv2bojzr2IyIpMNOmqOFGYMLVN0V2Ue1bLdI4E7pWYjJ2cJ j+F3qkPNZVEI7VFY/uY5+ctHhKQV8Xa7pO6kO8Rf77IzlhEYt8llvhjho6Tc+hj507wTmzl6NLrT Qfv6MooqtyuGC2mDOL7Nii4LcK2NJpLuHvUBKwrZ1pebbuCoGRw6IYsMHkCtA+fdZn71uSANA+iW +YJF1DngoABd15jmfZ5nc8OaKveri6E6FO80vFIOiZiaBECEHX5FaZNXzuvO+FB8TxxuBEOb+dY7 Ixjp6o7RTUaN8Tvkasq6+yO3m/qZASlaWFot4/nUbQ4mrcFuNLwy+AwF+mWj2zs3gyLp1txyM/1d 8iC9djwj2ij3+RvrWWTV3F9yfiD8zYm1kGdNYno/Tq0dwzn+evQoFt9B9kiABdcPUXmsEKvU7ANm 5mqwujGSQkBqvjrTcuFqN1W8rB2Vt2lh8kORdOag0wokRqEIr9baRRmW1FMdW4R58MD3R++Lj8UG rp1MYp3/RgT408m2ECVAdf4WqslKYIYvuu8wd+RU4riEmViAqhOLUTpPSPaLtrM= -----END CERTIFICATE----- Amazon Root CA 1 ================ -----BEGIN CERTIFICATE----- MIIDQTCCAimgAwIBAgITBmyfz5m/jAo54vB4ikPmljZbyjANBgkqhkiG9w0BAQsFADA5MQswCQYD VQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24gUm9vdCBDQSAxMB4XDTE1 MDUyNjAwMDAwMFoXDTM4MDExNzAwMDAwMFowOTELMAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpv bjEZMBcGA1UEAxMQQW1hem9uIFJvb3QgQ0EgMTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC ggEBALJ4gHHKeNXjca9HgFB0fW7Y14h29Jlo91ghYPl0hAEvrAIthtOgQ3pOsqTQNroBvo3bSMgH FzZM9O6II8c+6zf1tRn4SWiw3te5djgdYZ6k/oI2peVKVuRF4fn9tBb6dNqcmzU5L/qwIFAGbHrQ gLKm+a/sRxmPUDgH3KKHOVj4utWp+UhnMJbulHheb4mjUcAwhmahRWa6VOujw5H5SNz/0egwLX0t dHA114gk957EWW67c4cX8jJGKLhD+rcdqsq08p8kDi1L93FcXmn/6pUCyziKrlA4b9v7LWIbxcce VOF34GfID5yHI9Y/QCB/IIDEgEw+OyQmjgSubJrIqg0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB /zAOBgNVHQ8BAf8EBAMCAYYwHQYDVR0OBBYEFIQYzIU07LwMlJQuCFmcx7IQTgoIMA0GCSqGSIb3 DQEBCwUAA4IBAQCY8jdaQZChGsV2USggNiMOruYou6r4lK5IpDB/G/wkjUu0yKGX9rbxenDIU5PM CCjjmCXPI6T53iHTfIUJrU6adTrCC2qJeHZERxhlbI1Bjjt/msv0tadQ1wUsN+gDS63pYaACbvXy 8MWy7Vu33PqUXHeeE6V/Uq2V8viTO96LXFvKWlJbYK8U90vvo/ufQJVtMVT8QtPHRh8jrdkPSHCa 2XV4cdFyQzR1bldZwgJcJmApzyMZFo6IQ6XU5MsI+yMRQ+hDKXJioaldXgjUkK642M4UwtBV8ob2 xJNDd2ZhwLnoQdeXeGADbkpyrqXRfboQnoZsG4q5WTP468SQvvG5 -----END CERTIFICATE----- Amazon Root CA 2 ================ -----BEGIN CERTIFICATE----- MIIFQTCCAymgAwIBAgITBmyf0pY1hp8KD+WGePhbJruKNzANBgkqhkiG9w0BAQwFADA5MQswCQYD VQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24gUm9vdCBDQSAyMB4XDTE1 MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpv bjEZMBcGA1UEAxMQQW1hem9uIFJvb3QgQ0EgMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC ggIBAK2Wny2cSkxKgXlRmeyKy2tgURO8TW0G/LAIjd0ZEGrHJgw12MBvIITplLGbhQPDW9tK6Mj4 kHbZW0/jTOgGNk3Mmqw9DJArktQGGWCsN0R5hYGCrVo34A3MnaZMUnbqQ523BNFQ9lXg1dKmSYXp N+nKfq5clU1Imj+uIFptiJXZNLhSGkOQsL9sBbm2eLfq0OQ6PBJTYv9K8nu+NQWpEjTj82R0Yiw9 AElaKP4yRLuH3WUnAnE72kr3H9rN9yFVkE8P7K6C4Z9r2UXTu/Bfh+08LDmG2j/e7HJV63mjrdvd fLC6HM783k81ds8P+HgfajZRRidhW+mez/CiVX18JYpvL7TFz4QuK/0NURBs+18bvBt+xa47mAEx kv8LV/SasrlX6avvDXbR8O70zoan4G7ptGmh32n2M8ZpLpcTnqWHsFcQgTfJU7O7f/aS0ZzQGPSS btqDT6ZjmUyl+17vIWR6IF9sZIUVyzfpYgwLKhbcAS4y2j5L9Z469hdAlO+ekQiG+r5jqFoz7Mt0 Q5X5bGlSNscpb/xVA1wf+5+9R+vnSUeVC06JIglJ4PVhHvG/LopyboBZ/1c6+XUyo05f7O0oYtlN c/LMgRdg7c3r3NunysV+Ar3yVAhU/bQtCSwXVEqY0VThUWcI0u1ufm8/0i2BWSlmy5A5lREedCf+ 3euvAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSw DPBMMPQFWAJI/TPlUq9LhONmUjANBgkqhkiG9w0BAQwFAAOCAgEAqqiAjw54o+Ci1M3m9Zh6O+oA A7CXDpO8Wqj2LIxyh6mx/H9z/WNxeKWHWc8w4Q0QshNabYL1auaAn6AFC2jkR2vHat+2/XcycuUY +gn0oJMsXdKMdYV2ZZAMA3m3MSNjrXiDCYZohMr/+c8mmpJ5581LxedhpxfL86kSk5Nrp+gvU5LE YFiwzAJRGFuFjWJZY7attN6a+yb3ACfAXVU3dJnJUH/jWS5E4ywl7uxMMne0nxrpS10gxdr9HIcW xkPo1LsmmkVwXqkLN1PiRnsn/eBG8om3zEK2yygmbtmlyTrIQRNg91CMFa6ybRoVGld45pIq2WWQ gj9sAq+uEjonljYE1x2igGOpm/HlurR8FLBOybEfdF849lHqm/osohHUqS0nGkWxr7JOcQ3AWEbW aQbLU8uz/mtBzUF+fUwPfHJ5elnNXkoOrJupmHN5fLT0zLm4BwyydFy4x2+IoZCn9Kr5v2c69BoV Yh63n749sSmvZ6ES8lgQGVMDMBu4Gon2nL2XA46jCfMdiyHxtN/kHNGfZQIG6lzWE7OE76KlXIx3 KadowGuuQNKotOrN8I1LOJwZmhsoVLiJkO/KdYE+HvJkJMcYr07/R54H9jVlpNMKVv/1F2Rs76gi JUmTtt8AF9pYfl3uxRuw0dFfIRDH+fO6AgonB8Xx1sfT4PsJYGw= -----END CERTIFICATE----- Amazon Root CA 3 ================ -----BEGIN CERTIFICATE----- MIIBtjCCAVugAwIBAgITBmyf1XSXNmY/Owua2eiedgPySjAKBggqhkjOPQQDAjA5MQswCQYDVQQG EwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24gUm9vdCBDQSAzMB4XDTE1MDUy NjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZ MBcGA1UEAxMQQW1hem9uIFJvb3QgQ0EgMzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABCmXp8ZB f8ANm+gBG1bG8lKlui2yEujSLtf6ycXYqm0fc4E7O5hrOXwzpcVOho6AF2hiRVd9RFgdszflZwjr Zt6jQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSrttvXBp43 rDCGB5Fwx5zEGbF4wDAKBggqhkjOPQQDAgNJADBGAiEA4IWSoxe3jfkrBqWTrBqYaGFy+uGh0Psc eGCmQ5nFuMQCIQCcAu/xlJyzlvnrxir4tiz+OpAUFteMYyRIHN8wfdVoOw== -----END CERTIFICATE----- Amazon Root CA 4 ================ -----BEGIN CERTIFICATE----- MIIB8jCCAXigAwIBAgITBmyf18G7EEwpQ+Vxe3ssyBrBDjAKBggqhkjOPQQDAzA5MQswCQYDVQQG EwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24gUm9vdCBDQSA0MB4XDTE1MDUy NjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZ MBcGA1UEAxMQQW1hem9uIFJvb3QgQ0EgNDB2MBAGByqGSM49AgEGBSuBBAAiA2IABNKrijdPo1MN /sGKe0uoe0ZLY7Bi9i0b2whxIdIA6GO9mif78DluXeo9pcmBqqNbIJhFXRbb/egQbeOc4OO9X4Ri 83BkM6DLJC9wuoihKqB1+IGuYgbEgds5bimwHvouXKNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNV HQ8BAf8EBAMCAYYwHQYDVR0OBBYEFNPsxzplbszh2naaVvuc84ZtV+WBMAoGCCqGSM49BAMDA2gA MGUCMDqLIfG9fhGt0O9Yli/W651+kI0rz2ZVwyzjKKlwCkcO8DdZEv8tmZQoTipPNU0zWgIxAOp1 AE47xDqUEpHJWEadIRNyp4iciuRMStuW1KyLa2tJElMzrdfkviT8tQp21KW8EA== -----END CERTIFICATE----- TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 ============================================= -----BEGIN CERTIFICATE----- MIIEYzCCA0ugAwIBAgIBATANBgkqhkiG9w0BAQsFADCB0jELMAkGA1UEBhMCVFIxGDAWBgNVBAcT D0dlYnplIC0gS29jYWVsaTFCMEAGA1UEChM5VHVya2l5ZSBCaWxpbXNlbCB2ZSBUZWtub2xvamlr IEFyYXN0aXJtYSBLdXJ1bXUgLSBUVUJJVEFLMS0wKwYDVQQLEyRLYW11IFNlcnRpZmlrYXN5b24g TWVya2V6aSAtIEthbXUgU00xNjA0BgNVBAMTLVRVQklUQUsgS2FtdSBTTSBTU0wgS29rIFNlcnRp ZmlrYXNpIC0gU3VydW0gMTAeFw0xMzExMjUwODI1NTVaFw00MzEwMjUwODI1NTVaMIHSMQswCQYD VQQGEwJUUjEYMBYGA1UEBxMPR2ViemUgLSBLb2NhZWxpMUIwQAYDVQQKEzlUdXJraXllIEJpbGlt c2VsIHZlIFRla25vbG9qaWsgQXJhc3Rpcm1hIEt1cnVtdSAtIFRVQklUQUsxLTArBgNVBAsTJEth bXUgU2VydGlmaWthc3lvbiBNZXJrZXppIC0gS2FtdSBTTTE2MDQGA1UEAxMtVFVCSVRBSyBLYW11 IFNNIFNTTCBLb2sgU2VydGlmaWthc2kgLSBTdXJ1bSAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A MIIBCgKCAQEAr3UwM6q7a9OZLBI3hNmNe5eA027n/5tQlT6QlVZC1xl8JoSNkvoBHToP4mQ4t4y8 6Ij5iySrLqP1N+RAjhgleYN1Hzv/bKjFxlb4tO2KRKOrbEz8HdDc72i9z+SqzvBV96I01INrN3wc wv61A+xXzry0tcXtAA9TNypN9E8Mg/uGz8v+jE69h/mniyFXnHrfA2eJLJ2XYacQuFWQfw4tJzh0 3+f92k4S400VIgLI4OD8D62K18lUUMw7D8oWgITQUVbDjlZ/iSIzL+aFCr2lqBs23tPcLG07xxO9 WSMs5uWk99gL7eqQQESolbuT1dCANLZGeA4fAJNG4e7p+exPFwIDAQABo0IwQDAdBgNVHQ4EFgQU ZT/HiobGPN08VFw1+DrtUgxHV8gwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJ KoZIhvcNAQELBQADggEBACo/4fEyjq7hmFxLXs9rHmoJ0iKpEsdeV31zVmSAhHqT5Am5EM2fKifh AHe+SMg1qIGf5LgsyX8OsNJLN13qudULXjS99HMpw+0mFZx+CFOKWI3QSyjfwbPfIPP54+M638yc lNhOT8NrF7f3cuitZjO1JVOr4PhMqZ398g26rrnZqsZr+ZO7rqu4lzwDGrpDxpa5RXI4s6ehlj2R e37AIVNMh+3yC1SVUZPVIqUNivGTDj5UDrDYyU7c8jEyVupk+eq1nRZmQnLzf9OxMUP8pI4X8W0j q5Rm+K37DwhuJi1/FwcJsoz7UMCflo3Ptv0AnVoUmr8CRPXBwp8iXqIPoeM= -----END CERTIFICATE----- GDCA TrustAUTH R5 ROOT ====================== -----BEGIN CERTIFICATE----- MIIFiDCCA3CgAwIBAgIIfQmX/vBH6nowDQYJKoZIhvcNAQELBQAwYjELMAkGA1UEBhMCQ04xMjAw BgNVBAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZIENPLixMVEQuMR8wHQYDVQQD DBZHRENBIFRydXN0QVVUSCBSNSBST09UMB4XDTE0MTEyNjA1MTMxNVoXDTQwMTIzMTE1NTk1OVow YjELMAkGA1UEBhMCQ04xMjAwBgNVBAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZ IENPLixMVEQuMR8wHQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMIICIjANBgkqhkiG9w0B AQEFAAOCAg8AMIICCgKCAgEA2aMW8Mh0dHeb7zMNOwZ+Vfy1YI92hhJCfVZmPoiC7XJjDp6L3TQs AlFRwxn9WVSEyfFrs0yw6ehGXTjGoqcuEVe6ghWinI9tsJlKCvLriXBjTnnEt1u9ol2x8kECK62p OqPseQrsXzrj/e+APK00mxqriCZ7VqKChh/rNYmDf1+uKU49tm7srsHwJ5uu4/Ts765/94Y9cnrr pftZTqfrlYwiOXnhLQiPzLyRuEH3FMEjqcOtmkVEs7LXLM3GKeJQEK5cy4KOFxg2fZfmiJqwTTQJ 9Cy5WmYqsBebnh52nUpmMUHfP/vFBu8btn4aRjb3ZGM74zkYI+dndRTVdVeSN72+ahsmUPI2JgaQ xXABZG12ZuGR224HwGGALrIuL4xwp9E7PLOR5G62xDtw8mySlwnNR30YwPO7ng/Wi64HtloPzgsM R6flPri9fcebNaBhlzpBdRfMK5Z3KpIhHtmVdiBnaM8Nvd/WHwlqmuLMc3GkL30SgLdTMEZeS1SZ D2fJpcjyIMGC7J0R38IC+xo70e0gmu9lZJIQDSri3nDxGGeCjGHeuLzRL5z7D9Ar7Rt2ueQ5Vfj4 oR24qoAATILnsn8JuLwwoC8N9VKejveSswoAHQBUlwbgsQfZxw9cZX08bVlX5O2ljelAU58VS6Bx 9hoh49pwBiFYFIeFd3mqgnkCAwEAAaNCMEAwHQYDVR0OBBYEFOLJQJ9NzuiaoXzPDj9lxSmIahlR MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQDRSVfg p8xoWLoBDysZzY2wYUWsEe1jUGn4H3++Fo/9nesLqjJHdtJnJO29fDMylyrHBYZmDRd9FBUb1Ov9 H5r2XpdptxolpAqzkT9fNqyL7FeoPueBihhXOYV0GkLH6VsTX4/5COmSdI31R9KrO9b7eGZONn35 6ZLpBN79SWP8bfsUcZNnL0dKt7n/HipzcEYwv1ryL3ml4Y0M2fmyYzeMN2WFcGpcWwlyua1jPLHd +PwyvzeG5LuOmCd+uh8W4XAR8gPfJWIyJyYYMoSf/wA6E7qaTfRPuBRwIrHKK5DOKcFw9C+df/KQ HtZa37dG/OaG+svgIHZ6uqbL9XzeYqWxi+7egmaKTjowHz+Ay60nugxe19CxVsp3cbK1daFQqUBD F8Io2c9Si1vIY9RCPqAzekYu9wogRlR+ak8x8YF+QnQ4ZXMn7sZ8uI7XpTrXmKGcjBBV09tL7ECQ 8s1uV9JiDnxXk7Gnbc2dg7sq5+W2O3FYrf3RRbxake5TFW/TRQl1brqQXR4EzzffHqhmsYzmIGrv /EhOdJhCrylvLmrH+33RZjEizIYAfmaDDEL0vTSSwxrqT8p+ck0LcIymSLumoRT2+1hEmRSuqguT aaApJUqlyyvdimYHFngVV3Eb7PVHhPOeMTd61X8kreS8/f3MboPoDKi3QWwH3b08hpcv0g== -----END CERTIFICATE----- SSL.com Root Certification Authority RSA ======================================== -----BEGIN CERTIFICATE----- MIIF3TCCA8WgAwIBAgIIeyyb0xaAMpkwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxDjAM BgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9TU0wgQ29ycG9yYXRpb24x MTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSBSU0EwHhcNMTYw MjEyMTczOTM5WhcNNDEwMjEyMTczOTM5WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMx EDAOBgNVBAcMB0hvdXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NM LmNvbSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTCCAiIwDQYJKoZIhvcNAQEBBQAD ggIPADCCAgoCggIBAPkP3aMrfcvQKv7sZ4Wm5y4bunfh4/WvpOz6Sl2RxFdHaxh3a3by/ZPkPQ/C Fp4LZsNWlJ4Xg4XOVu/yFv0AYvUiCVToZRdOQbngT0aXqhvIuG5iXmmxX9sqAn78bMrzQdjt0Oj8 P2FI7bADFB0QDksZ4LtO7IZl/zbzXmcCC52GVWH9ejjt/uIZALdvoVBidXQ8oPrIJZK0bnoix/ge oeOy3ZExqysdBP+lSgQ36YWkMyv94tZVNHwZpEpox7Ko07fKoZOI68GXvIz5HdkihCR0xwQ9aqkp k8zruFvh/l8lqjRYyMEjVJ0bmBHDOJx+PYZspQ9AhnwC9FwCTyjLrnGfDzrIM/4RJTXq/LrFYD3Z fBjVsqnTdXgDciLKOsMf7yzlLqn6niy2UUb9rwPW6mBo6oUWNmuF6R7As93EJNyAKoFBbZQ+yODJ gUEAnl6/f8UImKIYLEJAs/lvOCdLToD0PYFH4Ih86hzOtXVcUS4cK38acijnALXRdMbX5J+tB5O2 UzU1/Dfkw/ZdFr4hc96SCvigY2q8lpJqPvi8ZVWb3vUNiSYE/CUapiVpy8JtynziWV+XrOvvLsi8 1xtZPCvM8hnIk2snYxnP/Okm+Mpxm3+T/jRnhE6Z6/yzeAkzcLpmpnbtG3PrGqUNxCITIJRWCk4s bE6x/c+cCbqiM+2HAgMBAAGjYzBhMB0GA1UdDgQWBBTdBAkHovV6fVJTEpKV7jiAJQ2mWTAPBgNV HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFN0ECQei9Xp9UlMSkpXuOIAlDaZZMA4GA1UdDwEB/wQE AwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAIBgRlCn7Jp0cHh5wYfGVcpNxJK1ok1iOMq8bs3AD/CUr dIWQPXhq9LmLpZc7tRiRux6n+UBbkflVma8eEdBcHadm47GUBwwyOabqG7B52B2ccETjit3E+ZUf ijhDPwGFpUenPUayvOUiaPd7nNgsPgohyC0zrL/FgZkxdMF1ccW+sfAjRfSda/wZY52jvATGGAsl u1OJD7OAUN5F7kR/q5R4ZJjT9ijdh9hwZXT7DrkT66cPYakylszeu+1jTBi7qUD3oFRuIIhxdRjq erQ0cuAjJ3dctpDqhiVAq+8zD8ufgr6iIPv2tS0a5sKFsXQP+8hlAqRSAUfdSSLBv9jra6x+3uxj MxW3IwiPxg+NQVrdjsW5j+VFP3jbutIbQLH+cU0/4IGiul607BXgk90IH37hVZkLId6Tngr75qNJ vTYw/ud3sqB1l7UtgYgXZSD32pAAn8lSzDLKNXz1PQ/YK9f1JmzJBjSWFupwWRoyeXkLtoh/D1JI Pb9s2KJELtFOt3JY04kTlf5Eq/jXixtunLwsoFvVagCvXzfh1foQC5ichucmj87w7G6KVwuA406y wKBjYZC6VWg3dGq2ktufoYYitmUnDuy2n0Jg5GfCtdpBC8TTi2EbvPofkSvXRAdeuims2cXp71NI WuuA8ShYIc2wBlX7Jz9TkHCpBB5XJ7k= -----END CERTIFICATE----- SSL.com Root Certification Authority ECC ======================================== -----BEGIN CERTIFICATE----- MIICjTCCAhSgAwIBAgIIdebfy8FoW6gwCgYIKoZIzj0EAwIwfDELMAkGA1UEBhMCVVMxDjAMBgNV BAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9TU0wgQ29ycG9yYXRpb24xMTAv BgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEy MTgxNDAzWhcNNDEwMjEyMTgxNDAzWjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAO BgNVBAcMB0hvdXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNv bSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49AgEGBSuBBAAiA2IA BEVuqVDEpiM2nl8ojRfLliJkP9x6jh3MCLOicSS6jkm5BBtHllirLZXI7Z4INcgn64mMU1jrYor+ 8FsPazFSY0E7ic3s7LaNGdM0B9y7xgZ/wkWV7Mt/qCPgCemB+vNH06NjMGEwHQYDVR0OBBYEFILR hXMw5zUE044CkvvlpNHEIejNMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUgtGFczDnNQTT jgKS++Wk0cQh6M0wDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2cAMGQCMG/n61kRpGDPYbCW e+0F+S8Tkdzt5fxQaxFGRrMcIQBiu77D5+jNB5n5DQtdcj7EqgIwH7y6C+IwJPt8bYBVCpk+gA0z 5Wajs6O7pdWLjwkspl1+4vAHCGht0nxpbl/f5Wpl -----END CERTIFICATE----- SSL.com EV Root Certification Authority RSA R2 ============================================== -----BEGIN CERTIFICATE----- MIIF6zCCA9OgAwIBAgIIVrYpzTS8ePYwDQYJKoZIhvcNAQELBQAwgYIxCzAJBgNVBAYTAlVTMQ4w DAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91c3RvbjEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9u MTcwNQYDVQQDDC5TU0wuY29tIEVWIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIy MB4XDTE3MDUzMTE4MTQzN1oXDTQyMDUzMDE4MTQzN1owgYIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQI DAVUZXhhczEQMA4GA1UEBwwHSG91c3RvbjEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMTcwNQYD VQQDDC5TU0wuY29tIEVWIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIyMIICIjAN BgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAjzZlQOHWTcDXtOlG2mvqM0fNTPl9fb69LT3w23jh hqXZuglXaO1XPqDQCEGD5yhBJB/jchXQARr7XnAjssufOePPxU7Gkm0mxnu7s9onnQqG6YE3Bf7w cXHswxzpY6IXFJ3vG2fThVUCAtZJycxa4bH3bzKfydQ7iEGonL3Lq9ttewkfokxykNorCPzPPFTO Zw+oz12WGQvE43LrrdF9HSfvkusQv1vrO6/PgN3B0pYEW3p+pKk8OHakYo6gOV7qd89dAFmPZiw+ B6KjBSYRaZfqhbcPlgtLyEDhULouisv3D5oi53+aNxPN8k0TayHRwMwi8qFG9kRpnMphNQcAb9Zh CBHqurj26bNg5U257J8UZslXWNvNh2n4ioYSA0e/ZhN2rHd9NCSFg83XqpyQGp8hLH94t2S42Oim 9HizVcuE0jLEeK6jj2HdzghTreyI/BXkmg3mnxp3zkyPuBQVPWKchjgGAGYS5Fl2WlPAApiiECto RHuOec4zSnaqW4EWG7WK2NAAe15itAnWhmMOpgWVSbooi4iTsjQc2KRVbrcc0N6ZVTsj9CLg+Slm JuwgUHfbSguPvuUCYHBBXtSuUDkiFCbLsjtzdFVHB3mBOagwE0TlBIqulhMlQg+5U8Sb/M3kHN48 +qvWBkofZ6aYMBzdLNvcGJVXZsb/XItW9XcCAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNV HSMEGDAWgBT5YLvU49U09rj1BoAlp3PbRmmonjAdBgNVHQ4EFgQU+WC71OPVNPa49QaAJadz20Zp qJ4wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQBWs47LCp1Jjr+kxJG7ZhcFUZh1 ++VQLHqe8RT6q9OKPv+RKY9ji9i0qVQBDb6Thi/5Sm3HXvVX+cpVHBK+Rw82xd9qt9t1wkclf7nx Y/hoLVUE0fKNsKTPvDxeH3jnpaAgcLAExbf3cqfeIg29MyVGjGSSJuM+LmOW2puMPfgYCdcDzH2G guDKBAdRUNf/ktUM79qGn5nX67evaOI5JpS6aLe/g9Pqemc9YmeuJeVy6OLk7K4S9ksrPJ/psEDz OFSz/bdoyNrGj1E8svuR3Bznm53htw1yj+KkxKl4+esUrMZDBcJlOSgYAsOCsp0FvmXtll9ldDz7 CTUue5wT/RsPXcdtgTpWD8w74a8CLyKsRspGPKAcTNZEtF4uXBVmCeEmKf7GUmG6sXP/wwyc5Wxq lD8UykAWlYTzWamsX0xhk23RO8yilQwipmdnRC652dKKQbNmC1r7fSOl8hqw/96bg5Qu0T/fkreR rwU7ZcegbLHNYhLDkBvjJc40vG93drEQw/cFGsDWr3RiSBd3kmmQYRzelYB0VI8YHMPzA9C/pEN1 hlMYegouCRw2n5H9gooiS9EOUCXdywMMF8mDAAhONU2Ki+3wApRmLER/y5UnlhetCTCstnEXbosX 9hwJ1C07mKVx01QT2WDz9UtmT/rx7iASjbSsV7FFY6GsdqnC+w== -----END CERTIFICATE----- SSL.com EV Root Certification Authority ECC =========================================== -----BEGIN CERTIFICATE----- MIIClDCCAhqgAwIBAgIILCmcWxbtBZUwCgYIKoZIzj0EAwIwfzELMAkGA1UEBhMCVVMxDjAMBgNV BAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9TU0wgQ29ycG9yYXRpb24xNDAy BgNVBAMMK1NTTC5jb20gRVYgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYw MjEyMTgxNTIzWhcNNDEwMjEyMTgxNTIzWjB/MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMx EDAOBgNVBAcMB0hvdXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjE0MDIGA1UEAwwrU1NM LmNvbSBFViBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49AgEGBSuB BAAiA2IABKoSR5CYG/vvw0AHgyBO8TCCogbR8pKGYfL2IWjKAMTH6kMAVIbc/R/fALhBYlzccBYy 3h+Z1MzFB8gIH2EWB1E9fVwHU+M1OIzfzZ/ZLg1KthkuWnBaBu2+8KGwytAJKaNjMGEwHQYDVR0O BBYEFFvKXuXe0oGqzagtZFG22XKbl+ZPMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUW8pe 5d7SgarNqC1kUbbZcpuX5k8wDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2gAMGUCMQCK5kCJ N+vp1RPZytRrJPOwPYdGWBrssd9v+1a6cGvHOMzosYxPD/fxZ3YOg9AeUY8CMD32IygmTMZgh5Mm m7I1HrrW9zzRHM76JTymGoEVW/MSD2zuZYrJh6j5B+BimoxcSg== -----END CERTIFICATE----- GlobalSign Root CA - R6 ======================= -----BEGIN CERTIFICATE----- MIIFgzCCA2ugAwIBAgIORea7A4Mzw4VlSOb/RVEwDQYJKoZIhvcNAQEMBQAwTDEgMB4GA1UECxMX R2xvYmFsU2lnbiBSb290IENBIC0gUjYxEzARBgNVBAoTCkdsb2JhbFNpZ24xEzARBgNVBAMTCkds b2JhbFNpZ24wHhcNMTQxMjEwMDAwMDAwWhcNMzQxMjEwMDAwMDAwWjBMMSAwHgYDVQQLExdHbG9i YWxTaWduIFJvb3QgQ0EgLSBSNjETMBEGA1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFs U2lnbjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAJUH6HPKZvnsFMp7PPcNCPG0RQss grRIxutbPK6DuEGSMxSkb3/pKszGsIhrxbaJ0cay/xTOURQh7ErdG1rG1ofuTToVBu1kZguSgMpE 3nOUTvOniX9PeGMIyBJQbUJmL025eShNUhqKGoC3GYEOfsSKvGRMIRxDaNc9PIrFsmbVkJq3MQbF vuJtMgamHvm566qjuL++gmNQ0PAYid/kD3n16qIfKtJwLnvnvJO7bVPiSHyMEAc4/2ayd2F+4OqM PKq0pPbzlUoSB239jLKJz9CgYXfIWHSw1CM69106yqLbnQneXUQtkPGBzVeS+n68UARjNN9rkxi+ azayOeSsJDa38O+2HBNXk7besvjihbdzorg1qkXy4J02oW9UivFyVm4uiMVRQkQVlO6jxTiWm05O WgtH8wY2SXcwvHE35absIQh1/OZhFj931dmRl4QKbNQCTXTAFO39OfuD8l4UoQSwC+n+7o/hbguy CLNhZglqsQY6ZZZZwPA1/cnaKI0aEYdwgQqomnUdnjqGBQCe24DWJfncBZ4nWUx2OVvq+aWh2IMP 0f/fMBH5hc8zSPXKbWQULHpYT9NLCEnFlWQaYw55PfWzjMpYrZxCRXluDocZXFSxZba/jJvcE+kN b7gu3GduyYsRtYQUigAZcIN5kZeR1BonvzceMgfYFGM8KEyvAgMBAAGjYzBhMA4GA1UdDwEB/wQE AwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBSubAWjkxPioufi1xzWx/B/yGdToDAfBgNV HSMEGDAWgBSubAWjkxPioufi1xzWx/B/yGdToDANBgkqhkiG9w0BAQwFAAOCAgEAgyXt6NH9lVLN nsAEoJFp5lzQhN7craJP6Ed41mWYqVuoPId8AorRbrcWc+ZfwFSY1XS+wc3iEZGtIxg93eFyRJa0 lV7Ae46ZeBZDE1ZXs6KzO7V33EByrKPrmzU+sQghoefEQzd5Mr6155wsTLxDKZmOMNOsIeDjHfrY BzN2VAAiKrlNIC5waNrlU/yDXNOd8v9EDERm8tLjvUYAGm0CuiVdjaExUd1URhxN25mW7xocBFym Fe944Hn+Xds+qkxV/ZoVqW/hpvvfcDDpw+5CRu3CkwWJ+n1jez/QcYF8AOiYrg54NMMl+68KnyBr 3TsTjxKM4kEaSHpzoHdpx7Zcf4LIHv5YGygrqGytXm3ABdJ7t+uA/iU3/gKbaKxCXcPu9czc8FB1 0jZpnOZ7BN9uBmm23goJSFmH63sUYHpkqmlD75HHTOwY3WzvUy2MmeFe8nI+z1TIvWfspA9MRf/T uTAjB0yPEL+GltmZWrSZVxykzLsViVO6LAUP5MSeGbEYNNVMnbrt9x+vJJUEeKgDu+6B5dpffItK oZB0JaezPkvILFa9x8jvOOJckvB595yEunQtYQEgfn7R8k8HWV+LLUNS60YMlOH1Zkd5d9VUWx+t JDfLRVpOoERIyNiwmcUVhAn21klJwGW45hpxbqCo8YLoRT5s1gLXCmeDBVrJpBA= -----END CERTIFICATE----- OISTE WISeKey Global Root GC CA =============================== -----BEGIN CERTIFICATE----- MIICaTCCAe+gAwIBAgIQISpWDK7aDKtARb8roi066jAKBggqhkjOPQQDAzBtMQswCQYDVQQGEwJD SDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUgRm91bmRhdGlvbiBFbmRvcnNlZDEo MCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9iYWwgUm9vdCBHQyBDQTAeFw0xNzA1MDkwOTQ4MzRa Fw00MjA1MDkwOTU4MzNaMG0xCzAJBgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQL ExlPSVNURSBGb3VuZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2Jh bCBSb290IEdDIENBMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAETOlQwMYPchi82PG6s4nieUqjFqdr VCTbUf/q9Akkwwsin8tqJ4KBDdLArzHkdIJuyiXZjHWd8dvQmqJLIX4Wp2OQ0jnUsYd4XxiWD1Ab NTcPasbc2RNNpI6QN+a9WzGRo1QwUjAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAd BgNVHQ4EFgQUSIcUrOPDnpBgOtfKie7TrYy0UGYwEAYJKwYBBAGCNxUBBAMCAQAwCgYIKoZIzj0E AwMDaAAwZQIwJsdpW9zV57LnyAyMjMPdeYwbY9XJUpROTYJKcx6ygISpJcBMWm1JKWB4E+J+SOtk AjEA2zQgMgj/mkkCtojeFK9dbJlxjRo/i9fgojaGHAeCOnZT/cKi7e97sIBPWA9LUzm9 -----END CERTIFICATE----- UCA Global G2 Root ================== -----BEGIN CERTIFICATE----- MIIFRjCCAy6gAwIBAgIQXd+x2lqj7V2+WmUgZQOQ7zANBgkqhkiG9w0BAQsFADA9MQswCQYDVQQG EwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxGzAZBgNVBAMMElVDQSBHbG9iYWwgRzIgUm9vdDAeFw0x NjAzMTEwMDAwMDBaFw00MDEyMzEwMDAwMDBaMD0xCzAJBgNVBAYTAkNOMREwDwYDVQQKDAhVbmlU cnVzdDEbMBkGA1UEAwwSVUNBIEdsb2JhbCBHMiBSb290MIICIjANBgkqhkiG9w0BAQEFAAOCAg8A MIICCgKCAgEAxeYrb3zvJgUno4Ek2m/LAfmZmqkywiKHYUGRO8vDaBsGxUypK8FnFyIdK+35KYmT oni9kmugow2ifsqTs6bRjDXVdfkX9s9FxeV67HeToI8jrg4aA3++1NDtLnurRiNb/yzmVHqUwCoV 8MmNsHo7JOHXaOIxPAYzRrZUEaalLyJUKlgNAQLx+hVRZ2zA+te2G3/RVogvGjqNO7uCEeBHANBS h6v7hn4PJGtAnTRnvI3HLYZveT6OqTwXS3+wmeOwcWDcC/Vkw85DvG1xudLeJ1uK6NjGruFZfc8o LTW4lVYa8bJYS7cSN8h8s+1LgOGN+jIjtm+3SJUIsUROhYw6AlQgL9+/V087OpAh18EmNVQg7Mc/ R+zvWr9LesGtOxdQXGLYD0tK3Cv6brxzks3sx1DoQZbXqX5t2Okdj4q1uViSukqSKwxW/YDrCPBe KW4bHAyvj5OJrdu9o54hyokZ7N+1wxrrFv54NkzWbtA+FxyQF2smuvt6L78RHBgOLXMDj6DlNaBa 4kx1HXHhOThTeEDMg5PXCp6dW4+K5OXgSORIskfNTip1KnvyIvbJvgmRlld6iIis7nCs+dwp4wwc OxJORNanTrAmyPPZGpeRaOrvjUYG0lZFWJo8DA+DuAUlwznPO6Q0ibd5Ei9Hxeepl2n8pndntd97 8XplFeRhVmUCAwEAAaNCMEAwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0O BBYEFIHEjMz15DD/pQwIX4wVZyF0Ad/fMA0GCSqGSIb3DQEBCwUAA4ICAQATZSL1jiutROTL/7lo 5sOASD0Ee/ojL3rtNtqyzm325p7lX1iPyzcyochltq44PTUbPrw7tgTQvPlJ9Zv3hcU2tsu8+Mg5 1eRfB70VVJd0ysrtT7q6ZHafgbiERUlMjW+i67HM0cOU2kTC5uLqGOiiHycFutfl1qnN3e92mI0A Ds0b+gO3joBYDic/UvuUospeZcnWhNq5NXHzJsBPd+aBJ9J3O5oUb3n09tDh05S60FdRvScFDcH9 yBIw7m+NESsIndTUv4BFFJqIRNow6rSn4+7vW4LVPtateJLbXDzz2K36uGt/xDYotgIVilQsnLAX c47QN6MUPJiVAAwpBVueSUmxX8fjy88nZY41F7dXyDDZQVu5FLbowg+UMaeUmMxq67XhJ/UQqAHo jhJi6IjMtX9Gl8CbEGY4GjZGXyJoPd/JxhMnq1MGrKI8hgZlb7F+sSlEmqO6SWkoaY/X5V+tBIZk bxqgDMUIYs6Ao9Dz7GjevjPHF1t/gMRMTLGmhIrDO7gJzRSBuhjjVFc2/tsvfEehOjPI+Vg7RE+x ygKJBJYoaMVLuCaJu9YzL1DV/pqJuhgyklTGW+Cd+V7lDSKb9triyCGyYiGqhkCyLmTTX8jjfhFn RR8F/uOi77Oos/N9j/gMHyIfLXC0uAE0djAA5SN4p1bXUB+K+wb1whnw0A== -----END CERTIFICATE----- UCA Extended Validation Root ============================ -----BEGIN CERTIFICATE----- MIIFWjCCA0KgAwIBAgIQT9Irj/VkyDOeTzRYZiNwYDANBgkqhkiG9w0BAQsFADBHMQswCQYDVQQG EwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNVBAMMHFVDQSBFeHRlbmRlZCBWYWxpZGF0aW9u IFJvb3QwHhcNMTUwMzEzMDAwMDAwWhcNMzgxMjMxMDAwMDAwWjBHMQswCQYDVQQGEwJDTjERMA8G A1UECgwIVW5pVHJ1c3QxJTAjBgNVBAMMHFVDQSBFeHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwggIi MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCpCQcoEwKwmeBkqh5DFnpzsZGgdT6o+uM4AHrs iWogD4vFsJszA1qGxliG1cGFu0/GnEBNyr7uaZa4rYEwmnySBesFK5pI0Lh2PpbIILvSsPGP2KxF Rv+qZ2C0d35qHzwaUnoEPQc8hQ2E0B92CvdqFN9y4zR8V05WAT558aopO2z6+I9tTcg1367r3CTu eUWnhbYFiN6IXSV8l2RnCdm/WhUFhvMJHuxYMjMR83dksHYf5BA1FxvyDrFspCqjc/wJHx4yGVMR 59mzLC52LqGj3n5qiAno8geK+LLNEOfic0CTuwjRP+H8C5SzJe98ptfRr5//lpr1kXuYC3fUfugH 0mK1lTnj8/FtDw5lhIpjVMWAtuCeS31HJqcBCF3RiJ7XwzJE+oJKCmhUfzhTA8ykADNkUVkLo4KR el7sFsLzKuZi2irbWWIQJUoqgQtHB0MGcIfS+pMRKXpITeuUx3BNr2fVUbGAIAEBtHoIppB/TuDv B0GHr2qlXov7z1CymlSvw4m6WC31MJixNnI5fkkE/SmnTHnkBVfblLkWU41Gsx2VYVdWf6/wFlth WG82UBEL2KwrlRYaDh8IzTY0ZRBiZtWAXxQgXy0MoHgKaNYs1+lvK9JKBZP8nm9rZ/+I8U6laUpS NwXqxhaN0sSZ0YIrO7o1dfdRUVjzyAfd5LQDfwIDAQABo0IwQDAdBgNVHQ4EFgQU2XQ65DA9DfcS 3H5aBZ8eNJr34RQwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQEL BQADggIBADaNl8xCFWQpN5smLNb7rhVpLGsaGvdftvkHTFnq88nIua7Mui563MD1sC3AO6+fcAUR ap8lTwEpcOPlDOHqWnzcSbvBHiqB9RZLcpHIojG5qtr8nR/zXUACE/xOHAbKsxSQVBcZEhrxH9cM aVr2cXj0lH2RC47skFSOvG+hTKv8dGT9cZr4QQehzZHkPJrgmzI5c6sq1WnIeJEmMX3ixzDx/BR4 dxIOE/TdFpS/S2d7cFOFyrC78zhNLJA5wA3CXWvp4uXViI3WLL+rG761KIcSF3Ru/H38j9CHJrAb +7lsq+KePRXBOy5nAliRn+/4Qh8st2j1da3Ptfb/EX3C8CSlrdP6oDyp+l3cpaDvRKS+1ujl5BOW F3sGPjLtx7dCvHaj2GU4Kzg1USEODm8uNBNA4StnDG1KQTAYI1oyVZnJF+A83vbsea0rWBmirSwi GpWOvpaQXUJXxPkUAzUrHC1RVwinOt4/5Mi0A3PCwSaAuwtCH60NryZy2sy+s6ODWA2CxR9GUeOc GMyNm43sSet1UNWMKFnKdDTajAshqx7qG+XH/RU+wBeq+yNuJkbL+vmxcmtpzyKEC2IPrNkZAJSi djzULZrtBJ4tBmIQN1IchXIbJ+XMxjHsN+xjWZsLHXbMfjKaiJUINlK73nZfdklJrX+9ZSCyycEr dhh2n1ax -----END CERTIFICATE----- Certigna Root CA ================ -----BEGIN CERTIFICATE----- MIIGWzCCBEOgAwIBAgIRAMrpG4nxVQMNo+ZBbcTjpuEwDQYJKoZIhvcNAQELBQAwWjELMAkGA1UE BhMCRlIxEjAQBgNVBAoMCURoaW15b3RpczEcMBoGA1UECwwTMDAwMiA0ODE0NjMwODEwMDAzNjEZ MBcGA1UEAwwQQ2VydGlnbmEgUm9vdCBDQTAeFw0xMzEwMDEwODMyMjdaFw0zMzEwMDEwODMyMjda MFoxCzAJBgNVBAYTAkZSMRIwEAYDVQQKDAlEaGlteW90aXMxHDAaBgNVBAsMEzAwMDIgNDgxNDYz MDgxMDAwMzYxGTAXBgNVBAMMEENlcnRpZ25hIFJvb3QgQ0EwggIiMA0GCSqGSIb3DQEBAQUAA4IC DwAwggIKAoICAQDNGDllGlmx6mQWDoyUJJV8g9PFOSbcDO8WV43X2KyjQn+Cyu3NW9sOty3tRQgX stmzy9YXUnIo245Onoq2C/mehJpNdt4iKVzSs9IGPjA5qXSjklYcoW9MCiBtnyN6tMbaLOQdLNyz KNAT8kxOAkmhVECe5uUFoC2EyP+YbNDrihqECB63aCPuI9Vwzm1RaRDuoXrC0SIxwoKF0vJVdlB8 JXrJhFwLrN1CTivngqIkicuQstDuI7pmTLtipPlTWmR7fJj6o0ieD5Wupxj0auwuA0Wv8HT4Ks16 XdG+RCYyKfHx9WzMfgIhC59vpD++nVPiz32pLHxYGpfhPTc3GGYo0kDFUYqMwy3OU4gkWGQwFsWq 4NYKpkDfePb1BHxpE4S80dGnBs8B92jAqFe7OmGtBIyT46388NtEbVncSVmurJqZNjBBe3YzIoej wpKGbvlw7q6Hh5UbxHq9MfPU0uWZ/75I7HX1eBYdpnDBfzwboZL7z8g81sWTCo/1VTp2lc5ZmIoJ lXcymoO6LAQ6l73UL77XbJuiyn1tJslV1c/DeVIICZkHJC1kJWumIWmbat10TWuXekG9qxf5kBdI jzb5LdXF2+6qhUVB+s06RbFo5jZMm5BX7CO5hwjCxAnxl4YqKE3idMDaxIzb3+KhF1nOJFl0Mdp/ /TBt2dzhauH8XwIDAQABo4IBGjCCARYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYw HQYDVR0OBBYEFBiHVuBud+4kNTxOc5of1uHieX4rMB8GA1UdIwQYMBaAFBiHVuBud+4kNTxOc5of 1uHieX4rMEQGA1UdIAQ9MDswOQYEVR0gADAxMC8GCCsGAQUFBwIBFiNodHRwczovL3d3d3cuY2Vy dGlnbmEuZnIvYXV0b3JpdGVzLzBtBgNVHR8EZjBkMC+gLaArhilodHRwOi8vY3JsLmNlcnRpZ25h LmZyL2NlcnRpZ25hcm9vdGNhLmNybDAxoC+gLYYraHR0cDovL2NybC5kaGlteW90aXMuY29tL2Nl cnRpZ25hcm9vdGNhLmNybDANBgkqhkiG9w0BAQsFAAOCAgEAlLieT/DjlQgi581oQfccVdV8AOIt OoldaDgvUSILSo3L6btdPrtcPbEo/uRTVRPPoZAbAh1fZkYJMyjhDSSXcNMQH+pkV5a7XdrnxIxP TGRGHVyH41neQtGbqH6mid2PHMkwgu07nM3A6RngatgCdTer9zQoKJHyBApPNeNgJgH60BGM+RFq 7q89w1DTj18zeTyGqHNFkIwgtnJzFyO+B2XleJINugHA64wcZr+shncBlA2c5uk5jR+mUYyZDDl3 4bSb+hxnV29qao6pK0xXeXpXIs/NX2NGjVxZOob4Mkdio2cNGJHc+6Zr9UhhcyNZjgKnvETq9Emd 8VRY+WCv2hikLyhF3HqgiIZd8zvn/yk1gPxkQ5Tm4xxvvq0OKmOZK8l+hfZx6AYDlf7ej0gcWtSS 6Cvu5zHbugRqh5jnxV/vfaci9wHYTfmJ0A6aBVmknpjZbyvKcL5kwlWj9Omvw5Ip3IgWJJk8jSaY tlu3zM63Nwf9JtmYhST/WSMDmu2dnajkXjjO11INb9I/bbEFa0nOipFGc/T2L/Coc3cOZayhjWZS aX5LaAzHHjcng6WMxwLkFM1JAbBzs/3GkDpv0mztO+7skb6iQ12LAEpmJURw3kAP+HwV96LOPNde E4yBFxgX0b3xdxA61GU5wSesVywlVP+i2k+KYTlerj1KjL0= -----END CERTIFICATE----- emSign Root CA - G1 =================== -----BEGIN CERTIFICATE----- MIIDlDCCAnygAwIBAgIKMfXkYgxsWO3W2DANBgkqhkiG9w0BAQsFADBnMQswCQYDVQQGEwJJTjET MBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNobm9sb2dpZXMgTGltaXRl ZDEcMBoGA1UEAxMTZW1TaWduIFJvb3QgQ0EgLSBHMTAeFw0xODAyMTgxODMwMDBaFw00MzAyMTgx ODMwMDBaMGcxCzAJBgNVBAYTAklOMRMwEQYDVQQLEwplbVNpZ24gUEtJMSUwIwYDVQQKExxlTXVk aHJhIFRlY2hub2xvZ2llcyBMaW1pdGVkMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEcxMIIB IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAk0u76WaK7p1b1TST0Bsew+eeuGQzf2N4aLTN LnF115sgxk0pvLZoYIr3IZpWNVrzdr3YzZr/k1ZLpVkGoZM0Kd0WNHVO8oG0x5ZOrRkVUkr+PHB1 cM2vK6sVmjM8qrOLqs1D/fXqcP/tzxE7lM5OMhbTI0Aqd7OvPAEsbO2ZLIvZTmmYsvePQbAyeGHW DV/D+qJAkh1cF+ZwPjXnorfCYuKrpDhMtTk1b+oDafo6VGiFbdbyL0NVHpENDtjVaqSW0RM8LHhQ 6DqS0hdW5TUaQBw+jSztOd9C4INBdN+jzcKGYEho42kLVACL5HZpIQ15TjQIXhTCzLG3rdd8cIrH hQIDAQABo0IwQDAdBgNVHQ4EFgQU++8Nhp6w492pufEhF38+/PB3KxowDgYDVR0PAQH/BAQDAgEG MA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAFn/8oz1h31xPaOfG1vR2vjTnGs2 vZupYeveFix0PZ7mddrXuqe8QhfnPZHr5X3dPpzxz5KsbEjMwiI/aTvFthUvozXGaCocV685743Q NcMYDHsAVhzNixl03r4PEuDQqqE/AjSxcM6dGNYIAwlG7mDgfrbESQRRfXBgvKqy/3lyeqYdPV8q +Mri/Tm3R7nrft8EI6/6nAYH6ftjk4BAtcZsCjEozgyfz7MjNYBBjWzEN3uBL4ChQEKF6dk4jeih U80Bv2noWgbyRQuQ+q7hv53yrlc8pa6yVvSLZUDp/TGBLPQ5Cdjua6e0ph0VpZj3AYHYhX3zUVxx iN66zB+Afko= -----END CERTIFICATE----- emSign ECC Root CA - G3 ======================= -----BEGIN CERTIFICATE----- MIICTjCCAdOgAwIBAgIKPPYHqWhwDtqLhDAKBggqhkjOPQQDAzBrMQswCQYDVQQGEwJJTjETMBEG A1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNobm9sb2dpZXMgTGltaXRlZDEg MB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0gRzMwHhcNMTgwMjE4MTgzMDAwWhcNNDMwMjE4 MTgzMDAwWjBrMQswCQYDVQQGEwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11 ZGhyYSBUZWNobm9sb2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0g RzMwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQjpQy4LRL1KPOxst3iAhKAnjlfSU2fySU0WXTsuwYc 58Byr+iuL+FBVIcUqEqy6HyC5ltqtdyzdc6LBtCGI79G1Y4PPwT01xySfvalY8L1X44uT6EYGQIr MgqCZH0Wk9GjQjBAMB0GA1UdDgQWBBR8XQKEE9TMipuBzhccLikenEhjQjAOBgNVHQ8BAf8EBAMC AQYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNpADBmAjEAvvNhzwIQHWSVB7gYboiFBS+D CBeQyh+KTOgNG3qxrdWBCUfvO6wIBHxcmbHtRwfSAjEAnbpV/KlK6O3t5nYBQnvI+GDZjVGLVTv7 jHvrZQnD+JbNR6iC8hZVdyR+EhCVBCyj -----END CERTIFICATE----- emSign Root CA - C1 =================== -----BEGIN CERTIFICATE----- MIIDczCCAlugAwIBAgILAK7PALrEzzL4Q7IwDQYJKoZIhvcNAQELBQAwVjELMAkGA1UEBhMCVVMx EzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMRwwGgYDVQQDExNlbVNp Z24gUm9vdCBDQSAtIEMxMB4XDTE4MDIxODE4MzAwMFoXDTQzMDIxODE4MzAwMFowVjELMAkGA1UE BhMCVVMxEzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMRwwGgYDVQQD ExNlbVNpZ24gUm9vdCBDQSAtIEMxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAz+up ufGZBczYKCFK83M0UYRWEPWgTywS4/oTmifQz/l5GnRfHXk5/Fv4cI7gklL35CX5VIPZHdPIWoU/ Xse2B+4+wM6ar6xWQio5JXDWv7V7Nq2s9nPczdcdioOl+yuQFTdrHCZH3DspVpNqs8FqOp099cGX OFgFixwR4+S0uF2FHYP+eF8LRWgYSKVGczQ7/g/IdrvHGPMF0Ybzhe3nudkyrVWIzqa2kbBPrH4V I5b2P/AgNBbeCsbEBEV5f6f9vtKppa+cxSMq9zwhbL2vj07FOrLzNBL834AaSaTUqZX3noleooms lMuoaJuvimUnzYnu3Yy1aylwQ6BpC+S5DwIDAQABo0IwQDAdBgNVHQ4EFgQU/qHgcB4qAzlSWkK+ XJGFehiqTbUwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQAD ggEBAMJKVvoVIXsoounlHfv4LcQ5lkFMOycsxGwYFYDGrK9HWS8mC+M2sO87/kOXSTKZEhVb3xEp /6tT+LvBeA+snFOvV71ojD1pM/CjoCNjO2RnIkSt1XHLVip4kqNPEjE2NuLe/gDEo2APJ62gsIq1 NnpSob0n9CAnYuhNlCQT5AoE6TyrLshDCUrGYQTlSTR+08TI9Q/Aqum6VF7zYytPT1DU/rl7mYw9 wC68AivTxEDkigcxHpvOJpkT+xHqmiIMERnHXhuBUDDIlhJu58tBf5E7oke3VIAb3ADMmpDqw8NQ BmIMMMAVSKeoWXzhriKi4gp6D/piq1JM4fHfyr6DDUI= -----END CERTIFICATE----- emSign ECC Root CA - C3 ======================= -----BEGIN CERTIFICATE----- MIICKzCCAbGgAwIBAgIKe3G2gla4EnycqDAKBggqhkjOPQQDAzBaMQswCQYDVQQGEwJVUzETMBEG A1UECxMKZW1TaWduIFBLSTEUMBIGA1UEChMLZU11ZGhyYSBJbmMxIDAeBgNVBAMTF2VtU2lnbiBF Q0MgUm9vdCBDQSAtIEMzMB4XDTE4MDIxODE4MzAwMFoXDTQzMDIxODE4MzAwMFowWjELMAkGA1UE BhMCVVMxEzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMSAwHgYDVQQD ExdlbVNpZ24gRUNDIFJvb3QgQ0EgLSBDMzB2MBAGByqGSM49AgEGBSuBBAAiA2IABP2lYa57JhAd 6bciMK4G9IGzsUJxlTm801Ljr6/58pc1kjZGDoeVjbk5Wum739D+yAdBPLtVb4OjavtisIGJAnB9 SMVK4+kiVCJNk7tCDK93nCOmfddhEc5lx/h//vXyqaNCMEAwHQYDVR0OBBYEFPtaSNCAIEDyqOkA B2kZd6fmw/TPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MAoGCCqGSM49BAMDA2gA MGUCMQC02C8Cif22TGK6Q04ThHK1rt0c3ta13FaPWEBaLd4gTCKDypOofu4SQMfWh0/434UCMBwU ZOR8loMRnLDRWmFLpg9J0wD8ofzkpf9/rdcw0Md3f76BB1UwUCAU9Vc4CqgxUQ== -----END CERTIFICATE----- Hongkong Post Root CA 3 ======================= -----BEGIN CERTIFICATE----- MIIFzzCCA7egAwIBAgIUCBZfikyl7ADJk0DfxMauI7gcWqQwDQYJKoZIhvcNAQELBQAwbzELMAkG A1UEBhMCSEsxEjAQBgNVBAgTCUhvbmcgS29uZzESMBAGA1UEBxMJSG9uZyBLb25nMRYwFAYDVQQK Ew1Ib25na29uZyBQb3N0MSAwHgYDVQQDExdIb25na29uZyBQb3N0IFJvb3QgQ0EgMzAeFw0xNzA2 MDMwMjI5NDZaFw00MjA2MDMwMjI5NDZaMG8xCzAJBgNVBAYTAkhLMRIwEAYDVQQIEwlIb25nIEtv bmcxEjAQBgNVBAcTCUhvbmcgS29uZzEWMBQGA1UEChMNSG9uZ2tvbmcgUG9zdDEgMB4GA1UEAxMX SG9uZ2tvbmcgUG9zdCBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCz iNfqzg8gTr7m1gNt7ln8wlffKWihgw4+aMdoWJwcYEuJQwy51BWy7sFOdem1p+/l6TWZ5Mwc50tf jTMwIDNT2aa71T4Tjukfh0mtUC1Qyhi+AViiE3CWu4mIVoBc+L0sPOFMV4i707mV78vH9toxdCim 5lSJ9UExyuUmGs2C4HDaOym71QP1mbpV9WTRYA6ziUm4ii8F0oRFKHyPaFASePwLtVPLwpgchKOe sL4jpNrcyCse2m5FHomY2vkALgbpDDtw1VAliJnLzXNg99X/NWfFobxeq81KuEXryGgeDQ0URhLj 0mRiikKYvLTGCAj4/ahMZJx2Ab0vqWwzD9g/KLg8aQFChn5pwckGyuV6RmXpwtZQQS4/t+TtbNe/ JgERohYpSms0BpDsE9K2+2p20jzt8NYt3eEV7KObLyzJPivkaTv/ciWxNoZbx39ri1UbSsUgYT2u y1DhCDq+sI9jQVMwCFk8mB13umOResoQUGC/8Ne8lYePl8X+l2oBlKN8W4UdKjk60FSh0Tlxnf0h +bV78OLgAo9uliQlLKAeLKjEiafv7ZkGL7YKTE/bosw3Gq9HhS2KX8Q0NEwA/RiTZxPRN+ZItIsG xVd7GYYKecsAyVKvQv83j+GjHno9UKtjBucVtT+2RTeUN7F+8kjDf8V1/peNRY8apxpyKBpADwID AQABo2MwYTAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAfBgNVHSMEGDAWgBQXnc0e i9Y5K3DTXNSguB+wAPzFYTAdBgNVHQ4EFgQUF53NHovWOStw01zUoLgfsAD8xWEwDQYJKoZIhvcN AQELBQADggIBAFbVe27mIgHSQpsY1Q7XZiNc4/6gx5LS6ZStS6LG7BJ8dNVI0lkUmcDrudHr9Egw W62nV3OZqdPlt9EuWSRY3GguLmLYauRwCy0gUCCkMpXRAJi70/33MvJJrsZ64Ee+bs7Lo3I6LWld y8joRTnU+kLBEUx3XZL7av9YROXrgZ6voJmtvqkBZss4HTzfQx/0TW60uhdG/H39h4F5ag0zD/ov +BS5gLNdTaqX4fnkGMX41TiMJjz98iji7lpJiCzfeT2OnpA8vUFKOt1b9pq0zj8lMH8yfaIDlNDc eqFS3m6TjRgm/VWsvY+b0s+v54Ysyx8Jb6NvqYTUc79NoXQbTiNg8swOqn+knEwlqLJmOzj/2ZQw 9nKEvmhVEA/GcywWaZMH/rFF7buiVWqw2rVKAiUnhde3t4ZEFolsgCs+l6mc1X5VTMbeRRAc6uk7 nwNT7u56AQIWeNTowr5GdogTPyK7SBIdUgC0An4hGh6cJfTzPV4e0hz5sy229zdcxsshTrD3mUcY hcErulWuBurQB7Lcq9CClnXO0lD+mefPL5/ndtFhKvshuzHQqp9HpLIiyhY6UFfEW0NnxWViA0kB 60PZ2Pierc+xYw5F9KBaLJstxabArahH9CdMOA0uG0k7UvToiIMrVCjU8jVStDKDYmlkDJGcn5fq dBb9HxEGmpv0 -----END CERTIFICATE----- Entrust Root Certification Authority - G4 ========================================= -----BEGIN CERTIFICATE----- MIIGSzCCBDOgAwIBAgIRANm1Q3+vqTkPAAAAAFVlrVgwDQYJKoZIhvcNAQELBQAwgb4xCzAJBgNV BAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1c3Qu bmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxNSBFbnRydXN0LCBJbmMuIC0gZm9yIGF1 dGhvcml6ZWQgdXNlIG9ubHkxMjAwBgNVBAMTKUVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1 dGhvcml0eSAtIEc0MB4XDTE1MDUyNzExMTExNloXDTM3MTIyNzExNDExNlowgb4xCzAJBgNVBAYT AlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1c3QubmV0 L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxNSBFbnRydXN0LCBJbmMuIC0gZm9yIGF1dGhv cml6ZWQgdXNlIG9ubHkxMjAwBgNVBAMTKUVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhv cml0eSAtIEc0MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAsewsQu7i0TD/pZJH4i3D umSXbcr3DbVZwbPLqGgZ2K+EbTBwXX7zLtJTmeH+H17ZSK9dE43b/2MzTdMAArzE+NEGCJR5WIoV 3imz/f3ET+iq4qA7ec2/a0My3dl0ELn39GjUu9CH1apLiipvKgS1sqbHoHrmSKvS0VnM1n4j5pds 8ELl3FFLFUHtSUrJ3hCX1nbB76W1NhSXNdh4IjVS70O92yfbYVaCNNzLiGAMC1rlLAHGVK/XqsEQ e9IFWrhAnoanw5CGAlZSCXqc0ieCU0plUmr1POeo8pyvi73TDtTUXm6Hnmo9RR3RXRv06QqsYJn7 ibT/mCzPfB3pAqoEmh643IhuJbNsZvc8kPNXwbMv9W3y+8qh+CmdRouzavbmZwe+LGcKKh9asj5X xNMhIWNlUpEbsZmOeX7m640A2Vqq6nPopIICR5b+W45UYaPrL0swsIsjdXJ8ITzI9vF01Bx7owVV 7rtNOzK+mndmnqxpkCIHH2E6lr7lmk/MBTwoWdPBDFSoWWG9yHJM6Nyfh3+9nEg2XpWjDrk4JFX8 dWbrAuMINClKxuMrLzOg2qOGpRKX/YAr2hRC45K9PvJdXmd0LhyIRyk0X+IyqJwlN4y6mACXi0mW Hv0liqzc2thddG5msP9E36EYxr5ILzeUePiVSj9/E15dWf10hkNjc0kCAwEAAaNCMEAwDwYDVR0T AQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFJ84xFYjwznooHFs6FRM5Og6sb9n MA0GCSqGSIb3DQEBCwUAA4ICAQAS5UKme4sPDORGpbZgQIeMJX6tuGguW8ZAdjwD+MlZ9POrYs4Q jbRaZIxowLByQzTSGwv2LFPSypBLhmb8qoMi9IsabyZIrHZ3CL/FmFz0Jomee8O5ZDIBf9PD3Vht 7LGrhFV0d4QEJ1JrhkzO3bll/9bGXp+aEJlLdWr+aumXIOTkdnrG0CSqkM0gkLpHZPt/B7NTeLUK YvJzQ85BK4FqLoUWlFPUa19yIqtRLULVAJyZv967lDtX/Zr1hstWO1uIAeV8KEsD+UmDfLJ/fOPt jqF/YFOOVZ1QNBIPt5d7bIdKROf1beyAN/BYGW5KaHbwH5Lk6rWS02FREAutp9lfx1/cH6NcjKF+ m7ee01ZvZl4HliDtC3T7Zk6LERXpgUl+b7DUUH8i119lAg2m9IUe2K4GS0qn0jFmwvjO5QimpAKW RGhXxNUzzxkvFMSUHHuk2fCfDrGA4tGeEWSpiBE6doLlYsKA2KSD7ZPvfC+QsDJMlhVoSFLUmQjA JOgc47OlIQ6SwJAfzyBfyjs4x7dtOvPmRLgOMWuIjnDrnBdSqEGULoe256YSxXXfW8AKbnuk5F6G +TaU33fD6Q3AOfF5u0aOq0NZJ7cguyPpVkAh7DE9ZapD8j3fcEThuk0mEDuYn/PIjhs4ViFqUZPT kcpG2om3PVODLAgfi49T3f+sHw== -----END CERTIFICATE----- Microsoft ECC Root Certificate Authority 2017 ============================================= -----BEGIN CERTIFICATE----- MIICWTCCAd+gAwIBAgIQZvI9r4fei7FK6gxXMQHC7DAKBggqhkjOPQQDAzBlMQswCQYDVQQGEwJV UzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1NaWNyb3NvZnQgRUND IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwHhcNMTkxMjE4MjMwNjQ1WhcNNDIwNzE4 MjMxNjA0WjBlMQswCQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYw NAYDVQQDEy1NaWNyb3NvZnQgRUNDIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwdjAQ BgcqhkjOPQIBBgUrgQQAIgNiAATUvD0CQnVBEyPNgASGAlEvaqiBYgtlzPbKnR5vSmZRogPZnZH6 thaxjG7efM3beaYvzrvOcS/lpaso7GMEZpn4+vKTEAXhgShC48Zo9OYbhGBKia/teQ87zvH2RPUB eMCjVDBSMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTIy5lycFIM +Oa+sgRXKSrPQhDtNTAQBgkrBgEEAYI3FQEEAwIBADAKBggqhkjOPQQDAwNoADBlAjBY8k3qDPlf Xu5gKcs68tvWMoQZP3zVL8KxzJOuULsJMsbG7X7JNpQS5GiFBqIb0C8CMQCZ6Ra0DvpWSNSkMBaR eNtUjGUBiudQZsIxtzm6uBoiB078a1QWIP8rtedMDE2mT3M= -----END CERTIFICATE----- Microsoft RSA Root Certificate Authority 2017 ============================================= -----BEGIN CERTIFICATE----- MIIFqDCCA5CgAwIBAgIQHtOXCV/YtLNHcB6qvn9FszANBgkqhkiG9w0BAQwFADBlMQswCQYDVQQG EwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTYwNAYDVQQDEy1NaWNyb3NvZnQg UlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcwHhcNMTkxMjE4MjI1MTIyWhcNNDIw NzE4MjMwMDIzWjBlMQswCQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9u MTYwNAYDVQQDEy1NaWNyb3NvZnQgUlNBIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTcw ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKW76UM4wplZEWCpW9R2LBifOZNt9GkMml 7Xhqb0eRaPgnZ1AzHaGm++DlQ6OEAlcBXZxIQIJTELy/xztokLaCLeX0ZdDMbRnMlfl7rEqUrQ7e S0MdhweSE5CAg2Q1OQT85elss7YfUJQ4ZVBcF0a5toW1HLUX6NZFndiyJrDKxHBKrmCk3bPZ7Pw7 1VdyvD/IybLeS2v4I2wDwAW9lcfNcztmgGTjGqwu+UcF8ga2m3P1eDNbx6H7JyqhtJqRjJHTOoI+ dkC0zVJhUXAoP8XFWvLJjEm7FFtNyP9nTUwSlq31/niol4fX/V4ggNyhSyL71Imtus5Hl0dVe49F yGcohJUcaDDv70ngNXtk55iwlNpNhTs+VcQor1fznhPbRiefHqJeRIOkpcrVE7NLP8TjwuaGYaRS MLl6IE9vDzhTyzMMEyuP1pq9KsgtsRx9S1HKR9FIJ3Jdh+vVReZIZZ2vUpC6W6IYZVcSn2i51BVr lMRpIpj0M+Dt+VGOQVDJNE92kKz8OMHY4Xu54+OU4UZpyw4KUGsTuqwPN1q3ErWQgR5WrlcihtnJ 0tHXUeOrO8ZV/R4O03QK0dqq6mm4lyiPSMQH+FJDOvTKVTUssKZqwJz58oHhEmrARdlns87/I6KJ ClTUFLkqqNfs+avNJVgyeY+QW5g5xAgGwax/Dj0ApQIDAQABo1QwUjAOBgNVHQ8BAf8EBAMCAYYw DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUCctZf4aycI8awznjwNnpv7tNsiMwEAYJKwYBBAGC NxUBBAMCAQAwDQYJKoZIhvcNAQEMBQADggIBAKyvPl3CEZaJjqPnktaXFbgToqZCLgLNFgVZJ8og 6Lq46BrsTaiXVq5lQ7GPAJtSzVXNUzltYkyLDVt8LkS/gxCP81OCgMNPOsduET/m4xaRhPtthH80 dK2Jp86519efhGSSvpWhrQlTM93uCupKUY5vVau6tZRGrox/2KJQJWVggEbbMwSubLWYdFQl3JPk +ONVFT24bcMKpBLBaYVu32TxU5nhSnUgnZUP5NbcA/FZGOhHibJXWpS2qdgXKxdJ5XbLwVaZOjex /2kskZGT4d9Mozd2TaGf+G0eHdP67Pv0RR0Tbc/3WeUiJ3IrhvNXuzDtJE3cfVa7o7P4NHmJweDy AmH3pvwPuxwXC65B2Xy9J6P9LjrRk5Sxcx0ki69bIImtt2dmefU6xqaWM/5TkshGsRGRxpl/j8nW ZjEgQRCHLQzWwa80mMpkg/sTV9HB8Dx6jKXB/ZUhoHHBk2dxEuqPiAppGWSZI1b7rCoucL5mxAyE 7+WL85MB+GqQk2dLsmijtWKP6T+MejteD+eMuMZ87zf9dOLITzNy4ZQ5bb0Sr74MTnB8G2+NszKT c0QWbej09+CVgI+WXTik9KveCjCHk9hNAHFiRSdLOkKEW39lt2c0Ui2cFmuqqNh7o0JMcccMyj6D 5KbvtwEwXlGjefVwaaZBRA+GsCyRxj3qrg+E -----END CERTIFICATE----- e-Szigno Root CA 2017 ===================== -----BEGIN CERTIFICATE----- MIICQDCCAeWgAwIBAgIMAVRI7yH9l1kN9QQKMAoGCCqGSM49BAMCMHExCzAJBgNVBAYTAkhVMREw DwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UECgwNTWljcm9zZWMgTHRkLjEXMBUGA1UEYQwOVkFUSFUt MjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3ppZ25vIFJvb3QgQ0EgMjAxNzAeFw0xNzA4MjIxMjA3MDZa Fw00MjA4MjIxMjA3MDZaMHExCzAJBgNVBAYTAkhVMREwDwYDVQQHDAhCdWRhcGVzdDEWMBQGA1UE CgwNTWljcm9zZWMgTHRkLjEXMBUGA1UEYQwOVkFUSFUtMjM1ODQ0OTcxHjAcBgNVBAMMFWUtU3pp Z25vIFJvb3QgQ0EgMjAxNzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABJbcPYrYsHtvxie+RJCx s1YVe45DJH0ahFnuY2iyxl6H0BVIHqiQrb1TotreOpCmYF9oMrWGQd+HWyx7xf58etqjYzBhMA8G A1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBSHERUI0arBeAyxr87GyZDv vzAEwDAfBgNVHSMEGDAWgBSHERUI0arBeAyxr87GyZDvvzAEwDAKBggqhkjOPQQDAgNJADBGAiEA tVfd14pVCzbhhkT61NlojbjcI4qKDdQvfepz7L9NbKgCIQDLpbQS+ue16M9+k/zzNY9vTlp8tLxO svxyqltZ+efcMQ== -----END CERTIFICATE----- certSIGN Root CA G2 =================== -----BEGIN CERTIFICATE----- MIIFRzCCAy+gAwIBAgIJEQA0tk7GNi02MA0GCSqGSIb3DQEBCwUAMEExCzAJBgNVBAYTAlJPMRQw EgYDVQQKEwtDRVJUU0lHTiBTQTEcMBoGA1UECxMTY2VydFNJR04gUk9PVCBDQSBHMjAeFw0xNzAy MDYwOTI3MzVaFw00MjAyMDYwOTI3MzVaMEExCzAJBgNVBAYTAlJPMRQwEgYDVQQKEwtDRVJUU0lH TiBTQTEcMBoGA1UECxMTY2VydFNJR04gUk9PVCBDQSBHMjCCAiIwDQYJKoZIhvcNAQEBBQADggIP ADCCAgoCggIBAMDFdRmRfUR0dIf+DjuW3NgBFszuY5HnC2/OOwppGnzC46+CjobXXo9X69MhWf05 N0IwvlDqtg+piNguLWkh59E3GE59kdUWX2tbAMI5Qw02hVK5U2UPHULlj88F0+7cDBrZuIt4Imfk abBoxTzkbFpG583H+u/E7Eu9aqSs/cwoUe+StCmrqzWaTOTECMYmzPhpn+Sc8CnTXPnGFiWeI8Mg wT0PPzhAsP6CRDiqWhqKa2NYOLQV07YRaXseVO6MGiKscpc/I1mbySKEwQdPzH/iV8oScLumZfNp dWO9lfsbl83kqK/20U6o2YpxJM02PbyWxPFsqa7lzw1uKA2wDrXKUXt4FMMgL3/7FFXhEZn91Qqh ngLjYl/rNUssuHLoPj1PrCy7Lobio3aP5ZMqz6WryFyNSwb/EkaseMsUBzXgqd+L6a8VTxaJW732 jcZZroiFDsGJ6x9nxUWO/203Nit4ZoORUSs9/1F3dmKh7Gc+PoGD4FapUB8fepmrY7+EF3fxDTvf 95xhszWYijqy7DwaNz9+j5LP2RIUZNoQAhVB/0/E6xyjyfqZ90bp4RjZsbgyLcsUDFDYg2WD7rlc z8sFWkz6GZdr1l0T08JcVLwyc6B49fFtHsufpaafItzRUZ6CeWRgKRM+o/1Pcmqr4tTluCRVLERL iohEnMqE0yo7AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1Ud DgQWBBSCIS1mxteg4BXrzkwJd8RgnlRuAzANBgkqhkiG9w0BAQsFAAOCAgEAYN4auOfyYILVAzOB ywaK8SJJ6ejqkX/GM15oGQOGO0MBzwdw5AgeZYWR5hEit/UCI46uuR59H35s5r0l1ZUa8gWmr4UC b6741jH/JclKyMeKqdmfS0mbEVeZkkMR3rYzpMzXjWR91M08KCy0mpbqTfXERMQlqiCA2ClV9+BB /AYm/7k29UMUA2Z44RGx2iBfRgB4ACGlHgAoYXhvqAEBj500mv/0OJD7uNGzcgbJceaBxXntC6Z5 8hMLnPddDnskk7RI24Zf3lCGeOdA5jGokHZwYa+cNywRtYK3qq4kNFtyDGkNzVmf9nGvnAvRCjj5 BiKDUyUM/FHE5r7iOZULJK2v0ZXkltd0ZGtxTgI8qoXzIKNDOXZbbFD+mpwUHmUUihW9o4JFWklW atKcsWMy5WHgUyIOpwpJ6st+H6jiYoD2EEVSmAYY3qXNL3+q1Ok+CHLsIwMCPKaq2LxndD0UF/tU Sxfj03k9bWtJySgOLnRQvwzZRjoQhsmnP+mg7H/rpXdYaXHmgwo38oZJar55CJD2AhZkPuXaTH4M NMn5X7azKFGnpyuqSfqNZSlO42sTp5SjLVFteAxEy9/eCG/Oo2Sr05WE1LlSVHJ7liXMvGnjSG4N 0MedJ5qq+BOS3R7fY581qRY27Iy4g/Q9iY/NtBde17MXQRBdJ3NghVdJIgc= -----END CERTIFICATE----- Trustwave Global Certification Authority ======================================== -----BEGIN CERTIFICATE----- MIIF2jCCA8KgAwIBAgIMBfcOhtpJ80Y1LrqyMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJV UzERMA8GA1UECAwISWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28xITAfBgNVBAoMGFRydXN0d2F2 ZSBIb2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1c3R3YXZlIEdsb2JhbCBDZXJ0aWZpY2F0aW9u IEF1dGhvcml0eTAeFw0xNzA4MjMxOTM0MTJaFw00MjA4MjMxOTM0MTJaMIGIMQswCQYDVQQGEwJV UzERMA8GA1UECAwISWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28xITAfBgNVBAoMGFRydXN0d2F2 ZSBIb2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1c3R3YXZlIEdsb2JhbCBDZXJ0aWZpY2F0aW9u IEF1dGhvcml0eTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALldUShLPDeS0YLOvR29 zd24q88KPuFd5dyqCblXAj7mY2Hf8g+CY66j96xz0XznswuvCAAJWX/NKSqIk4cXGIDtiLK0thAf LdZfVaITXdHG6wZWiYj+rDKd/VzDBcdu7oaJuogDnXIhhpCujwOl3J+IKMujkkkP7NAP4m1ET4Bq stTnoApTAbqOl5F2brz81Ws25kCI1nsvXwXoLG0R8+eyvpJETNKXpP7ScoFDB5zpET71ixpZfR9o WN0EACyW80OzfpgZdNmcc9kYvkHHNHnZ9GLCQ7mzJ7Aiy/k9UscwR7PJPrhq4ufogXBeQotPJqX+ OsIgbrv4Fo7NDKm0G2x2EOFYeUY+VM6AqFcJNykbmROPDMjWLBz7BegIlT1lRtzuzWniTY+HKE40 Cz7PFNm73bZQmq131BnW2hqIyE4bJ3XYsgjxroMwuREOzYfwhI0Vcnyh78zyiGG69Gm7DIwLdVcE uE4qFC49DxweMqZiNu5m4iK4BUBjECLzMx10coos9TkpoNPnG4CELcU9402x/RpvumUHO1jsQkUm +9jaJXLE9gCxInm943xZYkqcBW89zubWR2OZxiRvchLIrH+QtAuRcOi35hYQcRfO3gZPSEF9NUqj ifLJS3tBEW1ntwiYTOURGa5CgNz7kAXU+FDKvuStx8KU1xad5hePrzb7AgMBAAGjQjBAMA8GA1Ud EwEB/wQFMAMBAf8wHQYDVR0OBBYEFJngGWcNYtt2s9o9uFvo/ULSMQ6HMA4GA1UdDwEB/wQEAwIB BjANBgkqhkiG9w0BAQsFAAOCAgEAmHNw4rDT7TnsTGDZqRKGFx6W0OhUKDtkLSGm+J1WE2pIPU/H PinbbViDVD2HfSMF1OQc3Og4ZYbFdada2zUFvXfeuyk3QAUHw5RSn8pk3fEbK9xGChACMf1KaA0H ZJDmHvUqoai7PF35owgLEQzxPy0QlG/+4jSHg9bP5Rs1bdID4bANqKCqRieCNqcVtgimQlRXtpla 4gt5kNdXElE1GYhBaCXUNxeEFfsBctyV3lImIJgm4nb1J2/6ADtKYdkNy1GTKv0WBpanI5ojSP5R vbbEsLFUzt5sQa0WZ37b/TjNuThOssFgy50X31ieemKyJo90lZvkWx3SD92YHJtZuSPTMaCm/zjd zyBP6VhWOmfD0faZmZ26NraAL4hHT4a/RDqA5Dccprrql5gR0IRiR2Qequ5AvzSxnI9O4fKSTx+O 856X3vOmeWqJcU9LJxdI/uz0UA9PSX3MReO9ekDFQdxhVicGaeVyQYHTtgGJoC86cnn+OjC/QezH Yj6RS8fZMXZC+fc8Y+wmjHMMfRod6qh8h6jCJ3zhM0EPz8/8AKAigJ5Kp28AsEFFtyLKaEjFQqKu 3R3y4G5OBVixwJAWKqQ9EEC+j2Jjg6mcgn0tAumDMHzLJ8n9HmYAsC7TIS+OMxZsmO0QqAfWzJPP 29FpHOTKyeC2nOnOcXHebD8WpHk= -----END CERTIFICATE----- Trustwave Global ECC P256 Certification Authority ================================================= -----BEGIN CERTIFICATE----- MIICYDCCAgegAwIBAgIMDWpfCD8oXD5Rld9dMAoGCCqGSM49BAMCMIGRMQswCQYDVQQGEwJVUzER MA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0d2F2ZSBI b2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBFQ0MgUDI1NiBDZXJ0aWZp Y2F0aW9uIEF1dGhvcml0eTAeFw0xNzA4MjMxOTM1MTBaFw00MjA4MjMxOTM1MTBaMIGRMQswCQYD VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRy dXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBFQ0MgUDI1 NiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABH77bOYj 43MyCMpg5lOcunSNGLB4kFKA3TjASh3RqMyTpJcGOMoNFWLGjgEqZZ2q3zSRLoHB5DOSMcT9CTqm P62jQzBBMA8GA1UdEwEB/wQFMAMBAf8wDwYDVR0PAQH/BAUDAwcGADAdBgNVHQ4EFgQUo0EGrJBt 0UrrdaVKEJmzsaGLSvcwCgYIKoZIzj0EAwIDRwAwRAIgB+ZU2g6gWrKuEZ+Hxbb/ad4lvvigtwjz RM4q3wghDDcCIC0mA6AFvWvR9lz4ZcyGbbOcNEhjhAnFjXca4syc4XR7 -----END CERTIFICATE----- Trustwave Global ECC P384 Certification Authority ================================================= -----BEGIN CERTIFICATE----- MIICnTCCAiSgAwIBAgIMCL2Fl2yZJ6SAaEc7MAoGCCqGSM49BAMDMIGRMQswCQYDVQQGEwJVUzER MA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0d2F2ZSBI b2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBFQ0MgUDM4NCBDZXJ0aWZp Y2F0aW9uIEF1dGhvcml0eTAeFw0xNzA4MjMxOTM2NDNaFw00MjA4MjMxOTM2NDNaMIGRMQswCQYD VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRy dXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBFQ0MgUDM4 NCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTB2MBAGByqGSM49AgEGBSuBBAAiA2IABGvaDXU1CDFH Ba5FmVXxERMuSvgQMSOjfoPTfygIOiYaOs+Xgh+AtycJj9GOMMQKmw6sWASr9zZ9lCOkmwqKi6vr /TklZvFe/oyujUF5nQlgziip04pt89ZF1PKYhDhloKNDMEEwDwYDVR0TAQH/BAUwAwEB/zAPBgNV HQ8BAf8EBQMDBwYAMB0GA1UdDgQWBBRVqYSJ0sEyvRjLbKYHTsjnnb6CkDAKBggqhkjOPQQDAwNn ADBkAjA3AZKXRRJ+oPM+rRk6ct30UJMDEr5E0k9BpIycnR+j9sKS50gU/k6bpZFXrsY3crsCMGcl CrEMXu6pY5Jv5ZAL/mYiykf9ijH3g/56vxC+GCsej/YpHpRZ744hN8tRmKVuSw== -----END CERTIFICATE----- NAVER Global Root Certification Authority ========================================= -----BEGIN CERTIFICATE----- MIIFojCCA4qgAwIBAgIUAZQwHqIL3fXFMyqxQ0Rx+NZQTQ0wDQYJKoZIhvcNAQEMBQAwaTELMAkG A1UEBhMCS1IxJjAkBgNVBAoMHU5BVkVSIEJVU0lORVNTIFBMQVRGT1JNIENvcnAuMTIwMAYDVQQD DClOQVZFUiBHbG9iYWwgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0xNzA4MTgwODU4 NDJaFw0zNzA4MTgyMzU5NTlaMGkxCzAJBgNVBAYTAktSMSYwJAYDVQQKDB1OQVZFUiBCVVNJTkVT UyBQTEFURk9STSBDb3JwLjEyMDAGA1UEAwwpTkFWRVIgR2xvYmFsIFJvb3QgQ2VydGlmaWNhdGlv biBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC21PGTXLVAiQqrDZBb UGOukJR0F0Vy1ntlWilLp1agS7gvQnXp2XskWjFlqxcX0TM62RHcQDaH38dq6SZeWYp34+hInDEW +j6RscrJo+KfziFTowI2MMtSAuXaMl3Dxeb57hHHi8lEHoSTGEq0n+USZGnQJoViAbbJAh2+g1G7 XNr4rRVqmfeSVPc0W+m/6imBEtRTkZazkVrd/pBzKPswRrXKCAfHcXLJZtM0l/aM9BhK4dA9WkW2 aacp+yPOiNgSnABIqKYPszuSjXEOdMWLyEz59JuOuDxp7W87UC9Y7cSw0BwbagzivESq2M0UXZR4 Yb8ObtoqvC8MC3GmsxY/nOb5zJ9TNeIDoKAYv7vxvvTWjIcNQvcGufFt7QSUqP620wbGQGHfnZ3z VHbOUzoBppJB7ASjjw2i1QnK1sua8e9DXcCrpUHPXFNwcMmIpi3Ua2FzUCaGYQ5fG8Ir4ozVu53B A0K6lNpfqbDKzE0K70dpAy8i+/Eozr9dUGWokG2zdLAIx6yo0es+nPxdGoMuK8u180SdOqcXYZai cdNwlhVNt0xz7hlcxVs+Qf6sdWA7G2POAN3aCJBitOUt7kinaxeZVL6HSuOpXgRM6xBtVNbv8ejy YhbLgGvtPe31HzClrkvJE+2KAQHJuFFYwGY6sWZLxNUxAmLpdIQM201GLQIDAQABo0IwQDAdBgNV HQ4EFgQU0p+I36HNLL3s9TsBAZMzJ7LrYEswDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMB Af8wDQYJKoZIhvcNAQEMBQADggIBADLKgLOdPVQG3dLSLvCkASELZ0jKbY7gyKoNqo0hV4/GPnrK 21HUUrPUloSlWGB/5QuOH/XcChWB5Tu2tyIvCZwTFrFsDDUIbatjcu3cvuzHV+YwIHHW1xDBE1UB jCpD5EHxzzp6U5LOogMFDTjfArsQLtk70pt6wKGm+LUx5vR1yblTmXVHIloUFcd4G7ad6Qz4G3bx hYTeodoS76TiEJd6eN4MUZeoIUCLhr0N8F5OSza7OyAfikJW4Qsav3vQIkMsRIz75Sq0bBwcupTg E34h5prCy8VCZLQelHsIJchxzIdFV4XTnyliIoNRlwAYl3dqmJLJfGBs32x9SuRwTMKeuB330DTH D8z7p/8Dvq1wkNoL3chtl1+afwkyQf3NosxabUzyqkn+Zvjp2DXrDige7kgvOtB5CTh8piKCk5XQ A76+AqAF3SAi428diDRgxuYKuQl1C/AH6GmWNcf7I4GOODm4RStDeKLRLBT/DShycpWbXgnbiUSY qqFJu3FS8r/2/yehNq+4tneI3TqkbZs0kNwUXTC/t+sX5Ie3cdCh13cV1ELX8vMxmV2b3RZtP+oG I/hGoiLtk/bdmuYqh7GYVPEi92tF4+KOdh2ajcQGjTa3FPOdVGm3jjzVpG2Tgbet9r1ke8LJaDmg kpzNNIaRkPpkUZ3+/uul9XXeifdy -----END CERTIFICATE----- AC RAIZ FNMT-RCM SERVIDORES SEGUROS =================================== -----BEGIN CERTIFICATE----- MIICbjCCAfOgAwIBAgIQYvYybOXE42hcG2LdnC6dlTAKBggqhkjOPQQDAzB4MQswCQYDVQQGEwJF UzERMA8GA1UECgwIRk5NVC1SQ00xDjAMBgNVBAsMBUNlcmVzMRgwFgYDVQRhDA9WQVRFUy1RMjgy NjAwNEoxLDAqBgNVBAMMI0FDIFJBSVogRk5NVC1SQ00gU0VSVklET1JFUyBTRUdVUk9TMB4XDTE4 MTIyMDA5MzczM1oXDTQzMTIyMDA5MzczM1oweDELMAkGA1UEBhMCRVMxETAPBgNVBAoMCEZOTVQt UkNNMQ4wDAYDVQQLDAVDZXJlczEYMBYGA1UEYQwPVkFURVMtUTI4MjYwMDRKMSwwKgYDVQQDDCNB QyBSQUlaIEZOTVQtUkNNIFNFUlZJRE9SRVMgU0VHVVJPUzB2MBAGByqGSM49AgEGBSuBBAAiA2IA BPa6V1PIyqvfNkpSIeSX0oNnnvBlUdBeh8dHsVnyV0ebAAKTRBdp20LHsbI6GA60XYyzZl2hNPk2 LEnb80b8s0RpRBNm/dfF/a82Tc4DTQdxz69qBdKiQ1oKUm8BA06Oi6NCMEAwDwYDVR0TAQH/BAUw AwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFAG5L++/EYZg8k/QQW6rcx/n0m5JMAoGCCqG SM49BAMDA2kAMGYCMQCuSuMrQMN0EfKVrRYj3k4MGuZdpSRea0R7/DjiT8ucRRcRTBQnJlU5dUoD zBOQn5ICMQD6SmxgiHPz7riYYqnOK8LZiqZwMR2vsJRM60/G49HzYqc8/5MuB1xJAWdpEgJyv+c= -----END CERTIFICATE----- GlobalSign Root R46 =================== -----BEGIN CERTIFICATE----- MIIFWjCCA0KgAwIBAgISEdK7udcjGJ5AXwqdLdDfJWfRMA0GCSqGSIb3DQEBDAUAMEYxCzAJBgNV BAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYDVQQDExNHbG9iYWxTaWduIFJv b3QgUjQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMyMDAwMDAwMFowRjELMAkGA1UEBhMCQkUxGTAX BgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExHDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBSNDYwggIi MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCsrHQy6LNl5brtQyYdpokNRbopiLKkHWPd08Es CVeJOaFV6Wc0dwxu5FUdUiXSE2te4R2pt32JMl8Nnp8semNgQB+msLZ4j5lUlghYruQGvGIFAha/ r6gjA7aUD7xubMLL1aa7DOn2wQL7Id5m3RerdELv8HQvJfTqa1VbkNud316HCkD7rRlr+/fKYIje 2sGP1q7Vf9Q8g+7XFkyDRTNrJ9CG0Bwta/OrffGFqfUo0q3v84RLHIf8E6M6cqJaESvWJ3En7YEt bWaBkoe0G1h6zD8K+kZPTXhc+CtI4wSEy132tGqzZfxCnlEmIyDLPRT5ge1lFgBPGmSXZgjPjHvj K8Cd+RTyG/FWaha/LIWFzXg4mutCagI0GIMXTpRW+LaCtfOW3T3zvn8gdz57GSNrLNRyc0NXfeD4 12lPFzYE+cCQYDdF3uYM2HSNrpyibXRdQr4G9dlkbgIQrImwTDsHTUB+JMWKmIJ5jqSngiCNI/on ccnfxkF0oE32kRbcRoxfKWMxWXEM2G/CtjJ9++ZdU6Z+Ffy7dXxd7Pj2Fxzsx2sZy/N78CsHpdls eVR2bJ0cpm4O6XkMqCNqo98bMDGfsVR7/mrLZqrcZdCinkqaByFrgY/bxFn63iLABJzjqls2k+g9 vXqhnQt2sQvHnf3PmKgGwvgqo6GDoLclcqUC4wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYD VR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA1yrc4GHqMywptWU4jaWSf8FmSwwDQYJKoZIhvcNAQEM BQADggIBAHx47PYCLLtbfpIrXTncvtgdokIzTfnvpCo7RGkerNlFo048p9gkUbJUHJNOxO97k4Vg JuoJSOD1u8fpaNK7ajFxzHmuEajwmf3lH7wvqMxX63bEIaZHU1VNaL8FpO7XJqti2kM3S+LGteWy gxk6x9PbTZ4IevPuzz5i+6zoYMzRx6Fcg0XERczzF2sUyQQCPtIkpnnpHs6i58FZFZ8d4kuaPp92 CC1r2LpXFNqD6v6MVenQTqnMdzGxRBF6XLE+0xRFFRhiJBPSy03OXIPBNvIQtQ6IbbjhVp+J3pZm OUdkLG5NrmJ7v2B0GbhWrJKsFjLtrWhV/pi60zTe9Mlhww6G9kuEYO4Ne7UyWHmRVSyBQ7N0H3qq JZ4d16GLuc1CLgSkZoNNiTW2bKg2SnkheCLQQrzRQDGQob4Ez8pn7fXwgNNgyYMqIgXQBztSvwye qiv5u+YfjyW6hY0XHgL+XVAEV8/+LbzvXMAaq7afJMbfc2hIkCwU9D9SGuTSyxTDYWnP4vkYxboz nxSjBF25cfe1lNj2M8FawTSLfJvdkzrnE6JwYZ+vj+vYxXX4M2bUdGc6N3ec592kD3ZDZopD8p/7 DEJ4Y9HiD2971KE9dJeFt0g5QdYg/NA6s/rob8SKunE3vouXsXgxT7PntgMTzlSdriVZzH81Xwj3 QEUxeCp6 -----END CERTIFICATE----- GlobalSign Root E46 =================== -----BEGIN CERTIFICATE----- MIICCzCCAZGgAwIBAgISEdK7ujNu1LzmJGjFDYQdmOhDMAoGCCqGSM49BAMDMEYxCzAJBgNVBAYT AkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRwwGgYDVQQDExNHbG9iYWxTaWduIFJvb3Qg RTQ2MB4XDTE5MDMyMDAwMDAwMFoXDTQ2MDMyMDAwMDAwMFowRjELMAkGA1UEBhMCQkUxGTAXBgNV BAoTEEdsb2JhbFNpZ24gbnYtc2ExHDAaBgNVBAMTE0dsb2JhbFNpZ24gUm9vdCBFNDYwdjAQBgcq hkjOPQIBBgUrgQQAIgNiAAScDrHPt+ieUnd1NPqlRqetMhkytAepJ8qUuwzSChDH2omwlwxwEwkB jtjqR+q+soArzfwoDdusvKSGN+1wCAB16pMLey5SnCNoIwZD7JIvU4Tb+0cUB+hflGddyXqBPCCj QjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBQxCpCPtsad0kRL gLWi5h+xEk8blTAKBggqhkjOPQQDAwNoADBlAjEA31SQ7Zvvi5QCkxeCmb6zniz2C5GMn0oUsfZk vLtoURMMA/cVi4RguYv/Uo7njLwcAjA8+RHUjE7AwWHCFUyqqx0LMV87HOIAl0Qx5v5zli/altP+ CAezNIm8BZ/3Hobui3A= -----END CERTIFICATE----- ANF Secure Server Root CA ========================= -----BEGIN CERTIFICATE----- MIIF7zCCA9egAwIBAgIIDdPjvGz5a7EwDQYJKoZIhvcNAQELBQAwgYQxEjAQBgNVBAUTCUc2MzI4 NzUxMDELMAkGA1UEBhMCRVMxJzAlBgNVBAoTHkFORiBBdXRvcmlkYWQgZGUgQ2VydGlmaWNhY2lv bjEUMBIGA1UECxMLQU5GIENBIFJhaXoxIjAgBgNVBAMTGUFORiBTZWN1cmUgU2VydmVyIFJvb3Qg Q0EwHhcNMTkwOTA0MTAwMDM4WhcNMzkwODMwMTAwMDM4WjCBhDESMBAGA1UEBRMJRzYzMjg3NTEw MQswCQYDVQQGEwJFUzEnMCUGA1UEChMeQU5GIEF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uMRQw EgYDVQQLEwtBTkYgQ0EgUmFpejEiMCAGA1UEAxMZQU5GIFNlY3VyZSBTZXJ2ZXIgUm9vdCBDQTCC AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANvrayvmZFSVgpCjcqQZAZ2cC4Ffc0m6p6zz BE57lgvsEeBbphzOG9INgxwruJ4dfkUyYA8H6XdYfp9qyGFOtibBTI3/TO80sh9l2Ll49a2pcbnv T1gdpd50IJeh7WhM3pIXS7yr/2WanvtH2Vdy8wmhrnZEE26cLUQ5vPnHO6RYPUG9tMJJo8gN0pcv B2VSAKduyK9o7PQUlrZXH1bDOZ8rbeTzPvY1ZNoMHKGESy9LS+IsJJ1tk0DrtSOOMspvRdOoiXse zx76W0OLzc2oD2rKDF65nkeP8Nm2CgtYZRczuSPkdxl9y0oukntPLxB3sY0vaJxizOBQ+OyRp1RM VwnVdmPF6GUe7m1qzwmd+nxPrWAI/VaZDxUse6mAq4xhj0oHdkLePfTdsiQzW7i1o0TJrH93PB0j 7IKppuLIBkwC/qxcmZkLLxCKpvR/1Yd0DVlJRfbwcVw5Kda/SiOL9V8BY9KHcyi1Swr1+KuCLH5z JTIdC2MKF4EA/7Z2Xue0sUDKIbvVgFHlSFJnLNJhiQcND85Cd8BEc5xEUKDbEAotlRyBr+Qc5RQe 8TZBAQIvfXOn3kLMTOmJDVb3n5HUA8ZsyY/b2BzgQJhdZpmYgG4t/wHFzstGH6wCxkPmrqKEPMVO Hj1tyRRM4y5Bu8o5vzY8KhmqQYdOpc5LMnndkEl/AgMBAAGjYzBhMB8GA1UdIwQYMBaAFJxf0Gxj o1+TypOYCK2Mh6UsXME3MB0GA1UdDgQWBBScX9BsY6Nfk8qTmAitjIelLFzBNzAOBgNVHQ8BAf8E BAMCAYYwDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOCAgEATh65isagmD9uw2nAalxJ UqzLK114OMHVVISfk/CHGT0sZonrDUL8zPB1hT+L9IBdeeUXZ701guLyPI59WzbLWoAAKfLOKyzx j6ptBZNscsdW699QIyjlRRA96Gejrw5VD5AJYu9LWaL2U/HANeQvwSS9eS9OICI7/RogsKQOLHDt dD+4E5UGUcjohybKpFtqFiGS3XNgnhAY3jyB6ugYw3yJ8otQPr0R4hUDqDZ9MwFsSBXXiJCZBMXM 5gf0vPSQ7RPi6ovDj6MzD8EpTBNO2hVWcXNyglD2mjN8orGoGjR0ZVzO0eurU+AagNjqOknkJjCb 5RyKqKkVMoaZkgoQI1YS4PbOTOK7vtuNknMBZi9iPrJyJ0U27U1W45eZ/zo1PqVUSlJZS2Db7v54 EX9K3BR5YLZrZAPbFYPhor72I5dQ8AkzNqdxliXzuUJ92zg/LFis6ELhDtjTO0wugumDLmsx2d1H hk9tl5EuT+IocTUW0fJz/iUrB0ckYyfI+PbZa/wSMVYIwFNCr5zQM378BvAxRAMU8Vjq8moNqRGy g77FGr8H6lnco4g175x2MjxNBiLOFeXdntiP2t7SxDnlF4HPOEfrf4htWRvfn0IUrn7PqLBmZdo3 r5+qPeoott7VMVgWglvquxl1AnMaykgaIZOQCo6ThKd9OyMYkomgjaw= -----END CERTIFICATE----- Certum EC-384 CA ================ -----BEGIN CERTIFICATE----- MIICZTCCAeugAwIBAgIQeI8nXIESUiClBNAt3bpz9DAKBggqhkjOPQQDAzB0MQswCQYDVQQGEwJQ TDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2Vy dGlmaWNhdGlvbiBBdXRob3JpdHkxGTAXBgNVBAMTEENlcnR1bSBFQy0zODQgQ0EwHhcNMTgwMzI2 MDcyNDU0WhcNNDMwMzI2MDcyNDU0WjB0MQswCQYDVQQGEwJQTDEhMB8GA1UEChMYQXNzZWNvIERh dGEgU3lzdGVtcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkx GTAXBgNVBAMTEENlcnR1bSBFQy0zODQgQ0EwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAATEKI6rGFtq vm5kN2PkzeyrOvfMobgOgknXhimfoZTy42B4mIF4Bk3y7JoOV2CDn7TmFy8as10CW4kjPMIRBSqn iBMY81CE1700LCeJVf/OTOffph8oxPBUw7l8t1Ot68KjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYD VR0OBBYEFI0GZnQkdjrzife81r1HfS+8EF9LMA4GA1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNo ADBlAjADVS2m5hjEfO/JUG7BJw+ch69u1RsIGL2SKcHvlJF40jocVYli5RsJHrpka/F2tNQCMQC0 QoSZ/6vnnvuRlydd3LBbMHHOXjgaatkl5+r3YZJW+OraNsKHZZYuciUvf9/DE8k= -----END CERTIFICATE----- Certum Trusted Root CA ====================== -----BEGIN CERTIFICATE----- MIIFwDCCA6igAwIBAgIQHr9ZULjJgDdMBvfrVU+17TANBgkqhkiG9w0BAQ0FADB6MQswCQYDVQQG EwJQTDEhMB8GA1UEChMYQXNzZWNvIERhdGEgU3lzdGVtcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0g Q2VydGlmaWNhdGlvbiBBdXRob3JpdHkxHzAdBgNVBAMTFkNlcnR1bSBUcnVzdGVkIFJvb3QgQ0Ew HhcNMTgwMzE2MTIxMDEzWhcNNDMwMzE2MTIxMDEzWjB6MQswCQYDVQQGEwJQTDEhMB8GA1UEChMY QXNzZWNvIERhdGEgU3lzdGVtcyBTLkEuMScwJQYDVQQLEx5DZXJ0dW0gQ2VydGlmaWNhdGlvbiBB dXRob3JpdHkxHzAdBgNVBAMTFkNlcnR1bSBUcnVzdGVkIFJvb3QgQ0EwggIiMA0GCSqGSIb3DQEB AQUAA4ICDwAwggIKAoICAQDRLY67tzbqbTeRn06TpwXkKQMlzhyC93yZn0EGze2jusDbCSzBfN8p fktlL5On1AFrAygYo9idBcEq2EXxkd7fO9CAAozPOA/qp1x4EaTByIVcJdPTsuclzxFUl6s1wB52 HO8AU5853BSlLCIls3Jy/I2z5T4IHhQqNwuIPMqw9MjCoa68wb4pZ1Xi/K1ZXP69VyywkI3C7Te2 fJmItdUDmj0VDT06qKhF8JVOJVkdzZhpu9PMMsmN74H+rX2Ju7pgE8pllWeg8xn2A1bUatMn4qGt g/BKEiJ3HAVz4hlxQsDsdUaakFjgao4rpUYwBI4Zshfjvqm6f1bxJAPXsiEodg42MEx51UGamqi4 NboMOvJEGyCI98Ul1z3G4z5D3Yf+xOr1Uz5MZf87Sst4WmsXXw3Hw09Omiqi7VdNIuJGmj8PkTQk fVXjjJU30xrwCSss0smNtA0Aq2cpKNgB9RkEth2+dv5yXMSFytKAQd8FqKPVhJBPC/PgP5sZ0jeJ P/J7UhyM9uH3PAeXjA6iWYEMspA90+NZRu0PqafegGtaqge2Gcu8V/OXIXoMsSt0Puvap2ctTMSY njYJdmZm/Bo/6khUHL4wvYBQv3y1zgD2DGHZ5yQD4OMBgQ692IU0iL2yNqh7XAjlRICMb/gv1SHK HRzQ+8S1h9E6Tsd2tTVItQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBSM+xx1 vALTn04uSNn5YFSqxLNP+jAOBgNVHQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQENBQADggIBAEii1QAL LtA/vBzVtVRJHlpr9OTy4EA34MwUe7nJ+jW1dReTagVphZzNTxl4WxmB82M+w85bj/UvXgF2Ez8s ALnNllI5SW0ETsXpD4YN4fqzX4IS8TrOZgYkNCvozMrnadyHncI013nR03e4qllY/p0m+jiGPp2K h2RX5Rc64vmNueMzeMGQ2Ljdt4NR5MTMI9UGfOZR0800McD2RrsLrfw9EAUqO0qRJe6M1ISHgCq8 CYyqOhNf6DR5UMEQGfnTKB7U0VEwKbOukGfWHwpjscWpxkIxYxeU72nLL/qMFH3EQxiJ2fAyQOaA 4kZf5ePBAFmo+eggvIksDkc0C+pXwlM2/KfUrzHN/gLldfq5Jwn58/U7yn2fqSLLiMmq0Uc9Nneo WWRrJ8/vJ8HjJLWG965+Mk2weWjROeiQWMODvA8s1pfrzgzhIMfatz7DP78v3DSk+yshzWePS/Tj 6tQ/50+6uaWTRRxmHyH6ZF5v4HaUMst19W7l9o/HuKTMqJZ9ZPskWkoDbGs4xugDQ5r3V7mzKWmT OPQD8rv7gmsHINFSH5pkAnuYZttcTVoP0ISVoDwUQwbKytu4QTbaakRnh6+v40URFWkIsr4WOZck bxJF0WddCajJFdr60qZfE2Efv4WstK2tBZQIgx51F9NxO5NQI1mg7TyRVJ12AMXDuDjb -----END CERTIFICATE----- TunTrust Root CA ================ -----BEGIN CERTIFICATE----- MIIFszCCA5ugAwIBAgIUEwLV4kBMkkaGFmddtLu7sms+/BMwDQYJKoZIhvcNAQELBQAwYTELMAkG A1UEBhMCVE4xNzA1BgNVBAoMLkFnZW5jZSBOYXRpb25hbGUgZGUgQ2VydGlmaWNhdGlvbiBFbGVj dHJvbmlxdWUxGTAXBgNVBAMMEFR1blRydXN0IFJvb3QgQ0EwHhcNMTkwNDI2MDg1NzU2WhcNNDQw NDI2MDg1NzU2WjBhMQswCQYDVQQGEwJUTjE3MDUGA1UECgwuQWdlbmNlIE5hdGlvbmFsZSBkZSBD ZXJ0aWZpY2F0aW9uIEVsZWN0cm9uaXF1ZTEZMBcGA1UEAwwQVHVuVHJ1c3QgUm9vdCBDQTCCAiIw DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMPN0/y9BFPdDCA61YguBUtB9YOCfvdZn56eY+hz 2vYGqU8ftPkLHzmMmiDQfgbU7DTZhrx1W4eI8NLZ1KMKsmwb60ksPqxd2JQDoOw05TDENX37Jk0b bjBU2PWARZw5rZzJJQRNmpA+TkBuimvNKWfGzC3gdOgFVwpIUPp6Q9p+7FuaDmJ2/uqdHYVy7BG7 NegfJ7/Boce7SBbdVtfMTqDhuazb1YMZGoXRlJfXyqNlC/M4+QKu3fZnz8k/9YosRxqZbwUN/dAd gjH8KcwAWJeRTIAAHDOFli/LQcKLEITDCSSJH7UP2dl3RxiSlGBcx5kDPP73lad9UKGAwqmDrViW VSHbhlnUr8a83YFuB9tgYv7sEG7aaAH0gxupPqJbI9dkxt/con3YS7qC0lH4Zr8GRuR5KiY2eY8f Tpkdso8MDhz/yV3A/ZAQprE38806JG60hZC/gLkMjNWb1sjxVj8agIl6qeIbMlEsPvLfe/ZdeikZ juXIvTZxi11Mwh0/rViizz1wTaZQmCXcI/m4WEEIcb9PuISgjwBUFfyRbVinljvrS5YnzWuioYas DXxU5mZMZl+QviGaAkYt5IPCgLnPSz7ofzwB7I9ezX/SKEIBlYrilz0QIX32nRzFNKHsLA4KUiwS VXAkPcvCFDVDXSdOvsC9qnyW5/yeYa1E0wCXAgMBAAGjYzBhMB0GA1UdDgQWBBQGmpsfU33x9aTI 04Y+oXNZtPdEITAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFAaamx9TffH1pMjThj6hc1m0 90QhMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAqgVutt0Vyb+zxiD2BkewhpMl 0425yAA/l/VSJ4hxyXT968pk21vvHl26v9Hr7lxpuhbI87mP0zYuQEkHDVneixCwSQXi/5E/S7fd Ao74gShczNxtr18UnH1YeA32gAm56Q6XKRm4t+v4FstVEuTGfbvE7Pi1HE4+Z7/FXxttbUcoqgRY YdZ2vyJ/0Adqp2RT8JeNnYA/u8EH22Wv5psymsNUk8QcCMNE+3tjEUPRahphanltkE8pjkcFwRJp adbGNjHh/PqAulxPxOu3Mqz4dWEX1xAZufHSCe96Qp1bWgvUxpVOKs7/B9dPfhgGiPEZtdmYu65x xBzndFlY7wyJz4sfdZMaBBSSSFCp61cpABbjNhzI+L/wM9VBD8TMPN3pM0MBkRArHtG5Xc0yGYuP jCB31yLEQtyEFpslbei0VXF/sHyz03FJuc9SpAQ/3D2gu68zngowYI7bnV2UqL1g52KAdoGDDIzM MEZJ4gzSqK/rYXHv5yJiqfdcZGyfFoxnNidF9Ql7v/YQCvGwjVRDjAS6oz/v4jXH+XTgbzRB0L9z ZVcg+ZtnemZoJE6AZb0QmQZZ8mWvuMZHu/2QeItBcy6vVR/cO5JyboTT0GFMDcx2V+IthSIVNg3r AZ3r2OvEhJn7wAzMMujjd9qDRIueVSjAi1jTkD5OGwDxFa2DK5o= -----END CERTIFICATE----- HARICA TLS RSA Root CA 2021 =========================== -----BEGIN CERTIFICATE----- MIIFpDCCA4ygAwIBAgIQOcqTHO9D88aOk8f0ZIk4fjANBgkqhkiG9w0BAQsFADBsMQswCQYDVQQG EwJHUjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9u cyBDQTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBSU0EgUm9vdCBDQSAyMDIxMB4XDTIxMDIxOTEwNTUz OFoXDTQ1MDIxMzEwNTUzN1owbDELMAkGA1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRl bWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgUlNB IFJvb3QgQ0EgMjAyMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAIvC569lmwVnlskN JLnQDmT8zuIkGCyEf3dRywQRNrhe7Wlxp57kJQmXZ8FHws+RFjZiPTgE4VGC/6zStGndLuwRo0Xu a2s7TL+MjaQenRG56Tj5eg4MmOIjHdFOY9TnuEFE+2uva9of08WRiFukiZLRgeaMOVig1mlDqa2Y Ulhu2wr7a89o+uOkXjpFc5gH6l8Cct4MpbOfrqkdtx2z/IpZ525yZa31MJQjB/OCFks1mJxTuy/K 5FrZx40d/JiZ+yykgmvwKh+OC19xXFyuQnspiYHLA6OZyoieC0AJQTPb5lh6/a6ZcMBaD9YThnEv dmn8kN3bLW7R8pv1GmuebxWMevBLKKAiOIAkbDakO/IwkfN4E8/BPzWr8R0RI7VDIp4BkrcYAuUR 0YLbFQDMYTfBKnya4dC6s1BG7oKsnTH4+yPiAwBIcKMJJnkVU2DzOFytOOqBAGMUuTNe3QvboEUH GjMJ+E20pwKmafTCWQWIZYVWrkvL4N48fS0ayOn7H6NhStYqE613TBoYm5EPWNgGVMWX+Ko/IIqm haZ39qb8HOLubpQzKoNQhArlT4b4UEV4AIHrW2jjJo3Me1xR9BQsQL4aYB16cmEdH2MtiKrOokWQ CPxrvrNQKlr9qEgYRtaQQJKQCoReaDH46+0N0x3GfZkYVVYnZS6NRcUk7M7jAgMBAAGjQjBAMA8G A1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFApII6ZgpJIKM+qTW8VX6iVNvRLuMA4GA1UdDwEB/wQE AwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAPpBIqm5iFSVmewzVjIuJndftTgfvnNAUX15QvWiWkKQU EapobQk1OUAJ2vQJLDSle1mESSmXdMgHHkdt8s4cUCbjnj1AUz/3f5Z2EMVGpdAgS1D0NTsY9FVq QRtHBmg8uwkIYtlfVUKqrFOFrJVWNlar5AWMxajaH6NpvVMPxP/cyuN+8kyIhkdGGvMA9YCRotxD QpSbIPDRzbLrLFPCU3hKTwSUQZqPJzLB5UkZv/HywouoCjkxKLR9YjYsTewfM7Z+d21+UPCfDtcR j88YxeMn/ibvBZ3PzzfF0HvaO7AWhAw6k9a+F9sPPg4ZeAnHqQJyIkv3N3a6dcSFA1pj1bF1BcK5 vZStjBWZp5N99sXzqnTPBIWUmAD04vnKJGW/4GKvyMX6ssmeVkjaef2WdhW+o45WxLM0/L5H9MG0 qPzVMIho7suuyWPEdr6sOBjhXlzPrjoiUevRi7PzKzMHVIf6tLITe7pTBGIBnfHAT+7hOtSLIBD6 Alfm78ELt5BGnBkpjNxvoEppaZS3JGWg/6w/zgH7IS79aPib8qXPMThcFarmlwDB31qlpzmq6YR/ PFGoOtmUW4y/Twhx5duoXNTSpv4Ao8YWxw/ogM4cKGR0GQjTQuPOAF1/sdwTsOEFy9EgqoZ0njnn kf3/W9b3raYvAwtt41dU63ZTGI0RmLo= -----END CERTIFICATE----- HARICA TLS ECC Root CA 2021 =========================== -----BEGIN CERTIFICATE----- MIICVDCCAdugAwIBAgIQZ3SdjXfYO2rbIvT/WeK/zjAKBggqhkjOPQQDAzBsMQswCQYDVQQGEwJH UjE3MDUGA1UECgwuSGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9ucyBD QTEkMCIGA1UEAwwbSEFSSUNBIFRMUyBFQ0MgUm9vdCBDQSAyMDIxMB4XDTIxMDIxOTExMDExMFoX DTQ1MDIxMzExMDEwOVowbDELMAkGA1UEBhMCR1IxNzA1BgNVBAoMLkhlbGxlbmljIEFjYWRlbWlj IGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ0ExJDAiBgNVBAMMG0hBUklDQSBUTFMgRUNDIFJv b3QgQ0EgMjAyMTB2MBAGByqGSM49AgEGBSuBBAAiA2IABDgI/rGgltJ6rK9JOtDA4MM7KKrxcm1l AEeIhPyaJmuqS7psBAqIXhfyVYf8MLA04jRYVxqEU+kw2anylnTDUR9YSTHMmE5gEYd103KUkE+b ECUqqHgtvpBBWJAVcqeht6NCMEAwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUyRtTgRL+BNUW 0aq8mm+3oJUZbsowDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMDA2cAMGQCMBHervjcToiwqfAi rcJRQO9gcS3ujwLEXQNwSaSS6sUUiHCm0w2wqsosQJz76YJumgIwK0eaB8bRwoF8yguWGEEbo/Qw CZ61IygNnxS2PFOiTAZpffpskcYqSUXm7LcT4Tps -----END CERTIFICATE----- Autoridad de Certificacion Firmaprofesional CIF A62634068 ========================================================= -----BEGIN CERTIFICATE----- MIIGFDCCA/ygAwIBAgIIG3Dp0v+ubHEwDQYJKoZIhvcNAQELBQAwUTELMAkGA1UEBhMCRVMxQjBA BgNVBAMMOUF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uIEZpcm1hcHJvZmVzaW9uYWwgQ0lGIEE2 MjYzNDA2ODAeFw0xNDA5MjMxNTIyMDdaFw0zNjA1MDUxNTIyMDdaMFExCzAJBgNVBAYTAkVTMUIw QAYDVQQDDDlBdXRvcmlkYWQgZGUgQ2VydGlmaWNhY2lvbiBGaXJtYXByb2Zlc2lvbmFsIENJRiBB NjI2MzQwNjgwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKlmuO6vj78aI14H9M2uDD Utd9thDIAl6zQyrET2qyyhxdKJp4ERppWVevtSBC5IsP5t9bpgOSL/UR5GLXMnE42QQMcas9UX4P B99jBVzpv5RvwSmCwLTaUbDBPLutN0pcyvFLNg4kq7/DhHf9qFD0sefGL9ItWY16Ck6WaVICqjaY 7Pz6FIMMNx/Jkjd/14Et5cS54D40/mf0PmbR0/RAz15iNA9wBj4gGFrO93IbJWyTdBSTo3OxDqqH ECNZXyAFGUftaI6SEspd/NYrspI8IM/hX68gvqB2f3bl7BqGYTM+53u0P6APjqK5am+5hyZvQWyI plD9amML9ZMWGxmPsu2bm8mQ9QEM3xk9Dz44I8kvjwzRAv4bVdZO0I08r0+k8/6vKtMFnXkIoctX MbScyJCyZ/QYFpM6/EfY0XiWMR+6KwxfXZmtY4laJCB22N/9q06mIqqdXuYnin1oKaPnirjaEbsX LZmdEyRG98Xi2J+Of8ePdG1asuhy9azuJBCtLxTa/y2aRnFHvkLfuwHb9H/TKI8xWVvTyQKmtFLK bpf7Q8UIJm+K9Lv9nyiqDdVF8xM6HdjAeI9BZzwelGSuewvF6NkBiDkal4ZkQdU7hwxu+g/GvUgU vzlN1J5Bto+WHWOWk9mVBngxaJ43BjuAiUVhOSPHG0SjFeUc+JIwuwIDAQABo4HvMIHsMB0GA1Ud DgQWBBRlzeurNR4APn7VdMActHNHDhpkLzASBgNVHRMBAf8ECDAGAQH/AgEBMIGmBgNVHSAEgZ4w gZswgZgGBFUdIAAwgY8wLwYIKwYBBQUHAgEWI2h0dHA6Ly93d3cuZmlybWFwcm9mZXNpb25hbC5j b20vY3BzMFwGCCsGAQUFBwICMFAeTgBQAGEAcwBlAG8AIABkAGUAIABsAGEAIABCAG8AbgBhAG4A bwB2AGEAIAA0ADcAIABCAGEAcgBjAGUAbABvAG4AYQAgADAAOAAwADEANzAOBgNVHQ8BAf8EBAMC AQYwDQYJKoZIhvcNAQELBQADggIBAHSHKAIrdx9miWTtj3QuRhy7qPj4Cx2Dtjqn6EWKB7fgPiDL 4QjbEwj4KKE1soCzC1HA01aajTNFSa9J8OA9B3pFE1r/yJfY0xgsfZb43aJlQ3CTkBW6kN/oGbDb LIpgD7dvlAceHabJhfa9NPhAeGIQcDq+fUs5gakQ1JZBu/hfHAsdCPKxsIl68veg4MSPi3i1O1il I45PVf42O+AMt8oqMEEgtIDNrvx2ZnOorm7hfNoD6JQg5iKj0B+QXSBTFCZX2lSX3xZEEAEeiGaP cjiT3SC3NL7X8e5jjkd5KAb881lFJWAiMxujX6i6KtoaPc1A6ozuBRWV1aUsIC+nmCjuRfzxuIgA LI9C2lHVnOUTaHFFQ4ueCyE8S1wF3BqfmI7avSKecs2tCsvMo2ebKHTEm9caPARYpoKdrcd7b/+A lun4jWq9GJAd/0kakFI3ky88Al2CdgtR5xbHV/g4+afNmyJU72OwFW1TZQNKXkqgsqeOSQBZONXH 9IBk9W6VULgRfhVwOEqwf9DEMnDAGf/JOC0ULGb0QkTmVXYbgBVX/8Cnp6o5qtjTcNAuuuuUavpf NIbnYrX9ivAwhZTJryQCL2/W3Wf+47BVTwSYT6RBVuKT0Gro1vP7ZeDOdcQxWQzugsgMYDNKGbqE ZycPvEJdvSRUDewdcAZfpLz6IHxV -----END CERTIFICATE----- vTrus ECC Root CA ================= -----BEGIN CERTIFICATE----- MIICDzCCAZWgAwIBAgIUbmq8WapTvpg5Z6LSa6Q75m0c1towCgYIKoZIzj0EAwMwRzELMAkGA1UE BhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4xGjAYBgNVBAMTEXZUcnVzIEVDQyBS b290IENBMB4XDTE4MDczMTA3MjY0NFoXDTQzMDczMTA3MjY0NFowRzELMAkGA1UEBhMCQ04xHDAa BgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4xGjAYBgNVBAMTEXZUcnVzIEVDQyBSb290IENBMHYw EAYHKoZIzj0CAQYFK4EEACIDYgAEZVBKrox5lkqqHAjDo6LN/llWQXf9JpRCux3NCNtzslt188+c ToL0v/hhJoVs1oVbcnDS/dtitN9Ti72xRFhiQgnH+n9bEOf+QP3A2MMrMudwpremIFUde4BdS49n TPEQo0IwQDAdBgNVHQ4EFgQUmDnNvtiyjPeyq+GtJK97fKHbH88wDwYDVR0TAQH/BAUwAwEB/zAO BgNVHQ8BAf8EBAMCAQYwCgYIKoZIzj0EAwMDaAAwZQIwV53dVvHH4+m4SVBrm2nDb+zDfSXkV5UT QJtS0zvzQBm8JsctBp61ezaf9SXUY2sAAjEA6dPGnlaaKsyh2j/IZivTWJwghfqrkYpwcBE4YGQL YgmRWAD5Tfs0aNoJrSEGGJTO -----END CERTIFICATE----- vTrus Root CA ============= -----BEGIN CERTIFICATE----- MIIFVjCCAz6gAwIBAgIUQ+NxE9izWRRdt86M/TX9b7wFjUUwDQYJKoZIhvcNAQELBQAwQzELMAkG A1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4xFjAUBgNVBAMTDXZUcnVzIFJv b3QgQ0EwHhcNMTgwNzMxMDcyNDA1WhcNNDMwNzMxMDcyNDA1WjBDMQswCQYDVQQGEwJDTjEcMBoG A1UEChMTaVRydXNDaGluYSBDby4sTHRkLjEWMBQGA1UEAxMNdlRydXMgUm9vdCBDQTCCAiIwDQYJ KoZIhvcNAQEBBQADggIPADCCAgoCggIBAL1VfGHTuB0EYgWgrmy3cLRB6ksDXhA/kFocizuwZots SKYcIrrVQJLuM7IjWcmOvFjai57QGfIvWcaMY1q6n6MLsLOaXLoRuBLpDLvPbmyAhykUAyyNJJrI ZIO1aqwTLDPxn9wsYTwaP3BVm60AUn/PBLn+NvqcwBauYv6WTEN+VRS+GrPSbcKvdmaVayqwlHeF XgQPYh1jdfdr58tbmnDsPmcF8P4HCIDPKNsFxhQnL4Z98Cfe/+Z+M0jnCx5Y0ScrUw5XSmXX+6KA YPxMvDVTAWqXcoKv8R1w6Jz1717CbMdHflqUhSZNO7rrTOiwCcJlwp2dCZtOtZcFrPUGoPc2BX70 kLJrxLT5ZOrpGgrIDajtJ8nU57O5q4IikCc9Kuh8kO+8T/3iCiSn3mUkpF3qwHYw03dQ+A0Em5Q2 AXPKBlim0zvc+gRGE1WKyURHuFE5Gi7oNOJ5y1lKCn+8pu8fA2dqWSslYpPZUxlmPCdiKYZNpGvu /9ROutW04o5IWgAZCfEF2c6Rsffr6TlP9m8EQ5pV9T4FFL2/s1m02I4zhKOQUqqzApVg+QxMaPnu 1RcN+HFXtSXkKe5lXa/R7jwXC1pDxaWG6iSe4gUH3DRCEpHWOXSuTEGC2/KmSNGzm/MzqvOmwMVO 9fSddmPmAsYiS8GVP1BkLFTltvA8Kc9XAgMBAAGjQjBAMB0GA1UdDgQWBBRUYnBj8XWEQ1iO0RYg scasGrz2iTAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOC AgEAKbqSSaet8PFww+SX8J+pJdVrnjT+5hpk9jprUrIQeBqfTNqK2uwcN1LgQkv7bHbKJAs5EhWd nxEt/Hlk3ODg9d3gV8mlsnZwUKT+twpw1aA08XXXTUm6EdGz2OyC/+sOxL9kLX1jbhd47F18iMjr jld22VkE+rxSH0Ws8HqA7Oxvdq6R2xCOBNyS36D25q5J08FsEhvMKar5CKXiNxTKsbhm7xqC5PD4 8acWabfbqWE8n/Uxy+QARsIvdLGx14HuqCaVvIivTDUHKgLKeBRtRytAVunLKmChZwOgzoy8sHJn xDHO2zTlJQNgJXtxmOTAGytfdELSS8VZCAeHvsXDf+eW2eHcKJfWjwXj9ZtOyh1QRwVTsMo554Wg icEFOwE30z9J4nfrI8iIZjs9OXYhRvHsXyO466JmdXTBQPfYaJqT4i2pLr0cox7IdMakLXogqzu4 sEb9b91fUlV1YvCXoHzXOP0l382gmxDPi7g4Xl7FtKYCNqEeXxzP4padKar9mK5S4fNBUvupLnKW nyfjqnN9+BojZns7q2WwMgFLFT49ok8MKzWixtlnEjUwzXYuFrOZnk1PTi07NEPhmg4NpGaXutIc SkwsKouLgU9xGqndXHt7CMUADTdA43x7VF8vhV929vensBxXVsFy6K2ir40zSbofitzmdHxghm+H l3s= -----END CERTIFICATE----- ISRG Root X2 ============ -----BEGIN CERTIFICATE----- MIICGzCCAaGgAwIBAgIQQdKd0XLq7qeAwSxs6S+HUjAKBggqhkjOPQQDAzBPMQswCQYDVQQGEwJV UzEpMCcGA1UEChMgSW50ZXJuZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElT UkcgUm9vdCBYMjAeFw0yMDA5MDQwMDAwMDBaFw00MDA5MTcxNjAwMDBaME8xCzAJBgNVBAYTAlVT MSkwJwYDVQQKEyBJbnRlcm5ldCBTZWN1cml0eSBSZXNlYXJjaCBHcm91cDEVMBMGA1UEAxMMSVNS RyBSb290IFgyMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEzZvVn4CDCuwJSvMWSj5cz3es3mcFDR0H ttwW+1qLFNvicWDEukWVEYmO6gbf9yoWHKS5xcUy4APgHoIYOIvXRdgKam7mAHf7AlF9ItgKbppb d9/w+kHsOdx1ymgHDB/qo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV HQ4EFgQUfEKWrt5LSDv6kviejM9ti6lyN5UwCgYIKoZIzj0EAwMDaAAwZQIwe3lORlCEwkSHRhtF cP9Ymd70/aTSVaYgLXTWNLxBo1BfASdWtL4ndQavEi51mI38AjEAi/V3bNTIZargCyzuFJ0nN6T5 U6VR5CmD1/iQMVtCnwr1/q4AaOeMSQ+2b1tbFfLn -----END CERTIFICATE----- HiPKI Root CA - G1 ================== -----BEGIN CERTIFICATE----- MIIFajCCA1KgAwIBAgIQLd2szmKXlKFD6LDNdmpeYDANBgkqhkiG9w0BAQsFADBPMQswCQYDVQQG EwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0ZC4xGzAZBgNVBAMMEkhpUEtJ IFJvb3QgQ0EgLSBHMTAeFw0xOTAyMjIwOTQ2MDRaFw0zNzEyMzExNTU5NTlaME8xCzAJBgNVBAYT AlRXMSMwIQYDVQQKDBpDaHVuZ2h3YSBUZWxlY29tIENvLiwgTHRkLjEbMBkGA1UEAwwSSGlQS0kg Um9vdCBDQSAtIEcxMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA9B5/UnMyDHPkvRN0 o9QwqNCuS9i233VHZvR85zkEHmpwINJaR3JnVfSl6J3VHiGh8Ge6zCFovkRTv4354twvVcg3Px+k wJyz5HdcoEb+d/oaoDjq7Zpy3iu9lFc6uux55199QmQ5eiY29yTw1S+6lZgRZq2XNdZ1AYDgr/SE YYwNHl98h5ZeQa/rh+r4XfEuiAU+TCK72h8q3VJGZDnzQs7ZngyzsHeXZJzA9KMuH5UHsBffMNsA GJZMoYFL3QRtU6M9/Aes1MU3guvklQgZKILSQjqj2FPseYlgSGDIcpJQ3AOPgz+yQlda22rpEZfd hSi8MEyr48KxRURHH+CKFgeW0iEPU8DtqX7UTuybCeyvQqww1r/REEXgphaypcXTT3OUM3ECoWqj 1jOXTyFjHluP2cFeRXF3D4FdXyGarYPM+l7WjSNfGz1BryB1ZlpK9p/7qxj3ccC2HTHsOyDry+K4 9a6SsvfhhEvyovKTmiKe0xRvNlS9H15ZFblzqMF8b3ti6RZsR1pl8w4Rm0bZ/W3c1pzAtH2lsN0/ Vm+h+fbkEkj9Bn8SV7apI09bA8PgcSojt/ewsTu8mL3WmKgMa/aOEmem8rJY5AIJEzypuxC00jBF 8ez3ABHfZfjcK0NVvxaXxA/VLGGEqnKG/uY6fsI/fe78LxQ+5oXdUG+3Se0CAwEAAaNCMEAwDwYD VR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU8ncX+l6o/vY9cdVouslGDDjYr7AwDgYDVR0PAQH/BAQD AgGGMA0GCSqGSIb3DQEBCwUAA4ICAQBQUfB13HAE4/+qddRxosuej6ip0691x1TPOhwEmSKsxBHi 7zNKpiMdDg1H2DfHb680f0+BazVP6XKlMeJ45/dOlBhbQH3PayFUhuaVevvGyuqcSE5XCV0vrPSl tJczWNWseanMX/mF+lLFjfiRFOs6DRfQUsJ748JzjkZ4Bjgs6FzaZsT0pPBWGTMpWmWSBUdGSquE wx4noR8RkpkndZMPvDY7l1ePJlsMu5wP1G4wB9TcXzZoZjmDlicmisjEOf6aIW/Vcobpf2Lll07Q JNBAsNB1CI69aO4I1258EHBGG3zgiLKecoaZAeO/n0kZtCW+VmWuF2PlHt/o/0elv+EmBYTksMCv 5wiZqAxeJoBF1PhoL5aPruJKHJwWDBNvOIf2u8g0X5IDUXlwpt/L9ZlNec1OvFefQ05rLisY+Gpz jLrFNe85akEez3GoorKGB1s6yeHvP2UEgEcyRHCVTjFnanRbEEV16rCf0OY1/k6fi8wrkkVbbiVg hUbN0aqwdmaTd5a+g744tiROJgvM7XpWGuDpWsZkrUx6AEhEL7lAuxM+vhV4nYWBSipX3tUZQ9rb yltHhoMLP7YNdnhzeSJesYAfz77RP1YQmCuVh6EfnWQUYDksswBVLuT1sw5XxJFBAJw/6KXf6vb/ yPCtbVKoF6ubYfwSUTXkJf2vqmqGOQ== -----END CERTIFICATE----- GlobalSign ECC Root CA - R4 =========================== -----BEGIN CERTIFICATE----- MIIB3DCCAYOgAwIBAgINAgPlfvU/k/2lCSGypjAKBggqhkjOPQQDAjBQMSQwIgYDVQQLExtHbG9i YWxTaWduIEVDQyBSb290IENBIC0gUjQxEzARBgNVBAoTCkdsb2JhbFNpZ24xEzARBgNVBAMTCkds b2JhbFNpZ24wHhcNMTIxMTEzMDAwMDAwWhcNMzgwMTE5MDMxNDA3WjBQMSQwIgYDVQQLExtHbG9i YWxTaWduIEVDQyBSb290IENBIC0gUjQxEzARBgNVBAoTCkdsb2JhbFNpZ24xEzARBgNVBAMTCkds b2JhbFNpZ24wWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAAS4xnnTj2wlDp8uORkcA6SumuU5BwkW ymOxuYb4ilfBV85C+nOh92VC/x7BALJucw7/xyHlGKSq2XE/qNS5zowdo0IwQDAOBgNVHQ8BAf8E BAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUVLB7rUW44kB/+wpu+74zyTyjhNUwCgYI KoZIzj0EAwIDRwAwRAIgIk90crlgr/HmnKAWBVBfw147bmF0774BxL4YSFlhgjICICadVGNA3jdg UM/I2O2dgq43mLyjj0xMqTQrbO/7lZsm -----END CERTIFICATE----- GTS Root R1 =========== -----BEGIN CERTIFICATE----- MIIFVzCCAz+gAwIBAgINAgPlk28xsBNJiGuiFzANBgkqhkiG9w0BAQwFADBHMQswCQYDVQQGEwJV UzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3Qg UjEwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UE ChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjEwggIiMA0G CSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC2EQKLHuOhd5s73L+UPreVp0A8of2C+X0yBoJx9vaM f/vo27xqLpeXo4xL+Sv2sfnOhB2x+cWX3u+58qPpvBKJXqeqUqv4IyfLpLGcY9vXmX7wCl7raKb0 xlpHDU0QM+NOsROjyBhsS+z8CZDfnWQpJSMHobTSPS5g4M/SCYe7zUjwTcLCeoiKu7rPWRnWr4+w B7CeMfGCwcDfLqZtbBkOtdh+JhpFAz2weaSUKK0PfyblqAj+lug8aJRT7oM6iCsVlgmy4HqMLnXW nOunVmSPlk9orj2XwoSPwLxAwAtcvfaHszVsrBhQf4TgTM2S0yDpM7xSma8ytSmzJSq0SPly4cpk 9+aCEI3oncKKiPo4Zor8Y/kB+Xj9e1x3+naH+uzfsQ55lVe0vSbv1gHR6xYKu44LtcXFilWr06zq kUspzBmkMiVOKvFlRNACzqrOSbTqn3yDsEB750Orp2yjj32JgfpMpf/VjsPOS+C12LOORc92wO1A K/1TD7Cn1TsNsYqiA94xrcx36m97PtbfkSIS5r762DL8EGMUUXLeXdYWk70paDPvOmbsB4om3xPX V2V4J95eSRQAogB/mqghtqmxlbCluQ0WEdrHbEg8QOB+DVrNVjzRlwW5y0vtOUucxD/SVRNuJLDW cfr0wbrM7Rv1/oFB2ACYPTrIrnqYNxgFlQIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0T AQH/BAUwAwEB/zAdBgNVHQ4EFgQU5K8rJnEaK0gnhS9SZizv8IkTcT4wDQYJKoZIhvcNAQEMBQAD ggIBAJ+qQibbC5u+/x6Wki4+omVKapi6Ist9wTrYggoGxval3sBOh2Z5ofmmWJyq+bXmYOfg6LEe QkEzCzc9zolwFcq1JKjPa7XSQCGYzyI0zzvFIoTgxQ6KfF2I5DUkzps+GlQebtuyh6f88/qBVRRi ClmpIgUxPoLW7ttXNLwzldMXG+gnoot7TiYaelpkttGsN/H9oPM47HLwEXWdyzRSjeZ2axfG34ar J45JK3VmgRAhpuo+9K4l/3wV3s6MJT/KYnAK9y8JZgfIPxz88NtFMN9iiMG1D53Dn0reWVlHxYci NuaCp+0KueIHoI17eko8cdLiA6EfMgfdG+RCzgwARWGAtQsgWSl4vflVy2PFPEz0tv/bal8xa5me LMFrUKTX5hgUvYU/Z6tGn6D/Qqc6f1zLXbBwHSs09dR2CQzreExZBfMzQsNhFRAbd03OIozUhfJF fbdT6u9AWpQKXCBfTkBdYiJ23//OYb2MI3jSNwLgjt7RETeJ9r/tSQdirpLsQBqvFAnZ0E6yove+ 7u7Y/9waLd64NnHi/Hm3lCXRSHNboTXns5lndcEZOitHTtNCjv0xyBZm2tIMPNuzjsmhDYAPexZ3 FL//2wmUspO8IFgV6dtxQ/PeEMMA3KgqlbbC1j+Qa3bbbP6MvPJwNQzcmRk13NfIRmPVNnGuV/u3 gm3c -----END CERTIFICATE----- GTS Root R2 =========== -----BEGIN CERTIFICATE----- MIIFVzCCAz+gAwIBAgINAgPlrsWNBCUaqxElqjANBgkqhkiG9w0BAQwFADBHMQswCQYDVQQGEwJV UzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3Qg UjIwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UE ChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjIwggIiMA0G CSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDO3v2m++zsFDQ8BwZabFn3GTXd98GdVarTzTukk3Lv CvptnfbwhYBboUhSnznFt+4orO/LdmgUud+tAWyZH8QiHZ/+cnfgLFuv5AS/T3KgGjSY6Dlo7JUl e3ah5mm5hRm9iYz+re026nO8/4Piy33B0s5Ks40FnotJk9/BW9BuXvAuMC6C/Pq8tBcKSOWIm8Wb a96wyrQD8Nr0kLhlZPdcTK3ofmZemde4wj7I0BOdre7kRXuJVfeKH2JShBKzwkCX44ofR5GmdFrS +LFjKBC4swm4VndAoiaYecb+3yXuPuWgf9RhD1FLPD+M2uFwdNjCaKH5wQzpoeJ/u1U8dgbuak7M kogwTZq9TwtImoS1mKPV+3PBV2HdKFZ1E66HjucMUQkQdYhMvI35ezzUIkgfKtzra7tEscszcTJG r61K8YzodDqs5xoic4DSMPclQsciOzsSrZYuxsN2B6ogtzVJV+mSSeh2FnIxZyuWfoqjx5RWIr9q S34BIbIjMt/kmkRtWVtd9QCgHJvGeJeNkP+byKq0rxFROV7Z+2et1VsRnTKaG73VululycslaVNV J1zgyjbLiGH7HrfQy+4W+9OmTN6SpdTi3/UGVN4unUu0kzCqgc7dGtxRcw1PcOnlthYhGXmy5okL dWTK1au8CcEYof/UVKGFPP0UJAOyh9OktwIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0T AQH/BAUwAwEB/zAdBgNVHQ4EFgQUu//KjiOfT5nK2+JopqUVJxce2Q4wDQYJKoZIhvcNAQEMBQAD ggIBAB/Kzt3HvqGf2SdMC9wXmBFqiN495nFWcrKeGk6c1SuYJF2ba3uwM4IJvd8lRuqYnrYb/oM8 0mJhwQTtzuDFycgTE1XnqGOtjHsB/ncw4c5omwX4Eu55MaBBRTUoCnGkJE+M3DyCB19m3H0Q/gxh swWV7uGugQ+o+MePTagjAiZrHYNSVc61LwDKgEDg4XSsYPWHgJ2uNmSRXbBoGOqKYcl3qJfEycel /FVL8/B/uWU9J2jQzGv6U53hkRrJXRqWbTKH7QMgyALOWr7Z6v2yTcQvG99fevX4i8buMTolUVVn jWQye+mew4K6Ki3pHrTgSAai/GevHyICc/sgCq+dVEuhzf9gR7A/Xe8bVr2XIZYtCtFenTgCR2y5 9PYjJbigapordwj6xLEokCZYCDzifqrXPW+6MYgKBesntaFJ7qBFVHvmJ2WZICGoo7z7GJa7Um8M 7YNRTOlZ4iBgxcJlkoKM8xAfDoqXvneCbT+PHV28SSe9zE8P4c52hgQjxcCMElv924SgJPFI/2R8 0L5cFtHvma3AH/vLrrw4IgYmZNralw4/KBVEqE8AyvCazM90arQ+POuV7LXTWtiBmelDGDfrs7vR WGJB82bSj6p4lVQgw1oudCvV0b4YacCs1aTPObpRhANl6WLAYv7YTVWW4tAR+kg0Eeye7QUd5MjW HYbL -----END CERTIFICATE----- GTS Root R3 =========== -----BEGIN CERTIFICATE----- MIICCTCCAY6gAwIBAgINAgPluILrIPglJ209ZjAKBggqhkjOPQQDAzBHMQswCQYDVQQGEwJVUzEi MCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjMw HhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZ R29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjMwdjAQBgcqhkjO PQIBBgUrgQQAIgNiAAQfTzOHMymKoYTey8chWEGJ6ladK0uFxh1MJ7x/JlFyb+Kf1qPKzEUURout 736GjOyxfi//qXGdGIRFBEFVbivqJn+7kAHjSxm65FSWRQmx1WyRRK2EE46ajA2ADDL24CejQjBA MA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTB8Sa6oC2uhYHP0/Eq Er24Cmf9vDAKBggqhkjOPQQDAwNpADBmAjEA9uEglRR7VKOQFhG/hMjqb2sXnh5GmCCbn9MN2azT L818+FsuVbu/3ZL3pAzcMeGiAjEA/JdmZuVDFhOD3cffL74UOO0BzrEXGhF16b0DjyZ+hOXJYKaV 11RZt+cRLInUue4X -----END CERTIFICATE----- GTS Root R4 =========== -----BEGIN CERTIFICATE----- MIICCTCCAY6gAwIBAgINAgPlwGjvYxqccpBQUjAKBggqhkjOPQQDAzBHMQswCQYDVQQGEwJVUzEi MCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjQw HhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZ R29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjQwdjAQBgcqhkjO PQIBBgUrgQQAIgNiAATzdHOnaItgrkO4NcWBMHtLSZ37wWHO5t5GvWvVYRg1rkDdc/eJkTBa6zzu hXyiQHY7qca4R9gq55KRanPpsXI5nymfopjTX15YhmUPoYRlBtHci8nHc8iMai/lxKvRHYqjQjBA MA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBSATNbrdP9JNqPV2Py1 PsVq8JQdjDAKBggqhkjOPQQDAwNpADBmAjEA6ED/g94D9J+uHXqnLrmvT/aDHQ4thQEd0dlq7A/C r8deVl5c1RxYIigL9zC2L7F8AjEA8GE8p/SgguMh1YQdc4acLa/KNJvxn7kjNuK8YAOdgLOaVsjh 4rsUecrNIdSUtUlD -----END CERTIFICATE----- Telia Root CA v2 ================ -----BEGIN CERTIFICATE----- MIIFdDCCA1ygAwIBAgIPAWdfJ9b+euPkrL4JWwWeMA0GCSqGSIb3DQEBCwUAMEQxCzAJBgNVBAYT AkZJMRowGAYDVQQKDBFUZWxpYSBGaW5sYW5kIE95ajEZMBcGA1UEAwwQVGVsaWEgUm9vdCBDQSB2 MjAeFw0xODExMjkxMTU1NTRaFw00MzExMjkxMTU1NTRaMEQxCzAJBgNVBAYTAkZJMRowGAYDVQQK DBFUZWxpYSBGaW5sYW5kIE95ajEZMBcGA1UEAwwQVGVsaWEgUm9vdCBDQSB2MjCCAiIwDQYJKoZI hvcNAQEBBQADggIPADCCAgoCggIBALLQPwe84nvQa5n44ndp586dpAO8gm2h/oFlH0wnrI4AuhZ7 6zBqAMCzdGh+sq/H1WKzej9Qyow2RCRj0jbpDIX2Q3bVTKFgcmfiKDOlyzG4OiIjNLh9vVYiQJ3q 9HsDrWj8soFPmNB06o3lfc1jw6P23pLCWBnglrvFxKk9pXSW/q/5iaq9lRdU2HhE8Qx3FZLgmEKn pNaqIJLNwaCzlrI6hEKNfdWV5Nbb6WLEWLN5xYzTNTODn3WhUidhOPFZPY5Q4L15POdslv5e2QJl tI5c0BE0312/UqeBAMN/mUWZFdUXyApT7GPzmX3MaRKGwhfwAZ6/hLzRUssbkmbOpFPlob/E2wnW 5olWK8jjfN7j/4nlNW4o6GwLI1GpJQXrSPjdscr6bAhR77cYbETKJuFzxokGgeWKrLDiKca5JLNr RBH0pUPCTEPlcDaMtjNXepUugqD0XBCzYYP2AgWGLnwtbNwDRm41k9V6lS/eINhbfpSQBGq6WT0E BXWdN6IOLj3rwaRSg/7Qa9RmjtzG6RJOHSpXqhC8fF6CfaamyfItufUXJ63RDolUK5X6wK0dmBR4 M0KGCqlztft0DbcbMBnEWg4cJ7faGND/isgFuvGqHKI3t+ZIpEYslOqodmJHixBTB0hXbOKSTbau BcvcwUpej6w9GU7C7WB1K9vBykLVAgMBAAGjYzBhMB8GA1UdIwQYMBaAFHKs5DN5qkWH9v2sHZ7W xy+G2CQ5MB0GA1UdDgQWBBRyrOQzeapFh/b9rB2e1scvhtgkOTAOBgNVHQ8BAf8EBAMCAQYwDwYD VR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOCAgEAoDtZpwmUPjaE0n4vOaWWl/oRrfxn83EJ 8rKJhGdEr7nv7ZbsnGTbMjBvZ5qsfl+yqwE2foH65IRe0qw24GtixX1LDoJt0nZi0f6X+J8wfBj5 tFJ3gh1229MdqfDBmgC9bXXYfef6xzijnHDoRnkDry5023X4blMMA8iZGok1GTzTyVR8qPAs5m4H eW9q4ebqkYJpCh3DflminmtGFZhb069GHWLIzoBSSRE/yQQSwxN8PzuKlts8oB4KtItUsiRnDe+C y748fdHif64W1lZYudogsYMVoe+KTTJvQS8TUoKU1xrBeKJR3Stwbbca+few4GeXVtt8YVMJAygC QMez2P2ccGrGKMOF6eLtGpOg3kuYooQ+BXcBlj37tCAPnHICehIv1aO6UXivKitEZU61/Qrowc15 h2Er3oBXRb9n8ZuRXqWk7FlIEA04x7D6w0RtBPV4UBySllva9bguulvP5fBqnUsvWHMtTy3EHD70 sz+rFQ47GUGKpMFXEmZxTPpT41frYpUJnlTd0cI8Vzy9OK2YZLe4A5pTVmBds9hCG1xLEooc6+t9 xnppxyd/pPiL8uSUZodL6ZQHCRJ5irLrdATczvREWeAWysUsWNc8e89ihmpQfTU2Zqf7N+cox9jQ raVplI/owd8k+BsHMYeB2F326CjYSlKArBPuUBQemMc= -----END CERTIFICATE----- D-TRUST BR Root CA 1 2020 ========================= -----BEGIN CERTIFICATE----- MIIC2zCCAmCgAwIBAgIQfMmPK4TX3+oPyWWa00tNljAKBggqhkjOPQQDAzBIMQswCQYDVQQGEwJE RTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRSVVNUIEJSIFJvb3QgQ0EgMSAy MDIwMB4XDTIwMDIxMTA5NDUwMFoXDTM1MDIxMTA5NDQ1OVowSDELMAkGA1UEBhMCREUxFTATBgNV BAoTDEQtVHJ1c3QgR21iSDEiMCAGA1UEAxMZRC1UUlVTVCBCUiBSb290IENBIDEgMjAyMDB2MBAG ByqGSM49AgEGBSuBBAAiA2IABMbLxyjR+4T1mu9CFCDhQ2tuda38KwOE1HaTJddZO0Flax7mNCq7 dPYSzuht56vkPE4/RAiLzRZxy7+SmfSk1zxQVFKQhYN4lGdnoxwJGT11NIXe7WB9xwy0QVK5buXu QqOCAQ0wggEJMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFHOREKv/VbNafAkl1bK6CKBrqx9t MA4GA1UdDwEB/wQEAwIBBjCBxgYDVR0fBIG+MIG7MD6gPKA6hjhodHRwOi8vY3JsLmQtdHJ1c3Qu bmV0L2NybC9kLXRydXN0X2JyX3Jvb3RfY2FfMV8yMDIwLmNybDB5oHegdYZzbGRhcDovL2RpcmVj dG9yeS5kLXRydXN0Lm5ldC9DTj1ELVRSVVNUJTIwQlIlMjBSb290JTIwQ0ElMjAxJTIwMjAyMCxP PUQtVHJ1c3QlMjBHbWJILEM9REU/Y2VydGlmaWNhdGVyZXZvY2F0aW9ubGlzdDAKBggqhkjOPQQD AwNpADBmAjEAlJAtE/rhY/hhY+ithXhUkZy4kzg+GkHaQBZTQgjKL47xPoFWwKrY7RjEsK70Pvom AjEA8yjixtsrmfu3Ubgko6SUeho/5jbiA1czijDLgsfWFBHVdWNbFJWcHwHP2NVypw87 -----END CERTIFICATE----- D-TRUST EV Root CA 1 2020 ========================= -----BEGIN CERTIFICATE----- MIIC2zCCAmCgAwIBAgIQXwJB13qHfEwDo6yWjfv/0DAKBggqhkjOPQQDAzBIMQswCQYDVQQGEwJE RTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRSVVNUIEVWIFJvb3QgQ0EgMSAy MDIwMB4XDTIwMDIxMTEwMDAwMFoXDTM1MDIxMTA5NTk1OVowSDELMAkGA1UEBhMCREUxFTATBgNV BAoTDEQtVHJ1c3QgR21iSDEiMCAGA1UEAxMZRC1UUlVTVCBFViBSb290IENBIDEgMjAyMDB2MBAG ByqGSM49AgEGBSuBBAAiA2IABPEL3YZDIBnfl4XoIkqbz52Yv7QFJsnL46bSj8WeeHsxiamJrSc8 ZRCC/N/DnU7wMyPE0jL1HLDfMxddxfCxivnvubcUyilKwg+pf3VlSSowZ/Rk99Yad9rDwpdhQntJ raOCAQ0wggEJMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFH8QARY3OqQo5FD4pPfsazK2/umL MA4GA1UdDwEB/wQEAwIBBjCBxgYDVR0fBIG+MIG7MD6gPKA6hjhodHRwOi8vY3JsLmQtdHJ1c3Qu bmV0L2NybC9kLXRydXN0X2V2X3Jvb3RfY2FfMV8yMDIwLmNybDB5oHegdYZzbGRhcDovL2RpcmVj dG9yeS5kLXRydXN0Lm5ldC9DTj1ELVRSVVNUJTIwRVYlMjBSb290JTIwQ0ElMjAxJTIwMjAyMCxP PUQtVHJ1c3QlMjBHbWJILEM9REU/Y2VydGlmaWNhdGVyZXZvY2F0aW9ubGlzdDAKBggqhkjOPQQD AwNpADBmAjEAyjzGKnXCXnViOTYAYFqLwZOZzNnbQTs7h5kXO9XMT8oi96CAy/m0sRtW9XLS/BnR AjEAkfcwkz8QRitxpNA7RJvAKQIFskF3UfN5Wp6OFKBOQtJbgfM0agPnIjhQW+0ZT0MW -----END CERTIFICATE----- DigiCert TLS ECC P384 Root G5 ============================= -----BEGIN CERTIFICATE----- MIICGTCCAZ+gAwIBAgIQCeCTZaz32ci5PhwLBCou8zAKBggqhkjOPQQDAzBOMQswCQYDVQQGEwJV UzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJjAkBgNVBAMTHURpZ2lDZXJ0IFRMUyBFQ0MgUDM4 NCBSb290IEc1MB4XDTIxMDExNTAwMDAwMFoXDTQ2MDExNDIzNTk1OVowTjELMAkGA1UEBhMCVVMx FzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMSYwJAYDVQQDEx1EaWdpQ2VydCBUTFMgRUNDIFAzODQg Um9vdCBHNTB2MBAGByqGSM49AgEGBSuBBAAiA2IABMFEoc8Rl1Ca3iOCNQfN0MsYndLxf3c1Tzvd lHJS7cI7+Oz6e2tYIOyZrsn8aLN1udsJ7MgT9U7GCh1mMEy7H0cKPGEQQil8pQgO4CLp0zVozptj n4S1mU1YoI71VOeVyaNCMEAwHQYDVR0OBBYEFMFRRVBZqz7nLFr6ICISB4CIfBFqMA4GA1UdDwEB /wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MAoGCCqGSM49BAMDA2gAMGUCMQCJao1H5+z8blUD2Wds Jk6Dxv3J+ysTvLd6jLRl0mlpYxNjOyZQLgGheQaRnUi/wr4CMEfDFXuxoJGZSZOoPHzoRgaLLPIx AJSdYsiJvRmEFOml+wG4DXZDjC5Ty3zfDBeWUA== -----END CERTIFICATE----- DigiCert TLS RSA4096 Root G5 ============================ -----BEGIN CERTIFICATE----- MIIFZjCCA06gAwIBAgIQCPm0eKj6ftpqMzeJ3nzPijANBgkqhkiG9w0BAQwFADBNMQswCQYDVQQG EwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJTAjBgNVBAMTHERpZ2lDZXJ0IFRMUyBSU0E0 MDk2IFJvb3QgRzUwHhcNMjEwMTE1MDAwMDAwWhcNNDYwMTE0MjM1OTU5WjBNMQswCQYDVQQGEwJV UzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJTAjBgNVBAMTHERpZ2lDZXJ0IFRMUyBSU0E0MDk2 IFJvb3QgRzUwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCz0PTJeRGd/fxmgefM1eS8 7IE+ajWOLrfn3q/5B03PMJ3qCQuZvWxX2hhKuHisOjmopkisLnLlvevxGs3npAOpPxG02C+JFvuU AT27L/gTBaF4HI4o4EXgg/RZG5Wzrn4DReW+wkL+7vI8toUTmDKdFqgpwgscONyfMXdcvyej/Ces tyu9dJsXLfKB2l2w4SMXPohKEiPQ6s+d3gMXsUJKoBZMpG2T6T867jp8nVid9E6P/DsjyG244gXa zOvswzH016cpVIDPRFtMbzCe88zdH5RDnU1/cHAN1DrRN/BsnZvAFJNY781BOHW8EwOVfH/jXOnV DdXifBBiqmvwPXbzP6PosMH976pXTayGpxi0KcEsDr9kvimM2AItzVwv8n/vFfQMFawKsPHTDU9q TXeXAaDxZre3zu/O7Oyldcqs4+Fj97ihBMi8ez9dLRYiVu1ISf6nL3kwJZu6ay0/nTvEF+cdLvvy z6b84xQslpghjLSR6Rlgg/IwKwZzUNWYOwbpx4oMYIwo+FKbbuH2TbsGJJvXKyY//SovcfXWJL5/ MZ4PbeiPT02jP/816t9JXkGPhvnxd3lLG7SjXi/7RgLQZhNeXoVPzthwiHvOAbWWl9fNff2C+MIk wcoBOU+NosEUQB+cZtUMCUbW8tDRSHZWOkPLtgoRObqME2wGtZ7P6wIDAQABo0IwQDAdBgNVHQ4E FgQUUTMc7TZArxfTJc1paPKvTiM+s0EwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8w DQYJKoZIhvcNAQEMBQADggIBAGCmr1tfV9qJ20tQqcQjNSH/0GEwhJG3PxDPJY7Jv0Y02cEhJhxw GXIeo8mH/qlDZJY6yFMECrZBu8RHANmfGBg7sg7zNOok992vIGCukihfNudd5N7HPNtQOa27PShN lnx2xlv0wdsUpasZYgcYQF+Xkdycx6u1UQ3maVNVzDl92sURVXLFO4uJ+DQtpBflF+aZfTCIITfN MBc9uPK8qHWgQ9w+iUuQrm0D4ByjoJYJu32jtyoQREtGBzRj7TG5BO6jm5qu5jF49OokYTurWGT/ u4cnYiWB39yhL/btp/96j1EuMPikAdKFOV8BmZZvWltwGUb+hmA+rYAQCd05JS9Yf7vSdPD3Rh9G OUrYU9DzLjtxpdRv/PNn5AeP3SYZ4Y1b+qOTEZvpyDrDVWiakuFSdjjo4bq9+0/V77PnSIMx8IIh 47a+p6tv75/fTM8BuGJqIz3nCU2AG3swpMPdB380vqQmsvZB6Akd4yCYqjdP//fx4ilwMUc/dNAU FvohigLVigmUdy7yWSiLfFCSCmZ4OIN1xLVaqBHG5cGdZlXPU8Sv13WFqUITVuwhd4GTWgzqltlJ yqEI8pc7bZsEGCREjnwB8twl2F6GmrE52/WRMmrRpnCKovfepEWFJqgejF0pW8hL2JpqA15w8oVP bEtoL8pU9ozaMv7Da4M/OMZ+ -----END CERTIFICATE----- Certainly Root R1 ================= -----BEGIN CERTIFICATE----- MIIFRzCCAy+gAwIBAgIRAI4P+UuQcWhlM1T01EQ5t+AwDQYJKoZIhvcNAQELBQAwPTELMAkGA1UE BhMCVVMxEjAQBgNVBAoTCUNlcnRhaW5seTEaMBgGA1UEAxMRQ2VydGFpbmx5IFJvb3QgUjEwHhcN MjEwNDAxMDAwMDAwWhcNNDYwNDAxMDAwMDAwWjA9MQswCQYDVQQGEwJVUzESMBAGA1UEChMJQ2Vy dGFpbmx5MRowGAYDVQQDExFDZXJ0YWlubHkgUm9vdCBSMTCCAiIwDQYJKoZIhvcNAQEBBQADggIP ADCCAgoCggIBANA21B/q3avk0bbm+yLA3RMNansiExyXPGhjZjKcA7WNpIGD2ngwEc/csiu+kr+O 5MQTvqRoTNoCaBZ0vrLdBORrKt03H2As2/X3oXyVtwxwhi7xOu9S98zTm/mLvg7fMbedaFySpvXl 8wo0tf97ouSHocavFwDvA5HtqRxOcT3Si2yJ9HiG5mpJoM610rCrm/b01C7jcvk2xusVtyWMOvwl DbMicyF0yEqWYZL1LwsYpfSt4u5BvQF5+paMjRcCMLT5r3gajLQ2EBAHBXDQ9DGQilHFhiZ5shGI XsXwClTNSaa/ApzSRKft43jvRl5tcdF5cBxGX1HpyTfcX35pe0HfNEXgO4T0oYoKNp43zGJS4YkN KPl6I7ENPT2a/Z2B7yyQwHtETrtJ4A5KVpK8y7XdeReJkd5hiXSSqOMyhb5OhaRLWcsrxXiOcVTQ AjeZjOVJ6uBUcqQRBi8LjMFbvrWhsFNunLhgkR9Za/kt9JQKl7XsxXYDVBtlUrpMklZRNaBA2Cnb rlJ2Oy0wQJuK0EJWtLeIAaSHO1OWzaMWj/Nmqhexx2DgwUMFDO6bW2BvBlyHWyf5QBGenDPBt+U1 VwV/J84XIIwc/PH72jEpSe31C4SnT8H2TsIonPru4K8H+zMReiFPCyEQtkA6qyI6BJyLm4SGcprS p6XEtHWRqSsjAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud DgQWBBTgqj8ljZ9EXME66C6ud0yEPmcM9DANBgkqhkiG9w0BAQsFAAOCAgEAuVevuBLaV4OPaAsz HQNTVfSVcOQrPbA56/qJYv331hgELyE03fFo8NWWWt7CgKPBjcZq91l3rhVkz1t5BXdm6ozTaw3d 8VkswTOlMIAVRQdFGjEitpIAq5lNOo93r6kiyi9jyhXWx8bwPWz8HA2YEGGeEaIi1wrykXprOQ4v MMM2SZ/g6Q8CRFA3lFV96p/2O7qUpUzpvD5RtOjKkjZUbVwlKNrdrRT90+7iIgXr0PK3aBLXWopB GsaSpVo7Y0VPv+E6dyIvXL9G+VoDhRNCX8reU9ditaY1BMJH/5n9hN9czulegChB8n3nHpDYT3Y+ gjwN/KUD+nsa2UUeYNrEjvn8K8l7lcUq/6qJ34IxD3L/DCfXCh5WAFAeDJDBlrXYFIW7pw0WwfgH JBu6haEaBQmAupVjyTrsJZ9/nbqkRxWbRHDxakvWOF5D8xh+UG7pWijmZeZ3Gzr9Hb4DJqPb1OG7 fpYnKx3upPvaJVQTA945xsMfTZDsjxtK0hzthZU4UHlG1sGQUDGpXJpuHfUzVounmdLyyCwzk5Iw x06MZTMQZBf9JBeW0Y3COmor6xOLRPIh80oat3df1+2IpHLlOR+Vnb5nwXARPbv0+Em34yaXOp/S X3z7wJl8OSngex2/DaeP0ik0biQVy96QXr8axGbqwua6OV+KmalBWQewLK8= -----END CERTIFICATE----- Certainly Root E1 ================= -----BEGIN CERTIFICATE----- MIIB9zCCAX2gAwIBAgIQBiUzsUcDMydc+Y2aub/M+DAKBggqhkjOPQQDAzA9MQswCQYDVQQGEwJV UzESMBAGA1UEChMJQ2VydGFpbmx5MRowGAYDVQQDExFDZXJ0YWlubHkgUm9vdCBFMTAeFw0yMTA0 MDEwMDAwMDBaFw00NjA0MDEwMDAwMDBaMD0xCzAJBgNVBAYTAlVTMRIwEAYDVQQKEwlDZXJ0YWlu bHkxGjAYBgNVBAMTEUNlcnRhaW5seSBSb290IEUxMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAE3m/4 fxzf7flHh4axpMCK+IKXgOqPyEpeKn2IaKcBYhSRJHpcnqMXfYqGITQYUBsQ3tA3SybHGWCA6TS9 YBk2QNYphwk8kXr2vBMj3VlOBF7PyAIcGFPBMdjaIOlEjeR2o0IwQDAOBgNVHQ8BAf8EBAMCAQYw DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU8ygYy2R17ikq6+2uI1g4hevIIgcwCgYIKoZIzj0E AwMDaAAwZQIxALGOWiDDshliTd6wT99u0nCK8Z9+aozmut6Dacpps6kFtZaSF4fC0urQe87YQVt8 rgIwRt7qy12a7DLCZRawTDBcMPPaTnOGBtjOiQRINzf43TNRnXCve1XYAS59BWQOhriR -----END CERTIFICATE----- Security Communication RootCA3 ============================== -----BEGIN CERTIFICATE----- MIIFfzCCA2egAwIBAgIJAOF8N0D9G/5nMA0GCSqGSIb3DQEBDAUAMF0xCzAJBgNVBAYTAkpQMSUw IwYDVQQKExxTRUNPTSBUcnVzdCBTeXN0ZW1zIENPLixMVEQuMScwJQYDVQQDEx5TZWN1cml0eSBD b21tdW5pY2F0aW9uIFJvb3RDQTMwHhcNMTYwNjE2MDYxNzE2WhcNMzgwMTE4MDYxNzE2WjBdMQsw CQYDVQQGEwJKUDElMCMGA1UEChMcU0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UE AxMeU2VjdXJpdHkgQ29tbXVuaWNhdGlvbiBSb290Q0EzMIICIjANBgkqhkiG9w0BAQEFAAOCAg8A MIICCgKCAgEA48lySfcw3gl8qUCBWNO0Ot26YQ+TUG5pPDXC7ltzkBtnTCHsXzW7OT4rCmDvu20r hvtxosis5FaU+cmvsXLUIKx00rgVrVH+hXShuRD+BYD5UpOzQD11EKzAlrenfna84xtSGc4RHwsE NPXY9Wk8d/Nk9A2qhd7gCVAEF5aEt8iKvE1y/By7z/MGTfmfZPd+pmaGNXHIEYBMwXFAWB6+oHP2 /D5Q4eAvJj1+XCO1eXDe+uDRpdYMQXF79+qMHIjH7Iv10S9VlkZ8WjtYO/u62C21Jdp6Ts9EriGm npjKIG58u4iFW/vAEGK78vknR+/RiTlDxN/e4UG/VHMgly1s2vPUB6PmudhvrvyMGS7TZ2crldtY XLVqAvO4g160a75BflcJdURQVc1aEWEhCmHCqYj9E7wtiS/NYeCVvsq1e+F7NGcLH7YMx3weGVPK p7FKFSBWFHA9K4IsD50VHUeAR/94mQ4xr28+j+2GaR57GIgUssL8gjMunEst+3A7caoreyYn8xrC 3PsXuKHqy6C0rtOUfnrQq8PsOC0RLoi/1D+tEjtCrI8Cbn3M0V9hvqG8OmpI6iZVIhZdXw3/JzOf GAN0iltSIEdrRU0id4xVJ/CvHozJgyJUt5rQT9nO/NkuHJYosQLTA70lUhw0Zk8jq/R3gpYd0Vcw CBEF/VfR2ccCAwEAAaNCMEAwHQYDVR0OBBYEFGQUfPxYchamCik0FW8qy7z8r6irMA4GA1UdDwEB /wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3DQEBDAUAA4ICAQDcAiMI4u8hOscNtybS YpOnpSNyByCCYN8Y11StaSWSntkUz5m5UoHPrmyKO1o5yGwBQ8IibQLwYs1OY0PAFNr0Y/Dq9HHu Tofjcan0yVflLl8cebsjqodEV+m9NU1Bu0soo5iyG9kLFwfl9+qd9XbXv8S2gVj/yP9kaWJ5rW4O H3/uHWnlt3Jxs/6lATWUVCvAUm2PVcTJ0rjLyjQIUYWg9by0F1jqClx6vWPGOi//lkkZhOpn2ASx YfQAW0q3nHE3GYV5v4GwxxMOdnE+OoAGrgYWp421wsTL/0ClXI2lyTrtcoHKXJg80jQDdwj98ClZ XSEIx2C/pHF7uNkegr4Jr2VvKKu/S7XuPghHJ6APbw+LP6yVGPO5DtxnVW5inkYO0QR4ynKudtml +LLfiAlhi+8kTtFZP1rUPcmTPCtk9YENFpb3ksP+MW/oKjJ0DvRMmEoYDjBU1cXrvMUVnuiZIesn KwkK2/HmcBhWuwzkvvnoEKQTkrgc4NtnHVMDpCKn3F2SEDzq//wbEBrD2NCcnWXL0CsnMQMeNuE9 dnUM/0Umud1RvCPHX9jYhxBAEg09ODfnRDwYwFMJZI//1ZqmfHAuc1Uh6N//g7kdPjIe1qZ9LPFm 6Vwdp6POXiUyK+OVrCoHzrQoeIY8LaadTdJ0MN1kURXbg4NR16/9M51NZg== -----END CERTIFICATE----- Security Communication ECC RootCA1 ================================== -----BEGIN CERTIFICATE----- MIICODCCAb6gAwIBAgIJANZdm7N4gS7rMAoGCCqGSM49BAMDMGExCzAJBgNVBAYTAkpQMSUwIwYD VQQKExxTRUNPTSBUcnVzdCBTeXN0ZW1zIENPLixMVEQuMSswKQYDVQQDEyJTZWN1cml0eSBDb21t dW5pY2F0aW9uIEVDQyBSb290Q0ExMB4XDTE2MDYxNjA1MTUyOFoXDTM4MDExODA1MTUyOFowYTEL MAkGA1UEBhMCSlAxJTAjBgNVBAoTHFNFQ09NIFRydXN0IFN5c3RlbXMgQ08uLExURC4xKzApBgNV BAMTIlNlY3VyaXR5IENvbW11bmljYXRpb24gRUNDIFJvb3RDQTEwdjAQBgcqhkjOPQIBBgUrgQQA IgNiAASkpW9gAwPDvTH00xecK4R1rOX9PVdu12O/5gSJko6BnOPpR27KkBLIE+CnnfdldB9sELLo 5OnvbYUymUSxXv3MdhDYW72ixvnWQuRXdtyQwjWpS4g8EkdtXP9JTxpKULGjQjBAMB0GA1UdDgQW BBSGHOf+LaVKiwj+KBH6vqNm+GBZLzAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAK BggqhkjOPQQDAwNoADBlAjAVXUI9/Lbu9zuxNuie9sRGKEkz0FhDKmMpzE2xtHqiuQ04pV1IKv3L snNdo4gIxwwCMQDAqy0Obe0YottT6SXbVQjgUMzfRGEWgqtJsLKB7HOHeLRMsmIbEvoWTSVLY70e N9k= -----END CERTIFICATE----- BJCA Global Root CA1 ==================== -----BEGIN CERTIFICATE----- MIIFdDCCA1ygAwIBAgIQVW9l47TZkGobCdFsPsBsIDANBgkqhkiG9w0BAQsFADBUMQswCQYDVQQG EwJDTjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRIT1JJVFkxHTAbBgNVBAMMFEJK Q0EgR2xvYmFsIFJvb3QgQ0ExMB4XDTE5MTIxOTAzMTYxN1oXDTQ0MTIxMjAzMTYxN1owVDELMAkG A1UEBhMCQ04xJjAkBgNVBAoMHUJFSUpJTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQD DBRCSkNBIEdsb2JhbCBSb290IENBMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAPFm CL3ZxRVhy4QEQaVpN3cdwbB7+sN3SJATcmTRuHyQNZ0YeYjjlwE8R4HyDqKYDZ4/N+AZspDyRhyS sTphzvq3Rp4Dhtczbu33RYx2N95ulpH3134rhxfVizXuhJFyV9xgw8O558dnJCNPYwpj9mZ9S1Wn P3hkSWkSl+BMDdMJoDIwOvqfwPKcxRIqLhy1BDPapDgRat7GGPZHOiJBhyL8xIkoVNiMpTAK+BcW yqw3/XmnkRd4OJmtWO2y3syJfQOcs4ll5+M7sSKGjwZteAf9kRJ/sGsciQ35uMt0WwfCyPQ10WRj eulumijWML3mG90Vr4TqnMfK9Q7q8l0ph49pczm+LiRvRSGsxdRpJQaDrXpIhRMsDQa4bHlW/KNn MoH1V6XKV0Jp6VwkYe/iMBhORJhVb3rCk9gZtt58R4oRTklH2yiUAguUSiz5EtBP6DF+bHq/pj+b OT0CFqMYs2esWz8sgytnOYFcuX6U1WTdno9uruh8W7TXakdI136z1C2OVnZOz2nxbkRs1CTqjSSh GL+9V/6pmTW12xB3uD1IutbB5/EjPtffhZ0nPNRAvQoMvfXnjSXWgXSHRtQpdaJCbPdzied9v3pK H9MiyRVVz99vfFXQpIsHETdfg6YmV6YBW37+WGgHqel62bno/1Afq8K0wM7o6v0PvY1NuLxxAgMB AAGjQjBAMB0GA1UdDgQWBBTF7+3M2I0hxkjk49cULqcWk+WYATAPBgNVHRMBAf8EBTADAQH/MA4G A1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAUoKsITQfI/Ki2Pm4rzc2IInRNwPWaZ+4 YRC6ojGYWUfo0Q0lHhVBDOAqVdVXUsv45Mdpox1NcQJeXyFFYEhcCY5JEMEE3KliawLwQ8hOnThJ dMkycFRtwUf8jrQ2ntScvd0g1lPJGKm1Vrl2i5VnZu69mP6u775u+2D2/VnGKhs/I0qUJDAnyIm8 60Qkmss9vk/Ves6OF8tiwdneHg56/0OGNFK8YT88X7vZdrRTvJez/opMEi4r89fO4aL/3Xtw+zuh TaRjAv04l5U/BXCga99igUOLtFkNSoxUnMW7gZ/NfaXvCyUeOiDbHPwfmGcCCtRzRBPbUYQaVQNW 4AB+dAb/OMRyHdOoP2gxXdMJxy6MW2Pg6Nwe0uxhHvLe5e/2mXZgLR6UcnHGCyoyx5JO1UbXHfmp GQrI+pXObSOYqgs4rZpWDW+N8TEAiMEXnM0ZNjX+VVOg4DwzX5Ze4jLp3zO7Bkqp2IRzznfSxqxx 4VyjHQy7Ct9f4qNx2No3WqB4K/TUfet27fJhcKVlmtOJNBir+3I+17Q9eVzYH6Eze9mCUAyTF6ps 3MKCuwJXNq+YJyo5UOGwifUll35HaBC07HPKs5fRJNz2YqAo07WjuGS3iGJCz51TzZm+ZGiPTx4S SPfSKcOYKMryMguTjClPPGAyzQWWYezyr/6zcCwupvI= -----END CERTIFICATE----- BJCA Global Root CA2 ==================== -----BEGIN CERTIFICATE----- MIICJTCCAaugAwIBAgIQLBcIfWQqwP6FGFkGz7RK6zAKBggqhkjOPQQDAzBUMQswCQYDVQQGEwJD TjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRIT1JJVFkxHTAbBgNVBAMMFEJKQ0Eg R2xvYmFsIFJvb3QgQ0EyMB4XDTE5MTIxOTAzMTgyMVoXDTQ0MTIxMjAzMTgyMVowVDELMAkGA1UE BhMCQ04xJjAkBgNVBAoMHUJFSUpJTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQDDBRC SkNBIEdsb2JhbCBSb290IENBMjB2MBAGByqGSM49AgEGBSuBBAAiA2IABJ3LgJGNU2e1uVCxA/jl SR9BIgmwUVJY1is0j8USRhTFiy8shP8sbqjV8QnjAyEUxEM9fMEsxEtqSs3ph+B99iK++kpRuDCK /eHeGBIK9ke35xe/J4rUQUyWPGCWwf0VHKNCMEAwHQYDVR0OBBYEFNJKsVF/BvDRgh9Obl+rg/xI 1LCRMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMAoGCCqGSM49BAMDA2gAMGUCMBq8 W9f+qdJUDkpd0m2xQNz0Q9XSSpkZElaA94M04TVOSG0ED1cxMDAtsaqdAzjbBgIxAMvMh1PLet8g UXOQwKhbYdDFUDn9hf7B43j4ptZLvZuHjw/l1lOWqzzIQNph91Oj9w== -----END CERTIFICATE----- Sectigo Public Server Authentication Root E46 ============================================= -----BEGIN CERTIFICATE----- MIICOjCCAcGgAwIBAgIQQvLM2htpN0RfFf51KBC49DAKBggqhkjOPQQDAzBfMQswCQYDVQQGEwJH QjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1YmxpYyBTZXJ2 ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwHhcNMjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1OTU5 WjBfMQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0 aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwdjAQBgcqhkjOPQIBBgUr gQQAIgNiAAR2+pmpbiDt+dd34wc7qNs9Xzjoq1WmVk/WSOrsfy2qw7LFeeyZYX8QeccCWvkEN/U0 NSt3zn8gj1KjAIns1aeibVvjS5KToID1AZTc8GgHHs3u/iVStSBDHBv+6xnOQ6OjQjBAMB0GA1Ud DgQWBBTRItpMWfFLXyY4qp3W7usNw/upYTAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB /zAKBggqhkjOPQQDAwNnADBkAjAn7qRaqCG76UeXlImldCBteU/IvZNeWBj7LRoAasm4PdCkT0RH lAFWovgzJQxC36oCMB3q4S6ILuH5px0CMk7yn2xVdOOurvulGu7t0vzCAxHrRVxgED1cf5kDW21U SAGKcw== -----END CERTIFICATE----- Sectigo Public Server Authentication Root R46 ============================================= -----BEGIN CERTIFICATE----- MIIFijCCA3KgAwIBAgIQdY39i658BwD6qSWn4cetFDANBgkqhkiG9w0BAQwFADBfMQswCQYDVQQG EwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1YmxpYyBT ZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYwHhcNMjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1 OTU5WjBfMQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1T ZWN0aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYwggIiMA0GCSqGSIb3 DQEBAQUAA4ICDwAwggIKAoICAQCTvtU2UnXYASOgHEdCSe5jtrch/cSV1UgrJnwUUxDaef0rty2k 1Cz66jLdScK5vQ9IPXtamFSvnl0xdE8H/FAh3aTPaE8bEmNtJZlMKpnzSDBh+oF8HqcIStw+Kxwf GExxqjWMrfhu6DtK2eWUAtaJhBOqbchPM8xQljeSM9xfiOefVNlI8JhD1mb9nxc4Q8UBUQvX4yMP FF1bFOdLvt30yNoDN9HWOaEhUTCDsG3XME6WW5HwcCSrv0WBZEMNvSE6Lzzpng3LILVCJ8zab5vu ZDCQOc2TZYEhMbUjUDM3IuM47fgxMMxF/mL50V0yeUKH32rMVhlATc6qu/m1dkmU8Sf4kaWD5Qaz Yw6A3OASVYCmO2a0OYctyPDQ0RTp5A1NDvZdV3LFOxxHVp3i1fuBYYzMTYCQNFu31xR13NgESJ/A wSiItOkcyqex8Va3e0lMWeUgFaiEAin6OJRpmkkGj80feRQXEgyDet4fsZfu+Zd4KKTIRJLpfSYF plhym3kT2BFfrsU4YjRosoYwjviQYZ4ybPUHNs2iTG7sijbt8uaZFURww3y8nDnAtOFr94MlI1fZ EoDlSfB1D++N6xybVCi0ITz8fAr/73trdf+LHaAZBav6+CuBQug4urv7qv094PPK306Xlynt8xhW 6aWWrL3DkJiy4Pmi1KZHQ3xtzwIDAQABo0IwQDAdBgNVHQ4EFgQUVnNYZJX5khqwEioEYnmhQBWI IUkwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAC9c mTz8Bl6MlC5w6tIyMY208FHVvArzZJ8HXtXBc2hkeqK5Duj5XYUtqDdFqij0lgVQYKlJfp/imTYp E0RHap1VIDzYm/EDMrraQKFz6oOht0SmDpkBm+S8f74TlH7Kph52gDY9hAaLMyZlbcp+nv4fjFg4 exqDsQ+8FxG75gbMY/qB8oFM2gsQa6H61SilzwZAFv97fRheORKkU55+MkIQpiGRqRxOF3yEvJ+M 0ejf5lG5Nkc/kLnHvALcWxxPDkjBJYOcCj+esQMzEhonrPcibCTRAUH4WAP+JWgiH5paPHxsnnVI 84HxZmduTILA7rpXDhjvLpr3Etiga+kFpaHpaPi8TD8SHkXoUsCjvxInebnMMTzD9joiFgOgyY9m pFuiTdaBJQbpdqQACj7LzTWb4OE4y2BThihCQRxEV+ioratF4yUQvNs+ZUH7G6aXD+u5dHn5Hrwd Vw1Hr8Mvn4dGp+smWg9WY7ViYG4A++MnESLn/pmPNPW56MORcr3Ywx65LvKRRFHQV80MNNVIIb/b E/FmJUNS0nAiNs2fxBx1IK1jcmMGDw4nztJqDby1ORrp0XZ60Vzk50lJLVU3aPAaOpg+VBeHVOmm J1CJeyAvP/+/oYtKR5j/K3tJPsMpRmAYQqszKbrAKbkTidOIijlBO8n9pu0f9GBj39ItVQGL -----END CERTIFICATE----- SSL.com TLS RSA Root CA 2022 ============================ -----BEGIN CERTIFICATE----- MIIFiTCCA3GgAwIBAgIQb77arXO9CEDii02+1PdbkTANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQG EwJVUzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQDDBxTU0wuY29tIFRMUyBSU0Eg Um9vdCBDQSAyMDIyMB4XDTIyMDgyNTE2MzQyMloXDTQ2MDgxOTE2MzQyMVowTjELMAkGA1UEBhMC VVMxGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgUlNBIFJv b3QgQ0EgMjAyMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANCkCXJPQIgSYT41I57u 9nTPL3tYPc48DRAokC+X94xI2KDYJbFMsBFMF3NQ0CJKY7uB0ylu1bUJPiYYf7ISf5OYt6/wNr/y 7hienDtSxUcZXXTzZGbVXcdotL8bHAajvI9AI7YexoS9UcQbOcGV0insS657Lb85/bRi3pZ7Qcac oOAGcvvwB5cJOYF0r/c0WRFXCsJbwST0MXMwgsadugL3PnxEX4MN8/HdIGkWCVDi1FW24IBydm5M R7d1VVm0U3TZlMZBrViKMWYPHqIbKUBOL9975hYsLfy/7PO0+r4Y9ptJ1O4Fbtk085zx7AGL0SDG D6C1vBdOSHtRwvzpXGk3R2azaPgVKPC506QVzFpPulJwoxJF3ca6TvvC0PeoUidtbnm1jPx7jMEW TO6Af77wdr5BUxIzrlo4QqvXDz5BjXYHMtWrifZOZ9mxQnUjbvPNQrL8VfVThxc7wDNY8VLS+YCk 8OjwO4s4zKTGkH8PnP2L0aPP2oOnaclQNtVcBdIKQXTbYxE3waWglksejBYSd66UNHsef8JmAOSq g+qKkK3ONkRN0VHpvB/zagX9wHQfJRlAUW7qglFA35u5CCoGAtUjHBPW6dvbxrB6y3snm/vg1UYk 7RBLY0ulBY+6uB0rpvqR4pJSvezrZ5dtmi2fgTIFZzL7SAg/2SW4BCUvAgMBAAGjYzBhMA8GA1Ud EwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU+y437uOEeicuzRk1sTN8/9REQrkwHQYDVR0OBBYEFPsu N+7jhHonLs0ZNbEzfP/UREK5MA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAjYlt hEUY8U+zoO9opMAdrDC8Z2awms22qyIZZtM7QbUQnRC6cm4pJCAcAZli05bg4vsMQtfhWsSWTVTN j8pDU/0quOr4ZcoBwq1gaAafORpR2eCNJvkLTqVTJXojpBzOCBvfR4iyrT7gJ4eLSYwfqUdYe5by iB0YrrPRpgqU+tvT5TgKa3kSM/tKWTcWQA673vWJDPFs0/dRa1419dvAJuoSc06pkZCmF8NsLzjU o3KUQyxi4U5cMj29TH0ZR6LDSeeWP4+a0zvkEdiLA9z2tmBVGKaBUfPhqBVq6+AL8BQx1rmMRTqo ENjwuSfr98t67wVylrXEj5ZzxOhWc5y8aVFjvO9nHEMaX3cZHxj4HCUp+UmZKbaSPaKDN7Egkaib MOlqbLQjk2UEqxHzDh1TJElTHaE/nUiSEeJ9DU/1172iWD54nR4fK/4huxoTtrEoZP2wAgDHbICi vRZQIA9ygV/MlP+7mea6kMvq+cYMwq7FGc4zoWtcu358NFcXrfA/rs3qr5nsLFR+jM4uElZI7xc7 P0peYNLcdDa8pUNjyw9bowJWCZ4kLOGGgYz+qxcs+sjiMho6/4UIyYOf8kpIEFR3N+2ivEC+5BB0 9+Rbu7nzifmPQdjH5FCQNYA+HLhNkNPU98OwoX6EyneSMSy4kLGCenROmxMmtNVQZlR4rmA= -----END CERTIFICATE----- SSL.com TLS ECC Root CA 2022 ============================ -----BEGIN CERTIFICATE----- MIICOjCCAcCgAwIBAgIQFAP1q/s3ixdAW+JDsqXRxDAKBggqhkjOPQQDAzBOMQswCQYDVQQGEwJV UzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQDDBxTU0wuY29tIFRMUyBFQ0MgUm9v dCBDQSAyMDIyMB4XDTIyMDgyNTE2MzM0OFoXDTQ2MDgxOTE2MzM0N1owTjELMAkGA1UEBhMCVVMx GDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgRUNDIFJvb3Qg Q0EgMjAyMjB2MBAGByqGSM49AgEGBSuBBAAiA2IABEUpNXP6wrgjzhR9qLFNoFs27iosU8NgCTWy JGYmacCzldZdkkAZDsalE3D07xJRKF3nzL35PIXBz5SQySvOkkJYWWf9lCcQZIxPBLFNSeR7T5v1 5wj4A4j3p8OSSxlUgaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBSJjy+j6CugFFR7 81a4Jl9nOAuc0DAdBgNVHQ4EFgQUiY8vo+groBRUe/NWuCZfZzgLnNAwDgYDVR0PAQH/BAQDAgGG MAoGCCqGSM49BAMDA2gAMGUCMFXjIlbp15IkWE8elDIPDAI2wv2sdDJO4fscgIijzPvX6yv/N33w 7deedWo1dlJF4AIxAMeNb0Igj762TVntd00pxCAgRWSGOlDGxK0tk/UYfXLtqc/ErFc2KAhl3zx5 Zn6g6g== -----END CERTIFICATE----- Atos TrustedRoot Root CA ECC TLS 2021 ===================================== -----BEGIN CERTIFICATE----- MIICFTCCAZugAwIBAgIQPZg7pmY9kGP3fiZXOATvADAKBggqhkjOPQQDAzBMMS4wLAYDVQQDDCVB dG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgRUNDIFRMUyAyMDIxMQ0wCwYDVQQKDARBdG9zMQswCQYD VQQGEwJERTAeFw0yMTA0MjIwOTI2MjNaFw00MTA0MTcwOTI2MjJaMEwxLjAsBgNVBAMMJUF0b3Mg VHJ1c3RlZFJvb3QgUm9vdCBDQSBFQ0MgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNVBAYT AkRFMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEloZYKDcKZ9Cg3iQZGeHkBQcfl+3oZIK59sRxUM6K DP/XtXa7oWyTbIOiaG6l2b4siJVBzV3dscqDY4PMwL502eCdpO5KTlbgmClBk1IQ1SQ4AjJn8ZQS b+/Xxd4u/RmAo0IwQDAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBR2KCXWfeBmmnoJsmo7jjPX NtNPojAOBgNVHQ8BAf8EBAMCAYYwCgYIKoZIzj0EAwMDaAAwZQIwW5kp85wxtolrbNa9d+F851F+ uDrNozZffPc8dz7kUK2o59JZDCaOMDtuCCrCp1rIAjEAmeMM56PDr9NJLkaCI2ZdyQAUEv049OGY a3cpetskz2VAv9LcjBHo9H1/IISpQuQo -----END CERTIFICATE----- Atos TrustedRoot Root CA RSA TLS 2021 ===================================== -----BEGIN CERTIFICATE----- MIIFZDCCA0ygAwIBAgIQU9XP5hmTC/srBRLYwiqipDANBgkqhkiG9w0BAQwFADBMMS4wLAYDVQQD DCVBdG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgUlNBIFRMUyAyMDIxMQ0wCwYDVQQKDARBdG9zMQsw CQYDVQQGEwJERTAeFw0yMTA0MjIwOTIxMTBaFw00MTA0MTcwOTIxMDlaMEwxLjAsBgNVBAMMJUF0 b3MgVHJ1c3RlZFJvb3QgUm9vdCBDQSBSU0EgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNV BAYTAkRFMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAtoAOxHm9BYx9sKOdTSJNy/BB l01Z4NH+VoyX8te9j2y3I49f1cTYQcvyAh5x5en2XssIKl4w8i1mx4QbZFc4nXUtVsYvYe+W/CBG vevUez8/fEc4BKkbqlLfEzfTFRVOvV98r61jx3ncCHvVoOX3W3WsgFWZkmGbzSoXfduP9LVq6hdK ZChmFSlsAvFr1bqjM9xaZ6cF4r9lthawEO3NUDPJcFDsGY6wx/J0W2tExn2WuZgIWWbeKQGb9Cpt 0xU6kGpn8bRrZtkh68rZYnxGEFzedUlnnkL5/nWpo63/dgpnQOPF943HhZpZnmKaau1Fh5hnstVK PNe0OwANwI8f4UDErmwh3El+fsqyjW22v5MvoVw+j8rtgI5Y4dtXz4U2OLJxpAmMkokIiEjxQGMY sluMWuPD0xeqqxmjLBvk1cbiZnrXghmmOxYsL3GHX0WelXOTwkKBIROW1527k2gV+p2kHYzygeBY Br3JtuP2iV2J+axEoctr+hbxx1A9JNr3w+SH1VbxT5Aw+kUJWdo0zuATHAR8ANSbhqRAvNncTFd+ rrcztl524WWLZt+NyteYr842mIycg5kDcPOvdO3GDjbnvezBc6eUWsuSZIKmAMFwoW4sKeFYV+xa fJlrJaSQOoD0IJ2azsct+bJLKZWD6TWNp0lIpw9MGZHQ9b8Q4HECAwEAAaNCMEAwDwYDVR0TAQH/ BAUwAwEB/zAdBgNVHQ4EFgQUdEmZ0f+0emhFdcN+tNzMzjkz2ggwDgYDVR0PAQH/BAQDAgGGMA0G CSqGSIb3DQEBDAUAA4ICAQAjQ1MkYlxt/T7Cz1UAbMVWiLkO3TriJQ2VSpfKgInuKs1l+NsW4AmS 4BjHeJi78+xCUvuppILXTdiK/ORO/auQxDh1MoSf/7OwKwIzNsAQkG8dnK/haZPso0UvFJ/1TCpl Q3IM98P4lYsU84UgYt1UU90s3BiVaU+DR3BAM1h3Egyi61IxHkzJqM7F78PRreBrAwA0JrRUITWX AdxfG/F851X6LWh3e9NpzNMOa7pNdkTWwhWaJuywxfW70Xp0wmzNxbVe9kzmWy2B27O3Opee7c9G slA9hGCZcbUztVdF5kJHdWoOsAgMrr3e97sPWD2PAzHoPYJQyi9eDF20l74gNAf0xBLh7tew2Vkt afcxBPTy+av5EzH4AXcOPUIjJsyacmdRIXrMPIWo6iFqO9taPKU0nprALN+AnCng33eU0aKAQv9q TFsR0PXNor6uzFFcw9VUewyu1rkGd4Di7wcaaMxZUa1+XGdrudviB0JbuAEFWDlN5LuYo7Ey7Nmj 1m+UI/87tyll5gfp77YZ6ufCOB0yiJA8EytuzO+rdwY0d4RPcuSBhPm5dDTedk+SKlOxJTnbPP/l PqYO5Wue/9vsL3SD3460s6neFE3/MaNFcyT6lSnMEpcEoji2jbDwN/zIIX8/syQbPYtuzE2wFg2W HYMfRsCbvUOZ58SWLs5fyQ== -----END CERTIFICATE----- TrustAsia Global Root CA G3 =========================== -----BEGIN CERTIFICATE----- MIIFpTCCA42gAwIBAgIUZPYOZXdhaqs7tOqFhLuxibhxkw8wDQYJKoZIhvcNAQEMBQAwWjELMAkG A1UEBhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dpZXMsIEluYy4xJDAiBgNVBAMM G1RydXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHMzAeFw0yMTA1MjAwMjEwMTlaFw00NjA1MTkwMjEw MTlaMFoxCzAJBgNVBAYTAkNOMSUwIwYDVQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMu MSQwIgYDVQQDDBtUcnVzdEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzMwggIiMA0GCSqGSIb3DQEBAQUA A4ICDwAwggIKAoICAQDAMYJhkuSUGwoqZdC+BqmHO1ES6nBBruL7dOoKjbmzTNyPtxNST1QY4Sxz lZHFZjtqz6xjbYdT8PfxObegQ2OwxANdV6nnRM7EoYNl9lA+sX4WuDqKAtCWHwDNBSHvBm3dIZwZ Q0WhxeiAysKtQGIXBsaqvPPW5vxQfmZCHzyLpnl5hkA1nyDvP+uLRx+PjsXUjrYsyUQE49RDdT/V P68czH5GX6zfZBCK70bwkPAPLfSIC7Epqq+FqklYqL9joDiR5rPmd2jE+SoZhLsO4fWvieylL1Ag dB4SQXMeJNnKziyhWTXAyB1GJ2Faj/lN03J5Zh6fFZAhLf3ti1ZwA0pJPn9pMRJpxx5cynoTi+jm 9WAPzJMshH/x/Gr8m0ed262IPfN2dTPXS6TIi/n1Q1hPy8gDVI+lhXgEGvNz8teHHUGf59gXzhqc D0r83ERoVGjiQTz+LISGNzzNPy+i2+f3VANfWdP3kXjHi3dqFuVJhZBFcnAvkV34PmVACxmZySYg WmjBNb9Pp1Hx2BErW+Canig7CjoKH8GB5S7wprlppYiU5msTf9FkPz2ccEblooV7WIQn3MSAPmea mseaMQ4w7OYXQJXZRe0Blqq/DPNL0WP3E1jAuPP6Z92bfW1K/zJMtSU7/xxnD4UiWQWRkUF3gdCF TIcQcf+eQxuulXUtgQIDAQABo2MwYTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFEDk5PIj 7zjKsK5Xf/IhMBY027ySMB0GA1UdDgQWBBRA5OTyI+84yrCuV3/yITAWNNu8kjAOBgNVHQ8BAf8E BAMCAQYwDQYJKoZIhvcNAQEMBQADggIBACY7UeFNOPMyGLS0XuFlXsSUT9SnYaP4wM8zAQLpw6o1 D/GUE3d3NZ4tVlFEbuHGLige/9rsR82XRBf34EzC4Xx8MnpmyFq2XFNFV1pF1AWZLy4jVe5jaN/T G3inEpQGAHUNcoTpLrxaatXeL1nHo+zSh2bbt1S1JKv0Q3jbSwTEb93mPmY+KfJLaHEih6D4sTNj duMNhXJEIlU/HHzp/LgV6FL6qj6jITk1dImmasI5+njPtqzn59ZW/yOSLlALqbUHM/Q4X6RJpstl cHboCoWASzY9M/eVVHUl2qzEc4Jl6VL1XP04lQJqaTDFHApXB64ipCz5xUG3uOyfT0gA+QEEVcys +TIxxHWVBqB/0Y0n3bOppHKH/lmLmnp0Ft0WpWIp6zqW3IunaFnT63eROfjXy9mPX1onAX1daBli 2MjN9LdyR75bl87yraKZk62Uy5P2EgmVtqvXO9A/EcswFi55gORngS1d7XB4tmBZrOFdRWOPyN9y aFvqHbgB8X7754qz41SgOAngPN5C8sLtLpvzHzW2NtjjgKGLzZlkD8Kqq7HK9W+eQ42EVJmzbsAS ZthwEPEGNTNDqJwuuhQxzhB/HIbjj9LV+Hfsm6vxL2PZQl/gZ4FkkfGXL/xuJvYz+NO1+MRiqzFR JQJ6+N1rZdVtTTDIZbpoFGWsJwt0ivKH -----END CERTIFICATE----- TrustAsia Global Root CA G4 =========================== -----BEGIN CERTIFICATE----- MIICVTCCAdygAwIBAgIUTyNkuI6XY57GU4HBdk7LKnQV1tcwCgYIKoZIzj0EAwMwWjELMAkGA1UE BhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dpZXMsIEluYy4xJDAiBgNVBAMMG1Ry dXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHNDAeFw0yMTA1MjAwMjEwMjJaFw00NjA1MTkwMjEwMjJa MFoxCzAJBgNVBAYTAkNOMSUwIwYDVQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMuMSQw IgYDVQQDDBtUcnVzdEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzQwdjAQBgcqhkjOPQIBBgUrgQQAIgNi AATxs8045CVD5d4ZCbuBeaIVXxVjAd7Cq92zphtnS4CDr5nLrBfbK5bKfFJV4hrhPVbwLxYI+hW8 m7tH5j/uqOFMjPXTNvk4XatwmkcN4oFBButJ+bAp3TPsUKV/eSm4IJijYzBhMA8GA1UdEwEB/wQF MAMBAf8wHwYDVR0jBBgwFoAUpbtKl86zK3+kMd6Xg1mDpm9xy94wHQYDVR0OBBYEFKW7SpfOsyt/ pDHel4NZg6ZvccveMA4GA1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNnADBkAjBe8usGzEkxn0AA bbd+NvBNEU/zy4k6LHiRUKNbwMp1JvK/kF0LgoxgKJ/GcJpo5PECMFxYDlZ2z1jD1xCMuo6u47xk dUfFVZDj/bpV6wfEU6s3qe4hsiFbYI89MvHVI5TWWA== -----END CERTIFICATE----- CommScope Public Trust ECC Root-01 ================================== -----BEGIN CERTIFICATE----- MIICHTCCAaOgAwIBAgIUQ3CCd89NXTTxyq4yLzf39H91oJ4wCgYIKoZIzj0EAwMwTjELMAkGA1UE BhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29tbVNjb3BlIFB1YmxpYyBUcnVz dCBFQ0MgUm9vdC0wMTAeFw0yMTA0MjgxNzM1NDNaFw00NjA0MjgxNzM1NDJaME4xCzAJBgNVBAYT AlVTMRIwEAYDVQQKDAlDb21tU2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3Qg RUNDIFJvb3QtMDEwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAARLNumuV16ocNfQj3Rid8NeeqrltqLx eP0CflfdkXmcbLlSiFS8LwS+uM32ENEp7LXQoMPwiXAZu1FlxUOcw5tjnSCDPgYLpkJEhRGnSjot 6dZoL0hOUysHP029uax3OVejQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G A1UdDgQWBBSOB2LAUN3GGQYARnQE9/OufXVNMDAKBggqhkjOPQQDAwNoADBlAjEAnDPfQeMjqEI2 Jpc1XHvr20v4qotzVRVcrHgpD7oh2MSg2NED3W3ROT3Ek2DS43KyAjB8xX6I01D1HiXo+k515liW pDVfG2XqYZpwI7UNo5uSUm9poIyNStDuiw7LR47QjRE= -----END CERTIFICATE----- CommScope Public Trust ECC Root-02 ================================== -----BEGIN CERTIFICATE----- MIICHDCCAaOgAwIBAgIUKP2ZYEFHpgE6yhR7H+/5aAiDXX0wCgYIKoZIzj0EAwMwTjELMAkGA1UE BhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29tbVNjb3BlIFB1YmxpYyBUcnVz dCBFQ0MgUm9vdC0wMjAeFw0yMTA0MjgxNzQ0NTRaFw00NjA0MjgxNzQ0NTNaME4xCzAJBgNVBAYT AlVTMRIwEAYDVQQKDAlDb21tU2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3Qg RUNDIFJvb3QtMDIwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAR4MIHoYx7l63FRD/cHB8o5mXxO1Q/M MDALj2aTPs+9xYa9+bG3tD60B8jzljHz7aRP+KNOjSkVWLjVb3/ubCK1sK9IRQq9qEmUv4RDsNuE SgMjGWdqb8FuvAY5N9GIIvejQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G A1UdDgQWBBTmGHX/72DehKT1RsfeSlXjMjZ59TAKBggqhkjOPQQDAwNnADBkAjAmc0l6tqvmSfR9 Uj/UQQSugEODZXW5hYA4O9Zv5JOGq4/nich/m35rChJVYaoR4HkCMHfoMXGsPHED1oQmHhS48zs7 3u1Z/GtMMH9ZzkXpc2AVmkzw5l4lIhVtwodZ0LKOag== -----END CERTIFICATE----- CommScope Public Trust RSA Root-01 ================================== -----BEGIN CERTIFICATE----- MIIFbDCCA1SgAwIBAgIUPgNJgXUWdDGOTKvVxZAplsU5EN0wDQYJKoZIhvcNAQELBQAwTjELMAkG A1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29tbVNjb3BlIFB1YmxpYyBU cnVzdCBSU0EgUm9vdC0wMTAeFw0yMTA0MjgxNjQ1NTRaFw00NjA0MjgxNjQ1NTNaME4xCzAJBgNV BAYTAlVTMRIwEAYDVQQKDAlDb21tU2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1 c3QgUlNBIFJvb3QtMDEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCwSGWjDR1C45Ft nYSkYZYSwu3D2iM0GXb26v1VWvZVAVMP8syMl0+5UMuzAURWlv2bKOx7dAvnQmtVzslhsuitQDy6 uUEKBU8bJoWPQ7VAtYXR1HHcg0Hz9kXHgKKEUJdGzqAMxGBWBB0HW0alDrJLpA6lfO741GIDuZNq ihS4cPgugkY4Iw50x2tBt9Apo52AsH53k2NC+zSDO3OjWiE260f6GBfZumbCk6SP/F2krfxQapWs vCQz0b2If4b19bJzKo98rwjyGpg/qYFlP8GMicWWMJoKz/TUyDTtnS+8jTiGU+6Xn6myY5QXjQ/c Zip8UlF1y5mO6D1cv547KI2DAg+pn3LiLCuz3GaXAEDQpFSOm117RTYm1nJD68/A6g3czhLmfTif BSeolz7pUcZsBSjBAg/pGG3svZwG1KdJ9FQFa2ww8esD1eo9anbCyxooSU1/ZOD6K9pzg4H/kQO9 lLvkuI6cMmPNn7togbGEW682v3fuHX/3SZtS7NJ3Wn2RnU3COS3kuoL4b/JOHg9O5j9ZpSPcPYeo KFgo0fEbNttPxP/hjFtyjMcmAyejOQoBqsCyMWCDIqFPEgkBEa801M/XrmLTBQe0MXXgDW1XT2mH +VepuhX2yFJtocucH+X8eKg1mp9BFM6ltM6UCBwJrVbl2rZJmkrqYxhTnCwuwwIDAQABo0IwQDAP BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUN12mmnQywsL5x6YVEFm4 5P3luG0wDQYJKoZIhvcNAQELBQADggIBAK+nz97/4L1CjU3lIpbfaOp9TSp90K09FlxD533Ahuh6 NWPxzIHIxgvoLlI1pKZJkGNRrDSsBTtXAOnTYtPZKdVUvhwQkZyybf5Z/Xn36lbQnmhUQo8mUuJM 3y+Xpi/SB5io82BdS5pYV4jvguX6r2yBS5KPQJqTRlnLX3gWsWc+QgvfKNmwrZggvkN80V4aCRck jXtdlemrwWCrWxhkgPut4AZ9HcpZuPN4KWfGVh2vtrV0KnahP/t1MJ+UXjulYPPLXAziDslg+Mkf Foom3ecnf+slpoq9uC02EJqxWE2aaE9gVOX2RhOOiKy8IUISrcZKiX2bwdgt6ZYD9KJ0DLwAHb/W NyVntHKLr4W96ioDj8z7PEQkguIBpQtZtjSNMgsSDesnwv1B10A8ckYpwIzqug/xBpMu95yo9GA+ o/E4Xo4TwbM6l4c/ksp4qRyv0LAbJh6+cOx69TOY6lz/KwsETkPdY34Op054A5U+1C0wlREQKC6/ oAI+/15Z0wUOlV9TRe9rh9VIzRamloPh37MG88EU26fsHItdkJANclHnYfkUyq+Dj7+vsQpZXdxc 1+SWrVtgHdqul7I52Qb1dgAT+GhMIbA1xNxVssnBQVocicCMb3SgazNNtQEo/a2tiRc7ppqEvOuM 6sRxJKi6KfkIsidWNTJf6jn7MZrVGczw -----END CERTIFICATE----- CommScope Public Trust RSA Root-02 ================================== -----BEGIN CERTIFICATE----- MIIFbDCCA1SgAwIBAgIUVBa/O345lXGN0aoApYYNK496BU4wDQYJKoZIhvcNAQELBQAwTjELMAkG A1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29tbVNjb3BlIFB1YmxpYyBU cnVzdCBSU0EgUm9vdC0wMjAeFw0yMTA0MjgxNzE2NDNaFw00NjA0MjgxNzE2NDJaME4xCzAJBgNV BAYTAlVTMRIwEAYDVQQKDAlDb21tU2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1 c3QgUlNBIFJvb3QtMDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDh+g77aAASyE3V rCLENQE7xVTlWXZjpX/rwcRqmL0yjReA61260WI9JSMZNRTpf4mnG2I81lDnNJUDMrG0kyI9p+Kx 7eZ7Ti6Hmw0zdQreqjXnfuU2mKKuJZ6VszKWpCtYHu8//mI0SFHRtI1CrWDaSWqVcN3SAOLMV2MC e5bdSZdbkk6V0/nLKR8YSvgBKtJjCW4k6YnS5cciTNxzhkcAqg2Ijq6FfUrpuzNPDlJwnZXjfG2W Wy09X6GDRl224yW4fKcZgBzqZUPckXk2LHR88mcGyYnJ27/aaL8j7dxrrSiDeS/sOKUNNwFnJ5rp M9kzXzehxfCrPfp4sOcsn/Y+n2Dg70jpkEUeBVF4GiwSLFworA2iI540jwXmojPOEXcT1A6kHkIf hs1w/tkuFT0du7jyU1fbzMZ0KZwYszZ1OC4PVKH4kh+Jlk+71O6d6Ts2QrUKOyrUZHk2EOH5kQMr eyBUzQ0ZGshBMjTRsJnhkB4BQDa1t/qp5Xd1pCKBXbCL5CcSD1SIxtuFdOa3wNemKfrb3vOTlycE VS8KbzfFPROvCgCpLIscgSjX74Yxqa7ybrjKaixUR9gqiC6vwQcQeKwRoi9C8DfF8rhW3Q5iLc4t Vn5V8qdE9isy9COoR+jUKgF4z2rDN6ieZdIs5fq6M8EGRPbmz6UNp2YINIos8wIDAQABo0IwQDAP BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUR9DnsSL/nSz12Vdgs7Gx cJXvYXowDQYJKoZIhvcNAQELBQADggIBAIZpsU0v6Z9PIpNojuQhmaPORVMbc0RTAIFhzTHjCLqB KCh6krm2qMhDnscTJk3C2OVVnJJdUNjCK9v+5qiXz1I6JMNlZFxHMaNlNRPDk7n3+VGXu6TwYofF 1gbTl4MgqX67tiHCpQ2EAOHyJxCDut0DgdXdaMNmEMjRdrSzbymeAPnCKfWxkxlSaRosTKCL4BWa MS/TiJVZbuXEs1DIFAhKm4sTg7GkcrI7djNB3NyqpgdvHSQSn8h2vS/ZjvQs7rfSOBAkNlEv41xd gSGn2rtO/+YHqP65DSdsu3BaVXoT6fEqSWnHX4dXTEN5bTpl6TBcQe7rd6VzEojov32u5cSoHw2O HG1QAk8mGEPej1WFsQs3BWDJVTkSBKEqz3EWnzZRSb9wO55nnPt7eck5HHisd5FUmrh1CoFSl+Nm YWvtPjgelmFV4ZFUjO2MJB+ByRCac5krFk5yAD9UG/iNuovnFNa2RU9g7Jauwy8CTl2dlklyALKr dVwPaFsdZcJfMw8eD/A7hvWwTruc9+olBdytoptLFwG+Qt81IR2tq670v64fG9PiO/yzcnMcmyiQ iRM9HcEARwmWmjgb3bHPDcK0RPOWlc4yOo80nOAXx17Org3bhzjlP1v9mxnhMUF6cKojawHhRUzN lM47ni3niAIi9G7oyOzWPPO5std3eqx7 -----END CERTIFICATE----- Telekom Security TLS ECC Root 2020 ================================== -----BEGIN CERTIFICATE----- MIICQjCCAcmgAwIBAgIQNjqWjMlcsljN0AFdxeVXADAKBggqhkjOPQQDAzBjMQswCQYDVQQGEwJE RTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0eSBHbWJIMSswKQYDVQQDDCJUZWxl a29tIFNlY3VyaXR5IFRMUyBFQ0MgUm9vdCAyMDIwMB4XDTIwMDgyNTA3NDgyMFoXDTQ1MDgyNTIz NTk1OVowYzELMAkGA1UEBhMCREUxJzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJpdHkg R21iSDErMCkGA1UEAwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgRUNDIFJvb3QgMjAyMDB2MBAGByqG SM49AgEGBSuBBAAiA2IABM6//leov9Wq9xCazbzREaK9Z0LMkOsVGJDZos0MKiXrPk/OtdKPD/M1 2kOLAoC+b1EkHQ9rK8qfwm9QMuU3ILYg/4gND21Ju9sGpIeQkpT0CdDPf8iAC8GXs7s1J8nCG6NC MEAwHQYDVR0OBBYEFONyzG6VmUex5rNhTNHLq+O6zd6fMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0P AQH/BAQDAgEGMAoGCCqGSM49BAMDA2cAMGQCMHVSi7ekEE+uShCLsoRbQuHmKjYC2qBuGT8lv9pZ Mo7k+5Dck2TOrbRBR2Diz6fLHgIwN0GMZt9Ba9aDAEH9L1r3ULRn0SyocddDypwnJJGDSA3PzfdU ga/sf+Rn27iQ7t0l -----END CERTIFICATE----- Telekom Security TLS RSA Root 2023 ================================== -----BEGIN CERTIFICATE----- MIIFszCCA5ugAwIBAgIQIZxULej27HF3+k7ow3BXlzANBgkqhkiG9w0BAQwFADBjMQswCQYDVQQG EwJERTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0eSBHbWJIMSswKQYDVQQDDCJU ZWxla29tIFNlY3VyaXR5IFRMUyBSU0EgUm9vdCAyMDIzMB4XDTIzMDMyODEyMTY0NVoXDTQ4MDMy NzIzNTk1OVowYzELMAkGA1UEBhMCREUxJzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJp dHkgR21iSDErMCkGA1UEAwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgUlNBIFJvb3QgMjAyMzCCAiIw DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAO01oYGA88tKaVvC+1GDrib94W7zgRJ9cUD/h3VC KSHtgVIs3xLBGYSJwb3FKNXVS2xE1kzbB5ZKVXrKNoIENqil/Cf2SfHVcp6R+SPWcHu79ZvB7JPP GeplfohwoHP89v+1VmLhc2o0mD6CuKyVU/QBoCcHcqMAU6DksquDOFczJZSfvkgdmOGjup5czQRx UX11eKvzWarE4GC+j4NSuHUaQTXtvPM6Y+mpFEXX5lLRbtLevOP1Czvm4MS9Q2QTps70mDdsipWo l8hHD/BeEIvnHRz+sTugBTNoBUGCwQMrAcjnj02r6LX2zWtEtefdi+zqJbQAIldNsLGyMcEWzv/9 FIS3R/qy8XDe24tsNlikfLMR0cN3f1+2JeANxdKz+bi4d9s3cXFH42AYTyS2dTd4uaNir73Jco4v zLuu2+QVUhkHM/tqty1LkCiCc/4YizWN26cEar7qwU02OxY2kTLvtkCJkUPg8qKrBC7m8kwOFjQg rIfBLX7JZkcXFBGk8/ehJImr2BrIoVyxo/eMbcgByU/J7MT8rFEz0ciD0cmfHdRHNCk+y7AO+oML KFjlKdw/fKifybYKu6boRhYPluV75Gp6SG12mAWl3G0eQh5C2hrgUve1g8Aae3g1LDj1H/1Joy7S WWO/gLCMk3PLNaaZlSJhZQNg+y+TS/qanIA7AgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAdBgNV HQ4EFgQUtqeXgj10hZv3PJ+TmpV5dVKMbUcwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBS2 p5eCPXSFm/c8n5OalXl1UoxtRzANBgkqhkiG9w0BAQwFAAOCAgEAqMxhpr51nhVQpGv7qHBFfLp+ sVr8WyP6Cnf4mHGCDG3gXkaqk/QeoMPhk9tLrbKmXauw1GLLXrtm9S3ul0A8Yute1hTWjOKWi0Fp kzXmuZlrYrShF2Y0pmtjxrlO8iLpWA1WQdH6DErwM807u20hOq6OcrXDSvvpfeWxm4bu4uB9tPcy /SKE8YXJN3nptT+/XOR0so8RYgDdGGah2XsjX/GO1WfoVNpbOms2b/mBsTNHM3dA+VKq3dSDz4V4 mZqTuXNnQkYRIer+CqkbGmVps4+uFrb2S1ayLfmlyOw7YqPta9BO1UAJpB+Y1zqlklkg5LB9zVtz aL1txKITDmcZuI1CfmwMmm6gJC3VRRvcxAIU/oVbZZfKTpBQCHpCNfnqwmbU+AGuHrS+w6jv/naa oqYfRvaE7fzbzsQCzndILIyy7MMAo+wsVRjBfhnu4S/yrYObnqsZ38aKL4x35bcF7DvB7L6Gs4a8 wPfc5+pbrrLMtTWGS9DiP7bY+A4A7l3j941Y/8+LN+ljX273CXE2whJdV/LItM3z7gLfEdxquVeE HVlNjM7IDiPCtyaaEBRx/pOyiriA8A4QntOoUAw3gi/q4Iqd4Sw5/7W0cwDk90imc6y/st53BIe0 o82bNSQ3+pCTE4FCxpgmdTdmQRCsu/WU48IxK63nI1bMNSWSs1A= -----END CERTIFICATE----- FIRMAPROFESIONAL CA ROOT-A WEB ============================== -----BEGIN CERTIFICATE----- MIICejCCAgCgAwIBAgIQMZch7a+JQn81QYehZ1ZMbTAKBggqhkjOPQQDAzBuMQswCQYDVQQGEwJF UzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UEYQwPVkFURVMtQTYyNjM0MDY4 MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFMIENBIFJPT1QtQSBXRUIwHhcNMjIwNDA2MDkwMTM2 WhcNNDcwMzMxMDkwMTM2WjBuMQswCQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25h bCBTQTEYMBYGA1UEYQwPVkFURVMtQTYyNjM0MDY4MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFM IENBIFJPT1QtQSBXRUIwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAARHU+osEaR3xyrq89Zfe9MEkVz6 iMYiuYMQYneEMy3pA4jU4DP37XcsSmDq5G+tbbT4TIqk5B/K6k84Si6CcyvHZpsKjECcfIr28jlg st7L7Ljkb+qbXbdTkBgyVcUgt5SjYzBhMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUk+FD Y1w8ndYn81LsF7Kpryz3dvgwHQYDVR0OBBYEFJPhQ2NcPJ3WJ/NS7Beyqa8s93b4MA4GA1UdDwEB /wQEAwIBBjAKBggqhkjOPQQDAwNoADBlAjAdfKR7w4l1M+E7qUW/Runpod3JIha3RxEL2Jq68cgL cFBTApFwhVmpHqTm6iMxoAACMQD94vizrxa5HnPEluPBMBnYfubDl94cT7iJLzPrSA8Z94dGXSaQ pYXFuXqUPoeovQA= -----END CERTIFICATE----- wp-cli/wp-cli 2.12.0 2025-05-07T01:19:40+00:00 composer/ca-bundle 1.4.7 9b8b487385d1a5140ad6765b9e9131fc3de3b891 composer/composer 2.2.25 0374e6fa9d20beeffa0765c890ace6b33cbb33bd composer/metadata-minifier 1.0.0 c549d23829536f0d0e984aaabbf02af91f443207 composer/pcre 1.0.1 67a32d7d6f9f560b726ab25a061b38ff3a80c560 composer/semver 3.4.3 4313d26ada5e0c4edfbd1dc481a92ff7bff91f12 composer/spdx-licenses 1.5.8 560bdcf8deb88ae5d611c80a2de8ea9d0358cc0a composer/xdebug-handler 2.0.5 9e36aeed4616366d2b690bdce11f71e9178c579a eftec/bladeone 3.52 a19bf66917de0b29836983db87a455a4f6e32148 gettext/gettext v4.8.12 11af89ee6c087db3cf09ce2111a150bca5c46e12 gettext/languages 2.12.1 0b0b0851c55168e1dfb14305735c64019732b5f1 justinrainbow/json-schema v5.2.13 fbbe7e5d79f618997bc3332a6f49246036c45793 mck89/peast v1.17.0 3a752d39bd7d8dc1e19bcf424f3d5ac1a1ca6ad5 nb/oxymel v0.1.0 cbe626ef55d5c4cc9b5e6e3904b395861ea76e3c psr/log 1.1.4 d49695b909c3b7628b6289db5479a1c204601f11 react/promise v2.11.0 1a8460931ea36dc5c76838fec5734d55c88c6831 seld/jsonlint 1.11.0 1748aaf847fc731cfad7725aec413ee46f0cc3a2 seld/phar-utils 1.2.1 ea2f4014f163c1be4c601b9b7bd6af81ba8d701c symfony/console v3.4.47 a10b1da6fc93080c180bba7219b5ff5b7518fe81 symfony/debug v3.4.47 ab42889de57fdfcfcc0759ab102e2fd4ea72dcae symfony/filesystem v3.4.47 e58d7841cddfed6e846829040dca2cca0ebbbbb3 symfony/finder v3.4.47 b6b6ad3db3edb1b4b1c1896b1975fb684994de6e symfony/polyfill-ctype v1.19.0 aed596913b70fae57be53d86faa2e9ef85a2297b symfony/polyfill-mbstring v1.19.0 b5f7b932ee6fa802fc792eabd77c4c88084517ce wp-cli/cache-command v2.2.0 14f76b0bc8f9fa0a680e9c70e18fcf627774d055 wp-cli/checksum-command v2.3.1 39992dbd66835f8d5c2cc5bfeacf9d2c450cbafe wp-cli/config-command v2.3.8 994b3dc9e8284fc978366920d5c5ae0dde3a004e wp-cli/core-command v2.1.20 83e4692784a815bb7f5df10b72204f237b5224b9 wp-cli/cron-command v2.3.2 6f450028a75ebd275f12cad62959a0709bf3e7c1 wp-cli/db-command v2.1.3 f857c91454d7092fa672bc388512a51752d9264a wp-cli/embed-command v2.0.18 52f59a1dacf1d4a1c68fd685f27909e1f493816b wp-cli/entity-command v2.8.4 213611f8ab619ca137d983e9b987f7fbf1ac21d4 wp-cli/eval-command v2.2.6 20ec428a7b9bc604fab0bd33ee8fa20662650455 wp-cli/export-command v2.1.14 2af32bf12c1bccd6561a215dbbafc2f272647ee8 wp-cli/extension-command v2.1.24 d21a2f504ac43a86b6b08697669b5b0844748133 wp-cli/i18n-command v2.6.5 5e73d417398993625331a9f69f6c2ef60f234070 wp-cli/import-command v2.0.14 b2c48f3e51683e825738df62bf8ccc7004c5f0f9 wp-cli/language-command v2.0.23 7221cc39d2b14fd39e55aa7884889f26eec2f822 wp-cli/maintenance-mode-command v2.1.3 b947e094e00b7b68c6376ec9bd03303515864062 wp-cli/media-command v2.2.2 a810ea0e68473fce6a234e67c6c5f19bb820a753 wp-cli/mustache v2.14.99 ca23b97ac35fbe01c160549eb634396183d04a59 wp-cli/mustangostang-spyc 0.6.3 6aa0b4da69ce9e9a2c8402dab8d43cf32c581cc7 wp-cli/package-command v2.6.0 682d8c6bb30c782c3b09c015478c7cbe1cc727a9 wp-cli/php-cli-tools v0.12.5 34b83b4f700df8a4ec3fd17bf7e7e7d8ca5f28da wp-cli/process v5.9.99 f0aec5ca26a702d3157e3a19982b662521ac2b81 wp-cli/rewrite-command v2.0.15 277ec689b7c268680ff429f52558508622c9b34c wp-cli/role-command v2.0.16 ed57fb5436b4d47954b07e56c734d19deb4fc491 wp-cli/scaffold-command v2.5.0 b4238ea12e768b3f15d10339a53a8642f82e1d2b wp-cli/search-replace-command v2.1.8 65397a7bfdd5ba2cff26f3ab03ef0bcb916c0057 wp-cli/server-command v2.0.15 80a9243f94e0ac073f9bfdb516d2ac7e1fa01a71 wp-cli/shell-command v2.0.16 3af53a9f4b240e03e77e815b2ee10f229f1aa591 wp-cli/super-admin-command v2.0.16 54ac063c384743ee414806d42cb8c61c6aa1fa8e wp-cli/widget-command v2.1.12 73084053f7b32d92583e44d870b81f287beea6a9 wp-cli/wp-cli v2.12.0 03d30d4138d12b4bffd8b507b82e56e129e0523f wp-cli/wp-config-transformer v1.4.2 b78cab1159b43eb5ee097e2cfafe5eab573d2a8a2.12.0fE¸®~Ÿ‚M¥úð¤¿íÜM$��GBMBPK�� DM\ï@Õñ��ñ��wp-cli-wrappednu�È¯Ýí��#!/bin/bash ####################################### # WP_CLI_VERSION=v2.12.0 # Timed-out wrapper around wp-cli # Arguments: # $1 - Path to PHP binary, full filesystem path # $2 - Path to Wordpress installation, full filesystem path # All the rest arguments ($@) are treated as WP-CLI command # Outputs: # Writes result to stdout ####################################### PATH_TO_PHP="$1" PATH_TO_WP="$2" shift 2; CODE=0 # WPOS wp-cli WP_CLI="/opt/clwpos/wp-cli" # Defaults for PHP PHP_EXTRA_OPTIONS="-d memory_limit=-1 -d open_basedir=none" PHP_DEFAULT_EXTENSIONS="phar" # pick other extensions based on PHP version PHP_VERSION_PARTS=($($PATH_TO_PHP -v | head -n1 | sed -n -e 's/^.* $[0-9]\+\.[0-9]\+\.[0-9]\+$.*/\1/p' | tr '.' ' ')) PHP_VERSION_ID=$((PHP_VERSION_PARTS[0] * 10000 + PHP_VERSION_PARTS[1] * 100 + PHP_VERSION_PARTS[2])) # PHP 8.0 and above have json extension enabled by default if (( PHP_VERSION_ID < 80000 )); then PHP_DEFAULT_EXTENSIONS+=" json" fi # for PHP 8.2 and above mysqlnd must be loaded before mysqli if (( PHP_VERSION_ID >= 80200 )); then PHP_DEFAULT_EXTENSIONS+=" mysqlnd" fi PHP_DEFAULT_EXTENSIONS+=" mysqli" # explicitly drop PHP disable_functions directive in order to avoid errors like # 'Error: Cannot do 'launch': The PHP functions `proc_open()` and/or `proc_close()` are disabled' # during plugin manipulations PHP_DEFAULT_FUNCTIONS="-d disable_functions= -d display_errors=0 -d error_log=/dev/null" # PHP functions for retry with enhanced error reporting PHP_DEBUG_FUNCTIONS="-d disable_functions= -d display_errors=1 -d error_log=/dev/null" # Defaults for WP-CLI WP_CLI_DEFAULT_OPTS=("--skip-themes") # Must be first [0] # Passed via ENVVAR if [ -n "${SKIP_PLUGINS_LOADING}" ]; then WP_CLI_DEFAULT_OPTS+=("--skip-plugins") fi # Find wp-config.php WP_CONFIG_PATH="${PATH_TO_WP}/wp-config.php" if [ ! -e "${WP_CONFIG_PATH}" ]; then # It's ok for wp-config.php to be in a subdirectory PARENT_PATH=$(dirname "${PATH_TO_WP}") WP_CONFIG_PATH="${PARENT_PATH}/wp-config.php" fi # Define constants WP_CLI_DEFAULT_OPTS+=("--exec=define('WP_DEBUG', true);") WP_CLI_DEFAULT_OPTS+=("--exec=define('WP_DEBUG_DISPLAY', false);") WP_CLI_DEFAULT_OPTS+=("--exec=define('DISABLE_WP_CRON', true);") # Default timeout, formatted as for timeout command (GNU coreutils) # 2 minutes (120 seconds) TIMEOUT="2m" # Construct PHP extensions to include EXTS="" for ext in $PHP_DEFAULT_EXTENSIONS do if ! $PATH_TO_PHP -m | grep -i "$ext" 1>/dev/null; then EXTS+=" -d extension=$ext.so" fi done # change current working directory # we need this because if php code has relative imports # it looks for scripts inside current directory first # e.g. some providers add require('wp-salt.php') to config # https://stackoverflow.com/questions/75823716/ # the overall approach of relative import is not correct, # but we still need patch for this cd "${PATH_TO_WP}" if [[ "$1" == "help" ]]; then exec timeout $TIMEOUT \ $PATH_TO_PHP $EXTS $PHP_EXTRA_OPTIONS $PHP_DEFAULT_FUNCTIONS \ $WP_CLI --path=$PATH_TO_WP "${WP_CLI_DEFAULT_OPTS[@]}" "$@" | cat else WP_CLI_RESULT=$(exec timeout $TIMEOUT \ $PATH_TO_PHP $EXTS $PHP_EXTRA_OPTIONS $PHP_DEFAULT_FUNCTIONS \ $WP_CLI --path=$PATH_TO_WP "${WP_CLI_DEFAULT_OPTS[@]}" "$@") WP_CLI_CODE=$? # Not 0 and not 1 because WP-CLI has commands that return status as the result of the command execution # For example plugin is-active, exit status 0 if active, otherwise 1 # Calling an error at the php level will return 255 # Let's try to run the command without --skip-themes if [ "$WP_CLI_CODE" -ne 0 ] && [ "$WP_CLI_CODE" -ne 1 ]; then echo "Retry without --skip-themes and with enhanced error reporting" >&2 unset WP_CLI_DEFAULT_OPTS[0] WP_CLI_RESULT=$(exec timeout $TIMEOUT \ $PATH_TO_PHP $EXTS $PHP_EXTRA_OPTIONS $PHP_DEBUG_FUNCTIONS \ $WP_CLI --path=$PATH_TO_WP "${WP_CLI_DEFAULT_OPTS[@]}" "$@") WP_CLI_CODE=$? fi printf '%s' "$WP_CLI_RESULT" CODE=$WP_CLI_CODE fi exit $CODE PK�� DM\3Ù $��$��agreements/meta.jsonnu�„[µü¤��{ "cdn_updated_at": "2023-03-31" }PK�� DM\Ø›@Õ!��!��agreements/cdnnu�„[µü¤��Referred hereinafter as CloudLinux, 'our', 'we' and 'us'; is a content delivery network service provider. Anyone using our services are subject to the terms and conditions described in this document as well as the Acceptable Use Policy described in this document. We reserve the right to make alterations to this document whenever desired. It is the user's sole responsibility to check for updates on a regular basis.<br> <br> <h3>Privacy & Data Policy</h3> CloudLinux is committed to complete transparency in how we handle your data. We have prepared a complete and detailed, but easy to understand privacy and data policy. By using our service, you agree that you have read and accept the terms outlined in the policy. â€œOur serviceâ€ includes all services provided by us, or our licensors, to you, or your end user.<br> <h3>Pricing</h3> All payments are paid in advance and non-refundable. All prices stated by us are subject to change and may be changed from time to time at our sole discretion.<br> <h3>Account Termination</h3> You agree that we may, under certain circumstances, and without prior notice terminate your account and restrict access to our service. Causes for this include, but are not limited to: violations of the Terms of Service and Acceptable Use Policy, requests by law enforcement or other government agencies and/or having provided false information as part of your account, or as desired by our licensors. All terminations will be made in CloudLinuxâ€™s sole discretion and we will not be liable for any disruption or damage to you or your service that such a termination might cause. Once your account has been terminated we reserve the right to delete all the data associated with it without the option to restore it.<br> <h3>Content Hosting</h3> In order for us to distribute your content on our network, it is necessary for our servers to make and store copies of your files. By using our service you acknowledge that these copies are being made and give us permission to maintain them and distribute them to users on the internet. This does not give us any ownership of your content, you still retain all ownership and any intellectual property rights.<br> <h3>Service Level Agreement</h3> CloudLinux will use reasonable efforts to keep your service running 24 hours a day, 7 days a week as long as you abide by our Terms Of Service. We are aiming for at least a 99.995% monthly uptime for our content delivery service, however sometimes, for a number of reasons, it may be unavailable to you. You recognize and acknowledge that occasional unavailability of the services will occur. We make no warranty or assurance that the service will be running uninterrupted. We do not guarantee to provide support outside of normal business hours unless specifically stated by us.<br> <h3>Liability of Those Starting Services</h3> To the extent that a hosting company or other entity/person (â€œThird-Partyâ€) starts the service on behalf of an end user, such Third-Party (including, at all times, the entity that such Third-Party which an individual starting the service is engaged by) (a) agrees to be liable for the use of the service by all end users, and (b) shall require the end user to review and agree to the terms of this Terms of Service. We, and our licensors, shall be third-party beneficiaries of such agreement between the Third-Party and its end users with respect to such end user agreeing to these Terms of Service.<br> <h3>Limitation of liability</h3> To the extent allowed by applicable law, in no event, shall CloudLinux, its licensors, and their affiliates, directors, officers, members, shareholders, contractors or employees (collectively, â€œAffiliatesâ€) be liable for any damages whatsoever, including, without limitation, any loss of profits, loss of business, loss of use or data, interruption of business, or for direct, indirect, special, incidental or consequential damages of any kind.<br> <br> <strong>To the extent allowed by applicable law, in no event shall CloudLinux, its licensors, or their respective Affiliates be liable for the following:</strong><br> <ul> <li>Errors, mistakes, or inaccuracies of content</li> <li>Any unauthorized access to our secure servers and/or any personal information stored therein</li> <li>Any interruption of the service</li> <li>Failure of the products to perform</li> </ul> <h3>DMCA</h3> We respect artist and content owner rights and are not a platform for distributing copyrighted content. You must do the same. In accordance with the Digital Millennium Copyright Act (DMCA), we have adopted a policy to terminate the accounts of customers found to be repeatedly violating of copyright without the right to a refund.<br> <br> <strong>For your complaint to be valid under the DMCA, you must provide the following information in writing:</strong><br> <ul> <li>An electronic or physical signature of a person authorized to act on behalf of the copyright owner</li> <li>Identification of the copyrighted work that you claim has been infringed</li> <li>Identification of the material that is claimed to be infringing and where it is located on the Service</li> <li>Information reasonably sufficient to permit CloudLinux to contact you, such as your address, telephone number, and, email address</li> <li>A statement that you have a good faith belief that use of the material in the manner complained of is not authorized by the copyright owner, its agent, or law</li> <li>A statement, made under penalty of perjury, that the above information is accurate, and that you are the copyright owner or are authorized to act on behalf of the owner</li> </ul> <strong>The above information must be submitted to the following DMCA Agent:</strong><br> Attn: DMCA Notice<br> CloudLinux Inc.<br> Address: 2318 Louis Rd, Suite B Palo Alto, CA 94303-3635 USA<br> Email: DMCA@CloudLinux.com PK�� DM\*ïyýl�yýl��wp-clinu�È¯Ýí��PK�� DM\ï@Õñ��ñ��¯ýl�wp-cli-wrappednu�È¯Ýí��PK�� DM\3Ù $��$��Þ m�agreements/meta.jsonnu�„[µü¤��PK�� DM\Ø›@Õ!��!��Fm�agreements/cdnnu�„[µü¤��PK��6��¥%m��

(.+?)

' => '`', '

$args Provided table names, or tables with wildcards. * @param array $assoc_args Optional flags for groups of tables (e.g. --network) * @return array */ function wp_get_table_names( $args, $assoc_args = [] ) { global $wpdb; // Abort if incompatible args supplied. if ( get_flag_value( $assoc_args, 'base-tables-only' ) && get_flag_value( $assoc_args, 'views-only' ) ) { WP_CLI::error( 'You cannot supply --base-tables-only and --views-only at the same time.' ); } // Pre-load tables SQL query with Views restriction if needed. if ( get_flag_value( $assoc_args, 'base-tables-only' ) ) { $tables_sql = 'SHOW FULL TABLES WHERE Table_Type = "BASE TABLE"'; } elseif ( get_flag_value( $assoc_args, 'views-only' ) ) { $tables_sql = 'SHOW FULL TABLES WHERE Table_Type = "VIEW"'; } if ( get_flag_value( $assoc_args, 'all-tables' ) ) { if ( empty( $tables_sql ) ) { $tables_sql = 'SHOW TABLES'; } // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- Query is safe, see above. $tables = $wpdb->get_col( $tables_sql, 0 ); } elseif ( get_flag_value( $assoc_args, 'all-tables-with-prefix' ) ) { if ( empty( $tables_sql ) ) { $tables_sql = $wpdb->prepare( 'SHOW TABLES LIKE %s', esc_like( $wpdb->get_blog_prefix() ) . '%' ); } else { $tables_sql .= sprintf( " AND %s LIKE '%s'", esc_sql_ident( 'Tables_in_' . $wpdb->dbname ), esc_like( $wpdb->get_blog_prefix() ) . '%' ); } // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- Query is prepared, see above. $tables = $wpdb->get_col( $tables_sql, 0 ); } else { $scope = get_flag_value( $assoc_args, 'scope', 'all' ); // Note: BC change 1.5.0, taking scope into consideration for network also. if ( get_flag_value( $assoc_args, 'network' ) && is_multisite() ) { $network_global_scope = in_array( $scope, [ 'all', 'global', 'ms_global' ], true ) ? ( 'all' === $scope ? 'global' : $scope ) : ''; $wp_tables = array_values( $wpdb->tables( $network_global_scope ) ); if ( in_array( $scope, [ 'all', 'blog' ], true ) ) { // Do directly for compat with old WP versions. Note: private, deleted, archived sites are not excluded. $blog_ids = $wpdb->get_col( "SELECT blog_id FROM $wpdb->blogs WHERE site_id = $wpdb->siteid" ); foreach ( $blog_ids as $blog_id ) { $wp_tables = array_merge( $wp_tables, array_values( $wpdb->tables( 'blog', true /*prefix*/, $blog_id ) ) ); } } } else { $wp_tables = array_values( $wpdb->tables( $scope ) ); } // The global_terms_enabled() function has been deprecated with WP 6.1+. if ( wp_version_compare( '6.1', '>=' ) || ! global_terms_enabled() ) { // phpcs:ignore WordPress.WP.DeprecatedFunctions.global_terms_enabledFound // Only include sitecategories when it's actually enabled. $wp_tables = array_values( array_diff( $wp_tables, [ $wpdb->sitecategories ] ) ); } // Note: BC change 1.5.0, tables are sorted (via TABLES view). // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- uses esc_sql_ident() and $wpdb->_escape(). $tables = $wpdb->get_col( sprintf( "SHOW TABLES WHERE %s IN ('%s')", esc_sql_ident( 'Tables_in_' . $wpdb->dbname ), implode( "', '", $wpdb->_escape( $wp_tables ) ) ) ); if ( get_flag_value( $assoc_args, 'base-tables-only' ) || get_flag_value( $assoc_args, 'views-only' ) ) { // Apply Views restriction args if needed. // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- Query is prepared, see above. $views_query_tables = $wpdb->get_col( $tables_sql, 0 ); $tables = array_intersect( $tables, $views_query_tables ); } } // Filter by `$args`. if ( $args ) { $args_tables = []; foreach ( $args as $arg ) { if ( false !== strpos( $arg, '*' ) || false !== strpos( $arg, '?' ) ) { $args_tables = array_merge( $args_tables, array_filter( $tables, function ( $v ) use ( $arg ) { return fnmatch( $arg, $v ); } ) ); } else { $args_tables[] = $arg; } } $args_tables = array_values( array_unique( $args_tables ) ); $tables = array_values( array_intersect( $tables, $args_tables ) ); if ( empty( $tables ) ) { WP_CLI::error( sprintf( "Couldn't find any tables matching: %s", implode( ' ', $args ) ) ); } } return $tables; } /** * Failsafe use of the WordPress wp_strip_all_tags() function. * * Automatically falls back to strip_tags() function if the WP function is not * available. * * @param string $string String to strip the tags from. * @return string String devoid of tags. */ function strip_tags( $string ) { if ( function_exists( 'wp_strip_all_tags' ) ) { return \wp_strip_all_tags( $string ); } $string = preg_replace( '@<(script|style)[^>]*?>.*?@si', '', $string ); // phpcs:ignore WordPress.WP.AlternativeFunctions.strip_tags_strip_tags -- Fallback. $string = \strip_tags( $string ); return trim( $string ); } #.*?$)|(?>//.*?$)|(?>/\*.*?\*/)|(?>\'(?:(?=(\\\\?))\1.)*?\')|(?>"(?:(?=(\\\\?))\2.)*?")|(?\b__FILE__\b)|(?\b__DIR__\b)%ms'; /** * Check if a certain path is within a Phar archive. * * If no path is provided, the function checks whether the current WP_CLI instance is * running from within a Phar archive. * * @param string|null $path Optional. Path to check. Defaults to null, which checks WP_CLI_ROOT. * @return bool Whether path is within a Phar archive. */ function inside_phar( $path = null ) { if ( null === $path ) { if ( ! defined( 'WP_CLI_ROOT' ) ) { return false; } $path = WP_CLI_ROOT; } return 0 === strpos( $path, PHAR_STREAM_PREFIX ); } /** * Extract a file from a Phar archive. * * Files that need to be read by external programs have to be extracted from the Phar archive. * If the file is not within a Phar archive, the function returns the path unchanged. * * @param string $path Path to the file to extract. * @return string Path to the extracted file. */ function extract_from_phar( $path ) { if ( ! inside_phar( $path ) ) { return $path; } $fname = basename( $path ); $tmp_path = get_temp_dir() . uniqid( 'wp-cli-extract-from-phar-', true ) . "-$fname"; copy( $path, $tmp_path ); register_shutdown_function( function () use ( $tmp_path ) { if ( file_exists( $tmp_path ) ) { unlink( $tmp_path ); } } ); return $tmp_path; } /** * Load dependencies. * * @return void|never */ function load_dependencies() { if ( inside_phar() ) { if ( file_exists( WP_CLI_ROOT . '/vendor/autoload.php' ) ) { require WP_CLI_ROOT . '/vendor/autoload.php'; } elseif ( file_exists( dirname( dirname( WP_CLI_ROOT ) ) . '/autoload.php' ) ) { require dirname( dirname( WP_CLI_ROOT ) ) . '/autoload.php'; } return; } $has_autoload = false; foreach ( get_vendor_paths() as $vendor_path ) { if ( file_exists( $vendor_path . '/autoload.php' ) ) { require $vendor_path . '/autoload.php'; $has_autoload = true; break; } } if ( ! $has_autoload ) { fwrite( STDERR, "Internal error: Can't find Composer autoloader.\nTry running: composer install\n" ); exit( 3 ); } } /** * Return vendor paths. * * @return array List of paths. */ function get_vendor_paths() { $vendor_paths = [ WP_CLI_ROOT . '/../../../vendor', // Part of a larger project / installed via Composer (preferred). WP_CLI_ROOT . '/vendor', // Top-level project / installed as Git clone. ]; $maybe_composer_json = WP_CLI_ROOT . '/../../../composer.json'; if ( file_exists( $maybe_composer_json ) && is_readable( $maybe_composer_json ) ) { $composer = json_decode( file_get_contents( $maybe_composer_json ) ); if ( ! empty( $composer->config ) && ! empty( $composer->config->{'vendor-dir'} ) ) { array_unshift( $vendor_paths, WP_CLI_ROOT . '/../../../' . $composer->config->{'vendor-dir'} ); } } return $vendor_paths; } /** * Load a file. * * Using require() directly inside a class grants access * to private methods to the loaded code, hence this wrapper helper. * * @param string $path * @return void */ function load_file( $path ) { require_once $path; } /** * Load a command. * * @param string $name * @return void */ function load_command( $name ) { $path = WP_CLI_ROOT . "/php/commands/$name.php"; if ( is_readable( $path ) ) { include_once $path; } } /** * Like array_map(), except it returns a new iterator, instead of a modified array. * * Example: * * $arr = array('Football', 'Socker'); * * $it = iterator_map($arr, 'strtolower', function($val) { * return str_replace('foo', 'bar', $val); * }); * * foreach ( $it as $val ) { * var_dump($val); * } * * @param array|object $it Either a plain array or another iterator. * @param callable $fn The function to apply to an element. * @return object An iterator that applies the given callback(s). */ function iterator_map( $it, $fn ) { if ( is_array( $it ) ) { $it = new ArrayIterator( $it ); } if ( ! method_exists( $it, 'add_transform' ) ) { $it = new Transform( $it ); } foreach ( array_slice( func_get_args(), 1 ) as $fn ) { $it->add_transform( $fn ); } return $it; } /** * Search for file by walking up the directory tree until the first file is found or until $stop_check($dir) returns true. * * @param string|array $files The files (or file) to search for. * @param string|null $dir The directory to start searching from; defaults to CWD. * @param callable $stop_check Function which is passed the current dir each time a directory level is traversed. * @return null|string Null if the file was not found. */ function find_file_upward( $files, $dir = null, $stop_check = null ) { $files = (array) $files; if ( is_null( $dir ) ) { $dir = getcwd(); } while ( is_readable( $dir ) ) { // Stop walking up when the supplied callable returns true being passed the $dir if ( is_callable( $stop_check ) && call_user_func( $stop_check, $dir ) ) { return null; } foreach ( $files as $file ) { $path = $dir . DIRECTORY_SEPARATOR . $file; if ( file_exists( $path ) ) { return $path; } } $parent_dir = dirname( $dir ); if ( empty( $parent_dir ) || $parent_dir === $dir ) { break; } $dir = $parent_dir; } return null; } /** * Determine whether a path is absolute. * @param string $path * @return bool */ function is_path_absolute( $path ) { // Windows. if ( isset( $path[1] ) && ':' === $path[1] ) { return true; } return isset( $path[0] ) && '/' === $path[0]; } /** * Composes positional arguments into a command string. * * @param array $args Positional arguments to compose. * @return string */ function args_to_str( $args ) { return ' ' . implode( ' ', array_map( 'escapeshellarg', $args ) ); } /** * Composes associative arguments into a command string. * * @param array $assoc_args Associative arguments to compose. * @return string */ function assoc_args_to_str( $assoc_args ) { $str = ''; foreach ( $assoc_args as $key => $value ) { if ( true === $value ) { $str .= " --$key"; } elseif ( is_array( $value ) ) { foreach ( $value as $v ) { $str .= assoc_args_to_str( [ $key => $v, ] ); } } else { $str .= " --$key=" . escapeshellarg( $value ); } } return $str; } /** * Given a template string and an arbitrary number of arguments, * returns the final command, with the parameters escaped. * * @param array $cmd */ function esc_cmd( $cmd ) { if ( func_num_args() < 2 ) { trigger_error( 'esc_cmd() requires at least two arguments.', E_USER_WARNING ); } $args = func_get_args(); $cmd = array_shift( $args ); return vsprintf( $cmd, array_map( 'escapeshellarg', $args ) ); } /** * Gets path to WordPress configuration. * * @return string */ function locate_wp_config() { static $path; if ( null === $path ) { $path = false; if ( getenv( 'WP_CONFIG_PATH' ) && file_exists( getenv( 'WP_CONFIG_PATH' ) ) ) { $path = getenv( 'WP_CONFIG_PATH' ); } elseif ( file_exists( ABSPATH . 'wp-config.php' ) ) { $path = ABSPATH . 'wp-config.php'; } elseif ( file_exists( dirname( ABSPATH ) . '/wp-config.php' ) && ! file_exists( dirname( ABSPATH ) . '/wp-settings.php' ) ) { $path = dirname( ABSPATH ) . '/wp-config.php'; } if ( $path ) { $path = realpath( $path ); } } return $path; } /** * Compare a WordPress version. * * @param string $since * @param string $operator * @return bool */ function wp_version_compare( $since, $operator ) { $wp_version = str_replace( '-src', '', $GLOBALS['wp_version'] ); $since = str_replace( '-src', '', $since ); return version_compare( $wp_version, $since, $operator ); } /** * Render a collection of items as an ASCII table, JSON, CSV, YAML, list of ids, or count. * * Given a collection of items with a consistent data structure: * * ``` * $items = array( * array( * 'key' => 'foo', * 'value' => 'bar', * ) * ); * ``` * * Render `$items` as an ASCII table: * * ``` * WP_CLI\Utils\format_items( 'table', $items, array( 'key', 'value' ) ); * * # +-----+-------+ * # | key | value | * # +-----+-------+ * # | foo | bar | * # +-----+-------+ * ``` * * Or render `$items` as YAML: * * ``` * WP_CLI\Utils\format_items( 'yaml', $items, array( 'key', 'value' ) ); * * # --- * # - * # key: foo * # value: bar * ``` * * @access public * @category Output * * @param string $format Format to use: 'table', 'json', 'csv', 'yaml', 'ids', 'count'. * @param array $items An array of items to output. * @param array|string $fields Named fields for each item of data. Can be array or comma-separated list. */ function format_items( $format, $items, $fields ) { $assoc_args = [ 'format' => $format, 'fields' => $fields, ]; $formatter = new Formatter( $assoc_args ); $formatter->display_items( $items ); } /** * Write data as CSV to a given file. * * @access public * * @param resource $fd File descriptor. * @param array $rows Array of rows to output. * @param array $headers List of CSV columns (optional). */ function write_csv( $fd, $rows, $headers = [] ) { if ( ! empty( $headers ) ) { $headers = array_map( __NAMESPACE__ . '\escape_csv_value', $headers ); fputcsv( $fd, $headers, ',', '"', '\\' ); } foreach ( $rows as $row ) { if ( ! empty( $headers ) ) { $row = pick_fields( $row, $headers ); } $row = array_map( __NAMESPACE__ . '\escape_csv_value', $row ); fputcsv( $fd, array_values( $row ), ',', '"', '\\' ); } } /** * Pick fields from an associative array or object. * * @param array|object $item Associative array or object to pick fields from. * @param array $fields List of fields to pick. * @return array */ function pick_fields( $item, $fields ) { $values = []; if ( is_object( $item ) ) { foreach ( $fields as $field ) { $values[ $field ] = isset( $item->$field ) ? $item->$field : null; } } else { foreach ( $fields as $field ) { $values[ $field ] = isset( $item[ $field ] ) ? $item[ $field ] : null; } } return $values; } /** * Launch system's $EDITOR for the user to edit some text. * * @access public * @category Input * * @param string $input Some form of text to edit (e.g. post content). * @param string $title Title to display in the editor. * @param string $ext Extension to use with the temp file. * @return string|bool Edited text, if file is saved from editor; false, if no change to file. */ function launch_editor_for_input( $input, $title = 'WP-CLI', $ext = 'tmp' ) { check_proc_available( 'launch_editor_for_input' ); $tmpdir = get_temp_dir(); do { $tmpfile = basename( $title ); $tmpfile = preg_replace( '|\.[^.]*$|', '', $tmpfile ); $tmpfile .= '-' . substr( md5( (string) mt_rand() ), 0, 6 ); // phpcs:ignore WordPress.WP.AlternativeFunctions.rand_mt_rand -- no crypto and WP not loaded. $tmpfile = $tmpdir . $tmpfile . '.' . $ext; $fp = fopen( $tmpfile, 'xb' ); if ( ! $fp && is_writable( $tmpdir ) && file_exists( $tmpfile ) ) { $tmpfile = ''; continue; } if ( $fp ) { fclose( $fp ); } } while ( ! $tmpfile ); if ( ! $tmpfile ) { WP_CLI::error( 'Error creating temporary file.' ); } file_put_contents( $tmpfile, $input ); $editor = getenv( 'EDITOR' ); if ( ! $editor ) { $editor = is_windows() ? 'notepad' : 'vi'; } $descriptorspec = [ STDIN, STDOUT, STDERR ]; $process = proc_open_compat( "$editor " . escapeshellarg( $tmpfile ), $descriptorspec, $pipes ); $r = proc_close( $process ); if ( $r ) { exit( $r ); } $output = file_get_contents( $tmpfile ); unlink( $tmpfile ); if ( $output === $input ) { return false; } return $output; } /** * @param string $raw_host MySQL host string, as defined in wp-config.php. * * @return array */ function mysql_host_to_cli_args( $raw_host ) { $assoc_args = []; /** * If the host string begins with 'p:' for a persistent db connection, * replace 'p:' with nothing. */ if ( substr( $raw_host, 0, 2 ) === 'p:' ) { $raw_host = substr_replace( $raw_host, '', 0, 2 ); } $host_parts = explode( ':', $raw_host ); if ( count( $host_parts ) === 2 ) { list( $assoc_args['host'], $extra ) = $host_parts; $extra = trim( $extra ); if ( is_numeric( $extra ) ) { $assoc_args['port'] = (int) $extra; $assoc_args['protocol'] = 'tcp'; } elseif ( '' !== $extra ) { $assoc_args['socket'] = $extra; } } else { $assoc_args['host'] = $raw_host; } return $assoc_args; } /** * Run a MySQL command and optionally return the output. * * @since v2.5.0 Deprecated $descriptors argument. * * @param string $cmd Command to run. * @param array $assoc_args Associative array of arguments to use. * @param mixed $_ Deprecated. Former $descriptors argument. * @param bool $send_to_shell Optional. Whether to send STDOUT and STDERR * immediately to the shell. Defaults to true. * @param bool $interactive Optional. Whether MySQL is meant to be * executed as an interactive process. Defaults * to false. * * @return array { * Associative array containing STDOUT and STDERR output. * * @type string $stdout Output that was sent to STDOUT. * @type string $stderr Output that was sent to STDERR. * @type int $exit_code Exit code of the process. * } */ function run_mysql_command( $cmd, $assoc_args, $_ = null, $send_to_shell = true, $interactive = false ) { check_proc_available( 'run_mysql_command' ); $descriptors = ( $interactive || $send_to_shell ) ? [ 0 => STDIN, 1 => STDOUT, 2 => STDERR, ] : [ 0 => STDIN, 1 => [ 'pipe', 'w' ], 2 => [ 'pipe', 'w' ], ]; $stdout = ''; $stderr = ''; $pipes = []; if ( isset( $assoc_args['host'] ) ) { // phpcs:ignore WordPress.DB.RestrictedFunctions.mysql_mysql_host_to_cli_args -- Misidentified as PHP native MySQL function. $assoc_args = array_merge( $assoc_args, mysql_host_to_cli_args( $assoc_args['host'] ) ); } if ( isset( $assoc_args['pass'] ) ) { $old_password = getenv( 'MYSQL_PWD' ); putenv( 'MYSQL_PWD=' . $assoc_args['pass'] ); unset( $assoc_args['pass'] ); } $final_cmd = force_env_on_nix_systems( $cmd ) . assoc_args_to_str( $assoc_args ); WP_CLI::debug( 'Final MySQL command: ' . $final_cmd, 'db' ); $process = proc_open_compat( $final_cmd, $descriptors, $pipes ); if ( isset( $old_password ) ) { putenv( 'MYSQL_PWD=' . $old_password ); } if ( ! $process ) { WP_CLI::debug( 'Failed to create a valid process using proc_open_compat()', 'db' ); exit( 1 ); } if ( is_resource( $process ) && ! $send_to_shell && ! $interactive ) { $stdout = stream_get_contents( $pipes[1] ); $stderr = stream_get_contents( $pipes[2] ); fclose( $pipes[1] ); fclose( $pipes[2] ); } $exit_code = proc_close( $process ); if ( $exit_code && ( $send_to_shell || $interactive ) ) { exit( $exit_code ); } return [ $stdout, $stderr, $exit_code, ]; } /** * Render PHP or other types of files using Mustache templates. * * IMPORTANT: Automatic HTML escaping is disabled! * * @param string $template_name * @param array $data */ function mustache_render( $template_name, $data = [] ) { if ( ! file_exists( $template_name ) ) { $template_name = WP_CLI_ROOT . "/templates/$template_name"; } $template = file_get_contents( $template_name ); $mustache = new Mustache_Engine( [ 'escape' => function ( $val ) { return $val; }, ] ); return $mustache->render( $template, $data ); } /** * Create a progress bar to display percent completion of a given operation. * * Progress bar is written to STDOUT, and disabled when command is piped. Progress * advances with `$progress->tick()`, and completes with `$progress->finish()`. * Process bar also indicates elapsed time and expected total time. * * ``` * # `wp user generate` ticks progress bar each time a new user is created. * # * # $ wp user generate --count=500 * # Generating users 22 % [=======> ] 0:05 / 0:23 * * $progress = \WP_CLI\Utils\make_progress_bar( 'Generating users', $count ); * for ( $i = 0; $i < $count; $i++ ) { * // uses wp_insert_user() to insert the user * $progress->tick(); * } * $progress->finish(); * ``` * * @access public * @category Output * * @param string $message Text to display before the progress bar. * @param integer $count Total number of ticks to be performed. * @param int $interval Optional. The interval in milliseconds between updates. Default 100. * @return \cli\progress\Bar|\WP_CLI\NoOp */ function make_progress_bar( $message, $count, $interval = 100 ) { if ( Shell::isPiped() ) { return new NoOp(); } return new Bar( $message, $count, $interval ); } /** * Helper function to use wp_parse_url when available or fall back to PHP's * parse_url if not. * * Additionally, this adds 'http://' to the URL if no scheme was found. * * @param string $url The URL to parse. * @param int $component Optional. The specific component to retrieve. * Use one of the PHP predefined constants to * specify which one. Defaults to -1 (= return * all parts as an array). * @param bool $auto_add_scheme Optional. Automatically add an http:// scheme if * none was found. Defaults to true. * @return mixed False on parse failure; Array of URL components on success; * When a specific component has been requested: null if the * component doesn't exist in the given URL; a string or - in the * case of PHP_URL_PORT - integer when it does. See parse_url()'s * return values. */ function parse_url( $url, $component = - 1, $auto_add_scheme = true ) { if ( function_exists( 'wp_parse_url' ) && ( -1 === $component || wp_version_compare( '4.7', '>=' ) ) ) { $url_parts = wp_parse_url( $url, $component ); } else { // phpcs:ignore WordPress.WP.AlternativeFunctions.parse_url_parse_url -- Fallback. $url_parts = \parse_url( $url, $component ); } // phpcs:ignore WordPress.WP.AlternativeFunctions.parse_url_parse_url -- Own version based on WP one. if ( $auto_add_scheme && ! parse_url( $url, PHP_URL_SCHEME, false ) ) { // phpcs:ignore WordPress.WP.AlternativeFunctions.parse_url_parse_url -- Own version based on WP one. $url_parts = parse_url( 'http://' . $url, $component, false ); } return $url_parts; } /** * Check if we're running in a Windows environment (cmd.exe). * * @return bool */ function is_windows() { $test_is_windows = getenv( 'WP_CLI_TEST_IS_WINDOWS' ); return false !== $test_is_windows ? (bool) $test_is_windows : strtoupper( substr( PHP_OS, 0, 3 ) ) === 'WIN'; } /** * Replace magic constants in some PHP source code. * * Replaces the __FILE__ and __DIR__ magic constants with the values they are * supposed to represent at runtime. * * @param string $source The PHP code to manipulate. * @param string $path The path to use instead of the magic constants. * @return string Adapted PHP code. */ function replace_path_consts( $source, $path ) { // Solve issue with Windows allowing single quotes in account names. $file = addslashes( $path ); if ( file_exists( $file ) ) { $file = realpath( $file ); } $dir = dirname( $file ); // Replace __FILE__ and __DIR__ constants with value of $file or $dir. return preg_replace_callback( FILE_DIR_PATTERN, static function ( $matches ) use ( $file, $dir ) { if ( ! empty( $matches['file'] ) ) { return "'{$file}'"; } if ( ! empty( $matches['dir'] ) ) { return "'{$dir}'"; } return $matches[0]; }, $source ); } /** * Make a HTTP request to a remote URL. * * Wraps the Requests HTTP library to ensure every request includes a cert. * * ``` * # `wp core download` verifies the hash for a downloaded WordPress archive * * $md5_response = Utils\http_request( 'GET', $download_url . '.md5' ); * if ( 20 != substr( $md5_response->status_code, 0, 2 ) ) { * WP_CLI::error( "Couldn't access md5 hash for release (HTTP code {$response->status_code})" ); * } * ``` * * @access public * * @param string $method HTTP method (GET, POST, DELETE, etc.). * @param string $url URL to make the HTTP request to. * @param array|null $data Data to send either as a query string for GET/HEAD requests, * or in the body for POST requests. * @param array $headers Add specific headers to the request. * @param array $options { * Optional. An associative array of additional request options. * * @type bool $halt_on_error Whether or not command execution should be halted on error. Default: true * @type bool|string $verify A boolean to use enable/disable SSL verification * or string absolute path to CA cert to use. * Defaults to detected CA cert bundled with the Requests library. * @type bool $insecure Whether to retry automatically without certificate validation. * } * @return object * @throws RuntimeException If the request failed. * @throws ExitException If the request failed and $halt_on_error is true. */ function http_request( $method, $url, $data = null, $headers = [], $options = [] ) { $insecure = isset( $options['insecure'] ) && (bool) $options['insecure']; $halt_on_error = ! isset( $options['halt_on_error'] ) || (bool) $options['halt_on_error']; unset( $options['halt_on_error'] ); if ( ! isset( $options['verify'] ) ) { // 'curl.cainfo' enforces the CA file to use, otherwise fallback to system-wide defaults then use the embedded CA file. $options['verify'] = ! empty( ini_get( 'curl.cainfo' ) ) ? ini_get( 'curl.cainfo' ) : true; } $options = WP_CLI::do_hook( 'http_request_options', $options ); RequestsLibrary::register_autoloader(); $request_method = [ RequestsLibrary::get_class_name(), 'request' ]; try { try { return $request_method( $url, $headers, $data, $method, $options ); } catch ( Exception $exception ) { if ( RequestsLibrary::is_requests_exception( $exception ) ) { if ( true !== $options['verify'] || 'curlerror' !== $exception->getType() || curl_errno( $exception->getData() ) !== CURLE_SSL_CACERT ) { throw $exception; } $options['verify'] = get_default_cacert( $halt_on_error ); return $request_method( $url, $headers, $data, $method, $options ); } throw $exception; } } catch ( Exception $exception ) { if ( RequestsLibrary::is_requests_exception( $exception ) ) { // CURLE_SSL_CACERT_BADFILE only defined for PHP >= 7. if ( ! $insecure || 'curlerror' !== $exception->getType() || ! in_array( curl_errno( $exception->getData() ), [ CURLE_SSL_CONNECT_ERROR, CURLE_SSL_CERTPROBLEM, 77 /*CURLE_SSL_CACERT_BADFILE*/ ], true ) ) { $error_msg = sprintf( "Failed to get url '%s': %s.", $url, $exception->getMessage() ); if ( $halt_on_error ) { WP_CLI::error( $error_msg ); } throw new RuntimeException( $error_msg, 0, $exception ); } $warning = sprintf( "Re-trying without verify after failing to get verified url '%s' %s.", $url, $exception->getMessage() ); WP_CLI::warning( $warning ); // Disable certificate validation for the next try. $options['verify'] = false; try { return $request_method( $url, $headers, $data, $method, $options ); } catch ( Exception $exception ) { if ( RequestsLibrary::is_requests_exception( $exception ) ) { $error_msg = sprintf( "Failed to get non-verified url '%s' %s.", $url, $exception->getMessage() ); if ( $halt_on_error ) { WP_CLI::error( $error_msg ); } throw new RuntimeException( $error_msg, 0, $exception ); } throw $exception; } } throw $exception; } } /** * Gets the full path to the default CA cert. * * @param bool $halt_on_error Whether or not command execution should be halted on error. Default: false * @return string Absolute path to the default CA cert. * @throws RuntimeException If unable to locate the cert. * @throws ExitException If unable to locate the cert and $halt_on_error is true. */ function get_default_cacert( $halt_on_error = false ) { $cert_path = RequestsLibrary::get_bundled_certificate_path(); $error_msg = 'Cannot find SSL certificate.'; if ( inside_phar( $cert_path ) ) { // cURL can't read Phar archives. return extract_from_phar( $cert_path ); } if ( file_exists( $cert_path ) ) { return $cert_path; } if ( $halt_on_error ) { WP_CLI::error( $error_msg ); } throw new RuntimeException( $error_msg ); } /** * Increments a version string using the "x.y.z-pre" format. * * Can increment the major, minor or patch number by one. * If $new_version == "same" the version string is not changed. * If $new_version is not a known keyword, it will be used as the new version string directly. * * @param string $current_version * @param string $new_version * @return string */ function increment_version( $current_version, $new_version ) { // split version assuming the format is x.y.z-pre. $current_version = explode( '-', $current_version, 2 ); $current_version[0] = explode( '.', $current_version[0] ); switch ( $new_version ) { case 'same': // do nothing. break; case 'patch': ++$current_version[0][2]; $current_version = [ $current_version[0] ]; // Drop possible pre-release info. break; case 'minor': ++$current_version[0][1]; $current_version[0][2] = 0; $current_version = [ $current_version[0] ]; // Drop possible pre-release info. break; case 'major': ++$current_version[0][0]; $current_version[0][1] = 0; $current_version[0][2] = 0; $current_version = [ $current_version[0] ]; // Drop possible pre-release info. break; default: // not a keyword. $current_version = [ [ $new_version ] ]; break; } // Reconstruct version string. $current_version[0] = implode( '.', $current_version[0] ); $current_version = implode( '-', $current_version ); return $current_version; } /** * Compare two version strings to get the named semantic version. * * @access public * * @param string $new_version * @param string $original_version * @return string 'major', 'minor', 'patch' */ function get_named_sem_ver( $new_version, $original_version ) { if ( ! Comparator::greaterThan( $new_version, $original_version ) ) { return ''; } $parts = explode( '-', $original_version ); $bits = explode( '.', $parts[0] ); $major = $bits[0]; if ( isset( $bits[1] ) ) { $minor = $bits[1]; } if ( isset( $bits[2] ) ) { $patch = $bits[2]; } try { if ( isset( $minor ) && Semver::satisfies( $new_version, "{$major}.{$minor}.x" ) ) { return 'patch'; } if ( Semver::satisfies( $new_version, "{$major}.x.x" ) ) { return 'minor'; } } catch ( \UnexpectedValueException $e ) { return ''; } return 'major'; } /** * Return the flag value or, if it's not set, the $default value. * * Because flags can be negated (e.g. --no-quiet to negate --quiet), this * function provides a safer alternative to using * `isset( $assoc_args['quiet'] )` or similar. * * @access public * @category Input * * @param array $assoc_args Arguments array. * @param string $flag Flag to get the value. * @param mixed $default Default value for the flag. Default: NULL. * @return mixed */ function get_flag_value( $assoc_args, $flag, $default = null ) { return isset( $assoc_args[ $flag ] ) ? $assoc_args[ $flag ] : $default; } /** * Get the home directory. * * @access public * @category System * * @return string */ function get_home_dir() { $home = getenv( 'HOME' ); if ( ! $home ) { // In Windows $HOME may not be defined. $home = getenv( 'HOMEDRIVE' ) . getenv( 'HOMEPATH' ); } return rtrim( $home, '/\\' ); } /** * Appends a trailing slash. * * @access public * @category System * * @param string $string What to add the trailing slash to. * @return string String with trailing slash added. */ function trailingslashit( $string ) { if ( ! is_string( $string ) ) { return '/'; } return rtrim( $string, '/\\' ) . '/'; } /** * Normalize a filesystem path. * * On Windows systems, replaces backslashes with forward slashes * and forces upper-case drive letters. * Allows for two leading slashes for Windows network shares, but * ensures that all other duplicate slashes are reduced to a single one. * Ensures upper-case drive letters on Windows systems. * * @access public * @category System * * @param string $path Path to normalize. * @return string Normalized path. */ function normalize_path( $path ) { $path = str_replace( '\\', '/', $path ); $path = preg_replace( '|(?<=.)/+|', '/', $path ); if ( ':' === substr( $path, 1, 1 ) ) { $path = ucfirst( $path ); } return $path; } /** * Convert Windows EOLs to *nix. * * @param string $str String to convert. * @return string String with carriage return / newline pairs reduced to newlines. */ function normalize_eols( $str ) { return str_replace( "\r\n", "\n", $str ); } /** * Get the system's temp directory. Warns user if it isn't writable. * * @access public * @category System * * @return string */ function get_temp_dir() { static $temp = ''; if ( $temp ) { return $temp; } // `sys_get_temp_dir()` introduced PHP 5.2.1. Will always return something. $temp = trailingslashit( sys_get_temp_dir() ); if ( ! is_writable( $temp ) ) { WP_CLI::warning( "Temp directory isn't writable: {$temp}" ); } return $temp; } /** * Parse a SSH url for its host, port, and path. * * Similar to parse_url(), but adds support for defined SSH aliases. * * ``` * host OR host/path/to/wordpress OR host:port/path/to/wordpress * ``` * * @access public * * @param string $url * @param int $component * @return mixed */ function parse_ssh_url( $url, $component = -1 ) { preg_match( '#^((docker|docker\-compose|docker\-compose\-run|ssh|vagrant):)?(([^@:]+)@)?([^:/~]+)(:([\d]*))?((/|~)(.+))?$#', $url, $matches ); $bits = []; foreach ( [ 2 => 'scheme', 4 => 'user', 5 => 'host', 7 => 'port', 8 => 'path', ] as $i => $key ) { if ( ! empty( $matches[ $i ] ) ) { $bits[ $key ] = $matches[ $i ]; } } // Find the hostname from `vagrant ssh-config` automatically. if ( preg_match( '/^vagrant:?/', $url ) ) { if ( 'vagrant' === $bits['host'] && empty( $bits['scheme'] ) ) { $bits['scheme'] = 'vagrant'; $bits['host'] = ''; } } switch ( $component ) { case PHP_URL_SCHEME: return isset( $bits['scheme'] ) ? $bits['scheme'] : null; case PHP_URL_USER: return isset( $bits['user'] ) ? $bits['user'] : null; case PHP_URL_HOST: return isset( $bits['host'] ) ? $bits['host'] : null; case PHP_URL_PATH: return isset( $bits['path'] ) ? $bits['path'] : null; case PHP_URL_PORT: return isset( $bits['port'] ) ? $bits['port'] : null; default: return $bits; } } /** * Report the results of the same operation against multiple resources. * * @access public * @category Input * * @param string $noun Resource being affected (e.g. plugin). * @param string $verb Type of action happening to the noun (e.g. activate). * @param integer $total Total number of resource being affected. * @param integer $successes Number of successful operations. * @param integer $failures Number of failures. * @param null|integer $skips Optional. Number of skipped operations. Default null (don't show skips). * @return void */ function report_batch_operation_results( $noun, $verb, $total, $successes, $failures, $skips = null ) { $plural_noun = $noun . 's'; $past_tense_verb = past_tense_verb( $verb ); $past_tense_verb_upper = ucfirst( $past_tense_verb ); if ( $failures ) { $failed_skipped_message = null === $skips ? '' : " ({$failures} failed" . ( $skips ? ", {$skips} skipped" : '' ) . ')'; if ( $successes ) { WP_CLI::error( "Only {$past_tense_verb} {$successes} of {$total} {$plural_noun}{$failed_skipped_message}." ); } else { WP_CLI::error( "No {$plural_noun} {$past_tense_verb}{$failed_skipped_message}." ); } } else { $skipped_message = $skips ? " ({$skips} skipped)" : ''; if ( $successes || $skips ) { WP_CLI::success( "{$past_tense_verb_upper} {$successes} of {$total} {$plural_noun}{$skipped_message}." ); } else { $message = $total > 1 ? ucfirst( $plural_noun ) : ucfirst( $noun ); WP_CLI::success( "{$message} already {$past_tense_verb}." ); } } } /** * Parse a string of command line arguments into an $argv-esqe variable. * * @access public * @category Input * * @param string $arguments * @return array */ function parse_str_to_argv( $arguments ) { preg_match_all( '/(?:--[^\s=]+=(["\'])((\\{2})*|(?:[^\1]+?[^\\\\](\\{2})*))\1|--[^\s=]+=[^\s]+|--[^\s=]+|(["\'])((\\{2})*|(?:[^\5]+?[^\\\\](\\{2})*))\5|[^\s]+)/', $arguments, $matches ); $argv = $matches[0]; return array_map( static function ( $arg ) { foreach ( [ '"', "'" ] as $char ) { if ( substr( $arg, 0, 1 ) === $char && substr( $arg, -1 ) === $char ) { $arg = substr( $arg, 1, -1 ); break; } } return $arg; }, $argv ); } /** * Locale-independent version of basename() * * @access public * * @param string $path * @param string $suffix * @return string */ function basename( $path, $suffix = '' ) { // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.urlencode_urlencode -- Format required by wordpress.org API. return urldecode( \basename( str_replace( [ '%2F', '%5C' ], '/', urlencode( $path ) ), $suffix ) ); } /** * Checks whether the output of the current script is a TTY or a pipe / redirect * * Returns `true` if `STDOUT` output is being redirected to a pipe or a file; `false` is * output is being sent directly to the terminal. * * If an env variable `SHELL_PIPE` exists, the returned result depends on its * value. Strings like `1`, `0`, `yes`, `no`, that validate to booleans are accepted. * * To enable ASCII formatting even when the shell is piped, use the * ENV variable `SHELL_PIPE=0`. * ``` * SHELL_PIPE=0 wp plugin list | cat * ``` * * Note that the db command forwards to the mysql client, which is unaware of the env * variable. For db commands, pass the `--table` option instead. * ``` * wp db query --table "SELECT 1" | cat * ``` * * @access public * * @return bool */ function isPiped() { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid -- Renaming would break BC. $shell_pipe = getenv( 'SHELL_PIPE' ); if ( false !== $shell_pipe ) { return filter_var( $shell_pipe, FILTER_VALIDATE_BOOLEAN ); } return function_exists( 'posix_isatty' ) && ! posix_isatty( STDOUT ); } /** * Expand within paths to their matching paths. * * Has no effect on paths which do not use glob patterns. * * @param string|array $paths Single path as a string, or an array of paths. * @param int|'default' $flags Optional. Flags to pass to glob. Defaults to GLOB_BRACE. * @return array Expanded paths. */ function expand_globs( $paths, $flags = 'default' ) { // Compatibility for systems without GLOB_BRACE. $glob_func = 'glob'; if ( 'default' === $flags ) { if ( ! defined( 'GLOB_BRACE' ) || getenv( 'WP_CLI_TEST_EXPAND_GLOBS_NO_GLOB_BRACE' ) ) { $glob_func = 'WP_CLI\Utils\glob_brace'; } else { $flags = GLOB_BRACE; } } $expanded = []; foreach ( (array) $paths as $path ) { $matching = [ $path ]; if ( preg_match( '/[' . preg_quote( '*?[]{}!', '/' ) . ']/', $path ) ) { $matching = $glob_func( $path, $flags ) ?: []; } $expanded = array_merge( $expanded, $matching ); } return array_values( array_unique( $expanded ) ); } /** * Simulate a `glob()` with the `GLOB_BRACE` flag set. For systems (eg Alpine Linux) built against a libc library (eg https://www.musl-libc.org/) that lacks it. * Copied and adapted from Zend Framework's `Glob::fallbackGlob()` and Glob::nextBraceSub()`. * * Zend Framework (https://framework.zend.com/) * * @link https://github.com/zendframework/zf2 for the canonical source repository * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (https://www.zend.com) * @license https://framework.zend.com/license/new-bsd New BSD License * * @param string $pattern Filename pattern. * @param void $dummy_flags Not used. * @return array Array of paths. */ function glob_brace( $pattern, $dummy_flags = null ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed -- $dummy_flags is needed for compatibility with the libc implementation. static $next_brace_sub; if ( ! $next_brace_sub ) { // Find the end of the subpattern in a brace expression. $next_brace_sub = function ( $pattern, $current ) { $length = strlen( $pattern ); $depth = 0; while ( $current < $length ) { if ( '\\' === $pattern[ $current ] ) { if ( ++$current === $length ) { break; } ++$current; } else { if ( ( '}' === $pattern[ $current ] && 0 === $depth-- ) || ( ',' === $pattern[ $current ] && 0 === $depth ) ) { break; } if ( '{' === $pattern[ $current++ ] ) { ++$depth; } } } return $current < $length ? $current : null; }; } $length = strlen( $pattern ); // Find first opening brace. for ( $begin = 0; $begin < $length; $begin++ ) { if ( '\\' === $pattern[ $begin ] ) { ++$begin; } elseif ( '{' === $pattern[ $begin ] ) { break; } } // Find comma or matching closing brace. $next = $next_brace_sub( $pattern, $begin + 1 ); if ( null === $next ) { return glob( $pattern ); } $rest = $next; // Point `$rest` to matching closing brace. while ( '}' !== $pattern[ $rest ] ) { $rest = $next_brace_sub( $pattern, $rest + 1 ); if ( null === $rest ) { return glob( $pattern ); } } $paths = []; $p = $begin + 1; // For each comma-separated subpattern. do { $subpattern = substr( $pattern, 0, $begin ) . substr( $pattern, $p, $next - $p ) . substr( $pattern, $rest + 1 ); $result = glob_brace( $subpattern ); if ( ! empty( $result ) ) { $paths = array_merge( $paths, $result ); } if ( '}' === $pattern[ $next ] ) { break; } $p = $next + 1; $next = $next_brace_sub( $pattern, $p ); } while ( null !== $next ); return array_values( array_unique( $paths ) ); } /** * Get the closest suggestion for a mistyped target term amongst a list of * options. * * Uses the Levenshtein algorithm to calculate the relative "distance" between * terms. * * If the "distance" to the closest term is higher than the threshold, an empty * string is returned. * * @param string $target Target term to get a suggestion for. * @param array $options Array with possible options. * @param int $threshold Threshold above which to return an empty string. * @return string */ function get_suggestion( $target, array $options, $threshold = 2 ) { $suggestion_map = [ 'add' => 'create', 'check' => 'check-update', 'capability' => 'cap', 'clear' => 'flush', 'decrement' => 'decr', 'del' => 'delete', 'directory' => 'dir', 'exec' => 'eval', 'exec-file' => 'eval-file', 'increment' => 'incr', 'language' => 'locale', 'lang' => 'locale', 'new' => 'create', 'number' => 'count', 'remove' => 'delete', 'regen' => 'regenerate', 'rep' => 'replace', 'repl' => 'replace', 'trash' => 'delete', 'v' => 'version', ]; if ( array_key_exists( $target, $suggestion_map ) && in_array( $suggestion_map[ $target ], $options, true ) ) { return $suggestion_map[ $target ]; } if ( empty( $options ) ) { return ''; } foreach ( $options as $option ) { $distance = levenshtein( $option, $target ); $levenshtein[ $option ] = $distance; } // Sort known command strings by distance to user entry. asort( $levenshtein ); // Fetch the closest command string. reset( $levenshtein ); $suggestion = key( $levenshtein ); // Only return a suggestion if below a given threshold. return $levenshtein[ $suggestion ] <= $threshold && $suggestion !== $target ? (string) $suggestion : ''; } /** * Get a Phar-safe version of a path. * * For paths inside a Phar, this strips the outer filesystem's location to * reduce the path to what it needs to be within the Phar archive. * * Use the __FILE__ or __DIR__ constants as a starting point. * * @param string $path An absolute path that might be within a Phar. * @return string A Phar-safe version of the path. */ function phar_safe_path( $path ) { if ( ! inside_phar() ) { return $path; } return str_replace( PHAR_STREAM_PREFIX . rtrim( WP_CLI_PHAR_PATH, '/' ) . '/', PHAR_STREAM_PREFIX, $path ); } /** * Maybe prefix command string with "/usr/bin/env". * Removes (if there) if Windows, adds (if not there) if not. * * @param string $command * @return string */ function force_env_on_nix_systems( $command ) { $env_prefix = '/usr/bin/env '; $env_prefix_len = strlen( $env_prefix ); if ( is_windows() ) { if ( 0 === strncmp( $command, $env_prefix, $env_prefix_len ) ) { $command = substr( $command, $env_prefix_len ); } } elseif ( 0 !== strncmp( $command, $env_prefix, $env_prefix_len ) ) { $command = $env_prefix . $command; } return $command; } /** * Check that `proc_open()` and `proc_close()` haven't been disabled. * * @param string $context Optional. If set will appear in error message. Default null. * @param bool $return Optional. If set will return false rather than error out. Default false. * @return bool */ function check_proc_available( $context = null, $return = false ) { if ( ! function_exists( 'proc_open' ) || ! function_exists( 'proc_close' ) ) { if ( $return ) { return false; } $msg = 'The PHP functions `proc_open()` and/or `proc_close()` are disabled. Please check your PHP ini directive `disable_functions` or suhosin settings.'; if ( $context ) { WP_CLI::error( sprintf( "Cannot do '%s': %s", $context, $msg ) ); } else { WP_CLI::error( $msg ); } } return true; } /** * Returns past tense of verb, with limited accuracy. Only regular verbs catered for, apart from "reset". * * @param string $verb Verb to return past tense of. * @return string */ function past_tense_verb( $verb ) { static $irregular = [ 'reset' => 'reset', ]; if ( isset( $irregular[ $verb ] ) ) { return $irregular[ $verb ]; } $last = substr( $verb, -1 ); if ( 'e' === $last ) { $verb = substr( $verb, 0, -1 ); } elseif ( 'y' === $last && ! preg_match( '/[aeiou]y$/', $verb ) ) { $verb = substr( $verb, 0, -1 ) . 'i'; } elseif ( preg_match( '/^[^aeiou]*[aeiou][^aeiouhwxy]$/', $verb ) ) { // Rule of thumb that most (all?) one-voweled regular verbs ending in vowel + consonant (excluding "h", "w", "x", "y") double their final consonant - misses many cases (eg "submit"). $verb .= $last; } return $verb . 'ed'; } /** * Get the path to the PHP binary used when executing WP-CLI. * * Environment values permit specific binaries to be indicated. * * @access public * @category System * * @return string */ function get_php_binary() { // Phar installs always use PHP_BINARY. if ( inside_phar() ) { return PHP_BINARY; } $wp_cli_php_used = getenv( 'WP_CLI_PHP_USED' ); if ( false !== $wp_cli_php_used ) { return $wp_cli_php_used; } $wp_cli_php = getenv( 'WP_CLI_PHP' ); if ( false !== $wp_cli_php ) { return $wp_cli_php; } return PHP_BINARY; } /** * Windows compatible `proc_open()`. * Works around bug in PHP, and also deals with *nix-like `ENV_VAR=blah cmd` environment variable prefixes. * * @access public * * @param string $cmd Command to execute. * @param array $descriptorspec Indexed array of descriptor numbers and their values. * @param array &$pipes Indexed array of file pointers that correspond to PHP's end of any pipes that are created. * @param string $cwd Initial working directory for the command. * @param array $env Array of environment variables. * @param array $other_options Array of additional options (Windows only). * @return resource Command stripped of any environment variable settings. */ function proc_open_compat( $cmd, $descriptorspec, &$pipes, $cwd = null, $env = null, $other_options = null ) { if ( is_windows() ) { $cmd = _proc_open_compat_win_env( $cmd, $env ); } return proc_open( $cmd, $descriptorspec, $pipes, $cwd, $env, $other_options ); } /** * For use by `proc_open_compat()` only. Separated out for ease of testing. Windows only. * Turns *nix-like `ENV_VAR=blah command` environment variable prefixes into stripped `cmd` with prefixed environment variables added to passed in environment array. * * @access private * * @param string $cmd Command to execute. * @param array &$env Array of existing environment variables. Will be modified if any settings in command. * @return string Command stripped of any environment variable settings. */ function _proc_open_compat_win_env( $cmd, &$env ) { if ( false !== strpos( $cmd, '=' ) ) { while ( preg_match( '/^([A-Za-z_][A-Za-z0-9_]*)=("[^"]*"|[^ ]*) /', $cmd, $matches ) ) { $cmd = substr( $cmd, strlen( $matches[0] ) ); if ( null === $env ) { $env = []; } $env[ $matches[1] ] = isset( $matches[2][0] ) && '"' === $matches[2][0] ? substr( $matches[2], 1, -1 ) : $matches[2]; } } return $cmd; } /** * First half of escaping for LIKE special characters % and _ before preparing for MySQL. * * Use this only before wpdb::prepare() or esc_sql(). Reversing the order is very bad for security. * * Copied from core "wp-includes/wp-db.php". Avoids dependency on WP 4.4 wpdb. * * @access public * * @param string $text The raw text to be escaped. The input typed by the user should have no * extra or deleted slashes. * @return string Text in the form of a LIKE phrase. The output is not SQL safe. Call $wpdb::prepare() * or real_escape next. */ function esc_like( $text ) { global $wpdb; // Check if the esc_like() method exists on the global $wpdb object. // We need to do this because to ensure compatibilty layers like the // SQLite integration plugin still work. if ( null !== $wpdb && method_exists( $wpdb, 'esc_like' ) ) { return $wpdb->esc_like( $text ); } return addcslashes( $text, '_%\\' ); } /** * Escapes (backticks) MySQL identifiers (aka schema object names) - i.e. column names, table names, and database/index/alias/view etc names. * See https://dev.mysql.com/doc/refman/5.5/en/identifiers.html * * @param string|array $idents A single identifier or an array of identifiers. * @return string|array An escaped string if given a string, or an array of escaped strings if given an array of strings. */ function esc_sql_ident( $idents ) { $backtick = static function ( $v ) { // Escape any backticks in the identifier by doubling. return '`' . str_replace( '`', '``', $v ) . '`'; }; if ( is_string( $idents ) ) { return $backtick( $idents ); } return array_map( $backtick, $idents ); } /** * Check whether a given string is a valid JSON representation. * * @param string $argument String to evaluate. * @param bool $ignore_scalars Optional. Whether to ignore scalar values. * Defaults to true. * @return bool Whether the provided string is a valid JSON representation. */ function is_json( $argument, $ignore_scalars = true ) { if ( ! is_string( $argument ) || '' === $argument ) { return false; } if ( $ignore_scalars && ! in_array( $argument[0], [ '{', '[' ], true ) ) { return false; } json_decode( $argument, $assoc = true ); return json_last_error() === JSON_ERROR_NONE; } /** * Parse known shell arrays included in the $assoc_args array. * * @param array $assoc_args Associative array of arguments. * @param array $array_arguments Array of argument keys that should receive an * array through the shell. * @return array */ function parse_shell_arrays( $assoc_args, $array_arguments ) { if ( empty( $assoc_args ) || empty( $array_arguments ) ) { return $assoc_args; } foreach ( $array_arguments as $key ) { if ( array_key_exists( $key, $assoc_args ) && is_json( $assoc_args[ $key ] ) ) { $assoc_args[ $key ] = json_decode( $assoc_args[ $key ], $assoc = true ); } } return $assoc_args; } /** * Describe a callable as a string. * * @param callable $callable The callable to describe. * @return string String description of the callable. */ function describe_callable( $callable ) { try { if ( $callable instanceof Closure ) { $reflection = new ReflectionFunction( $callable ); return "Closure in file {$reflection->getFileName()} at line {$reflection->getStartLine()}"; } if ( is_array( $callable ) ) { if ( is_object( $callable[0] ) ) { return sprintf( '%s->%s()', get_class( $callable[0] ), $callable[1] ); } return sprintf( '%s::%s()', $callable[0], $callable[1] ); } return gettype( $callable ); } catch ( Exception $exception ) { return 'Callable of unknown type'; } } /** * Checks if the given class and method pair is a valid callable. * * This accommodates changes to `is_callable()` in PHP 8 that mean an array of a * classname and instance method is no longer callable. * * @param array $pair The class and method pair to check. * @return bool */ function is_valid_class_and_method_pair( $pair ) { if ( ! is_array( $pair ) || 2 !== count( $pair ) ) { return false; } if ( ! is_string( $pair[0] ) || ! is_string( $pair[1] ) ) { return false; } if ( ! class_exists( $pair[0] ) ) { return false; } if ( ! method_exists( $pair[0], $pair[1] ) ) { return false; } return true; } /** * Pluralizes a noun in a grammatically correct way. * * @param string $noun Noun to be pluralized. Needs to be in singular form. * @param int|null $count Optional. Count of the nouns, to decide whether to * pluralize. Will pluralize unconditionally if none * provided. * @return string Pluralized noun. */ function pluralize( $noun, $count = null ) { if ( 1 === $count ) { return $noun; } return Inflector::pluralize( $noun ); } /** * Return the detected database type. * * Can be either 'sqlite' (if in a WordPress installation with the SQLite drop-in), * 'mysql', or 'mariadb'. * * @return string Database type. */ function get_db_type() { static $db_type = null; if ( defined( 'SQLITE_DB_DROPIN_VERSION' ) ) { return 'sqlite'; } if ( null !== $db_type ) { return $db_type; } $db_type = 'mysql'; $binary = get_mysql_binary_path(); if ( '' !== $binary ) { $result = Process::create( "$binary --version", null, null )->run(); if ( 0 === $result->return_code ) { $db_type = ( false !== strpos( $result->stdout, 'MariaDB' ) ) ? 'mariadb' : 'mysql'; } } return $db_type; } /** * Get the path to the MySQL or MariaDB binary. * * If the MySQL binary is provided by MariaDB (as determined by the version string), * prefers the actual MariaDB binary. * * @since 2.12.0 Now also checks for MariaDB. * * @return string Path to the MySQL/MariaDB binary, or an empty string if not found. */ function get_mysql_binary_path() { static $path = null; if ( null !== $path ) { return $path; } $path = ''; $mysql = Process::create( '/usr/bin/env which mysql', null, null )->run(); $mariadb = Process::create( '/usr/bin/env which mariadb', null, null )->run(); $mysql_binary = trim( $mysql->stdout ); $mariadb_binary = trim( $mariadb->stdout ); if ( 0 === $mysql->return_code ) { if ( '' !== $mysql_binary ) { $path = $mysql_binary; $result = Process::create( "$mysql_binary --version", null, null )->run(); // It's actually MariaDB disguised as MySQL. if ( 0 === $result->return_code && false !== strpos( $result->stdout, 'MariaDB' ) && 0 === $mariadb->return_code ) { $path = $mariadb_binary; } } } elseif ( 0 === $mariadb->return_code ) { $path = $mariadb_binary; } return $path; } /** * Get the version of the MySQL or MariaDB database. * * @since 2.12.0 Now also checks for MariaDB. * * @return string Version of the MySQL/MariaDB database, * or an empty string if not found. */ function get_mysql_version() { static $version = null; if ( null !== $version ) { return $version; } $db_type = get_db_type(); if ( 'sqlite' !== $db_type ) { $result = Process::create( "/usr/bin/env $db_type --version", null, null )->run(); if ( 0 !== $result->return_code ) { $version = ''; } else { $version = trim( $result->stdout ); } } return $version; } /** * Returns the correct `dump` command based on the detected database type. * * @return string The appropriate dump command. */ function get_sql_dump_command() { return 'mariadb' === get_db_type() ? 'mariadb-dump' : 'mysqldump'; } /** * Returns the correct `check` command based on the detected database type. * * @return string The appropriate check command. */ function get_sql_check_command() { return 'mariadb' === get_db_type() ? 'mariadb-check' : 'mysqlcheck'; } /** * Get the SQL modes of the MySQL session. * * @return string[] Array of SQL modes, or an empty array if they couldn't be * read. */ function get_sql_modes() { static $sql_modes = null; if ( null !== $sql_modes ) { return $sql_modes; } $binary = get_mysql_binary_path(); if ( '' === $binary ) { $sql_modes = []; } else { $result = Process::create( "$binary --no-auto-rehash --batch --skip-column-names --execute=\"SELECT @@SESSION.sql_mode\"", null, null )->run(); if ( 0 !== $result->return_code ) { $sql_modes = []; } else { $sql_modes = array_filter( array_map( 'trim', preg_split( "/\r\n|\n|\r/", $result->stdout ) ) ); } } return $sql_modes; } /** * Get the WP-CLI cache directory. * * @return string */ function get_cache_dir() { $home = get_home_dir(); return getenv( 'WP_CLI_CACHE_DIR' ) ? : "$home/.wp-cli/cache"; } /** * Check whether any input is passed to STDIN. * * @return bool */ function has_stdin() { $handle = fopen( 'php://stdin', 'r' ); $read = array( $handle ); $write = null; $except = null; $streams = stream_select( $read, $write, $except, 0 ); fclose( $handle ); return 1 === $streams; } /** * Return description of WP_CLI hooks used in @when tag * * @param string $hook Name of WP_CLI hook * * @return string|null */ function get_hook_description( $hook ) { $events = [ 'find_command_to_run_pre' => 'just before WP-CLI finds the command to run.', 'before_registering_contexts' => 'before the contexts are registered.', 'before_wp_load' => 'just before the WP load process begins.', 'before_wp_config_load' => 'after wp-config.php has been located.', 'after_wp_config_load' => 'after wp-config.php has been loaded into scope.', 'after_wp_load' => 'just after the WP load process has completed.', ]; if ( array_key_exists( $hook, $events ) ) { return $events[ $hook ]; } return null; } /** * Escape a value for CSV output. * * Values that start with the following characters are escaping with a single * quote: =, +, -, @, TAB (0x09) and CR (0x0D). * * @param string $value Value to escape. * @return string Escaped value. */ function escape_csv_value( $value ) { if ( null === $value ) { return ''; } // Convert to string if not already $value = (string) $value; if ( in_array( substr( $value, 0, 1 ), [ '=', '+', '-', '@', "\t", "\r" ], true ) ) { return "'{$value}"; } return $value; } error ) ) { wp_die( $wpdb->error ); } // Set the database table prefix and the format specifiers for database table columns. $GLOBALS['table_prefix'] = $table_prefix; wp_set_wpdb_vars(); // Start the WordPress object cache, or an external object cache if the drop-in is present. wp_start_object_cache(); // Attach the default filters. require ABSPATH . WPINC . '/default-filters.php'; // Initialize multisite if enabled. if ( is_multisite() ) { Utils\maybe_require( '4.6-alpha-37575', ABSPATH . WPINC . '/class-wp-site-query.php' ); Utils\maybe_require( '4.6-alpha-37896', ABSPATH . WPINC . '/class-wp-network-query.php' ); require ABSPATH . WPINC . '/ms-blogs.php'; require ABSPATH . WPINC . '/ms-settings.php'; } elseif ( ! defined( 'MULTISITE' ) ) { define( 'MULTISITE', false ); } register_shutdown_function( 'shutdown_action_hook' ); // Stop most of WordPress from being loaded if we just want the basics. if ( SHORTINIT ) { return false; } // Load the L10n library. require_once ABSPATH . WPINC . '/l10n.php'; // WP-CLI: Permit Utils\wp_not_installed() to run on < WP 4.0 apply_filters( 'nocache_headers', [] ); // Run the installer if WordPress is not installed. wp_not_installed(); // Load most of WordPress. require ABSPATH . WPINC . '/class-wp-walker.php'; require ABSPATH . WPINC . '/class-wp-ajax-response.php'; require ABSPATH . WPINC . '/formatting.php'; require ABSPATH . WPINC . '/capabilities.php'; Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-roles.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-role.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-user.php' ); require ABSPATH . WPINC . '/query.php'; Utils\maybe_require( '3.7-alpha-25139', ABSPATH . WPINC . '/date.php' ); require ABSPATH . WPINC . '/theme.php'; require ABSPATH . WPINC . '/class-wp-theme.php'; require ABSPATH . WPINC . '/template.php'; require ABSPATH . WPINC . '/user.php'; Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-user-query.php' ); Utils\maybe_require( '4.0', ABSPATH . WPINC . '/session.php' ); require ABSPATH . WPINC . '/meta.php'; Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-meta-query.php' ); Utils\maybe_require( '4.5-alpha-35776', ABSPATH . WPINC . '/class-wp-metadata-lazyloader.php' ); require ABSPATH . WPINC . '/general-template.php'; require ABSPATH . WPINC . '/link-template.php'; require ABSPATH . WPINC . '/author-template.php'; require ABSPATH . WPINC . '/post.php'; Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-walker-page.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-walker-page-dropdown.php' ); Utils\maybe_require( '4.6-alpha-37890', ABSPATH . WPINC . '/class-wp-post-type.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-post.php' ); require ABSPATH . WPINC . '/post-template.php'; Utils\maybe_require( '3.6-alpha-23451', ABSPATH . WPINC . '/revision.php' ); Utils\maybe_require( '3.6-alpha-23451', ABSPATH . WPINC . '/post-formats.php' ); require ABSPATH . WPINC . '/post-thumbnail-template.php'; require ABSPATH . WPINC . '/category.php'; Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-walker-category.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-walker-category-dropdown.php' ); require ABSPATH . WPINC . '/category-template.php'; require ABSPATH . WPINC . '/comment.php'; Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-comment.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-comment-query.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-walker-comment.php' ); require ABSPATH . WPINC . '/comment-template.php'; require ABSPATH . WPINC . '/rewrite.php'; Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-rewrite.php' ); require ABSPATH . WPINC . '/feed.php'; require ABSPATH . WPINC . '/bookmark.php'; require ABSPATH . WPINC . '/bookmark-template.php'; require ABSPATH . WPINC . '/kses.php'; require ABSPATH . WPINC . '/cron.php'; require ABSPATH . WPINC . '/deprecated.php'; require ABSPATH . WPINC . '/script-loader.php'; require ABSPATH . WPINC . '/taxonomy.php'; Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-term.php' ); Utils\maybe_require( '4.6-alpha-37575', ABSPATH . WPINC . '/class-wp-term-query.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-tax-query.php' ); require ABSPATH . WPINC . '/update.php'; require ABSPATH . WPINC . '/canonical.php'; require ABSPATH . WPINC . '/shortcodes.php'; Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/embed.php' ); require ABSPATH . WPINC . '/class-wp-embed.php'; require ABSPATH . WPINC . '/media.php'; Utils\maybe_require( '4.4-alpha-34903', ABSPATH . WPINC . '/class-wp-oembed-controller.php' ); require ABSPATH . WPINC . '/http.php'; require_once ABSPATH . WPINC . '/class-http.php'; Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-http-streams.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-http-curl.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-http-proxy.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-http-cookie.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-http-encoding.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-http-response.php' ); Utils\maybe_require( '4.6-alpha-37438', ABSPATH . WPINC . '/class-wp-http-requests-response.php' ); require ABSPATH . WPINC . '/widgets.php'; Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-widget.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/class-wp-widget-factory.php' ); require ABSPATH . WPINC . '/nav-menu.php'; require ABSPATH . WPINC . '/nav-menu-template.php'; require ABSPATH . WPINC . '/admin-bar.php'; Utils\maybe_require( '4.4-alpha-34928', ABSPATH . WPINC . '/rest-api.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/rest-api/class-wp-rest-server.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/rest-api/class-wp-rest-response.php' ); Utils\maybe_require( '4.4-beta4-35719', ABSPATH . WPINC . '/rest-api/class-wp-rest-request.php' ); // Load multisite-specific files. if ( is_multisite() ) { require ABSPATH . WPINC . '/ms-functions.php'; require ABSPATH . WPINC . '/ms-default-filters.php'; require ABSPATH . WPINC . '/ms-deprecated.php'; } // Define constants that rely on the API to obtain the default value. // Define must-use plugin directory constants, which may be overridden in the sunrise.php drop-in. wp_plugin_directory_constants(); $symlinked_plugins_supported = function_exists( 'wp_register_plugin_realpath' ); if ( $symlinked_plugins_supported ) { $GLOBALS['wp_plugin_paths'] = []; } // Load must-use plugins. foreach ( wp_get_mu_plugins() as $mu_plugin ) { include_once $mu_plugin; } unset( $mu_plugin ); // Load network activated plugins. if ( is_multisite() ) { foreach ( wp_get_active_network_plugins() as $network_plugin ) { if ( $symlinked_plugins_supported ) { wp_register_plugin_realpath( $network_plugin ); } include_once $network_plugin; } unset( $network_plugin ); } do_action( 'muplugins_loaded' ); if ( is_multisite() ) { ms_cookie_constants(); } // Define constants after multisite is loaded. Cookie-related constants may be overridden in ms_network_cookies(). wp_cookie_constants(); // Define and enforce our SSL constants. wp_ssl_constants(); // Create common globals. require ABSPATH . WPINC . '/vars.php'; // Make taxonomies and posts available to plugins and themes. // @plugin authors: warning: these get registered again on the init hook. create_initial_taxonomies(); create_initial_post_types(); // Register the default theme directory root register_theme_directory( get_theme_root() ); // Load active plugins. foreach ( wp_get_active_and_valid_plugins() as $plugin ) { if ( $symlinked_plugins_supported ) { wp_register_plugin_realpath( $plugin ); } include_once $plugin; } unset( $plugin, $symlinked_plugins_supported ); // Load pluggable functions. require ABSPATH . WPINC . '/pluggable.php'; require ABSPATH . WPINC . '/pluggable-deprecated.php'; // Set internal encoding. wp_set_internal_encoding(); // Run wp_cache_postload() if object cache is enabled and the function exists. if ( WP_CACHE && function_exists( 'wp_cache_postload' ) ) { wp_cache_postload(); } do_action( 'plugins_loaded' ); // Define constants which affect functionality if not already defined. wp_functionality_constants(); if ( ! function_exists( 'get_magic_quotes_gpc' ) ) { // Provide compat fallback for newer PHP version (7.4+) on older WordPress core versions. function get_magic_quotes_gpc() { return false; } } // Add magic quotes and set up $_REQUEST ( $_GET + $_POST ) wp_magic_quotes(); do_action( 'sanitize_comment_cookies' ); /** * WordPress Query object * @since 2.0.0 * @global object $wp_the_query */ $GLOBALS['wp_the_query'] = new WP_Query(); /** * Holds the reference to @see $wp_the_query * Use this global for WordPress queries * @since 1.5.0 * @global object $wp_query */ $GLOBALS['wp_query'] = $GLOBALS['wp_the_query']; /** * Holds the WordPress Rewrite object for creating pretty URLs * @since 1.5.0 * @global object $wp_rewrite */ $GLOBALS['wp_rewrite'] = new WP_Rewrite(); /** * WordPress Object * @since 2.0.0 * @global object $wp */ $GLOBALS['wp'] = new WP(); /** * WordPress Widget Factory Object * @since 2.8.0 * @global object $wp_widget_factory */ $GLOBALS['wp_widget_factory'] = new WP_Widget_Factory(); /** * WordPress User Roles * @since 2.0.0 * @global object $wp_roles */ $GLOBALS['wp_roles'] = new WP_Roles(); do_action( 'setup_theme' ); // Define the template related constants. wp_templating_constants(); // Load the default text localization domain. load_default_textdomain(); $locale = get_locale(); $locale_file = WP_LANG_DIR . "/$locale.php"; if ( ( 0 === validate_file( $locale ) ) && is_readable( $locale_file ) ) { require $locale_file; } unset( $locale_file ); // Pull in locale data after loading text domain. require_once ABSPATH . WPINC . '/locale.php'; /** * WordPress Locale object for loading locale domain date and various strings. * @since 2.1.0 * @global object $wp_locale */ $GLOBALS['wp_locale'] = new WP_Locale(); // Load the functions for the active theme, for both parent and child theme if applicable. // phpcs:disable WordPress.WP.DiscouragedConstants.STYLESHEETPATHUsageFound,WordPress.WP.DiscouragedConstants.TEMPLATEPATHUsageFound global $pagenow; if ( ! defined( 'WP_INSTALLING' ) || 'wp-activate.php' === $pagenow ) { if ( TEMPLATEPATH !== STYLESHEETPATH && file_exists( STYLESHEETPATH . '/functions.php' ) ) { include STYLESHEETPATH . '/functions.php'; } if ( file_exists( TEMPLATEPATH . '/functions.php' ) ) { include TEMPLATEPATH . '/functions.php'; } } // phpcs:enable WordPress.WP.DiscouragedConstants do_action( 'after_setup_theme' ); // Set up current user. $GLOBALS['wp']->init(); /** * Most of WP is loaded at this stage, and the user is authenticated. WP continues * to load on the init hook that follows (e.g. widgets), and many plugins instantiate * themselves on it for all sorts of reasons (e.g. they need a user, a taxonomy, etc.). * * If you wish to plug an action once WP is loaded, use the wp_loaded hook below. */ do_action( 'init' ); // Check site status. # if ( is_multisite() ) { // WP-CLI if ( is_multisite() && ! defined( 'WP_INSTALLING' ) ) { $file = ms_site_check(); if ( true !== $file ) { require $file; die(); } unset( $file ); } /** * This hook is fired once WP, all plugins, and the theme are fully loaded and instantiated. * * AJAX requests should use wp-admin/admin-ajax.php. admin-ajax.php can handle requests for * users not logged in. * * @link https://developer.wordpress.org/plugins/javascript/ajax/ * * @since 3.0.0 */ do_action( 'wp_loaded' ); ] * : Render output in a particular format. * --- * default: yaml * options: * - yaml * - json * - var_export * --- * * ## EXAMPLES * * # List all available aliases. * $ wp cli alias list * --- * @all: Run command against every registered alias. * @prod: * ssh: runcommand@runcommand.io~/webapps/production * @dev: * ssh: vagrant@192.168.50.10/srv/www/runcommand.dev * @both: * - @prod * - @dev * * @subcommand list */ public function list_( $args, $assoc_args ) { WP_CLI::print_value( WP_CLI::get_runner()->aliases, $assoc_args ); } /** * Gets the value for an alias. * * ## OPTIONS * * * : Key for the alias. * * ## EXAMPLES * * # Get alias. * $ wp cli alias get @prod * ssh: dev@somedeve.env:12345/home/dev/ */ public function get( $args, $assoc_args ) { list( $alias ) = $args; $aliases = WP_CLI::get_runner()->aliases; if ( empty( $aliases[ $alias ] ) ) { WP_CLI::error( "No alias found with key '{$alias}'." ); } foreach ( $aliases[ $alias ] as $key => $value ) { WP_CLI::log( "{$key}: {$value}" ); } } /** * Creates an alias. * * ## OPTIONS * * * : Key for the alias. * * [--set-user=] * : Set user for alias. * * [--set-url=] * : Set url for alias. * * [--set-path=] * : Set path for alias. * * [--set-ssh=] * : Set ssh for alias. * * [--set-http=] * : Set http for alias. * * [--grouping=] * : For grouping multiple aliases. * * [--config=] * : Config file to be considered for operations. * --- * default: global * options: * - global * - project * --- * * ## EXAMPLES * * # Add alias to global config. * $ wp cli alias add @prod --set-ssh=login@host --set-path=/path/to/wordpress/install/ --set-user=wpcli * Success: Added '@prod' alias. * * # Add alias to project config. * $ wp cli alias add @prod --set-ssh=login@host --set-path=/path/to/wordpress/install/ --set-user=wpcli --config=project * Success: Added '@prod' alias. * * # Add group of aliases. * $ wp cli alias add @multiservers --grouping=servera,serverb * Success: Added '@multiservers' alias. */ public function add( $args, $assoc_args ) { $config = ( ! empty( $assoc_args['config'] ) ? $assoc_args['config'] : 'global' ); list( $config_path, $aliases ) = $this->get_aliases_data( $config, '', true ); $this->validate_config_file( $config_path ); $alias = $args[0]; $grouping = Utils\get_flag_value( $assoc_args, 'grouping' ); $this->validate_input( $assoc_args, $grouping ); if ( isset( $aliases[ $alias ] ) ) { WP_CLI::error( "Key '{$alias}' exists already." ); } if ( null === $grouping ) { $aliases = $this->build_aliases( $aliases, $alias, $assoc_args, false ); } else { $aliases = $this->build_aliases( $aliases, $alias, $assoc_args, true, $grouping ); } $this->process_aliases( $aliases, $alias, $config_path, 'Added' ); } /** * Deletes an alias. * * ## OPTIONS * * * : Key for the alias. * * [--config=] * : Config file to be considered for operations. * --- * options: * - global * - project * --- * * ## EXAMPLES * * # Delete alias. * $ wp cli alias delete @prod * Success: Deleted '@prod' alias. * * # Delete project alias. * $ wp cli alias delete @prod --config=project * Success: Deleted '@prod' alias. */ public function delete( $args, $assoc_args ) { list( $alias ) = $args; $config = ( ! empty( $assoc_args['config'] ) ? $assoc_args['config'] : '' ); list( $config_path, $aliases ) = $this->get_aliases_data( $config, $alias ); $this->validate_config_file( $config_path ); if ( empty( $aliases[ $alias ] ) ) { WP_CLI::error( "No alias found with key '{$alias}'." ); } unset( $aliases[ $alias ] ); $this->process_aliases( $aliases, $alias, $config_path, 'Deleted' ); } /** * Updates an alias. * * ## OPTIONS * * * : Key for the alias. * * [--set-user=] * : Set user for alias. * * [--set-url=] * : Set url for alias. * * [--set-path=] * : Set path for alias. * * [--set-ssh=] * : Set ssh for alias. * * [--set-http=] * : Set http for alias. * * [--grouping=] * : For grouping multiple aliases. * * [--config=] * : Config file to be considered for operations. * --- * options: * - global * - project * --- * * ## EXAMPLES * * # Update alias. * $ wp cli alias update @prod --set-user=newuser --set-path=/new/path/to/wordpress/install/ * Success: Updated 'prod' alias. * * # Update project alias. * $ wp cli alias update @prod --set-user=newuser --set-path=/new/path/to/wordpress/install/ --config=project * Success: Updated 'prod' alias. */ public function update( $args, $assoc_args ) { $config = ( ! empty( $assoc_args['config'] ) ? $assoc_args['config'] : '' ); $alias = $args[0]; $grouping = Utils\get_flag_value( $assoc_args, 'grouping' ); list( $config_path, $aliases ) = $this->get_aliases_data( $config, $alias, true ); $this->validate_config_file( $config_path ); $this->validate_input( $assoc_args, $grouping ); if ( empty( $aliases[ $alias ] ) ) { WP_CLI::error( "No alias found with key '{$alias}'." ); } if ( null === $grouping ) { $aliases = $this->build_aliases( $aliases, $alias, $assoc_args, false, '', true ); } else { $aliases = $this->build_aliases( $aliases, $alias, $assoc_args, true, $grouping, true ); } $this->process_aliases( $aliases, $alias, $config_path, 'Updated' ); } /** * Check whether an alias is a group. * * ## OPTIONS * * * : Key for the alias. * * ## EXAMPLES * * # Checks whether the alias is a group; exit status 0 if it is, otherwise 1. * $ wp cli alias is-group @prod * $ echo $? * 1 * * @subcommand is-group */ public function is_group( $args, $assoc_args = array() ) { $alias = $args[0]; $aliases = WP_CLI::get_runner()->aliases; if ( empty( $aliases[ $alias ] ) ) { WP_CLI::error( "No alias found with key '{$alias}'." ); } // how do we know the alias is a group? // + array keys are numeric // + array values begin with '@' $first_item = $aliases[ $alias ]; $first_item_key = key( $first_item ); $first_item_value = $first_item[ $first_item_key ]; if ( is_numeric( $first_item_key ) && substr( $first_item_value, 0, 1 ) === '@' ) { WP_CLI::halt( 0 ); } WP_CLI::halt( 1 ); } /** * Get config path and aliases data based on config type. * * @param string $config Type of config to get data from. * @param string $alias Alias to be used for Add/Update/Delete. * @param bool $create_config_file Optional. If a config file doesn't exist, * should it be created? Defaults to false. * * @return array Config Path and Aliases in it. * @throws ExitException */ private function get_aliases_data( $config, $alias, $create_config_file = false ) { $global_config_path = WP_CLI::get_runner()->get_global_config_path( $create_config_file ); $global_aliases = Spyc::YAMLLoad( $global_config_path ); $project_config_path = WP_CLI::get_runner()->get_project_config_path(); $project_aliases = Spyc::YAMLLoad( $project_config_path ); if ( 'global' === $config ) { $config_path = $global_config_path; $aliases = $global_aliases; } elseif ( 'project' === $config ) { $config_path = $project_config_path; $aliases = $project_aliases; } else { $is_global_alias = array_key_exists( $alias, $global_aliases ); $is_project_alias = array_key_exists( $alias, $project_aliases ); if ( $is_global_alias && $is_project_alias ) { WP_CLI::error( "Key '{$alias}' found in more than one path. Please pass --config param." ); } elseif ( $is_global_alias ) { $config_path = $global_config_path; $aliases = $global_aliases; } else { $config_path = $project_config_path; $aliases = $project_aliases; } } return [ $config_path, $aliases ]; } /** * Check if the config file exists and is writable. * * @param string $config_path Path to config file. * * @return void */ private function validate_config_file( $config_path ) { if ( ! file_exists( $config_path ) || ! is_writable( $config_path ) ) { WP_CLI::error( "Config file does not exist: {$config_path}" ); } } /** * Return aliases array. * * @param array $aliases Current aliases data. * @param string $alias Name of alias. * @param array $assoc_args Associative arguments. * @param bool $is_grouping Check if its a grouping operation. * @param string $grouping Grouping value. * @param bool $is_update Is this an update operation? * * @return mixed */ private function build_aliases( $aliases, $alias, $assoc_args, $is_grouping, $grouping = '', $is_update = false ) { $alias = $this->normalize_alias( $alias ); if ( $is_grouping ) { $valid_assoc_args = [ 'config', 'grouping' ]; $invalid_args = array_diff( array_keys( $assoc_args ), $valid_assoc_args ); // Check for invalid args. if ( ! empty( $invalid_args ) ) { $args_info = implode( ',', $invalid_args ); WP_CLI::error( "--grouping argument works alone. Found invalid arg(s) '$args_info'." ); } } if ( $is_update ) { $this->validate_alias_type( $aliases, $alias, $assoc_args, $grouping ); } if ( ! $is_grouping ) { foreach ( $assoc_args as $key => $value ) { if ( strpos( $key, 'set-' ) !== false ) { $alias_key_info = explode( '-', $key ); $alias_key = empty( $alias_key_info[1] ) ? '' : $alias_key_info[1]; if ( ! empty( $alias_key ) && ! empty( $value ) ) { $aliases[ $alias ][ $alias_key ] = $value; } } } } elseif ( ! empty( $grouping ) ) { $group_alias_list = explode( ',', $grouping ); $group_alias = array_map( function ( $current_alias ) { return '@' . ltrim( $current_alias, '@' ); }, $group_alias_list ); $aliases[ $alias ] = $group_alias; } return $aliases; } /** * Validate input of passed arguments. * * @param array $assoc_args Arguments array. * @param string $grouping Grouping argument value. * * @throws ExitException */ private function validate_input( $assoc_args, $grouping ) { // Check if valid arguments were passed. $arg_match = preg_grep( '/^set-(\w+)/i', array_keys( $assoc_args ) ); // Verify passed-arguments. if ( empty( $grouping ) && empty( $arg_match ) ) { WP_CLI::error( 'No valid arguments passed.' ); } // Check whether passed arguments contain value or not. $assoc_arg_values = array_filter( array_intersect_key( $assoc_args, array_flip( $arg_match ) ) ); if ( empty( $grouping ) && empty( $assoc_arg_values ) ) { WP_CLI::error( 'No value passed to arguments.' ); } } /** * Validate alias type before update. * * @param array $aliases Existing aliases data. * @param string $alias Alias Name. * @param array $assoc_args Arguments array. * @param string $grouping Grouping argument value. * * @throws ExitException */ private function validate_alias_type( $aliases, $alias, $assoc_args, $grouping ) { $alias_data = $aliases[ $alias ]; $group_aliases_match = preg_grep( '/^@(\w+)/i', $alias_data ); $arg_match = preg_grep( '/^set-(\w+)/i', array_keys( $assoc_args ) ); if ( ! empty( $group_aliases_match ) && ! empty( $arg_match ) ) { WP_CLI::error( 'Trying to update group alias with invalid arguments.' ); } elseif ( empty( $group_aliases_match ) && ! empty( $grouping ) ) { WP_CLI::error( 'Trying to update simple alias with invalid --grouping argument.' ); } } /** * Save aliases data to config file. * * @param array $aliases Current aliases data. * @param string $alias Name of alias. * @param string $config_path Path to config file. * @param string $operation Current operation string fro message. */ private function process_aliases( $aliases, $alias, $config_path, $operation = '' ) { $alias = $this->normalize_alias( $alias ); // Convert data to YAML string. $yaml_data = Spyc::YAMLDump( $aliases ); // Add data in config file. if ( file_put_contents( $config_path, $yaml_data ) ) { WP_CLI::success( "$operation '{$alias}' alias." ); } } /** * Normalize the alias to an expected format. * * - Add @ if not present. * * @param string $alias Name of alias. */ private function normalize_alias( $alias ) { // Check if the alias starts with the @. // See: https://github.com/wp-cli/wp-cli/issues/5391 if ( strpos( $alias, '@' ) !== 0 ) { $alias = '@' . ltrim( $alias, '@' ); } return $alias; } } is_enabled() ) { WP_CLI::error( 'Cache directory does not exist.' ); } $cache->clear(); WP_CLI::success( 'Cache cleared.' ); } /** * Prunes the internal cache. * * Removes all cached files except for the newest version of each one. * * ## EXAMPLES * * $ wp cli cache prune * Success: Cache pruned. * * @subcommand prune */ public function cache_prune() { $cache = WP_CLI::get_cache(); if ( ! $cache->is_enabled() ) { WP_CLI::error( 'Cache directory does not exist.' ); } $cache->prune(); WP_CLI::success( 'Cache pruned.' ); } } $command->get_name(), 'description' => $command->get_shortdesc(), 'longdesc' => $command->get_longdesc(), 'hook' => $command->get_hook(), ]; foreach ( $command->get_subcommands() as $subcommand ) { $dump['subcommands'][] = $this->command_to_array( $subcommand ); } if ( empty( $dump['subcommands'] ) ) { $dump['synopsis'] = (string) $command->get_synopsis(); } return $dump; } /** * Prints WP-CLI version. * * ## EXAMPLES * * # Display CLI version. * $ wp cli version * WP-CLI 0.24.1 */ public function version() { WP_CLI::line( 'WP-CLI ' . WP_CLI_VERSION ); } /** * Prints various details about the WP-CLI environment. * * Helpful for diagnostic purposes, this command shares: * * * OS information. * * Shell information. * * PHP binary used. * * PHP binary version. * * php.ini configuration file used (which is typically different than web). * * WP-CLI root dir: where WP-CLI is installed (if non-Phar install). * * WP-CLI global config: where the global config YAML file is located. * * WP-CLI project config: where the project config YAML file is located. * * WP-CLI version: currently installed version. * * See [config docs](https://make.wordpress.org/cli/handbook/references/config/) for more details on global * and project config YAML files. * * ## OPTIONS * * [--format=] * : Render output in a particular format. * --- * default: list * options: * - list * - json * --- * * ## EXAMPLES * * # Display various data about the CLI environment. * $ wp cli info * OS: Linux 4.10.0-42-generic #46~16.04.1-Ubuntu SMP Mon Dec 4 15:57:59 UTC 2017 x86_64 * Shell: /usr/bin/zsh * PHP binary: /usr/bin/php * PHP version: 7.1.12-1+ubuntu16.04.1+deb.sury.org+1 * php.ini used: /etc/php/7.1/cli/php.ini * WP-CLI root dir: phar://wp-cli.phar * WP-CLI packages dir: /home/person/.wp-cli/packages/ * WP-CLI global config: * WP-CLI project config: * WP-CLI version: 1.5.0 */ public function info( $_, $assoc_args ) { // php_uname() $mode argument was only added with PHP 7.0+. Fall back to // entire string for older versions. $system_os = PHP_MAJOR_VERSION < 7 ? php_uname() : sprintf( '%s %s %s %s', php_uname( 's' ), php_uname( 'r' ), php_uname( 'v' ), php_uname( 'm' ) ); $shell = getenv( 'SHELL' ); if ( ! $shell && Utils\is_windows() ) { $shell = getenv( 'ComSpec' ); } $php_bin = Utils\get_php_binary(); $runner = WP_CLI::get_runner(); $packages_dir = $runner->get_packages_dir_path(); if ( ! is_dir( $packages_dir ) ) { $packages_dir = null; } if ( Utils\get_flag_value( $assoc_args, 'format' ) === 'json' ) { $info = [ 'system_os' => $system_os, 'shell' => $shell, 'php_binary_path' => $php_bin, 'php_version' => PHP_VERSION, 'php_ini_used' => get_cfg_var( 'cfg_file_path' ), 'mysql_binary_path' => Utils\get_mysql_binary_path(), 'mysql_version' => Utils\get_mysql_version(), 'sql_modes' => Utils\get_sql_modes(), 'wp_cli_dir_path' => WP_CLI_ROOT, 'wp_cli_vendor_path' => WP_CLI_VENDOR_DIR, 'wp_cli_phar_path' => defined( 'WP_CLI_PHAR_PATH' ) ? WP_CLI_PHAR_PATH : '', 'wp_cli_packages_dir_path' => $packages_dir, 'wp_cli_cache_dir_path' => Utils\get_cache_dir(), 'global_config_path' => $runner->global_config_path, 'project_config_path' => $runner->project_config_path, 'wp_cli_version' => WP_CLI_VERSION, ]; WP_CLI::line( json_encode( $info ) ); } else { WP_CLI::line( "OS:\t" . $system_os ); WP_CLI::line( "Shell:\t" . $shell ); WP_CLI::line( "PHP binary:\t" . $php_bin ); WP_CLI::line( "PHP version:\t" . PHP_VERSION ); WP_CLI::line( "php.ini used:\t" . get_cfg_var( 'cfg_file_path' ) ); WP_CLI::line( "MySQL binary:\t" . Utils\get_mysql_binary_path() ); WP_CLI::line( "MySQL version:\t" . Utils\get_mysql_version() ); WP_CLI::line( "SQL modes:\t" . implode( ',', Utils\get_sql_modes() ) ); WP_CLI::line( "WP-CLI root dir:\t" . WP_CLI_ROOT ); WP_CLI::line( "WP-CLI vendor dir:\t" . WP_CLI_VENDOR_DIR ); WP_CLI::line( "WP_CLI phar path:\t" . ( defined( 'WP_CLI_PHAR_PATH' ) ? WP_CLI_PHAR_PATH : '' ) ); WP_CLI::line( "WP-CLI packages dir:\t" . $packages_dir ); WP_CLI::line( "WP-CLI cache dir:\t" . Utils\get_cache_dir() ); WP_CLI::line( "WP-CLI global config:\t" . $runner->global_config_path ); WP_CLI::line( "WP-CLI project config:\t" . $runner->project_config_path ); WP_CLI::line( "WP-CLI version:\t" . WP_CLI_VERSION ); } } /** * Checks to see if there is a newer version of WP-CLI available. * * Queries the GitHub releases API. Returns available versions if there are * updates available, or success message if using the latest release. * * ## OPTIONS * * [--patch] * : Only list patch updates. * * [--minor] * : Only list minor updates. * * [--major] * : Only list major updates. * * [--field=] * : Prints the value of a single field for each update. * * [--fields=] * : Limit the output to specific object fields. Defaults to version,update_type,package_url,status,requires_php. * * [--format=] * : Render output in a particular format. * --- * default: table * options: * - table * - csv * - json * - count * - yaml * --- * * ## EXAMPLES * * # Check for update. * $ wp cli check-update * Success: WP-CLI is at the latest version. * * # Check for update and new version is available. * $ wp cli check-update * +---------+-------------+-------------------------------------------------------------------------------+ * | version | update_type | package_url | * +---------+-------------+-------------------------------------------------------------------------------+ * | 0.24.1 | patch | https://github.com/wp-cli/wp-cli/releases/download/v0.24.1/wp-cli-0.24.1.phar | * +---------+-------------+-------------------------------------------------------------------------------+ * * @subcommand check-update */ public function check_update( $_, $assoc_args ) { $updates = $this->get_updates( $assoc_args ); if ( $updates ) { $formatter = new Formatter( $assoc_args, [ 'version', 'update_type', 'package_url', 'status', 'requires_php' ] ); $formatter->display_items( $updates ); } elseif ( empty( $assoc_args['format'] ) || 'table' === $assoc_args['format'] ) { $update_type = $this->get_update_type_str( $assoc_args ); WP_CLI::success( "WP-CLI is at the latest{$update_type}version." ); } } /** * Updates WP-CLI to the latest release. * * Default behavior is to check the releases API for the newest stable * version, and prompt if one is available. * * Use `--stable` to install or reinstall the latest stable version. * * Use `--nightly` to install the latest built version of the master branch. * While not recommended for production, nightly contains the latest and * greatest, and should be stable enough for development and staging * environments. * * Only works for the Phar installation mechanism. * * ## OPTIONS * * [--patch] * : Only perform patch updates. * * [--minor] * : Only perform minor updates. * * [--major] * : Only perform major updates. * * [--stable] * : Update to the latest stable release. Skips update check. * * [--nightly] * : Update to the latest built version of the master branch. Potentially unstable. * * [--yes] * : Do not prompt for confirmation. * * [--insecure] * : Retry without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack. * * ## EXAMPLES * * # Update CLI. * $ wp cli update * You are currently using WP-CLI version 0.24.0. Would you like to update to 0.24.1? [y/n] y * Downloading from https://github.com/wp-cli/wp-cli/releases/download/v0.24.1/wp-cli-0.24.1.phar... * New version works. Proceeding to replace. * Success: Updated WP-CLI to 0.24.1. */ public function update( $_, $assoc_args ) { if ( ! Utils\inside_phar() ) { WP_CLI::error( 'You can only self-update Phar files.' ); } $old_phar = realpath( $_SERVER['argv'][0] ); if ( ! is_writable( $old_phar ) ) { WP_CLI::error( sprintf( '%s is not writable by current user.', $old_phar ) ); } elseif ( ! is_writable( dirname( $old_phar ) ) ) { WP_CLI::error( sprintf( '%s is not writable by current user.', dirname( $old_phar ) ) ); } if ( Utils\get_flag_value( $assoc_args, 'nightly' ) ) { WP_CLI::confirm( sprintf( 'You are currently using WP-CLI version %s. Would you like to update to the latest nightly version?', WP_CLI_VERSION ), $assoc_args ); $download_url = 'https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli-nightly.phar'; $md5_url = 'https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli-nightly.phar.md5'; $sha512_url = 'https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli-nightly.phar.sha512'; } elseif ( Utils\get_flag_value( $assoc_args, 'stable' ) ) { WP_CLI::confirm( sprintf( 'You are currently using WP-CLI version %s. Would you like to update to the latest stable release?', WP_CLI_VERSION ), $assoc_args ); $download_url = 'https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar'; $md5_url = 'https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar.md5'; $sha512_url = 'https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar.sha512'; } else { $updates = $this->get_updates( $assoc_args ); $newest = $this->array_find( $updates, static function ( $update ) { return 'available' === $update['status']; } ); if ( ! $newest ) { $update_type = $this->get_update_type_str( $assoc_args ); WP_CLI::success( "WP-CLI is at the latest{$update_type}version." ); return; } WP_CLI::confirm( sprintf( 'You have version %s. Would you like to update to %s?', WP_CLI_VERSION, $newest['version'] ), $assoc_args ); $download_url = $newest['package_url']; $md5_url = str_replace( '.phar', '.phar.md5', $download_url ); $sha512_url = str_replace( '.phar', '.phar.sha512', $download_url ); } WP_CLI::log( sprintf( 'Downloading from %s...', $download_url ) ); $temp = Utils\get_temp_dir() . uniqid( 'wp_', true ) . '.phar'; $headers = []; $options = [ 'timeout' => 600, // 10 minutes ought to be enough for everybody. 'filename' => $temp, 'insecure' => (bool) Utils\get_flag_value( $assoc_args, 'insecure', false ), ]; Utils\http_request( 'GET', $download_url, null, $headers, $options ); unset( $options['filename'] ); $this->validate_hashes( $temp, $sha512_url, $md5_url ); $allow_root = WP_CLI::get_runner()->config['allow-root'] ? '--allow-root' : ''; $php_binary = Utils\get_php_binary(); $process = Process::create( "{$php_binary} $temp --info {$allow_root}" ); $result = $process->run(); if ( 0 !== $result->return_code || false === stripos( $result->stdout, 'WP-CLI version' ) ) { $multi_line = explode( PHP_EOL, $result->stderr ); WP_CLI::error_multi_line( $multi_line ); WP_CLI::error( 'The downloaded PHAR is broken, try running wp cli update again.' ); } WP_CLI::log( 'New version works. Proceeding to replace.' ); $mode = fileperms( $old_phar ) & 511; if ( false === chmod( $temp, $mode ) ) { WP_CLI::error( sprintf( 'Cannot chmod %s.', $temp ) ); } class_exists( '\cli\Colors' ); // This autoloads \cli\Colors - after we move the file we no longer have access to this class. if ( false === rename( $temp, $old_phar ) ) { WP_CLI::error( sprintf( 'Cannot move %s to %s', $temp, $old_phar ) ); } if ( Utils\get_flag_value( $assoc_args, 'nightly', false ) ) { $updated_version = 'the latest nightly release'; } elseif ( Utils\get_flag_value( $assoc_args, 'stable', false ) ) { $updated_version = 'the latest stable release'; } else { $updated_version = isset( $newest['version'] ) ? $newest['version'] : ''; } WP_CLI::success( sprintf( 'Updated WP-CLI to %s.', $updated_version ) ); } /** * @param string $file Release file path. * @param string $sha512_url URL to sha512 hash. * @param string $md5_url URL to md5 hash. * * @return void * @throws \WP_CLI\ExitException */ private function validate_hashes( $file, $sha512_url, $md5_url ) { $algos = [ 'sha512' => $sha512_url, 'md5' => $md5_url, ]; foreach ( $algos as $algo => $url ) { $response = Utils\http_request( 'GET', $url ); if ( '20' !== substr( $response->status_code, 0, 2 ) ) { WP_CLI::log( "Couldn't access $algo hash for release (HTTP code {$response->status_code})." ); continue; } $file_hash = hash_file( $algo, $file ); $release_hash = trim( $response->body ); if ( $file_hash === $release_hash ) { WP_CLI::log( "$algo hash verified: $release_hash" ); return; } else { WP_CLI::error( "$algo hash for download ($file_hash) is different than the release hash ($release_hash)." ); } } WP_CLI::error( 'Release hash verification failed.' ); } /** * Returns update information. */ private function get_updates( $assoc_args ) { $url = 'https://api.github.com/repos/wp-cli/wp-cli/releases?per_page=100'; $options = [ 'timeout' => 30, 'insecure' => (bool) Utils\get_flag_value( $assoc_args, 'insecure', false ), ]; $headers = [ 'Accept' => 'application/json', ]; $github_token = getenv( 'GITHUB_TOKEN' ); if ( false !== $github_token ) { $headers['Authorization'] = 'token ' . $github_token; } $response = Utils\http_request( 'GET', $url, null, $headers, $options ); if ( ! $response->success || 200 !== $response->status_code ) { WP_CLI::error( sprintf( 'Failed to get latest version (HTTP code %d).', $response->status_code ) ); } $release_data = json_decode( $response->body ); $updates = [ 'major' => false, 'minor' => false, 'patch' => false, ]; $updates_unavailable = []; foreach ( $release_data as $release ) { // Get rid of leading "v" if there is one set. $release_version = $release->tag_name; if ( 'v' === substr( $release_version, 0, 1 ) ) { $release_version = ltrim( $release_version, 'v' ); } $update_type = Utils\get_named_sem_ver( $release_version, WP_CLI_VERSION ); if ( ! $update_type ) { continue; } // Release is older than one we already have on file. if ( ! empty( $updates[ $update_type ] ) && ! Comparator::greaterThan( $release_version, $updates[ $update_type ]['version'] ) ) { continue; } $package_url = null; $manifest_data = null; foreach ( $release->assets as $asset ) { if ( ! isset( $asset->browser_download_url ) ) { continue; } if ( substr( $asset->browser_download_url, - strlen( '.phar' ) ) === '.phar' ) { $package_url = $asset->browser_download_url; } // The manifest.json file, if it exists, contains information about PHP version requirements and similar. if ( substr( $asset->browser_download_url, - strlen( 'manifest.json' ) ) === 'manifest.json' ) { $response = Utils\http_request( 'GET', $asset->browser_download_url, null, $headers, $options ); if ( $response->success ) { $manifest_data = json_decode( $response->body ); } } } if ( ! $package_url ) { continue; } // Release requires a newer version of PHP. if ( isset( $manifest_data->requires_php ) && ! Comparator::greaterThanOrEqualTo( PHP_VERSION, $manifest_data->requires_php ) ) { $updates_unavailable[] = [ 'version' => $release_version, 'update_type' => $update_type, 'package_url' => $release->assets[0]->browser_download_url, 'status' => 'unavailable', 'requires_php' => $manifest_data->requires_php, ]; } else { $updates[ $update_type ] = [ 'version' => $release_version, 'update_type' => $update_type, 'package_url' => $release->assets[0]->browser_download_url, 'status' => 'available', 'requires_php' => isset( $manifest_data->requires_php ) ? $manifest_data->requires_php : '', ]; } } foreach ( $updates as $type => $value ) { if ( empty( $value ) ) { unset( $updates[ $type ] ); } } foreach ( [ 'major', 'minor', 'patch' ] as $type ) { if ( true === Utils\get_flag_value( $assoc_args, $type ) ) { return ! empty( $updates[ $type ] ) ? [ $updates[ $type ] ] : false; } } if ( empty( $updates ) && preg_match( '#-alpha-(.+)$#', WP_CLI_VERSION, $matches ) ) { $version_url = 'https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/NIGHTLY_VERSION'; $response = Utils\http_request( 'GET', $version_url, null, [], $options ); if ( ! $response->success || 200 !== $response->status_code ) { WP_CLI::error( sprintf( 'Failed to get current nightly version (HTTP code %d)', $response->status_code ) ); } $nightly_version = trim( $response->body ); if ( WP_CLI_VERSION !== $nightly_version ) { $manifest_data = null; // The manifest.json file, if it exists, contains information about PHP version requirements and similar. $response = Utils\http_request( 'GET', 'https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli-nightly.manifest.json', null, $headers, $options ); if ( $response->success ) { $manifest_data = json_decode( $response->body ); } // Release requires a newer version of PHP. if ( isset( $manifest_data->requires_php ) && ! Comparator::greaterThanOrEqualTo( PHP_VERSION, $manifest_data->requires_php ) ) { $updates_unavailable[] = [ 'version' => $nightly_version, 'update_type' => 'nightly', 'package_url' => 'https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli-nightly.phar', 'status' => 'unvailable', 'requires_php' => $manifest_data->requires_php, ]; } else { $updates['nightly'] = [ 'version' => $nightly_version, 'update_type' => 'nightly', 'package_url' => 'https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli-nightly.phar', 'status' => 'available', 'requires_php' => isset( $manifest_data->requires_php ) ? $manifest_data->requires_php : '', ]; } } } return array_merge( $updates_unavailable, array_values( $updates ) ); } /** * Returns the the first element of the passed array for which the * callback returns true. * * Polyfill for the `array_find()` function introduced in PHP 8.3. * * @param array $arr Array to search. * @param callable $callback The callback function for each element in the array. * @return mixed First array element for which the callback returns true, null otherwise. */ private function array_find( $arr, $callback ) { if ( function_exists( '\array_find' ) ) { // phpcs:ignore PHPCompatibility.FunctionUse.NewFunctions.array_findFound return \array_find( $arr, $callback ); } foreach ( $arr as $key => $value ) { if ( $callback( $value, $key ) ) { return $value; } } return null; } /** * Dumps the list of global parameters, as JSON or in var_export format. * * ## OPTIONS * * [--with-values] * : Display current values also. * * [--format=] * : Render output in a particular format. * --- * default: json * options: * - var_export * - json * --- * * ## EXAMPLES * * # Dump the list of global parameters. * $ wp cli param-dump --format=var_export * array ( * 'path' => * array ( * 'runtime' => '=', * 'file' => '', * 'synopsis' => '', * 'default' => NULL, * 'multiple' => false, * 'desc' => 'Path to the WordPress files.', * ), * 'url' => * array ( * * @subcommand param-dump */ public function param_dump( $_, $assoc_args ) { $spec = WP_CLI::get_configurator()->get_spec(); if ( Utils\get_flag_value( $assoc_args, 'with-values' ) ) { $config = WP_CLI::get_configurator()->to_array(); // Copy current config values to $spec. foreach ( $spec as $key => $value ) { $current = null; if ( isset( $config[0][ $key ] ) ) { $current = $config[0][ $key ]; } $spec[ $key ]['current'] = $current; } } if ( 'var_export' === Utils\get_flag_value( $assoc_args, 'format' ) ) { var_export( $spec ); } else { echo json_encode( $spec ); } } /** * Dumps the list of installed commands, as JSON. * * ## EXAMPLES * * # Dump the list of installed commands. * $ wp cli cmd-dump * {"name":"wp","description":"Manage WordPress through the command-line.","longdesc":"\n\n## GLOBAL PARAMETERS\n\n --path=\n Path to the WordPress files.\n\n --ssh=\n Perform operation against a remote server over SSH (or a container using scheme of "docker" or "docker-compose").\n\n --url=\n Pretend request came from given URL. In multisite, this argument is how the target site is specified. \n\n --user=\n * * @subcommand cmd-dump */ public function cmd_dump() { echo json_encode( $this->command_to_array( WP_CLI::get_root_command() ) ); } /** * Generates tab completion strings. * * ## OPTIONS * * --line= * : The current command line to be executed. * * --point= * : The index to the current cursor position relative to the beginning of the command. * * ## EXAMPLES * * # Generate tab completion strings. * $ wp cli completions --line='wp eva' --point=100 * eval * eval-file */ public function completions( $_, $assoc_args ) { $line = substr( $assoc_args['line'], 0, $assoc_args['point'] ); $compl = new Completions( $line ); $compl->render(); } /** * Get a string representing the type of update being checked for. */ private function get_update_type_str( $assoc_args ) { $update_type = ' '; foreach ( [ 'major', 'minor', 'patch' ] as $type ) { if ( true === Utils\get_flag_value( $assoc_args, $type ) ) { $update_type = ' ' . $type . ' '; break; } } return $update_type; } /** * Detects if a command exists * * This commands checks if a command is registered with WP-CLI. * If the command is found then it returns with exit status 0. * If the command doesn't exist, then it will exit with status 1. * * ## OPTIONS * ... * : The command * * ## EXAMPLES * * # The "site delete" command is registered. * $ wp cli has-command "site delete" * $ echo $? * 0 * * # The "foo bar" command is not registered. * $ wp cli has-command "foo bar" * $ echo $? * 1 * * # Install a WP-CLI package if not already installed * $ if ! $(wp cli has-command doctor); then wp package install wp-cli/doctor-command; fi * Installing package wp-cli/doctor-command (dev-main || dev-master || dev-trunk) * Updating /home/person/.wp-cli/packages/composer.json to require the package... * Using Composer to install the package... * --- * Success: Package installed. * * @subcommand has-command * * @when after_wp_load */ public function has_command( $_, $assoc_args ) { // If command is input as a string, then explode it into array. $command = explode( ' ', implode( ' ', $_ ) ); WP_CLI::halt( is_array( WP_CLI::get_runner()->find_command_to_run( $command ) ) ? 0 : 1 ); } } ...] * : Get help on a specific command. * * ## EXAMPLES * * # get help for `core` command * wp help core * * # get help for `core download` subcommand * wp help core download */ public function __invoke( $args, $assoc_args ) { $r = WP_CLI::get_runner()->find_command_to_run( $args ); if ( is_array( $r ) ) { list( $command ) = $r; self::show_help( $command ); exit; } } private static function show_help( $command ) { $out = self::get_initial_markdown( $command ); // Remove subcommands if in columns - will wordwrap separately. $subcommands = ''; $column_subpattern = '[ \t]+[^\t]+\t+'; if ( preg_match( '/(^## SUBCOMMANDS[^\n]*\n+' . $column_subpattern . '.+?)(?:^##|\z)/ms', $out, $matches, PREG_OFFSET_CAPTURE ) ) { $subcommands = $matches[1][0]; $subcommands_header = "## SUBCOMMANDS\n"; $out = substr_replace( $out, $subcommands_header, $matches[1][1], strlen( $subcommands ) ); } $out .= self::parse_reference_links( $command->get_longdesc() ); // Definition lists. $out = preg_replace_callback( '/([^\n]+)\n: (.+?)(\n\n|$)/s', [ __CLASS__, 'rewrap_param_desc' ], $out ); // Ensure lines with no leading whitespace that aren't section headers are indented. $out = preg_replace( '/^((?! |\t|##).)/m', "\t$1", $out ); $tab = str_repeat( ' ', 2 ); // Need to de-tab for wordwrapping to work properly. $out = str_replace( "\t", $tab, $out ); $wordwrap_width = Shell::columns(); // Wordwrap with indent. $out = preg_replace_callback( '/^( *)([^\n]+)\n/m', function ( $matches ) use ( $wordwrap_width ) { return $matches[1] . str_replace( "\n", "\n{$matches[1]}", wordwrap( $matches[2], $wordwrap_width - strlen( $matches[1] ) ) ) . "\n"; }, $out ); if ( $subcommands ) { // Wordwrap with column indent. $subcommands = preg_replace_callback( '/^(' . $column_subpattern . ')([^\n]+)\n/m', function ( $matches ) use ( $wordwrap_width, $tab ) { // Need to de-tab for wordwrapping to work properly. $matches[1] = str_replace( "\t", $tab, $matches[1] ); $matches[2] = str_replace( "\t", $tab, $matches[2] ); $padding_len = strlen( $matches[1] ); $padding = str_repeat( ' ', $padding_len ); return $matches[1] . str_replace( "\n", "\n$padding", wordwrap( $matches[2], $wordwrap_width - $padding_len ) ) . "\n"; }, $subcommands ); // Put subcommands back. $out = str_replace( $subcommands_header, $subcommands, $out ); } // Section headers. $out = preg_replace( '/^## ([A-Z ]+)/m', WP_CLI::colorize( '%9\1%n' ), $out ); self::pass_through_pager( $out ); } private static function rewrap_param_desc( $matches ) { $param = $matches[1]; $desc = self::indent( "\t\t", $matches[2] ); return "\t$param\n$desc\n\n"; } private static function indent( $whitespace, $text ) { $lines = explode( "\n", $text ); foreach ( $lines as &$line ) { $line = $whitespace . $line; } return implode( "\n", $lines ); } private static function pass_through_pager( $out ) { if ( ! Utils\check_proc_available( null /*context*/, true /*return*/ ) ) { WP_CLI::line( $out ); WP_CLI::debug( 'Warning: check_proc_available() failed in pass_through_pager().', 'help' ); return -1; } $pager = getenv( 'PAGER' ); if ( false === $pager ) { $pager = Utils\is_windows() ? 'more' : 'less -R'; } // For Windows 7 need to set code page to something other than Unicode (65001) to get around "Not enough memory." error with `more.com` on PHP 7.1+. if ( 'more' === $pager && defined( 'PHP_WINDOWS_VERSION_MAJOR' ) && PHP_WINDOWS_VERSION_MAJOR < 10 && function_exists( 'sapi_windows_cp_set' ) ) { // Note will also apply to Windows 8 (see https://msdn.microsoft.com/en-us/library/windows/desktop/ms724832.aspx) but probably harmless anyway. $cp = getenv( 'WP_CLI_WINDOWS_CODE_PAGE' ) ?: 1252; // Code page 1252 is the most used so probably the most compat. // phpcs:ignore PHPCompatibility.FunctionUse.NewFunctions -- Wrapped in function_exists() call. sapi_windows_cp_set( $cp ); // `sapi_windows_cp_set()` introduced PHP 7.1. } // Convert string to file handle. $fd = fopen( 'php://temp', 'r+b' ); fwrite( $fd, $out ); rewind( $fd ); $descriptorspec = [ 0 => $fd, 1 => STDOUT, 2 => STDERR, ]; return proc_close( Utils\proc_open_compat( $pager, $descriptorspec, $pipes ) ); } private static function get_initial_markdown( $command ) { $name = implode( ' ', Dispatcher\get_path( $command ) ); $binding = [ 'name' => $name, 'shortdesc' => $command->get_shortdesc(), ]; $binding['synopsis'] = "$name " . $command->get_synopsis(); $alias = $command->get_alias(); if ( $alias ) { $binding['alias'] = $alias; } $hook_name = $command->get_hook(); $hook_description = $hook_name ? Utils\get_hook_description( $hook_name ) : null; if ( $hook_description && 'after_wp_load' !== $hook_name ) { if ( $command->can_have_subcommands() ) { $binding['shortdesc'] .= "\n\nUnless overridden, these commands run on the '$hook_name' hook, $hook_description"; } else { $binding['shortdesc'] .= "\n\nThis command runs on the '$hook_name' hook, $hook_description"; } } if ( $command->can_have_subcommands() ) { $binding['has-subcommands']['subcommands'] = self::render_subcommands( $command ); } return Utils\mustache_render( 'man.mustache', $binding ); } private static function render_subcommands( $command ) { $subcommands = []; foreach ( $command->get_subcommands() as $subcommand ) { if ( WP_CLI::get_runner()->is_command_disabled( $subcommand ) ) { continue; } $subcommands[ $subcommand->get_name() ] = $subcommand->get_shortdesc(); } $max_len = self::get_max_len( array_keys( $subcommands ) ); $lines = []; foreach ( $subcommands as $name => $desc ) { $lines[] = str_pad( $name, $max_len ) . "\t\t\t" . $desc; } return $lines; } private static function get_max_len( $strings ) { $max_len = 0; foreach ( $strings as $str ) { $len = strlen( $str ); if ( $len > $max_len ) { $max_len = $len; } } return $max_len; } /** * Parse reference links from longdescription. * * @param string $longdesc The longdescription from the `$command->get_longdesc()`. * @return string The longdescription which has links as footnote. */ private static function parse_reference_links( $longdesc ) { $description = ''; foreach ( explode( "\n", $longdesc ) as $line ) { if ( 0 === strpos( $line, '#' ) ) { break; } $description .= $line . "\n"; } // Fires if it has description text at the head of `$longdesc`. if ( $description ) { $links = []; // An array of URLs from the description. $pattern = '/\[.+?\]$(https?:\/\/.+?)$/'; $newdesc = preg_replace_callback( $pattern, function ( $matches ) use ( &$links ) { static $count = 0; $count++; $links[] = $matches[1]; return str_replace( '(' . $matches[1] . ')', '[' . $count . ']', $matches[0] ); }, $description ); $footnote = ''; $link_count = count( $links ); for ( $i = 0; $i < $link_count; $i++ ) { $n = $i + 1; $footnote .= '[' . $n . '] ' . $links[ $i ] . "\n"; } if ( $footnote ) { $newdesc = trim( $newdesc ) . "\n\n---\n" . $footnote; $longdesc = str_replace( trim( $description ), trim( $newdesc ), $longdesc ); } } return $longdesc; } } */ class SymfonyClassCollectionLoader { private static $loaded; const HEADER = <<<'EOS' \s*$/'), '', file_get_contents($r->getFileName())); } $cache = $cacheDir . '/' . $name . $extension; $header = sprintf(self::HEADER, date('Y')); self::writeCacheFile($cache, $header . substr(self::stripComments(' true, self::PRAGMA_BLOCKS => true, self::PRAGMA_ANCHORED_DOT => true, self::PRAGMA_DYNAMIC_NAMES => true, ); // Template cache private $templates = array(); // Environment private $templateClassPrefix = '__Mustache_'; private $cache; private $lambdaCache; private $cacheLambdaTemplates = false; private $loader; private $partialsLoader; private $helpers; private $escape; private $entityFlags = ENT_COMPAT; private $charset = 'UTF-8'; private $logger; private $strictCallables = false; private $pragmas = array(); private $delimiters; private $buggyPropertyShadowing = false; // Services private $tokenizer; private $parser; private $compiler; /** * Mustache class constructor. * * Passing an $options array allows overriding certain Mustache options during instantiation: * * $options = array( * // The class prefix for compiled templates. Defaults to '__Mustache_'. * 'template_class_prefix' => '__MyTemplates_', * * // A Mustache cache instance or a cache directory string for compiled templates. * // Mustache will not cache templates unless this is set. * 'cache' => dirname(__FILE__).'/tmp/cache/mustache', * * // Override default permissions for cache files. Defaults to using the system-defined umask. It is * // *strongly* recommended that you configure your umask properly rather than overriding permissions here. * 'cache_file_mode' => 0666, * * // Optionally, enable caching for lambda section templates. This is generally not recommended, as lambda * // sections are often too dynamic to benefit from caching. * 'cache_lambda_templates' => true, * * // Customize the tag delimiters used by this engine instance. Note that overriding here changes the * // delimiters used to parse all templates and partials loaded by this instance. To override just for a * // single template, use an inline "change delimiters" tag at the start of the template file: * // * // {{=<% %>=}} * // * 'delimiters' => '<% %>', * * // A Mustache template loader instance. Uses a StringLoader if not specified. * 'loader' => new Mustache_Loader_FilesystemLoader(dirname(__FILE__).'/views'), * * // A Mustache loader instance for partials. * 'partials_loader' => new Mustache_Loader_FilesystemLoader(dirname(__FILE__).'/views/partials'), * * // An array of Mustache partials. Useful for quick-and-dirty string template loading, but not as * // efficient or lazy as a Filesystem (or database) loader. * 'partials' => array('foo' => file_get_contents(dirname(__FILE__).'/views/partials/foo.mustache')), * * // An array of 'helpers'. Helpers can be global variables or objects, closures (e.g. for higher order * // sections), or any other valid Mustache context value. They will be prepended to the context stack, * // so they will be available in any template loaded by this Mustache instance. * 'helpers' => array('i18n' => function ($text) { * // do something translatey here... * }), * * // An 'escape' callback, responsible for escaping double-mustache variables. * 'escape' => function ($value) { * return htmlspecialchars($buffer, ENT_COMPAT, 'UTF-8'); * }, * * // Type argument for `htmlspecialchars`. Defaults to ENT_COMPAT. You may prefer ENT_QUOTES. * 'entity_flags' => ENT_QUOTES, * * // Character set for `htmlspecialchars`. Defaults to 'UTF-8'. Use 'UTF-8'. * 'charset' => 'ISO-8859-1', * * // A Mustache Logger instance. No logging will occur unless this is set. Using a PSR-3 compatible * // logging library -- such as Monolog -- is highly recommended. A simple stream logger implementation is * // available as well: * 'logger' => new Mustache_Logger_StreamLogger('php://stderr'), * * // Only treat Closure instances and invokable classes as callable. If true, values like * // `array('ClassName', 'methodName')` and `array($classInstance, 'methodName')`, which are traditionally * // "callable" in PHP, are not called to resolve variables for interpolation or section contexts. This * // helps protect against arbitrary code execution when user input is passed directly into the template. * // This currently defaults to false, but will default to true in v3.0. * 'strict_callables' => true, * * // Enable pragmas across all templates, regardless of the presence of pragma tags in the individual * // templates. * 'pragmas' => [Mustache_Engine::PRAGMA_FILTERS], * ); * * @throws Mustache_Exception_InvalidArgumentException If `escape` option is not callable * * @param array $options (default: array()) */ public function __construct(array $options = array()) { if (isset($options['template_class_prefix'])) { if ((string) $options['template_class_prefix'] === '') { throw new Mustache_Exception_InvalidArgumentException('Mustache Constructor "template_class_prefix" must not be empty'); } $this->templateClassPrefix = $options['template_class_prefix']; } if (isset($options['cache'])) { $cache = $options['cache']; if (is_string($cache)) { $mode = isset($options['cache_file_mode']) ? $options['cache_file_mode'] : null; $cache = new Mustache_Cache_FilesystemCache($cache, $mode); } $this->setCache($cache); } if (isset($options['cache_lambda_templates'])) { $this->cacheLambdaTemplates = (bool) $options['cache_lambda_templates']; } if (isset($options['loader'])) { $this->setLoader($options['loader']); } if (isset($options['partials_loader'])) { $this->setPartialsLoader($options['partials_loader']); } if (isset($options['partials'])) { $this->setPartials($options['partials']); } if (isset($options['helpers'])) { $this->setHelpers($options['helpers']); } if (isset($options['escape'])) { if (!is_callable($options['escape'])) { throw new Mustache_Exception_InvalidArgumentException('Mustache Constructor "escape" option must be callable'); } $this->escape = $options['escape']; } if (isset($options['entity_flags'])) { $this->entityFlags = $options['entity_flags']; } if (isset($options['charset'])) { $this->charset = $options['charset']; } if (isset($options['logger'])) { $this->setLogger($options['logger']); } if (isset($options['strict_callables'])) { $this->strictCallables = $options['strict_callables']; } if (isset($options['delimiters'])) { $this->delimiters = $options['delimiters']; } if (isset($options['pragmas'])) { foreach ($options['pragmas'] as $pragma) { if (!isset(self::$knownPragmas[$pragma])) { throw new Mustache_Exception_InvalidArgumentException(sprintf('Unknown pragma: "%s".', $pragma)); } $this->pragmas[$pragma] = true; } } if (isset($options['buggy_property_shadowing'])) { $this->buggyPropertyShadowing = (bool) $options['buggy_property_shadowing']; } } /** * Shortcut 'render' invocation. * * Equivalent to calling `$mustache->loadTemplate($template)->render($context);` * * @see Mustache_Engine::loadTemplate * @see Mustache_Template::render * * @param string $template * @param mixed $context (default: array()) * * @return string Rendered template */ public function render($template, $context = array()) { return $this->loadTemplate($template)->render($context); } /** * Get the current Mustache escape callback. * * @return callable|null */ public function getEscape() { return $this->escape; } /** * Get the current Mustache entitity type to escape. * * @return int */ public function getEntityFlags() { return $this->entityFlags; } /** * Get the current Mustache character set. * * @return string */ public function getCharset() { return $this->charset; } /** * Check whether to use buggy property shadowing. * * See https://github.com/bobthecow/mustache.php/pull/410 */ public function useBuggyPropertyShadowing() { return $this->buggyPropertyShadowing; } /** * Get the current globally enabled pragmas. * * @return array */ public function getPragmas() { return array_keys($this->pragmas); } /** * Set the Mustache template Loader instance. * * @param Mustache_Loader $loader */ public function setLoader(Mustache_Loader $loader) { $this->loader = $loader; } /** * Get the current Mustache template Loader instance. * * If no Loader instance has been explicitly specified, this method will instantiate and return * a StringLoader instance. * * @return Mustache_Loader */ public function getLoader() { if (!isset($this->loader)) { $this->loader = new Mustache_Loader_StringLoader(); } return $this->loader; } /** * Set the Mustache partials Loader instance. * * @param Mustache_Loader $partialsLoader */ public function setPartialsLoader(Mustache_Loader $partialsLoader) { $this->partialsLoader = $partialsLoader; } /** * Get the current Mustache partials Loader instance. * * If no Loader instance has been explicitly specified, this method will instantiate and return * an ArrayLoader instance. * * @return Mustache_Loader */ public function getPartialsLoader() { if (!isset($this->partialsLoader)) { $this->partialsLoader = new Mustache_Loader_ArrayLoader(); } return $this->partialsLoader; } /** * Set partials for the current partials Loader instance. * * @throws Mustache_Exception_RuntimeException If the current Loader instance is immutable * * @param array $partials (default: array()) */ public function setPartials(array $partials = array()) { if (!isset($this->partialsLoader)) { $this->partialsLoader = new Mustache_Loader_ArrayLoader(); } if (!$this->partialsLoader instanceof Mustache_Loader_MutableLoader) { throw new Mustache_Exception_RuntimeException('Unable to set partials on an immutable Mustache Loader instance'); } $this->partialsLoader->setTemplates($partials); } /** * Set an array of Mustache helpers. * * An array of 'helpers'. Helpers can be global variables or objects, closures (e.g. for higher order sections), or * any other valid Mustache context value. They will be prepended to the context stack, so they will be available in * any template loaded by this Mustache instance. * * @throws Mustache_Exception_InvalidArgumentException if $helpers is not an array or Traversable * * @param array|Traversable $helpers */ public function setHelpers($helpers) { if (!is_array($helpers) && !$helpers instanceof Traversable) { throw new Mustache_Exception_InvalidArgumentException('setHelpers expects an array of helpers'); } $this->getHelpers()->clear(); foreach ($helpers as $name => $helper) { $this->addHelper($name, $helper); } } /** * Get the current set of Mustache helpers. * * @see Mustache_Engine::setHelpers * * @return Mustache_HelperCollection */ public function getHelpers() { if (!isset($this->helpers)) { $this->helpers = new Mustache_HelperCollection(); } return $this->helpers; } /** * Add a new Mustache helper. * * @see Mustache_Engine::setHelpers * * @param string $name * @param mixed $helper */ public function addHelper($name, $helper) { $this->getHelpers()->add($name, $helper); } /** * Get a Mustache helper by name. * * @see Mustache_Engine::setHelpers * * @param string $name * * @return mixed Helper */ public function getHelper($name) { return $this->getHelpers()->get($name); } /** * Check whether this Mustache instance has a helper. * * @see Mustache_Engine::setHelpers * * @param string $name * * @return bool True if the helper is present */ public function hasHelper($name) { return $this->getHelpers()->has($name); } /** * Remove a helper by name. * * @see Mustache_Engine::setHelpers * * @param string $name */ public function removeHelper($name) { $this->getHelpers()->remove($name); } /** * Set the Mustache Logger instance. * * @throws Mustache_Exception_InvalidArgumentException If logger is not an instance of Mustache_Logger or Psr\Log\LoggerInterface * * @param Mustache_Logger|Psr\Log\LoggerInterface $logger */ public function setLogger($logger = null) { if ($logger !== null && !($logger instanceof Mustache_Logger || is_a($logger, 'Psr\\Log\\LoggerInterface'))) { throw new Mustache_Exception_InvalidArgumentException('Expected an instance of Mustache_Logger or Psr\\Log\\LoggerInterface.'); } if ($this->getCache()->getLogger() === null) { $this->getCache()->setLogger($logger); } $this->logger = $logger; } /** * Get the current Mustache Logger instance. * * @return Mustache_Logger|Psr\Log\LoggerInterface */ public function getLogger() { return $this->logger; } /** * Set the Mustache Tokenizer instance. * * @param Mustache_Tokenizer $tokenizer */ public function setTokenizer(Mustache_Tokenizer $tokenizer) { $this->tokenizer = $tokenizer; } /** * Get the current Mustache Tokenizer instance. * * If no Tokenizer instance has been explicitly specified, this method will instantiate and return a new one. * * @return Mustache_Tokenizer */ public function getTokenizer() { if (!isset($this->tokenizer)) { $this->tokenizer = new Mustache_Tokenizer(); } return $this->tokenizer; } /** * Set the Mustache Parser instance. * * @param Mustache_Parser $parser */ public function setParser(Mustache_Parser $parser) { $this->parser = $parser; } /** * Get the current Mustache Parser instance. * * If no Parser instance has been explicitly specified, this method will instantiate and return a new one. * * @return Mustache_Parser */ public function getParser() { if (!isset($this->parser)) { $this->parser = new Mustache_Parser(); } return $this->parser; } /** * Set the Mustache Compiler instance. * * @param Mustache_Compiler $compiler */ public function setCompiler(Mustache_Compiler $compiler) { $this->compiler = $compiler; } /** * Get the current Mustache Compiler instance. * * If no Compiler instance has been explicitly specified, this method will instantiate and return a new one. * * @return Mustache_Compiler */ public function getCompiler() { if (!isset($this->compiler)) { $this->compiler = new Mustache_Compiler(); } return $this->compiler; } /** * Set the Mustache Cache instance. * * @param Mustache_Cache $cache */ public function setCache(Mustache_Cache $cache) { if (isset($this->logger) && $cache->getLogger() === null) { $cache->setLogger($this->getLogger()); } $this->cache = $cache; } /** * Get the current Mustache Cache instance. * * If no Cache instance has been explicitly specified, this method will instantiate and return a new one. * * @return Mustache_Cache */ public function getCache() { if (!isset($this->cache)) { $this->setCache(new Mustache_Cache_NoopCache()); } return $this->cache; } /** * Get the current Lambda Cache instance. * * If 'cache_lambda_templates' is enabled, this is the default cache instance. Otherwise, it is a NoopCache. * * @see Mustache_Engine::getCache * * @return Mustache_Cache */ protected function getLambdaCache() { if ($this->cacheLambdaTemplates) { return $this->getCache(); } if (!isset($this->lambdaCache)) { $this->lambdaCache = new Mustache_Cache_NoopCache(); } return $this->lambdaCache; } /** * Helper method to generate a Mustache template class. * * This method must be updated any time options are added which make it so * the same template could be parsed and compiled multiple different ways. * * @param string|Mustache_Source $source * * @return string Mustache Template class name */ public function getTemplateClassName($source) { // For the most part, adding a new option here should do the trick. // // Pick a value here which is unique for each possible way the template // could be compiled... but not necessarily unique per option value. See // escape below, which only needs to differentiate between 'custom' and // 'default' escapes. // // Keep this list in alphabetical order :) $chunks = array( 'charset' => $this->charset, 'delimiters' => $this->delimiters ? $this->delimiters : '{{ }}', 'entityFlags' => $this->entityFlags, 'escape' => isset($this->escape) ? 'custom' : 'default', 'key' => ($source instanceof Mustache_Source) ? $source->getKey() : 'source', 'pragmas' => $this->getPragmas(), 'strictCallables' => $this->strictCallables, 'version' => self::VERSION, ); $key = json_encode($chunks); // Template Source instances have already provided their own source key. For strings, just include the whole // source string in the md5 hash. if (!$source instanceof Mustache_Source) { $key .= "\n" . $source; } return $this->templateClassPrefix . md5($key); } /** * Load a Mustache Template by name. * * @param string $name * * @return Mustache_Template */ public function loadTemplate($name) { return $this->loadSource($this->getLoader()->load($name)); } /** * Load a Mustache partial Template by name. * * This is a helper method used internally by Template instances for loading partial templates. You can most likely * ignore it completely. * * @param string $name * * @return Mustache_Template */ public function loadPartial($name) { try { if (isset($this->partialsLoader)) { $loader = $this->partialsLoader; } elseif (isset($this->loader) && !$this->loader instanceof Mustache_Loader_StringLoader) { $loader = $this->loader; } else { throw new Mustache_Exception_UnknownTemplateException($name); } return $this->loadSource($loader->load($name)); } catch (Mustache_Exception_UnknownTemplateException $e) { // If the named partial cannot be found, log then return null. $this->log( Mustache_Logger::WARNING, 'Partial not found: "{name}"', array('name' => $e->getTemplateName()) ); } } /** * Load a Mustache lambda Template by source. * * This is a helper method used by Template instances to generate subtemplates for Lambda sections. You can most * likely ignore it completely. * * @param string $source * @param string $delims (default: null) * * @return Mustache_Template */ public function loadLambda($source, $delims = null) { if ($delims !== null) { $source = $delims . "\n" . $source; } return $this->loadSource($source, $this->getLambdaCache()); } /** * Instantiate and return a Mustache Template instance by source. * * Optionally provide a Mustache_Cache instance. This is used internally by Mustache_Engine::loadLambda to respect * the 'cache_lambda_templates' configuration option. * * @see Mustache_Engine::loadTemplate * @see Mustache_Engine::loadPartial * @see Mustache_Engine::loadLambda * * @param string|Mustache_Source $source * @param Mustache_Cache $cache (default: null) * * @return Mustache_Template */ private function loadSource($source, $cache = null) { $className = $this->getTemplateClassName($source); if (!isset($this->templates[$className])) { if ($cache === null || ! $cache instanceof Mustache_Cache) { $cache = $this->getCache(); } if (!class_exists($className, false)) { if (!$cache->load($className)) { $compiled = $this->compile($source); $cache->cache($className, $compiled); } } $this->log( Mustache_Logger::DEBUG, 'Instantiating template: "{className}"', array('className' => $className) ); $this->templates[$className] = new $className($this); } return $this->templates[$className]; } /** * Helper method to tokenize a Mustache template. * * @see Mustache_Tokenizer::scan * * @param string $source * * @return array Tokens */ private function tokenize($source) { return $this->getTokenizer()->scan($source, $this->delimiters); } /** * Helper method to parse a Mustache template. * * @see Mustache_Parser::parse * * @param string $source * * @return array Token tree */ private function parse($source) { $parser = $this->getParser(); $parser->setPragmas($this->getPragmas()); return $parser->parse($this->tokenize($source)); } /** * Helper method to compile a Mustache template. * * @see Mustache_Compiler::compile * * @param string|Mustache_Source $source * * @return string generated Mustache template class code */ private function compile($source) { $name = $this->getTemplateClassName($source); $this->log( Mustache_Logger::INFO, 'Compiling template to "{className}" class', array('className' => $name) ); if ($source instanceof Mustache_Source) { $source = $source->getSource(); } $tree = $this->parse($source); $compiler = $this->getCompiler(); $compiler->setPragmas($this->getPragmas()); return $compiler->compile($source, $tree, $name, isset($this->escape), $this->charset, $this->strictCallables, $this->entityFlags); } /** * Add a log record if logging is enabled. * * @param int $level The logging level * @param string $message The log message * @param array $context The log context */ private function log($level, $message, array $context = array()) { if (isset($this->logger)) { $this->logger->log($level, $message, $context); } } } filterName = $filterName; $message = sprintf('Unknown filter: %s', $filterName); if (version_compare(PHP_VERSION, '5.3.0', '>=')) { parent::__construct($message, 0, $previous); } else { parent::__construct($message); // @codeCoverageIgnore } } public function getFilterName() { return $this->filterName; } } helperName = $helperName; $message = sprintf('Unknown helper: %s', $helperName); if (version_compare(PHP_VERSION, '5.3.0', '>=')) { parent::__construct($message, 0, $previous); } else { parent::__construct($message); // @codeCoverageIgnore } } public function getHelperName() { return $this->helperName; } } token = $token; if (version_compare(PHP_VERSION, '5.3.0', '>=')) { parent::__construct($msg, 0, $previous); } else { parent::__construct($msg); // @codeCoverageIgnore } } /** * @return array */ public function getToken() { return $this->token; } } templateName = $templateName; $message = sprintf('Unknown template: %s', $templateName); if (version_compare(PHP_VERSION, '5.3.0', '>=')) { parent::__construct($message, 0, $previous); } else { parent::__construct($message); // @codeCoverageIgnore } } public function getTemplateName() { return $this->templateName; } } lineNum = -1; $this->lineTokens = 0; $this->pragmas = $this->defaultPragmas; $this->pragmaFilters = isset($this->pragmas[Mustache_Engine::PRAGMA_FILTERS]); $this->pragmaBlocks = isset($this->pragmas[Mustache_Engine::PRAGMA_BLOCKS]); $this->pragmaDynamicNames = isset($this->pragmas[Mustache_Engine::PRAGMA_DYNAMIC_NAMES]); return $this->buildTree($tokens); } /** * Enable pragmas across all templates, regardless of the presence of pragma * tags in the individual templates. * * @internal Users should set global pragmas in Mustache_Engine, not here :) * * @param string[] $pragmas */ public function setPragmas(array $pragmas) { $this->pragmas = array(); foreach ($pragmas as $pragma) { $this->enablePragma($pragma); } $this->defaultPragmas = $this->pragmas; } /** * Helper method for recursively building a parse tree. * * @throws Mustache_Exception_SyntaxException when nesting errors or mismatched section tags are encountered * * @param array &$tokens Set of Mustache tokens * @param array $parent Parent token (default: null) * * @return array Mustache Token parse tree */ private function buildTree(array &$tokens, $parent = null) { $nodes = array(); while (!empty($tokens)) { $token = array_shift($tokens); if ($token[Mustache_Tokenizer::LINE] === $this->lineNum) { $this->lineTokens++; } else { $this->lineNum = $token[Mustache_Tokenizer::LINE]; $this->lineTokens = 0; } if ($token[Mustache_Tokenizer::TYPE] !== Mustache_Tokenizer::T_COMMENT) { if ($this->pragmaDynamicNames && isset($token[Mustache_Tokenizer::NAME])) { list($name, $isDynamic) = $this->getDynamicName($token); if ($isDynamic) { $token[Mustache_Tokenizer::NAME] = $name; $token[Mustache_Tokenizer::DYNAMIC] = true; } } if ($this->pragmaFilters && isset($token[Mustache_Tokenizer::NAME])) { list($name, $filters) = $this->getNameAndFilters($token[Mustache_Tokenizer::NAME]); if (!empty($filters)) { $token[Mustache_Tokenizer::NAME] = $name; $token[Mustache_Tokenizer::FILTERS] = $filters; } } } switch ($token[Mustache_Tokenizer::TYPE]) { case Mustache_Tokenizer::T_DELIM_CHANGE: $this->checkIfTokenIsAllowedInParent($parent, $token); $this->clearStandaloneLines($nodes, $tokens); break; case Mustache_Tokenizer::T_SECTION: case Mustache_Tokenizer::T_INVERTED: $this->checkIfTokenIsAllowedInParent($parent, $token); $this->clearStandaloneLines($nodes, $tokens); $nodes[] = $this->buildTree($tokens, $token); break; case Mustache_Tokenizer::T_END_SECTION: if (!isset($parent)) { $msg = sprintf( 'Unexpected closing tag: /%s on line %d', $token[Mustache_Tokenizer::NAME], $token[Mustache_Tokenizer::LINE] ); throw new Mustache_Exception_SyntaxException($msg, $token); } $sameName = $token[Mustache_Tokenizer::NAME] !== $parent[Mustache_Tokenizer::NAME]; $tokenDynamic = isset($token[Mustache_Tokenizer::DYNAMIC]) && $token[Mustache_Tokenizer::DYNAMIC]; $parentDynamic = isset($parent[Mustache_Tokenizer::DYNAMIC]) && $parent[Mustache_Tokenizer::DYNAMIC]; if ($sameName || ($tokenDynamic !== $parentDynamic)) { $msg = sprintf( 'Nesting error: %s%s (on line %d) vs. %s%s (on line %d)', $parentDynamic ? '*' : '', $parent[Mustache_Tokenizer::NAME], $parent[Mustache_Tokenizer::LINE], $tokenDynamic ? '*' : '', $token[Mustache_Tokenizer::NAME], $token[Mustache_Tokenizer::LINE] ); throw new Mustache_Exception_SyntaxException($msg, $token); } $this->clearStandaloneLines($nodes, $tokens); $parent[Mustache_Tokenizer::END] = $token[Mustache_Tokenizer::INDEX]; $parent[Mustache_Tokenizer::NODES] = $nodes; return $parent; case Mustache_Tokenizer::T_PARTIAL: $this->checkIfTokenIsAllowedInParent($parent, $token); //store the whitespace prefix for laters! if ($indent = $this->clearStandaloneLines($nodes, $tokens)) { $token[Mustache_Tokenizer::INDENT] = $indent[Mustache_Tokenizer::VALUE]; } $nodes[] = $token; break; case Mustache_Tokenizer::T_PARENT: $this->checkIfTokenIsAllowedInParent($parent, $token); $nodes[] = $this->buildTree($tokens, $token); break; case Mustache_Tokenizer::T_BLOCK_VAR: if ($this->pragmaBlocks) { // BLOCKS pragma is enabled, let's do this! if (isset($parent) && $parent[Mustache_Tokenizer::TYPE] === Mustache_Tokenizer::T_PARENT) { $token[Mustache_Tokenizer::TYPE] = Mustache_Tokenizer::T_BLOCK_ARG; } $this->clearStandaloneLines($nodes, $tokens); $nodes[] = $this->buildTree($tokens, $token); } else { // pretend this was just a normal "escaped" token... $token[Mustache_Tokenizer::TYPE] = Mustache_Tokenizer::T_ESCAPED; // TODO: figure out how to figure out if there was a space after this dollar: $token[Mustache_Tokenizer::NAME] = '$' . $token[Mustache_Tokenizer::NAME]; $nodes[] = $token; } break; case Mustache_Tokenizer::T_PRAGMA: $this->enablePragma($token[Mustache_Tokenizer::NAME]); // no break case Mustache_Tokenizer::T_COMMENT: $this->clearStandaloneLines($nodes, $tokens); $nodes[] = $token; break; default: $nodes[] = $token; break; } } if (isset($parent)) { $msg = sprintf( 'Missing closing tag: %s opened on line %d', $parent[Mustache_Tokenizer::NAME], $parent[Mustache_Tokenizer::LINE] ); throw new Mustache_Exception_SyntaxException($msg, $parent); } return $nodes; } /** * Clear standalone line tokens. * * Returns a whitespace token for indenting partials, if applicable. * * @param array $nodes Parsed nodes * @param array $tokens Tokens to be parsed * * @return array|null Resulting indent token, if any */ private function clearStandaloneLines(array &$nodes, array &$tokens) { if ($this->lineTokens > 1) { // this is the third or later node on this line, so it can't be standalone return; } $prev = null; if ($this->lineTokens === 1) { // this is the second node on this line, so it can't be standalone // unless the previous node is whitespace. if ($prev = end($nodes)) { if (!$this->tokenIsWhitespace($prev)) { return; } } } if ($next = reset($tokens)) { // If we're on a new line, bail. if ($next[Mustache_Tokenizer::LINE] !== $this->lineNum) { return; } // If the next token isn't whitespace, bail. if (!$this->tokenIsWhitespace($next)) { return; } if (count($tokens) !== 1) { // Unless it's the last token in the template, the next token // must end in newline for this to be standalone. if (substr($next[Mustache_Tokenizer::VALUE], -1) !== "\n") { return; } } // Discard the whitespace suffix array_shift($tokens); } if ($prev) { // Return the whitespace prefix, if any return array_pop($nodes); } } /** * Check whether token is a whitespace token. * * True if token type is T_TEXT and value is all whitespace characters. * * @param array $token * * @return bool True if token is a whitespace token */ private function tokenIsWhitespace(array $token) { if ($token[Mustache_Tokenizer::TYPE] === Mustache_Tokenizer::T_TEXT) { return preg_match('/^\s*$/', $token[Mustache_Tokenizer::VALUE]); } return false; } /** * Check whether a token is allowed inside a parent tag. * * @throws Mustache_Exception_SyntaxException if an invalid token is found inside a parent tag * * @param array|null $parent * @param array $token */ private function checkIfTokenIsAllowedInParent($parent, array $token) { if (isset($parent) && $parent[Mustache_Tokenizer::TYPE] === Mustache_Tokenizer::T_PARENT) { throw new Mustache_Exception_SyntaxException('Illegal content in < parent tag', $token); } } /** * Parse dynamic names. * * @throws Mustache_Exception_SyntaxException when a tag does not allow * * @throws Mustache_Exception_SyntaxException on multiple *s, or dots or filters with * */ private function getDynamicName(array $token) { $name = $token[Mustache_Tokenizer::NAME]; $isDynamic = false; if (preg_match('/^\s*\*\s*/', $name)) { $this->ensureTagAllowsDynamicNames($token); $name = preg_replace('/^\s*\*\s*/', '', $name); $isDynamic = true; } return array($name, $isDynamic); } /** * Check whether the given token supports dynamic tag names. * * @throws Mustache_Exception_SyntaxException when a tag does not allow * * * @param array $token */ private function ensureTagAllowsDynamicNames(array $token) { switch ($token[Mustache_Tokenizer::TYPE]) { case Mustache_Tokenizer::T_PARTIAL: case Mustache_Tokenizer::T_PARENT: case Mustache_Tokenizer::T_END_SECTION: return; } $msg = sprintf( 'Invalid dynamic name: %s in %s tag', $token[Mustache_Tokenizer::NAME], Mustache_Tokenizer::getTagName($token[Mustache_Tokenizer::TYPE]) ); throw new Mustache_Exception_SyntaxException($msg, $token); } /** * Split a tag name into name and filters. * * @param string $name * * @return array [Tag name, Array of filters] */ private function getNameAndFilters($name) { $filters = array_map('trim', explode('|', $name)); $name = array_shift($filters); return array($name, $filters); } /** * Enable a pragma. * * @param string $name */ private function enablePragma($name) { $this->pragmas[$name] = true; switch ($name) { case Mustache_Engine::PRAGMA_BLOCKS: $this->pragmaBlocks = true; break; case Mustache_Engine::PRAGMA_FILTERS: $this->pragmaFilters = true; break; case Mustache_Engine::PRAGMA_DYNAMIC_NAMES: $this->pragmaDynamicNames = true; break; } } } load('foo'); // equivalent to `file_get_contents(dirname(__FILE__).'/views/foo.mustache'); * * This is probably the most useful Mustache Loader implementation. It can be used for partials and normal Templates: * * $m = new Mustache(array( * 'loader' => new Mustache_Loader_FilesystemLoader(dirname(__FILE__).'/views'), * 'partials_loader' => new Mustache_Loader_FilesystemLoader(dirname(__FILE__).'/views/partials'), * )); */ class Mustache_Loader_FilesystemLoader implements Mustache_Loader { private $baseDir; private $extension = '.mustache'; private $templates = array(); /** * Mustache filesystem Loader constructor. * * Passing an $options array allows overriding certain Loader options during instantiation: * * $options = array( * // The filename extension used for Mustache templates. Defaults to '.mustache' * 'extension' => '.ms', * ); * * @throws Mustache_Exception_RuntimeException if $baseDir does not exist * * @param string $baseDir Base directory containing Mustache template files * @param array $options Array of Loader options (default: array()) */ public function __construct($baseDir, array $options = array()) { $this->baseDir = $baseDir; if (strpos($this->baseDir, '://') === false) { $this->baseDir = realpath($this->baseDir); } if ($this->shouldCheckPath() && !is_dir($this->baseDir)) { throw new Mustache_Exception_RuntimeException(sprintf('FilesystemLoader baseDir must be a directory: %s', $baseDir)); } if (array_key_exists('extension', $options)) { if (empty($options['extension'])) { $this->extension = ''; } else { $this->extension = '.' . ltrim($options['extension'], '.'); } } } /** * Load a Template by name. * * $loader = new Mustache_Loader_FilesystemLoader(dirname(__FILE__).'/views'); * $loader->load('admin/dashboard'); // loads "./views/admin/dashboard.mustache"; * * @param string $name * * @return string Mustache Template source */ public function load($name) { if (!isset($this->templates[$name])) { $this->templates[$name] = $this->loadFile($name); } return $this->templates[$name]; } /** * Helper function for loading a Mustache file by name. * * @throws Mustache_Exception_UnknownTemplateException If a template file is not found * * @param string $name * * @return string Mustache Template source */ protected function loadFile($name) { $fileName = $this->getFileName($name); if ($this->shouldCheckPath() && !file_exists($fileName)) { throw new Mustache_Exception_UnknownTemplateException($name); } return file_get_contents($fileName); } /** * Helper function for getting a Mustache template file name. * * @param string $name * * @return string Template file name */ protected function getFileName($name) { $fileName = $this->baseDir . '/' . $name; if (substr($fileName, 0 - strlen($this->extension)) !== $this->extension) { $fileName .= $this->extension; } return $fileName; } /** * Only check if baseDir is a directory and requested templates are files if * baseDir is using the filesystem stream wrapper. * * @return bool Whether to check `is_dir` and `file_exists` */ protected function shouldCheckPath() { return strpos($this->baseDir, '://') === false || strpos($this->baseDir, 'file://') === 0; } } '{{ bar }}', * 'baz' => 'Hey {{ qux }}!' * ); * * $tpl = $loader->load('foo'); // '{{ bar }}' * * The ArrayLoader is used internally as a partials loader by Mustache_Engine instance when an array of partials * is set. It can also be used as a quick-and-dirty Template loader. */ class Mustache_Loader_ArrayLoader implements Mustache_Loader, Mustache_Loader_MutableLoader { private $templates; /** * ArrayLoader constructor. * * @param array $templates Associative array of Template source (default: array()) */ public function __construct(array $templates = array()) { $this->templates = $templates; } /** * Load a Template. * * @throws Mustache_Exception_UnknownTemplateException If a template file is not found * * @param string $name * * @return string Mustache Template source */ public function load($name) { if (!isset($this->templates[$name])) { throw new Mustache_Exception_UnknownTemplateException($name); } return $this->templates[$name]; } /** * Set an associative array of Template sources for this loader. * * @param array $templates */ public function setTemplates(array $templates) { $this->templates = $templates; } /** * Set a Template source by name. * * @param string $name * @param string $template Mustache Template source */ public function setTemplate($name, $template) { $this->templates[$name] = $template; } } loaders = array(); foreach ($loaders as $loader) { $this->addLoader($loader); } } /** * Add a Loader instance. * * @param Mustache_Loader $loader */ public function addLoader(Mustache_Loader $loader) { $this->loaders[] = $loader; } /** * Load a Template by name. * * @throws Mustache_Exception_UnknownTemplateException If a template file is not found * * @param string $name * * @return string Mustache Template source */ public function load($name) { foreach ($this->loaders as $loader) { try { return $loader->load($name); } catch (Mustache_Exception_UnknownTemplateException $e) { // do nothing, check the next loader. } } throw new Mustache_Exception_UnknownTemplateException($name); } } load('{{ foo }}'); // '{{ foo }}' * * This is the default Template Loader instance used by Mustache: * * $m = new Mustache; * $tpl = $m->loadTemplate('{{ foo }}'); * echo $tpl->render(array('foo' => 'bar')); // "bar" */ class Mustache_Loader_StringLoader implements Mustache_Loader { /** * Load a Template by source. * * @param string $name Mustache Template source * * @return string Mustache Template source */ public function load($name) { return $name; } } load('hello'); * $goodbye = $loader->load('goodbye'); * * __halt_compiler(); * * @@ hello * Hello, {{ planet }}! * * @@ goodbye * Goodbye, cruel {{ planet }} * * Templates are deliniated by lines containing only `@@ name`. * * The InlineLoader is well-suited to micro-frameworks such as Silex: * * $app->register(new MustacheServiceProvider, array( * 'mustache.loader' => new Mustache_Loader_InlineLoader(__FILE__, __COMPILER_HALT_OFFSET__) * )); * * $app->get('/{name}', function ($name) use ($app) { * return $app['mustache']->render('hello', compact('name')); * }) * ->value('name', 'world'); * * // ... * * __halt_compiler(); * * @@ hello * Hello, {{ name }}! */ class Mustache_Loader_InlineLoader implements Mustache_Loader { protected $fileName; protected $offset; protected $templates; /** * The InlineLoader requires a filename and offset to process templates. * * The magic constants `__FILE__` and `__COMPILER_HALT_OFFSET__` are usually * perfectly suited to the job: * * $loader = new Mustache_Loader_InlineLoader(__FILE__, __COMPILER_HALT_OFFSET__); * * Note that this only works if the loader is instantiated inside the same * file as the inline templates. If the templates are located in another * file, it would be necessary to manually specify the filename and offset. * * @param string $fileName The file to parse for inline templates * @param int $offset A string offset for the start of the templates. * This usually coincides with the `__halt_compiler` * call, and the `__COMPILER_HALT_OFFSET__` */ public function __construct($fileName, $offset) { if (!is_file($fileName)) { throw new Mustache_Exception_InvalidArgumentException('InlineLoader expects a valid filename.'); } if (!is_int($offset) || $offset < 0) { throw new Mustache_Exception_InvalidArgumentException('InlineLoader expects a valid file offset.'); } $this->fileName = $fileName; $this->offset = $offset; } /** * Load a Template by name. * * @throws Mustache_Exception_UnknownTemplateException If a template file is not found * * @param string $name * * @return string Mustache Template source */ public function load($name) { $this->loadTemplates(); if (!array_key_exists($name, $this->templates)) { throw new Mustache_Exception_UnknownTemplateException($name); } return $this->templates[$name]; } /** * Parse and load templates from the end of a source file. */ protected function loadTemplates() { if ($this->templates === null) { $this->templates = array(); $data = file_get_contents($this->fileName, false, null, $this->offset); foreach (preg_split("/^@@(?= [\w\d\.]+$)/m", $data, -1) as $chunk) { if (trim($chunk)) { list($name, $content) = explode("\n", $chunk, 2); $this->templates[trim($name)] = trim($content); } } } } } '.ms', * 'stat_props' => array('size', 'mtime'), * ); * * Specifying 'stat_props' overrides the stat properties used to invalidate the template cache. By default, this * uses 'mtime' and 'size', but this can be set to any of the properties supported by stat(): * * http://php.net/manual/en/function.stat.php * * You can also disable filesystem stat entirely: * * $options = array('stat_props' => null); * * But with great power comes great responsibility. Namely, if you disable stat-based cache invalidation, * YOU MUST CLEAR THE TEMPLATE CACHE YOURSELF when your templates change. Make it part of your build or deploy * process so you don't forget! * * @throws Mustache_Exception_RuntimeException if $baseDir does not exist. * * @param string $baseDir Base directory containing Mustache template files. * @param array $options Array of Loader options (default: array()) */ public function __construct($baseDir, array $options = array()) { parent::__construct($baseDir, $options); if (array_key_exists('stat_props', $options)) { if (empty($options['stat_props'])) { $this->statProps = array(); } else { $this->statProps = $options['stat_props']; } } else { $this->statProps = array('size', 'mtime'); } } /** * Helper function for loading a Mustache file by name. * * @throws Mustache_Exception_UnknownTemplateException If a template file is not found. * * @param string $name * * @return Mustache_Source Mustache Template source */ protected function loadFile($name) { $fileName = $this->getFileName($name); if (!file_exists($fileName)) { throw new Mustache_Exception_UnknownTemplateException($name); } return new Mustache_Source_FilesystemSource($fileName, $this->statProps); } } log( Mustache_Logger::WARNING, 'Template cache disabled, evaluating "{className}" class at runtime', array('className' => $key) ); eval('?>' . $value); } } cache($className, $compiledSource); * * The FilesystemCache benefits from any opcode caching that may be setup in your environment. So do that, k? */ class Mustache_Cache_FilesystemCache extends Mustache_Cache_AbstractCache { private $baseDir; private $fileMode; /** * Filesystem cache constructor. * * @param string $baseDir Directory for compiled templates * @param int $fileMode Override default permissions for cache files. Defaults to using the system-defined umask */ public function __construct($baseDir, $fileMode = null) { $this->baseDir = $baseDir; $this->fileMode = $fileMode; } /** * Load the class from cache using `require_once`. * * @param string $key * * @return bool */ public function load($key) { $fileName = $this->getCacheFilename($key); if (!is_file($fileName)) { return false; } require_once $fileName; return true; } /** * Cache and load the compiled class. * * @param string $key * @param string $value */ public function cache($key, $value) { $fileName = $this->getCacheFilename($key); $this->log( Mustache_Logger::DEBUG, 'Writing to template cache: "{fileName}"', array('fileName' => $fileName) ); $this->writeFile($fileName, $value); $this->load($key); } /** * Build the cache filename. * Subclasses should override for custom cache directory structures. * * @param string $name * * @return string */ protected function getCacheFilename($name) { return sprintf('%s/%s.php', $this->baseDir, $name); } /** * Create cache directory. * * @throws Mustache_Exception_RuntimeException If unable to create directory * * @param string $fileName * * @return string */ private function buildDirectoryForFilename($fileName) { $dirName = dirname($fileName); if (!is_dir($dirName)) { $this->log( Mustache_Logger::INFO, 'Creating Mustache template cache directory: "{dirName}"', array('dirName' => $dirName) ); @mkdir($dirName, 0777, true); // @codeCoverageIgnoreStart if (!is_dir($dirName)) { throw new Mustache_Exception_RuntimeException(sprintf('Failed to create cache directory "%s".', $dirName)); } // @codeCoverageIgnoreEnd } return $dirName; } /** * Write cache file. * * @throws Mustache_Exception_RuntimeException If unable to write file * * @param string $fileName * @param string $value */ private function writeFile($fileName, $value) { $dirName = $this->buildDirectoryForFilename($fileName); $this->log( Mustache_Logger::DEBUG, 'Caching compiled template to "{fileName}"', array('fileName' => $fileName) ); $tempFile = tempnam($dirName, basename($fileName)); if (false !== @file_put_contents($tempFile, $value)) { if (@rename($tempFile, $fileName)) { $mode = isset($this->fileMode) ? $this->fileMode : (0666 & ~umask()); @chmod($fileName, $mode); return; } // @codeCoverageIgnoreStart $this->log( Mustache_Logger::ERROR, 'Unable to rename Mustache temp cache file: "{tempName}" -> "{fileName}"', array('tempName' => $tempFile, 'fileName' => $fileName) ); // @codeCoverageIgnoreEnd } // @codeCoverageIgnoreStart throw new Mustache_Exception_RuntimeException(sprintf('Failed to write cache file "%s".', $fileName)); // @codeCoverageIgnoreEnd } } logger; } /** * Set a logger instance. * * @param Mustache_Logger|Psr\Log\LoggerInterface $logger */ public function setLogger($logger = null) { if ($logger !== null && !($logger instanceof Mustache_Logger || is_a($logger, 'Psr\\Log\\LoggerInterface'))) { throw new Mustache_Exception_InvalidArgumentException('Expected an instance of Mustache_Logger or Psr\\Log\\LoggerInterface.'); } $this->logger = $logger; } /** * Add a log record if logging is enabled. * * @param string $level The logging level * @param string $message The log message * @param array $context The log context */ protected function log($level, $message, array $context = array()) { if (isset($this->logger)) { $this->logger->log($level, $message, $context); } } } $helper` pairs. * * @throws Mustache_Exception_InvalidArgumentException if the $helpers argument isn't an array or Traversable * * @param array|Traversable $helpers (default: null) */ public function __construct($helpers = null) { if ($helpers === null) { return; } if (!is_array($helpers) && !$helpers instanceof Traversable) { throw new Mustache_Exception_InvalidArgumentException('HelperCollection constructor expects an array of helpers'); } foreach ($helpers as $name => $helper) { $this->add($name, $helper); } } /** * Magic mutator. * * @see Mustache_HelperCollection::add * * @param string $name * @param mixed $helper */ public function __set($name, $helper) { $this->add($name, $helper); } /** * Add a helper to this collection. * * @param string $name * @param mixed $helper */ public function add($name, $helper) { $this->helpers[$name] = $helper; } /** * Magic accessor. * * @see Mustache_HelperCollection::get * * @param string $name * * @return mixed Helper */ public function __get($name) { return $this->get($name); } /** * Get a helper by name. * * @throws Mustache_Exception_UnknownHelperException If helper does not exist * * @param string $name * * @return mixed Helper */ public function get($name) { if (!$this->has($name)) { throw new Mustache_Exception_UnknownHelperException($name); } return $this->helpers[$name]; } /** * Magic isset(). * * @see Mustache_HelperCollection::has * * @param string $name * * @return bool True if helper is present */ public function __isset($name) { return $this->has($name); } /** * Check whether a given helper is present in the collection. * * @param string $name * * @return bool True if helper is present */ public function has($name) { return array_key_exists($name, $this->helpers); } /** * Magic unset(). * * @see Mustache_HelperCollection::remove * * @param string $name */ public function __unset($name) { $this->remove($name); } /** * Check whether a given helper is present in the collection. * * @throws Mustache_Exception_UnknownHelperException if the requested helper is not present * * @param string $name */ public function remove($name) { if (!$this->has($name)) { throw new Mustache_Exception_UnknownHelperException($name); } unset($this->helpers[$name]); } /** * Clear the helper collection. * * Removes all helpers from this collection */ public function clear() { $this->helpers = array(); } /** * Check whether the helper collection is empty. * * @return bool True if the collection is empty */ public function isEmpty() { return empty($this->helpers); } } stack = array($context); } $this->buggyPropertyShadowing = $buggyPropertyShadowing; } /** * Push a new Context frame onto the stack. * * @param mixed $value Object or array to use for context */ public function push($value) { array_push($this->stack, $value); } /** * Push a new Context frame onto the block context stack. * * @param mixed $value Object or array to use for block context */ public function pushBlockContext($value) { array_push($this->blockStack, $value); } /** * Pop the last Context frame from the stack. * * @return mixed Last Context frame (object or array) */ public function pop() { return array_pop($this->stack); } /** * Pop the last block Context frame from the stack. * * @return mixed Last block Context frame (object or array) */ public function popBlockContext() { return array_pop($this->blockStack); } /** * Get the last Context frame. * * @return mixed Last Context frame (object or array) */ public function last() { return end($this->stack); } /** * Find a variable in the Context stack. * * Starting with the last Context frame (the context of the innermost section), and working back to the top-level * rendering context, look for a variable with the given name: * * * If the Context frame is an associative array which contains the key $id, returns the value of that element. * * If the Context frame is an object, this will check first for a public method, then a public property named * $id. Failing both of these, it will try `__isset` and `__get` magic methods. * * If a value named $id is not found in any Context frame, returns an empty string. * * @param string $id Variable name * * @return mixed Variable value, or '' if not found */ public function find($id) { return $this->findVariableInStack($id, $this->stack); } /** * Find a 'dot notation' variable in the Context stack. * * Note that dot notation traversal bubbles through scope differently than the regular find method. After finding * the initial chunk of the dotted name, each subsequent chunk is searched for only within the value of the previous * result. For example, given the following context stack: * * $data = array( * 'name' => 'Fred', * 'child' => array( * 'name' => 'Bob' * ), * ); * * ... and the Mustache following template: * * {{ child.name }} * * ... the `name` value is only searched for within the `child` value of the global Context, not within parent * Context frames. * * @param string $id Dotted variable selector * @param bool $strictCallables (default: false) * * @return mixed Variable value, or '' if not found */ public function findDot($id, $strictCallables = false) { $chunks = explode('.', $id); $first = array_shift($chunks); $value = $this->findVariableInStack($first, $this->stack); // This wasn't really a dotted name, so we can just return the value. if (empty($chunks)) { return $value; } foreach ($chunks as $chunk) { $isCallable = $strictCallables ? (is_object($value) && is_callable($value)) : (!is_string($value) && is_callable($value)); if ($isCallable) { $value = $value(); } elseif ($value === '') { return $value; } $value = $this->findVariableInStack($chunk, array($value)); } return $value; } /** * Find an 'anchored dot notation' variable in the Context stack. * * This is the same as findDot(), except it looks in the top of the context * stack for the first value, rather than searching the whole context stack * and starting from there. * * @see Mustache_Context::findDot * * @throws Mustache_Exception_InvalidArgumentException if given an invalid anchored dot $id * * @param string $id Dotted variable selector * * @return mixed Variable value, or '' if not found */ public function findAnchoredDot($id) { $chunks = explode('.', $id); $first = array_shift($chunks); if ($first !== '') { throw new Mustache_Exception_InvalidArgumentException(sprintf('Unexpected id for findAnchoredDot: %s', $id)); } $value = $this->last(); foreach ($chunks as $chunk) { if ($value === '') { return $value; } $value = $this->findVariableInStack($chunk, array($value)); } return $value; } /** * Find an argument in the block context stack. * * @param string $id * * @return mixed Variable value, or '' if not found */ public function findInBlock($id) { foreach ($this->blockStack as $context) { if (array_key_exists($id, $context)) { return $context[$id]; } } return ''; } /** * Helper function to find a variable in the Context stack. * * @see Mustache_Context::find * * @param string $id Variable name * @param array $stack Context stack * * @return mixed Variable value, or '' if not found */ private function findVariableInStack($id, array $stack) { for ($i = count($stack) - 1; $i >= 0; $i--) { $frame = &$stack[$i]; switch (gettype($frame)) { case 'object': if (!($frame instanceof Closure)) { // Note that is_callable() *will not work here* // See https://github.com/bobthecow/mustache.php/wiki/Magic-Methods if (method_exists($frame, $id)) { return $frame->$id(); } if (isset($frame->$id)) { return $frame->$id; } // Preserve backwards compatibility with a property shadowing bug in // Mustache.php <= 2.14.2 // See https://github.com/bobthecow/mustache.php/pull/410 if ($this->buggyPropertyShadowing) { if ($frame instanceof ArrayAccess && isset($frame[$id])) { return $frame[$id]; } } else { if (property_exists($frame, $id)) { $rp = new \ReflectionProperty($frame, $id); if ($rp->isPublic()) { return $frame->$id; } } if ($frame instanceof ArrayAccess && $frame->offsetExists($id)) { return $frame[$id]; } } } break; case 'array': if (array_key_exists($id, $frame)) { return $frame[$id]; } break; } } return ''; } } mustache = $mustache; } /** * Mustache Template instances can be treated as a function and rendered by simply calling them. * * $m = new Mustache_Engine; * $tpl = $m->loadTemplate('Hello, {{ name }}!'); * echo $tpl(array('name' => 'World')); // "Hello, World!" * * @see Mustache_Template::render * * @param mixed $context Array or object rendering context (default: array()) * * @return string Rendered template */ public function __invoke($context = array()) { return $this->render($context); } /** * Render this template given the rendering context. * * @param mixed $context Array or object rendering context (default: array()) * * @return string Rendered template */ public function render($context = array()) { return $this->renderInternal( $this->prepareContextStack($context) ); } /** * Internal rendering method implemented by Mustache Template concrete subclasses. * * This is where the magic happens :) * * NOTE: This method is not part of the Mustache.php public API. * * @param Mustache_Context $context * @param string $indent (default: '') * * @return string Rendered template */ abstract public function renderInternal(Mustache_Context $context, $indent = ''); /** * Tests whether a value should be iterated over (e.g. in a section context). * * In most languages there are two distinct array types: list and hash (or whatever you want to call them). Lists * should be iterated, hashes should be treated as objects. Mustache follows this paradigm for Ruby, Javascript, * Java, Python, etc. * * PHP, however, treats lists and hashes as one primitive type: array. So Mustache.php needs a way to distinguish * between between a list of things (numeric, normalized array) and a set of variables to be used as section context * (associative array). In other words, this will be iterated over: * * $items = array( * array('name' => 'foo'), * array('name' => 'bar'), * array('name' => 'baz'), * ); * * ... but this will be used as a section context block: * * $items = array( * 1 => array('name' => 'foo'), * 'banana' => array('name' => 'bar'), * 42 => array('name' => 'baz'), * ); * * @param mixed $value * * @return bool True if the value is 'iterable' */ protected function isIterable($value) { switch (gettype($value)) { case 'object': return $value instanceof Traversable; case 'array': $i = 0; foreach ($value as $k => $v) { if ($k !== $i++) { return false; } } return true; default: return false; } } /** * Helper method to prepare the Context stack. * * Adds the Mustache HelperCollection to the stack's top context frame if helpers are present. * * @param mixed $context Optional first context frame (default: null) * * @return Mustache_Context */ protected function prepareContextStack($context = null) { $stack = new Mustache_Context(null, $this->mustache->useBuggyPropertyShadowing()); $helpers = $this->mustache->getHelpers(); if (!$helpers->isEmpty()) { $stack->push($helpers); } if (!empty($context)) { $stack->push($context); } return $stack; } /** * Resolve a context value. * * Invoke the value if it is callable, otherwise return the value. * * @param mixed $value * @param Mustache_Context $context * * @return string */ protected function resolveValue($value, Mustache_Context $context) { if (($this->strictCallables ? is_object($value) : !is_string($value)) && is_callable($value)) { $result = call_user_func($value); if (is_string($result)) { return $this->mustache ->loadLambda($result) ->renderInternal($context); } return $result; } return $value; } } '; const T_PARENT = '<'; const T_DELIM_CHANGE = '='; const T_ESCAPED = '_v'; const T_UNESCAPED = '{'; const T_UNESCAPED_2 = '&'; const T_TEXT = '_t'; const T_PRAGMA = '%'; const T_BLOCK_VAR = '$'; const T_BLOCK_ARG = '$arg'; // Valid token types private static $tagTypes = array( self::T_SECTION => true, self::T_INVERTED => true, self::T_END_SECTION => true, self::T_COMMENT => true, self::T_PARTIAL => true, self::T_PARENT => true, self::T_DELIM_CHANGE => true, self::T_ESCAPED => true, self::T_UNESCAPED => true, self::T_UNESCAPED_2 => true, self::T_PRAGMA => true, self::T_BLOCK_VAR => true, ); private static $tagNames = array( self::T_SECTION => 'section', self::T_INVERTED => 'inverted section', self::T_END_SECTION => 'section end', self::T_COMMENT => 'comment', self::T_PARTIAL => 'partial', self::T_PARENT => 'parent', self::T_DELIM_CHANGE => 'set delimiter', self::T_ESCAPED => 'variable', self::T_UNESCAPED => 'unescaped variable', self::T_UNESCAPED_2 => 'unescaped variable', self::T_PRAGMA => 'pragma', self::T_BLOCK_VAR => 'block variable', self::T_BLOCK_ARG => 'block variable', ); // Token properties const TYPE = 'type'; const NAME = 'name'; const DYNAMIC = 'dynamic'; const OTAG = 'otag'; const CTAG = 'ctag'; const LINE = 'line'; const INDEX = 'index'; const END = 'end'; const INDENT = 'indent'; const NODES = 'nodes'; const VALUE = 'value'; const FILTERS = 'filters'; private $state; private $tagType; private $buffer; private $tokens; private $seenTag; private $line; private $otag; private $otagChar; private $otagLen; private $ctag; private $ctagChar; private $ctagLen; /** * Scan and tokenize template source. * * @throws Mustache_Exception_SyntaxException when mismatched section tags are encountered * @throws Mustache_Exception_InvalidArgumentException when $delimiters string is invalid * * @param string $text Mustache template source to tokenize * @param string $delimiters Optionally, pass initial opening and closing delimiters (default: empty string) * * @return array Set of Mustache tokens */ public function scan($text, $delimiters = '') { // Setting mbstring.func_overload makes things *really* slow. // Let's do everyone a favor and scan this string as ASCII instead. // // The INI directive was removed in PHP 8.0 so we don't need to check there (and can drop it // when we remove support for older versions of PHP). // // @codeCoverageIgnoreStart $encoding = null; if (version_compare(PHP_VERSION, '8.0.0', '<')) { if (function_exists('mb_internal_encoding') && ini_get('mbstring.func_overload') & 2) { $encoding = mb_internal_encoding(); mb_internal_encoding('ASCII'); } } // @codeCoverageIgnoreEnd $this->reset(); if (is_string($delimiters) && $delimiters = trim($delimiters)) { $this->setDelimiters($delimiters); } $len = strlen($text); for ($i = 0; $i < $len; $i++) { switch ($this->state) { case self::IN_TEXT: $char = $text[$i]; // Test whether it's time to change tags. if ($char === $this->otagChar && substr($text, $i, $this->otagLen) === $this->otag) { $i--; $this->flushBuffer(); $this->state = self::IN_TAG_TYPE; } else { $this->buffer .= $char; if ($char === "\n") { $this->flushBuffer(); $this->line++; } } break; case self::IN_TAG_TYPE: $i += $this->otagLen - 1; $char = $text[$i + 1]; if (isset(self::$tagTypes[$char])) { $tag = $char; $this->tagType = $tag; } else { $tag = null; $this->tagType = self::T_ESCAPED; } if ($this->tagType === self::T_DELIM_CHANGE) { $i = $this->changeDelimiters($text, $i); $this->state = self::IN_TEXT; } elseif ($this->tagType === self::T_PRAGMA) { $i = $this->addPragma($text, $i); $this->state = self::IN_TEXT; } else { if ($tag !== null) { $i++; } $this->state = self::IN_TAG; } $this->seenTag = $i; break; default: $char = $text[$i]; // Test whether it's time to change tags. if ($char === $this->ctagChar && substr($text, $i, $this->ctagLen) === $this->ctag) { $token = array( self::TYPE => $this->tagType, self::NAME => trim($this->buffer), self::OTAG => $this->otag, self::CTAG => $this->ctag, self::LINE => $this->line, self::INDEX => ($this->tagType === self::T_END_SECTION) ? $this->seenTag - $this->otagLen : $i + $this->ctagLen, ); if ($this->tagType === self::T_UNESCAPED) { // Clean up `{{{ tripleStache }}}` style tokens. if ($this->ctag === '}}') { if (($i + 2 < $len) && $text[$i + 2] === '}') { $i++; } else { $msg = sprintf( 'Mismatched tag delimiters: %s on line %d', $token[self::NAME], $token[self::LINE] ); throw new Mustache_Exception_SyntaxException($msg, $token); } } else { $lastName = $token[self::NAME]; if (substr($lastName, -1) === '}') { $token[self::NAME] = trim(substr($lastName, 0, -1)); } else { $msg = sprintf( 'Mismatched tag delimiters: %s on line %d', $token[self::NAME], $token[self::LINE] ); throw new Mustache_Exception_SyntaxException($msg, $token); } } } $this->buffer = ''; $i += $this->ctagLen - 1; $this->state = self::IN_TEXT; $this->tokens[] = $token; } else { $this->buffer .= $char; } break; } } if ($this->state !== self::IN_TEXT) { $this->throwUnclosedTagException(); } $this->flushBuffer(); // Restore the user's encoding... // @codeCoverageIgnoreStart if ($encoding) { mb_internal_encoding($encoding); } // @codeCoverageIgnoreEnd return $this->tokens; } /** * Helper function to reset tokenizer internal state. */ private function reset() { $this->state = self::IN_TEXT; $this->tagType = null; $this->buffer = ''; $this->tokens = array(); $this->seenTag = false; $this->line = 0; $this->otag = '{{'; $this->otagChar = '{'; $this->otagLen = 2; $this->ctag = '}}'; $this->ctagChar = '}'; $this->ctagLen = 2; } /** * Flush the current buffer to a token. */ private function flushBuffer() { if (strlen($this->buffer) > 0) { $this->tokens[] = array( self::TYPE => self::T_TEXT, self::LINE => $this->line, self::VALUE => $this->buffer, ); $this->buffer = ''; } } /** * Change the current Mustache delimiters. Set new `otag` and `ctag` values. * * @throws Mustache_Exception_SyntaxException when delimiter string is invalid * * @param string $text Mustache template source * @param int $index Current tokenizer index * * @return int New index value */ private function changeDelimiters($text, $index) { $startIndex = strpos($text, '=', $index) + 1; $close = '=' . $this->ctag; $closeIndex = strpos($text, $close, $index); if ($closeIndex === false) { $this->throwUnclosedTagException(); } $token = array( self::TYPE => self::T_DELIM_CHANGE, self::LINE => $this->line, ); try { $this->setDelimiters(trim(substr($text, $startIndex, $closeIndex - $startIndex))); } catch (Mustache_Exception_InvalidArgumentException $e) { throw new Mustache_Exception_SyntaxException($e->getMessage(), $token); } $this->tokens[] = $token; return $closeIndex + strlen($close) - 1; } /** * Set the current Mustache `otag` and `ctag` delimiters. * * @throws Mustache_Exception_InvalidArgumentException when delimiter string is invalid * * @param string $delimiters */ private function setDelimiters($delimiters) { if (!preg_match('/^\s*(\S+)\s+(\S+)\s*$/', $delimiters, $matches)) { throw new Mustache_Exception_InvalidArgumentException(sprintf('Invalid delimiters: %s', $delimiters)); } list($_, $otag, $ctag) = $matches; $this->otag = $otag; $this->otagChar = $otag[0]; $this->otagLen = strlen($otag); $this->ctag = $ctag; $this->ctagChar = $ctag[0]; $this->ctagLen = strlen($ctag); } /** * Add pragma token. * * Pragmas are hoisted to the front of the template, so all pragma tokens * will appear at the front of the token list. * * @param string $text * @param int $index * * @return int New index value */ private function addPragma($text, $index) { $end = strpos($text, $this->ctag, $index); if ($end === false) { $this->throwUnclosedTagException(); } $pragma = trim(substr($text, $index + 2, $end - $index - 2)); // Pragmas are hoisted to the front of the template. array_unshift($this->tokens, array( self::TYPE => self::T_PRAGMA, self::NAME => $pragma, self::LINE => 0, )); return $end + $this->ctagLen - 1; } private function throwUnclosedTagException() { $name = trim($this->buffer); if ($name !== '') { $msg = sprintf('Unclosed tag: %s on line %d', $name, $this->line); } else { $msg = sprintf('Unclosed tag on line %d', $this->line); } throw new Mustache_Exception_SyntaxException($msg, array( self::TYPE => $this->tagType, self::NAME => $name, self::OTAG => $this->otag, self::CTAG => $this->ctag, self::LINE => $this->line, self::INDEX => $this->seenTag - $this->otagLen, )); } /** * Get the human readable name for a tag type. * * @param string $tagType One of the tokenizer T_* constants * * @return string */ static function getTagName($tagType) { return isset(self::$tagNames[$tagType]) ? self::$tagNames[$tagType] : 'unknown'; } } log(Mustache_Logger::EMERGENCY, $message, $context); } /** * Action must be taken immediately. * * Example: Entire website down, database unavailable, etc. This should * trigger the SMS alerts and wake you up. * * @param string $message * @param array $context */ public function alert($message, array $context = array()) { $this->log(Mustache_Logger::ALERT, $message, $context); } /** * Critical conditions. * * Example: Application component unavailable, unexpected exception. * * @param string $message * @param array $context */ public function critical($message, array $context = array()) { $this->log(Mustache_Logger::CRITICAL, $message, $context); } /** * Runtime errors that do not require immediate action but should typically * be logged and monitored. * * @param string $message * @param array $context */ public function error($message, array $context = array()) { $this->log(Mustache_Logger::ERROR, $message, $context); } /** * Exceptional occurrences that are not errors. * * Example: Use of deprecated APIs, poor use of an API, undesirable things * that are not necessarily wrong. * * @param string $message * @param array $context */ public function warning($message, array $context = array()) { $this->log(Mustache_Logger::WARNING, $message, $context); } /** * Normal but significant events. * * @param string $message * @param array $context */ public function notice($message, array $context = array()) { $this->log(Mustache_Logger::NOTICE, $message, $context); } /** * Interesting events. * * Example: User logs in, SQL logs. * * @param string $message * @param array $context */ public function info($message, array $context = array()) { $this->log(Mustache_Logger::INFO, $message, $context); } /** * Detailed debug information. * * @param string $message * @param array $context */ public function debug($message, array $context = array()) { $this->log(Mustache_Logger::DEBUG, $message, $context); } } 100, self::INFO => 200, self::NOTICE => 250, self::WARNING => 300, self::ERROR => 400, self::CRITICAL => 500, self::ALERT => 550, self::EMERGENCY => 600, ); protected $level; protected $stream = null; protected $url = null; /** * @throws InvalidArgumentException if the logging level is unknown * * @param resource|string $stream Resource instance or URL * @param int $level The minimum logging level at which this handler will be triggered */ public function __construct($stream, $level = Mustache_Logger::ERROR) { $this->setLevel($level); if (is_resource($stream)) { $this->stream = $stream; } else { $this->url = $stream; } } /** * Close stream resources. */ public function __destruct() { if (is_resource($this->stream)) { fclose($this->stream); } } /** * Set the minimum logging level. * * @throws Mustache_Exception_InvalidArgumentException if the logging level is unknown * * @param int $level The minimum logging level which will be written */ public function setLevel($level) { if (!array_key_exists($level, self::$levels)) { throw new Mustache_Exception_InvalidArgumentException(sprintf('Unexpected logging level: %s', $level)); } $this->level = $level; } /** * Get the current minimum logging level. * * @return int */ public function getLevel() { return $this->level; } /** * Logs with an arbitrary level. * * @throws Mustache_Exception_InvalidArgumentException if the logging level is unknown * * @param mixed $level * @param string $message * @param array $context */ public function log($level, $message, array $context = array()) { if (!array_key_exists($level, self::$levels)) { throw new Mustache_Exception_InvalidArgumentException(sprintf('Unexpected logging level: %s', $level)); } if (self::$levels[$level] >= self::$levels[$this->level]) { $this->writeLog($level, $message, $context); } } /** * Write a record to the log. * * @throws Mustache_Exception_LogicException If neither a stream resource nor url is present * @throws Mustache_Exception_RuntimeException If the stream url cannot be opened * * @param int $level The logging level * @param string $message The log message * @param array $context The log context */ protected function writeLog($level, $message, array $context = array()) { if (!is_resource($this->stream)) { if (!isset($this->url)) { throw new Mustache_Exception_LogicException('Missing stream url, the stream can not be opened. This may be caused by a premature call to close().'); } $this->stream = fopen($this->url, 'a'); if (!is_resource($this->stream)) { // @codeCoverageIgnoreStart throw new Mustache_Exception_RuntimeException(sprintf('The stream or file "%s" could not be opened.', $this->url)); // @codeCoverageIgnoreEnd } } fwrite($this->stream, self::formatLine($level, $message, $context)); } /** * Gets the name of the logging level. * * @throws InvalidArgumentException if the logging level is unknown * * @param int $level * * @return string */ protected static function getLevelName($level) { return strtoupper($level); } /** * Format a log line for output. * * @param int $level The logging level * @param string $message The log message * @param array $context The log context * * @return string */ protected static function formatLine($level, $message, array $context = array()) { return sprintf( "%s: %s\n", self::getLevelName($level), self::interpolateMessage($message, $context) ); } /** * Interpolate context values into the message placeholders. * * @param string $message * @param array $context * * @return string */ protected static function interpolateMessage($message, array $context = array()) { if (strpos($message, '{') === false) { return $message; } // build a replacement array with braces around the context keys $replace = array(); foreach ($context as $key => $val) { $replace['{' . $key . '}'] = $val; } // interpolate replacement values into the the message and return return strtr($message, $replace); } } baseDir = $realDir; } else { $this->baseDir = $baseDir; } } /** * Register a new instance as an SPL autoloader. * * @param string $baseDir Mustache library base directory (default: dirname(__FILE__).'/..') * * @return Mustache_Autoloader Registered Autoloader instance */ public static function register($baseDir = null) { $key = $baseDir ? $baseDir : 0; if (!isset(self::$instances[$key])) { self::$instances[$key] = new self($baseDir); } $loader = self::$instances[$key]; spl_autoload_register(array($loader, 'autoload')); return $loader; } /** * Autoload Mustache classes. * * @param string $class */ public function autoload($class) { if ($class[0] === '\\') { $class = substr($class, 1); } if (strpos($class, 'Mustache') !== 0) { return; } $file = sprintf('%s/%s.php', $this->baseDir, str_replace('_', '/', $class)); if (is_file($file)) { require $file; } } } pragmas = $this->defaultPragmas; $this->sections = array(); $this->blocks = array(); $this->source = $source; $this->indentNextLine = true; $this->customEscape = $customEscape; $this->entityFlags = $entityFlags; $this->charset = $charset; $this->strictCallables = $strictCallables; return $this->writeCode($tree, $name); } /** * Enable pragmas across all templates, regardless of the presence of pragma * tags in the individual templates. * * @internal Users should set global pragmas in Mustache_Engine, not here :) * * @param string[] $pragmas */ public function setPragmas(array $pragmas) { $this->pragmas = array(); foreach ($pragmas as $pragma) { $this->pragmas[$pragma] = true; } $this->defaultPragmas = $this->pragmas; } /** * Helper function for walking the Mustache token parse tree. * * @throws Mustache_Exception_SyntaxException upon encountering unknown token types * * @param array $tree Parse tree of Mustache tokens * @param int $level (default: 0) * * @return string Generated PHP source code */ private function walk(array $tree, $level = 0) { $code = ''; $level++; foreach ($tree as $node) { switch ($node[Mustache_Tokenizer::TYPE]) { case Mustache_Tokenizer::T_PRAGMA: $this->pragmas[$node[Mustache_Tokenizer::NAME]] = true; break; case Mustache_Tokenizer::T_SECTION: $code .= $this->section( $node[Mustache_Tokenizer::NODES], $node[Mustache_Tokenizer::NAME], isset($node[Mustache_Tokenizer::FILTERS]) ? $node[Mustache_Tokenizer::FILTERS] : array(), $node[Mustache_Tokenizer::INDEX], $node[Mustache_Tokenizer::END], $node[Mustache_Tokenizer::OTAG], $node[Mustache_Tokenizer::CTAG], $level ); break; case Mustache_Tokenizer::T_INVERTED: $code .= $this->invertedSection( $node[Mustache_Tokenizer::NODES], $node[Mustache_Tokenizer::NAME], isset($node[Mustache_Tokenizer::FILTERS]) ? $node[Mustache_Tokenizer::FILTERS] : array(), $level ); break; case Mustache_Tokenizer::T_PARTIAL: $code .= $this->partial( $node[Mustache_Tokenizer::NAME], isset($node[Mustache_Tokenizer::DYNAMIC]) ? $node[Mustache_Tokenizer::DYNAMIC] : false, isset($node[Mustache_Tokenizer::INDENT]) ? $node[Mustache_Tokenizer::INDENT] : '', $level ); break; case Mustache_Tokenizer::T_PARENT: $code .= $this->parent( $node[Mustache_Tokenizer::NAME], isset($node[Mustache_Tokenizer::DYNAMIC]) ? $node[Mustache_Tokenizer::DYNAMIC] : false, isset($node[Mustache_Tokenizer::INDENT]) ? $node[Mustache_Tokenizer::INDENT] : '', $node[Mustache_Tokenizer::NODES], $level ); break; case Mustache_Tokenizer::T_BLOCK_ARG: $code .= $this->blockArg( $node[Mustache_Tokenizer::NODES], $node[Mustache_Tokenizer::NAME], $node[Mustache_Tokenizer::INDEX], $node[Mustache_Tokenizer::END], $node[Mustache_Tokenizer::OTAG], $node[Mustache_Tokenizer::CTAG], $level ); break; case Mustache_Tokenizer::T_BLOCK_VAR: $code .= $this->blockVar( $node[Mustache_Tokenizer::NODES], $node[Mustache_Tokenizer::NAME], $node[Mustache_Tokenizer::INDEX], $node[Mustache_Tokenizer::END], $node[Mustache_Tokenizer::OTAG], $node[Mustache_Tokenizer::CTAG], $level ); break; case Mustache_Tokenizer::T_COMMENT: break; case Mustache_Tokenizer::T_ESCAPED: case Mustache_Tokenizer::T_UNESCAPED: case Mustache_Tokenizer::T_UNESCAPED_2: $code .= $this->variable( $node[Mustache_Tokenizer::NAME], isset($node[Mustache_Tokenizer::FILTERS]) ? $node[Mustache_Tokenizer::FILTERS] : array(), $node[Mustache_Tokenizer::TYPE] === Mustache_Tokenizer::T_ESCAPED, $level ); break; case Mustache_Tokenizer::T_TEXT: $code .= $this->text($node[Mustache_Tokenizer::VALUE], $level); break; default: throw new Mustache_Exception_SyntaxException(sprintf('Unknown token type: %s', $node[Mustache_Tokenizer::TYPE]), $node); } } return $code; } const KLASS = 'lambdaHelper = new Mustache_LambdaHelper($this->mustache, $context); $buffer = \'\'; %s return $buffer; } %s %s }'; const KLASS_NO_LAMBDAS = 'walk($tree); $sections = implode("\n", $this->sections); $blocks = implode("\n", $this->blocks); $klass = empty($this->sections) && empty($this->blocks) ? self::KLASS_NO_LAMBDAS : self::KLASS; $callable = $this->strictCallables ? $this->prepare(self::STRICT_CALLABLE) : ''; return sprintf($this->prepare($klass, 0, false, true), $name, $callable, $code, $sections, $blocks); } const BLOCK_VAR = ' $blockFunction = $context->findInBlock(%s); if (is_callable($blockFunction)) { $buffer .= call_user_func($blockFunction, $context); %s} '; const BLOCK_VAR_ELSE = '} else {%s'; /** * Generate Mustache Template inheritance block variable PHP source. * * @param array $nodes Array of child tokens * @param string $id Section name * @param int $start Section start offset * @param int $end Section end offset * @param string $otag Current Mustache opening tag * @param string $ctag Current Mustache closing tag * @param int $level * * @return string Generated PHP source code */ private function blockVar($nodes, $id, $start, $end, $otag, $ctag, $level) { $id = var_export($id, true); $else = $this->walk($nodes, $level); if ($else !== '') { $else = sprintf($this->prepare(self::BLOCK_VAR_ELSE, $level + 1, false, true), $else); } return sprintf($this->prepare(self::BLOCK_VAR, $level), $id, $else); } const BLOCK_ARG = '%s => array($this, \'block%s\'),'; /** * Generate Mustache Template inheritance block argument PHP source. * * @param array $nodes Array of child tokens * @param string $id Section name * @param int $start Section start offset * @param int $end Section end offset * @param string $otag Current Mustache opening tag * @param string $ctag Current Mustache closing tag * @param int $level * * @return string Generated PHP source code */ private function blockArg($nodes, $id, $start, $end, $otag, $ctag, $level) { $key = $this->block($nodes); $id = var_export($id, true); return sprintf($this->prepare(self::BLOCK_ARG, $level), $id, $key); } const BLOCK_FUNCTION = ' public function block%s($context) { $indent = $buffer = \'\';%s return $buffer; } '; /** * Generate Mustache Template inheritance block function PHP source. * * @param array $nodes Array of child tokens * * @return string key of new block function */ private function block($nodes) { $code = $this->walk($nodes, 0); $key = ucfirst(md5($code)); if (!isset($this->blocks[$key])) { $this->blocks[$key] = sprintf($this->prepare(self::BLOCK_FUNCTION, 0), $key, $code); } return $key; } const SECTION_CALL = ' $value = $context->%s(%s%s);%s $buffer .= $this->section%s($context, $indent, $value); '; const SECTION = ' private function section%s(Mustache_Context $context, $indent, $value) { $buffer = \'\'; if (%s) { $source = %s; $value = call_user_func($value, $source, %s); if (is_string($value)) { if (strpos($value, \'{{\') === false) { return $value; } return $this->mustache ->loadLambda($value%s) ->renderInternal($context); } } if (!empty($value)) { $values = $this->isIterable($value) ? $value : array($value); foreach ($values as $value) { $context->push($value); %s $context->pop(); } } return $buffer; } '; /** * Generate Mustache Template section PHP source. * * @param array $nodes Array of child tokens * @param string $id Section name * @param string[] $filters Array of filters * @param int $start Section start offset * @param int $end Section end offset * @param string $otag Current Mustache opening tag * @param string $ctag Current Mustache closing tag * @param int $level * * @return string Generated section PHP source code */ private function section($nodes, $id, $filters, $start, $end, $otag, $ctag, $level) { $source = var_export(substr($this->source, $start, $end - $start), true); $callable = $this->getCallable(); if ($otag !== '{{' || $ctag !== '}}') { $delimTag = var_export(sprintf('{{= %s %s =}}', $otag, $ctag), true); $helper = sprintf('$this->lambdaHelper->withDelimiters(%s)', $delimTag); $delims = ', ' . $delimTag; } else { $helper = '$this->lambdaHelper'; $delims = ''; } $key = ucfirst(md5($delims . "\n" . $source)); if (!isset($this->sections[$key])) { $this->sections[$key] = sprintf($this->prepare(self::SECTION), $key, $callable, $source, $helper, $delims, $this->walk($nodes, 2)); } $method = $this->getFindMethod($id); $id = var_export($id, true); $findArg = $this->getFindMethodArgs($method); $filters = $this->getFilters($filters, $level); return sprintf($this->prepare(self::SECTION_CALL, $level), $method, $id, $findArg, $filters, $key); } const INVERTED_SECTION = ' $value = $context->%s(%s%s);%s if (empty($value)) { %s } '; /** * Generate Mustache Template inverted section PHP source. * * @param array $nodes Array of child tokens * @param string $id Section name * @param string[] $filters Array of filters * @param int $level * * @return string Generated inverted section PHP source code */ private function invertedSection($nodes, $id, $filters, $level) { $method = $this->getFindMethod($id); $id = var_export($id, true); $findArg = $this->getFindMethodArgs($method); $filters = $this->getFilters($filters, $level); return sprintf($this->prepare(self::INVERTED_SECTION, $level), $method, $id, $findArg, $filters, $this->walk($nodes, $level)); } const DYNAMIC_NAME = '$this->resolveValue($context->%s(%s%s), $context)'; /** * Generate Mustache Template dynamic name resolution PHP source. * * @param string $id Tag name * @param bool $dynamic True if the name is dynamic * * @return string Dynamic name resolution PHP source code */ private function resolveDynamicName($id, $dynamic) { if (!$dynamic) { return var_export($id, true); } $method = $this->getFindMethod($id); $id = ($method !== 'last') ? var_export($id, true) : ''; $findArg = $this->getFindMethodArgs($method); // TODO: filters? return sprintf(self::DYNAMIC_NAME, $method, $id, $findArg); } const PARTIAL_INDENT = ', $indent . %s'; const PARTIAL = ' if ($partial = $this->mustache->loadPartial(%s)) { $buffer .= $partial->renderInternal($context%s); } '; /** * Generate Mustache Template partial call PHP source. * * @param string $id Partial name * @param bool $dynamic Partial name is dynamic * @param string $indent Whitespace indent to apply to partial * @param int $level * * @return string Generated partial call PHP source code */ private function partial($id, $dynamic, $indent, $level) { if ($indent !== '') { $indentParam = sprintf(self::PARTIAL_INDENT, var_export($indent, true)); } else { $indentParam = ''; } return sprintf( $this->prepare(self::PARTIAL, $level), $this->resolveDynamicName($id, $dynamic), $indentParam ); } const PARENT = ' if ($parent = $this->mustache->loadPartial(%s)) { $context->pushBlockContext(array(%s )); $buffer .= $parent->renderInternal($context, $indent); $context->popBlockContext(); } '; const PARENT_NO_CONTEXT = ' if ($parent = $this->mustache->loadPartial(%s)) { $buffer .= $parent->renderInternal($context, $indent); } '; /** * Generate Mustache Template inheritance parent call PHP source. * * @param string $id Parent tag name * @param bool $dynamic Tag name is dynamic * @param string $indent Whitespace indent to apply to parent * @param array $children Child nodes * @param int $level * * @return string Generated PHP source code */ private function parent($id, $dynamic, $indent, array $children, $level) { $realChildren = array_filter($children, array(__CLASS__, 'onlyBlockArgs')); $partialName = $this->resolveDynamicName($id, $dynamic); if (empty($realChildren)) { return sprintf($this->prepare(self::PARENT_NO_CONTEXT, $level), $partialName); } return sprintf( $this->prepare(self::PARENT, $level), $partialName, $this->walk($realChildren, $level + 1) ); } /** * Helper method for filtering out non-block-arg tokens. * * @param array $node * * @return bool True if $node is a block arg token */ private static function onlyBlockArgs(array $node) { return $node[Mustache_Tokenizer::TYPE] === Mustache_Tokenizer::T_BLOCK_ARG; } const VARIABLE = ' $value = $this->resolveValue($context->%s(%s%s), $context);%s $buffer .= %s($value === null ? \'\' : %s); '; /** * Generate Mustache Template variable interpolation PHP source. * * @param string $id Variable name * @param string[] $filters Array of filters * @param bool $escape Escape the variable value for output? * @param int $level * * @return string Generated variable interpolation PHP source */ private function variable($id, $filters, $escape, $level) { $method = $this->getFindMethod($id); $id = ($method !== 'last') ? var_export($id, true) : ''; $findArg = $this->getFindMethodArgs($method); $filters = $this->getFilters($filters, $level); $value = $escape ? $this->getEscape() : '$value'; return sprintf($this->prepare(self::VARIABLE, $level), $method, $id, $findArg, $filters, $this->flushIndent(), $value); } const FILTER = ' $filter = $context->%s(%s%s); if (!(%s)) { throw new Mustache_Exception_UnknownFilterException(%s); } $value = call_user_func($filter, %s);%s '; const FILTER_FIRST_VALUE = '$this->resolveValue($value, $context)'; const FILTER_VALUE = '$value'; /** * Generate Mustache Template variable filtering PHP source. * * If the initial $value is a lambda it will be resolved before starting the filter chain. * * @param string[] $filters Array of filters * @param int $level * @param bool $first (default: false) * * @return string Generated filter PHP source */ private function getFilters(array $filters, $level, $first = true) { if (empty($filters)) { return ''; } $name = array_shift($filters); $method = $this->getFindMethod($name); $filter = ($method !== 'last') ? var_export($name, true) : ''; $findArg = $this->getFindMethodArgs($method); $callable = $this->getCallable('$filter'); $msg = var_export($name, true); $value = $first ? self::FILTER_FIRST_VALUE : self::FILTER_VALUE; return sprintf($this->prepare(self::FILTER, $level), $method, $filter, $findArg, $callable, $msg, $value, $this->getFilters($filters, $level, false)); } const LINE = '$buffer .= "\n";'; const TEXT = '$buffer .= %s%s;'; /** * Generate Mustache Template output Buffer call PHP source. * * @param string $text * @param int $level * * @return string Generated output Buffer call PHP source */ private function text($text, $level) { $indentNextLine = (substr($text, -1) === "\n"); $code = sprintf($this->prepare(self::TEXT, $level), $this->flushIndent(), var_export($text, true)); $this->indentNextLine = $indentNextLine; return $code; } /** * Prepare PHP source code snippet for output. * * @param string $text * @param int $bonus Additional indent level (default: 0) * @param bool $prependNewline Prepend a newline to the snippet? (default: true) * @param bool $appendNewline Append a newline to the snippet? (default: false) * * @return string PHP source code snippet */ private function prepare($text, $bonus = 0, $prependNewline = true, $appendNewline = false) { $text = ($prependNewline ? "\n" : '') . trim($text); if ($prependNewline) { $bonus++; } if ($appendNewline) { $text .= "\n"; } return preg_replace("/\n( {8})?/", "\n" . str_repeat(' ', $bonus * 4), $text); } const DEFAULT_ESCAPE = 'htmlspecialchars(%s, %s, %s)'; const CUSTOM_ESCAPE = 'call_user_func($this->mustache->getEscape(), %s)'; /** * Get the current escaper. * * @param string $value (default: '$value') * * @return string Either a custom callback, or an inline call to `htmlspecialchars` */ private function getEscape($value = '$value') { if ($this->customEscape) { return sprintf(self::CUSTOM_ESCAPE, $value); } return sprintf(self::DEFAULT_ESCAPE, $value, var_export($this->entityFlags, true), var_export($this->charset, true)); } /** * Select the appropriate Context `find` method for a given $id. * * The return value will be one of `find`, `findDot`, `findAnchoredDot` or `last`. * * @see Mustache_Context::find * @see Mustache_Context::findDot * @see Mustache_Context::last * * @param string $id Variable name * * @return string `find` method name */ private function getFindMethod($id) { if ($id === '.') { return 'last'; } if (isset($this->pragmas[Mustache_Engine::PRAGMA_ANCHORED_DOT]) && $this->pragmas[Mustache_Engine::PRAGMA_ANCHORED_DOT]) { if (substr($id, 0, 1) === '.') { return 'findAnchoredDot'; } } if (strpos($id, '.') === false) { return 'find'; } return 'findDot'; } /** * Get the args needed for a given find method. * * In this case, it's "true" iff it's a "find dot" method and strict callables is enabled. * * @param string $method Find method name */ private function getFindMethodArgs($method) { if (($method === 'findDot' || $method === 'findAnchoredDot') && $this->strictCallables) { return ', true'; } return ''; } const IS_CALLABLE = '!is_string(%s) && is_callable(%s)'; const STRICT_IS_CALLABLE = 'is_object(%s) && is_callable(%s)'; /** * Helper function to compile strict vs lax "is callable" logic. * * @param string $variable (default: '$value') * * @return string "is callable" logic */ private function getCallable($variable = '$value') { $tpl = $this->strictCallables ? self::STRICT_IS_CALLABLE : self::IS_CALLABLE; return sprintf($tpl, $variable, $variable); } const LINE_INDENT = '$indent . '; /** * Get the current $indent prefix to write to the buffer. * * @return string "$indent . " or "" */ private function flushIndent() { if (!$this->indentNextLine) { return ''; } $this->indentNextLine = false; return self::LINE_INDENT; } } fileName = $fileName; $this->statProps = $statProps; } /** * Get the Source key (used to generate the compiled class name). * * @throws Mustache_Exception_RuntimeException when a source file cannot be read * * @return string */ public function getKey() { $chunks = array( 'fileName' => $this->fileName, ); if (!empty($this->statProps)) { if (!isset($this->stat)) { $this->stat = @stat($this->fileName); } if ($this->stat === false) { throw new Mustache_Exception_RuntimeException(sprintf('Failed to read source file "%s".', $this->fileName)); } foreach ($this->statProps as $prop) { $chunks[$prop] = $this->stat[$prop]; } } return json_encode($chunks); } /** * Get the template Source. * * @return string */ public function getSource() { return file_get_contents($this->fileName); } } =}}`. (default: null) */ public function __construct(Mustache_Engine $mustache, Mustache_Context $context, $delims = null) { $this->mustache = $mustache; $this->context = $context; $this->delims = $delims; } /** * Render a string as a Mustache template with the current rendering context. * * @param string $string * * @return string Rendered template */ public function render($string) { return $this->mustache ->loadLambda((string) $string, $this->delims) ->renderInternal($this->context); } /** * Render a string as a Mustache template with the current rendering context. * * @param string $string * * @return string Rendered template */ public function __invoke($string) { return $this->render($string); } /** * Get a Lambda Helper with custom delimiters. * * @param string $delims Custom delimiters, in the format `{{= <% %> =}}` * * @return Mustache_LambdaHelper */ public function withDelimiters($delims) { return new self($this->mustache, $this->context, $delims); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process\Pipes; use Symfony\Component\Process\Process; /** * UnixPipes implementation uses unix pipes as handles. * * @author Romain Neutron * * @internal */ class UnixPipes extends AbstractPipes { private $ttyMode; private $ptyMode; private $haveReadSupport; public function __construct($ttyMode, $ptyMode, $input, $haveReadSupport) { $this->ttyMode = (bool) $ttyMode; $this->ptyMode = (bool) $ptyMode; $this->haveReadSupport = (bool) $haveReadSupport; parent::__construct($input); } public function __destruct() { $this->close(); } /** * {@inheritdoc} */ public function getDescriptors() { if (!$this->haveReadSupport) { $nullstream = fopen('/dev/null', 'c'); return [ ['pipe', 'r'], $nullstream, $nullstream, ]; } if ($this->ttyMode) { return [ ['file', '/dev/tty', 'r'], ['file', '/dev/tty', 'w'], ['file', '/dev/tty', 'w'], ]; } if ($this->ptyMode && Process::isPtySupported()) { return [ ['pty'], ['pty'], ['pty'], ]; } return [ ['pipe', 'r'], ['pipe', 'w'], // stdout ['pipe', 'w'], // stderr ]; } /** * {@inheritdoc} */ public function getFiles() { return []; } /** * {@inheritdoc} */ public function readAndWrite($blocking, $close = false) { $this->unblock(); $w = $this->write(); $read = $e = []; $r = $this->pipes; unset($r[0]); // let's have a look if something changed in streams set_error_handler([$this, 'handleError']); if (($r || $w) && false === stream_select($r, $w, $e, 0, $blocking ? Process::TIMEOUT_PRECISION * 1E6 : 0)) { restore_error_handler(); // if a system call has been interrupted, forget about it, let's try again // otherwise, an error occurred, let's reset pipes if (!$this->hasSystemCallBeenInterrupted()) { $this->pipes = []; } return $read; } restore_error_handler(); foreach ($r as $pipe) { // prior PHP 5.4 the array passed to stream_select is modified and // lose key association, we have to find back the key $read[$type = array_search($pipe, $this->pipes, true)] = ''; do { $data = @fread($pipe, self::CHUNK_SIZE); $read[$type] .= $data; } while (isset($data[0]) && ($close || isset($data[self::CHUNK_SIZE - 1]))); if (!isset($read[$type][0])) { unset($read[$type]); } if ($close && feof($pipe)) { fclose($pipe); unset($this->pipes[$type]); } } return $read; } /** * {@inheritdoc} */ public function haveReadSupport() { return $this->haveReadSupport; } /** * {@inheritdoc} */ public function areOpen() { return (bool) $this->pipes; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process\Pipes; use Symfony\Component\Process\Exception\RuntimeException; use Symfony\Component\Process\Process; /** * WindowsPipes implementation uses temporary files as handles. * * @see https://bugs.php.net/51800 * @see https://bugs.php.net/65650 * * @author Romain Neutron * * @internal */ class WindowsPipes extends AbstractPipes { private $files = []; private $fileHandles = []; private $lockHandles = []; private $readBytes = [ Process::STDOUT => 0, Process::STDERR => 0, ]; private $haveReadSupport; public function __construct($input, $haveReadSupport) { $this->haveReadSupport = (bool) $haveReadSupport; if ($this->haveReadSupport) { // Fix for PHP bug #51800: reading from STDOUT pipe hangs forever on Windows if the output is too big. // Workaround for this problem is to use temporary files instead of pipes on Windows platform. // // @see https://bugs.php.net/51800 $pipes = [ Process::STDOUT => Process::OUT, Process::STDERR => Process::ERR, ]; $tmpDir = sys_get_temp_dir(); $lastError = 'unknown reason'; set_error_handler(function ($type, $msg) use (&$lastError) { $lastError = $msg; }); for ($i = 0;; ++$i) { foreach ($pipes as $pipe => $name) { $file = sprintf('%s\\sf_proc_%02X.%s', $tmpDir, $i, $name); if (!$h = fopen($file.'.lock', 'w')) { if (file_exists($file.'.lock')) { continue 2; } restore_error_handler(); throw new RuntimeException('A temporary file could not be opened to write the process output: '.$lastError); } if (!flock($h, \LOCK_EX | \LOCK_NB)) { continue 2; } if (isset($this->lockHandles[$pipe])) { flock($this->lockHandles[$pipe], \LOCK_UN); fclose($this->lockHandles[$pipe]); } $this->lockHandles[$pipe] = $h; if (!fclose(fopen($file, 'w')) || !$h = fopen($file, 'r')) { flock($this->lockHandles[$pipe], \LOCK_UN); fclose($this->lockHandles[$pipe]); unset($this->lockHandles[$pipe]); continue 2; } $this->fileHandles[$pipe] = $h; $this->files[$pipe] = $file; } break; } restore_error_handler(); } parent::__construct($input); } public function __destruct() { $this->close(); } /** * {@inheritdoc} */ public function getDescriptors() { if (!$this->haveReadSupport) { $nullstream = fopen('NUL', 'c'); return [ ['pipe', 'r'], $nullstream, $nullstream, ]; } // We're not using pipe on Windows platform as it hangs (https://bugs.php.net/51800) // We're not using file handles as it can produce corrupted output https://bugs.php.net/65650 // So we redirect output within the commandline and pass the nul device to the process return [ ['pipe', 'r'], ['file', 'NUL', 'w'], ['file', 'NUL', 'w'], ]; } /** * {@inheritdoc} */ public function getFiles() { return $this->files; } /** * {@inheritdoc} */ public function readAndWrite($blocking, $close = false) { $this->unblock(); $w = $this->write(); $read = $r = $e = []; if ($blocking) { if ($w) { @stream_select($r, $w, $e, 0, Process::TIMEOUT_PRECISION * 1E6); } elseif ($this->fileHandles) { usleep(Process::TIMEOUT_PRECISION * 1E6); } } foreach ($this->fileHandles as $type => $fileHandle) { $data = stream_get_contents($fileHandle, -1, $this->readBytes[$type]); if (isset($data[0])) { $this->readBytes[$type] += \strlen($data); $read[$type] = $data; } if ($close) { ftruncate($fileHandle, 0); fclose($fileHandle); flock($this->lockHandles[$type], \LOCK_UN); fclose($this->lockHandles[$type]); unset($this->fileHandles[$type], $this->lockHandles[$type]); } } return $read; } /** * {@inheritdoc} */ public function haveReadSupport() { return $this->haveReadSupport; } /** * {@inheritdoc} */ public function areOpen() { return $this->pipes && $this->fileHandles; } /** * {@inheritdoc} */ public function close() { parent::close(); foreach ($this->fileHandles as $type => $handle) { ftruncate($handle, 0); fclose($handle); flock($this->lockHandles[$type], \LOCK_UN); fclose($this->lockHandles[$type]); } $this->fileHandles = $this->lockHandles = []; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process\Pipes; /** * PipesInterface manages descriptors and pipes for the use of proc_open. * * @author Romain Neutron * * @internal */ interface PipesInterface { const CHUNK_SIZE = 16384; /** * Returns an array of descriptors for the use of proc_open. * * @return array */ public function getDescriptors(); /** * Returns an array of filenames indexed by their related stream in case these pipes use temporary files. * * @return string[] */ public function getFiles(); /** * Reads data in file handles and pipes. * * @param bool $blocking Whether to use blocking calls or not * @param bool $close Whether to close pipes if they've reached EOF * * @return string[] An array of read data indexed by their fd */ public function readAndWrite($blocking, $close = false); /** * Returns if the current state has open file handles or pipes. * * @return bool */ public function areOpen(); /** * Returns if pipes are able to read output. * * @return bool */ public function haveReadSupport(); /** * Closes file handles and pipes. */ public function close(); } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process\Pipes; use Symfony\Component\Process\Exception\InvalidArgumentException; /** * @author Romain Neutron * * @internal */ abstract class AbstractPipes implements PipesInterface { public $pipes = []; private $inputBuffer = ''; private $input; private $blocked = true; private $lastError; /** * @param resource|string|int|float|bool|\Iterator|null $input */ public function __construct($input) { if (\is_resource($input) || $input instanceof \Iterator) { $this->input = $input; } elseif (\is_string($input)) { $this->inputBuffer = $input; } else { $this->inputBuffer = (string) $input; } } /** * {@inheritdoc} */ public function close() { foreach ($this->pipes as $pipe) { fclose($pipe); } $this->pipes = []; } /** * Returns true if a system call has been interrupted. * * @return bool */ protected function hasSystemCallBeenInterrupted() { $lastError = $this->lastError; $this->lastError = null; // stream_select returns false when the `select` system call is interrupted by an incoming signal return null !== $lastError && false !== stripos($lastError, 'interrupted system call'); } /** * Unblocks streams. */ protected function unblock() { if (!$this->blocked) { return; } foreach ($this->pipes as $pipe) { stream_set_blocking($pipe, 0); } if (\is_resource($this->input)) { stream_set_blocking($this->input, 0); } $this->blocked = false; } /** * Writes input to stdin. * * @return array|null * * @throws InvalidArgumentException When an input iterator yields a non supported value */ protected function write() { if (!isset($this->pipes[0])) { return null; } $input = $this->input; if ($input instanceof \Iterator) { if (!$input->valid()) { $input = null; } elseif (\is_resource($input = $input->current())) { stream_set_blocking($input, 0); } elseif (!isset($this->inputBuffer[0])) { if (!\is_string($input)) { if (!is_scalar($input)) { throw new InvalidArgumentException(sprintf('"%s" yielded a value of type "%s", but only scalars and stream resources are supported.', \get_class($this->input), \gettype($input))); } $input = (string) $input; } $this->inputBuffer = $input; $this->input->next(); $input = null; } else { $input = null; } } $r = $e = []; $w = [$this->pipes[0]]; // let's have a look if something changed in streams if (false === @stream_select($r, $w, $e, 0, 0)) { return null; } foreach ($w as $stdin) { if (isset($this->inputBuffer[0])) { $written = fwrite($stdin, $this->inputBuffer); $this->inputBuffer = substr($this->inputBuffer, $written); if (isset($this->inputBuffer[0])) { return [$this->pipes[0]]; } } if ($input) { for (;;) { $data = fread($input, self::CHUNK_SIZE); if (!isset($data[0])) { break; } $written = fwrite($stdin, $data); $data = substr($data, $written); if (isset($data[0])) { $this->inputBuffer = $data; return [$this->pipes[0]]; } } if (feof($input)) { if ($this->input instanceof \Iterator) { $this->input->next(); } else { $this->input = null; } } } } // no input to read on resource, buffer is empty if (!isset($this->inputBuffer[0]) && !($this->input instanceof \Iterator ? $this->input->valid() : $this->input)) { $this->input = null; fclose($this->pipes[0]); unset($this->pipes[0]); } elseif (!$w) { return [$this->pipes[0]]; } return null; } /** * @internal */ public function handleError($type, $msg) { $this->lastError = $msg; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process\Exception; /** * Marker Interface for the Process Component. * * @author Johannes M. Schmitt */ interface ExceptionInterface { } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process\Exception; /** * RuntimeException for the Process Component. * * @author Johannes M. Schmitt */ class RuntimeException extends \RuntimeException implements ExceptionInterface { } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process\Exception; /** * InvalidArgumentException for the Process Component. * * @author Romain Neutron */ class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface { } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process\Exception; use Symfony\Component\Process\Process; /** * Exception that is thrown when a process times out. * * @author Johannes M. Schmitt */ class ProcessTimedOutException extends RuntimeException { const TYPE_GENERAL = 1; const TYPE_IDLE = 2; private $process; private $timeoutType; public function __construct(Process $process, $timeoutType) { $this->process = $process; $this->timeoutType = $timeoutType; parent::__construct(sprintf( 'The process "%s" exceeded the timeout of %s seconds.', $process->getCommandLine(), $this->getExceededTimeout() )); } public function getProcess() { return $this->process; } public function isGeneralTimeout() { return self::TYPE_GENERAL === $this->timeoutType; } public function isIdleTimeout() { return self::TYPE_IDLE === $this->timeoutType; } public function getExceededTimeout() { switch ($this->timeoutType) { case self::TYPE_GENERAL: return $this->process->getTimeout(); case self::TYPE_IDLE: return $this->process->getIdleTimeout(); default: throw new \LogicException(sprintf('Unknown timeout type "%d".', $this->timeoutType)); } } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process\Exception; /** * LogicException for the Process Component. * * @author Romain Neutron */ class LogicException extends \LogicException implements ExceptionInterface { } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process\Exception; use Symfony\Component\Process\Process; /** * Exception for failed processes. * * @author Johannes M. Schmitt */ class ProcessFailedException extends RuntimeException { private $process; public function __construct(Process $process) { if ($process->isSuccessful()) { throw new InvalidArgumentException('Expected a failed process, but the given process was successful.'); } $error = sprintf('The command "%s" failed.'."\n\nExit Code: %s(%s)\n\nWorking directory: %s", $process->getCommandLine(), $process->getExitCode(), $process->getExitCodeText(), $process->getWorkingDirectory() ); if (!$process->isOutputDisabled()) { $error .= sprintf("\n\nOutput:\n================\n%s\n\nError Output:\n================\n%s", $process->getOutput(), $process->getErrorOutput() ); } parent::__construct($error); $this->process = $process; } public function getProcess() { return $this->process; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process; /** * Generic executable finder. * * @author Fabien Potencier * @author Johannes M. Schmitt */ class ExecutableFinder { private $suffixes = []; /** * Replaces default suffixes of executable. */ public function setSuffixes(array $suffixes) { $this->suffixes = $suffixes; } /** * Adds new possible suffix to check for executable. * * @param string $suffix */ public function addSuffix($suffix) { $this->suffixes[] = $suffix; } /** * Finds an executable by name. * * @param string $name The executable name (without the extension) * @param string|null $default The default to return if no executable is found * @param array $extraDirs Additional dirs to check into * * @return string|null The executable path or default value */ public function find($name, $default = null, array $extraDirs = []) { if (ini_get('open_basedir')) { $searchPath = array_merge(explode(\PATH_SEPARATOR, ini_get('open_basedir')), $extraDirs); $dirs = []; foreach ($searchPath as $path) { // Silencing against https://bugs.php.net/69240 if (@is_dir($path)) { $dirs[] = $path; } else { if (basename($path) == $name && @is_executable($path)) { return $path; } } } } else { $dirs = array_merge( explode(\PATH_SEPARATOR, getenv('PATH') ?: getenv('Path')), $extraDirs ); } $suffixes = []; if ('\\' === \DIRECTORY_SEPARATOR) { $pathExt = getenv('PATHEXT'); $suffixes = $this->suffixes; $suffixes = array_merge($suffixes, $pathExt ? explode(\PATH_SEPARATOR, $pathExt) : ['.exe', '.bat', '.cmd', '.com']); } $suffixes = '' !== pathinfo($name, PATHINFO_EXTENSION) ? array_merge([''], $suffixes) : array_merge($suffixes, ['']); foreach ($suffixes as $suffix) { foreach ($dirs as $dir) { if ('' === $dir) { $dir = '.'; } if (@is_file($file = $dir.\DIRECTORY_SEPARATOR.$name.$suffix) && ('\\' === \DIRECTORY_SEPARATOR || @is_executable($file))) { return $file; } if (!@is_dir($dir) && basename($dir) === $name.$suffix && @is_executable($dir)) { return $dir; } } } if ('\\' === \DIRECTORY_SEPARATOR || !\function_exists('exec') || \strlen($name) !== strcspn($name, '/'.\DIRECTORY_SEPARATOR)) { return $default; } $execResult = exec('command -v -- '.escapeshellarg($name)); if (($executablePath = substr($execResult, 0, strpos($execResult, \PHP_EOL) ?: null)) && @is_executable($executablePath)) { return $executablePath; } return $default; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process; use Symfony\Component\Process\Exception\InvalidArgumentException; /** * ProcessUtils is a bunch of utility methods. * * This class contains static methods only and is not meant to be instantiated. * * @author Martin HasoÅˆ */ class ProcessUtils { /** * This class should not be instantiated. */ private function __construct() { } /** * Escapes a string to be used as a shell argument. * * @param string $argument The argument that will be escaped * * @return string The escaped argument * * @deprecated since version 3.3, to be removed in 4.0. Use a command line array or give env vars to the `Process::start/run()` method instead. */ public static function escapeArgument($argument) { @trigger_error('The '.__METHOD__.'() method is deprecated since Symfony 3.3 and will be removed in 4.0. Use a command line array or give env vars to the Process::start/run() method instead.', \E_USER_DEPRECATED); //Fix for PHP bug #43784 escapeshellarg removes % from given string //Fix for PHP bug #49446 escapeshellarg doesn't work on Windows //@see https://bugs.php.net/43784 //@see https://bugs.php.net/49446 if ('\\' === \DIRECTORY_SEPARATOR) { if ('' === $argument) { return escapeshellarg($argument); } $escapedArgument = ''; $quote = false; foreach (preg_split('/(")/', $argument, -1, \PREG_SPLIT_NO_EMPTY | \PREG_SPLIT_DELIM_CAPTURE) as $part) { if ('"' === $part) { $escapedArgument .= '\\"'; } elseif (self::isSurroundedBy($part, '%')) { // Avoid environment variable expansion $escapedArgument .= '^%"'.substr($part, 1, -1).'"^%'; } else { // escape trailing backslash if ('\\' === substr($part, -1)) { $part .= '\\'; } $quote = true; $escapedArgument .= $part; } } if ($quote) { $escapedArgument = '"'.$escapedArgument.'"'; } return $escapedArgument; } return "'".str_replace("'", "'\\''", $argument)."'"; } /** * Validates and normalizes a Process input. * * @param string $caller The name of method call that validates the input * @param mixed $input The input to validate * * @return mixed The validated input * * @throws InvalidArgumentException In case the input is not valid */ public static function validateInput($caller, $input) { if (null !== $input) { if (\is_resource($input)) { return $input; } if (\is_string($input)) { return $input; } if (is_scalar($input)) { return (string) $input; } if ($input instanceof Process) { return $input->getIterator($input::ITER_SKIP_ERR); } if ($input instanceof \Iterator) { return $input; } if ($input instanceof \Traversable) { return new \IteratorIterator($input); } throw new InvalidArgumentException(sprintf('"%s" only accepts strings, Traversable objects or stream resources.', $caller)); } return $input; } private static function isSurroundedBy($arg, $char) { return 2 < \strlen($arg) && $char === $arg[0] && $char === $arg[\strlen($arg) - 1]; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process; @trigger_error(sprintf('The %s class is deprecated since Symfony 3.4 and will be removed in 4.0. Use the Process class instead.', ProcessBuilder::class), \E_USER_DEPRECATED); use Symfony\Component\Process\Exception\InvalidArgumentException; use Symfony\Component\Process\Exception\LogicException; /** * @author Kris Wallsmith * * @deprecated since version 3.4, to be removed in 4.0. Use the Process class instead. */ class ProcessBuilder { private $arguments; private $cwd; private $env = []; private $input; private $timeout = 60; private $options; private $inheritEnv = true; private $prefix = []; private $outputDisabled = false; /** * @param string[] $arguments An array of arguments */ public function __construct(array $arguments = []) { $this->arguments = $arguments; } /** * Creates a process builder instance. * * @param string[] $arguments An array of arguments * * @return static */ public static function create(array $arguments = []) { return new static($arguments); } /** * Adds an unescaped argument to the command string. * * @param string $argument A command argument * * @return $this */ public function add($argument) { $this->arguments[] = $argument; return $this; } /** * Adds a prefix to the command string. * * The prefix is preserved when resetting arguments. * * @param string|array $prefix A command prefix or an array of command prefixes * * @return $this */ public function setPrefix($prefix) { $this->prefix = \is_array($prefix) ? $prefix : [$prefix]; return $this; } /** * Sets the arguments of the process. * * Arguments must not be escaped. * Previous arguments are removed. * * @param string[] $arguments * * @return $this */ public function setArguments(array $arguments) { $this->arguments = $arguments; return $this; } /** * Sets the working directory. * * @param string|null $cwd The working directory * * @return $this */ public function setWorkingDirectory($cwd) { $this->cwd = $cwd; return $this; } /** * Sets whether environment variables will be inherited or not. * * @param bool $inheritEnv * * @return $this */ public function inheritEnvironmentVariables($inheritEnv = true) { $this->inheritEnv = $inheritEnv; return $this; } /** * Sets an environment variable. * * Setting a variable overrides its previous value. Use `null` to unset a * defined environment variable. * * @param string $name The variable name * @param string|null $value The variable value * * @return $this */ public function setEnv($name, $value) { $this->env[$name] = $value; return $this; } /** * Adds a set of environment variables. * * Already existing environment variables with the same name will be * overridden by the new values passed to this method. Pass `null` to unset * a variable. * * @param array $variables The variables * * @return $this */ public function addEnvironmentVariables(array $variables) { $this->env = array_replace($this->env, $variables); return $this; } /** * Sets the input of the process. * * @param resource|string|int|float|bool|\Traversable|null $input The input content * * @return $this * * @throws InvalidArgumentException In case the argument is invalid */ public function setInput($input) { $this->input = ProcessUtils::validateInput(__METHOD__, $input); return $this; } /** * Sets the process timeout. * * To disable the timeout, set this value to null. * * @param float|null $timeout * * @return $this * * @throws InvalidArgumentException */ public function setTimeout($timeout) { if (null === $timeout) { $this->timeout = null; return $this; } $timeout = (float) $timeout; if ($timeout < 0) { throw new InvalidArgumentException('The timeout value must be a valid positive integer or float number.'); } $this->timeout = $timeout; return $this; } /** * Adds a proc_open option. * * @param string $name The option name * @param string $value The option value * * @return $this */ public function setOption($name, $value) { $this->options[$name] = $value; return $this; } /** * Disables fetching output and error output from the underlying process. * * @return $this */ public function disableOutput() { $this->outputDisabled = true; return $this; } /** * Enables fetching output and error output from the underlying process. * * @return $this */ public function enableOutput() { $this->outputDisabled = false; return $this; } /** * Creates a Process instance and returns it. * * @return Process * * @throws LogicException In case no arguments have been provided */ public function getProcess() { if (0 === \count($this->prefix) && 0 === \count($this->arguments)) { throw new LogicException('You must add() command arguments before calling getProcess().'); } $arguments = array_merge($this->prefix, $this->arguments); $process = new Process($arguments, $this->cwd, $this->env, $this->input, $this->timeout, $this->options); // to preserve the BC with symfony <3.3, we convert the array structure // to a string structure to avoid the prefixing with the exec command $process->setCommandLine($process->getCommandLine()); if ($this->inheritEnv) { $process->inheritEnvironmentVariables(); } if ($this->outputDisabled) { $process->disableOutput(); } return $process; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process; use Symfony\Component\Process\Exception\InvalidArgumentException; use Symfony\Component\Process\Exception\LogicException; use Symfony\Component\Process\Exception\ProcessFailedException; use Symfony\Component\Process\Exception\ProcessTimedOutException; use Symfony\Component\Process\Exception\RuntimeException; use Symfony\Component\Process\Pipes\PipesInterface; use Symfony\Component\Process\Pipes\UnixPipes; use Symfony\Component\Process\Pipes\WindowsPipes; /** * Process is a thin wrapper around proc_* functions to easily * start independent PHP processes. * * @author Fabien Potencier * @author Romain Neutron */ class Process implements \IteratorAggregate { const ERR = 'err'; const OUT = 'out'; const STATUS_READY = 'ready'; const STATUS_STARTED = 'started'; const STATUS_TERMINATED = 'terminated'; const STDIN = 0; const STDOUT = 1; const STDERR = 2; // Timeout Precision in seconds. const TIMEOUT_PRECISION = 0.2; const ITER_NON_BLOCKING = 1; // By default, iterating over outputs is a blocking call, use this flag to make it non-blocking const ITER_KEEP_OUTPUT = 2; // By default, outputs are cleared while iterating, use this flag to keep them in memory const ITER_SKIP_OUT = 4; // Use this flag to skip STDOUT while iterating const ITER_SKIP_ERR = 8; // Use this flag to skip STDERR while iterating private $callback; private $hasCallback = false; private $commandline; private $cwd; private $env; private $input; private $starttime; private $lastOutputTime; private $timeout; private $idleTimeout; private $options = ['suppress_errors' => true]; private $exitcode; private $fallbackStatus = []; private $processInformation; private $outputDisabled = false; private $stdout; private $stderr; private $enhanceWindowsCompatibility = true; private $enhanceSigchildCompatibility; private $process; private $status = self::STATUS_READY; private $incrementalOutputOffset = 0; private $incrementalErrorOutputOffset = 0; private $tty = false; private $pty; private $inheritEnv = false; private $useFileHandles = false; /** @var PipesInterface */ private $processPipes; private $latestSignal; private static $sigchild; /** * Exit codes translation table. * * User-defined errors must use exit codes in the 64-113 range. */ public static $exitCodes = [ 0 => 'OK', 1 => 'General error', 2 => 'Misuse of shell builtins', 126 => 'Invoked command cannot execute', 127 => 'Command not found', 128 => 'Invalid exit argument', // signals 129 => 'Hangup', 130 => 'Interrupt', 131 => 'Quit and dump core', 132 => 'Illegal instruction', 133 => 'Trace/breakpoint trap', 134 => 'Process aborted', 135 => 'Bus error: "access to undefined portion of memory object"', 136 => 'Floating point exception: "erroneous arithmetic operation"', 137 => 'Kill (terminate immediately)', 138 => 'User-defined 1', 139 => 'Segmentation violation', 140 => 'User-defined 2', 141 => 'Write to pipe with no one reading', 142 => 'Signal raised by alarm', 143 => 'Termination (request to terminate)', // 144 - not defined 145 => 'Child process terminated, stopped (or continued*)', 146 => 'Continue if stopped', 147 => 'Stop executing temporarily', 148 => 'Terminal stop signal', 149 => 'Background process attempting to read from tty ("in")', 150 => 'Background process attempting to write to tty ("out")', 151 => 'Urgent data available on socket', 152 => 'CPU time limit exceeded', 153 => 'File size limit exceeded', 154 => 'Signal raised by timer counting virtual time: "virtual timer expired"', 155 => 'Profiling timer expired', // 156 - not defined 157 => 'Pollable event', // 158 - not defined 159 => 'Bad syscall', ]; /** * @param string|array $commandline The command line to run * @param string|null $cwd The working directory or null to use the working dir of the current PHP process * @param array|null $env The environment variables or null to use the same environment as the current PHP process * @param mixed|null $input The input as stream resource, scalar or \Traversable, or null for no input * @param int|float|null $timeout The timeout in seconds or null to disable * @param array $options An array of options for proc_open * * @throws RuntimeException When proc_open is not installed */ public function __construct($commandline, $cwd = null, array $env = null, $input = null, $timeout = 60, array $options = null) { if (!\function_exists('proc_open')) { throw new RuntimeException('The Process class relies on proc_open, which is not available on your PHP installation.'); } $this->commandline = $commandline; $this->cwd = $cwd; // on Windows, if the cwd changed via chdir(), proc_open defaults to the dir where PHP was started // on Gnu/Linux, PHP builds with --enable-maintainer-zts are also affected // @see : https://bugs.php.net/51800 // @see : https://bugs.php.net/50524 if (null === $this->cwd && (\defined('ZEND_THREAD_SAFE') || '\\' === \DIRECTORY_SEPARATOR)) { $this->cwd = getcwd(); } if (null !== $env) { $this->setEnv($env); } $this->setInput($input); $this->setTimeout($timeout); $this->useFileHandles = '\\' === \DIRECTORY_SEPARATOR; $this->pty = false; $this->enhanceSigchildCompatibility = '\\' !== \DIRECTORY_SEPARATOR && $this->isSigchildEnabled(); if (null !== $options) { @trigger_error(sprintf('The $options parameter of the %s constructor is deprecated since Symfony 3.3 and will be removed in 4.0.', __CLASS__), \E_USER_DEPRECATED); $this->options = array_replace($this->options, $options); } } /** * Creates a Process instance as a command-line to be run in a shell wrapper. * * Command-lines are parsed by the shell of your OS (/bin/sh on Unix-like, cmd.exe on Windows.) * This allows using e.g. pipes or conditional execution. In this mode, signals are sent to the * shell wrapper and not to your commands. * * In order to inject dynamic values into command-lines, we strongly recommend using placeholders. * This will save escaping values, which is not portable nor secure anyway: * * $process = Process::fromShellCommandline('my_command "${:MY_VAR}"'); * $process->run(null, ['MY_VAR' => $theValue]); * * @param string $command The command line to pass to the shell of the OS * @param string|null $cwd The working directory or null to use the working dir of the current PHP process * @param array|null $env The environment variables or null to use the same environment as the current PHP process * @param mixed $input The input as stream resource, scalar or \Traversable, or null for no input * @param int|float|null $timeout The timeout in seconds or null to disable * * @return static * * @throws LogicException When proc_open is not installed */ public static function fromShellCommandline($command, $cwd = null, array $env = null, $input = null, $timeout = 60) { $process = new static([], $cwd, $env, $input, $timeout); $process->commandline = $command; return $process; } public function __destruct() { $this->stop(0); } public function __clone() { $this->resetProcessData(); } /** * Runs the process. * * The callback receives the type of output (out or err) and * some bytes from the output in real-time. It allows to have feedback * from the independent process during execution. * * The STDOUT and STDERR are also available after the process is finished * via the getOutput() and getErrorOutput() methods. * * @param callable|null $callback A PHP callback to run whenever there is some * output available on STDOUT or STDERR * * @return int The exit status code * * @throws RuntimeException When process can't be launched * @throws RuntimeException When process stopped after receiving signal * @throws LogicException In case a callback is provided and output has been disabled * * @final since version 3.3 */ public function run($callback = null/*, array $env = []*/) { $env = 1 < \func_num_args() ? func_get_arg(1) : null; $this->start($callback, $env); return $this->wait(); } /** * Runs the process. * * This is identical to run() except that an exception is thrown if the process * exits with a non-zero exit code. * * @return $this * * @throws RuntimeException if PHP was compiled with --enable-sigchild and the enhanced sigchild compatibility mode is not enabled * @throws ProcessFailedException if the process didn't terminate successfully * * @final since version 3.3 */ public function mustRun(callable $callback = null/*, array $env = []*/) { if (!$this->enhanceSigchildCompatibility && $this->isSigchildEnabled()) { throw new RuntimeException('This PHP has been compiled with --enable-sigchild. You must use setEnhanceSigchildCompatibility() to use this method.'); } $env = 1 < \func_num_args() ? func_get_arg(1) : null; if (0 !== $this->run($callback, $env)) { throw new ProcessFailedException($this); } return $this; } /** * Starts the process and returns after writing the input to STDIN. * * This method blocks until all STDIN data is sent to the process then it * returns while the process runs in the background. * * The termination of the process can be awaited with wait(). * * The callback receives the type of output (out or err) and some bytes from * the output in real-time while writing the standard input to the process. * It allows to have feedback from the independent process during execution. * * @param callable|null $callback A PHP callback to run whenever there is some * output available on STDOUT or STDERR * * @throws RuntimeException When process can't be launched * @throws RuntimeException When process is already running * @throws LogicException In case a callback is provided and output has been disabled */ public function start(callable $callback = null/*, array $env = [*/) { if ($this->isRunning()) { throw new RuntimeException('Process is already running.'); } if (2 <= \func_num_args()) { $env = func_get_arg(1); } else { if (__CLASS__ !== static::class) { $r = new \ReflectionMethod($this, __FUNCTION__); if (__CLASS__ !== $r->getDeclaringClass()->getName() && (2 > $r->getNumberOfParameters() || 'env' !== $r->getParameters()[1]->name)) { @trigger_error(sprintf('The %s::start() method expects a second "$env" argument since Symfony 3.3. It will be made mandatory in 4.0.', static::class), \E_USER_DEPRECATED); } } $env = null; } $this->resetProcessData(); $this->starttime = $this->lastOutputTime = microtime(true); $this->callback = $this->buildCallback($callback); $this->hasCallback = null !== $callback; $descriptors = $this->getDescriptors(); $inheritEnv = $this->inheritEnv; if (\is_array($commandline = $this->commandline)) { $commandline = implode(' ', array_map([$this, 'escapeArgument'], $commandline)); if ('\\' !== \DIRECTORY_SEPARATOR) { // exec is mandatory to deal with sending a signal to the process $commandline = 'exec '.$commandline; } } if (null === $env) { $env = $this->env; } else { if ($this->env) { $env += $this->env; } $inheritEnv = true; } if (null !== $env && $inheritEnv) { $env += $this->getDefaultEnv(); } elseif (null !== $env) { @trigger_error('Not inheriting environment variables is deprecated since Symfony 3.3 and will always happen in 4.0. Set "Process::inheritEnvironmentVariables()" to true instead.', \E_USER_DEPRECATED); } else { $env = $this->getDefaultEnv(); } if ('\\' === \DIRECTORY_SEPARATOR && $this->enhanceWindowsCompatibility) { $this->options['bypass_shell'] = true; $commandline = $this->prepareWindowsCommandLine($commandline, $env); } elseif (!$this->useFileHandles && $this->enhanceSigchildCompatibility && $this->isSigchildEnabled()) { // last exit code is output on the fourth pipe and caught to work around --enable-sigchild $descriptors[3] = ['pipe', 'w']; // See https://unix.stackexchange.com/questions/71205/background-process-pipe-input $commandline = '{ ('.$commandline.') <&3 3<&- 3>/dev/null & } 3<&0;'; $commandline .= 'pid=$!; echo $pid >&3; wait $pid; code=$?; echo $code >&3; exit $code'; // Workaround for the bug, when PTS functionality is enabled. // @see : https://bugs.php.net/69442 $ptsWorkaround = fopen(__FILE__, 'r'); } if (\defined('HHVM_VERSION')) { $envPairs = $env; } else { $envPairs = []; foreach ($env as $k => $v) { if (false !== $v) { $envPairs[] = $k.'='.$v; } } } if (!is_dir($this->cwd)) { @trigger_error('The provided cwd does not exist. Command is currently ran against getcwd(). This behavior is deprecated since Symfony 3.4 and will be removed in 4.0.', \E_USER_DEPRECATED); } $this->process = @proc_open($commandline, $descriptors, $this->processPipes->pipes, $this->cwd, $envPairs, $this->options); if (!\is_resource($this->process)) { throw new RuntimeException('Unable to launch a new process.'); } $this->status = self::STATUS_STARTED; if (isset($descriptors[3])) { $this->fallbackStatus['pid'] = (int) fgets($this->processPipes->pipes[3]); } if ($this->tty) { return; } $this->updateStatus(false); $this->checkTimeout(); } /** * Restarts the process. * * Be warned that the process is cloned before being started. * * @param callable|null $callback A PHP callback to run whenever there is some * output available on STDOUT or STDERR * * @return static * * @throws RuntimeException When process can't be launched * @throws RuntimeException When process is already running * * @see start() * * @final since version 3.3 */ public function restart(callable $callback = null/*, array $env = []*/) { if ($this->isRunning()) { throw new RuntimeException('Process is already running.'); } $env = 1 < \func_num_args() ? func_get_arg(1) : null; $process = clone $this; $process->start($callback, $env); return $process; } /** * Waits for the process to terminate. * * The callback receives the type of output (out or err) and some bytes * from the output in real-time while writing the standard input to the process. * It allows to have feedback from the independent process during execution. * * @param callable|null $callback A valid PHP callback * * @return int The exitcode of the process * * @throws RuntimeException When process timed out * @throws RuntimeException When process stopped after receiving signal * @throws LogicException When process is not yet started */ public function wait(callable $callback = null) { $this->requireProcessIsStarted(__FUNCTION__); $this->updateStatus(false); if (null !== $callback) { if (!$this->processPipes->haveReadSupport()) { $this->stop(0); throw new \LogicException('Pass the callback to the Process::start method or enableOutput to use a callback with Process::wait.'); } $this->callback = $this->buildCallback($callback); } do { $this->checkTimeout(); $running = '\\' === \DIRECTORY_SEPARATOR ? $this->isRunning() : $this->processPipes->areOpen(); $this->readPipes($running, '\\' !== \DIRECTORY_SEPARATOR || !$running); } while ($running); while ($this->isRunning()) { $this->checkTimeout(); usleep(1000); } if ($this->processInformation['signaled'] && $this->processInformation['termsig'] !== $this->latestSignal) { throw new RuntimeException(sprintf('The process has been signaled with signal "%s".', $this->processInformation['termsig'])); } return $this->exitcode; } /** * Returns the Pid (process identifier), if applicable. * * @return int|null The process id if running, null otherwise */ public function getPid() { return $this->isRunning() ? $this->processInformation['pid'] : null; } /** * Sends a POSIX signal to the process. * * @param int $signal A valid POSIX signal (see https://php.net/pcntl.constants) * * @return $this * * @throws LogicException In case the process is not running * @throws RuntimeException In case --enable-sigchild is activated and the process can't be killed * @throws RuntimeException In case of failure */ public function signal($signal) { $this->doSignal($signal, true); return $this; } /** * Disables fetching output and error output from the underlying process. * * @return $this * * @throws RuntimeException In case the process is already running * @throws LogicException if an idle timeout is set */ public function disableOutput() { if ($this->isRunning()) { throw new RuntimeException('Disabling output while the process is running is not possible.'); } if (null !== $this->idleTimeout) { throw new LogicException('Output can not be disabled while an idle timeout is set.'); } $this->outputDisabled = true; return $this; } /** * Enables fetching output and error output from the underlying process. * * @return $this * * @throws RuntimeException In case the process is already running */ public function enableOutput() { if ($this->isRunning()) { throw new RuntimeException('Enabling output while the process is running is not possible.'); } $this->outputDisabled = false; return $this; } /** * Returns true in case the output is disabled, false otherwise. * * @return bool */ public function isOutputDisabled() { return $this->outputDisabled; } /** * Returns the current output of the process (STDOUT). * * @return string The process output * * @throws LogicException in case the output has been disabled * @throws LogicException In case the process is not started */ public function getOutput() { $this->readPipesForOutput(__FUNCTION__); if (false === $ret = stream_get_contents($this->stdout, -1, 0)) { return ''; } return $ret; } /** * Returns the output incrementally. * * In comparison with the getOutput method which always return the whole * output, this one returns the new output since the last call. * * @return string The process output since the last call * * @throws LogicException in case the output has been disabled * @throws LogicException In case the process is not started */ public function getIncrementalOutput() { $this->readPipesForOutput(__FUNCTION__); $latest = stream_get_contents($this->stdout, -1, $this->incrementalOutputOffset); $this->incrementalOutputOffset = ftell($this->stdout); if (false === $latest) { return ''; } return $latest; } /** * Returns an iterator to the output of the process, with the output type as keys (Process::OUT/ERR). * * @param int $flags A bit field of Process::ITER_* flags * * @throws LogicException in case the output has been disabled * @throws LogicException In case the process is not started * * @return \Generator */ public function getIterator($flags = 0) { $this->readPipesForOutput(__FUNCTION__, false); $clearOutput = !(self::ITER_KEEP_OUTPUT & $flags); $blocking = !(self::ITER_NON_BLOCKING & $flags); $yieldOut = !(self::ITER_SKIP_OUT & $flags); $yieldErr = !(self::ITER_SKIP_ERR & $flags); while (null !== $this->callback || ($yieldOut && !feof($this->stdout)) || ($yieldErr && !feof($this->stderr))) { if ($yieldOut) { $out = stream_get_contents($this->stdout, -1, $this->incrementalOutputOffset); if (isset($out[0])) { if ($clearOutput) { $this->clearOutput(); } else { $this->incrementalOutputOffset = ftell($this->stdout); } yield self::OUT => $out; } } if ($yieldErr) { $err = stream_get_contents($this->stderr, -1, $this->incrementalErrorOutputOffset); if (isset($err[0])) { if ($clearOutput) { $this->clearErrorOutput(); } else { $this->incrementalErrorOutputOffset = ftell($this->stderr); } yield self::ERR => $err; } } if (!$blocking && !isset($out[0]) && !isset($err[0])) { yield self::OUT => ''; } $this->checkTimeout(); $this->readPipesForOutput(__FUNCTION__, $blocking); } } /** * Clears the process output. * * @return $this */ public function clearOutput() { ftruncate($this->stdout, 0); fseek($this->stdout, 0); $this->incrementalOutputOffset = 0; return $this; } /** * Returns the current error output of the process (STDERR). * * @return string The process error output * * @throws LogicException in case the output has been disabled * @throws LogicException In case the process is not started */ public function getErrorOutput() { $this->readPipesForOutput(__FUNCTION__); if (false === $ret = stream_get_contents($this->stderr, -1, 0)) { return ''; } return $ret; } /** * Returns the errorOutput incrementally. * * In comparison with the getErrorOutput method which always return the * whole error output, this one returns the new error output since the last * call. * * @return string The process error output since the last call * * @throws LogicException in case the output has been disabled * @throws LogicException In case the process is not started */ public function getIncrementalErrorOutput() { $this->readPipesForOutput(__FUNCTION__); $latest = stream_get_contents($this->stderr, -1, $this->incrementalErrorOutputOffset); $this->incrementalErrorOutputOffset = ftell($this->stderr); if (false === $latest) { return ''; } return $latest; } /** * Clears the process output. * * @return $this */ public function clearErrorOutput() { ftruncate($this->stderr, 0); fseek($this->stderr, 0); $this->incrementalErrorOutputOffset = 0; return $this; } /** * Returns the exit code returned by the process. * * @return int|null The exit status code, null if the Process is not terminated * * @throws RuntimeException In case --enable-sigchild is activated and the sigchild compatibility mode is disabled */ public function getExitCode() { if (!$this->enhanceSigchildCompatibility && $this->isSigchildEnabled()) { throw new RuntimeException('This PHP has been compiled with --enable-sigchild. You must use setEnhanceSigchildCompatibility() to use this method.'); } $this->updateStatus(false); return $this->exitcode; } /** * Returns a string representation for the exit code returned by the process. * * This method relies on the Unix exit code status standardization * and might not be relevant for other operating systems. * * @return string|null A string representation for the exit status code, null if the Process is not terminated * * @see http://tldp.org/LDP/abs/html/exitcodes.html * @see http://en.wikipedia.org/wiki/Unix_signal */ public function getExitCodeText() { if (null === $exitcode = $this->getExitCode()) { return null; } return isset(self::$exitCodes[$exitcode]) ? self::$exitCodes[$exitcode] : 'Unknown error'; } /** * Checks if the process ended successfully. * * @return bool true if the process ended successfully, false otherwise */ public function isSuccessful() { return 0 === $this->getExitCode(); } /** * Returns true if the child process has been terminated by an uncaught signal. * * It always returns false on Windows. * * @return bool * * @throws RuntimeException In case --enable-sigchild is activated * @throws LogicException In case the process is not terminated */ public function hasBeenSignaled() { $this->requireProcessIsTerminated(__FUNCTION__); if (!$this->enhanceSigchildCompatibility && $this->isSigchildEnabled()) { throw new RuntimeException('This PHP has been compiled with --enable-sigchild. Term signal can not be retrieved.'); } return $this->processInformation['signaled']; } /** * Returns the number of the signal that caused the child process to terminate its execution. * * It is only meaningful if hasBeenSignaled() returns true. * * @return int * * @throws RuntimeException In case --enable-sigchild is activated * @throws LogicException In case the process is not terminated */ public function getTermSignal() { $this->requireProcessIsTerminated(__FUNCTION__); if ($this->isSigchildEnabled() && (!$this->enhanceSigchildCompatibility || -1 === $this->processInformation['termsig'])) { throw new RuntimeException('This PHP has been compiled with --enable-sigchild. Term signal can not be retrieved.'); } return $this->processInformation['termsig']; } /** * Returns true if the child process has been stopped by a signal. * * It always returns false on Windows. * * @return bool * * @throws LogicException In case the process is not terminated */ public function hasBeenStopped() { $this->requireProcessIsTerminated(__FUNCTION__); return $this->processInformation['stopped']; } /** * Returns the number of the signal that caused the child process to stop its execution. * * It is only meaningful if hasBeenStopped() returns true. * * @return int * * @throws LogicException In case the process is not terminated */ public function getStopSignal() { $this->requireProcessIsTerminated(__FUNCTION__); return $this->processInformation['stopsig']; } /** * Checks if the process is currently running. * * @return bool true if the process is currently running, false otherwise */ public function isRunning() { if (self::STATUS_STARTED !== $this->status) { return false; } $this->updateStatus(false); return $this->processInformation['running']; } /** * Checks if the process has been started with no regard to the current state. * * @return bool true if status is ready, false otherwise */ public function isStarted() { return self::STATUS_READY != $this->status; } /** * Checks if the process is terminated. * * @return bool true if process is terminated, false otherwise */ public function isTerminated() { $this->updateStatus(false); return self::STATUS_TERMINATED == $this->status; } /** * Gets the process status. * * The status is one of: ready, started, terminated. * * @return string The current process status */ public function getStatus() { $this->updateStatus(false); return $this->status; } /** * Stops the process. * * @param int|float $timeout The timeout in seconds * @param int $signal A POSIX signal to send in case the process has not stop at timeout, default is SIGKILL (9) * * @return int|null The exit-code of the process or null if it's not running */ public function stop($timeout = 10, $signal = null) { $timeoutMicro = microtime(true) + $timeout; if ($this->isRunning()) { // given `SIGTERM` may not be defined and that `proc_terminate` uses the constant value and not the constant itself, we use the same here $this->doSignal(15, false); do { usleep(1000); } while ($this->isRunning() && microtime(true) < $timeoutMicro); if ($this->isRunning()) { // Avoid exception here: process is supposed to be running, but it might have stopped just // after this line. In any case, let's silently discard the error, we cannot do anything. $this->doSignal($signal ?: 9, false); } } if ($this->isRunning()) { if (isset($this->fallbackStatus['pid'])) { unset($this->fallbackStatus['pid']); return $this->stop(0, $signal); } $this->close(); } return $this->exitcode; } /** * Adds a line to the STDOUT stream. * * @internal * * @param string $line The line to append */ public function addOutput($line) { $this->lastOutputTime = microtime(true); fseek($this->stdout, 0, \SEEK_END); fwrite($this->stdout, $line); fseek($this->stdout, $this->incrementalOutputOffset); } /** * Adds a line to the STDERR stream. * * @internal * * @param string $line The line to append */ public function addErrorOutput($line) { $this->lastOutputTime = microtime(true); fseek($this->stderr, 0, \SEEK_END); fwrite($this->stderr, $line); fseek($this->stderr, $this->incrementalErrorOutputOffset); } /** * Gets the command line to be executed. * * @return string The command to execute */ public function getCommandLine() { return \is_array($this->commandline) ? implode(' ', array_map([$this, 'escapeArgument'], $this->commandline)) : $this->commandline; } /** * Sets the command line to be executed. * * @param string|array $commandline The command to execute * * @return $this */ public function setCommandLine($commandline) { $this->commandline = $commandline; return $this; } /** * Gets the process timeout (max. runtime). * * @return float|null The timeout in seconds or null if it's disabled */ public function getTimeout() { return $this->timeout; } /** * Gets the process idle timeout (max. time since last output). * * @return float|null The timeout in seconds or null if it's disabled */ public function getIdleTimeout() { return $this->idleTimeout; } /** * Sets the process timeout (max. runtime) in seconds. * * To disable the timeout, set this value to null. * * @param int|float|null $timeout The timeout in seconds * * @return $this * * @throws InvalidArgumentException if the timeout is negative */ public function setTimeout($timeout) { $this->timeout = $this->validateTimeout($timeout); return $this; } /** * Sets the process idle timeout (max. time since last output). * * To disable the timeout, set this value to null. * * @param int|float|null $timeout The timeout in seconds * * @return $this * * @throws LogicException if the output is disabled * @throws InvalidArgumentException if the timeout is negative */ public function setIdleTimeout($timeout) { if (null !== $timeout && $this->outputDisabled) { throw new LogicException('Idle timeout can not be set while the output is disabled.'); } $this->idleTimeout = $this->validateTimeout($timeout); return $this; } /** * Enables or disables the TTY mode. * * @param bool $tty True to enabled and false to disable * * @return $this * * @throws RuntimeException In case the TTY mode is not supported */ public function setTty($tty) { if ('\\' === \DIRECTORY_SEPARATOR && $tty) { throw new RuntimeException('TTY mode is not supported on Windows platform.'); } if ($tty) { static $isTtySupported; if (null === $isTtySupported) { $isTtySupported = (bool) @proc_open('echo 1 >/dev/null', [['file', '/dev/tty', 'r'], ['file', '/dev/tty', 'w'], ['file', '/dev/tty', 'w']], $pipes); } if (!$isTtySupported) { throw new RuntimeException('TTY mode requires /dev/tty to be read/writable.'); } } $this->tty = (bool) $tty; return $this; } /** * Checks if the TTY mode is enabled. * * @return bool true if the TTY mode is enabled, false otherwise */ public function isTty() { return $this->tty; } /** * Sets PTY mode. * * @param bool $bool * * @return $this */ public function setPty($bool) { $this->pty = (bool) $bool; return $this; } /** * Returns PTY state. * * @return bool */ public function isPty() { return $this->pty; } /** * Gets the working directory. * * @return string|null The current working directory or null on failure */ public function getWorkingDirectory() { if (null === $this->cwd) { // getcwd() will return false if any one of the parent directories does not have // the readable or search mode set, even if the current directory does return getcwd() ?: null; } return $this->cwd; } /** * Sets the current working directory. * * @param string $cwd The new working directory * * @return $this */ public function setWorkingDirectory($cwd) { $this->cwd = $cwd; return $this; } /** * Gets the environment variables. * * @return array The current environment variables */ public function getEnv() { return $this->env; } /** * Sets the environment variables. * * Each environment variable value should be a string. * If it is an array, the variable is ignored. * If it is false or null, it will be removed when * env vars are otherwise inherited. * * That happens in PHP when 'argv' is registered into * the $_ENV array for instance. * * @param array $env The new environment variables * * @return $this */ public function setEnv(array $env) { // Process can not handle env values that are arrays $env = array_filter($env, function ($value) { return !\is_array($value); }); $this->env = $env; return $this; } /** * Gets the Process input. * * @return resource|string|\Iterator|null The Process input */ public function getInput() { return $this->input; } /** * Sets the input. * * This content will be passed to the underlying process standard input. * * @param string|int|float|bool|resource|\Traversable|null $input The content * * @return $this * * @throws LogicException In case the process is running */ public function setInput($input) { if ($this->isRunning()) { throw new LogicException('Input can not be set while the process is running.'); } $this->input = ProcessUtils::validateInput(__METHOD__, $input); return $this; } /** * Gets the options for proc_open. * * @return array The current options * * @deprecated since version 3.3, to be removed in 4.0. */ public function getOptions() { @trigger_error(sprintf('The %s() method is deprecated since Symfony 3.3 and will be removed in 4.0.', __METHOD__), \E_USER_DEPRECATED); return $this->options; } /** * Sets the options for proc_open. * * @param array $options The new options * * @return $this * * @deprecated since version 3.3, to be removed in 4.0. */ public function setOptions(array $options) { @trigger_error(sprintf('The %s() method is deprecated since Symfony 3.3 and will be removed in 4.0.', __METHOD__), \E_USER_DEPRECATED); $this->options = $options; return $this; } /** * Gets whether or not Windows compatibility is enabled. * * This is true by default. * * @return bool * * @deprecated since version 3.3, to be removed in 4.0. Enhanced Windows compatibility will always be enabled. */ public function getEnhanceWindowsCompatibility() { @trigger_error(sprintf('The %s() method is deprecated since Symfony 3.3 and will be removed in 4.0. Enhanced Windows compatibility will always be enabled.', __METHOD__), \E_USER_DEPRECATED); return $this->enhanceWindowsCompatibility; } /** * Sets whether or not Windows compatibility is enabled. * * @param bool $enhance * * @return $this * * @deprecated since version 3.3, to be removed in 4.0. Enhanced Windows compatibility will always be enabled. */ public function setEnhanceWindowsCompatibility($enhance) { @trigger_error(sprintf('The %s() method is deprecated since Symfony 3.3 and will be removed in 4.0. Enhanced Windows compatibility will always be enabled.', __METHOD__), \E_USER_DEPRECATED); $this->enhanceWindowsCompatibility = (bool) $enhance; return $this; } /** * Returns whether sigchild compatibility mode is activated or not. * * @return bool * * @deprecated since version 3.3, to be removed in 4.0. Sigchild compatibility will always be enabled. */ public function getEnhanceSigchildCompatibility() { @trigger_error(sprintf('The %s() method is deprecated since Symfony 3.3 and will be removed in 4.0. Sigchild compatibility will always be enabled.', __METHOD__), \E_USER_DEPRECATED); return $this->enhanceSigchildCompatibility; } /** * Activates sigchild compatibility mode. * * Sigchild compatibility mode is required to get the exit code and * determine the success of a process when PHP has been compiled with * the --enable-sigchild option * * @param bool $enhance * * @return $this * * @deprecated since version 3.3, to be removed in 4.0. */ public function setEnhanceSigchildCompatibility($enhance) { @trigger_error(sprintf('The %s() method is deprecated since Symfony 3.3 and will be removed in 4.0. Sigchild compatibility will always be enabled.', __METHOD__), \E_USER_DEPRECATED); $this->enhanceSigchildCompatibility = (bool) $enhance; return $this; } /** * Sets whether environment variables will be inherited or not. * * @param bool $inheritEnv * * @return $this */ public function inheritEnvironmentVariables($inheritEnv = true) { if (!$inheritEnv) { @trigger_error('Not inheriting environment variables is deprecated since Symfony 3.3 and will always happen in 4.0. Set "Process::inheritEnvironmentVariables()" to true instead.', \E_USER_DEPRECATED); } $this->inheritEnv = (bool) $inheritEnv; return $this; } /** * Returns whether environment variables will be inherited or not. * * @return bool * * @deprecated since version 3.3, to be removed in 4.0. Environment variables will always be inherited. */ public function areEnvironmentVariablesInherited() { @trigger_error(sprintf('The %s() method is deprecated since Symfony 3.3 and will be removed in 4.0. Environment variables will always be inherited.', __METHOD__), \E_USER_DEPRECATED); return $this->inheritEnv; } /** * Performs a check between the timeout definition and the time the process started. * * In case you run a background process (with the start method), you should * trigger this method regularly to ensure the process timeout * * @throws ProcessTimedOutException In case the timeout was reached */ public function checkTimeout() { if (self::STATUS_STARTED !== $this->status) { return; } if (null !== $this->timeout && $this->timeout < microtime(true) - $this->starttime) { $this->stop(0); throw new ProcessTimedOutException($this, ProcessTimedOutException::TYPE_GENERAL); } if (null !== $this->idleTimeout && $this->idleTimeout < microtime(true) - $this->lastOutputTime) { $this->stop(0); throw new ProcessTimedOutException($this, ProcessTimedOutException::TYPE_IDLE); } } /** * Returns whether PTY is supported on the current operating system. * * @return bool */ public static function isPtySupported() { static $result; if (null !== $result) { return $result; } if ('\\' === \DIRECTORY_SEPARATOR) { return $result = false; } return $result = (bool) @proc_open('echo 1 >/dev/null', [['pty'], ['pty'], ['pty']], $pipes); } /** * Creates the descriptors needed by the proc_open. * * @return array */ private function getDescriptors() { if ($this->input instanceof \Iterator) { $this->input->rewind(); } if ('\\' === \DIRECTORY_SEPARATOR) { $this->processPipes = new WindowsPipes($this->input, !$this->outputDisabled || $this->hasCallback); } else { $this->processPipes = new UnixPipes($this->isTty(), $this->isPty(), $this->input, !$this->outputDisabled || $this->hasCallback); } return $this->processPipes->getDescriptors(); } /** * Builds up the callback used by wait(). * * The callbacks adds all occurred output to the specific buffer and calls * the user callback (if present) with the received output. * * @param callable|null $callback The user defined PHP callback * * @return \Closure A PHP closure */ protected function buildCallback(callable $callback = null) { if ($this->outputDisabled) { return function ($type, $data) use ($callback) { if (null !== $callback) { \call_user_func($callback, $type, $data); } }; } $out = self::OUT; return function ($type, $data) use ($callback, $out) { if ($out == $type) { $this->addOutput($data); } else { $this->addErrorOutput($data); } if (null !== $callback) { \call_user_func($callback, $type, $data); } }; } /** * Updates the status of the process, reads pipes. * * @param bool $blocking Whether to use a blocking read call */ protected function updateStatus($blocking) { if (self::STATUS_STARTED !== $this->status) { return; } $this->processInformation = proc_get_status($this->process); $running = $this->processInformation['running']; $this->readPipes($running && $blocking, '\\' !== \DIRECTORY_SEPARATOR || !$running); if ($this->fallbackStatus && $this->enhanceSigchildCompatibility && $this->isSigchildEnabled()) { $this->processInformation = $this->fallbackStatus + $this->processInformation; } if (!$running) { $this->close(); } } /** * Returns whether PHP has been compiled with the '--enable-sigchild' option or not. * * @return bool */ protected function isSigchildEnabled() { if (null !== self::$sigchild) { return self::$sigchild; } if (!\function_exists('phpinfo') || \defined('HHVM_VERSION')) { return self::$sigchild = false; } ob_start(); phpinfo(\INFO_GENERAL); return self::$sigchild = false !== strpos(ob_get_clean(), '--enable-sigchild'); } /** * Reads pipes for the freshest output. * * @param string $caller The name of the method that needs fresh outputs * @param bool $blocking Whether to use blocking calls or not * * @throws LogicException in case output has been disabled or process is not started */ private function readPipesForOutput($caller, $blocking = false) { if ($this->outputDisabled) { throw new LogicException('Output has been disabled.'); } $this->requireProcessIsStarted($caller); $this->updateStatus($blocking); } /** * Validates and returns the filtered timeout. * * @param int|float|null $timeout * * @return float|null * * @throws InvalidArgumentException if the given timeout is a negative number */ private function validateTimeout($timeout) { $timeout = (float) $timeout; if (0.0 === $timeout) { $timeout = null; } elseif ($timeout < 0) { throw new InvalidArgumentException('The timeout value must be a valid positive integer or float number.'); } return $timeout; } /** * Reads pipes, executes callback. * * @param bool $blocking Whether to use blocking calls or not * @param bool $close Whether to close file handles or not */ private function readPipes($blocking, $close) { $result = $this->processPipes->readAndWrite($blocking, $close); $callback = $this->callback; foreach ($result as $type => $data) { if (3 !== $type) { $callback(self::STDOUT === $type ? self::OUT : self::ERR, $data); } elseif (!isset($this->fallbackStatus['signaled'])) { $this->fallbackStatus['exitcode'] = (int) $data; } } } /** * Closes process resource, closes file handles, sets the exitcode. * * @return int The exitcode */ private function close() { $this->processPipes->close(); if (\is_resource($this->process)) { proc_close($this->process); } $this->exitcode = $this->processInformation['exitcode']; $this->status = self::STATUS_TERMINATED; if (-1 === $this->exitcode) { if ($this->processInformation['signaled'] && 0 < $this->processInformation['termsig']) { // if process has been signaled, no exitcode but a valid termsig, apply Unix convention $this->exitcode = 128 + $this->processInformation['termsig']; } elseif ($this->enhanceSigchildCompatibility && $this->isSigchildEnabled()) { $this->processInformation['signaled'] = true; $this->processInformation['termsig'] = -1; } } // Free memory from self-reference callback created by buildCallback // Doing so in other contexts like __destruct or by garbage collector is ineffective // Now pipes are closed, so the callback is no longer necessary $this->callback = null; return $this->exitcode; } /** * Resets data related to the latest run of the process. */ private function resetProcessData() { $this->starttime = null; $this->callback = null; $this->exitcode = null; $this->fallbackStatus = []; $this->processInformation = null; $this->stdout = fopen('php://temp/maxmemory:'.(1024 * 1024), 'w+b'); $this->stderr = fopen('php://temp/maxmemory:'.(1024 * 1024), 'w+b'); $this->process = null; $this->latestSignal = null; $this->status = self::STATUS_READY; $this->incrementalOutputOffset = 0; $this->incrementalErrorOutputOffset = 0; } /** * Sends a POSIX signal to the process. * * @param int $signal A valid POSIX signal (see https://php.net/pcntl.constants) * @param bool $throwException Whether to throw exception in case signal failed * * @return bool True if the signal was sent successfully, false otherwise * * @throws LogicException In case the process is not running * @throws RuntimeException In case --enable-sigchild is activated and the process can't be killed * @throws RuntimeException In case of failure */ private function doSignal($signal, $throwException) { if (null === $pid = $this->getPid()) { if ($throwException) { throw new LogicException('Can not send signal on a non running process.'); } return false; } if ('\\' === \DIRECTORY_SEPARATOR) { exec(sprintf('taskkill /F /T /PID %d 2>&1', $pid), $output, $exitCode); if ($exitCode && $this->isRunning()) { if ($throwException) { throw new RuntimeException(sprintf('Unable to kill the process (%s).', implode(' ', $output))); } return false; } } else { if (!$this->enhanceSigchildCompatibility || !$this->isSigchildEnabled()) { $ok = @proc_terminate($this->process, $signal); } elseif (\function_exists('posix_kill')) { $ok = @posix_kill($pid, $signal); } elseif ($ok = proc_open(sprintf('kill -%d %d', $signal, $pid), [2 => ['pipe', 'w']], $pipes)) { $ok = false === fgets($pipes[2]); } if (!$ok) { if ($throwException) { throw new RuntimeException(sprintf('Error while sending signal `%s`.', $signal)); } return false; } } $this->latestSignal = (int) $signal; $this->fallbackStatus['signaled'] = true; $this->fallbackStatus['exitcode'] = -1; $this->fallbackStatus['termsig'] = $this->latestSignal; return true; } private function prepareWindowsCommandLine($cmd, array &$env) { $uid = uniqid('', true); $varCount = 0; $varCache = []; $cmd = preg_replace_callback( '/"(?:( [^"%!^]*+ (?: (?: !LF! | "(?:\^[%!^])?+" ) [^"%!^]*+ )++ ) | [^"]*+ )"/x', function ($m) use (&$env, &$varCache, &$varCount, $uid) { if (!isset($m[1])) { return $m[0]; } if (isset($varCache[$m[0]])) { return $varCache[$m[0]]; } if (false !== strpos($value = $m[1], "\0")) { $value = str_replace("\0", '?', $value); } if (false === strpbrk($value, "\"%!\n")) { return '"'.$value.'"'; } $value = str_replace(['!LF!', '"^!"', '"^%"', '"^^"', '""'], ["\n", '!', '%', '^', '"'], $value); $value = '"'.preg_replace('/(\\\\*)"/', '$1$1\\"', $value).'"'; $var = $uid.++$varCount; $env[$var] = $value; return $varCache[$m[0]] = '!'.$var.'!'; }, $cmd ); $cmd = 'cmd /V:ON /E:ON /D /C ('.str_replace("\n", ' ', $cmd).')'; static $comSpec; if (!$comSpec && $comSpec = (new ExecutableFinder())->find('cmd.exe')) { // Escape according to CommandLineToArgvW rules $comSpec = '"'.preg_replace('{(\\\\*+)"}', '$1$1\"', $comSpec) .'"'; } $cmd = ($comSpec !== null ? $comSpec : 'cmd').' /V:ON /E:ON /D /C ('.str_replace("\n", ' ', $cmd).')'; foreach ($this->processPipes->getFiles() as $offset => $filename) { $cmd .= ' '.$offset.'>"'.$filename.'"'; } return $cmd; } /** * Ensures the process is running or terminated, throws a LogicException if the process has a not started. * * @param string $functionName The function name that was called * * @throws LogicException if the process has not run */ private function requireProcessIsStarted($functionName) { if (!$this->isStarted()) { throw new LogicException(sprintf('Process must be started before calling "%s()".', $functionName)); } } /** * Ensures the process is terminated, throws a LogicException if the process has a status different than `terminated`. * * @param string $functionName The function name that was called * * @throws LogicException if the process is not yet terminated */ private function requireProcessIsTerminated($functionName) { if (!$this->isTerminated()) { throw new LogicException(sprintf('Process must be terminated before calling "%s()".', $functionName)); } } /** * Escapes a string to be used as a shell argument. * * @param string $argument The argument that will be escaped * * @return string The escaped argument */ private function escapeArgument($argument) { if ('\\' !== \DIRECTORY_SEPARATOR) { return "'".str_replace("'", "'\\''", $argument)."'"; } if ('' === $argument = (string) $argument) { return '""'; } if (false !== strpos($argument, "\0")) { $argument = str_replace("\0", '?', $argument); } if (!preg_match('/[\/()%!^"<>&|\s]/', $argument)) { return $argument; } $argument = preg_replace('/(\\\\+)$/', '$1$1', $argument); return '"'.str_replace(['"', '^', '%', '!', "\n"], ['""', '"^^"', '"^%"', '"^!"', '!LF!'], $argument).'"'; } private function getDefaultEnv() { $env = []; foreach ($_SERVER as $k => $v) { if (\is_string($v) && false !== $v = getenv($k)) { $env[$k] = $v; } } foreach ($_ENV as $k => $v) { if (\is_string($v)) { $env[$k] = $v; } } return $env; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process; use Symfony\Component\Process\Exception\RuntimeException; /** * PhpProcess runs a PHP script in an independent process. * * $p = new PhpProcess(''); * $p->run(); * print $p->getOutput()."\n"; * * @author Fabien Potencier */ class PhpProcess extends Process { /** * @param string $script The PHP script to run (as a string) * @param string|null $cwd The working directory or null to use the working dir of the current PHP process * @param array|null $env The environment variables or null to use the same environment as the current PHP process * @param int $timeout The timeout in seconds * @param array $options An array of options for proc_open */ public function __construct($script, $cwd = null, array $env = null, $timeout = 60, array $options = null) { $executableFinder = new PhpExecutableFinder(); if (false === $php = $executableFinder->find(false)) { $php = null; } else { $php = array_merge([$php], $executableFinder->findArguments()); } if ('phpdbg' === \PHP_SAPI) { $file = tempnam(sys_get_temp_dir(), 'dbg'); file_put_contents($file, $script); register_shutdown_function('unlink', $file); $php[] = $file; $script = null; } if (null !== $options) { @trigger_error(sprintf('The $options parameter of the %s constructor is deprecated since Symfony 3.3 and will be removed in 4.0.', __CLASS__), \E_USER_DEPRECATED); } parent::__construct($php, $cwd, $env, $script, $timeout, $options); } /** * Sets the path to the PHP binary to use. */ public function setPhpBinary($php) { $this->setCommandLine($php); } /** * {@inheritdoc} */ public function start(callable $callback = null/*, array $env = []*/) { if (null === $this->getCommandLine()) { throw new RuntimeException('Unable to find the PHP executable.'); } $env = 1 < \func_num_args() ? func_get_arg(1) : null; parent::start($callback, $env); } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process; /** * An executable finder specifically designed for the PHP executable. * * @author Fabien Potencier * @author Johannes M. Schmitt */ class PhpExecutableFinder { private $executableFinder; public function __construct() { $this->executableFinder = new ExecutableFinder(); } /** * Finds The PHP executable. * * @param bool $includeArgs Whether or not include command arguments * * @return string|false The PHP executable path or false if it cannot be found */ public function find($includeArgs = true) { if ($php = getenv('PHP_BINARY')) { if (!is_executable($php) && !$php = $this->executableFinder->find($php)) { return false; } if (@is_dir($php)) { return false; } return $php; } $args = $this->findArguments(); $args = $includeArgs && $args ? ' '.implode(' ', $args) : ''; // HHVM support if (\defined('HHVM_VERSION')) { return (getenv('PHP_BINARY') ?: \PHP_BINARY).$args; } // PHP_BINARY return the current sapi executable if (\PHP_BINARY && \in_array(\PHP_SAPI, ['cli', 'cli-server', 'phpdbg'], true)) { return \PHP_BINARY.$args; } if ($php = getenv('PHP_PATH')) { if (!@is_executable($php)) { return false; } return $php; } if ($php = getenv('PHP_PEAR_PHP_BIN')) { if (@is_executable($php)) { return $php; } } if (@is_executable($php = \PHP_BINDIR.('\\' === \DIRECTORY_SEPARATOR ? '\\php.exe' : '/php'))) { return $php; } $dirs = [\PHP_BINDIR]; if ('\\' === \DIRECTORY_SEPARATOR) { $dirs[] = 'C:\xampp\php\\'; } return $this->executableFinder->find('php', false, $dirs); } /** * Finds the PHP executable arguments. * * @return array The PHP executable arguments */ public function findArguments() { $arguments = []; if (\defined('HHVM_VERSION')) { $arguments[] = '--php'; } elseif ('phpdbg' === \PHP_SAPI) { $arguments[] = '-qrr'; } return $arguments; } } * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Process; use Symfony\Component\Process\Exception\RuntimeException; /** * Provides a way to continuously write to the input of a Process until the InputStream is closed. * * @author Nicolas Grekas */ class InputStream implements \IteratorAggregate { /** @var callable|null */ private $onEmpty = null; private $input = []; private $open = true; /** * Sets a callback that is called when the write buffer becomes empty. */ public function onEmpty(callable $onEmpty = null) { $this->onEmpty = $onEmpty; } /** * Appends an input to the write buffer. * * @param resource|string|int|float|bool|\Traversable|null $input The input to append as scalar, * stream resource or \Traversable */ public function write($input) { if (null === $input) { return; } if ($this->isClosed()) { throw new RuntimeException(sprintf('"%s" is closed.', static::class)); } $this->input[] = ProcessUtils::validateInput(__METHOD__, $input); } /** * Closes the write buffer. */ public function close() { $this->open = false; } /** * Tells whether the write buffer is closed or not. */ public function isClosed() { return !$this->open; } public function getIterator() { $this->open = true; while ($this->open || $this->input) { if (!$this->input) { yield ''; continue; } $current = array_shift($this->input); if ($current instanceof \Iterator) { foreach ($current as $cur) { yield $cur; } } else { yield $current; } if (!$this->input && $this->open && null !== $onEmpty = $this->onEmpty) { $this->write($onEmpty($this)); } } } } * select: * @ _e('hello') * @ _n('Product','Products',$n) * @ _ef('hello %s',$user) * * * @package eftec\bladeone * @version 1.1 2019-08-09 * @link https://github.com/EFTEC/BladeOne * @author Jorge Patricio Castro Castillo * @copyright 2017 Jorge Patricio Castro Castillo MIT License. Don't delete this comment, its part of the license. * @deprecated Note: It is not needing anymore (BladeOne already includes the same functionalities). It is keep for compatibility purpose. */ trait BladeOneLang { /** @var string The path to the missing translations log file. If empty then every missing key is not saved. */ public $missingLog = ''; /** @var array Hold dictionary of translations */ public static $dictionary = []; /** * Tries to translate the word if its in the array defined by BladeOneLang::$dictionary * If the operation fails then, it returns the original expression without translation. * * @param $phrase * * @return string */ public function _e($phrase) { if ((!\array_key_exists($phrase, static::$dictionary))) { $this->missingTranslation($phrase); return $phrase; } else { return static::$dictionary[$phrase]; } } /** * Its the same than @_e, however it parses the text (using sprintf). * If the operation fails then, it returns the original expression without translation. * * @param $phrase * * @return string */ public function _ef($phrase) { $argv = \func_get_args(); $r = $this->_e($phrase); $argv[0] = $r; // replace the first argument with the translation. $result = @\call_user_func_array("sprintf", $argv); $result = ($result === false) ? $r : $result; return $result; } /** * if num is more than one then it returns the phrase in plural, otherwise the phrase in singular. * Note: the translation should be as follow: $msg['Person']='Person' $msg=['Person']['p']='People' * * @param string $phrase * @param string $phrases * @param int $num * * @return string */ public function _n($phrase, $phrases, $num = 0) { if ((!\array_key_exists($phrase, static::$dictionary))) { $this->missingTranslation($phrase); return ($num <= 1) ? $phrase : $phrases; } else { return ($num <= 1) ? $this->_e($phrase) : $this->_e($phrases); } } // /** * Used for @_e directive. * * @param $expression * * @return string */ protected function compile_e($expression) { return $this->phpTag . "echo \$this->_e{$expression}; ?>"; } /** * Used for @_ef directive. * * @param $expression * * @return string */ protected function compile_ef($expression) { return $this->phpTag . "echo \$this->_ef{$expression}; ?>"; } /** * Used for @_n directive. * * @param $expression * * @return string */ protected function compile_n($expression) { return $this->phpTag . "echo \$this->_n{$expression}; ?>"; } // /** * Log a missing translation into the file $this->missingLog.
* If the file is not defined, then it doesn't write the log. * * @param string $txt Message to write on. */ private function missingTranslation($txt) { if (!$this->missingLog) { return; // if there is not a file assigned then it skips saving. } $fz = @\filesize($this->missingLog); $mode = 'a'; if (\is_object($txt) || \is_array($txt)) { $txt = \print_r($txt, true); } // Rewrite file if more than 100000 bytes if ($fz > 100000) { $mode = 'w'; } $fp = \fopen($this->missingLog, 'w'); \fwrite($fp, $txt . "\n"); \fclose($fp); } } * select: * @ select('idCountry','value',[,$extra]) * @ item('0','--select a country'[,$extra]) * @ items($countries,'id','name',$currentCountry[,$extra]) * @ endselect() * input: * @ input('iduser',$currentUser,'text'[,$extra]) * button: * @ commandbutton('idbutton','value','text'[,$extra]) * * * Note. The names of the tags are based in Java Server Faces (JSF) * * @package BladeOneHtml * @version 1.9.2 2020-05-28 (1) * @link https://github.com/EFTEC/BladeOne * @author Jorge Patricio Castro Castillo * @deprecated use https://github.com/eftec/BladeOneHtml */ trait BladeOneHtml { protected $htmlItem = []; // indicates the type of the current tag. such as select/selectgroup/etc. protected $htmlCurrentId = []; //indicates the id of the current tag. // protected function compileSelect($expression) { $this->htmlItem[] = 'select'; return $this->phpTag . "echo \$this->select{$expression}; ?>"; } protected function compileListBoxes($expression) { return $this->phpTag . "echo \$this->listboxes{$expression}; ?>"; } protected function compileLink($expression) { return $this->phpTag . "echo \$this->link{$expression}; ?>"; } protected function compileSelectGroup($expression) { $this->htmlItem[] = 'selectgroup'; $this->compilePush(''); return $this->phpTag . "echo \$this->select{$expression}; ?>"; } protected function compileRadio($expression) { $this->htmlItem[] = 'radio'; return $this->phpTag . "echo \$this->radio{$expression}; ?>"; } protected function compileCheckbox($expression) { $this->htmlItem[] = 'checkbox'; return $this->phpTag . "echo \$this->checkbox{$expression}; ?>"; } protected function compileEndSelect() { $r = @\array_pop($this->htmlItem); if (\is_null($r)) { $this->showError("@endselect", "Missing @select or so many @endselect", true); } return $this->phpTag . "echo ''; ?>"; } protected function compileEndRadio() { $r = @\array_pop($this->htmlItem); if (\is_null($r)) { return $this->showError("@EndRadio", "Missing @Radio or so many @EndRadio", true); } return ''; } protected function compileEndCheckbox() { $r = @\array_pop($this->htmlItem); if (\is_null($r)) { return $this->showError("@EndCheckbox", "Missing @Checkbox or so many @EndCheckbox", true); } return ''; } protected function compileItem($expression) { // we add a new attribute with the type of the current open tag $r = \end($this->htmlItem); $x = \trim($expression); $x = "('{$r}'," . \substr($x, 1); return $this->phpTag . "echo \$this->item{$x}; ?>"; } protected function compileItems($expression) { // we add a new attribute with the type of the current open tag $r = \end($this->htmlItem); $x = \trim($expression); $x = "('{$r}'," . \substr($x, 1); return $this->phpTag . "echo \$this->items{$x}; ?>"; } protected function compileTrio($expression) { // we add a new attribute with the type of the current open tag $r = \end($this->htmlItem); $x = \trim($expression); $x = "('{$r}'," . \substr($x, 1); return $this->phpTag . "echo \$this->trio{$x}; ?>"; } protected function compileTrios($expression) { // we add a new attribute with the type of the current open tag $r = \end($this->htmlItem); $x = \trim($expression); $x = "('{$r}'," . \substr($x, 1); return $this->phpTag . "echo \$this->trios{$x}; ?>"; } protected function compileInput($expression) { return $this->phpTag . "echo \$this->input{$expression}; ?>"; } protected function compileFile($expression) { return $this->phpTag . "echo \$this->file{$expression}; ?>"; } protected function compileImage($expression) { return $this->phpTag . "echo \$this->image{$expression}; ?>"; } protected function compileTextArea($expression) { return $this->phpTag . "echo \$this->textArea{$expression}; ?>"; } protected function compileHidden($expression) { return $this->phpTag . "echo \$this->hidden{$expression}; ?>"; } protected function compileLabel($expression) { return $this->phpTag . "// {$expression} \n echo \$this->label{$expression}; ?>"; } protected function compileCommandButton($expression) { return $this->phpTag . "echo \$this->commandButton{$expression}; ?>"; } protected function compileForm($expression) { return $this->phpTag . "echo \$this->form{$expression}; ?>"; } protected function compileEndForm() { return $this->phpTag . "echo ''; ?>"; } // // public function select($name, $value, $extra = '') { if (\strpos($extra, 'readonly') === false) { return "

* $this->wrapPHP('$hello'); // "< ?php echo $this->e($hello); ? >" * $this->wrapPHP('$hello',''); // < ?php echo $this->e($hello); ? > * $this->wrapPHP('$hello','',false); // < ?php echo $hello; ? > * $this->wrapPHP('"hello"'); // "< ?php echo $this->e("hello"); ? >" * $this->wrapPHP('hello()'); // "< ?php echo $this->e(hello()); ? >" *

* Text::wildCardComparison('abcdef','abc*'); // true * Text::wildCardComparison('abcdef','*def'); // true * Text::wildCardComparison('abcdef','*abc*'); // true * Text::wildCardComparison('abcdef','*cde*'); // true * Text::wildCardComparison('abcdef','*cde'); // false * *

* $this->composer('folder.view',function($bladeOne) { $bladeOne->share('newvalue','hi there'); }); * $this->composer('folder.view','namespace1\namespace2\SomeClass'); // SomeClass must exists and it must has the * // method 'composer' * $this->composer('folder.*',$instance); // $instance must has the method called 'composer' * $this->composer(); // clear all composer. *

* $this->setBaseUrl('http://domain.dom/myblog'); * $this->setBaseUrl('http://domain.dom/corporate/erp'); * $this->setBaseUrl('http://domain.dom/blog.php?args=20'); // avoid this one. * $this->setBaseUrl('http://another.dom'); *

* // current url='http://domain.dom/page/subpage/web.php?aaa=2 * $this->setBaseUrl('http://domain.dom/'); * $this->getRelativePath(); // '../../' * $this->setBaseUrl('http://domain.dom/'); * $this->getRelativePath(); // '../../' *

" . (($toggle) ? "" : '') . ' ' . (($dismiss) ? "" : '') . "

$title

"; } // } * @ cache([cacheid],[duration=86400]). The id is optional. The duration of the cache is in seconds * // content here * @ endcache() * * It also adds a new function (optional) to the business or logic layer *


 * if ($blade->cacheExpired('hellocache',1,5)) {   //'helloonecache' =template, =1 id cache, 5=duration (seconds)
 *    // cache expired, so we should do some stuff (such as read from the database)
 * }
 *

* * @package BladeOneCache * @version 3.42 2020-04-25 * @link https://github.com/EFTEC/BladeOne * @author Jorge Patricio Castro Castillo */ trait BladeOneCache { protected $curCacheId = 0; protected $curCacheDuration = 0; protected $curCachePosition = 0; protected $cacheRunning = false; protected $cachePageRunning = false; protected $cacheLog; /** * @var array avoids to compare the file different times. It also avoids race conditions. */ private $cacheExpired = []; /** * @var string=['get','post','getpost','request',null][$i] */ private $cacheStrategy; /** @var array|null */ private $cacheStrategyIndex; /** * @return null|string $cacheStrategy=['get','post','getpost','request',null][$i] */ public function getCacheStrategy() { return $this->cacheStrategy; } /** * It sets the cache log. If not cache log then it does not generates a log file
* The cache log stores each time a template is creates or expired.
* * @param string $file */ public function setCacheLog($file) { $this->cacheLog=$file; } public function writeCacheLog($txt, $nivel) { if (!$this->cacheLog) { return; // if there is not a file assigned then it skips saving. } $fz = @filesize($this->cacheLog); if (is_object($txt) || is_array($txt)) { $txt = print_r($txt, true); } // Rewrite file if more than 100000 bytes $mode=($fz > 100000) ? 'w':'a'; $fp = fopen($this->cacheLog, $mode); if ($fp === false) { return; } switch ($nivel) { case 1: $txtNivel='expired'; break; case 2: $txtNivel='new'; break; default: $txtNivel='other'; } $txtarg=json_encode($this->cacheUniqueGUID(false)); fwrite($fp, date('c') . "\t$txt\t$txtNivel\t$txtarg\n"); fclose($fp); } /** * It sets the strategy of the cache page. * * @param null|string $cacheStrategy =['get','post','getpost','request',null][$i] * @param array|null $index if null then it reads all indexes. If not, it reads a indexes. */ public function setCacheStrategy($cacheStrategy, $index = null) { $this->cacheStrategy = $cacheStrategy; $this->cacheStrategyIndex = $index; } /** * It obtains an unique GUID based in:
* get= parameters from the url
* post= parameters sends via post
* getpost = a mix between get and post
* request = get, post and cookies (including sessions)
* MD5 could generate colisions (2^64 = 18,446,744,073,709,551,616) but the end hash is the sum of the hash of * the page + this GUID. * * @param bool $serialize if true then it serializes using md5 * @return string */ private function cacheUniqueGUID($serialize = true) { switch ($this->cacheStrategy) { case 'get': $r = $_GET; break; case 'post': $r = $_POST; break; case 'getpost': $arr = array_merge($_GET, $_POST); $r = $arr; break; case 'request': $r = $_REQUEST; break; default: $r = null; } if ($this->cacheStrategyIndex === null || !is_array($r)) { $r= serialize($r); } else { $copy=[]; foreach ($r as $key => $item) { if (in_array($key, $this->cacheStrategyIndex, true)) { $copy[$key]=$item; } } $r=serialize($copy); } return $serialize===true ? md5($r): $r; } public function compileCache($expression) { // get id of template // if the file exists then // compare date. // if the date is too old then re-save. // else // save for the first time. return $this->phpTag . "echo \$this->cacheStart{$expression}; if(!\$this->cacheRunning) { ?>"; } public function compileEndCache($expression) { return $this->phpTag . "} // if cacheRunning\necho \$this->cacheEnd{$expression}; ?>"; } /** * It get the filename of the compiled file (cached). If cache is not enabled, then it * returns the regular file. * * @param string $view * @return string The full filename */ private function getCompiledFileCache($view) { $id = $this->cacheUniqueGUID(); if ($id !== null) { return str_replace($this->compileExtension, '_cache' . $id . $this->compileExtension, $this->getCompiledFile($view)); } return $this->getCompiledFile($view); } /** * run the blade engine. It returns the result of the code. * * @param string $view The name of the cache. Ex: "folder.folder.view" ("/folder/folder/view.blade") * @param array $variables An associative arrays with the values to display. * @param int $ttl time to live (in second). * @return string */ public function runCache($view, $variables = [], $ttl = 86400) { $this->cachePageRunning = true; $cacheStatus=$this->cachePageExpired($view, $ttl); if ($cacheStatus!==0) { $this->writeCacheLog($view, $cacheStatus); $this->cacheStart('_page_', $ttl); $content = $this->run($view, $variables); // if no cache, then it runs normally. $this->fileName = $view; // sometimes the filename is replaced (@include), so we restore it $this->cacheEnd($content); // and it stores as a cache paged. } else { $content = $this->getFile($this->getCompiledFileCache($view)); } $this->cachePageRunning = false; return $content; } /** * Returns true if the block cache expired (or doesn't exist), otherwise false. * * @param string $templateName name of the template to use (such hello for template hello.blade.php) * @param string $id (id of cache, optional, if not id then it adds automatically a number) * @param int $cacheDuration (duration of the cache in seconds) * @return int 0=cache exists, 1= cache expired, 2=not exists, string= the cache file (if any) */ public function cacheExpired($templateName, $id, $cacheDuration) { if ($this->getMode() & 1) { return 2; // forced mode, hence it always expires. (fast mode is ignored). } $compiledFile = $this->getCompiledFile($templateName) . '_cache' . $id; return $this->cacheExpiredInt($compiledFile, $cacheDuration); } /** * It returns true if the whole page expired. * * @param string $templateName * @param int $cacheDuration is seconds. * @return int 0=cache exists, 1= cache expired, 2=not exists, string= the cache content (if any) */ public function cachePageExpired($templateName, $cacheDuration) { if ($this->getMode() & 1) { return 2; // forced mode, hence it always expires. (fast mode is ignored). } $compiledFile = $this->getCompiledFileCache($templateName); return $this->CacheExpiredInt($compiledFile, $cacheDuration); } /** * This method is used by cacheExpired() and cachePageExpired() * * @param string $compiledFile * @param int $cacheDuration is seconds. * @return int|mixed 0=cache exists, 1= cache expired, 2=not exists, string= the cache content (if any) */ private function cacheExpiredInt($compiledFile, $cacheDuration) { if (isset($this->cacheExpired[$compiledFile])) { // if the information is already in the array then returns it. return $this->cacheExpired[$compiledFile]; } $date = @filemtime($compiledFile); if ($date) { if ($date + $cacheDuration < time()) { $this->cacheExpired[$compiledFile] = 1; return 2; // time-out. } } else { $this->cacheExpired[$compiledFile] = 2; return 1; // no file } $this->cacheExpired[$compiledFile] = 0; return 0; // cache active. } public function cacheStart($id = '', $cacheDuration = 86400) { $this->curCacheId = ($id == '') ? ($this->curCacheId + 1) : $id; $this->curCacheDuration = $cacheDuration; $this->curCachePosition = strlen(ob_get_contents()); if ($this->cachePageRunning) { $compiledFile = $this->getCompiledFileCache($this->fileName); } else { $compiledFile = $this->getCompiledFile() . '_cache' . $this->curCacheId; } if ($this->cacheExpired('', $id, $cacheDuration) !==0) { $this->cacheRunning = false; } else { $this->cacheRunning = true; $content = $this->getFile($compiledFile); echo $content; } } public function cacheEnd($txt = null) { if (!$this->cacheRunning) { $txt = ($txt !== null) ? $txt : substr(ob_get_contents(), $this->curCachePosition); if ($this->cachePageRunning) { $compiledFile = $this->getCompiledFileCache($this->fileName); } else { $compiledFile = $this->getCompiledFile() . '_cache' . $this->curCacheId; } file_put_contents($compiledFile, $txt); } $this->cacheRunning = false; } } * select: * @ select('idCountry','value',[,$extra]) * @ item('0','--select a country'[,$extra]) * @ items($countries,'id','name',$currentCountry[,$extra]) * @ endselect() * input: * @ input('iduser',$currentUser,'text'[,$extra]) * button: * @ commandbutton('idbutton','value','text'[,$extra]) * * * Note. The names of the tags are based in Java Server Faces (JSF) * * @package BladeOneHtmlBootstrap * @version 1.9.1 2018-06-11 (1) * @link https://github.com/EFTEC/BladeOne * @author Jorge Patricio Castro Castillo * @deprecated use https://github.com/eftec/BladeOneHtml */ trait BladeOneHtmlBootstrap { use BladeOneHtml { BladeOneHtml::select as selectParent; BladeOneHtml::input as inputParent; BladeOneHtml::commandButton as commandButtonParent; BladeOneHtml::textArea as textAreaParent; BladeOneHtml::item as itemParent; BladeOneHtml::checkbox as checkboxParent; BladeOneHtml::compileEndCheckbox as compileEndCheckboxParent; BladeOneHtml::radio as radioParent; BladeOneHtml::compileEndRadio as compileEndRadioParent; } // public function select($name, $value, $extra = '') { $extra = $this->addClass($extra, 'form-control'); return $this->selectParent($name, $value, $extra); } public function input($id, $value = '', $type = 'text', $extra = '') { $extra = $this->addClass($extra, 'form-control'); return $this->inputParent($id, $value, $type, $extra); } public function commandButton($id, $value = '', $text = 'Button', $type = 'submit', $extra = '') { $extra = $this->addClass($extra, 'btn'); return $this->commandButtonParent($id, $value, $text, $type, $extra); } public function textArea($id, $value = '', $extra = '') { $extra = $this->addClass($extra, 'form-control'); return $this->textAreaParent($id, $value, $extra); } public function file($id, $fullfilepath = '', $file = '', $extra = '') { return "

Browse…

"; // return "$file // // convertArg($extra)." value='".static::e($fullfilepath)."' />\n"; } /** * @param string $id of the field * @param string $fullfilepath full file path of the image * @param string $file filename of the file * @param string $extra extra field of the input file * @return string html */ public function image($id, $fullfilepath = '', $file = '', $extra = '') { return "

Browse…

"; // return "$file // // convertArg($extra)." value='".static::e($fullfilepath)."' />\n"; } /** * @param string $type type of the current open tag * @param array|string $valueId if is an array then the first value is used as value, the second is used as * extra * @param $valueText * @param array|string $selectedItem Item selected (optional) * @param string $wrapper Wrapper of the element. For example,

* @param string $extra * @return string * @internal param string $fieldId Field of the id * @internal param string $fieldText Field of the value visible */ public function item($type, $valueId, $valueText, $selectedItem = '', $wrapper = '', $extra = '') { $id = @\end($this->htmlCurrentId); $wrapper = ($wrapper == '') ? '%s' : $wrapper; if (\is_array($selectedItem)) { $found = \in_array($valueId, $selectedItem); } else { if (\is_null($selectedItem)) { // diferentiate null = '' != 0 $found = $valueId === '' || $valueId === null; } else { $found = $selectedItem == $valueId; } } $valueHtml = (!\is_array($valueId)) ? "value='{$valueId}'" : "value='{$valueId[0]}' data='{$valueId[1]}'"; switch ($type) { case 'select': $selected = ($found) ? 'selected' : ''; return \sprintf($wrapper, "\n"); break; case 'radio': $selected = ($found) ? 'checked' : ''; return \sprintf($wrapper, "convertArg($extra) . "> {$valueText}\n"); break; case 'checkbox': $selected = ($found) ? 'checked' : ''; return \sprintf($wrapper, "convertArg($extra) . "> {$valueText}\n"); break; default: return '???? type undefined: [$type] on @item
'; } } public function checkbox($id, $value = '', $text = '', $valueSelected = '', $extra = '') { $num = \func_num_args(); if ($num > 2) { if ($value == $valueSelected) { if (\is_array($extra)) { $extra['checked'] = 'checked'; } else { $extra .= ' checked="checked"'; } } //return '

'.$this->inputParent($id, $value, 'checkbox', $extra) . ' ' . $text.'

'; return '

' . $this->inputParent($id, $value, 'checkbox', $extra) . ' ' . $text . '

'; } else { \array_push($this->htmlCurrentId, $id); return '

'; //return '

'; } } public function radio($id, $value = '', $text = '', $valueSelected = '', $extra = '') { $num = \func_num_args(); if ($num > 2) { if ($value == $valueSelected) { if (\is_array($extra)) { $extra['checked'] = 'checked'; } else { $extra .= ' checked="checked"'; } } return '

' . $this->inputParent($id, $value, 'radio', $extra) . ' ' . $text . '

'; } else { \array_push($this->htmlCurrentId, $id); return '

'; } } public function compileEndCheckbox() { $r = $this->compileEndCheckboxParent(); $r .= '

'; return $r; } public function compileEndRadio() { $r = $this->compileEndRadioParent(); $r .= '

'; return $r; } // // /** * It adds a class to a html tag parameter * * @example addClass('type="text" class="btn","btn-standard") * @param string|array $txt * @param string $newclass The class(es) to add, example "class1" or "class1 class" * @return string|array */ protected function addClass($txt, $newclass) { if (\is_array($txt)) { $txt = \array_change_key_case($txt); @$txt['class'] = ' ' . $newclass; return $txt; } $p0 = \stripos(' ' . $txt, ' class'); if ($p0 === false) { // if the content of the tag doesn't contain a class then it adds one. return $txt . ' class="' . $newclass . '"'; } // the class tag exists so we found the closes character ' or " and we add the class (or classes) inside it // may be it could duplicates the tag. $p1 = \strpos($txt, "'", $p0); $p2 = \strpos($txt, '"', $p0); $p1 = ($p1 === false) ? 99999 : $p1; $p2 = ($p2 === false) ? 99999 : $p2; if ($p1 < $p2) { return \substr_replace($txt, $newclass . ' ', $p1 + 1, 0); } else { echo $p2 . "#"; return \substr_replace($txt, $newclass . ' ', $p2 + 1, 0); } } protected function separatesParam($txt) { $result = []; \preg_match_all("~\"[^\"]++\"|'[^']++'|$[^)]++$|[^,]++~", $txt, $result); return $result; } // } dispatch('fsockopen.before_request'); $url_parts = parse_url($url); if (empty($url_parts)) { throw new Exception('Invalid URL.', 'invalidurl', $url); } $host = $url_parts['host']; $context = stream_context_create(); $verifyname = false; $case_insensitive_headers = new CaseInsensitiveDictionary($headers); // HTTPS support if (isset($url_parts['scheme']) && strtolower($url_parts['scheme']) === 'https') { $remote_socket = 'ssl://' . $host; if (!isset($url_parts['port'])) { $url_parts['port'] = Port::HTTPS; } $context_options = [ 'verify_peer' => true, 'capture_peer_cert' => true, ]; $verifyname = true; // SNI, if enabled (OpenSSL >=0.9.8j) // phpcs:ignore PHPCompatibility.Constants.NewConstants.openssl_tlsext_server_nameFound if (defined('OPENSSL_TLSEXT_SERVER_NAME') && OPENSSL_TLSEXT_SERVER_NAME) { $context_options['SNI_enabled'] = true; if (isset($options['verifyname']) && $options['verifyname'] === false) { $context_options['SNI_enabled'] = false; } } if (isset($options['verify'])) { if ($options['verify'] === false) { $context_options['verify_peer'] = false; $context_options['verify_peer_name'] = false; $verifyname = false; } elseif (is_string($options['verify'])) { $context_options['cafile'] = $options['verify']; } } if (isset($options['verifyname']) && $options['verifyname'] === false) { $context_options['verify_peer_name'] = false; $verifyname = false; } // Handle the PHP 8.4 deprecation (PHP 9.0 removal) of the function signature we use for stream_context_set_option(). // Ref: https://wiki.php.net/rfc/deprecate_functions_with_overloaded_signatures#stream_context_set_option if (function_exists('stream_context_set_options')) { // PHP 8.3+. stream_context_set_options($context, ['ssl' => $context_options]); } else { // PHP < 8.3. stream_context_set_option($context, ['ssl' => $context_options]); } } else { $remote_socket = 'tcp://' . $host; } $this->max_bytes = $options['max_bytes']; if (!isset($url_parts['port'])) { $url_parts['port'] = Port::HTTP; } $remote_socket .= ':' . $url_parts['port']; // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_set_error_handler set_error_handler([$this, 'connect_error_handler'], E_WARNING | E_NOTICE); $options['hooks']->dispatch('fsockopen.remote_socket', [&$remote_socket]); $socket = stream_socket_client($remote_socket, $errno, $errstr, ceil($options['connect_timeout']), STREAM_CLIENT_CONNECT, $context); restore_error_handler(); if ($verifyname && !$this->verify_certificate_from_context($host, $context)) { throw new Exception('SSL certificate did not match the requested domain name', 'ssl.no_match'); } if (!$socket) { if ($errno === 0) { // Connection issue throw new Exception(rtrim($this->connect_error), 'fsockopen.connect_error'); } throw new Exception($errstr, 'fsockopenerror', null, $errno); } $data_format = $options['data_format']; if ($data_format === 'query') { $path = self::format_get($url_parts, $data); $data = ''; } else { $path = self::format_get($url_parts, []); } $options['hooks']->dispatch('fsockopen.remote_host_path', [&$path, $url]); $request_body = ''; $out = sprintf("%s %s HTTP/%.1F\r\n", $options['type'], $path, $options['protocol_version']); if ($options['type'] !== Requests::TRACE) { if (is_array($data)) { $request_body = http_build_query($data, '', '&'); } else { $request_body = $data; } // Always include Content-length on POST requests to prevent // 411 errors from some servers when the body is empty. if (!empty($data) || $options['type'] === Requests::POST) { if (!isset($case_insensitive_headers['Content-Length'])) { $headers['Content-Length'] = strlen($request_body); } if (!isset($case_insensitive_headers['Content-Type'])) { $headers['Content-Type'] = 'application/x-www-form-urlencoded; charset=UTF-8'; } } } if (!isset($case_insensitive_headers['Host'])) { $out .= sprintf('Host: %s', $url_parts['host']); $scheme_lower = strtolower($url_parts['scheme']); if (($scheme_lower === 'http' && $url_parts['port'] !== Port::HTTP) || ($scheme_lower === 'https' && $url_parts['port'] !== Port::HTTPS)) { $out .= ':' . $url_parts['port']; } $out .= "\r\n"; } if (!isset($case_insensitive_headers['User-Agent'])) { $out .= sprintf("User-Agent: %s\r\n", $options['useragent']); } $accept_encoding = $this->accept_encoding(); if (!isset($case_insensitive_headers['Accept-Encoding']) && !empty($accept_encoding)) { $out .= sprintf("Accept-Encoding: %s\r\n", $accept_encoding); } $headers = Requests::flatten($headers); if (!empty($headers)) { $out .= implode("\r\n", $headers) . "\r\n"; } $options['hooks']->dispatch('fsockopen.after_headers', [&$out]); if (substr($out, -2) !== "\r\n") { $out .= "\r\n"; } if (!isset($case_insensitive_headers['Connection'])) { $out .= "Connection: Close\r\n"; } $out .= "\r\n" . $request_body; $options['hooks']->dispatch('fsockopen.before_send', [&$out]); fwrite($socket, $out); $options['hooks']->dispatch('fsockopen.after_send', [$out]); if (!$options['blocking']) { fclose($socket); $fake_headers = ''; $options['hooks']->dispatch('fsockopen.after_request', [&$fake_headers]); return ''; } $timeout_sec = (int) floor($options['timeout']); if ($timeout_sec === $options['timeout']) { $timeout_msec = 0; } else { $timeout_msec = self::SECOND_IN_MICROSECONDS * $options['timeout'] % self::SECOND_IN_MICROSECONDS; } stream_set_timeout($socket, $timeout_sec, $timeout_msec); $response = ''; $body = ''; $headers = ''; $this->info = stream_get_meta_data($socket); $size = 0; $doingbody = false; $download = false; if ($options['filename']) { // phpcs:ignore WordPress.PHP.NoSilencedErrors -- Silenced the PHP native warning in favour of throwing an exception. $download = @fopen($options['filename'], 'wb'); if ($download === false) { $error = error_get_last(); throw new Exception($error['message'], 'fopen'); } } while (!feof($socket)) { $this->info = stream_get_meta_data($socket); if ($this->info['timed_out']) { throw new Exception('fsocket timed out', 'timeout'); } $block = fread($socket, Requests::BUFFER_SIZE); if (!$doingbody) { $response .= $block; if (strpos($response, "\r\n\r\n")) { list($headers, $block) = explode("\r\n\r\n", $response, 2); $doingbody = true; } } // Are we in body mode now? if ($doingbody) { $options['hooks']->dispatch('request.progress', [$block, $size, $this->max_bytes]); $data_length = strlen($block); if ($this->max_bytes) { // Have we already hit a limit? if ($size === $this->max_bytes) { continue; } if (($size + $data_length) > $this->max_bytes) { // Limit the length $limited_length = ($this->max_bytes - $size); $block = substr($block, 0, $limited_length); } } $size += strlen($block); if ($download) { fwrite($download, $block); } else { $body .= $block; } } } $this->headers = $headers; if ($download) { fclose($download); } else { $this->headers .= "\r\n\r\n" . $body; } fclose($socket); $options['hooks']->dispatch('fsockopen.after_request', [&$this->headers, &$this->info]); return $this->headers; } /** * Send multiple requests simultaneously * * @param array $requests Request data (array of 'url', 'headers', 'data', 'options') as per {@see \WpOrg\Requests\Transport::request()} * @param array $options Global options, see {@see \WpOrg\Requests\Requests::response()} for documentation * @return array Array of \WpOrg\Requests\Response objects (may contain \WpOrg\Requests\Exception or string responses as well) * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $requests argument is not an array or iterable object with array access. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $options argument is not an array. */ public function request_multiple($requests, $options) { // If you're not requesting, we can't get any responses Â¯\_(ãƒ„)_/Â¯ if (empty($requests)) { return []; } if (InputValidator::has_array_access($requests) === false || InputValidator::is_iterable($requests) === false) { throw InvalidArgument::create(1, '$requests', 'array|ArrayAccess&Traversable', gettype($requests)); } if (is_array($options) === false) { throw InvalidArgument::create(2, '$options', 'array', gettype($options)); } $responses = []; $class = get_class($this); foreach ($requests as $id => $request) { try { $handler = new $class(); $responses[$id] = $handler->request($request['url'], $request['headers'], $request['data'], $request['options']); $request['options']['hooks']->dispatch('transport.internal.parse_response', [&$responses[$id], $request]); } catch (Exception $e) { $responses[$id] = $e; } if (!is_string($responses[$id])) { $request['options']['hooks']->dispatch('multiple.request.complete', [&$responses[$id], $id]); } } return $responses; } /** * Retrieve the encodings we can accept * * @return string Accept-Encoding header value */ private static function accept_encoding() { $type = []; if (function_exists('gzinflate')) { $type[] = 'deflate;q=1.0'; } if (function_exists('gzuncompress')) { $type[] = 'compress;q=0.5'; } $type[] = 'gzip;q=0.5'; return implode(', ', $type); } /** * Format a URL given GET data * * @param array $url_parts Array of URL parts as received from {@link https://www.php.net/parse_url} * @param array|object $data Data to build query using, see {@link https://www.php.net/http_build_query} * @return string URL with data */ private static function format_get($url_parts, $data) { if (!empty($data)) { if (empty($url_parts['query'])) { $url_parts['query'] = ''; } $url_parts['query'] .= '&' . http_build_query($data, '', '&'); $url_parts['query'] = trim($url_parts['query'], '&'); } if (isset($url_parts['path'])) { if (isset($url_parts['query'])) { $get = $url_parts['path'] . '?' . $url_parts['query']; } else { $get = $url_parts['path']; } } else { $get = '/'; } return $get; } /** * Error handler for stream_socket_client() * * @param int $errno Error number (e.g. E_WARNING) * @param string $errstr Error message */ public function connect_error_handler($errno, $errstr) { // Double-check we can handle it if (($errno & E_WARNING) === 0 && ($errno & E_NOTICE) === 0) { // Return false to indicate the default error handler should engage return false; } $this->connect_error .= $errstr . "\n"; return true; } /** * Verify the certificate against common name and subject alternative names * * Unfortunately, PHP doesn't check the certificate against the alternative * names, leading things like 'https://www.github.com/' to be invalid. * Instead * * @link https://tools.ietf.org/html/rfc2818#section-3.1 RFC2818, Section 3.1 * * @param string $host Host name to verify against * @param resource $context Stream context * @return bool * * @throws \WpOrg\Requests\Exception On failure to connect via TLS (`fsockopen.ssl.connect_error`) * @throws \WpOrg\Requests\Exception On not obtaining a match for the host (`fsockopen.ssl.no_match`) */ public function verify_certificate_from_context($host, $context) { $meta = stream_context_get_options($context); // If we don't have SSL options, then we couldn't make the connection at // all if (empty($meta) || empty($meta['ssl']) || empty($meta['ssl']['peer_certificate'])) { throw new Exception(rtrim($this->connect_error), 'ssl.connect_error'); } $cert = openssl_x509_parse($meta['ssl']['peer_certificate']); return Ssl::verify_certificate($host, $cert); } /** * Self-test whether the transport can be used. * * The available capabilities to test for can be found in {@see \WpOrg\Requests\Capability}. * * @codeCoverageIgnore * @param array $capabilities Optional. Associative array of capabilities to test against, i.e. `['' => true]`. * @return bool Whether the transport can be used. */ public static function test($capabilities = []) { if (!function_exists('fsockopen')) { return false; } // If needed, check that streams support SSL if (isset($capabilities[Capability::SSL]) && $capabilities[Capability::SSL]) { if (!extension_loaded('openssl') || !function_exists('openssl_x509_parse')) { return false; } } return true; } } = 8.0. */ private $handle; /** * Hook dispatcher instance * * @var \WpOrg\Requests\Hooks */ private $hooks; /** * Have we finished the headers yet? * * @var boolean */ private $done_headers = false; /** * If streaming to a file, keep the file pointer * * @var resource */ private $stream_handle; /** * How many bytes are in the response body? * * @var int */ private $response_bytes; /** * What's the maximum number of bytes we should keep? * * @var int|bool Byte count, or false if no limit. */ private $response_byte_limit; /** * Constructor */ public function __construct() { $curl = curl_version(); $this->version = $curl['version_number']; $this->handle = curl_init(); curl_setopt($this->handle, CURLOPT_HEADER, false); curl_setopt($this->handle, CURLOPT_RETURNTRANSFER, 1); if ($this->version >= self::CURL_7_10_5) { curl_setopt($this->handle, CURLOPT_ENCODING, ''); } if (defined('CURLOPT_PROTOCOLS')) { // phpcs:ignore PHPCompatibility.Constants.NewConstants.curlopt_protocolsFound curl_setopt($this->handle, CURLOPT_PROTOCOLS, CURLPROTO_HTTP | CURLPROTO_HTTPS); } if (defined('CURLOPT_REDIR_PROTOCOLS')) { // phpcs:ignore PHPCompatibility.Constants.NewConstants.curlopt_redir_protocolsFound curl_setopt($this->handle, CURLOPT_REDIR_PROTOCOLS, CURLPROTO_HTTP | CURLPROTO_HTTPS); } } /** * Destructor */ public function __destruct() { if (is_resource($this->handle)) { curl_close($this->handle); } } /** * Perform a request * * @param string|Stringable $url URL to request * @param array $headers Associative array of request headers * @param string|array $data Data to send either as the POST body, or as parameters in the URL for a GET/HEAD * @param array $options Request options, see {@see \WpOrg\Requests\Requests::response()} for documentation * @return string Raw HTTP result * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $url argument is not a string or Stringable. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $headers argument is not an array. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $data parameter is not an array or string. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $options argument is not an array. * @throws \WpOrg\Requests\Exception On a cURL error (`curlerror`) */ public function request($url, $headers = [], $data = [], $options = []) { if (InputValidator::is_string_or_stringable($url) === false) { throw InvalidArgument::create(1, '$url', 'string|Stringable', gettype($url)); } if (is_array($headers) === false) { throw InvalidArgument::create(2, '$headers', 'array', gettype($headers)); } if (!is_array($data) && !is_string($data)) { if ($data === null) { $data = ''; } else { throw InvalidArgument::create(3, '$data', 'array|string', gettype($data)); } } if (is_array($options) === false) { throw InvalidArgument::create(4, '$options', 'array', gettype($options)); } $this->hooks = $options['hooks']; $this->setup_handle($url, $headers, $data, $options); $options['hooks']->dispatch('curl.before_send', [&$this->handle]); if ($options['filename'] !== false) { // phpcs:ignore WordPress.PHP.NoSilencedErrors -- Silenced the PHP native warning in favour of throwing an exception. $this->stream_handle = @fopen($options['filename'], 'wb'); if ($this->stream_handle === false) { $error = error_get_last(); throw new Exception($error['message'], 'fopen'); } } $this->response_data = ''; $this->response_bytes = 0; $this->response_byte_limit = false; if ($options['max_bytes'] !== false) { $this->response_byte_limit = $options['max_bytes']; } if (isset($options['verify'])) { if ($options['verify'] === false) { curl_setopt($this->handle, CURLOPT_SSL_VERIFYHOST, 0); curl_setopt($this->handle, CURLOPT_SSL_VERIFYPEER, 0); } elseif (is_string($options['verify'])) { curl_setopt($this->handle, CURLOPT_CAINFO, $options['verify']); } } if (isset($options['verifyname']) && $options['verifyname'] === false) { curl_setopt($this->handle, CURLOPT_SSL_VERIFYHOST, 0); } curl_exec($this->handle); $response = $this->response_data; $options['hooks']->dispatch('curl.after_send', []); if (curl_errno($this->handle) === CURLE_WRITE_ERROR || curl_errno($this->handle) === CURLE_BAD_CONTENT_ENCODING) { // Reset encoding and try again curl_setopt($this->handle, CURLOPT_ENCODING, 'none'); $this->response_data = ''; $this->response_bytes = 0; curl_exec($this->handle); $response = $this->response_data; } $this->process_response($response, $options); // Need to remove the $this reference from the curl handle. // Otherwise \WpOrg\Requests\Transport\Curl won't be garbage collected and the curl_close() will never be called. curl_setopt($this->handle, CURLOPT_HEADERFUNCTION, null); curl_setopt($this->handle, CURLOPT_WRITEFUNCTION, null); return $this->headers; } /** * Send multiple requests simultaneously * * @param array $requests Request data * @param array $options Global options * @return array Array of \WpOrg\Requests\Response objects (may contain \WpOrg\Requests\Exception or string responses as well) * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $requests argument is not an array or iterable object with array access. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $options argument is not an array. */ public function request_multiple($requests, $options) { // If you're not requesting, we can't get any responses Â¯\_(ãƒ„)_/Â¯ if (empty($requests)) { return []; } if (InputValidator::has_array_access($requests) === false || InputValidator::is_iterable($requests) === false) { throw InvalidArgument::create(1, '$requests', 'array|ArrayAccess&Traversable', gettype($requests)); } if (is_array($options) === false) { throw InvalidArgument::create(2, '$options', 'array', gettype($options)); } $multihandle = curl_multi_init(); $subrequests = []; $subhandles = []; $class = get_class($this); foreach ($requests as $id => $request) { $subrequests[$id] = new $class(); $subhandles[$id] = $subrequests[$id]->get_subrequest_handle($request['url'], $request['headers'], $request['data'], $request['options']); $request['options']['hooks']->dispatch('curl.before_multi_add', [&$subhandles[$id]]); curl_multi_add_handle($multihandle, $subhandles[$id]); } $completed = 0; $responses = []; $subrequestcount = count($subrequests); $request['options']['hooks']->dispatch('curl.before_multi_exec', [&$multihandle]); do { $active = 0; do { $status = curl_multi_exec($multihandle, $active); } while ($status === CURLM_CALL_MULTI_PERFORM); $to_process = []; // Read the information as needed while ($done = curl_multi_info_read($multihandle)) { $key = array_search($done['handle'], $subhandles, true); if (!isset($to_process[$key])) { $to_process[$key] = $done; } } // Parse the finished requests before we start getting the new ones foreach ($to_process as $key => $done) { $options = $requests[$key]['options']; if ($done['result'] !== CURLE_OK) { //get error string for handle. $reason = curl_error($done['handle']); $exception = new CurlException( $reason, CurlException::EASY, $done['handle'], $done['result'] ); $responses[$key] = $exception; $options['hooks']->dispatch('transport.internal.parse_error', [&$responses[$key], $requests[$key]]); } else { $responses[$key] = $subrequests[$key]->process_response($subrequests[$key]->response_data, $options); $options['hooks']->dispatch('transport.internal.parse_response', [&$responses[$key], $requests[$key]]); } curl_multi_remove_handle($multihandle, $done['handle']); curl_close($done['handle']); if (!is_string($responses[$key])) { $options['hooks']->dispatch('multiple.request.complete', [&$responses[$key], $key]); } $completed++; } } while ($active || $completed < $subrequestcount); $request['options']['hooks']->dispatch('curl.after_multi_exec', [&$multihandle]); curl_multi_close($multihandle); return $responses; } /** * Get the cURL handle for use in a multi-request * * @param string $url URL to request * @param array $headers Associative array of request headers * @param string|array $data Data to send either as the POST body, or as parameters in the URL for a GET/HEAD * @param array $options Request options, see {@see \WpOrg\Requests\Requests::response()} for documentation * @return resource|\CurlHandle Subrequest's cURL handle */ public function &get_subrequest_handle($url, $headers, $data, $options) { $this->setup_handle($url, $headers, $data, $options); if ($options['filename'] !== false) { $this->stream_handle = fopen($options['filename'], 'wb'); } $this->response_data = ''; $this->response_bytes = 0; $this->response_byte_limit = false; if ($options['max_bytes'] !== false) { $this->response_byte_limit = $options['max_bytes']; } $this->hooks = $options['hooks']; return $this->handle; } /** * Setup the cURL handle for the given data * * @param string $url URL to request * @param array $headers Associative array of request headers * @param string|array $data Data to send either as the POST body, or as parameters in the URL for a GET/HEAD * @param array $options Request options, see {@see \WpOrg\Requests\Requests::response()} for documentation */ private function setup_handle($url, $headers, $data, $options) { $options['hooks']->dispatch('curl.before_request', [&$this->handle]); // Force closing the connection for old versions of cURL (<7.22). if (!isset($headers['Connection'])) { $headers['Connection'] = 'close'; } /** * Add "Expect" header. * * By default, cURL adds a "Expect: 100-Continue" to most requests. This header can * add as much as a second to the time it takes for cURL to perform a request. To * prevent this, we need to set an empty "Expect" header. To match the behaviour of * Guzzle, we'll add the empty header to requests that are smaller than 1 MB and use * HTTP/1.1. * * https://curl.se/mail/lib-2017-07/0013.html */ if (!isset($headers['Expect']) && $options['protocol_version'] === 1.1) { $headers['Expect'] = $this->get_expect_header($data); } $headers = Requests::flatten($headers); if (!empty($data)) { $data_format = $options['data_format']; if ($data_format === 'query') { $url = self::format_get($url, $data); $data = ''; } elseif (!is_string($data)) { $data = http_build_query($data, '', '&'); } } switch ($options['type']) { case Requests::POST: curl_setopt($this->handle, CURLOPT_POST, true); curl_setopt($this->handle, CURLOPT_POSTFIELDS, $data); break; case Requests::HEAD: curl_setopt($this->handle, CURLOPT_CUSTOMREQUEST, $options['type']); curl_setopt($this->handle, CURLOPT_NOBODY, true); break; case Requests::TRACE: curl_setopt($this->handle, CURLOPT_CUSTOMREQUEST, $options['type']); break; case Requests::PATCH: case Requests::PUT: case Requests::DELETE: case Requests::OPTIONS: default: curl_setopt($this->handle, CURLOPT_CUSTOMREQUEST, $options['type']); if (!empty($data)) { curl_setopt($this->handle, CURLOPT_POSTFIELDS, $data); } } // cURL requires a minimum timeout of 1 second when using the system // DNS resolver, as it uses `alarm()`, which is second resolution only. // There's no way to detect which DNS resolver is being used from our // end, so we need to round up regardless of the supplied timeout. // // https://github.com/curl/curl/blob/4f45240bc84a9aa648c8f7243be7b79e9f9323a5/lib/hostip.c#L606-L609 $timeout = max($options['timeout'], 1); if (is_int($timeout) || $this->version < self::CURL_7_16_2) { curl_setopt($this->handle, CURLOPT_TIMEOUT, ceil($timeout)); } else { // phpcs:ignore PHPCompatibility.Constants.NewConstants.curlopt_timeout_msFound curl_setopt($this->handle, CURLOPT_TIMEOUT_MS, round($timeout * 1000)); } if (is_int($options['connect_timeout']) || $this->version < self::CURL_7_16_2) { curl_setopt($this->handle, CURLOPT_CONNECTTIMEOUT, ceil($options['connect_timeout'])); } else { // phpcs:ignore PHPCompatibility.Constants.NewConstants.curlopt_connecttimeout_msFound curl_setopt($this->handle, CURLOPT_CONNECTTIMEOUT_MS, round($options['connect_timeout'] * 1000)); } curl_setopt($this->handle, CURLOPT_URL, $url); curl_setopt($this->handle, CURLOPT_USERAGENT, $options['useragent']); if (!empty($headers)) { curl_setopt($this->handle, CURLOPT_HTTPHEADER, $headers); } if ($options['protocol_version'] === 1.1) { curl_setopt($this->handle, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1); } else { curl_setopt($this->handle, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_0); } if ($options['blocking'] === true) { curl_setopt($this->handle, CURLOPT_HEADERFUNCTION, [$this, 'stream_headers']); curl_setopt($this->handle, CURLOPT_WRITEFUNCTION, [$this, 'stream_body']); curl_setopt($this->handle, CURLOPT_BUFFERSIZE, Requests::BUFFER_SIZE); } } /** * Process a response * * @param string $response Response data from the body * @param array $options Request options * @return string|false HTTP response data including headers. False if non-blocking. * @throws \WpOrg\Requests\Exception If the request resulted in a cURL error. */ public function process_response($response, $options) { if ($options['blocking'] === false) { $fake_headers = ''; $options['hooks']->dispatch('curl.after_request', [&$fake_headers]); return false; } if ($options['filename'] !== false && $this->stream_handle) { fclose($this->stream_handle); $this->headers = trim($this->headers); } else { $this->headers .= $response; } if (curl_errno($this->handle)) { $error = sprintf( 'cURL error %s: %s', curl_errno($this->handle), curl_error($this->handle) ); throw new Exception($error, 'curlerror', $this->handle); } $this->info = curl_getinfo($this->handle); $options['hooks']->dispatch('curl.after_request', [&$this->headers, &$this->info]); return $this->headers; } /** * Collect the headers as they are received * * @param resource|\CurlHandle $handle cURL handle * @param string $headers Header string * @return integer Length of provided header */ public function stream_headers($handle, $headers) { // Why do we do this? cURL will send both the final response and any // interim responses, such as a 100 Continue. We don't need that. // (We may want to keep this somewhere just in case) if ($this->done_headers) { $this->headers = ''; $this->done_headers = false; } $this->headers .= $headers; if ($headers === "\r\n") { $this->done_headers = true; } return strlen($headers); } /** * Collect data as it's received * * @since 1.6.1 * * @param resource|\CurlHandle $handle cURL handle * @param string $data Body data * @return integer Length of provided data */ public function stream_body($handle, $data) { $this->hooks->dispatch('request.progress', [$data, $this->response_bytes, $this->response_byte_limit]); $data_length = strlen($data); // Are we limiting the response size? if ($this->response_byte_limit) { if ($this->response_bytes === $this->response_byte_limit) { // Already at maximum, move on return $data_length; } if (($this->response_bytes + $data_length) > $this->response_byte_limit) { // Limit the length $limited_length = ($this->response_byte_limit - $this->response_bytes); $data = substr($data, 0, $limited_length); } } if ($this->stream_handle) { fwrite($this->stream_handle, $data); } else { $this->response_data .= $data; } $this->response_bytes += strlen($data); return $data_length; } /** * Format a URL given GET data * * @param string $url Original URL. * @param array|object $data Data to build query using, see {@link https://www.php.net/http_build_query} * @return string URL with data */ private static function format_get($url, $data) { if (!empty($data)) { $query = ''; $url_parts = parse_url($url); if (empty($url_parts['query'])) { $url_parts['query'] = ''; } else { $query = $url_parts['query']; } $query .= '&' . http_build_query($data, '', '&'); $query = trim($query, '&'); if (empty($url_parts['query'])) { $url .= '?' . $query; } else { $url = str_replace($url_parts['query'], $query, $url); } } return $url; } /** * Self-test whether the transport can be used. * * The available capabilities to test for can be found in {@see \WpOrg\Requests\Capability}. * * @codeCoverageIgnore * @param array $capabilities Optional. Associative array of capabilities to test against, i.e. `['' => true]`. * @return bool Whether the transport can be used. */ public static function test($capabilities = []) { if (!function_exists('curl_init') || !function_exists('curl_exec')) { return false; } // If needed, check that our installed curl version supports SSL if (isset($capabilities[Capability::SSL]) && $capabilities[Capability::SSL]) { $curl_version = curl_version(); if (!(CURL_VERSION_SSL & $curl_version['features'])) { return false; } } return true; } /** * Get the correct "Expect" header for the given request data. * * @param string|array $data Data to send either as the POST body, or as parameters in the URL for a GET/HEAD. * @return string The "Expect" header. */ private function get_expect_header($data) { if (!is_array($data)) { return strlen((string) $data) >= 1048576 ? '100-Continue' : ''; } $bytesize = 0; $iterator = new RecursiveIteratorIterator(new RecursiveArrayIterator($data)); foreach ($iterator as $datum) { $bytesize += strlen((string) $datum); if ($bytesize >= 1048576) { return '100-Continue'; } } return ''; } } headers = new Headers(); $this->cookies = new Jar(); } /** * Is the response a redirect? * * @return boolean True if redirect (3xx status), false if not. */ public function is_redirect() { $code = $this->status_code; return in_array($code, [300, 301, 302, 303, 307], true) || $code > 307 && $code < 400; } /** * Throws an exception if the request was not successful * * @param boolean $allow_redirects Set to false to throw on a 3xx as well * * @throws \WpOrg\Requests\Exception If `$allow_redirects` is false, and code is 3xx (`response.no_redirects`) * @throws \WpOrg\Requests\Exception\Http On non-successful status code. Exception class corresponds to "Status" + code (e.g. {@see \WpOrg\Requests\Exception\Http\Status404}) */ public function throw_for_status($allow_redirects = true) { if ($this->is_redirect()) { if ($allow_redirects !== true) { throw new Exception('Redirection not allowed', 'response.no_redirects', $this); } } elseif (!$this->success) { $exception = Http::get_class($this->status_code); throw new $exception(null, $this); } } /** * JSON decode the response body. * * The method parameters are the same as those for the PHP native `json_decode()` function. * * @link https://php.net/json-decode * * @param bool|null $associative Optional. When `true`, JSON objects will be returned as associative arrays; * When `false`, JSON objects will be returned as objects. * When `null`, JSON objects will be returned as associative arrays * or objects depending on whether `JSON_OBJECT_AS_ARRAY` is set in the flags. * Defaults to `true` (in contrast to the PHP native default of `null`). * @param int $depth Optional. Maximum nesting depth of the structure being decoded. * Defaults to `512`. * @param int $options Optional. Bitmask of JSON_BIGINT_AS_STRING, JSON_INVALID_UTF8_IGNORE, * JSON_INVALID_UTF8_SUBSTITUTE, JSON_OBJECT_AS_ARRAY, JSON_THROW_ON_ERROR. * Defaults to `0` (no options set). * * @return array * * @throws \WpOrg\Requests\Exception If `$this->body` is not valid json. */ public function decode_body($associative = true, $depth = 512, $options = 0) { $data = json_decode($this->body, $associative, $depth, $options); if (json_last_error() !== JSON_ERROR_NONE) { $last_error = json_last_error_msg(); throw new Exception('Unable to parse JSON data: ' . $last_error, 'response.invalid', $this); } return $data; } } '\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 Requests 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; } } } 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; } } type = $type; } if ($code !== null) { $this->code = (int) $code; } if ($message !== null) { $this->reason = $message; } $message = sprintf('%d %s', $this->code, $this->reason); parent::__construct($message, $this->type, $data, $this->code); } /** * Get the error message. * * @return string */ public function getReason() { return $this->reason; } } code = (int) $data->status_code; } parent::__construct($reason, $data); } } reason = $reason; } $message = sprintf('%d %s', $this->code, $this->reason); parent::__construct($message, 'httpresponse', $data, $this->code); } /** * Get the status message. * * @return string */ public function getReason() { return $this->reason; } /** * Get the correct exception class for a given error code * * @param int|bool $code HTTP status code, or false if unavailable * @return string Exception class name to use */ public static function get_class($code) { if (!$code) { return StatusUnknown::class; } $class = sprintf('\WpOrg\Requests\Exception\Http\Status%d', $code); if (class_exists($class)) { return $class; } return StatusUnknown::class; } } 0) { // Whitespace detected. This can never be a dNSName. return false; } $parts = explode('.', $reference); if ($parts !== array_filter($parts)) { // DNSName cannot contain two dots next to each other. return false; } // Check the first part of the name $first = array_shift($parts); if (strpos($first, '*') !== false) { // Check that the wildcard is the full part if ($first !== '*') { return false; } // Check that we have at least 3 components (including first) if (count($parts) < 2) { return false; } } // Check the remaining parts foreach ($parts as $part) { if (strpos($part, '*') !== false) { return false; } } // Nothing found, verified! return true; } /** * Match a hostname against a dNSName reference * * @param string|Stringable $host Requested host * @param string|Stringable $reference dNSName to match against * @return boolean Does the domain match? * @throws \WpOrg\Requests\Exception\InvalidArgument When either of the passed arguments is not a string or a stringable object. */ public static function match_domain($host, $reference) { if (InputValidator::is_string_or_stringable($host) === false) { throw InvalidArgument::create(1, '$host', 'string|Stringable', gettype($host)); } // Check if the reference is blocklisted first if (self::verify_reference_name($reference) !== true) { return false; } // Check for a direct match if ((string) $host === (string) $reference) { return true; } // Calculate the valid wildcard match if the host is not an IP address // Also validates that the host has 3 parts or more, as per Firefox's ruleset, // as a wildcard reference is only allowed with 3 parts or more, so the // comparison will never match if host doesn't contain 3 parts or more as well. if (ip2long($host) === false) { $parts = explode('.', $host); $parts[0] = '*'; $wildcard = implode('.', $parts); if ($wildcard === (string) $reference) { return true; } } return false; } } 10, 'connect_timeout' => 10, 'useragent' => 'php-requests/' . self::VERSION, 'protocol_version' => 1.1, 'redirected' => 0, 'redirects' => 10, 'follow_redirects' => true, 'blocking' => true, 'type' => self::GET, 'filename' => false, 'auth' => false, 'proxy' => false, 'cookies' => false, 'max_bytes' => false, 'idn' => true, 'hooks' => null, 'transport' => null, 'verify' => null, 'verifyname' => true, ]; /** * Default supported Transport classes. * * @since 2.0.0 * * @var array */ const DEFAULT_TRANSPORTS = [ Curl::class => Curl::class, Fsockopen::class => Fsockopen::class, ]; /** * Current version of Requests * * @var string */ const VERSION = '2.0.12'; /** * Selected transport name * * Use {@see \WpOrg\Requests\Requests::get_transport()} instead * * @var array */ public static $transport = []; /** * Registered transport classes * * @var array */ protected static $transports = []; /** * Default certificate path. * * @see \WpOrg\Requests\Requests::get_certificate_path() * @see \WpOrg\Requests\Requests::set_certificate_path() * * @var string */ protected static $certificate_path = __DIR__ . '/../certificates/cacert.pem'; /** * All (known) valid deflate, gzip header magic markers. * * These markers relate to different compression levels. * * @link https://stackoverflow.com/a/43170354/482864 Marker source. * * @since 2.0.0 * * @var array */ private static $magic_compression_headers = [ "\x1f\x8b" => true, // Gzip marker. "\x78\x01" => true, // Zlib marker - level 1. "\x78\x5e" => true, // Zlib marker - level 2 to 5. "\x78\x9c" => true, // Zlib marker - level 6. "\x78\xda" => true, // Zlib marker - level 7 to 9. ]; /** * This is a static class, do not instantiate it * * @codeCoverageIgnore */ private function __construct() {} /** * Register a transport * * @param string $transport Transport class to add, must support the \WpOrg\Requests\Transport interface */ public static function add_transport($transport) { if (empty(self::$transports)) { self::$transports = self::DEFAULT_TRANSPORTS; } self::$transports[$transport] = $transport; } /** * Get the fully qualified class name (FQCN) for a working transport. * * @param array $capabilities Optional. Associative array of capabilities to test against, i.e. `['' => true]`. * @return string FQCN of the transport to use, or an empty string if no transport was * found which provided the requested capabilities. */ protected static function get_transport_class(array $capabilities = []) { // Caching code, don't bother testing coverage. // @codeCoverageIgnoreStart // Array of capabilities as a string to be used as an array key. ksort($capabilities); $cap_string = serialize($capabilities); // Don't search for a transport if it's already been done for these $capabilities. if (isset(self::$transport[$cap_string])) { return self::$transport[$cap_string]; } // Ensure we will not run this same check again later on. self::$transport[$cap_string] = ''; // @codeCoverageIgnoreEnd if (empty(self::$transports)) { self::$transports = self::DEFAULT_TRANSPORTS; } // Find us a working transport. foreach (self::$transports as $class) { if (!class_exists($class)) { continue; } $result = $class::test($capabilities); if ($result === true) { self::$transport[$cap_string] = $class; break; } } return self::$transport[$cap_string]; } /** * Get a working transport. * * @param array $capabilities Optional. Associative array of capabilities to test against, i.e. `['' => true]`. * @return \WpOrg\Requests\Transport * @throws \WpOrg\Requests\Exception If no valid transport is found (`notransport`). */ protected static function get_transport(array $capabilities = []) { $class = self::get_transport_class($capabilities); if ($class === '') { throw new Exception('No working transports found', 'notransport', self::$transports); } return new $class(); } /** * Checks to see if we have a transport for the capabilities requested. * * Supported capabilities can be found in the {@see \WpOrg\Requests\Capability} * interface as constants. * * Example usage: * `Requests::has_capabilities([Capability::SSL => true])`. * * @param array $capabilities Optional. Associative array of capabilities to test against, i.e. `['' => true]`. * @return bool Whether the transport has the requested capabilities. */ public static function has_capabilities(array $capabilities = []) { return self::get_transport_class($capabilities) !== ''; } /**#@+ * @see \WpOrg\Requests\Requests::request() * @param string $url * @param array $headers * @param array $options * @return \WpOrg\Requests\Response */ /** * Send a GET request */ public static function get($url, $headers = [], $options = []) { return self::request($url, $headers, null, self::GET, $options); } /** * Send a HEAD request */ public static function head($url, $headers = [], $options = []) { return self::request($url, $headers, null, self::HEAD, $options); } /** * Send a DELETE request */ public static function delete($url, $headers = [], $options = []) { return self::request($url, $headers, null, self::DELETE, $options); } /** * Send a TRACE request */ public static function trace($url, $headers = [], $options = []) { return self::request($url, $headers, null, self::TRACE, $options); } /**#@-*/ /**#@+ * @see \WpOrg\Requests\Requests::request() * @param string $url * @param array $headers * @param array $data * @param array $options * @return \WpOrg\Requests\Response */ /** * Send a POST request */ public static function post($url, $headers = [], $data = [], $options = []) { return self::request($url, $headers, $data, self::POST, $options); } /** * Send a PUT request */ public static function put($url, $headers = [], $data = [], $options = []) { return self::request($url, $headers, $data, self::PUT, $options); } /** * Send an OPTIONS request */ public static function options($url, $headers = [], $data = [], $options = []) { return self::request($url, $headers, $data, self::OPTIONS, $options); } /** * Send a PATCH request * * Note: Unlike {@see \WpOrg\Requests\Requests::post()} and {@see \WpOrg\Requests\Requests::put()}, * `$headers` is required, as the specification recommends that should send an ETag * * @link https://tools.ietf.org/html/rfc5789 */ public static function patch($url, $headers, $data = [], $options = []) { return self::request($url, $headers, $data, self::PATCH, $options); } /**#@-*/ /** * Main interface for HTTP requests * * This method initiates a request and sends it via a transport before * parsing. * * The `$options` parameter takes an associative array with the following * options: * * - `timeout`: How long should we wait for a response? * Note: for cURL, a minimum of 1 second applies, as DNS resolution * operates at second-resolution only. * (float, seconds with a millisecond precision, default: 10, example: 0.01) * - `connect_timeout`: How long should we wait while trying to connect? * (float, seconds with a millisecond precision, default: 10, example: 0.01) * - `useragent`: Useragent to send to the server * (string, default: php-requests/$version) * - `follow_redirects`: Should we follow 3xx redirects? * (boolean, default: true) * - `redirects`: How many times should we redirect before erroring? * (integer, default: 10) * - `blocking`: Should we block processing on this request? * (boolean, default: true) * - `filename`: File to stream the body to instead. * (string|boolean, default: false) * - `auth`: Authentication handler or array of user/password details to use * for Basic authentication * (\WpOrg\Requests\Auth|array|boolean, default: false) * - `proxy`: Proxy details to use for proxy by-passing and authentication * (\WpOrg\Requests\Proxy|array|string|boolean, default: false) * - `max_bytes`: Limit for the response body size. * (integer|boolean, default: false) * - `idn`: Enable IDN parsing * (boolean, default: true) * - `transport`: Custom transport. Either a class name, or a * transport object. Defaults to the first working transport from * {@see \WpOrg\Requests\Requests::getTransport()} * (string|\WpOrg\Requests\Transport, default: {@see \WpOrg\Requests\Requests::getTransport()}) * - `hooks`: Hooks handler. * (\WpOrg\Requests\HookManager, default: new WpOrg\Requests\Hooks()) * - `verify`: Should we verify SSL certificates? Allows passing in a custom * certificate file as a string. (Using true uses the system-wide root * certificate store instead, but this may have different behaviour * across transports.) * (string|boolean, default: certificates/cacert.pem) * - `verifyname`: Should we verify the common name in the SSL certificate? * (boolean, default: true) * - `data_format`: How should we send the `$data` parameter? * (string, one of 'query' or 'body', default: 'query' for * HEAD/GET/DELETE, 'body' for POST/PUT/OPTIONS/PATCH) * * @param string|Stringable $url URL to request * @param array $headers Extra headers to send with the request * @param array|null $data Data to send either as a query string for GET/HEAD requests, or in the body for POST requests * @param string $type HTTP request type (use Requests constants) * @param array $options Options for the request (see description for more information) * @return \WpOrg\Requests\Response * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $url argument is not a string or Stringable. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $type argument is not a string. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $options argument is not an array. * @throws \WpOrg\Requests\Exception On invalid URLs (`nonhttp`) */ public static function request($url, $headers = [], $data = [], $type = self::GET, $options = []) { if (InputValidator::is_string_or_stringable($url) === false) { throw InvalidArgument::create(1, '$url', 'string|Stringable', gettype($url)); } if (is_string($type) === false) { throw InvalidArgument::create(4, '$type', 'string', gettype($type)); } if (is_array($options) === false) { throw InvalidArgument::create(5, '$options', 'array', gettype($options)); } if (empty($options['type'])) { $options['type'] = $type; } $options = array_merge(self::get_default_options(), $options); self::set_defaults($url, $headers, $data, $type, $options); $options['hooks']->dispatch('requests.before_request', [&$url, &$headers, &$data, &$type, &$options]); if (!empty($options['transport'])) { $transport = $options['transport']; if (is_string($options['transport'])) { $transport = new $transport(); } } else { $need_ssl = (stripos($url, 'https://') === 0); $capabilities = [Capability::SSL => $need_ssl]; $transport = self::get_transport($capabilities); } $response = $transport->request($url, $headers, $data, $options); $options['hooks']->dispatch('requests.before_parse', [&$response, $url, $headers, $data, $type, $options]); return self::parse_response($response, $url, $headers, $data, $options); } /** * Send multiple HTTP requests simultaneously * * The `$requests` parameter takes an associative or indexed array of * request fields. The key of each request can be used to match up the * request with the returned data, or with the request passed into your * `multiple.request.complete` callback. * * The request fields value is an associative array with the following keys: * * - `url`: Request URL Same as the `$url` parameter to * {@see \WpOrg\Requests\Requests::request()} * (string, required) * - `headers`: Associative array of header fields. Same as the `$headers` * parameter to {@see \WpOrg\Requests\Requests::request()} * (array, default: `array()`) * - `data`: Associative array of data fields or a string. Same as the * `$data` parameter to {@see \WpOrg\Requests\Requests::request()} * (array|string, default: `array()`) * - `type`: HTTP request type (use \WpOrg\Requests\Requests constants). Same as the `$type` * parameter to {@see \WpOrg\Requests\Requests::request()} * (string, default: `\WpOrg\Requests\Requests::GET`) * - `cookies`: Associative array of cookie name to value, or cookie jar. * (array|\WpOrg\Requests\Cookie\Jar) * * If the `$options` parameter is specified, individual requests will * inherit options from it. This can be used to use a single hooking system, * or set all the types to `\WpOrg\Requests\Requests::POST`, for example. * * In addition, the `$options` parameter takes the following global options: * * - `complete`: A callback for when a request is complete. Takes two * parameters, a \WpOrg\Requests\Response/\WpOrg\Requests\Exception reference, and the * ID from the request array (Note: this can also be overridden on a * per-request basis, although that's a little silly) * (callback) * * @param array $requests Requests data (see description for more information) * @param array $options Global and default options (see {@see \WpOrg\Requests\Requests::request()}) * @return array Responses (either \WpOrg\Requests\Response or a \WpOrg\Requests\Exception object) * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $requests argument is not an array or iterable object with array access. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $options argument is not an array. */ public static function request_multiple($requests, $options = []) { if (InputValidator::has_array_access($requests) === false || InputValidator::is_iterable($requests) === false) { throw InvalidArgument::create(1, '$requests', 'array|ArrayAccess&Traversable', gettype($requests)); } if (is_array($options) === false) { throw InvalidArgument::create(2, '$options', 'array', gettype($options)); } $options = array_merge(self::get_default_options(true), $options); if (!empty($options['hooks'])) { $options['hooks']->register('transport.internal.parse_response', [static::class, 'parse_multiple']); if (!empty($options['complete'])) { $options['hooks']->register('multiple.request.complete', $options['complete']); } } foreach ($requests as $id => &$request) { if (!isset($request['headers'])) { $request['headers'] = []; } if (!isset($request['data'])) { $request['data'] = []; } if (!isset($request['type'])) { $request['type'] = self::GET; } if (!isset($request['options'])) { $request['options'] = $options; $request['options']['type'] = $request['type']; } else { if (empty($request['options']['type'])) { $request['options']['type'] = $request['type']; } $request['options'] = array_merge($options, $request['options']); } self::set_defaults($request['url'], $request['headers'], $request['data'], $request['type'], $request['options']); // Ensure we only hook in once if ($request['options']['hooks'] !== $options['hooks']) { $request['options']['hooks']->register('transport.internal.parse_response', [static::class, 'parse_multiple']); if (!empty($request['options']['complete'])) { $request['options']['hooks']->register('multiple.request.complete', $request['options']['complete']); } } } unset($request); if (!empty($options['transport'])) { $transport = $options['transport']; if (is_string($options['transport'])) { $transport = new $transport(); } } else { $transport = self::get_transport(); } $responses = $transport->request_multiple($requests, $options); foreach ($responses as $id => &$response) { // If our hook got messed with somehow, ensure we end up with the // correct response if (is_string($response)) { $request = $requests[$id]; self::parse_multiple($response, $request); $request['options']['hooks']->dispatch('multiple.request.complete', [&$response, $id]); } } return $responses; } /** * Get the default options * * @see \WpOrg\Requests\Requests::request() for values returned by this method * @param boolean $multirequest Is this a multirequest? * @return array Default option values */ protected static function get_default_options($multirequest = false) { $defaults = static::OPTION_DEFAULTS; $defaults['verify'] = self::$certificate_path; if ($multirequest !== false) { $defaults['complete'] = null; } return $defaults; } /** * Get default certificate path. * * @return string Default certificate path. */ public static function get_certificate_path() { return self::$certificate_path; } /** * Set default certificate path. * * @param string|Stringable|bool $path Certificate path, pointing to a PEM file. * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $url argument is not a string, Stringable or boolean. */ public static function set_certificate_path($path) { if (InputValidator::is_string_or_stringable($path) === false && is_bool($path) === false) { throw InvalidArgument::create(1, '$path', 'string|Stringable|bool', gettype($path)); } self::$certificate_path = $path; } /** * Set the default values * * The $options parameter is updated with the results. * * @param string $url URL to request * @param array $headers Extra headers to send with the request * @param array|null $data Data to send either as a query string for GET/HEAD requests, or in the body for POST requests * @param string $type HTTP request type * @param array $options Options for the request * @return void * * @throws \WpOrg\Requests\Exception When the $url is not an http(s) URL. */ protected static function set_defaults(&$url, &$headers, &$data, &$type, &$options) { if (!preg_match('/^http(s)?:\/\//i', $url, $matches)) { throw new Exception('Only HTTP(S) requests are handled.', 'nonhttp', $url); } if (empty($options['hooks'])) { $options['hooks'] = new Hooks(); } if (is_array($options['auth'])) { $options['auth'] = new Basic($options['auth']); } if ($options['auth'] !== false) { $options['auth']->register($options['hooks']); } if (is_string($options['proxy']) || is_array($options['proxy'])) { $options['proxy'] = new Http($options['proxy']); } if ($options['proxy'] !== false) { $options['proxy']->register($options['hooks']); } if (is_array($options['cookies'])) { $options['cookies'] = new Jar($options['cookies']); } elseif (empty($options['cookies'])) { $options['cookies'] = new Jar(); } if ($options['cookies'] !== false) { $options['cookies']->register($options['hooks']); } if ($options['idn'] !== false) { $iri = new Iri($url); $iri->host = IdnaEncoder::encode($iri->ihost); $url = $iri->uri; } // Massage the type to ensure we support it. $type = strtoupper($type); if (!isset($options['data_format'])) { if (in_array($type, [self::HEAD, self::GET, self::DELETE], true)) { $options['data_format'] = 'query'; } else { $options['data_format'] = 'body'; } } } /** * HTTP response parser * * @param string $headers Full response text including headers and body * @param string $url Original request URL * @param array $req_headers Original $headers array passed to {@link request()}, in case we need to follow redirects * @param array $req_data Original $data array passed to {@link request()}, in case we need to follow redirects * @param array $options Original $options array passed to {@link request()}, in case we need to follow redirects * @return \WpOrg\Requests\Response * * @throws \WpOrg\Requests\Exception On missing head/body separator (`requests.no_crlf_separator`) * @throws \WpOrg\Requests\Exception On missing head/body separator (`noversion`) * @throws \WpOrg\Requests\Exception On missing head/body separator (`toomanyredirects`) */ protected static function parse_response($headers, $url, $req_headers, $req_data, $options) { $return = new Response(); if (!$options['blocking']) { return $return; } $return->raw = $headers; $return->url = (string) $url; $return->body = ''; if (!$options['filename']) { $pos = strpos($headers, "\r\n\r\n"); if ($pos === false) { // Crap! throw new Exception('Missing header/body separator', 'requests.no_crlf_separator'); } $headers = substr($return->raw, 0, $pos); // Headers will always be separated from the body by two new lines - `\n\r\n\r`. $body = substr($return->raw, $pos + 4); if (!empty($body)) { $return->body = $body; } } // Pretend CRLF = LF for compatibility (RFC 2616, section 19.3) $headers = str_replace("\r\n", "\n", $headers); // Unfold headers (replace [CRLF] 1*( SP | HT ) with SP) as per RFC 2616 (section 2.2) $headers = preg_replace('/\n[ \t]/', ' ', $headers); $headers = explode("\n", $headers); preg_match('#^HTTP/(1\.\d)[ \t]+(\d+)#i', array_shift($headers), $matches); if (empty($matches)) { throw new Exception('Response could not be parsed', 'noversion', $headers); } $return->protocol_version = (float) $matches[1]; $return->status_code = (int) $matches[2]; if ($return->status_code >= 200 && $return->status_code < 300) { $return->success = true; } foreach ($headers as $header) { list($key, $value) = explode(':', $header, 2); $value = trim($value); preg_replace('#(\s+)#i', ' ', $value); $return->headers[$key] = $value; } if (isset($return->headers['transfer-encoding'])) { $return->body = self::decode_chunked($return->body); unset($return->headers['transfer-encoding']); } if (isset($return->headers['content-encoding'])) { $return->body = self::decompress($return->body); } //fsockopen and cURL compatibility if (isset($return->headers['connection'])) { unset($return->headers['connection']); } $options['hooks']->dispatch('requests.before_redirect_check', [&$return, $req_headers, $req_data, $options]); if ($return->is_redirect() && $options['follow_redirects'] === true) { if (isset($return->headers['location']) && $options['redirected'] < $options['redirects']) { if ($return->status_code === 303) { $options['type'] = self::GET; } $options['redirected']++; $location = $return->headers['location']; if (strpos($location, 'http://') !== 0 && strpos($location, 'https://') !== 0) { // relative redirect, for compatibility make it absolute $location = Iri::absolutize($url, $location); $location = $location->uri; } $hook_args = [ &$location, &$req_headers, &$req_data, &$options, $return, ]; $options['hooks']->dispatch('requests.before_redirect', $hook_args); $redirected = self::request($location, $req_headers, $req_data, $options['type'], $options); $redirected->history[] = $return; return $redirected; } elseif ($options['redirected'] >= $options['redirects']) { throw new Exception('Too many redirects', 'toomanyredirects', $return); } } $return->redirects = $options['redirected']; $options['hooks']->dispatch('requests.after_request', [&$return, $req_headers, $req_data, $options]); return $return; } /** * Callback for `transport.internal.parse_response` * * Internal use only. Converts a raw HTTP response to a \WpOrg\Requests\Response * while still executing a multiple request. * * `$response` is either set to a \WpOrg\Requests\Response instance, or a \WpOrg\Requests\Exception object * * @param string $response Full response text including headers and body (will be overwritten with Response instance) * @param array $request Request data as passed into {@see \WpOrg\Requests\Requests::request_multiple()} * @return void */ public static function parse_multiple(&$response, $request) { try { $url = $request['url']; $headers = $request['headers']; $data = $request['data']; $options = $request['options']; $response = self::parse_response($response, $url, $headers, $data, $options); } catch (Exception $e) { $response = $e; } } /** * Decoded a chunked body as per RFC 2616 * * @link https://tools.ietf.org/html/rfc2616#section-3.6.1 * @param string $data Chunked body * @return string Decoded body */ protected static function decode_chunked($data) { if (!preg_match('/^([0-9a-f]+)(?:;(?:[\w-]*)(?:=(?:(?:[\w-]*)*|"(?:[^\r\n])*"))?)*\r\n/i', trim($data))) { return $data; } $decoded = ''; $encoded = $data; while (true) { $is_chunked = (bool) preg_match('/^([0-9a-f]+)(?:;(?:[\w-]*)(?:=(?:(?:[\w-]*)*|"(?:[^\r\n])*"))?)*\r\n/i', $encoded, $matches); if (!$is_chunked) { // Looks like it's not chunked after all return $data; } $length = hexdec(trim($matches[1])); if ($length === 0) { // Ignore trailer headers return $decoded; } $chunk_length = strlen($matches[0]); $decoded .= substr($encoded, $chunk_length, $length); $encoded = substr($encoded, $chunk_length + $length + 2); if (trim($encoded) === '0' || empty($encoded)) { return $decoded; } } // We'll never actually get down here // @codeCoverageIgnoreStart } // @codeCoverageIgnoreEnd /** * Convert a key => value array to a 'key: value' array for headers * * @param iterable $dictionary Dictionary of header values * @return array List of headers * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed argument is not iterable. */ public static function flatten($dictionary) { if (InputValidator::is_iterable($dictionary) === false) { throw InvalidArgument::create(1, '$dictionary', 'iterable', gettype($dictionary)); } $return = []; foreach ($dictionary as $key => $value) { $return[] = sprintf('%s: %s', $key, $value); } return $return; } /** * Decompress an encoded body * * Implements gzip, compress and deflate. Guesses which it is by attempting * to decode. * * @param string $data Compressed data in one of the above formats * @return string Decompressed string * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed argument is not a string. */ public static function decompress($data) { if (is_string($data) === false) { throw InvalidArgument::create(1, '$data', 'string', gettype($data)); } if (trim($data) === '') { // Empty body does not need further processing. return $data; } $marker = substr($data, 0, 2); if (!isset(self::$magic_compression_headers[$marker])) { // Not actually compressed. Probably cURL ruining this for us. return $data; } if (function_exists('gzdecode')) { $decoded = @gzdecode($data); if ($decoded !== false) { return $decoded; } } if (function_exists('gzinflate')) { $decoded = @gzinflate($data); if ($decoded !== false) { return $decoded; } } $decoded = self::compatible_gzinflate($data); if ($decoded !== false) { return $decoded; } if (function_exists('gzuncompress')) { $decoded = @gzuncompress($data); if ($decoded !== false) { return $decoded; } } return $data; } /** * Decompression of deflated string while staying compatible with the majority of servers. * * Certain Servers will return deflated data with headers which PHP's gzinflate() * function cannot handle out of the box. The following function has been created from * various snippets on the gzinflate() PHP documentation. * * Warning: Magic numbers within. Due to the potential different formats that the compressed * data may be returned in, some "magic offsets" are needed to ensure proper decompression * takes place. For a simple progmatic way to determine the magic offset in use, see: * https://core.trac.wordpress.org/ticket/18273 * * @since 1.6.0 * @link https://core.trac.wordpress.org/ticket/18273 * @link https://www.php.net/gzinflate#70875 * @link https://www.php.net/gzinflate#77336 * * @param string $gz_data String to decompress. * @return string|bool False on failure. * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed argument is not a string. */ public static function compatible_gzinflate($gz_data) { if (is_string($gz_data) === false) { throw InvalidArgument::create(1, '$gz_data', 'string', gettype($gz_data)); } if (trim($gz_data) === '') { return false; } // Compressed data might contain a full zlib header, if so strip it for // gzinflate() if (substr($gz_data, 0, 3) === "\x1f\x8b\x08") { $i = 10; $flg = ord(substr($gz_data, 3, 1)); if ($flg > 0) { if ($flg & 4) { list($xlen) = unpack('v', substr($gz_data, $i, 2)); $i += 2 + $xlen; } if ($flg & 8) { $i = strpos($gz_data, "\0", $i) + 1; } if ($flg & 16) { $i = strpos($gz_data, "\0", $i) + 1; } if ($flg & 2) { $i += 2; } } $decompressed = self::compatible_gzinflate(substr($gz_data, $i)); if ($decompressed !== false) { return $decompressed; } } // If the data is Huffman Encoded, we must first strip the leading 2 // byte Huffman marker for gzinflate() // The response is Huffman coded by many compressors such as // java.util.zip.Deflater, Ruby's Zlib::Deflate, and .NET's // System.IO.Compression.DeflateStream. // // See https://decompres.blogspot.com/ for a quick explanation of this // data type $huffman_encoded = false; // low nibble of first byte should be 0x08 list(, $first_nibble) = unpack('h', $gz_data); // First 2 bytes should be divisible by 0x1F list(, $first_two_bytes) = unpack('n', $gz_data); if ($first_nibble === 0x08 && ($first_two_bytes % 0x1F) === 0) { $huffman_encoded = true; } if ($huffman_encoded) { $decompressed = @gzinflate(substr($gz_data, 2)); if ($decompressed !== false) { return $decompressed; } } if (substr($gz_data, 0, 4) === "\x50\x4b\x03\x04") { // ZIP file format header // Offset 6: 2 bytes, General-purpose field // Offset 26: 2 bytes, filename length // Offset 28: 2 bytes, optional field length // Offset 30: Filename field, followed by optional field, followed // immediately by data list(, $general_purpose_flag) = unpack('v', substr($gz_data, 6, 2)); // If the file has been compressed on the fly, 0x08 bit is set of // the general purpose field. We can use this to differentiate // between a compressed document, and a ZIP file $zip_compressed_on_the_fly = ((0x08 & $general_purpose_flag) === 0x08); if (!$zip_compressed_on_the_fly) { // Don't attempt to decode a compressed zip file return $gz_data; } // Determine the first byte of data, based on the above ZIP header // offsets: $first_file_start = array_sum(unpack('v2', substr($gz_data, 26, 4))); $decompressed = @gzinflate(substr($gz_data, 30 + $first_file_start)); if ($decompressed !== false) { return $decompressed; } return false; } // Finally fall back to straight gzinflate $decompressed = @gzinflate($gz_data); if ($decompressed !== false) { return $decompressed; } // Fallback for all above failing, not expected, but included for // debugging and preventing regressions and to track stats $decompressed = @gzinflate(substr($gz_data, 2)); if ($decompressed !== false) { return $decompressed; } return false; } } 0 is executed later * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $hook argument is not a string. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $callback argument is not callable. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $priority argument is not an integer. */ public function register($hook, $callback, $priority = 0) { if (is_string($hook) === false) { throw InvalidArgument::create(1, '$hook', 'string', gettype($hook)); } if (is_callable($callback) === false) { throw InvalidArgument::create(2, '$callback', 'callable', gettype($callback)); } if (InputValidator::is_numeric_array_key($priority) === false) { throw InvalidArgument::create(3, '$priority', 'integer', gettype($priority)); } if (!isset($this->hooks[$hook])) { $this->hooks[$hook] = [ $priority => [], ]; } elseif (!isset($this->hooks[$hook][$priority])) { $this->hooks[$hook][$priority] = []; } $this->hooks[$hook][$priority][] = $callback; } /** * Dispatch a message * * @param string $hook Hook name * @param array $parameters Parameters to pass to callbacks * @return boolean Successfulness * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $hook argument is not a string. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $parameters argument is not an array. */ public function dispatch($hook, $parameters = []) { if (is_string($hook) === false) { throw InvalidArgument::create(1, '$hook', 'string', gettype($hook)); } // Check strictly against array, as Array* objects don't work in combination with `call_user_func_array()`. if (is_array($parameters) === false) { throw InvalidArgument::create(2, '$parameters', 'array', gettype($parameters)); } if (empty($this->hooks[$hook])) { return false; } if (!empty($parameters)) { // Strip potential keys from the array to prevent them being interpreted as parameter names in PHP 8.0. $parameters = array_values($parameters); } ksort($this->hooks[$hook]); foreach ($this->hooks[$hook] as $priority => $hooked) { foreach ($hooked as $callback) { $callback(...$parameters); } } return true; } } $capabilities Optional. Associative array of capabilities to test against, i.e. `['' => true]`. * @return bool Whether the transport can be used. */ public static function test($capabilities = []); } callback = $callback; } } /** * Prevent unserialization of the object for security reasons. * * @phpcs:disable PHPCompatibility.FunctionNameRestrictions.NewMagicMethods.__unserializeFound * * @param array $data Restored array of data originally serialized. * * @return void */ #[ReturnTypeWillChange] public function __unserialize($data) {} // phpcs:enable /** * Perform reinitialization tasks. * * Prevents a callback from being injected during unserialization of an object. * * @return void */ public function __wakeup() { unset($this->callback); } /** * Get the current item's value after filtering * * @return string */ #[ReturnTypeWillChange] public function current() { $value = parent::current(); if (is_callable($this->callback)) { $value = call_user_func($this->callback, $value); } return $value; } /** * Prevent creating a PHP value from a stored representation of the object for security reasons. * * @param string $data The serialized string. * * @return void */ #[ReturnTypeWillChange] public function unserialize($data) {} } $value) { $this->offsetSet($offset, $value); } } /** * Check if the given item exists * * @param string $offset Item key * @return boolean Does the item exist? */ #[ReturnTypeWillChange] public function offsetExists($offset) { if (is_string($offset)) { $offset = strtolower($offset); } return isset($this->data[$offset]); } /** * Get the value for the item * * @param string $offset Item key * @return string|null Item value (null if the item key doesn't exist) */ #[ReturnTypeWillChange] public function offsetGet($offset) { if (is_string($offset)) { $offset = strtolower($offset); } if (!isset($this->data[$offset])) { return null; } return $this->data[$offset]; } /** * Set the given item * * @param string $offset Item name * @param string $value Item value * * @throws \WpOrg\Requests\Exception On attempting to use dictionary as list (`invalidset`) */ #[ReturnTypeWillChange] public function offsetSet($offset, $value) { if ($offset === null) { throw new Exception('Object is a dictionary, not a list', 'invalidset'); } if (is_string($offset)) { $offset = strtolower($offset); } $this->data[$offset] = $value; } /** * Unset the given header * * @param string $offset The key for the item to unset. */ #[ReturnTypeWillChange] public function offsetUnset($offset) { if (is_string($offset)) { $offset = strtolower($offset); } unset($this->data[$offset]); } /** * Get an iterator for the data * * @return \ArrayIterator */ #[ReturnTypeWillChange] public function getIterator() { return new ArrayIterator($this->data); } /** * Get the headers as an array * * @return array Header data */ public function getAll() { return $this->data; } } FF01:0:0:0:0:0:0:101 * ::1 -> 0:0:0:0:0:0:0:1 * * @author Alexander Merz * @author elfrink at introweb dot nl * @author Josh Peck * @copyright 2003-2005 The PHP Group * @license https://opensource.org/licenses/bsd-license.php * * @param string|Stringable $ip An IPv6 address * @return string The uncompressed IPv6 address * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed argument is not a string or a stringable object. */ public static function uncompress($ip) { if (InputValidator::is_string_or_stringable($ip) === false) { throw InvalidArgument::create(1, '$ip', 'string|Stringable', gettype($ip)); } $ip = (string) $ip; if (substr_count($ip, '::') !== 1) { return $ip; } list($ip1, $ip2) = explode('::', $ip); $c1 = ($ip1 === '') ? -1 : substr_count($ip1, ':'); $c2 = ($ip2 === '') ? -1 : substr_count($ip2, ':'); if (strpos($ip2, '.') !== false) { $c2++; } if ($c1 === -1 && $c2 === -1) { // :: $ip = '0:0:0:0:0:0:0:0'; } elseif ($c1 === -1) { // ::xxx $fill = str_repeat('0:', 7 - $c2); $ip = str_replace('::', $fill, $ip); } elseif ($c2 === -1) { // xxx:: $fill = str_repeat(':0', 7 - $c1); $ip = str_replace('::', $fill, $ip); } else { // xxx::xxx $fill = ':' . str_repeat('0:', 6 - $c2 - $c1); $ip = str_replace('::', $fill, $ip); } return $ip; } /** * Compresses an IPv6 address * * RFC 4291 allows you to compress consecutive zero pieces in an address to * '::'. This method expects a valid IPv6 address and compresses consecutive * zero pieces to '::'. * * Example: FF01:0:0:0:0:0:0:101 -> FF01::101 * 0:0:0:0:0:0:0:1 -> ::1 * * @see \WpOrg\Requests\Ipv6::uncompress() * * @param string $ip An IPv6 address * @return string The compressed IPv6 address */ public static function compress($ip) { // Prepare the IP to be compressed. // Note: Input validation is handled in the `uncompress()` method, which is the first call made in this method. $ip = self::uncompress($ip); $ip_parts = self::split_v6_v4($ip); // Replace all leading zeros $ip_parts[0] = preg_replace('/(^|:)0+([0-9])/', '\1\2', $ip_parts[0]); // Find bunches of zeros if (preg_match_all('/(?:^|:)(?:0(?::|$))+/', $ip_parts[0], $matches, PREG_OFFSET_CAPTURE)) { $max = 0; $pos = null; foreach ($matches[0] as $match) { if (strlen($match[0]) > $max) { $max = strlen($match[0]); $pos = $match[1]; } } $ip_parts[0] = substr_replace($ip_parts[0], '::', $pos, $max); } if ($ip_parts[1] !== '') { return implode(':', $ip_parts); } else { return $ip_parts[0]; } } /** * Splits an IPv6 address into the IPv6 and IPv4 representation parts * * RFC 4291 allows you to represent the last two parts of an IPv6 address * using the standard IPv4 representation * * Example: 0:0:0:0:0:0:13.1.68.3 * 0:0:0:0:0:FFFF:129.144.52.38 * * @param string $ip An IPv6 address * @return string[] [0] contains the IPv6 represented part, and [1] the IPv4 represented part */ private static function split_v6_v4($ip) { if (strpos($ip, '.') !== false) { $pos = strrpos($ip, ':'); $ipv6_part = substr($ip, 0, $pos); $ipv4_part = substr($ip, $pos + 1); return [$ipv6_part, $ipv4_part]; } else { return [$ip, '']; } } /** * Checks an IPv6 address * * Checks if the given IP is a valid IPv6 address * * @param string $ip An IPv6 address * @return bool true if $ip is a valid IPv6 address */ public static function check_ipv6($ip) { // Note: Input validation is handled in the `uncompress()` method, which is the first call made in this method. $ip = self::uncompress($ip); list($ipv6, $ipv4) = self::split_v6_v4($ip); $ipv6 = explode(':', $ipv6); $ipv4 = explode('.', $ipv4); if ((count($ipv6) === 8 && count($ipv4) === 1) || (count($ipv6) === 6 && count($ipv4) === 4)) { foreach ($ipv6 as $ipv6_part) { // The section can't be empty if ($ipv6_part === '') { return false; } // Nor can it be over four characters if (strlen($ipv6_part) > 4) { return false; } // Remove leading zeros (this is safe because of the above) $ipv6_part = ltrim($ipv6_part, '0'); if ($ipv6_part === '') { $ipv6_part = '0'; } // Check the value is valid $value = hexdec($ipv6_part); if (dechex($value) !== strtolower($ipv6_part) || $value < 0 || $value > 0xFFFF) { return false; } } if (count($ipv4) === 4) { foreach ($ipv4 as $ipv4_part) { $value = (int) $ipv4_part; if ((string) $value !== $ipv4_part || $value < 0 || $value > 0xFF) { return false; } } } return true; } else { return false; } } } proxy = $args; } elseif (is_array($args)) { if (count($args) === 1) { list($this->proxy) = $args; } elseif (count($args) === 3) { list($this->proxy, $this->user, $this->pass) = $args; $this->use_authentication = true; } else { throw ArgumentCount::create( 'an array with exactly one element or exactly three elements', count($args), 'proxyhttpbadargs' ); } } elseif ($args !== null) { throw InvalidArgument::create(1, '$args', 'array|string|null', gettype($args)); } } /** * Register the necessary callbacks * * @since 1.6 * @see \WpOrg\Requests\Proxy\Http::curl_before_send() * @see \WpOrg\Requests\Proxy\Http::fsockopen_remote_socket() * @see \WpOrg\Requests\Proxy\Http::fsockopen_remote_host_path() * @see \WpOrg\Requests\Proxy\Http::fsockopen_header() * @param \WpOrg\Requests\Hooks $hooks Hook system */ public function register(Hooks $hooks) { $hooks->register('curl.before_send', [$this, 'curl_before_send']); $hooks->register('fsockopen.remote_socket', [$this, 'fsockopen_remote_socket']); $hooks->register('fsockopen.remote_host_path', [$this, 'fsockopen_remote_host_path']); if ($this->use_authentication) { $hooks->register('fsockopen.after_headers', [$this, 'fsockopen_header']); } } /** * Set cURL parameters before the data is sent * * @since 1.6 * @param resource|\CurlHandle $handle cURL handle */ public function curl_before_send(&$handle) { curl_setopt($handle, CURLOPT_PROXYTYPE, CURLPROXY_HTTP); curl_setopt($handle, CURLOPT_PROXY, $this->proxy); if ($this->use_authentication) { curl_setopt($handle, CURLOPT_PROXYAUTH, CURLAUTH_ANY); curl_setopt($handle, CURLOPT_PROXYUSERPWD, $this->get_auth_string()); } } /** * Alter remote socket information before opening socket connection * * @since 1.6 * @param string $remote_socket Socket connection string */ public function fsockopen_remote_socket(&$remote_socket) { $remote_socket = $this->proxy; } /** * Alter remote path before getting stream data * * @since 1.6 * @param string $path Path to send in HTTP request string ("GET ...") * @param string $url Full URL we're requesting */ public function fsockopen_remote_host_path(&$path, $url) { $path = $url; } /** * Add extra headers to the request before sending * * @since 1.6 * @param string $out HTTP header string */ public function fsockopen_header(&$out) { $out .= sprintf("Proxy-Authorization: Basic %s\r\n", base64_encode($this->get_auth_string())); } /** * Get the authentication string (user:pass) * * @since 1.6 * @return string */ public function get_auth_string() { return $this->user . ':' . $this->pass; } } array( 'port' => Port::ACAP, ), 'dict' => array( 'port' => Port::DICT, ), 'file' => array( 'ihost' => 'localhost', ), 'http' => array( 'port' => Port::HTTP, ), 'https' => array( 'port' => Port::HTTPS, ), ); /** * Return the entire IRI when you try and read the object as a string * * @return string */ public function __toString() { return $this->get_iri(); } /** * Overload __set() to provide access via properties * * @param string $name Property name * @param mixed $value Property value */ public function __set($name, $value) { if (method_exists($this, 'set_' . $name)) { call_user_func(array($this, 'set_' . $name), $value); } elseif ( $name === 'iauthority' || $name === 'iuserinfo' || $name === 'ihost' || $name === 'ipath' || $name === 'iquery' || $name === 'ifragment' ) { call_user_func(array($this, 'set_' . substr($name, 1)), $value); } } /** * Overload __get() to provide access via properties * * @param string $name Property name * @return mixed */ public function __get($name) { // isset() returns false for null, we don't want to do that // Also why we use array_key_exists below instead of isset() $props = get_object_vars($this); if ( $name === 'iri' || $name === 'uri' || $name === 'iauthority' || $name === 'authority' ) { $method = 'get_' . $name; $return = $this->$method(); } elseif (array_key_exists($name, $props)) { $return = $this->$name; } // host -> ihost elseif (($prop = 'i' . $name) && array_key_exists($prop, $props)) { $name = $prop; $return = $this->$prop; } // ischeme -> scheme elseif (($prop = substr($name, 1)) && array_key_exists($prop, $props)) { $name = $prop; $return = $this->$prop; } else { trigger_error('Undefined property: ' . get_class($this) . '::' . $name, E_USER_NOTICE); $return = null; } if ($return === null && isset($this->normalization[$this->scheme][$name])) { return $this->normalization[$this->scheme][$name]; } else { return $return; } } /** * Overload __isset() to provide access via properties * * @param string $name Property name * @return bool */ public function __isset($name) { return (method_exists($this, 'get_' . $name) || isset($this->$name)); } /** * Overload __unset() to provide access via properties * * @param string $name Property name */ public function __unset($name) { if (method_exists($this, 'set_' . $name)) { call_user_func(array($this, 'set_' . $name), ''); } } /** * Create a new IRI object, from a specified string * * @param string|Stringable|null $iri * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $iri argument is not a string, Stringable or null. */ public function __construct($iri = null) { if ($iri !== null && InputValidator::is_string_or_stringable($iri) === false) { throw InvalidArgument::create(1, '$iri', 'string|Stringable|null', gettype($iri)); } $this->set_iri($iri); } /** * Create a new IRI object by resolving a relative IRI * * Returns false if $base is not absolute, otherwise an IRI. * * @param \WpOrg\Requests\Iri|string $base (Absolute) Base IRI * @param \WpOrg\Requests\Iri|string $relative Relative IRI * @return \WpOrg\Requests\Iri|false */ public static function absolutize($base, $relative) { if (!($relative instanceof self)) { $relative = new self($relative); } if (!$relative->is_valid()) { return false; } elseif ($relative->scheme !== null) { return clone $relative; } if (!($base instanceof self)) { $base = new self($base); } if ($base->scheme === null || !$base->is_valid()) { return false; } if ($relative->get_iri() !== '') { if ($relative->iuserinfo !== null || $relative->ihost !== null || $relative->port !== null) { $target = clone $relative; $target->scheme = $base->scheme; } else { $target = new self; $target->scheme = $base->scheme; $target->iuserinfo = $base->iuserinfo; $target->ihost = $base->ihost; $target->port = $base->port; if ($relative->ipath !== '') { if ($relative->ipath[0] === '/') { $target->ipath = $relative->ipath; } elseif (($base->iuserinfo !== null || $base->ihost !== null || $base->port !== null) && $base->ipath === '') { $target->ipath = '/' . $relative->ipath; } elseif (($last_segment = strrpos($base->ipath, '/')) !== false) { $target->ipath = substr($base->ipath, 0, $last_segment + 1) . $relative->ipath; } else { $target->ipath = $relative->ipath; } $target->ipath = $target->remove_dot_segments($target->ipath); $target->iquery = $relative->iquery; } else { $target->ipath = $base->ipath; if ($relative->iquery !== null) { $target->iquery = $relative->iquery; } elseif ($base->iquery !== null) { $target->iquery = $base->iquery; } } $target->ifragment = $relative->ifragment; } } else { $target = clone $base; $target->ifragment = null; } $target->scheme_normalization(); return $target; } /** * Parse an IRI into scheme/authority/path/query/fragment segments * * @param string $iri * @return array */ protected function parse_iri($iri) { $iri = trim($iri, "\x20\x09\x0A\x0C\x0D"); $has_match = preg_match('/^((?P[^:\/?#]+):)?(\/\/(?P[^\/?#]*))?(?P[^?#]*)(\?(?P[^#]*))?(#(?P.*))?$/', $iri, $match); if (!$has_match) { throw new Exception('Cannot parse supplied IRI', 'iri.cannot_parse', $iri); } if ($match[1] === '') { $match['scheme'] = null; } if (!isset($match[3]) || $match[3] === '') { $match['authority'] = null; } if (!isset($match[5])) { $match['path'] = ''; } if (!isset($match[6]) || $match[6] === '') { $match['query'] = null; } if (!isset($match[8]) || $match[8] === '') { $match['fragment'] = null; } return $match; } /** * Remove dot segments from a path * * @param string $input * @return string */ protected function remove_dot_segments($input) { $output = ''; while (strpos($input, './') !== false || strpos($input, '/.') !== false || $input === '.' || $input === '..') { // A: If the input buffer begins with a prefix of "../" or "./", // then remove that prefix from the input buffer; otherwise, if (strpos($input, '../') === 0) { $input = substr($input, 3); } elseif (strpos($input, './') === 0) { $input = substr($input, 2); } // B: if the input buffer begins with a prefix of "/./" or "/.", // where "." is a complete path segment, then replace that prefix // with "/" in the input buffer; otherwise, elseif (strpos($input, '/./') === 0) { $input = substr($input, 2); } elseif ($input === '/.') { $input = '/'; } // C: if the input buffer begins with a prefix of "/../" or "/..", // where ".." is a complete path segment, then replace that prefix // with "/" in the input buffer and remove the last segment and its // preceding "/" (if any) from the output buffer; otherwise, elseif (strpos($input, '/../') === 0) { $input = substr($input, 3); $output = substr_replace($output, '', (strrpos($output, '/') ?: 0)); } elseif ($input === '/..') { $input = '/'; $output = substr_replace($output, '', (strrpos($output, '/') ?: 0)); } // D: if the input buffer consists only of "." or "..", then remove // that from the input buffer; otherwise, elseif ($input === '.' || $input === '..') { $input = ''; } // E: move the first path segment in the input buffer to the end of // the output buffer, including the initial "/" character (if any) // and any subsequent characters up to, but not including, the next // "/" character or the end of the input buffer elseif (($pos = strpos($input, '/', 1)) !== false) { $output .= substr($input, 0, $pos); $input = substr_replace($input, '', 0, $pos); } else { $output .= $input; $input = ''; } } return $output . $input; } /** * Replace invalid character with percent encoding * * @param string $text Input string * @param string $extra_chars Valid characters not in iunreserved or * iprivate (this is ASCII-only) * @param bool $iprivate Allow iprivate * @return string */ protected function replace_invalid_with_pct_encoding($text, $extra_chars, $iprivate = false) { // Normalize as many pct-encoded sections as possible $text = preg_replace_callback('/(?:%[A-Fa-f0-9]{2})+/', array($this, 'remove_iunreserved_percent_encoded'), $text); // Replace invalid percent characters $text = preg_replace('/%(?![A-Fa-f0-9]{2})/', '%25', $text); // Add unreserved and % to $extra_chars (the latter is safe because all // pct-encoded sections are now valid). $extra_chars .= 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~%'; // Now replace any bytes that aren't allowed with their pct-encoded versions $position = 0; $strlen = strlen($text); while (($position += strspn($text, $extra_chars, $position)) < $strlen) { $value = ord($text[$position]); // Start position $start = $position; // By default we are valid $valid = true; // No one byte sequences are valid due to the while. // Two byte sequence: if (($value & 0xE0) === 0xC0) { $character = ($value & 0x1F) << 6; $length = 2; $remaining = 1; } // Three byte sequence: elseif (($value & 0xF0) === 0xE0) { $character = ($value & 0x0F) << 12; $length = 3; $remaining = 2; } // Four byte sequence: elseif (($value & 0xF8) === 0xF0) { $character = ($value & 0x07) << 18; $length = 4; $remaining = 3; } // Invalid byte: else { $valid = false; $length = 1; $remaining = 0; } if ($remaining) { if ($position + $length <= $strlen) { for ($position++; $remaining; $position++) { $value = ord($text[$position]); // Check that the byte is valid, then add it to the character: if (($value & 0xC0) === 0x80) { $character |= ($value & 0x3F) << (--$remaining * 6); } // If it is invalid, count the sequence as invalid and reprocess the current byte: else { $valid = false; $position--; break; } } } else { $position = $strlen - 1; $valid = false; } } // Percent encode anything invalid or not in ucschar if ( // Invalid sequences !$valid // Non-shortest form sequences are invalid || $length > 1 && $character <= 0x7F || $length > 2 && $character <= 0x7FF || $length > 3 && $character <= 0xFFFF // Outside of range of ucschar codepoints // Noncharacters || ($character & 0xFFFE) === 0xFFFE || $character >= 0xFDD0 && $character <= 0xFDEF || ( // Everything else not in ucschar $character > 0xD7FF && $character < 0xF900 || $character < 0xA0 || $character > 0xEFFFD ) && ( // Everything not in iprivate, if it applies !$iprivate || $character < 0xE000 || $character > 0x10FFFD ) ) { // If we were a character, pretend we weren't, but rather an error. if ($valid) { $position--; } for ($j = $start; $j <= $position; $j++) { $text = substr_replace($text, sprintf('%%%02X', ord($text[$j])), $j, 1); $j += 2; $position += 2; $strlen += 2; } } } return $text; } /** * Callback function for preg_replace_callback. * * Removes sequences of percent encoded bytes that represent UTF-8 * encoded characters in iunreserved * * @param array $regex_match PCRE match * @return string Replacement */ protected function remove_iunreserved_percent_encoded($regex_match) { // As we just have valid percent encoded sequences we can just explode // and ignore the first member of the returned array (an empty string). $bytes = explode('%', $regex_match[0]); // Initialize the new string (this is what will be returned) and that // there are no bytes remaining in the current sequence (unsurprising // at the first byte!). $string = ''; $remaining = 0; // Loop over each and every byte, and set $value to its value for ($i = 1, $len = count($bytes); $i < $len; $i++) { $value = hexdec($bytes[$i]); // If we're the first byte of sequence: if (!$remaining) { // Start position $start = $i; // By default we are valid $valid = true; // One byte sequence: if ($value <= 0x7F) { $character = $value; $length = 1; } // Two byte sequence: elseif (($value & 0xE0) === 0xC0) { $character = ($value & 0x1F) << 6; $length = 2; $remaining = 1; } // Three byte sequence: elseif (($value & 0xF0) === 0xE0) { $character = ($value & 0x0F) << 12; $length = 3; $remaining = 2; } // Four byte sequence: elseif (($value & 0xF8) === 0xF0) { $character = ($value & 0x07) << 18; $length = 4; $remaining = 3; } // Invalid byte: else { $valid = false; $remaining = 0; } } // Continuation byte: else { // Check that the byte is valid, then add it to the character: if (($value & 0xC0) === 0x80) { $remaining--; $character |= ($value & 0x3F) << ($remaining * 6); } // If it is invalid, count the sequence as invalid and reprocess the current byte as the start of a sequence: else { $valid = false; $remaining = 0; $i--; } } // If we've reached the end of the current byte sequence, append it to Unicode::$data if (!$remaining) { // Percent encode anything invalid or not in iunreserved if ( // Invalid sequences !$valid // Non-shortest form sequences are invalid || $length > 1 && $character <= 0x7F || $length > 2 && $character <= 0x7FF || $length > 3 && $character <= 0xFFFF // Outside of range of iunreserved codepoints || $character < 0x2D || $character > 0xEFFFD // Noncharacters || ($character & 0xFFFE) === 0xFFFE || $character >= 0xFDD0 && $character <= 0xFDEF // Everything else not in iunreserved (this is all BMP) || $character === 0x2F || $character > 0x39 && $character < 0x41 || $character > 0x5A && $character < 0x61 || $character > 0x7A && $character < 0x7E || $character > 0x7E && $character < 0xA0 || $character > 0xD7FF && $character < 0xF900 ) { for ($j = $start; $j <= $i; $j++) { $string .= '%' . strtoupper($bytes[$j]); } } else { for ($j = $start; $j <= $i; $j++) { $string .= chr(hexdec($bytes[$j])); } } } } // If we have any bytes left over they are invalid (i.e., we are // mid-way through a multi-byte sequence) if ($remaining) { for ($j = $start; $j < $len; $j++) { $string .= '%' . strtoupper($bytes[$j]); } } return $string; } protected function scheme_normalization() { if (isset($this->normalization[$this->scheme]['iuserinfo']) && $this->iuserinfo === $this->normalization[$this->scheme]['iuserinfo']) { $this->iuserinfo = null; } if (isset($this->normalization[$this->scheme]['ihost']) && $this->ihost === $this->normalization[$this->scheme]['ihost']) { $this->ihost = null; } if (isset($this->normalization[$this->scheme]['port']) && $this->port === $this->normalization[$this->scheme]['port']) { $this->port = null; } if (isset($this->normalization[$this->scheme]['ipath']) && $this->ipath === $this->normalization[$this->scheme]['ipath']) { $this->ipath = ''; } if (isset($this->ihost) && empty($this->ipath)) { $this->ipath = '/'; } if (isset($this->normalization[$this->scheme]['iquery']) && $this->iquery === $this->normalization[$this->scheme]['iquery']) { $this->iquery = null; } if (isset($this->normalization[$this->scheme]['ifragment']) && $this->ifragment === $this->normalization[$this->scheme]['ifragment']) { $this->ifragment = null; } } /** * Check if the object represents a valid IRI. This needs to be done on each * call as some things change depending on another part of the IRI. * * @return bool */ public function is_valid() { $isauthority = $this->iuserinfo !== null || $this->ihost !== null || $this->port !== null; if ($this->ipath !== '' && ( $isauthority && $this->ipath[0] !== '/' || ( $this->scheme === null && !$isauthority && strpos($this->ipath, ':') !== false && (strpos($this->ipath, '/') === false ? true : strpos($this->ipath, ':') < strpos($this->ipath, '/')) ) ) ) { return false; } return true; } /** * Set the entire IRI. Returns true on success, false on failure (if there * are any invalid characters). * * @param string $iri * @return bool */ protected function set_iri($iri) { static $cache; if (!$cache) { $cache = array(); } if ($iri === null) { return true; } $iri = (string) $iri; if (isset($cache[$iri])) { list($this->scheme, $this->iuserinfo, $this->ihost, $this->port, $this->ipath, $this->iquery, $this->ifragment, $return) = $cache[$iri]; return $return; } $parsed = $this->parse_iri($iri); $return = $this->set_scheme($parsed['scheme']) && $this->set_authority($parsed['authority']) && $this->set_path($parsed['path']) && $this->set_query($parsed['query']) && $this->set_fragment($parsed['fragment']); $cache[$iri] = array($this->scheme, $this->iuserinfo, $this->ihost, $this->port, $this->ipath, $this->iquery, $this->ifragment, $return); return $return; } /** * Set the scheme. Returns true on success, false on failure (if there are * any invalid characters). * * @param string $scheme * @return bool */ protected function set_scheme($scheme) { if ($scheme === null) { $this->scheme = null; } elseif (!preg_match('/^[A-Za-z][0-9A-Za-z+\-.]*$/', $scheme)) { $this->scheme = null; return false; } else { $this->scheme = strtolower($scheme); } return true; } /** * Set the authority. Returns true on success, false on failure (if there are * any invalid characters). * * @param string $authority * @return bool */ protected function set_authority($authority) { static $cache; if (!$cache) { $cache = array(); } if ($authority === null) { $this->iuserinfo = null; $this->ihost = null; $this->port = null; return true; } if (isset($cache[$authority])) { list($this->iuserinfo, $this->ihost, $this->port, $return) = $cache[$authority]; return $return; } $remaining = $authority; if (($iuserinfo_end = strrpos($remaining, '@')) !== false) { $iuserinfo = substr($remaining, 0, $iuserinfo_end); $remaining = substr($remaining, $iuserinfo_end + 1); } else { $iuserinfo = null; } if (($port_start = strpos($remaining, ':', (strpos($remaining, ']') ?: 0))) !== false) { $port = substr($remaining, $port_start + 1); if ($port === false || $port === '') { $port = null; } $remaining = substr($remaining, 0, $port_start); } else { $port = null; } $return = $this->set_userinfo($iuserinfo) && $this->set_host($remaining) && $this->set_port($port); $cache[$authority] = array($this->iuserinfo, $this->ihost, $this->port, $return); return $return; } /** * Set the iuserinfo. * * @param string $iuserinfo * @return bool */ protected function set_userinfo($iuserinfo) { if ($iuserinfo === null) { $this->iuserinfo = null; } else { $this->iuserinfo = $this->replace_invalid_with_pct_encoding($iuserinfo, '!$&\'()*+,;=:'); $this->scheme_normalization(); } return true; } /** * Set the ihost. Returns true on success, false on failure (if there are * any invalid characters). * * @param string $ihost * @return bool */ protected function set_host($ihost) { if ($ihost === null) { $this->ihost = null; return true; } if (substr($ihost, 0, 1) === '[' && substr($ihost, -1) === ']') { if (Ipv6::check_ipv6(substr($ihost, 1, -1))) { $this->ihost = '[' . Ipv6::compress(substr($ihost, 1, -1)) . ']'; } else { $this->ihost = null; return false; } } else { $ihost = $this->replace_invalid_with_pct_encoding($ihost, '!$&\'()*+,;='); // Lowercase, but ignore pct-encoded sections (as they should // remain uppercase). This must be done after the previous step // as that can add unescaped characters. $position = 0; $strlen = strlen($ihost); while (($position += strcspn($ihost, 'ABCDEFGHIJKLMNOPQRSTUVWXYZ%', $position)) < $strlen) { if ($ihost[$position] === '%') { $position += 3; } else { $ihost[$position] = strtolower($ihost[$position]); $position++; } } $this->ihost = $ihost; } $this->scheme_normalization(); return true; } /** * Set the port. Returns true on success, false on failure (if there are * any invalid characters). * * @param string $port * @return bool */ protected function set_port($port) { if ($port === null) { $this->port = null; return true; } if (strspn($port, '0123456789') === strlen($port)) { $this->port = (int) $port; $this->scheme_normalization(); return true; } $this->port = null; return false; } /** * Set the ipath. * * @param string $ipath * @return bool */ protected function set_path($ipath) { static $cache; if (!$cache) { $cache = array(); } $ipath = (string) $ipath; if (isset($cache[$ipath])) { $this->ipath = $cache[$ipath][(int) ($this->scheme !== null)]; } else { $valid = $this->replace_invalid_with_pct_encoding($ipath, '!$&\'()*+,;=@:/'); $removed = $this->remove_dot_segments($valid); $cache[$ipath] = array($valid, $removed); $this->ipath = ($this->scheme !== null) ? $removed : $valid; } $this->scheme_normalization(); return true; } /** * Set the iquery. * * @param string $iquery * @return bool */ protected function set_query($iquery) { if ($iquery === null) { $this->iquery = null; } else { $this->iquery = $this->replace_invalid_with_pct_encoding($iquery, '!$&\'()*+,;=:@/?', true); $this->scheme_normalization(); } return true; } /** * Set the ifragment. * * @param string $ifragment * @return bool */ protected function set_fragment($ifragment) { if ($ifragment === null) { $this->ifragment = null; } else { $this->ifragment = $this->replace_invalid_with_pct_encoding($ifragment, '!$&\'()*+,;=:@/?'); $this->scheme_normalization(); } return true; } /** * Convert an IRI to a URI (or parts thereof) * * @param string|bool $iri IRI to convert (or false from {@see \WpOrg\Requests\Iri::get_iri()}) * @return string|false URI if IRI is valid, false otherwise. */ protected function to_uri($iri) { if (!is_string($iri)) { return false; } static $non_ascii; if (!$non_ascii) { $non_ascii = implode('', range("\x80", "\xFF")); } $position = 0; $strlen = strlen($iri); while (($position += strcspn($iri, $non_ascii, $position)) < $strlen) { $iri = substr_replace($iri, sprintf('%%%02X', ord($iri[$position])), $position, 1); $position += 3; $strlen += 2; } return $iri; } /** * Get the complete IRI * * @return string|false */ protected function get_iri() { if (!$this->is_valid()) { return false; } $iri = ''; if ($this->scheme !== null) { $iri .= $this->scheme . ':'; } if (($iauthority = $this->get_iauthority()) !== null) { $iri .= '//' . $iauthority; } $iri .= $this->ipath; if ($this->iquery !== null) { $iri .= '?' . $this->iquery; } if ($this->ifragment !== null) { $iri .= '#' . $this->ifragment; } return $iri; } /** * Get the complete URI * * @return string */ protected function get_uri() { return $this->to_uri($this->get_iri()); } /** * Get the complete iauthority * * @return string|null */ protected function get_iauthority() { if ($this->iuserinfo === null && $this->ihost === null && $this->port === null) { return null; } $iauthority = ''; if ($this->iuserinfo !== null) { $iauthority .= $this->iuserinfo . '@'; } if ($this->ihost !== null) { $iauthority .= $this->ihost; } if ($this->port !== null) { $iauthority .= ':' . $this->port; } return $iauthority; } /** * Get the complete authority * * @return string */ protected function get_authority() { $iauthority = $this->get_iauthority(); if (is_string($iauthority)) { return $this->to_uri($iauthority); } else { return $iauthority; } } } user, $this->pass) = $args; return; } if ($args !== null) { throw InvalidArgument::create(1, '$args', 'array|null', gettype($args)); } } /** * Register the necessary callbacks * * @see \WpOrg\Requests\Auth\Basic::curl_before_send() * @see \WpOrg\Requests\Auth\Basic::fsockopen_header() * @param \WpOrg\Requests\Hooks $hooks Hook system */ public function register(Hooks $hooks) { $hooks->register('curl.before_send', [$this, 'curl_before_send']); $hooks->register('fsockopen.after_headers', [$this, 'fsockopen_header']); } /** * Set cURL parameters before the data is sent * * @param resource|\CurlHandle $handle cURL handle */ public function curl_before_send(&$handle) { curl_setopt($handle, CURLOPT_HTTPAUTH, CURLAUTH_BASIC); curl_setopt($handle, CURLOPT_USERPWD, $this->getAuthString()); } /** * Add extra headers to the request before sending * * @param string $out HTTP header string */ public function fsockopen_header(&$out) { $out .= sprintf("Authorization: Basic %s\r\n", base64_encode($this->getAuthString())); } /** * Get the authentication string (user:pass) * * @return string */ public function getAuthString() { return $this->user . ':' . $this->pass; } } useragent = 'X';` * * @var array */ public $options = []; /** * Create a new session * * @param string|Stringable|null $url Base URL for requests * @param array $headers Default headers for requests * @param array $data Default data for requests * @param array $options Default options for requests * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $url argument is not a string, Stringable or null. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $headers argument is not an array. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $data argument is not an array. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $options argument is not an array. */ public function __construct($url = null, $headers = [], $data = [], $options = []) { if ($url !== null && InputValidator::is_string_or_stringable($url) === false) { throw InvalidArgument::create(1, '$url', 'string|Stringable|null', gettype($url)); } if (is_array($headers) === false) { throw InvalidArgument::create(2, '$headers', 'array', gettype($headers)); } if (is_array($data) === false) { throw InvalidArgument::create(3, '$data', 'array', gettype($data)); } if (is_array($options) === false) { throw InvalidArgument::create(4, '$options', 'array', gettype($options)); } $this->url = $url; $this->headers = $headers; $this->data = $data; $this->options = $options; if (empty($this->options['cookies'])) { $this->options['cookies'] = new Jar(); } } /** * Get a property's value * * @param string $name Property name. * @return mixed|null Property value, null if none found */ public function __get($name) { if (isset($this->options[$name])) { return $this->options[$name]; } return null; } /** * Set a property's value * * @param string $name Property name. * @param mixed $value Property value */ public function __set($name, $value) { $this->options[$name] = $value; } /** * Remove a property's value * * @param string $name Property name. */ public function __isset($name) { return isset($this->options[$name]); } /** * Remove a property's value * * @param string $name Property name. */ public function __unset($name) { unset($this->options[$name]); } /**#@+ * @see \WpOrg\Requests\Session::request() * @param string $url * @param array $headers * @param array $options * @return \WpOrg\Requests\Response */ /** * Send a GET request */ public function get($url, $headers = [], $options = []) { return $this->request($url, $headers, null, Requests::GET, $options); } /** * Send a HEAD request */ public function head($url, $headers = [], $options = []) { return $this->request($url, $headers, null, Requests::HEAD, $options); } /** * Send a DELETE request */ public function delete($url, $headers = [], $options = []) { return $this->request($url, $headers, null, Requests::DELETE, $options); } /**#@-*/ /**#@+ * @see \WpOrg\Requests\Session::request() * @param string $url * @param array $headers * @param array $data * @param array $options * @return \WpOrg\Requests\Response */ /** * Send a POST request */ public function post($url, $headers = [], $data = [], $options = []) { return $this->request($url, $headers, $data, Requests::POST, $options); } /** * Send a PUT request */ public function put($url, $headers = [], $data = [], $options = []) { return $this->request($url, $headers, $data, Requests::PUT, $options); } /** * Send a PATCH request * * Note: Unlike {@see \WpOrg\Requests\Session::post()} and {@see \WpOrg\Requests\Session::put()}, * `$headers` is required, as the specification recommends that should send an ETag * * @link https://tools.ietf.org/html/rfc5789 */ public function patch($url, $headers, $data = [], $options = []) { return $this->request($url, $headers, $data, Requests::PATCH, $options); } /**#@-*/ /** * Main interface for HTTP requests * * This method initiates a request and sends it via a transport before * parsing. * * @see \WpOrg\Requests\Requests::request() * * @param string $url URL to request * @param array $headers Extra headers to send with the request * @param array|null $data Data to send either as a query string for GET/HEAD requests, or in the body for POST requests * @param string $type HTTP request type (use \WpOrg\Requests\Requests constants) * @param array $options Options for the request (see {@see \WpOrg\Requests\Requests::request()}) * @return \WpOrg\Requests\Response * * @throws \WpOrg\Requests\Exception On invalid URLs (`nonhttp`) */ public function request($url, $headers = [], $data = [], $type = Requests::GET, $options = []) { $request = $this->merge_request(compact('url', 'headers', 'data', 'options')); return Requests::request($request['url'], $request['headers'], $request['data'], $type, $request['options']); } /** * Send multiple HTTP requests simultaneously * * @see \WpOrg\Requests\Requests::request_multiple() * * @param array $requests Requests data (see {@see \WpOrg\Requests\Requests::request_multiple()}) * @param array $options Global and default options (see {@see \WpOrg\Requests\Requests::request()}) * @return array Responses (either \WpOrg\Requests\Response or a \WpOrg\Requests\Exception object) * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $requests argument is not an array or iterable object with array access. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $options argument is not an array. */ public function request_multiple($requests, $options = []) { if (InputValidator::has_array_access($requests) === false || InputValidator::is_iterable($requests) === false) { throw InvalidArgument::create(1, '$requests', 'array|ArrayAccess&Traversable', gettype($requests)); } if (is_array($options) === false) { throw InvalidArgument::create(2, '$options', 'array', gettype($options)); } foreach ($requests as $key => $request) { $requests[$key] = $this->merge_request($request, false); } $options = array_merge($this->options, $options); // Disallow forcing the type, as that's a per request setting unset($options['type']); return Requests::request_multiple($requests, $options); } /** * Merge a request's data with the default data * * @param array $request Request data (same form as {@see \WpOrg\Requests\Session::request_multiple()}) * @param boolean $merge_options Should we merge options as well? * @return array Request data */ protected function merge_request($request, $merge_options = true) { if ($this->url !== null) { $request['url'] = Iri::absolutize($this->url, $request['url']); $request['url'] = $request['url']->uri; } if (empty($request['headers'])) { $request['headers'] = []; } $request['headers'] = array_merge($this->headers, $request['headers']); if (empty($request['data'])) { if (is_array($this->data)) { $request['data'] = $this->data; } } elseif (is_array($request['data']) && is_array($this->data)) { $request['data'] = array_merge($this->data, $request['data']); } if ($merge_options === true) { $request['options'] = array_merge($this->options, $request['options']); // Disallow forcing the type, as that's a per request setting unset($request['options']['type']); } return $request; } } data[$offset])) { return null; } return $this->flatten($this->data[$offset]); } /** * Set the given item * * @param string $offset Item name * @param string $value Item value * * @throws \WpOrg\Requests\Exception On attempting to use dictionary as list (`invalidset`) */ public function offsetSet($offset, $value) { if ($offset === null) { throw new Exception('Object is a dictionary, not a list', 'invalidset'); } if (is_string($offset)) { $offset = strtolower($offset); } if (!isset($this->data[$offset])) { $this->data[$offset] = []; } $this->data[$offset][] = $value; } /** * Get all values for a given header * * @param string $offset Name of the header to retrieve. * @return array|null Header values * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed argument is not valid as an array key. */ public function getValues($offset) { if (!is_string($offset) && !is_int($offset)) { throw InvalidArgument::create(1, '$offset', 'string|int', gettype($offset)); } if (is_string($offset)) { $offset = strtolower($offset); } if (!isset($this->data[$offset])) { return null; } return $this->data[$offset]; } /** * Flattens a value into a string * * Converts an array into a string by imploding values with a comma, as per * RFC2616's rules for folding headers. * * @param string|array $value Value to flatten * @return string Flattened value * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed argument is not a string or an array. */ public function flatten($value) { if (is_string($value)) { return $value; } if (is_array($value)) { return implode(',', $value); } throw InvalidArgument::create(1, '$value', 'string|array', gettype($value)); } /** * Get an iterator for the data * * Converts the internally stored values to a comma-separated string if there is more * than one value for a key. * * @return \ArrayIterator */ public function getIterator() { return new FilteredIterator($this->data, [$this, 'flatten']); } } name = $name; $this->value = $value; $this->attributes = $attributes; $default_flags = [ 'creation' => time(), 'last-access' => time(), 'persistent' => false, 'host-only' => true, ]; $this->flags = array_merge($default_flags, $flags); $this->reference_time = time(); if ($reference_time !== null) { $this->reference_time = $reference_time; } $this->normalize(); } /** * Get the cookie value * * Attributes and other data can be accessed via methods. */ public function __toString() { return $this->value; } /** * Check if a cookie is expired. * * Checks the age against $this->reference_time to determine if the cookie * is expired. * * @return boolean True if expired, false if time is valid. */ public function is_expired() { // RFC6265, s. 4.1.2.2: // If a cookie has both the Max-Age and the Expires attribute, the Max- // Age attribute has precedence and controls the expiration date of the // cookie. if (isset($this->attributes['max-age'])) { $max_age = $this->attributes['max-age']; return $max_age < $this->reference_time; } if (isset($this->attributes['expires'])) { $expires = $this->attributes['expires']; return $expires < $this->reference_time; } return false; } /** * Check if a cookie is valid for a given URI * * @param \WpOrg\Requests\Iri $uri URI to check * @return boolean Whether the cookie is valid for the given URI */ public function uri_matches(Iri $uri) { if (!$this->domain_matches($uri->host)) { return false; } if (!$this->path_matches($uri->path)) { return false; } return empty($this->attributes['secure']) || $uri->scheme === 'https'; } /** * Check if a cookie is valid for a given domain * * @param string $domain Domain to check * @return boolean Whether the cookie is valid for the given domain */ public function domain_matches($domain) { if (is_string($domain) === false) { return false; } if (!isset($this->attributes['domain'])) { // Cookies created manually; cookies created by Requests will set // the domain to the requested domain return true; } $cookie_domain = $this->attributes['domain']; if ($cookie_domain === $domain) { // The cookie domain and the passed domain are identical. return true; } // If the cookie is marked as host-only and we don't have an exact // match, reject the cookie if ($this->flags['host-only'] === true) { return false; } if (strlen($domain) <= strlen($cookie_domain)) { // For obvious reasons, the cookie domain cannot be a suffix if the passed domain // is shorter than the cookie domain return false; } if (substr($domain, -1 * strlen($cookie_domain)) !== $cookie_domain) { // The cookie domain should be a suffix of the passed domain. return false; } $prefix = substr($domain, 0, strlen($domain) - strlen($cookie_domain)); if (substr($prefix, -1) !== '.') { // The last character of the passed domain that is not included in the // domain string should be a %x2E (".") character. return false; } // The passed domain should be a host name (i.e., not an IP address). return !preg_match('#^(.+\.)\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$#', $domain); } /** * Check if a cookie is valid for a given path * * From the path-match check in RFC 6265 section 5.1.4 * * @param string $request_path Path to check * @return boolean Whether the cookie is valid for the given path */ public function path_matches($request_path) { if (empty($request_path)) { // Normalize empty path to root $request_path = '/'; } if (!isset($this->attributes['path'])) { // Cookies created manually; cookies created by Requests will set // the path to the requested path return true; } if (is_scalar($request_path) === false) { return false; } $cookie_path = $this->attributes['path']; if ($cookie_path === $request_path) { // The cookie-path and the request-path are identical. return true; } if (strlen($request_path) > strlen($cookie_path) && substr($request_path, 0, strlen($cookie_path)) === $cookie_path) { if (substr($cookie_path, -1) === '/') { // The cookie-path is a prefix of the request-path, and the last // character of the cookie-path is %x2F ("/"). return true; } if (substr($request_path, strlen($cookie_path), 1) === '/') { // The cookie-path is a prefix of the request-path, and the // first character of the request-path that is not included in // the cookie-path is a %x2F ("/") character. return true; } } return false; } /** * Normalize cookie and attributes * * @return boolean Whether the cookie was successfully normalized */ public function normalize() { foreach ($this->attributes as $key => $value) { $orig_value = $value; if (is_string($key)) { $value = $this->normalize_attribute($key, $value); } if ($value === null) { unset($this->attributes[$key]); continue; } if ($value !== $orig_value) { $this->attributes[$key] = $value; } } return true; } /** * Parse an individual cookie attribute * * Handles parsing individual attributes from the cookie values. * * @param string $name Attribute name * @param string|int|bool $value Attribute value (string/integer value, or true if empty/flag) * @return mixed Value if available, or null if the attribute value is invalid (and should be skipped) */ protected function normalize_attribute($name, $value) { switch (strtolower($name)) { case 'expires': // Expiration parsing, as per RFC 6265 section 5.2.1 if (is_int($value)) { return $value; } $expiry_time = strtotime($value); if ($expiry_time === false) { return null; } return $expiry_time; case 'max-age': // Expiration parsing, as per RFC 6265 section 5.2.2 if (is_int($value)) { return $value; } // Check that we have a valid age if (!preg_match('/^-?\d+$/', $value)) { return null; } $delta_seconds = (int) $value; if ($delta_seconds <= 0) { $expiry_time = 0; } else { $expiry_time = $this->reference_time + $delta_seconds; } return $expiry_time; case 'domain': // Domains are not required as per RFC 6265 section 5.2.3 if (empty($value)) { return null; } // Domain normalization, as per RFC 6265 section 5.2.3 if ($value[0] === '.') { $value = substr($value, 1); } return $value; default: return $value; } } /** * Format a cookie for a Cookie header * * This is used when sending cookies to a server. * * @return string Cookie formatted for Cookie header */ public function format_for_header() { return sprintf('%s=%s', $this->name, $this->value); } /** * Format a cookie for a Set-Cookie header * * This is used when sending cookies to clients. This isn't really * applicable to client-side usage, but might be handy for debugging. * * @return string Cookie formatted for Set-Cookie header */ public function format_for_set_cookie() { $header_value = $this->format_for_header(); if (!empty($this->attributes)) { $parts = []; foreach ($this->attributes as $key => $value) { // Ignore non-associative attributes if (is_numeric($key)) { $parts[] = $value; } else { $parts[] = sprintf('%s=%s', $key, $value); } } $header_value .= '; ' . implode('; ', $parts); } return $header_value; } /** * Parse a cookie string into a cookie object * * Based on Mozilla's parsing code in Firefox and related projects, which * is an intentional deviation from RFC 2109 and RFC 2616. RFC 6265 * specifies some of this handling, but not in a thorough manner. * * @param string $cookie_header Cookie header value (from a Set-Cookie header) * @param string $name * @param int|null $reference_time * @return \WpOrg\Requests\Cookie Parsed cookie object * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $cookie_header argument is not a string. * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $name argument is not a string. */ public static function parse($cookie_header, $name = '', $reference_time = null) { if (is_string($cookie_header) === false) { throw InvalidArgument::create(1, '$cookie_header', 'string', gettype($cookie_header)); } if (is_string($name) === false) { throw InvalidArgument::create(2, '$name', 'string', gettype($name)); } $parts = explode(';', $cookie_header); $kvparts = array_shift($parts); if (!empty($name)) { $value = $cookie_header; } elseif (strpos($kvparts, '=') === false) { // Some sites might only have a value without the equals separator. // Deviate from RFC 6265 and pretend it was actually a blank name // (`=foo`) // // https://bugzilla.mozilla.org/show_bug.cgi?id=169091 $name = ''; $value = $kvparts; } else { list($name, $value) = explode('=', $kvparts, 2); } $name = trim($name); $value = trim($value); // Attribute keys are handled case-insensitively $attributes = new CaseInsensitiveDictionary(); if (!empty($parts)) { foreach ($parts as $part) { if (strpos($part, '=') === false) { $part_key = $part; $part_value = true; } else { list($part_key, $part_value) = explode('=', $part, 2); $part_value = trim($part_value); } $part_key = trim($part_key); $attributes[$part_key] = $part_value; } } return new static($name, $value, $attributes, [], $reference_time); } /** * Parse all Set-Cookie headers from request headers * * @param \WpOrg\Requests\Response\Headers $headers Headers to parse from * @param \WpOrg\Requests\Iri|null $origin URI for comparing cookie origins * @param int|null $time Reference time for expiration calculation * @return array * * @throws \WpOrg\Requests\Exception\InvalidArgument When the passed $origin argument is not null or an instance of the Iri class. */ public static function parse_from_headers(Headers $headers, $origin = null, $time = null) { $cookie_headers = $headers->getValues('Set-Cookie'); if (empty($cookie_headers)) { return []; } if ($origin !== null && !($origin instanceof Iri)) { throw InvalidArgument::create(2, '$origin', Iri::class . ' or null', gettype($origin)); } $cookies = []; foreach ($cookie_headers as $header) { $parsed = self::parse($header, '', $time); // Default domain/path attributes if (empty($parsed->attributes['domain']) && !empty($origin)) { $parsed->attributes['domain'] = $origin->host; $parsed->flags['host-only'] = true; } else { $parsed->flags['host-only'] = false; } $path_is_valid = (!empty($parsed->attributes['path']) && $parsed->attributes['path'][0] === '/'); if (!$path_is_valid && !empty($origin)) { $path = $origin->path; // Default path normalization as per RFC 6265 section 5.1.4 if (substr($path, 0, 1) !== '/') { // If the uri-path is empty or if the first character of // the uri-path is not a %x2F ("/") character, output // %x2F ("/") and skip the remaining steps. $path = '/'; } elseif (substr_count($path, '/') === 1) { // If the uri-path contains no more than one %x2F ("/") // character, output %x2F ("/") and skip the remaining // step. $path = '/'; } else { // Output the characters of the uri-path from the first // character up to, but not including, the right-most // %x2F ("/"). $path = substr($path, 0, strrpos($path, '/')); } $parsed->attributes['path'] = $path; } // Reject invalid cookie domains if (!empty($origin) && !$parsed->domain_matches($origin->host)) { continue; } $cookies[$parsed->name] = $parsed; } return $cookies; } } 0) { if ($position + $length > $strlen) { throw new Exception('Invalid Unicode codepoint', 'idna.invalidcodepoint', $character); } for ($position++; $remaining > 0; $position++) { $value = ord($input[$position]); // If it is invalid, count the sequence as invalid and reprocess the current byte: if (($value & 0xC0) !== 0x80) { throw new Exception('Invalid Unicode codepoint', 'idna.invalidcodepoint', $character); } --$remaining; $character |= ($value & 0x3F) << ($remaining * 6); } $position--; } if (// Non-shortest form sequences are invalid ($length > 1 && $character <= 0x7F) || ($length > 2 && $character <= 0x7FF) || ($length > 3 && $character <= 0xFFFF) // Outside of range of ucschar codepoints // Noncharacters || ($character & 0xFFFE) === 0xFFFE || ($character >= 0xFDD0 && $character <= 0xFDEF) || ( // Everything else not in ucschar ($character > 0xD7FF && $character < 0xF900) || $character < 0x20 || ($character > 0x7E && $character < 0xA0) || $character > 0xEFFFD ) ) { throw new Exception('Invalid Unicode codepoint', 'idna.invalidcodepoint', $character); } $codepoints[] = $character; } return $codepoints; } /** * RFC3492-compliant encoder * * @internal Pseudo-code from Section 6.3 is commented with "#" next to relevant code * * @param string $input UTF-8 encoded string to encode * @return string Punycode-encoded string * * @throws \WpOrg\Requests\Exception On character outside of the domain (never happens with Punycode) (`idna.character_outside_domain`) */ public static function punycode_encode($input) { $output = ''; // let n = initial_n $n = self::BOOTSTRAP_INITIAL_N; // let delta = 0 $delta = 0; // let bias = initial_bias $bias = self::BOOTSTRAP_INITIAL_BIAS; // let h = b = the number of basic code points in the input $h = 0; $b = 0; // see loop // copy them to the output in order $codepoints = self::utf8_to_codepoints($input); $extended = []; foreach ($codepoints as $char) { if ($char < 128) { // Character is valid ASCII // TODO: this should also check if it's valid for a URL $output .= chr($char); $h++; // Check if the character is non-ASCII, but below initial n // This never occurs for Punycode, so ignore in coverage // @codeCoverageIgnoreStart } elseif ($char < $n) { throw new Exception('Invalid character', 'idna.character_outside_domain', $char); // @codeCoverageIgnoreEnd } else { $extended[$char] = true; } } $extended = array_keys($extended); sort($extended); $b = $h; // [copy them] followed by a delimiter if b > 0 if (strlen($output) > 0) { $output .= '-'; } // {if the input contains a non-basic code point < n then fail} // while h < length(input) do begin $codepointcount = count($codepoints); while ($h < $codepointcount) { // let m = the minimum code point >= n in the input $m = array_shift($extended); //printf('next code point to insert is %s' . PHP_EOL, dechex($m)); // let delta = delta + (m - n) * (h + 1), fail on overflow $delta += ($m - $n) * ($h + 1); // let n = m $n = $m; // for each code point c in the input (in order) do begin for ($num = 0; $num < $codepointcount; $num++) { $c = $codepoints[$num]; // if c < n then increment delta, fail on overflow if ($c < $n) { $delta++; } elseif ($c === $n) { // if c == n then begin // let q = delta $q = $delta; // for k = base to infinity in steps of base do begin for ($k = self::BOOTSTRAP_BASE; ; $k += self::BOOTSTRAP_BASE) { // let t = tmin if k <= bias {+ tmin}, or // tmax if k >= bias + tmax, or k - bias otherwise if ($k <= ($bias + self::BOOTSTRAP_TMIN)) { $t = self::BOOTSTRAP_TMIN; } elseif ($k >= ($bias + self::BOOTSTRAP_TMAX)) { $t = self::BOOTSTRAP_TMAX; } else { $t = $k - $bias; } // if q < t then break if ($q < $t) { break; } // output the code point for digit t + ((q - t) mod (base - t)) $digit = (int) ($t + (($q - $t) % (self::BOOTSTRAP_BASE - $t))); $output .= self::digit_to_char($digit); // let q = (q - t) div (base - t) $q = (int) floor(($q - $t) / (self::BOOTSTRAP_BASE - $t)); } // end // output the code point for digit q $output .= self::digit_to_char($q); // let bias = adapt(delta, h + 1, test h equals b?) $bias = self::adapt($delta, $h + 1, $h === $b); // let delta = 0 $delta = 0; // increment h $h++; } // end } // end // increment delta and n $delta++; $n++; } // end return $output; } /** * Convert a digit to its respective character * * @link https://tools.ietf.org/html/rfc3492#section-5 * * @param int $digit Digit in the range 0-35 * @return string Single character corresponding to digit * * @throws \WpOrg\Requests\Exception On invalid digit (`idna.invalid_digit`) */ protected static function digit_to_char($digit) { // @codeCoverageIgnoreStart // As far as I know, this never happens, but still good to be sure. if ($digit < 0 || $digit > 35) { throw new Exception(sprintf('Invalid digit %d', $digit), 'idna.invalid_digit', $digit); } // @codeCoverageIgnoreEnd $digits = 'abcdefghijklmnopqrstuvwxyz0123456789'; return substr($digits, $digit, 1); } /** * Adapt the bias * * @link https://tools.ietf.org/html/rfc3492#section-6.1 * @param int $delta * @param int $numpoints * @param bool $firsttime * @return int|float New bias * * function adapt(delta,numpoints,firsttime): */ protected static function adapt($delta, $numpoints, $firsttime) { // if firsttime then let delta = delta div damp if ($firsttime) { $delta = floor($delta / self::BOOTSTRAP_DAMP); } else { // else let delta = delta div 2 $delta = floor($delta / 2); } // let delta = delta + (delta div numpoints) $delta += floor($delta / $numpoints); // let k = 0 $k = 0; // while delta > ((base - tmin) * tmax) div 2 do begin $max = floor(((self::BOOTSTRAP_BASE - self::BOOTSTRAP_TMIN) * self::BOOTSTRAP_TMAX) / 2); while ($delta > $max) { // let delta = delta div (base - tmin) $delta = floor($delta / (self::BOOTSTRAP_BASE - self::BOOTSTRAP_TMIN)); // let k = k + base $k += self::BOOTSTRAP_BASE; } // end // return k + (((base - tmin + 1) * delta) div (delta + skew)) return $k + floor(((self::BOOTSTRAP_BASE - self::BOOTSTRAP_TMIN + 1) * $delta) / ($delta + self::BOOTSTRAP_SKEW)); } } cookies = $cookies; } /** * Normalise cookie data into a \WpOrg\Requests\Cookie * * @param string|\WpOrg\Requests\Cookie $cookie Cookie header value, possibly pre-parsed (object). * @param string $key Optional. The name for this cookie. * @return \WpOrg\Requests\Cookie */ public function normalize_cookie($cookie, $key = '') { if ($cookie instanceof Cookie) { return $cookie; } return Cookie::parse($cookie, $key); } /** * Check if the given item exists * * @param string $offset Item key * @return boolean Does the item exist? */ #[ReturnTypeWillChange] public function offsetExists($offset) { return isset($this->cookies[$offset]); } /** * Get the value for the item * * @param string $offset Item key * @return string|null Item value (null if offsetExists is false) */ #[ReturnTypeWillChange] public function offsetGet($offset) { if (!isset($this->cookies[$offset])) { return null; } return $this->cookies[$offset]; } /** * Set the given item * * @param string $offset Item name * @param string $value Item value * * @throws \WpOrg\Requests\Exception On attempting to use dictionary as list (`invalidset`) */ #[ReturnTypeWillChange] public function offsetSet($offset, $value) { if ($offset === null) { throw new Exception('Object is a dictionary, not a list', 'invalidset'); } $this->cookies[$offset] = $value; } /** * Unset the given header * * @param string $offset The key for the item to unset. */ #[ReturnTypeWillChange] public function offsetUnset($offset) { unset($this->cookies[$offset]); } /** * Get an iterator for the data * * @return \ArrayIterator */ #[ReturnTypeWillChange] public function getIterator() { return new ArrayIterator($this->cookies); } /** * Register the cookie handler with the request's hooking system * * @param \WpOrg\Requests\HookManager $hooks Hooking system */ public function register(HookManager $hooks) { $hooks->register('requests.before_request', [$this, 'before_request']); $hooks->register('requests.before_redirect_check', [$this, 'before_redirect_check']); } /** * Add Cookie header to a request if we have any * * As per RFC 6265, cookies are separated by '; ' * * @param string $url * @param array $headers * @param array $data * @param string $type * @param array $options */ public function before_request($url, &$headers, &$data, &$type, &$options) { if (!$url instanceof Iri) { $url = new Iri($url); } if (!empty($this->cookies)) { $cookies = []; foreach ($this->cookies as $key => $cookie) { $cookie = $this->normalize_cookie($cookie, $key); // Skip expired cookies if ($cookie->is_expired()) { continue; } if ($cookie->domain_matches($url->host)) { $cookies[] = $cookie->format_for_header(); } } $headers['Cookie'] = implode('; ', $cookies); } } /** * Parse all cookies from a response and attach them to the response * * @param \WpOrg\Requests\Response $response Response as received. */ public function before_redirect_check(Response $response) { $url = $response->url; if (!$url instanceof Iri) { $url = new Iri($url); } $cookies = Cookie::parse_from_headers($response->headers, $url); $this->cookies = array_merge($this->cookies, $cookies); $response->cookies = $this; } } 0 is executed later */ public function register($hook, $callback, $priority = 0); /** * Dispatch a message * * @param string $hook Hook name * @param array $parameters Parameters to pass to callbacks * @return boolean Successfulness */ public function dispatch($hook, $parameters = []); } array( 'pretty_version' => 'dev-main', 'version' => 'dev-main', 'type' => 'library', 'install_path' => __DIR__ . '/../../', 'aliases' => array( 0 => '2.12.x-dev', ), 'reference' => null, 'name' => 'wp-cli/wp-cli-bundle', 'dev' => true, ), 'versions' => array( 'behat/behat' => array( 'pretty_version' => 'v3.7.0', 'version' => '3.7.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../behat/behat', 'aliases' => array(), 'reference' => '08052f739619a9e9f62f457a67302f0715e6dd13', 'dev_requirement' => true, ), 'behat/gherkin' => array( 'pretty_version' => 'v4.7.3', 'version' => '4.7.3.0', 'type' => 'library', 'install_path' => __DIR__ . '/../behat/gherkin', 'aliases' => array(), 'reference' => 'd5ae4616aeaa91daadbfb8446d9d17aae8d43cf7', 'dev_requirement' => true, ), 'behat/transliterator' => array( 'pretty_version' => 'v1.4.0', 'version' => '1.4.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../behat/transliterator', 'aliases' => array(), 'reference' => '34490b42c5225687d9449e6476e66a03c62c43ff', 'dev_requirement' => true, ), 'composer/ca-bundle' => array( 'pretty_version' => '1.4.7', 'version' => '1.4.7.0', 'type' => 'library', 'install_path' => __DIR__ . '/./ca-bundle', 'aliases' => array(), 'reference' => '9b8b487385d1a5140ad6765b9e9131fc3de3b891', 'dev_requirement' => false, ), 'composer/composer' => array( 'pretty_version' => '2.2.25', 'version' => '2.2.25.0', 'type' => 'library', 'install_path' => __DIR__ . '/./composer', 'aliases' => array(), 'reference' => '0374e6fa9d20beeffa0765c890ace6b33cbb33bd', 'dev_requirement' => false, ), 'composer/metadata-minifier' => array( 'pretty_version' => '1.0.0', 'version' => '1.0.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/./metadata-minifier', 'aliases' => array(), 'reference' => 'c549d23829536f0d0e984aaabbf02af91f443207', 'dev_requirement' => false, ), 'composer/pcre' => array( 'pretty_version' => '1.0.1', 'version' => '1.0.1.0', 'type' => 'library', 'install_path' => __DIR__ . '/./pcre', 'aliases' => array(), 'reference' => '67a32d7d6f9f560b726ab25a061b38ff3a80c560', 'dev_requirement' => false, ), 'composer/semver' => array( 'pretty_version' => '3.4.3', 'version' => '3.4.3.0', 'type' => 'library', 'install_path' => __DIR__ . '/./semver', 'aliases' => array(), 'reference' => '4313d26ada5e0c4edfbd1dc481a92ff7bff91f12', 'dev_requirement' => false, ), 'composer/spdx-licenses' => array( 'pretty_version' => '1.5.8', 'version' => '1.5.8.0', 'type' => 'library', 'install_path' => __DIR__ . '/./spdx-licenses', 'aliases' => array(), 'reference' => '560bdcf8deb88ae5d611c80a2de8ea9d0358cc0a', 'dev_requirement' => false, ), 'composer/xdebug-handler' => array( 'pretty_version' => '2.0.5', 'version' => '2.0.5.0', 'type' => 'library', 'install_path' => __DIR__ . '/./xdebug-handler', 'aliases' => array(), 'reference' => '9e36aeed4616366d2b690bdce11f71e9178c579a', 'dev_requirement' => false, ), 'dealerdirect/phpcodesniffer-composer-installer' => array( 'pretty_version' => 'v1.0.0', 'version' => '1.0.0.0', 'type' => 'composer-plugin', 'install_path' => __DIR__ . '/../dealerdirect/phpcodesniffer-composer-installer', 'aliases' => array(), 'reference' => '4be43904336affa5c2f70744a348312336afd0da', 'dev_requirement' => true, ), 'doctrine/instantiator' => array( 'pretty_version' => '1.0.5', 'version' => '1.0.5.0', 'type' => 'library', 'install_path' => __DIR__ . '/../doctrine/instantiator', 'aliases' => array(), 'reference' => '8e884e78f9f0eb1329e445619e04456e64d8051d', 'dev_requirement' => true, ), 'eftec/bladeone' => array( 'pretty_version' => '3.52', 'version' => '3.52.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../eftec/bladeone', 'aliases' => array(), 'reference' => 'a19bf66917de0b29836983db87a455a4f6e32148', 'dev_requirement' => false, ), 'gettext/gettext' => array( 'pretty_version' => 'v4.8.12', 'version' => '4.8.12.0', 'type' => 'library', 'install_path' => __DIR__ . '/../gettext/gettext', 'aliases' => array(), 'reference' => '11af89ee6c087db3cf09ce2111a150bca5c46e12', 'dev_requirement' => false, ), 'gettext/languages' => array( 'pretty_version' => '2.12.1', 'version' => '2.12.1.0', 'type' => 'library', 'install_path' => __DIR__ . '/../gettext/languages', 'aliases' => array(), 'reference' => '0b0b0851c55168e1dfb14305735c64019732b5f1', 'dev_requirement' => false, ), 'grogy/php-parallel-lint' => array( 'dev_requirement' => true, 'replaced' => array( 0 => '*', ), ), 'jakub-onderka/php-console-color' => array( 'dev_requirement' => true, 'replaced' => array( 0 => '*', ), ), 'jakub-onderka/php-console-highlighter' => array( 'dev_requirement' => true, 'replaced' => array( 0 => '*', ), ), 'jakub-onderka/php-parallel-lint' => array( 'dev_requirement' => true, 'replaced' => array( 0 => '*', ), ), 'justinrainbow/json-schema' => array( 'pretty_version' => 'v5.2.13', 'version' => '5.2.13.0', 'type' => 'library', 'install_path' => __DIR__ . '/../justinrainbow/json-schema', 'aliases' => array(), 'reference' => 'fbbe7e5d79f618997bc3332a6f49246036c45793', 'dev_requirement' => false, ), 'mck89/peast' => array( 'pretty_version' => 'v1.17.0', 'version' => '1.17.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../mck89/peast', 'aliases' => array(), 'reference' => '3a752d39bd7d8dc1e19bcf424f3d5ac1a1ca6ad5', 'dev_requirement' => false, ), 'mustache/mustache' => array( 'dev_requirement' => false, 'replaced' => array( 0 => '^2.14.2', ), ), 'myclabs/deep-copy' => array( 'pretty_version' => '1.7.0', 'version' => '1.7.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../myclabs/deep-copy', 'aliases' => array(), 'reference' => '3b8a3a99ba1f6a3952ac2747d989303cbd6b7a3e', 'dev_requirement' => true, ), 'nb/oxymel' => array( 'pretty_version' => 'v0.1.0', 'version' => '0.1.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../nb/oxymel', 'aliases' => array(), 'reference' => 'cbe626ef55d5c4cc9b5e6e3904b395861ea76e3c', 'dev_requirement' => false, ), 'php-parallel-lint/php-console-color' => array( 'pretty_version' => 'v1.0.1', 'version' => '1.0.1.0', 'type' => 'library', 'install_path' => __DIR__ . '/../php-parallel-lint/php-console-color', 'aliases' => array(), 'reference' => '7adfefd530aa2d7570ba87100a99e2483a543b88', 'dev_requirement' => true, ), 'php-parallel-lint/php-console-highlighter' => array( 'pretty_version' => 'v1.0.0', 'version' => '1.0.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../php-parallel-lint/php-console-highlighter', 'aliases' => array(), 'reference' => '5b4803384d3303cf8e84141039ef56c8a123138d', 'dev_requirement' => true, ), 'php-parallel-lint/php-parallel-lint' => array( 'pretty_version' => 'v1.4.0', 'version' => '1.4.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../php-parallel-lint/php-parallel-lint', 'aliases' => array(), 'reference' => '6db563514f27e19595a19f45a4bf757b6401194e', 'dev_requirement' => true, ), 'phpcompatibility/php-compatibility' => array( 'pretty_version' => 'dev-develop', 'version' => 'dev-develop', 'type' => 'phpcodesniffer-standard', 'install_path' => __DIR__ . '/../phpcompatibility/php-compatibility', 'aliases' => array( 0 => '10.x-dev', ), 'reference' => '9013cd039fe5740953f9fdeebd19d901b80e26f2', 'dev_requirement' => true, ), 'phpcsstandards/phpcsextra' => array( 'pretty_version' => '1.3.0', 'version' => '1.3.0.0', 'type' => 'phpcodesniffer-standard', 'install_path' => __DIR__ . '/../phpcsstandards/phpcsextra', 'aliases' => array(), 'reference' => '46d08eb86eec622b96c466adec3063adfed280dd', 'dev_requirement' => true, ), 'phpcsstandards/phpcsutils' => array( 'pretty_version' => '1.0.12', 'version' => '1.0.12.0', 'type' => 'phpcodesniffer-standard', 'install_path' => __DIR__ . '/../phpcsstandards/phpcsutils', 'aliases' => array(), 'reference' => '87b233b00daf83fb70f40c9a28692be017ea7c6c', 'dev_requirement' => true, ), 'phpdocumentor/reflection-common' => array( 'pretty_version' => '1.0.1', 'version' => '1.0.1.0', 'type' => 'library', 'install_path' => __DIR__ . '/../phpdocumentor/reflection-common', 'aliases' => array(), 'reference' => '21bdeb5f65d7ebf9f43b1b25d404f87deab5bfb6', 'dev_requirement' => true, ), 'phpdocumentor/reflection-docblock' => array( 'pretty_version' => '3.3.2', 'version' => '3.3.2.0', 'type' => 'library', 'install_path' => __DIR__ . '/../phpdocumentor/reflection-docblock', 'aliases' => array(), 'reference' => 'bf329f6c1aadea3299f08ee804682b7c45b326a2', 'dev_requirement' => true, ), 'phpdocumentor/type-resolver' => array( 'pretty_version' => '0.4.0', 'version' => '0.4.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../phpdocumentor/type-resolver', 'aliases' => array(), 'reference' => '9c977708995954784726e25d0cd1dddf4e65b0f7', 'dev_requirement' => true, ), 'phpspec/prophecy' => array( 'pretty_version' => 'v1.10.3', 'version' => '1.10.3.0', 'type' => 'library', 'install_path' => __DIR__ . '/../phpspec/prophecy', 'aliases' => array(), 'reference' => '451c3cd1418cf640de218914901e51b064abb093', 'dev_requirement' => true, ), 'phpunit/php-code-coverage' => array( 'pretty_version' => '4.0.8', 'version' => '4.0.8.0', 'type' => 'library', 'install_path' => __DIR__ . '/../phpunit/php-code-coverage', 'aliases' => array(), 'reference' => 'ef7b2f56815df854e66ceaee8ebe9393ae36a40d', 'dev_requirement' => true, ), 'phpunit/php-file-iterator' => array( 'pretty_version' => '1.4.5', 'version' => '1.4.5.0', 'type' => 'library', 'install_path' => __DIR__ . '/../phpunit/php-file-iterator', 'aliases' => array(), 'reference' => '730b01bc3e867237eaac355e06a36b85dd93a8b4', 'dev_requirement' => true, ), 'phpunit/php-text-template' => array( 'pretty_version' => '1.2.1', 'version' => '1.2.1.0', 'type' => 'library', 'install_path' => __DIR__ . '/../phpunit/php-text-template', 'aliases' => array(), 'reference' => '31f8b717e51d9a2afca6c9f046f5d69fc27c8686', 'dev_requirement' => true, ), 'phpunit/php-timer' => array( 'pretty_version' => '1.0.9', 'version' => '1.0.9.0', 'type' => 'library', 'install_path' => __DIR__ . '/../phpunit/php-timer', 'aliases' => array(), 'reference' => '3dcf38ca72b158baf0bc245e9184d3fdffa9c46f', 'dev_requirement' => true, ), 'phpunit/php-token-stream' => array( 'pretty_version' => '1.4.12', 'version' => '1.4.12.0', 'type' => 'library', 'install_path' => __DIR__ . '/../phpunit/php-token-stream', 'aliases' => array(), 'reference' => '1ce90ba27c42e4e44e6d8458241466380b51fa16', 'dev_requirement' => true, ), 'phpunit/phpunit' => array( 'pretty_version' => '5.7.27', 'version' => '5.7.27.0', 'type' => 'library', 'install_path' => __DIR__ . '/../phpunit/phpunit', 'aliases' => array(), 'reference' => 'b7803aeca3ccb99ad0a506fa80b64cd6a56bbc0c', 'dev_requirement' => true, ), 'phpunit/phpunit-mock-objects' => array( 'pretty_version' => '3.4.4', 'version' => '3.4.4.0', 'type' => 'library', 'install_path' => __DIR__ . '/../phpunit/phpunit-mock-objects', 'aliases' => array(), 'reference' => 'a23b761686d50a560cc56233b9ecf49597cc9118', 'dev_requirement' => true, ), 'psr/container' => array( 'pretty_version' => '1.0.0', 'version' => '1.0.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../psr/container', 'aliases' => array(), 'reference' => 'b7ce3b176482dbbc1245ebf52b181af44c2cf55f', 'dev_requirement' => true, ), 'psr/container-implementation' => array( 'dev_requirement' => true, 'provided' => array( 0 => '1.0', ), ), 'psr/log' => array( 'pretty_version' => '1.1.4', 'version' => '1.1.4.0', 'type' => 'library', 'install_path' => __DIR__ . '/../psr/log', 'aliases' => array(), 'reference' => 'd49695b909c3b7628b6289db5479a1c204601f11', 'dev_requirement' => false, ), 'psr/log-implementation' => array( 'dev_requirement' => false, 'provided' => array( 0 => '1.0', ), ), 'react/promise' => array( 'pretty_version' => 'v2.11.0', 'version' => '2.11.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../react/promise', 'aliases' => array(), 'reference' => '1a8460931ea36dc5c76838fec5734d55c88c6831', 'dev_requirement' => false, ), 'roave/security-advisories' => array( 'pretty_version' => 'dev-latest', 'version' => 'dev-latest', 'type' => 'metapackage', 'install_path' => null, 'aliases' => array( 0 => '9999999-dev', ), 'reference' => '00a1b51fda5bb2305e7ae7ecbfa88cf826856f2c', 'dev_requirement' => true, ), 'sebastian/code-unit-reverse-lookup' => array( 'pretty_version' => '1.0.3', 'version' => '1.0.3.0', 'type' => 'library', 'install_path' => __DIR__ . '/../sebastian/code-unit-reverse-lookup', 'aliases' => array(), 'reference' => '92a1a52e86d34cde6caa54f1b5ffa9fda18e5d54', 'dev_requirement' => true, ), 'sebastian/comparator' => array( 'pretty_version' => '1.2.4', 'version' => '1.2.4.0', 'type' => 'library', 'install_path' => __DIR__ . '/../sebastian/comparator', 'aliases' => array(), 'reference' => '2b7424b55f5047b47ac6e5ccb20b2aea4011d9be', 'dev_requirement' => true, ), 'sebastian/diff' => array( 'pretty_version' => '1.4.3', 'version' => '1.4.3.0', 'type' => 'library', 'install_path' => __DIR__ . '/../sebastian/diff', 'aliases' => array(), 'reference' => '7f066a26a962dbe58ddea9f72a4e82874a3975a4', 'dev_requirement' => true, ), 'sebastian/environment' => array( 'pretty_version' => '2.0.0', 'version' => '2.0.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../sebastian/environment', 'aliases' => array(), 'reference' => '5795ffe5dc5b02460c3e34222fee8cbe245d8fac', 'dev_requirement' => true, ), 'sebastian/exporter' => array( 'pretty_version' => '2.0.0', 'version' => '2.0.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../sebastian/exporter', 'aliases' => array(), 'reference' => 'ce474bdd1a34744d7ac5d6aad3a46d48d9bac4c4', 'dev_requirement' => true, ), 'sebastian/global-state' => array( 'pretty_version' => '1.1.1', 'version' => '1.1.1.0', 'type' => 'library', 'install_path' => __DIR__ . '/../sebastian/global-state', 'aliases' => array(), 'reference' => 'bc37d50fea7d017d3d340f230811c9f1d7280af4', 'dev_requirement' => true, ), 'sebastian/object-enumerator' => array( 'pretty_version' => '2.0.1', 'version' => '2.0.1.0', 'type' => 'library', 'install_path' => __DIR__ . '/../sebastian/object-enumerator', 'aliases' => array(), 'reference' => '1311872ac850040a79c3c058bea3e22d0f09cbb7', 'dev_requirement' => true, ), 'sebastian/recursion-context' => array( 'pretty_version' => '2.0.0', 'version' => '2.0.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../sebastian/recursion-context', 'aliases' => array(), 'reference' => '2c3ba150cbec723aa057506e73a8d33bdb286c9a', 'dev_requirement' => true, ), 'sebastian/resource-operations' => array( 'pretty_version' => '1.0.0', 'version' => '1.0.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../sebastian/resource-operations', 'aliases' => array(), 'reference' => 'ce990bb21759f94aeafd30209e8cfcdfa8bc3f52', 'dev_requirement' => true, ), 'sebastian/version' => array( 'pretty_version' => '2.0.1', 'version' => '2.0.1.0', 'type' => 'library', 'install_path' => __DIR__ . '/../sebastian/version', 'aliases' => array(), 'reference' => '99732be0ddb3361e16ad77b68ba41efc8e979019', 'dev_requirement' => true, ), 'seld/jsonlint' => array( 'pretty_version' => '1.11.0', 'version' => '1.11.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../seld/jsonlint', 'aliases' => array(), 'reference' => '1748aaf847fc731cfad7725aec413ee46f0cc3a2', 'dev_requirement' => false, ), 'seld/phar-utils' => array( 'pretty_version' => '1.2.1', 'version' => '1.2.1.0', 'type' => 'library', 'install_path' => __DIR__ . '/../seld/phar-utils', 'aliases' => array(), 'reference' => 'ea2f4014f163c1be4c601b9b7bd6af81ba8d701c', 'dev_requirement' => false, ), 'squizlabs/php_codesniffer' => array( 'pretty_version' => '3.12.2', 'version' => '3.12.2.0', 'type' => 'library', 'install_path' => __DIR__ . '/../squizlabs/php_codesniffer', 'aliases' => array(), 'reference' => '6d4cf6032d4b718f168c90a96e36c7d0eaacb2aa', 'dev_requirement' => true, ), 'symfony/config' => array( 'pretty_version' => 'v3.4.47', 'version' => '3.4.47.0', 'type' => 'library', 'install_path' => __DIR__ . '/../symfony/config', 'aliases' => array(), 'reference' => 'bc6b3fd3930d4b53a60b42fe2ed6fc466b75f03f', 'dev_requirement' => true, ), 'symfony/console' => array( 'pretty_version' => 'v3.4.47', 'version' => '3.4.47.0', 'type' => 'library', 'install_path' => __DIR__ . '/../symfony/console', 'aliases' => array(), 'reference' => 'a10b1da6fc93080c180bba7219b5ff5b7518fe81', 'dev_requirement' => false, ), 'symfony/debug' => array( 'pretty_version' => 'v3.4.47', 'version' => '3.4.47.0', 'type' => 'library', 'install_path' => __DIR__ . '/../symfony/debug', 'aliases' => array(), 'reference' => 'ab42889de57fdfcfcc0759ab102e2fd4ea72dcae', 'dev_requirement' => false, ), 'symfony/dependency-injection' => array( 'pretty_version' => 'v3.4.47', 'version' => '3.4.47.0', 'type' => 'library', 'install_path' => __DIR__ . '/../symfony/dependency-injection', 'aliases' => array(), 'reference' => '51d2a2708c6ceadad84393f8581df1dcf9e5e84b', 'dev_requirement' => true, ), 'symfony/event-dispatcher' => array( 'pretty_version' => 'v3.4.47', 'version' => '3.4.47.0', 'type' => 'library', 'install_path' => __DIR__ . '/../symfony/event-dispatcher', 'aliases' => array(), 'reference' => '31fde73757b6bad247c54597beef974919ec6860', 'dev_requirement' => true, ), 'symfony/filesystem' => array( 'pretty_version' => 'v3.4.47', 'version' => '3.4.47.0', 'type' => 'library', 'install_path' => __DIR__ . '/../symfony/filesystem', 'aliases' => array(), 'reference' => 'e58d7841cddfed6e846829040dca2cca0ebbbbb3', 'dev_requirement' => false, ), 'symfony/finder' => array( 'pretty_version' => 'v3.4.47', 'version' => '3.4.47.0', 'type' => 'library', 'install_path' => __DIR__ . '/../symfony/finder', 'aliases' => array(), 'reference' => 'b6b6ad3db3edb1b4b1c1896b1975fb684994de6e', 'dev_requirement' => false, ), 'symfony/polyfill-ctype' => array( 'pretty_version' => 'v1.19.0', 'version' => '1.19.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../symfony/polyfill-ctype', 'aliases' => array(), 'reference' => 'aed596913b70fae57be53d86faa2e9ef85a2297b', 'dev_requirement' => false, ), 'symfony/polyfill-mbstring' => array( 'pretty_version' => 'v1.19.0', 'version' => '1.19.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../symfony/polyfill-mbstring', 'aliases' => array(), 'reference' => 'b5f7b932ee6fa802fc792eabd77c4c88084517ce', 'dev_requirement' => false, ), 'symfony/process' => array( 'dev_requirement' => false, 'replaced' => array( 0 => '^5.4.47', ), ), 'symfony/translation' => array( 'pretty_version' => 'v3.4.47', 'version' => '3.4.47.0', 'type' => 'library', 'install_path' => __DIR__ . '/../symfony/translation', 'aliases' => array(), 'reference' => 'be83ee6c065cb32becdb306ba61160d598b1ce88', 'dev_requirement' => true, ), 'symfony/yaml' => array( 'pretty_version' => 'v3.4.47', 'version' => '3.4.47.0', 'type' => 'library', 'install_path' => __DIR__ . '/../symfony/yaml', 'aliases' => array(), 'reference' => '88289caa3c166321883f67fe5130188ebbb47094', 'dev_requirement' => true, ), 'webmozart/assert' => array( 'pretty_version' => '1.9.1', 'version' => '1.9.1.0', 'type' => 'library', 'install_path' => __DIR__ . '/../webmozart/assert', 'aliases' => array(), 'reference' => 'bafc69caeb4d49c39fd0779086c03a3738cbb389', 'dev_requirement' => true, ), 'wimg/php-compatibility' => array( 'dev_requirement' => true, 'replaced' => array( 0 => '*', ), ), 'wp-cli/cache-command' => array( 'pretty_version' => 'v2.2.0', 'version' => '2.2.0.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/cache-command', 'aliases' => array(), 'reference' => '14f76b0bc8f9fa0a680e9c70e18fcf627774d055', 'dev_requirement' => false, ), 'wp-cli/checksum-command' => array( 'pretty_version' => 'v2.3.1', 'version' => '2.3.1.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/checksum-command', 'aliases' => array(), 'reference' => '39992dbd66835f8d5c2cc5bfeacf9d2c450cbafe', 'dev_requirement' => false, ), 'wp-cli/config-command' => array( 'pretty_version' => 'v2.3.8', 'version' => '2.3.8.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/config-command', 'aliases' => array(), 'reference' => '994b3dc9e8284fc978366920d5c5ae0dde3a004e', 'dev_requirement' => false, ), 'wp-cli/core-command' => array( 'pretty_version' => 'v2.1.20', 'version' => '2.1.20.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/core-command', 'aliases' => array(), 'reference' => '83e4692784a815bb7f5df10b72204f237b5224b9', 'dev_requirement' => false, ), 'wp-cli/cron-command' => array( 'pretty_version' => 'v2.3.2', 'version' => '2.3.2.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/cron-command', 'aliases' => array(), 'reference' => '6f450028a75ebd275f12cad62959a0709bf3e7c1', 'dev_requirement' => false, ), 'wp-cli/db-command' => array( 'pretty_version' => 'v2.1.3', 'version' => '2.1.3.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/db-command', 'aliases' => array(), 'reference' => 'f857c91454d7092fa672bc388512a51752d9264a', 'dev_requirement' => false, ), 'wp-cli/embed-command' => array( 'pretty_version' => 'v2.0.18', 'version' => '2.0.18.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/embed-command', 'aliases' => array(), 'reference' => '52f59a1dacf1d4a1c68fd685f27909e1f493816b', 'dev_requirement' => false, ), 'wp-cli/entity-command' => array( 'pretty_version' => 'v2.8.4', 'version' => '2.8.4.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/entity-command', 'aliases' => array(), 'reference' => '213611f8ab619ca137d983e9b987f7fbf1ac21d4', 'dev_requirement' => false, ), 'wp-cli/eval-command' => array( 'pretty_version' => 'v2.2.6', 'version' => '2.2.6.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/eval-command', 'aliases' => array(), 'reference' => '20ec428a7b9bc604fab0bd33ee8fa20662650455', 'dev_requirement' => false, ), 'wp-cli/export-command' => array( 'pretty_version' => 'v2.1.14', 'version' => '2.1.14.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/export-command', 'aliases' => array(), 'reference' => '2af32bf12c1bccd6561a215dbbafc2f272647ee8', 'dev_requirement' => false, ), 'wp-cli/extension-command' => array( 'pretty_version' => 'v2.1.24', 'version' => '2.1.24.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/extension-command', 'aliases' => array(), 'reference' => 'd21a2f504ac43a86b6b08697669b5b0844748133', 'dev_requirement' => false, ), 'wp-cli/i18n-command' => array( 'pretty_version' => 'v2.6.5', 'version' => '2.6.5.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/i18n-command', 'aliases' => array(), 'reference' => '5e73d417398993625331a9f69f6c2ef60f234070', 'dev_requirement' => false, ), 'wp-cli/import-command' => array( 'pretty_version' => 'v2.0.14', 'version' => '2.0.14.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/import-command', 'aliases' => array(), 'reference' => 'b2c48f3e51683e825738df62bf8ccc7004c5f0f9', 'dev_requirement' => false, ), 'wp-cli/language-command' => array( 'pretty_version' => 'v2.0.23', 'version' => '2.0.23.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/language-command', 'aliases' => array(), 'reference' => '7221cc39d2b14fd39e55aa7884889f26eec2f822', 'dev_requirement' => false, ), 'wp-cli/maintenance-mode-command' => array( 'pretty_version' => 'v2.1.3', 'version' => '2.1.3.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/maintenance-mode-command', 'aliases' => array(), 'reference' => 'b947e094e00b7b68c6376ec9bd03303515864062', 'dev_requirement' => false, ), 'wp-cli/media-command' => array( 'pretty_version' => 'v2.2.2', 'version' => '2.2.2.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/media-command', 'aliases' => array(), 'reference' => 'a810ea0e68473fce6a234e67c6c5f19bb820a753', 'dev_requirement' => false, ), 'wp-cli/mustache' => array( 'pretty_version' => 'v2.14.99', 'version' => '2.14.99.0', 'type' => 'library', 'install_path' => __DIR__ . '/../wp-cli/mustache', 'aliases' => array(), 'reference' => 'ca23b97ac35fbe01c160549eb634396183d04a59', 'dev_requirement' => false, ), 'wp-cli/mustangostang-spyc' => array( 'pretty_version' => '0.6.3', 'version' => '0.6.3.0', 'type' => 'library', 'install_path' => __DIR__ . '/../wp-cli/mustangostang-spyc', 'aliases' => array(), 'reference' => '6aa0b4da69ce9e9a2c8402dab8d43cf32c581cc7', 'dev_requirement' => false, ), 'wp-cli/package-command' => array( 'pretty_version' => 'v2.6.0', 'version' => '2.6.0.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/package-command', 'aliases' => array(), 'reference' => '682d8c6bb30c782c3b09c015478c7cbe1cc727a9', 'dev_requirement' => false, ), 'wp-cli/php-cli-tools' => array( 'pretty_version' => 'v0.12.5', 'version' => '0.12.5.0', 'type' => 'library', 'install_path' => __DIR__ . '/../wp-cli/php-cli-tools', 'aliases' => array(), 'reference' => '34b83b4f700df8a4ec3fd17bf7e7e7d8ca5f28da', 'dev_requirement' => false, ), 'wp-cli/process' => array( 'pretty_version' => 'v5.9.99', 'version' => '5.9.99.0', 'type' => 'library', 'install_path' => __DIR__ . '/../wp-cli/process', 'aliases' => array(), 'reference' => 'f0aec5ca26a702d3157e3a19982b662521ac2b81', 'dev_requirement' => false, ), 'wp-cli/rewrite-command' => array( 'pretty_version' => 'v2.0.15', 'version' => '2.0.15.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/rewrite-command', 'aliases' => array(), 'reference' => '277ec689b7c268680ff429f52558508622c9b34c', 'dev_requirement' => false, ), 'wp-cli/role-command' => array( 'pretty_version' => 'v2.0.16', 'version' => '2.0.16.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/role-command', 'aliases' => array(), 'reference' => 'ed57fb5436b4d47954b07e56c734d19deb4fc491', 'dev_requirement' => false, ), 'wp-cli/scaffold-command' => array( 'pretty_version' => 'v2.5.0', 'version' => '2.5.0.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/scaffold-command', 'aliases' => array(), 'reference' => 'b4238ea12e768b3f15d10339a53a8642f82e1d2b', 'dev_requirement' => false, ), 'wp-cli/search-replace-command' => array( 'pretty_version' => 'v2.1.8', 'version' => '2.1.8.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/search-replace-command', 'aliases' => array(), 'reference' => '65397a7bfdd5ba2cff26f3ab03ef0bcb916c0057', 'dev_requirement' => false, ), 'wp-cli/server-command' => array( 'pretty_version' => 'v2.0.15', 'version' => '2.0.15.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/server-command', 'aliases' => array(), 'reference' => '80a9243f94e0ac073f9bfdb516d2ac7e1fa01a71', 'dev_requirement' => false, ), 'wp-cli/shell-command' => array( 'pretty_version' => 'v2.0.16', 'version' => '2.0.16.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/shell-command', 'aliases' => array(), 'reference' => '3af53a9f4b240e03e77e815b2ee10f229f1aa591', 'dev_requirement' => false, ), 'wp-cli/super-admin-command' => array( 'pretty_version' => 'v2.0.16', 'version' => '2.0.16.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/super-admin-command', 'aliases' => array(), 'reference' => '54ac063c384743ee414806d42cb8c61c6aa1fa8e', 'dev_requirement' => false, ), 'wp-cli/widget-command' => array( 'pretty_version' => 'v2.1.12', 'version' => '2.1.12.0', 'type' => 'wp-cli-package', 'install_path' => __DIR__ . '/../wp-cli/widget-command', 'aliases' => array(), 'reference' => '73084053f7b32d92583e44d870b81f287beea6a9', 'dev_requirement' => false, ), 'wp-cli/wp-cli' => array( 'pretty_version' => 'v2.12.0', 'version' => '2.12.0.0', 'type' => 'library', 'install_path' => __DIR__ . '/../wp-cli/wp-cli', 'aliases' => array(), 'reference' => '03d30d4138d12b4bffd8b507b82e56e129e0523f', 'dev_requirement' => false, ), 'wp-cli/wp-cli-bundle' => array( 'pretty_version' => 'dev-main', 'version' => 'dev-main', 'type' => 'library', 'install_path' => __DIR__ . '/../../', 'aliases' => array( 0 => '2.12.x-dev', ), 'reference' => null, 'dev_requirement' => false, ), 'wp-cli/wp-cli-tests' => array( 'pretty_version' => 'v4.3.14', 'version' => '4.3.14.0', 'type' => 'phpcodesniffer-standard', 'install_path' => __DIR__ . '/../wp-cli/wp-cli-tests', 'aliases' => array(), 'reference' => 'b72c36dd0ebd70547c441f03c9257c3e857af4be', 'dev_requirement' => true, ), 'wp-cli/wp-config-transformer' => array( 'pretty_version' => 'v1.4.2', 'version' => '1.4.2.0', 'type' => 'library', 'install_path' => __DIR__ . '/../wp-cli/wp-config-transformer', 'aliases' => array(), 'reference' => 'b78cab1159b43eb5ee097e2cfafe5eab573d2a8a', 'dev_requirement' => false, ), 'wp-coding-standards/wpcs' => array( 'pretty_version' => '3.1.0', 'version' => '3.1.0.0', 'type' => 'phpcodesniffer-standard', 'install_path' => __DIR__ . '/../wp-coding-standards/wpcs', 'aliases' => array(), 'reference' => '9333efcbff231f10dfd9c56bb7b65818b4733ca7', 'dev_requirement' => true, ), 'yoast/phpunit-polyfills' => array( 'pretty_version' => '2.0.4', 'version' => '2.0.4.0', 'type' => 'library', 'install_path' => __DIR__ . '/../yoast/phpunit-polyfills', 'aliases' => array(), 'reference' => 'a0e3e9adecaa352697786cb29bb0f2fcc25f43f5', 'dev_requirement' => true, ), ), ); * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Autoload; /** * ClassLoader implements a PSR-0, PSR-4 and classmap class loader. * * $loader = new \Composer\Autoload\ClassLoader(); * * // register classes with namespaces * $loader->add('Symfony\Component', __DIR__.'/component'); * $loader->add('Symfony', __DIR__.'/framework'); * * // activate the autoloader * $loader->register(); * * // to enable searching the include path (eg. for PEAR packages) * $loader->setUseIncludePath(true); * * In this example, if you try to use a class in the Symfony\Component * namespace or one of its children (Symfony\Component\Console for instance), * the autoloader will first look for the class under the component/ * directory, and it will then fallback to the framework/ directory if not * found before giving up. * * This class is loosely based on the Symfony UniversalClassLoader. * * @author Fabien Potencier * @author Jordi Boggiano * @see https://www.php-fig.org/psr/psr-0/ * @see https://www.php-fig.org/psr/psr-4/ */ class ClassLoader { /** @var ?string */ private $vendorDir; // PSR-4 /** * @var array[] * @psalm-var array> */ private $prefixLengthsPsr4 = array(); /** * @var array[] * @psalm-var array> */ private $prefixDirsPsr4 = array(); /** * @var array[] * @psalm-var array */ private $fallbackDirsPsr4 = array(); // PSR-0 /** * @var array[] * @psalm-var array> */ private $prefixesPsr0 = array(); /** * @var array[] * @psalm-var array */ private $fallbackDirsPsr0 = array(); /** @var bool */ private $useIncludePath = false; /** * @var string[] * @psalm-var array */ private $classMap = array(); /** @var bool */ private $classMapAuthoritative = false; /** * @var bool[] * @psalm-var array */ private $missingClasses = array(); /** @var ?string */ private $apcuPrefix; /** * @var self[] */ private static $registeredLoaders = array(); /** * @param ?string $vendorDir */ public function __construct($vendorDir = null) { $this->vendorDir = $vendorDir; } /** * @return string[] */ public function getPrefixes() { if (!empty($this->prefixesPsr0)) { return call_user_func_array('array_merge', array_values($this->prefixesPsr0)); } return array(); } /** * @return array[] * @psalm-return array> */ public function getPrefixesPsr4() { return $this->prefixDirsPsr4; } /** * @return array[] * @psalm-return array */ public function getFallbackDirs() { return $this->fallbackDirsPsr0; } /** * @return array[] * @psalm-return array */ public function getFallbackDirsPsr4() { return $this->fallbackDirsPsr4; } /** * @return string[] Array of classname => path * @psalm-return array */ public function getClassMap() { return $this->classMap; } /** * @param string[] $classMap Class to filename map * @psalm-param array $classMap * * @return void */ public function addClassMap(array $classMap) { if ($this->classMap) { $this->classMap = array_merge($this->classMap, $classMap); } else { $this->classMap = $classMap; } } /** * Registers a set of PSR-0 directories for a given prefix, either * appending or prepending to the ones previously set for this prefix. * * @param string $prefix The prefix * @param string[]|string $paths The PSR-0 root directories * @param bool $prepend Whether to prepend the directories * * @return void */ public function add($prefix, $paths, $prepend = false) { if (!$prefix) { if ($prepend) { $this->fallbackDirsPsr0 = array_merge( (array) $paths, $this->fallbackDirsPsr0 ); } else { $this->fallbackDirsPsr0 = array_merge( $this->fallbackDirsPsr0, (array) $paths ); } return; } $first = $prefix[0]; if (!isset($this->prefixesPsr0[$first][$prefix])) { $this->prefixesPsr0[$first][$prefix] = (array) $paths; return; } if ($prepend) { $this->prefixesPsr0[$first][$prefix] = array_merge( (array) $paths, $this->prefixesPsr0[$first][$prefix] ); } else { $this->prefixesPsr0[$first][$prefix] = array_merge( $this->prefixesPsr0[$first][$prefix], (array) $paths ); } } /** * Registers a set of PSR-4 directories for a given namespace, either * appending or prepending to the ones previously set for this namespace. * * @param string $prefix The prefix/namespace, with trailing '\\' * @param string[]|string $paths The PSR-4 base directories * @param bool $prepend Whether to prepend the directories * * @throws \InvalidArgumentException * * @return void */ public function addPsr4($prefix, $paths, $prepend = false) { if (!$prefix) { // Register directories for the root namespace. if ($prepend) { $this->fallbackDirsPsr4 = array_merge( (array) $paths, $this->fallbackDirsPsr4 ); } else { $this->fallbackDirsPsr4 = array_merge( $this->fallbackDirsPsr4, (array) $paths ); } } elseif (!isset($this->prefixDirsPsr4[$prefix])) { // Register directories for a new namespace. $length = strlen($prefix); if ('\\' !== $prefix[$length - 1]) { throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); } $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; $this->prefixDirsPsr4[$prefix] = (array) $paths; } elseif ($prepend) { // Prepend directories for an already registered namespace. $this->prefixDirsPsr4[$prefix] = array_merge( (array) $paths, $this->prefixDirsPsr4[$prefix] ); } else { // Append directories for an already registered namespace. $this->prefixDirsPsr4[$prefix] = array_merge( $this->prefixDirsPsr4[$prefix], (array) $paths ); } } /** * Registers a set of PSR-0 directories for a given prefix, * replacing any others previously set for this prefix. * * @param string $prefix The prefix * @param string[]|string $paths The PSR-0 base directories * * @return void */ public function set($prefix, $paths) { if (!$prefix) { $this->fallbackDirsPsr0 = (array) $paths; } else { $this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths; } } /** * Registers a set of PSR-4 directories for a given namespace, * replacing any others previously set for this namespace. * * @param string $prefix The prefix/namespace, with trailing '\\' * @param string[]|string $paths The PSR-4 base directories * * @throws \InvalidArgumentException * * @return void */ public function setPsr4($prefix, $paths) { if (!$prefix) { $this->fallbackDirsPsr4 = (array) $paths; } else { $length = strlen($prefix); if ('\\' !== $prefix[$length - 1]) { throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); } $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; $this->prefixDirsPsr4[$prefix] = (array) $paths; } } /** * Turns on searching the include path for class files. * * @param bool $useIncludePath * * @return void */ public function setUseIncludePath($useIncludePath) { $this->useIncludePath = $useIncludePath; } /** * Can be used to check if the autoloader uses the include path to check * for classes. * * @return bool */ public function getUseIncludePath() { return $this->useIncludePath; } /** * Turns off searching the prefix and fallback directories for classes * that have not been registered with the class map. * * @param bool $classMapAuthoritative * * @return void */ public function setClassMapAuthoritative($classMapAuthoritative) { $this->classMapAuthoritative = $classMapAuthoritative; } /** * Should class lookup fail if not found in the current class map? * * @return bool */ public function isClassMapAuthoritative() { return $this->classMapAuthoritative; } /** * APCu prefix to use to cache found/not-found classes, if the extension is enabled. * * @param string|null $apcuPrefix * * @return void */ public function setApcuPrefix($apcuPrefix) { $this->apcuPrefix = function_exists('apcu_fetch') && filter_var(ini_get('apc.enabled'), FILTER_VALIDATE_BOOLEAN) ? $apcuPrefix : null; } /** * The APCu prefix in use, or null if APCu caching is not enabled. * * @return string|null */ public function getApcuPrefix() { return $this->apcuPrefix; } /** * Registers this instance as an autoloader. * * @param bool $prepend Whether to prepend the autoloader or not * * @return void */ public function register($prepend = false) { spl_autoload_register(array($this, 'loadClass'), true, $prepend); if (null === $this->vendorDir) { return; } if ($prepend) { self::$registeredLoaders = array($this->vendorDir => $this) + self::$registeredLoaders; } else { unset(self::$registeredLoaders[$this->vendorDir]); self::$registeredLoaders[$this->vendorDir] = $this; } } /** * Unregisters this instance as an autoloader. * * @return void */ public function unregister() { spl_autoload_unregister(array($this, 'loadClass')); if (null !== $this->vendorDir) { unset(self::$registeredLoaders[$this->vendorDir]); } } /** * Loads the given class or interface. * * @param string $class The name of the class * @return true|null True if loaded, null otherwise */ public function loadClass($class) { if ($file = $this->findFile($class)) { includeFile($file); return true; } return null; } /** * Finds the path to the file where the class is defined. * * @param string $class The name of the class * * @return string|false The path if found, false otherwise */ public function findFile($class) { // class map lookup if (isset($this->classMap[$class])) { return $this->classMap[$class]; } if ($this->classMapAuthoritative || isset($this->missingClasses[$class])) { return false; } if (null !== $this->apcuPrefix) { $file = apcu_fetch($this->apcuPrefix.$class, $hit); if ($hit) { return $file; } } $file = $this->findFileWithExtension($class, '.php'); // Search for Hack files if we are running on HHVM if (false === $file && defined('HHVM_VERSION')) { $file = $this->findFileWithExtension($class, '.hh'); } if (null !== $this->apcuPrefix) { apcu_add($this->apcuPrefix.$class, $file); } if (false === $file) { // Remember that this class does not exist. $this->missingClasses[$class] = true; } return $file; } /** * Returns the currently registered loaders indexed by their corresponding vendor directories. * * @return self[] */ public static function getRegisteredLoaders() { return self::$registeredLoaders; } /** * @param string $class * @param string $ext * @return string|false */ private function findFileWithExtension($class, $ext) { // PSR-4 lookup $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext; $first = $class[0]; if (isset($this->prefixLengthsPsr4[$first])) { $subPath = $class; while (false !== $lastPos = strrpos($subPath, '\\')) { $subPath = substr($subPath, 0, $lastPos); $search = $subPath . '\\'; if (isset($this->prefixDirsPsr4[$search])) { $pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1); foreach ($this->prefixDirsPsr4[$search] as $dir) { if (file_exists($file = $dir . $pathEnd)) { return $file; } } } } } // PSR-4 fallback dirs foreach ($this->fallbackDirsPsr4 as $dir) { if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) { return $file; } } // PSR-0 lookup if (false !== $pos = strrpos($class, '\\')) { // namespaced class name $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1) . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR); } else { // PEAR-like class name $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext; } if (isset($this->prefixesPsr0[$first])) { foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) { if (0 === strpos($class, $prefix)) { foreach ($dirs as $dir) { if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { return $file; } } } } } // PSR-0 fallback dirs foreach ($this->fallbackDirsPsr0 as $dir) { if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { return $file; } } // PSR-0 include paths. if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) { return $file; } return false; } } /** * Scope isolated include. * * Prevents access to $this/self from included files. * * @param string $file * @return void * @private */ function includeFile($file) { include $file; } * * For the full copyright and license information, please view * the LICENSE file that was distributed with this source code. */ namespace Composer\Spdx; class SpdxLicenses { /** @var string */ const LICENSES_FILE = 'spdx-licenses.json'; /** @var string */ const EXCEPTIONS_FILE = 'spdx-exceptions.json'; /** * Contains all the licenses. * * The array is indexed by license identifiers, which contain * a numerically indexed array with license details. * * [ lowercased license identifier => * [ 0 => identifier (string), 1 => full name (string), 2 => osi certified (bool), 3 => deprecated (bool) ] * , ... * ] * * @var array */ private $licenses; /** * @var string */ private $licensesExpression; /** * Contains all the license exceptions. * * The array is indexed by license exception identifiers, which contain * a numerically indexed array with license exception details. * * [ lowercased exception identifier => * [ 0 => exception identifier (string), 1 => full name (string) ] * , ... * ] * * @var array */ private $exceptions; /** * @var string */ private $exceptionsExpression; public function __construct() { $this->loadLicenses(); $this->loadExceptions(); } /** * Returns license metadata by license identifier. * * This function adds a link to the full license text to the license metadata. * The array returned is in the form of: * * [ 0 => full name (string), 1 => osi certified, 2 => link to license text (string), 3 => deprecation status (bool) ] * * @param string $identifier * * @return array{0: string, 1: bool, 2: string, 3: bool}|null */ public function getLicenseByIdentifier($identifier) { $key = strtolower($identifier); if (!isset($this->licenses[$key])) { return null; } list($identifier, $name, $isOsiApproved, $isDeprecatedLicenseId) = $this->licenses[$key]; return array( $name, $isOsiApproved, 'https://spdx.org/licenses/' . $identifier . '.html#licenseText', $isDeprecatedLicenseId, ); } /** * Returns all licenses information, keyed by the lowercased license identifier. * * @return array{0: string, 1: string, 2: bool, 3: bool}[] Each item is [ 0 => identifier (string), 1 => full name (string), 2 => osi certified (bool), 3 => deprecated (bool) ] */ public function getLicenses() { return $this->licenses; } /** * Returns license exception metadata by license exception identifier. * * This function adds a link to the full license exception text to the license exception metadata. * The array returned is in the form of: * * [ 0 => full name (string), 1 => link to license text (string) ] * * @param string $identifier * * @return array{0: string, 1: string}|null */ public function getExceptionByIdentifier($identifier) { $key = strtolower($identifier); if (!isset($this->exceptions[$key])) { return null; } list($identifier, $name) = $this->exceptions[$key]; return array( $name, 'https://spdx.org/licenses/' . $identifier . '.html#licenseExceptionText', ); } /** * Returns the short identifier of a license (or license exception) by full name. * * @param string $name * * @return string|null */ public function getIdentifierByName($name) { foreach ($this->licenses as $licenseData) { if ($licenseData[1] === $name) { return $licenseData[0]; } } foreach ($this->exceptions as $licenseData) { if ($licenseData[1] === $name) { return $licenseData[0]; } } return null; } /** * Returns the OSI Approved status for a license by identifier. * * @param string $identifier * * @return bool */ public function isOsiApprovedByIdentifier($identifier) { return $this->licenses[strtolower($identifier)][2]; } /** * Returns the deprecation status for a license by identifier. * * @param string $identifier * * @return bool */ public function isDeprecatedByIdentifier($identifier) { return $this->licenses[strtolower($identifier)][3]; } /** * @param string[]|string $license * * @throws \InvalidArgumentException * * @return bool */ public function validate($license) { if (is_array($license)) { $count = count($license); if ($count !== count(array_filter($license, 'is_string'))) { throw new \InvalidArgumentException('Array of strings expected.'); } $license = $count > 1 ? '(' . implode(' OR ', $license) . ')' : (string) reset($license); } if (!is_string($license)) { throw new \InvalidArgumentException(sprintf( 'Array or String expected, %s given.', gettype($license) )); } return $this->isValidLicenseString($license); } /** * @return string */ public static function getResourcesDir() { return dirname(__DIR__) . '/res'; } /** * @return void */ private function loadLicenses() { if (null !== $this->licenses) { return; } $json = file_get_contents(self::getResourcesDir() . '/' . self::LICENSES_FILE); if (false === $json) { throw new \RuntimeException('Missing license file in ' . self::getResourcesDir() . '/' . self::LICENSES_FILE); } $this->licenses = array(); foreach (json_decode($json, true) as $identifier => $license) { $this->licenses[strtolower($identifier)] = array($identifier, $license[0], $license[1], $license[2]); } } /** * @return void */ private function loadExceptions() { if (null !== $this->exceptions) { return; } $json = file_get_contents(self::getResourcesDir() . '/' . self::EXCEPTIONS_FILE); if (false === $json) { throw new \RuntimeException('Missing exceptions file in ' . self::getResourcesDir() . '/' . self::EXCEPTIONS_FILE); } $this->exceptions = array(); foreach (json_decode($json, true) as $identifier => $exception) { $this->exceptions[strtolower($identifier)] = array($identifier, $exception[0]); } } /** * @return string */ private function getLicensesExpression() { if (null === $this->licensesExpression) { $licenses = array_map('preg_quote', array_keys($this->licenses)); rsort($licenses); $licenses = implode('|', $licenses); $this->licensesExpression = $licenses; } return $this->licensesExpression; } /** * @return string */ private function getExceptionsExpression() { if (null === $this->exceptionsExpression) { $exceptions = array_map('preg_quote', array_keys($this->exceptions)); rsort($exceptions); $exceptions = implode('|', $exceptions); $this->exceptionsExpression = $exceptions; } return $this->exceptionsExpression; } /** * @param string $license * * @throws \RuntimeException * * @return bool */ private function isValidLicenseString($license) { if (isset($this->licenses[strtolower($license)])) { return true; } $licenses = $this->getLicensesExpression(); $exceptions = $this->getExceptionsExpression(); $regex = <<[\pL\pN.-]{1,}) # license-id: taken from list (?{$licenses}) # license-exception-id: taken from list (?{$exceptions}) # license-ref: [DocumentRef-1*(idstring):]LicenseRef-1*(idstring) (?(?:DocumentRef-(?&idstring):)?LicenseRef-(?&idstring)) # simple-expresssion: license-id / license-id+ / license-ref (?(?&licenseid)\+? | (?&licenseid) | (?&licenseref)) # compound-expression: 1*( # simple-expression / # simple-expression WITH license-exception-id / # compound-expression AND compound-expression / # compound-expression OR compound-expression # ) / ( compound-expression ) ) (? (?&simple_expression) ( \s+ WITH \s+ (?&licenseexceptionid))? | $ \s* (?&compound_expression) \s* $ ) (? (?&compound_head) (?: \s+ (?:AND|OR) \s+ (?&compound_expression))? ) # license-expression: 1*1(simple-expression / compound-expression) (?(?&compound_expression) | (?&simple_expression)) ) # end of define ^(NONE | NOASSERTION | (?&license_expression))$ }xi REGEX; $match = preg_match($regex, $license); if (0 === $match) { return false; } if (false === $match) { throw new \RuntimeException('Regex failed to compile/run.'); } return true; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ /** * @param string $file * @return ?\Composer\Autoload\ClassLoader */ function includeIfExists($file) { return file_exists($file) ? include $file : null; } if ((!$loader = includeIfExists(__DIR__.'/../vendor/autoload.php')) && (!$loader = includeIfExists(__DIR__.'/../../../autoload.php'))) { echo 'You must set up the project dependencies using `composer install`'.PHP_EOL. 'See https://getcomposer.org/download/ for instructions on installing Composer'.PHP_EOL; exit(1); } return $loader; * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Console; use Composer\IO\IOInterface; use Composer\Util\Platform; final class GithubActionError { /** * @var IOInterface */ protected $io; public function __construct(IOInterface $io) { $this->io = $io; } /** * @param string $message * @param null|string $file * @param null|int $line * * @return void */ public function emit($message, $file = null, $line = null) { if (Platform::getEnv('GITHUB_ACTIONS') && !Platform::getEnv('COMPOSER_TESTS_ARE_RUNNING')) { $message = $this->escapeData($message); if ($file && $line) { $file = $this->escapeProperty($file); $this->io->write("::error file=". $file .",line=". $line ."::". $message); } elseif ($file) { $file = $this->escapeProperty($file); $this->io->write("::error file=". $file ."::". $message); } else { $this->io->write("::error ::". $message); } } } /** * @param string $data * @return string */ private function escapeData($data) { // see https://github.com/actions/toolkit/blob/4f7fb6513a355689f69f0849edeb369a4dc81729/packages/core/src/command.ts#L80-L85 $data = str_replace("%", '%25', $data); $data = str_replace("\r", '%0D', $data); $data = str_replace("\n", '%0A', $data); return $data; } /** * @param string $property * @return string */ private function escapeProperty($property) { // see https://github.com/actions/toolkit/blob/4f7fb6513a355689f69f0849edeb369a4dc81729/packages/core/src/command.ts#L87-L94 $property = str_replace("%", '%25', $property); $property = str_replace("\r", '%0D', $property); $property = str_replace("\n", '%0A', $property); $property = str_replace(":", '%3A', $property); $property = str_replace(",", '%2C', $property); return $property; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Console; use Composer\Pcre\Preg; use Symfony\Component\Console\Formatter\OutputFormatter; use Symfony\Component\Console\Formatter\OutputFormatterStyle; /** * @author Jordi Boggiano */ class HtmlOutputFormatter extends OutputFormatter { /** @var array */ private static $availableForegroundColors = array( 30 => 'black', 31 => 'red', 32 => 'green', 33 => 'yellow', 34 => 'blue', 35 => 'magenta', 36 => 'cyan', 37 => 'white', ); /** @var array */ private static $availableBackgroundColors = array( 40 => 'black', 41 => 'red', 42 => 'green', 43 => 'yellow', 44 => 'blue', 45 => 'magenta', 46 => 'cyan', 47 => 'white', ); /** @var array */ private static $availableOptions = array( 1 => 'bold', 4 => 'underscore', //5 => 'blink', //7 => 'reverse', //8 => 'conceal' ); /** * @param array $styles Array of "name => FormatterStyle" instances */ public function __construct(array $styles = array()) { parent::__construct(true, $styles); } /** * @param ?string $message * * @return string */ public function format($message) { $formatted = parent::format($message); $clearEscapeCodes = '(?:39|49|0|22|24|25|27|28)'; // TODO in 2.3 replace with Closure::fromCallable and then use Preg::replaceCallback return preg_replace_callback("{\033\[([0-9;]+)m(.*?)\033\[(?:".$clearEscapeCodes.";)*?".$clearEscapeCodes."m}s", array($this, 'formatHtml'), $formatted); } /** * @param string[] $matches * * @return string */ private function formatHtml($matches) { $out = ''.$matches[2].''; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Console; use Composer\IO\NullIO; use Composer\Util\Filesystem; use Composer\Util\Platform; use Composer\Util\Silencer; use Symfony\Component\Console\Application as BaseApplication; use Symfony\Component\Console\Exception\CommandNotFoundException; use Symfony\Component\Console\Helper\HelperSet; use Symfony\Component\Console\Helper\QuestionHelper; use Symfony\Component\Console\Input\InputDefinition; use Symfony\Component\Console\Input\InputInterface; use Symfony\Component\Console\Input\InputOption; use Symfony\Component\Console\Output\OutputInterface; use Seld\JsonLint\ParsingException; use Composer\Command; use Composer\Composer; use Composer\Factory; use Composer\IO\IOInterface; use Composer\IO\ConsoleIO; use Composer\Json\JsonValidationException; use Composer\Util\ErrorHandler; use Composer\Util\HttpDownloader; use Composer\EventDispatcher\ScriptExecutionException; use Composer\Exception\NoSslException; use Composer\XdebugHandler\XdebugHandler; use Symfony\Component\Process\Exception\ProcessTimedOutException; /** * The console application that handles the commands * * @author Ryan Weaver * @author Jordi Boggiano * @author FranÃ§ois Pluchino */ class Application extends BaseApplication { /** * @var ?Composer */ protected $composer; /** * @var IOInterface */ protected $io; /** @var string */ private static $logo = ' ______ / ____/___ ____ ___ ____ ____ ________ _____ / / / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/ / /___/ /_/ / / / / / / /_/ / /_/ (__ ) __/ / \____/\____/_/ /_/ /_/ .___/\____/____/\___/_/ /_/ '; /** @var bool */ private $hasPluginCommands = false; /** @var bool */ private $disablePluginsByDefault = false; /** @var bool */ private $disableScriptsByDefault = false; /** * @var string Store the initial working directory at startup time */ private $initialWorkingDirectory; public function __construct() { static $shutdownRegistered = false; if (function_exists('ini_set') && extension_loaded('xdebug')) { ini_set('xdebug.show_exception_trace', '0'); ini_set('xdebug.scream', '0'); } if (function_exists('date_default_timezone_set') && function_exists('date_default_timezone_get')) { date_default_timezone_set(Silencer::call('date_default_timezone_get')); } if (!$shutdownRegistered) { if (function_exists('pcntl_async_signals') && function_exists('pcntl_signal')) { pcntl_async_signals(true); pcntl_signal(SIGINT, function ($sig) { exit(130); }); } $shutdownRegistered = true; register_shutdown_function(function () { $lastError = error_get_last(); if ($lastError && $lastError['message'] && (strpos($lastError['message'], 'Allowed memory') !== false /*Zend PHP out of memory error*/ || strpos($lastError['message'], 'exceeded memory') !== false /*HHVM out of memory errors*/)) { echo "\n". 'Check https://getcomposer.org/doc/articles/troubleshooting.md#memory-limit-errors for more info on how to handle out of memory errors.'; } }); } $this->io = new NullIO(); $this->initialWorkingDirectory = getcwd(); parent::__construct('Composer', Composer::getVersion()); } /** * @return int */ public function run(InputInterface $input = null, OutputInterface $output = null) { if (null === $output) { $output = Factory::createOutput(); } return parent::run($input, $output); } /** * @return int */ public function doRun(InputInterface $input, OutputInterface $output) { $this->disablePluginsByDefault = $input->hasParameterOption('--no-plugins'); $this->disableScriptsByDefault = $input->hasParameterOption('--no-scripts'); if (Platform::getEnv('COMPOSER_NO_INTERACTION') || !Platform::isTty(defined('STDIN') ? STDIN : fopen('php://stdin', 'r'))) { $input->setInteractive(false); } $io = $this->io = new ConsoleIO($input, $output, new HelperSet(array( new QuestionHelper(), ))); // Register error handler again to pass it the IO instance ErrorHandler::register($io); if ($input->hasParameterOption('--no-cache')) { $io->writeError('Disabling cache usage', true, IOInterface::DEBUG); Platform::putEnv('COMPOSER_CACHE_DIR', Platform::isWindows() ? 'nul' : '/dev/null'); } // switch working dir if ($newWorkDir = $this->getNewWorkingDir($input)) { $oldWorkingDir = getcwd(); chdir($newWorkDir); $this->initialWorkingDirectory = $newWorkDir; $io->writeError('Changed CWD to ' . getcwd(), true, IOInterface::DEBUG); } // determine command name to be executed without including plugin commands $commandName = ''; if ($name = $this->getCommandName($input)) { try { $commandName = $this->find($name)->getName(); } catch (CommandNotFoundException $e) { // we'll check command validity again later after plugins are loaded $commandName = false; } catch (\InvalidArgumentException $e) { } } // prompt user for dir change if no composer.json is present in current dir if ($io->isInteractive() && !$newWorkDir && !in_array($commandName, array('', 'list', 'init', 'about', 'help', 'diagnose', 'self-update', 'global', 'create-project', 'outdated'), true) && !file_exists(Factory::getComposerFile()) && ($useParentDirIfNoJsonAvailable = $this->getUseParentDirConfigValue()) !== false) { $dir = dirname(getcwd()); $home = realpath(Platform::getEnv('HOME') ?: Platform::getEnv('USERPROFILE') ?: '/'); // abort when we reach the home dir or top of the filesystem while (dirname($dir) !== $dir && $dir !== $home) { if (file_exists($dir.'/'.Factory::getComposerFile())) { if ($useParentDirIfNoJsonAvailable === true || $io->askConfirmation('No composer.json in current directory, do you want to use the one at '.$dir.'? [Y,n]? ')) { if ($useParentDirIfNoJsonAvailable === true) { $io->writeError('No composer.json in current directory, changing working directory to '.$dir.''); } else { $io->writeError('Always want to use the parent dir? Use "composer config --global use-parent-dir true" to change the default.'); } $oldWorkingDir = getcwd(); chdir($dir); } break; } $dir = dirname($dir); } } // avoid loading plugins/initializing the Composer instance earlier than necessary if no plugin command is needed // if showing the version, we never need plugin commands $mayNeedPluginCommand = false === $input->hasParameterOption(array('--version', '-V')) && ( // not a composer command, so try loading plugin ones false === $commandName // list command requires plugin commands to show them || in_array($commandName, array('', 'list', 'help'), true) ); if ($mayNeedPluginCommand && !$this->disablePluginsByDefault && !$this->hasPluginCommands) { try { foreach ($this->getPluginCommands() as $command) { if ($this->has($command->getName())) { $io->writeError('Plugin command '.$command->getName().' ('.get_class($command).') would override a Composer command and has been skipped'); } else { $this->add($command); } } } catch (NoSslException $e) { // suppress these as they are not relevant at this point } catch (ParsingException $e) { $details = $e->getDetails(); $file = realpath(Factory::getComposerFile()); $line = null; if ($details && isset($details['line'])) { $line = $details['line']; } $ghe = new GithubActionError($this->io); $ghe->emit($e->getMessage(), $file, $line); throw $e; } $this->hasPluginCommands = true; } // determine command name to be executed incl plugin commands, and check if it's a proxy command $isProxyCommand = false; if ($name = $this->getCommandName($input)) { try { $command = $this->find($name); $commandName = $command->getName(); $isProxyCommand = ($command instanceof Command\BaseCommand && $command->isProxyCommand()); } catch (\InvalidArgumentException $e) { } } if (!$isProxyCommand) { $io->writeError(sprintf( 'Running %s (%s) with %s on %s', Composer::getVersion(), Composer::RELEASE_DATE, defined('HHVM_VERSION') ? 'HHVM '.HHVM_VERSION : 'PHP '.PHP_VERSION, function_exists('php_uname') ? php_uname('s') . ' / ' . php_uname('r') : 'Unknown OS' ), true, IOInterface::DEBUG); if (PHP_VERSION_ID < 50302) { $io->writeError('Composer only officially supports PHP 5.3.2 and above, you will most likely encounter problems with your PHP '.PHP_VERSION.', upgrading is strongly recommended.'); } if (XdebugHandler::isXdebugActive() && !Platform::getEnv('COMPOSER_DISABLE_XDEBUG_WARN')) { $io->writeError('Composer is operating slower than normal because you have Xdebug enabled. See https://getcomposer.org/xdebug'); } if (defined('COMPOSER_DEV_WARNING_TIME') && $commandName !== 'self-update' && $commandName !== 'selfupdate' && time() > COMPOSER_DEV_WARNING_TIME) { $io->writeError(sprintf('Warning: This development build of Composer is over 60 days old. It is recommended to update it by running "%s self-update" to get the latest version.', $_SERVER['PHP_SELF'])); } if ( !Platform::isWindows() && function_exists('exec') && !Platform::getEnv('COMPOSER_ALLOW_SUPERUSER') && (ini_get('open_basedir') || !file_exists('/.dockerenv')) ) { if (function_exists('posix_getuid') && posix_getuid() === 0) { if ($commandName !== 'self-update' && $commandName !== 'selfupdate') { $io->writeError('Do not run Composer as root/super user! See https://getcomposer.org/root for details'); if ($io->isInteractive()) { if (!$io->askConfirmation('Continue as root/super user [yes]? ')) { return 1; } } } if ($uid = (int) Platform::getEnv('SUDO_UID')) { // Silently clobber any sudo credentials on the invoking user to avoid privilege escalations later on // ref. https://github.com/composer/composer/issues/5119 Silencer::call('exec', "sudo -u \\#{$uid} sudo -K > /dev/null 2>&1"); } } // Silently clobber any remaining sudo leases on the current user as well to avoid privilege escalations Silencer::call('exec', 'sudo -K > /dev/null 2>&1'); } // Check system temp folder for usability as it can cause weird runtime issues otherwise Silencer::call(function () use ($io) { $tempfile = sys_get_temp_dir() . '/temp-' . md5(microtime()); if (!(file_put_contents($tempfile, __FILE__) && (file_get_contents($tempfile) == __FILE__) && unlink($tempfile) && !file_exists($tempfile))) { $io->writeError(sprintf('PHP temp directory (%s) does not exist or is not writable to Composer. Set sys_temp_dir in your php.ini', sys_get_temp_dir())); } }); // add non-standard scripts as own commands $file = Factory::getComposerFile(); if (is_file($file) && Filesystem::isReadable($file) && is_array($composer = json_decode(file_get_contents($file), true))) { if (isset($composer['scripts']) && is_array($composer['scripts'])) { foreach ($composer['scripts'] as $script => $dummy) { if (!defined('Composer\Script\ScriptEvents::'.str_replace('-', '_', strtoupper($script)))) { if ($this->has($script)) { $io->writeError('A script named '.$script.' would override a Composer command and has been skipped'); } else { $description = null; if (isset($composer['scripts-descriptions'][$script])) { $description = $composer['scripts-descriptions'][$script]; } $this->add(new Command\ScriptAliasCommand($script, $description)); } } } } } } try { if ($input->hasParameterOption('--profile')) { $startTime = microtime(true); $this->io->enableDebugging($startTime); } $result = parent::doRun($input, $output); // chdir back to $oldWorkingDir if set if (isset($oldWorkingDir)) { Silencer::call('chdir', $oldWorkingDir); } if (isset($startTime)) { $io->writeError('Memory usage: '.round(memory_get_usage() / 1024 / 1024, 2).'MiB (peak: '.round(memory_get_peak_usage() / 1024 / 1024, 2).'MiB), time: '.round(microtime(true) - $startTime, 2).'s'); } restore_error_handler(); return $result; } catch (ScriptExecutionException $e) { return $e->getCode(); } catch (\Exception $e) { $ghe = new GithubActionError($this->io); $ghe->emit($e->getMessage()); $this->hintCommonErrors($e); restore_error_handler(); throw $e; } } /** * @param InputInterface $input * @throws \RuntimeException * @return string */ private function getNewWorkingDir(InputInterface $input) { $workingDir = $input->getParameterOption(array('--working-dir', '-d')); if (false !== $workingDir && !is_dir($workingDir)) { throw new \RuntimeException('Invalid working directory specified, '.$workingDir.' does not exist.'); } return $workingDir; } /** * @return void */ private function hintCommonErrors(\Exception $exception) { $io = $this->getIO(); Silencer::suppress(); try { $composer = $this->getComposer(false, true); if (null !== $composer && function_exists('disk_free_space')) { $config = $composer->getConfig(); $minSpaceFree = 1024 * 1024; if ((($df = disk_free_space($dir = $config->get('home'))) !== false && $df < $minSpaceFree) || (($df = disk_free_space($dir = $config->get('vendor-dir'))) !== false && $df < $minSpaceFree) || (($df = disk_free_space($dir = sys_get_temp_dir())) !== false && $df < $minSpaceFree) ) { $io->writeError('The disk hosting '.$dir.' is full, this may be the cause of the following exception', true, IOInterface::QUIET); } } } catch (\Exception $e) { } Silencer::restore(); if (Platform::isWindows() && false !== strpos($exception->getMessage(), 'The system cannot find the path specified')) { $io->writeError('The following exception may be caused by a stale entry in your cmd.exe AutoRun', true, IOInterface::QUIET); $io->writeError('Check https://getcomposer.org/doc/articles/troubleshooting.md#-the-system-cannot-find-the-path-specified-windows- for details', true, IOInterface::QUIET); } if (false !== strpos($exception->getMessage(), 'fork failed - Cannot allocate memory')) { $io->writeError('The following exception is caused by a lack of memory or swap, or not having swap configured', true, IOInterface::QUIET); $io->writeError('Check https://getcomposer.org/doc/articles/troubleshooting.md#proc-open-fork-failed-errors for details', true, IOInterface::QUIET); } if ($exception instanceof ProcessTimedOutException) { $io->writeError('The following exception is caused by a process timeout', true, IOInterface::QUIET); $io->writeError('Check https://getcomposer.org/doc/06-config.md#process-timeout for details', true, IOInterface::QUIET); } if ($hints = HttpDownloader::getExceptionHints($exception)) { foreach ($hints as $hint) { $io->writeError($hint, true, IOInterface::QUIET); } } } /** * @param bool $required * @param bool|null $disablePlugins * @param bool|null $disableScripts * @throws JsonValidationException * @throws \InvalidArgumentException * @return ?\Composer\Composer If $required is true then the return value is guaranteed */ public function getComposer($required = true, $disablePlugins = null, $disableScripts = null) { if (null === $disablePlugins) { $disablePlugins = $this->disablePluginsByDefault; } if (null === $disableScripts) { $disableScripts = $this->disableScriptsByDefault; } if (null === $this->composer) { try { $this->composer = Factory::create($this->io, null, $disablePlugins, $disableScripts); } catch (\InvalidArgumentException $e) { if ($required) { $this->io->writeError($e->getMessage()); // TODO composer 2.3 simplify to $this->areExceptionsCaught() if (!method_exists($this, 'areExceptionsCaught') || $this->areExceptionsCaught()) { exit(1); } throw $e; } } catch (JsonValidationException $e) { if ($required) { throw $e; } } } return $this->composer; } /** * Removes the cached composer instance * * @return void */ public function resetComposer() { $this->composer = null; if (method_exists($this->getIO(), 'resetAuthentications')) { $this->getIO()->resetAuthentications(); } } /** * @return IOInterface */ public function getIO() { return $this->io; } /** * @return string */ public function getHelp() { return self::$logo . parent::getHelp(); } /** * Initializes all the composer commands. * @return \Symfony\Component\Console\Command\Command[] */ protected function getDefaultCommands() { $commands = array_merge(parent::getDefaultCommands(), array( new Command\AboutCommand(), new Command\ConfigCommand(), new Command\DependsCommand(), new Command\ProhibitsCommand(), new Command\InitCommand(), new Command\InstallCommand(), new Command\CreateProjectCommand(), new Command\UpdateCommand(), new Command\SearchCommand(), new Command\ValidateCommand(), new Command\ShowCommand(), new Command\SuggestsCommand(), new Command\RequireCommand(), new Command\DumpAutoloadCommand(), new Command\StatusCommand(), new Command\ArchiveCommand(), new Command\DiagnoseCommand(), new Command\RunScriptCommand(), new Command\LicensesCommand(), new Command\GlobalCommand(), new Command\ClearCacheCommand(), new Command\RemoveCommand(), new Command\HomeCommand(), new Command\ExecCommand(), new Command\OutdatedCommand(), new Command\CheckPlatformReqsCommand(), new Command\FundCommand(), new Command\ReinstallCommand(), )); if (strpos(__FILE__, 'phar:') === 0) { $commands[] = new Command\SelfUpdateCommand(); } return $commands; } /** * @return string */ public function getLongVersion() { if (Composer::BRANCH_ALIAS_VERSION && Composer::BRANCH_ALIAS_VERSION !== '@package_branch_alias_version'.'@') { return sprintf( '%s version %s (%s) %s', $this->getName(), Composer::BRANCH_ALIAS_VERSION, $this->getVersion(), Composer::RELEASE_DATE ); } return parent::getLongVersion() . ' ' . Composer::RELEASE_DATE; } /** * @return InputDefinition */ protected function getDefaultInputDefinition() { $definition = parent::getDefaultInputDefinition(); $definition->addOption(new InputOption('--profile', null, InputOption::VALUE_NONE, 'Display timing and memory usage information')); $definition->addOption(new InputOption('--no-plugins', null, InputOption::VALUE_NONE, 'Whether to disable plugins.')); $definition->addOption(new InputOption('--no-scripts', null, InputOption::VALUE_NONE, 'Skips the execution of all scripts defined in composer.json file.')); $definition->addOption(new InputOption('--working-dir', '-d', InputOption::VALUE_REQUIRED, 'If specified, use the given directory as working directory.')); $definition->addOption(new InputOption('--no-cache', null, InputOption::VALUE_NONE, 'Prevent use of the cache')); return $definition; } /** * @return Command\BaseCommand[] */ private function getPluginCommands() { $commands = array(); $composer = $this->getComposer(false, false); if (null === $composer) { $composer = Factory::createGlobal($this->io); } if (null !== $composer) { $pm = $composer->getPluginManager(); foreach ($pm->getPluginCapabilities('Composer\Plugin\Capability\CommandProvider', array('composer' => $composer, 'io' => $this->io)) as $capability) { $newCommands = $capability->getCommands(); if (!is_array($newCommands)) { throw new \UnexpectedValueException('Plugin capability '.get_class($capability).' failed to return an array from getCommands'); } foreach ($newCommands as $command) { if (!$command instanceof Command\BaseCommand) { throw new \UnexpectedValueException('Plugin capability '.get_class($capability).' returned an invalid value, we expected an array of Composer\Command\BaseCommand objects'); } } $commands = array_merge($commands, $newCommands); } } return $commands; } /** * Get the working directory at startup time * * @return string */ public function getInitialWorkingDirectory() { return $this->initialWorkingDirectory; } /** * @return bool */ public function getDisablePluginsByDefault() { return $this->disablePluginsByDefault; } /** * @return bool */ public function getDisableScriptsByDefault() { return $this->disableScriptsByDefault; } /** * @return 'prompt'|bool */ private function getUseParentDirConfigValue() { $config = Factory::createConfig($this->io); return $config->get('use-parent-dir'); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer; use Composer\IO\IOInterface; use Composer\Pcre\Preg; use Composer\Util\Filesystem; use Composer\Util\Platform; use Composer\Util\Silencer; use Symfony\Component\Finder\Finder; /** * Reads/writes to a filesystem cache * * @author Jordi Boggiano */ class Cache { /** @var bool|null */ private static $cacheCollected = null; /** @var IOInterface */ private $io; /** @var string */ private $root; /** @var ?bool */ private $enabled = null; /** @var string */ private $allowlist; /** @var Filesystem */ private $filesystem; /** @var bool */ private $readOnly; /** * @param IOInterface $io * @param string $cacheDir location of the cache * @param string $allowlist List of characters that are allowed in path names (used in a regex character class) * @param Filesystem $filesystem optional filesystem instance * @param bool $readOnly whether the cache is in readOnly mode */ public function __construct(IOInterface $io, $cacheDir, $allowlist = 'a-z0-9._', Filesystem $filesystem = null, $readOnly = false) { $this->io = $io; $this->root = rtrim($cacheDir, '/\\') . '/'; $this->allowlist = $allowlist; $this->filesystem = $filesystem ?: new Filesystem(); $this->readOnly = (bool) $readOnly; if (!self::isUsable($cacheDir)) { $this->enabled = false; } } /** * @param bool $readOnly * * @return void */ public function setReadOnly($readOnly) { $this->readOnly = (bool) $readOnly; } /** * @return bool */ public function isReadOnly() { return $this->readOnly; } /** * @param string $path * * @return bool */ public static function isUsable($path) { return !Preg::isMatch('{(^|[\\\\/])(\$null|nul|NUL|/dev/null)([\\\\/]|$)}', $path); } /** * @return bool */ public function isEnabled() { if ($this->enabled === null) { $this->enabled = true; if ( !$this->readOnly && ( (!is_dir($this->root) && !Silencer::call('mkdir', $this->root, 0777, true)) || !is_writable($this->root) ) ) { $this->io->writeError('Cannot create cache directory ' . $this->root . ', or directory is not writable. Proceeding without cache. See also cache-read-only config if your filesystem is read-only.'); $this->enabled = false; } } return $this->enabled; } /** * @return string */ public function getRoot() { return $this->root; } /** * @param string $file * * @return string|false */ public function read($file) { if ($this->isEnabled()) { $file = Preg::replace('{[^'.$this->allowlist.']}i', '-', $file); if (file_exists($this->root . $file)) { $this->io->writeError('Reading '.$this->root . $file.' from cache', true, IOInterface::DEBUG); return file_get_contents($this->root . $file); } } return false; } /** * @param string $file * @param string $contents * * @return bool */ public function write($file, $contents) { if ($this->isEnabled() && !$this->readOnly) { $file = Preg::replace('{[^'.$this->allowlist.']}i', '-', $file); $this->io->writeError('Writing '.$this->root . $file.' into cache', true, IOInterface::DEBUG); $tempFileName = $this->root . $file . uniqid('.', true) . '.tmp'; try { return file_put_contents($tempFileName, $contents) !== false && rename($tempFileName, $this->root . $file); } catch (\ErrorException $e) { $this->io->writeError('Failed to write into cache: '.$e->getMessage().'', true, IOInterface::DEBUG); if (Preg::isMatch('{^file_put_contents: Only ([0-9]+) of ([0-9]+) bytes written}', $e->getMessage(), $m)) { // Remove partial file. unlink($tempFileName); $message = sprintf( 'Writing %1$s into cache failed after %2$u of %3$u bytes written, only %4$s bytes of free space available', $tempFileName, $m[1], $m[2], function_exists('disk_free_space') ? @disk_free_space(dirname($tempFileName)) : 'unknown' ); $this->io->writeError($message); return false; } throw $e; } } return false; } /** * Copy a file into the cache * * @param string $file * @param string $source * * @return bool */ public function copyFrom($file, $source) { if ($this->isEnabled() && !$this->readOnly) { $file = Preg::replace('{[^'.$this->allowlist.']}i', '-', $file); $this->filesystem->ensureDirectoryExists(dirname($this->root . $file)); if (!file_exists($source)) { $this->io->writeError(''.$source.' does not exist, can not write into cache'); } elseif ($this->io->isDebug()) { $this->io->writeError('Writing '.$this->root . $file.' into cache from '.$source); } return copy($source, $this->root . $file); } return false; } /** * Copy a file out of the cache * * @param string $file * @param string $target * * @return bool */ public function copyTo($file, $target) { if ($this->isEnabled()) { $file = Preg::replace('{[^'.$this->allowlist.']}i', '-', $file); if (file_exists($this->root . $file)) { try { touch($this->root . $file, filemtime($this->root . $file), time()); } catch (\ErrorException $e) { // fallback in case the above failed due to incorrect ownership // see https://github.com/composer/composer/issues/4070 Silencer::call('touch', $this->root . $file); } $this->io->writeError('Reading '.$this->root . $file.' from cache', true, IOInterface::DEBUG); return copy($this->root . $file, $target); } } return false; } /** * @return bool */ public function gcIsNecessary() { if (self::$cacheCollected) { return false; } self::$cacheCollected = true; if (Platform::getEnv('COMPOSER_TEST_SUITE')) { return false; } if (PHP_VERSION_ID > 70000) { return !random_int(0, 50); } return !mt_rand(0, 50); } /** * @param string $file * * @return bool */ public function remove($file) { if ($this->isEnabled() && !$this->readOnly) { $file = Preg::replace('{[^'.$this->allowlist.']}i', '-', $file); if (file_exists($this->root . $file)) { return $this->filesystem->unlink($this->root . $file); } } return false; } /** * @return bool */ public function clear() { if ($this->isEnabled() && !$this->readOnly) { $this->filesystem->emptyDirectory($this->root); return true; } return false; } /** * @param string $file * @return int|false * @phpstan-return int<0, max>|false */ public function getAge($file) { if ($this->isEnabled()) { $file = Preg::replace('{[^'.$this->allowlist.']}i', '-', $file); if (file_exists($this->root . $file) && ($mtime = filemtime($this->root . $file)) !== false) { return abs(time() - $mtime); } } return false; } /** * @param int $ttl * @param int $maxSize * * @return bool */ public function gc($ttl, $maxSize) { if ($this->isEnabled() && !$this->readOnly) { $expire = new \DateTime(); $expire->modify('-'.$ttl.' seconds'); $finder = $this->getFinder()->date('until '.$expire->format('Y-m-d H:i:s')); foreach ($finder as $file) { $this->filesystem->unlink($file->getPathname()); } $totalSize = $this->filesystem->size($this->root); if ($totalSize > $maxSize) { $iterator = $this->getFinder()->sortByAccessedTime()->getIterator(); while ($totalSize > $maxSize && $iterator->valid()) { $filepath = $iterator->current()->getPathname(); $totalSize -= $this->filesystem->size($filepath); $this->filesystem->unlink($filepath); $iterator->next(); } } self::$cacheCollected = true; return true; } return false; } /** * @param string $file * * @return string|false */ public function sha1($file) { if ($this->isEnabled()) { $file = Preg::replace('{[^'.$this->allowlist.']}i', '-', $file); if (file_exists($this->root . $file)) { return sha1_file($this->root . $file); } } return false; } /** * @param string $file * * @return string|false */ public function sha256($file) { if ($this->isEnabled()) { $file = Preg::replace('{[^'.$this->allowlist.']}i', '-', $file); if (file_exists($this->root . $file)) { return hash_file('sha256', $this->root . $file); } } return false; } /** * @return Finder */ protected function getFinder() { return Finder::create()->in($this->root)->files(); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Config; use Composer\IO\IOInterface; use Composer\Pcre\Preg; /** * @author Jordi Boggiano */ class Git { /** @var string|false|null */ private static $version = false; /** @var IOInterface */ protected $io; /** @var Config */ protected $config; /** @var ProcessExecutor */ protected $process; /** @var Filesystem */ protected $filesystem; public function __construct(IOInterface $io, Config $config, ProcessExecutor $process, Filesystem $fs) { $this->io = $io; $this->config = $config; $this->process = $process; $this->filesystem = $fs; } /** * @param callable $commandCallable * @param string $url * @param string|null $cwd * @param bool $initialClone * * @return void */ public function runCommand($commandCallable, $url, $cwd, $initialClone = false) { // Ensure we are allowed to use this URL by config $this->config->prohibitUrlByConfig($url, $this->io); if ($initialClone) { $origCwd = $cwd; $cwd = null; } if (Preg::isMatch('{^ssh://[^@]+@[^:]+:[^0-9]+}', $url)) { throw new \InvalidArgumentException('The source URL ' . $url . ' is invalid, ssh URLs should have a port number after ":".' . "\n" . 'Use ssh://git@example.com:22/path or just git@example.com:path if you do not want to provide a password or custom port.'); } if (!$initialClone) { // capture username/password from URL if there is one and we have no auth configured yet $this->process->execute('git remote -v', $output, $cwd); if (Preg::isMatch('{^(?:composer|origin)\s+https?://(.+):(.+)@([^/]+)}im', $output, $match) && !$this->io->hasAuthentication($match[3])) { $this->io->setAuthentication($match[3], rawurldecode($match[1]), rawurldecode($match[2])); } } $protocols = $this->config->get('github-protocols'); if (!is_array($protocols)) { throw new \RuntimeException('Config value "github-protocols" must be an array, got ' . gettype($protocols)); } // public github, autoswitch protocols if (Preg::isMatch('{^(?:https?|git)://' . self::getGitHubDomainsRegex($this->config) . '/(.*)}', $url, $match)) { $messages = array(); foreach ($protocols as $protocol) { if ('ssh' === $protocol) { $protoUrl = "git@" . $match[1] . ":" . $match[2]; } else { $protoUrl = $protocol . "://" . $match[1] . "/" . $match[2]; } if (0 === $this->process->execute(call_user_func($commandCallable, $protoUrl), $ignoredOutput, $cwd)) { return; } $messages[] = '- ' . $protoUrl . "\n" . Preg::replace('#^#m', ' ', $this->process->getErrorOutput()); if ($initialClone && isset($origCwd)) { $this->filesystem->removeDirectory($origCwd); } } // failed to checkout, first check git accessibility if (!$this->io->hasAuthentication($match[1]) && !$this->io->isInteractive()) { $this->throwException('Failed to clone ' . $url . ' via ' . implode(', ', $protocols) . ' protocols, aborting.' . "\n\n" . implode("\n", $messages), $url); } } // if we have a private github url and the ssh protocol is disabled then we skip it and directly fallback to https $bypassSshForGitHub = Preg::isMatch('{^git@' . self::getGitHubDomainsRegex($this->config) . ':(.+?)\.git$}i', $url) && !in_array('ssh', $protocols, true); $command = call_user_func($commandCallable, $url); $auth = null; $credentials = array(); if ($bypassSshForGitHub || 0 !== $this->process->execute($command, $ignoredOutput, $cwd)) { $errorMsg = $this->process->getErrorOutput(); // private github repository without ssh key access, try https with auth if (Preg::isMatch('{^git@' . self::getGitHubDomainsRegex($this->config) . ':(.+?)\.git$}i', $url, $match) || Preg::isMatch('{^https?://' . self::getGitHubDomainsRegex($this->config) . '/(.*?)(?:\.git)?$}i', $url, $match) ) { if (!$this->io->hasAuthentication($match[1])) { $gitHubUtil = new GitHub($this->io, $this->config, $this->process); $message = 'Cloning failed using an ssh key for authentication, enter your GitHub credentials to access private repos'; if (!$gitHubUtil->authorizeOAuth($match[1]) && $this->io->isInteractive()) { $gitHubUtil->authorizeOAuthInteractively($match[1], $message); } } if ($this->io->hasAuthentication($match[1])) { $auth = $this->io->getAuthentication($match[1]); $authUrl = 'https://' . rawurlencode($auth['username']) . ':' . rawurlencode($auth['password']) . '@' . $match[1] . '/' . $match[2] . '.git'; $command = call_user_func($commandCallable, $authUrl); if (0 === $this->process->execute($command, $ignoredOutput, $cwd)) { return; } $credentials = array(rawurlencode($auth['username']), rawurlencode($auth['password'])); $errorMsg = $this->process->getErrorOutput(); } } elseif (Preg::isMatch('{^https://(bitbucket\.org)/(.*?)(?:\.git)?$}i', $url, $match)) { //bitbucket oauth $bitbucketUtil = new Bitbucket($this->io, $this->config, $this->process); if (!$this->io->hasAuthentication($match[1])) { $message = 'Enter your Bitbucket credentials to access private repos'; if (!$bitbucketUtil->authorizeOAuth($match[1]) && $this->io->isInteractive()) { $bitbucketUtil->authorizeOAuthInteractively($match[1], $message); $accessToken = $bitbucketUtil->getToken(); $this->io->setAuthentication($match[1], 'x-token-auth', $accessToken); } } else { //We're authenticating with a locally stored consumer. $auth = $this->io->getAuthentication($match[1]); //We already have an access_token from a previous request. if ($auth['username'] !== 'x-token-auth') { $accessToken = $bitbucketUtil->requestToken($match[1], $auth['username'], $auth['password']); if (!empty($accessToken)) { $this->io->setAuthentication($match[1], 'x-token-auth', $accessToken); } } } if ($this->io->hasAuthentication($match[1])) { $auth = $this->io->getAuthentication($match[1]); $authUrl = 'https://' . rawurlencode($auth['username']) . ':' . rawurlencode($auth['password']) . '@' . $match[1] . '/' . $match[2] . '.git'; $command = call_user_func($commandCallable, $authUrl); if (0 === $this->process->execute($command, $ignoredOutput, $cwd)) { return; } $credentials = array(rawurlencode($auth['username']), rawurlencode($auth['password'])); $errorMsg = $this->process->getErrorOutput(); } else { // Falling back to ssh $sshUrl = 'git@bitbucket.org:' . $match[2] . '.git'; $this->io->writeError(' No bitbucket authentication configured. Falling back to ssh.'); $command = call_user_func($commandCallable, $sshUrl); if (0 === $this->process->execute($command, $ignoredOutput, $cwd)) { return; } $errorMsg = $this->process->getErrorOutput(); } } elseif ( Preg::isMatch('{^(git)@' . self::getGitLabDomainsRegex($this->config) . ':(.+?\.git)$}i', $url, $match) || Preg::isMatch('{^(https?)://' . self::getGitLabDomainsRegex($this->config) . '/(.*)}i', $url, $match) ) { if ($match[1] === 'git') { $match[1] = 'https'; } if (!$this->io->hasAuthentication($match[2])) { $gitLabUtil = new GitLab($this->io, $this->config, $this->process); $message = 'Cloning failed, enter your GitLab credentials to access private repos'; if (!$gitLabUtil->authorizeOAuth($match[2]) && $this->io->isInteractive()) { $gitLabUtil->authorizeOAuthInteractively($match[1], $match[2], $message); } } if ($this->io->hasAuthentication($match[2])) { $auth = $this->io->getAuthentication($match[2]); if ($auth['password'] === 'private-token' || $auth['password'] === 'oauth2' || $auth['password'] === 'gitlab-ci-token') { $authUrl = $match[1] . '://' . rawurlencode($auth['password']) . ':' . rawurlencode($auth['username']) . '@' . $match[2] . '/' . $match[3]; // swap username and password } else { $authUrl = $match[1] . '://' . rawurlencode($auth['username']) . ':' . rawurlencode($auth['password']) . '@' . $match[2] . '/' . $match[3]; } $command = call_user_func($commandCallable, $authUrl); if (0 === $this->process->execute($command, $ignoredOutput, $cwd)) { return; } $credentials = array(rawurlencode($auth['username']), rawurlencode($auth['password'])); $errorMsg = $this->process->getErrorOutput(); } } elseif ($this->isAuthenticationFailure($url, $match)) { // private non-github/gitlab/bitbucket repo that failed to authenticate if (strpos($match[2], '@')) { list($authParts, $match[2]) = explode('@', $match[2], 2); } $storeAuth = false; if ($this->io->hasAuthentication($match[2])) { $auth = $this->io->getAuthentication($match[2]); } elseif ($this->io->isInteractive()) { $defaultUsername = null; if (isset($authParts) && $authParts) { if (false !== strpos($authParts, ':')) { list($defaultUsername, ) = explode(':', $authParts, 2); } else { $defaultUsername = $authParts; } } $this->io->writeError(' Authentication required (' . $match[2] . '):'); $auth = array( 'username' => $this->io->ask(' Username: ', $defaultUsername), 'password' => $this->io->askAndHideAnswer(' Password: '), ); $storeAuth = $this->config->get('store-auths'); } if ($auth) { $authUrl = $match[1] . rawurlencode($auth['username']) . ':' . rawurlencode($auth['password']) . '@' . $match[2] . $match[3]; $command = call_user_func($commandCallable, $authUrl); if (0 === $this->process->execute($command, $ignoredOutput, $cwd)) { $this->io->setAuthentication($match[2], $auth['username'], $auth['password']); $authHelper = new AuthHelper($this->io, $this->config); $authHelper->storeAuth($match[2], $storeAuth); return; } $credentials = array(rawurlencode($auth['username']), rawurlencode($auth['password'])); $errorMsg = $this->process->getErrorOutput(); } } if ($initialClone && isset($origCwd)) { $this->filesystem->removeDirectory($origCwd); } if (count($credentials) > 0) { $command = $this->maskCredentials($command, $credentials); $errorMsg = $this->maskCredentials($errorMsg, $credentials); } $this->throwException('Failed to execute ' . $command . "\n\n" . $errorMsg, $url); } } /** * @param string $url * @param string $dir * * @return bool */ public function syncMirror($url, $dir) { if (Platform::getEnv('COMPOSER_DISABLE_NETWORK') && Platform::getEnv('COMPOSER_DISABLE_NETWORK') !== 'prime') { $this->io->writeError('Aborting git mirror sync of '.$url.' as network is disabled'); return false; } // update the repo if it is a valid git repository if (is_dir($dir) && 0 === $this->process->execute('git rev-parse --git-dir', $output, $dir) && trim($output) === '.') { try { $commandCallable = function ($url) { $sanitizedUrl = Preg::replace('{://([^@]+?):(.+?)@}', '://', $url); return sprintf('git remote set-url origin -- %s && git remote update --prune origin && git remote set-url origin -- %s && git gc --auto', ProcessExecutor::escape($url), ProcessExecutor::escape($sanitizedUrl)); }; $this->runCommand($commandCallable, $url, $dir); } catch (\Exception $e) { $this->io->writeError('Sync mirror failed: ' . $e->getMessage() . '', true, IOInterface::DEBUG); return false; } return true; } // clean up directory and do a fresh clone into it $this->filesystem->removeDirectory($dir); $commandCallable = function ($url) use ($dir) { return sprintf('git clone --mirror -- %s %s', ProcessExecutor::escape($url), ProcessExecutor::escape($dir)); }; $this->runCommand($commandCallable, $url, $dir, true); return true; } /** * @param string $url * @param string $dir * @param string $ref * @param ?string $prettyVersion * * @return bool */ public function fetchRefOrSyncMirror($url, $dir, $ref, $prettyVersion = null) { if ($this->checkRefIsInMirror($dir, $ref)) { if (Preg::isMatch('{^[a-f0-9]{40}$}', $ref) && $prettyVersion !== null) { $branch = Preg::replace('{(?:^dev-|(?:\.x)?-dev$)}i', '', $prettyVersion); $branches = null; $tags = null; if (0 === $this->process->execute('git branch', $output, $dir)) { $branches = $output; } if (0 === $this->process->execute('git tag', $output, $dir)) { $tags = $output; } // if the pretty version cannot be found as a branch (nor branch with 'v' in front of the branch as it may have been stripped when generating pretty name), // nor as a tag, then we sync the mirror as otherwise it will likely fail during install. // this can occur if a git tag gets created *after* the reference is already put into the cache, as the ref check above will then not sync the new tags // see https://github.com/composer/composer/discussions/11002 if (null !== $branches && !Preg::isMatch('{^[\s*]*v?'.preg_quote($branch).'$}m', $branches) && null !== $tags && !Preg::isMatch('{^[\s*]*'.preg_quote($branch).'$}m', $tags) ) { $this->syncMirror($url, $dir); } } return true; } if ($this->syncMirror($url, $dir)) { return $this->checkRefIsInMirror($dir, $ref); } return false; } /** * @return string */ public static function getNoShowSignatureFlag(ProcessExecutor $process) { $gitVersion = self::getVersion($process); if ($gitVersion && version_compare($gitVersion, '2.10.0-rc0', '>=')) { return ' --no-show-signature'; } return ''; } /** * @param string $dir * @param string $ref * * @return bool */ private function checkRefIsInMirror($dir, $ref) { if (is_dir($dir) && 0 === $this->process->execute('git rev-parse --git-dir', $output, $dir) && trim($output) === '.') { $escapedRef = ProcessExecutor::escape($ref.'^{commit}'); $exitCode = $this->process->execute(sprintf('git rev-parse --quiet --verify %s', $escapedRef), $ignoredOutput, $dir); if ($exitCode === 0) { return true; } } return false; } /** * @param string $url * @param string[] $match * * @return bool */ private function isAuthenticationFailure($url, &$match) { if (!Preg::isMatch('{^(https?://)([^/]+)(.*)$}i', $url, $match)) { return false; } $authFailures = array( 'fatal: Authentication failed', 'remote error: Invalid username or password.', 'error: 401 Unauthorized', 'fatal: unable to access', 'fatal: could not read Username', ); $errorOutput = $this->process->getErrorOutput(); foreach ($authFailures as $authFailure) { if (strpos($errorOutput, $authFailure) !== false) { return true; } } return false; } /** * @return void */ public static function cleanEnv() { if (PHP_VERSION_ID < 50400 && ini_get('safe_mode') && false === strpos(ini_get('safe_mode_allowed_env_vars'), 'GIT_ASKPASS')) { throw new \RuntimeException('safe_mode is enabled and safe_mode_allowed_env_vars does not contain GIT_ASKPASS, can not set env var. You can disable safe_mode with "-dsafe_mode=0" when running composer'); } // added in git 1.7.1, prevents prompting the user for username/password if (Platform::getEnv('GIT_ASKPASS') !== 'echo') { Platform::putEnv('GIT_ASKPASS', 'echo'); } // clean up rogue git env vars in case this is running in a git hook if (Platform::getEnv('GIT_DIR')) { Platform::clearEnv('GIT_DIR'); } if (Platform::getEnv('GIT_WORK_TREE')) { Platform::clearEnv('GIT_WORK_TREE'); } // Run processes with predictable LANGUAGE if (Platform::getEnv('LANGUAGE') !== 'C') { Platform::putEnv('LANGUAGE', 'C'); } // clean up env for OSX, see https://github.com/composer/composer/issues/2146#issuecomment-35478940 Platform::clearEnv('DYLD_LIBRARY_PATH'); } /** * @return non-empty-string */ public static function getGitHubDomainsRegex(Config $config) { return '(' . implode('|', array_map('preg_quote', $config->get('github-domains'))) . ')'; } /** * @return non-empty-string */ public static function getGitLabDomainsRegex(Config $config) { return '(' . implode('|', array_map('preg_quote', $config->get('gitlab-domains'))) . ')'; } /** * @param non-empty-string $message * @param string $url * * @return never */ private function throwException($message, $url) { // git might delete a directory when it fails and php will not know clearstatcache(); if (0 !== $this->process->execute('git --version', $ignoredOutput)) { throw new \RuntimeException(Url::sanitize('Failed to clone ' . $url . ', git was not found, check that it is installed and in your PATH env.' . "\n\n" . $this->process->getErrorOutput())); } throw new \RuntimeException(Url::sanitize($message)); } /** * Retrieves the current git version. * * @return string|null The git version number, if present. */ public static function getVersion(ProcessExecutor $process) { if (false === self::$version) { self::$version = null; if (0 === $process->execute('git --version', $output) && Preg::isMatch('/^git version (\d+(?:\.\d+)+)/m', $output, $matches)) { self::$version = $matches[1]; } } return self::$version; } /** * @param string $error * @param string[] $credentials * * @return string */ private function maskCredentials($error, array $credentials) { $maskedCredentials = array(); foreach ($credentials as $credential) { if (in_array($credential, array('private-token', 'x-token-auth', 'oauth2', 'gitlab-ci-token', 'x-oauth-basic'))) { $maskedCredentials[] = $credential; } elseif (strlen($credential) > 6) { $maskedCredentials[] = substr($credential, 0, 3) . '...' . substr($credential, -3); } elseif (strlen($credential) > 3) { $maskedCredentials[] = substr($credential, 0, 3) . '...'; } else { $maskedCredentials[] = 'XXX'; } } return str_replace($credentials, $maskedCredentials, $error); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Factory; use Composer\IO\IOInterface; use Composer\Config; use Composer\Downloader\TransportException; /** * @author Paul Wenke */ class Bitbucket { /** @var IOInterface */ private $io; /** @var Config */ private $config; /** @var ProcessExecutor */ private $process; /** @var HttpDownloader */ private $httpDownloader; /** @var array{access_token: string, expires_in?: int}|null */ private $token = null; /** @var int|null */ private $time; const OAUTH2_ACCESS_TOKEN_URL = 'https://bitbucket.org/site/oauth2/access_token'; /** * Constructor. * * @param IOInterface $io The IO instance * @param Config $config The composer configuration * @param ProcessExecutor $process Process instance, injectable for mocking * @param HttpDownloader $httpDownloader Remote Filesystem, injectable for mocking * @param int $time Timestamp, injectable for mocking */ public function __construct(IOInterface $io, Config $config, ProcessExecutor $process = null, HttpDownloader $httpDownloader = null, $time = null) { $this->io = $io; $this->config = $config; $this->process = $process ?: new ProcessExecutor($io); $this->httpDownloader = $httpDownloader ?: Factory::createHttpDownloader($this->io, $config); $this->time = $time; } /** * @return string */ public function getToken() { if (!isset($this->token['access_token'])) { return ''; } return $this->token['access_token']; } /** * Attempts to authorize a Bitbucket domain via OAuth * * @param string $originUrl The host this Bitbucket instance is located at * @return bool true on success */ public function authorizeOAuth($originUrl) { if ($originUrl !== 'bitbucket.org') { return false; } // if available use token from git config if (0 === $this->process->execute('git config bitbucket.accesstoken', $output)) { $this->io->setAuthentication($originUrl, 'x-token-auth', trim($output)); return true; } return false; } /** * @return bool */ private function requestAccessToken() { try { $response = $this->httpDownloader->get(self::OAUTH2_ACCESS_TOKEN_URL, array( 'retry-auth-failure' => false, 'http' => array( 'method' => 'POST', 'content' => 'grant_type=client_credentials', ), )); $token = $response->decodeJson(); if (!isset($token['expires_in']) || !isset($token['access_token'])) { throw new \LogicException('Expected a token configured with expires_in and access_token present, got '.json_encode($token)); } $this->token = $token; } catch (TransportException $e) { if ($e->getCode() === 400) { $this->io->writeError('Invalid OAuth consumer provided.'); $this->io->writeError('This can have two reasons:'); $this->io->writeError('1. You are authenticating with a bitbucket username/password combination'); $this->io->writeError('2. You are using an OAuth consumer, but didn\'t configure a (dummy) callback url'); return false; } if (in_array($e->getCode(), array(403, 401))) { $this->io->writeError('Invalid OAuth consumer provided.'); $this->io->writeError('You can also add it manually later by using "composer config --global --auth bitbucket-oauth.bitbucket.org

"'); return false; } throw $e; } return true; } /** * Authorizes a Bitbucket domain interactively via OAuth * * @param string $originUrl The host this Bitbucket instance is located at * @param string $message The reason this authorization is required * @throws \RuntimeException * @throws TransportException|\Exception * @return bool true on success */ public function authorizeOAuthInteractively($originUrl, $message = null) { if ($message) { $this->io->writeError($message); } $url = 'https://support.atlassian.com/bitbucket-cloud/docs/use-oauth-on-bitbucket-cloud/'; $this->io->writeError(sprintf('Follow the instructions on %s', $url)); $this->io->writeError(sprintf('to create a consumer. It will be stored in "%s" for future use by Composer.', $this->config->getAuthConfigSource()->getName())); $this->io->writeError('Ensure you enter a "Callback URL" (http://example.com is fine) or it will not be possible to create an Access Token (this callback url will not be used by composer)'); $consumerKey = trim((string) $this->io->askAndHideAnswer('Consumer Key (hidden): ')); if (!$consumerKey) { $this->io->writeError('No consumer key given, aborting.'); $this->io->writeError('You can also add it manually later by using "composer config --global --auth bitbucket-oauth.bitbucket.org

"'); return false; } $consumerSecret = trim((string) $this->io->askAndHideAnswer('Consumer Secret (hidden): ')); if (!$consumerSecret) { $this->io->writeError('No consumer secret given, aborting.'); $this->io->writeError('You can also add it manually later by using "composer config --global --auth bitbucket-oauth.bitbucket.org

"'); return false; } $this->io->setAuthentication($originUrl, $consumerKey, $consumerSecret); if (!$this->requestAccessToken()) { return false; } // store value in user config $this->storeInAuthConfig($originUrl, $consumerKey, $consumerSecret); // Remove conflicting basic auth credentials (if available) $this->config->getAuthConfigSource()->removeConfigSetting('http-basic.' . $originUrl); $this->io->writeError('Consumer stored successfully.'); return true; } /** * Retrieves an access token from Bitbucket. * * @param string $originUrl * @param string $consumerKey * @param string $consumerSecret * @return string */ public function requestToken($originUrl, $consumerKey, $consumerSecret) { if ($this->token !== null || $this->getTokenFromConfig($originUrl)) { return $this->token['access_token']; } $this->io->setAuthentication($originUrl, $consumerKey, $consumerSecret); if (!$this->requestAccessToken()) { return ''; } $this->storeInAuthConfig($originUrl, $consumerKey, $consumerSecret); if (!isset($this->token['access_token'])) { throw new \LogicException('Failed to initialize token above'); } return $this->token['access_token']; } /** * Store the new/updated credentials to the configuration * * @param string $originUrl * @param string $consumerKey * @param string $consumerSecret * * @return void */ private function storeInAuthConfig($originUrl, $consumerKey, $consumerSecret) { $this->config->getConfigSource()->removeConfigSetting('bitbucket-oauth.'.$originUrl); if (null === $this->token || !isset($this->token['expires_in'])) { throw new \LogicException('Expected a token configured with expires_in present, got '.json_encode($this->token)); } $time = null === $this->time ? time() : $this->time; $consumer = array( "consumer-key" => $consumerKey, "consumer-secret" => $consumerSecret, "access-token" => $this->token['access_token'], "access-token-expiration" => $time + $this->token['expires_in'], ); $this->config->getAuthConfigSource()->addConfigSetting('bitbucket-oauth.'.$originUrl, $consumer); } /** * @param string $originUrl * @return bool */ private function getTokenFromConfig($originUrl) { $authConfig = $this->config->get('bitbucket-oauth'); if ( !isset($authConfig[$originUrl]['access-token'], $authConfig[$originUrl]['access-token-expiration']) || time() > $authConfig[$originUrl]['access-token-expiration'] ) { return false; } $this->token = array( 'access_token' => $authConfig[$originUrl]['access-token'], ); return true; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Pcre\Preg; /** * Composer mirror utilities * * @author Jordi Boggiano */ class ComposerMirror { /** * @param string $mirrorUrl * @param string $packageName * @param string $version * @param string|null $reference * @param string|null $type * @param string|null $prettyVersion * * @return string */ public static function processUrl($mirrorUrl, $packageName, $version, $reference, $type, $prettyVersion = null) { if ($reference) { $reference = Preg::isMatch('{^([a-f0-9]*|%reference%)$}', $reference) ? $reference : md5($reference); } $version = strpos($version, '/') === false ? $version : md5($version); $from = array('%package%', '%version%', '%reference%', '%type%'); $to = array($packageName, $version, $reference, $type); if (null !== $prettyVersion) { $from[] = '%prettyVersion%'; $to[] = $prettyVersion; } return str_replace($from, $to, $mirrorUrl); } /** * @param string $mirrorUrl * @param string $packageName * @param string $url * @param string|null $type * * @return string */ public static function processGitUrl($mirrorUrl, $packageName, $url, $type) { if (Preg::isMatch('#^(?:(?:https?|git)://github\.com/|git@github\.com:)([^/]+)/(.+?)(?:\.git)?$#', $url, $match)) { $url = 'gh-'.$match[1].'/'.$match[2]; } elseif (Preg::isMatch('#^https://bitbucket\.org/([^/]+)/(.+?)(?:\.git)?/?$#', $url, $match)) { $url = 'bb-'.$match[1].'/'.$match[2]; } else { $url = Preg::replace('{[^a-z0-9_.-]}i', '-', trim($url, '/')); } return str_replace( array('%package%', '%normalizedUrl%', '%type%'), array($packageName, $url, $type), $mirrorUrl ); } /** * @param string $mirrorUrl * @param string $packageName * @param string $url * @param string $type * * @return string */ public static function processHgUrl($mirrorUrl, $packageName, $url, $type) { return self::processGitUrl($mirrorUrl, $packageName, $url, $type); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Config; use Composer\IO\IOInterface; use Composer\Pcre\Preg; /** * @author Jonas Renaudot */ class Hg { /** @var string|false|null */ private static $version = false; /** * @var \Composer\IO\IOInterface */ private $io; /** * @var \Composer\Config */ private $config; /** * @var \Composer\Util\ProcessExecutor */ private $process; public function __construct(IOInterface $io, Config $config, ProcessExecutor $process) { $this->io = $io; $this->config = $config; $this->process = $process; } /** * @param callable $commandCallable * @param string $url * @param string|null $cwd * * @return void */ public function runCommand($commandCallable, $url, $cwd) { $this->config->prohibitUrlByConfig($url, $this->io); // Try as is $command = call_user_func($commandCallable, $url); if (0 === $this->process->execute($command, $ignoredOutput, $cwd)) { return; } // Try with the authentication information available if (Preg::isMatch('{^(https?)://((.+)(?:\:(.+))?@)?([^/]+)(/.*)?}mi', $url, $match) && $this->io->hasAuthentication($match[5])) { $auth = $this->io->getAuthentication($match[5]); $authenticatedUrl = $match[1] . '://' . rawurlencode($auth['username']) . ':' . rawurlencode($auth['password']) . '@' . $match[5] . (!empty($match[6]) ? $match[6] : null); $command = call_user_func($commandCallable, $authenticatedUrl); if (0 === $this->process->execute($command, $ignoredOutput, $cwd)) { return; } $error = $this->process->getErrorOutput(); } else { $error = 'The given URL (' . $url . ') does not match the required format (http(s)://(username:password@)example.com/path-to-repository)'; } $this->throwException('Failed to clone ' . $url . ', ' . "\n\n" . $error, $url); } /** * @param non-empty-string $message * @param string $url * * @return never */ private function throwException($message, $url) { if (null === self::getVersion($this->process)) { throw new \RuntimeException(Url::sanitize('Failed to clone ' . $url . ', hg was not found, check that it is installed and in your PATH env.' . "\n\n" . $this->process->getErrorOutput())); } throw new \RuntimeException(Url::sanitize($message)); } /** * Retrieves the current hg version. * * @return string|null The hg version number, if present. */ public static function getVersion(ProcessExecutor $process) { if (false === self::$version) { self::$version = null; if (0 === $process->execute('hg --version', $output) && Preg::isMatch('/^.+? (\d+(?:\.\d+)+)(?:\+.*?)?\)?\r?\n/', $output, $matches)) { self::$version = $matches[1]; } } return self::$version; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use React\Promise\CancellablePromiseInterface; use Symfony\Component\Console\Helper\ProgressBar; use React\Promise\PromiseInterface; /** * @author Jordi Boggiano */ class Loop { /** @var HttpDownloader */ private $httpDownloader; /** @var ProcessExecutor|null */ private $processExecutor; /** @var PromiseInterface[][] */ private $currentPromises = array(); /** @var int */ private $waitIndex = 0; public function __construct(HttpDownloader $httpDownloader, ProcessExecutor $processExecutor = null) { $this->httpDownloader = $httpDownloader; $this->httpDownloader->enableAsync(); $this->processExecutor = $processExecutor; if ($this->processExecutor) { $this->processExecutor->enableAsync(); } } /** * @return HttpDownloader */ public function getHttpDownloader() { return $this->httpDownloader; } /** * @return ProcessExecutor|null */ public function getProcessExecutor() { return $this->processExecutor; } /** * @param PromiseInterface[] $promises * @param ?ProgressBar $progress * @return void */ public function wait(array $promises, ProgressBar $progress = null) { /** @var \Exception|null */ $uncaught = null; \React\Promise\all($promises)->then( function () { }, function ($e) use (&$uncaught) { $uncaught = $e; } ); // keep track of every group of promises that is waited on, so abortJobs can // cancel them all, even if wait() was called within a wait() $waitIndex = $this->waitIndex++; $this->currentPromises[$waitIndex] = $promises; if ($progress) { $totalJobs = 0; $totalJobs += $this->httpDownloader->countActiveJobs(); if ($this->processExecutor) { $totalJobs += $this->processExecutor->countActiveJobs(); } $progress->start($totalJobs); } $lastUpdate = 0; while (true) { $activeJobs = 0; $activeJobs += $this->httpDownloader->countActiveJobs(); if ($this->processExecutor) { $activeJobs += $this->processExecutor->countActiveJobs(); } if ($progress && microtime(true) - $lastUpdate > 0.1) { $lastUpdate = microtime(true); $progress->setProgress($progress->getMaxSteps() - $activeJobs); } if (!$activeJobs) { break; } } // as we skip progress updates if they are too quick, make sure we do one last one here at 100% if ($progress) { $progress->finish(); } unset($this->currentPromises[$waitIndex]); if ($uncaught) { throw $uncaught; } } /** * @return void */ public function abortJobs() { foreach ($this->currentPromises as $promiseGroup) { foreach ($promiseGroup as $promise) { if ($promise instanceof CancellablePromiseInterface) { $promise->cancel(); } } } } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\IO\IOInterface; use Composer\Pcre\Preg; use Symfony\Component\Process\Process; use Symfony\Component\Process\Exception\RuntimeException; use React\Promise\Promise; use React\Promise\PromiseInterface; /** * @author Robert SchÃ¶nthal * @author Jordi Boggiano */ class ProcessExecutor { const STATUS_QUEUED = 1; const STATUS_STARTED = 2; const STATUS_COMPLETED = 3; const STATUS_FAILED = 4; const STATUS_ABORTED = 5; /** @var int */ protected static $timeout = 300; /** @var bool */ protected $captureOutput = false; /** @var string */ protected $errorOutput = ''; /** @var ?IOInterface */ protected $io; /** * @phpstan-var array> */ private $jobs = array(); /** @var int */ private $runningJobs = 0; /** @var int */ private $maxJobs = 10; /** @var int */ private $idGen = 0; /** @var bool */ private $allowAsync = false; public function __construct(IOInterface $io = null) { $this->io = $io; } /** * runs a process on the commandline * * @param string $command the command to execute * @param mixed $output the output will be written into this var if passed by ref * if a callable is passed it will be used as output handler * @param ?string $cwd the working directory * @return int statuscode */ public function execute($command, &$output = null, $cwd = null) { if (func_num_args() > 1) { return $this->doExecute($command, $cwd, false, $output); } return $this->doExecute($command, $cwd, false); } /** * runs a process on the commandline in TTY mode * * @param string $command the command to execute * @param ?string $cwd the working directory * @return int statuscode */ public function executeTty($command, $cwd = null) { if (Platform::isTty()) { return $this->doExecute($command, $cwd, true); } return $this->doExecute($command, $cwd, false); } /** * @param string $command * @param ?string $cwd * @param bool $tty * @param mixed $output * @return int */ private function doExecute($command, $cwd, $tty, &$output = null) { $this->outputCommandRun($command, $cwd, false); // TODO in 2.2, these two checks can be dropped as Symfony 4+ supports them out of the box // make sure that null translate to the proper directory in case the dir is a symlink // and we call a git command, because msysgit does not handle symlinks properly if (null === $cwd && Platform::isWindows() && false !== strpos($command, 'git') && getcwd()) { $cwd = realpath(getcwd()); } if (null !== $cwd && !is_dir($cwd)) { throw new \RuntimeException('The given CWD for the process does not exist: '.$cwd); } $this->captureOutput = func_num_args() > 3; $this->errorOutput = ''; // TODO in v3, commands should be passed in as arrays of cmd + args if (method_exists('Symfony\Component\Process\Process', 'fromShellCommandline')) { $process = Process::fromShellCommandline($command, $cwd, null, null, static::getTimeout()); } else { /** @phpstan-ignore-next-line */ $process = new Process($command, $cwd, null, null, static::getTimeout()); } if (!Platform::isWindows() && $tty) { try { $process->setTty(true); } catch (RuntimeException $e) { // ignore TTY enabling errors } } $callback = is_callable($output) ? $output : array($this, 'outputHandler'); $process->run($callback); if ($this->captureOutput && !is_callable($output)) { $output = $process->getOutput(); } $this->errorOutput = $process->getErrorOutput(); return $process->getExitCode(); } /** * starts a process on the commandline in async mode * * @param string $command the command to execute * @param string $cwd the working directory * @return PromiseInterface */ public function executeAsync($command, $cwd = null) { if (!$this->allowAsync) { throw new \LogicException('You must use the ProcessExecutor instance which is part of a Composer\Loop instance to be able to run async processes'); } $job = array( 'id' => $this->idGen++, 'status' => self::STATUS_QUEUED, 'command' => $command, 'cwd' => $cwd, ); $resolver = function ($resolve, $reject) use (&$job) { $job['status'] = ProcessExecutor::STATUS_QUEUED; $job['resolve'] = $resolve; $job['reject'] = $reject; }; $self = $this; $canceler = function () use (&$job) { if ($job['status'] === ProcessExecutor::STATUS_QUEUED) { $job['status'] = ProcessExecutor::STATUS_ABORTED; } if ($job['status'] !== ProcessExecutor::STATUS_STARTED) { return; } $job['status'] = ProcessExecutor::STATUS_ABORTED; try { if (defined('SIGINT')) { $job['process']->signal(SIGINT); } } catch (\Exception $e) { // signal can throw in various conditions, but we don't care if it fails } $job['process']->stop(1); throw new \RuntimeException('Aborted process'); }; $promise = new Promise($resolver, $canceler); $promise = $promise->then(function () use (&$job, $self) { if ($job['process']->isSuccessful()) { $job['status'] = ProcessExecutor::STATUS_COMPLETED; } else { $job['status'] = ProcessExecutor::STATUS_FAILED; } // TODO 3.0 this should be done directly on $this when PHP 5.3 is dropped $self->markJobDone(); return $job['process']; }, function ($e) use (&$job, $self) { $job['status'] = ProcessExecutor::STATUS_FAILED; $self->markJobDone(); throw $e; }); $this->jobs[$job['id']] = &$job; if ($this->runningJobs < $this->maxJobs) { $this->startJob($job['id']); } return $promise; } /** * @param int $id * @return void */ private function startJob($id) { $job = &$this->jobs[$id]; if ($job['status'] !== self::STATUS_QUEUED) { return; } // start job $job['status'] = self::STATUS_STARTED; $this->runningJobs++; $command = $job['command']; $cwd = $job['cwd']; $this->outputCommandRun($command, $cwd, true); // TODO in 2.2, these two checks can be dropped as Symfony 4+ supports them out of the box // make sure that null translate to the proper directory in case the dir is a symlink // and we call a git command, because msysgit does not handle symlinks properly if (null === $cwd && Platform::isWindows() && false !== strpos($command, 'git') && getcwd()) { $cwd = realpath(getcwd()); } if (null !== $cwd && !is_dir($cwd)) { throw new \RuntimeException('The given CWD for the process does not exist: '.$cwd); } try { // TODO in v3, commands should be passed in as arrays of cmd + args if (method_exists('Symfony\Component\Process\Process', 'fromShellCommandline')) { $process = Process::fromShellCommandline($command, $cwd, null, null, static::getTimeout()); } else { $process = new Process($command, $cwd, null, null, static::getTimeout()); } } catch (\Exception $e) { call_user_func($job['reject'], $e); return; } catch (\Throwable $e) { call_user_func($job['reject'], $e); return; } $job['process'] = $process; try { $process->start(); } catch (\Exception $e) { call_user_func($job['reject'], $e); return; } catch (\Throwable $e) { call_user_func($job['reject'], $e); return; } } /** * @param ?int $index job id * @return void */ public function wait($index = null) { while (true) { if (!$this->countActiveJobs($index)) { return; } usleep(1000); } } /** * @internal * * @return void */ public function enableAsync() { $this->allowAsync = true; } /** * @internal * * @param ?int $index job id * @return int number of active (queued or started) jobs */ public function countActiveJobs($index = null) { // tick foreach ($this->jobs as $job) { if ($job['status'] === self::STATUS_STARTED) { if (!$job['process']->isRunning()) { call_user_func($job['resolve'], $job['process']); } $job['process']->checkTimeout(); } if ($this->runningJobs < $this->maxJobs) { if ($job['status'] === self::STATUS_QUEUED) { $this->startJob($job['id']); } } } if (null !== $index) { return $this->jobs[$index]['status'] < self::STATUS_COMPLETED ? 1 : 0; } $active = 0; foreach ($this->jobs as $job) { if ($job['status'] < self::STATUS_COMPLETED) { $active++; } else { unset($this->jobs[$job['id']]); } } return $active; } /** * @private * * @return void */ public function markJobDone() { $this->runningJobs--; } /** * @param ?string $output * @return string[] */ public function splitLines($output) { $output = trim((string) $output); return $output === '' ? array() : Preg::split('{\r?\n}', $output); } /** * Get any error output from the last command * * @return string */ public function getErrorOutput() { return $this->errorOutput; } /** * @private * * @param Process::ERR|Process::OUT $type * @param string $buffer * * @return void */ public function outputHandler($type, $buffer) { if ($this->captureOutput) { return; } if (null === $this->io) { echo $buffer; return; } if (Process::ERR === $type) { $this->io->writeErrorRaw($buffer, false); } else { $this->io->writeRaw($buffer, false); } } /** * @return int the timeout in seconds */ public static function getTimeout() { return static::$timeout; } /** * @param int $timeout the timeout in seconds * @return void */ public static function setTimeout($timeout) { static::$timeout = $timeout; } /** * Escapes a string to be used as a shell argument. * * @param string|false|null $argument The argument that will be escaped * * @return string The escaped argument */ public static function escape($argument) { return self::escapeArgument($argument); } /** * @param string $command * @param ?string $cwd * @param bool $async * @return void */ private function outputCommandRun($command, $cwd, $async) { if (null === $this->io || !$this->io->isDebug()) { return; } $safeCommand = Preg::replaceCallback('{://(?P[^:/\s]+):(?P[^@\s/]+)@}i', function ($m) { // if the username looks like a long (12char+) hex string, or a modern github token (e.g. ghp_xxx) we obfuscate that if (Preg::isMatch('{^([a-f0-9]{12,}|gh[a-z]_[a-zA-Z0-9_]+)$}', $m['user'])) { return '://***:***@'; } if (Preg::isMatch('{^[a-f0-9]{12,}$}', $m['user'])) { return '://***:***@'; } return '://'.$m['user'].':***@'; }, $command); $safeCommand = Preg::replace("{--password (.*[^\\\\]\') }", '--password \'***\' ', $safeCommand); $this->io->writeError('Executing'.($async ? ' async' : '').' command ('.($cwd ?: 'CWD').'): '.$safeCommand); } /** * Escapes a string to be used as a shell argument for Symfony Process. * * This method expects cmd.exe to be started with the /V:ON option, which * enables delayed environment variable expansion using ! as the delimiter. * If this is not the case, any escaped ^^!var^^! will be transformed to * ^!var^! and introduce two unintended carets. * * Modified from https://github.com/johnstevenson/winbox-args * MIT Licensed (c) John Stevenson * * @param string|false|null $argument * * @return string */ private static function escapeArgument($argument) { if ('' === ($argument = (string) $argument)) { return escapeshellarg($argument); } if (!Platform::isWindows()) { return "'".str_replace("'", "'\\''", $argument)."'"; } // New lines break cmd.exe command parsing // and special chars like the fullwidth quote can be used to break out // of parameter encoding via "Best Fit" encoding conversion $argument = strtr($argument, array( "\n" => ' ', "\u{ff02}" => '"', "\u{02ba}" => '"', "\u{301d}" => '"', "\u{301e}" => '"', "\u{030e}" => '"', "\u{ff1a}" => ':', "\u{0589}" => ':', "\u{2236}" => ':', "\u{ff0f}" => '/', "\u{2044}" => '/', "\u{2215}" => '/', "\u{00b4}" => '/', )); // In addition to whitespace, commas need quoting to preserve paths $quote = strpbrk($argument, " \t,") !== false; $argument = Preg::replace('/(\\\\*)"/', '$1$1\\"', $argument, -1, $dquotes); $meta = $dquotes || Preg::isMatch('/%[^%]+%|![^!]+!/', $argument); if (!$meta && !$quote) { $quote = strpbrk($argument, '^&|<>()') !== false; } if ($quote) { $argument = '"'.Preg::replace('/(\\\\*)$/', '$1$1', $argument).'"'; } if ($meta) { $argument = Preg::replace('/(["^&|<>()%])/', '^$1', $argument); $argument = Preg::replace('/(!)/', '^^$1', $argument); } return $argument; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Pcre\Preg; use React\Promise\PromiseInterface; use RecursiveDirectoryIterator; use RecursiveIteratorIterator; use Symfony\Component\Filesystem\Exception\IOException; use Symfony\Component\Finder\Finder; /** * @author Jordi Boggiano * @author Johannes M. Schmitt */ class Filesystem { /** @var ?ProcessExecutor */ private $processExecutor; public function __construct(ProcessExecutor $executor = null) { $this->processExecutor = $executor; } /** * @param string $file * * @return bool */ public function remove($file) { if (is_dir($file)) { return $this->removeDirectory($file); } if (file_exists($file)) { return $this->unlink($file); } return false; } /** * Checks if a directory is empty * * @param string $dir * @return bool */ public function isDirEmpty($dir) { $finder = Finder::create() ->ignoreVCS(false) ->ignoreDotFiles(false) ->depth(0) ->in($dir); return \count($finder) === 0; } /** * @param string $dir * @param bool $ensureDirectoryExists * * @return void */ public function emptyDirectory($dir, $ensureDirectoryExists = true) { if (is_link($dir) && file_exists($dir)) { $this->unlink($dir); } if ($ensureDirectoryExists) { $this->ensureDirectoryExists($dir); } if (is_dir($dir)) { $finder = Finder::create() ->ignoreVCS(false) ->ignoreDotFiles(false) ->depth(0) ->in($dir); foreach ($finder as $path) { $this->remove((string) $path); } } } /** * Recursively remove a directory * * Uses the process component if proc_open is enabled on the PHP * installation. * * @param string $directory * @throws \RuntimeException * @return bool */ public function removeDirectory($directory) { $edgeCaseResult = $this->removeEdgeCases($directory); if ($edgeCaseResult !== null) { return $edgeCaseResult; } if (Platform::isWindows()) { $cmd = sprintf('rmdir /S /Q %s', ProcessExecutor::escape(realpath($directory))); } else { $cmd = sprintf('rm -rf %s', ProcessExecutor::escape($directory)); } $result = $this->getProcess()->execute($cmd, $output) === 0; // clear stat cache because external processes aren't tracked by the php stat cache clearstatcache(); if ($result && !is_dir($directory)) { return true; } return $this->removeDirectoryPhp($directory); } /** * Recursively remove a directory asynchronously * * Uses the process component if proc_open is enabled on the PHP * installation. * * @param string $directory * @throws \RuntimeException * @return PromiseInterface */ public function removeDirectoryAsync($directory) { $edgeCaseResult = $this->removeEdgeCases($directory); if ($edgeCaseResult !== null) { return \React\Promise\resolve($edgeCaseResult); } if (Platform::isWindows()) { $cmd = sprintf('rmdir /S /Q %s', ProcessExecutor::escape(realpath($directory))); } else { $cmd = sprintf('rm -rf %s', ProcessExecutor::escape($directory)); } $promise = $this->getProcess()->executeAsync($cmd); $self = $this; return $promise->then(function ($process) use ($directory, $self) { // clear stat cache because external processes aren't tracked by the php stat cache clearstatcache(); if ($process->isSuccessful()) { if (!is_dir($directory)) { return \React\Promise\resolve(true); } } return \React\Promise\resolve($self->removeDirectoryPhp($directory)); }); } /** * @param string $directory * @param bool $fallbackToPhp * * @return bool|null Returns null, when no edge case was hit. Otherwise a bool whether removal was successful */ private function removeEdgeCases($directory, $fallbackToPhp = true) { if ($this->isSymlinkedDirectory($directory)) { return $this->unlinkSymlinkedDirectory($directory); } if ($this->isJunction($directory)) { return $this->removeJunction($directory); } if (is_link($directory)) { return unlink($directory); } if (!is_dir($directory) || !file_exists($directory)) { return true; } if (Preg::isMatch('{^(?:[a-z]:)?[/\\\\]+$}i', $directory)) { throw new \RuntimeException('Aborting an attempted deletion of '.$directory.', this was probably not intended, if it is a real use case please report it.'); } if (!\function_exists('proc_open') && $fallbackToPhp) { return $this->removeDirectoryPhp($directory); } return null; } /** * Recursively delete directory using PHP iterators. * * Uses a CHILD_FIRST RecursiveIteratorIterator to sort files * before directories, creating a single non-recursive loop * to delete files/directories in the correct order. * * @param string $directory * @return bool */ public function removeDirectoryPhp($directory) { $edgeCaseResult = $this->removeEdgeCases($directory, false); if ($edgeCaseResult !== null) { return $edgeCaseResult; } try { $it = new RecursiveDirectoryIterator($directory, RecursiveDirectoryIterator::SKIP_DOTS); } catch (\UnexpectedValueException $e) { // re-try once after clearing the stat cache if it failed as it // sometimes fails without apparent reason, see https://github.com/composer/composer/issues/4009 clearstatcache(); usleep(100000); if (!is_dir($directory)) { return true; } $it = new RecursiveDirectoryIterator($directory, RecursiveDirectoryIterator::SKIP_DOTS); } $ri = new RecursiveIteratorIterator($it, RecursiveIteratorIterator::CHILD_FIRST); foreach ($ri as $file) { if ($file->isDir()) { $this->rmdir($file->getPathname()); } else { $this->unlink($file->getPathname()); } } // release locks on the directory, see https://github.com/composer/composer/issues/9945 unset($ri, $it, $file); return $this->rmdir($directory); } /** * @param string $directory * * @return void */ public function ensureDirectoryExists($directory) { if (!is_dir($directory)) { if (file_exists($directory)) { throw new \RuntimeException( $directory.' exists and is not a directory.' ); } if (!@mkdir($directory, 0777, true)) { throw new \RuntimeException( $directory.' does not exist and could not be created.' ); } } } /** * Attempts to unlink a file and in case of failure retries after 350ms on windows * * @param string $path * @throws \RuntimeException * @return bool */ public function unlink($path) { $unlinked = @$this->unlinkImplementation($path); if (!$unlinked) { // retry after a bit on windows since it tends to be touchy with mass removals if (Platform::isWindows()) { usleep(350000); $unlinked = @$this->unlinkImplementation($path); } if (!$unlinked) { $error = error_get_last(); $message = 'Could not delete '.$path.': ' . @$error['message']; if (Platform::isWindows()) { $message .= "\nThis can be due to an antivirus or the Windows Search Indexer locking the file while they are analyzed"; } throw new \RuntimeException($message); } } return true; } /** * Attempts to rmdir a file and in case of failure retries after 350ms on windows * * @param string $path * @throws \RuntimeException * @return bool */ public function rmdir($path) { $deleted = @rmdir($path); if (!$deleted) { // retry after a bit on windows since it tends to be touchy with mass removals if (Platform::isWindows()) { usleep(350000); $deleted = @rmdir($path); } if (!$deleted) { $error = error_get_last(); $message = 'Could not delete '.$path.': ' . @$error['message']; if (Platform::isWindows()) { $message .= "\nThis can be due to an antivirus or the Windows Search Indexer locking the file while they are analyzed"; } throw new \RuntimeException($message); } } return true; } /** * Copy then delete is a non-atomic version of {@link rename}. * * Some systems can't rename and also don't have proc_open, * which requires this solution. * * @param string $source * @param string $target * * @return void */ public function copyThenRemove($source, $target) { $this->copy($source, $target); if (!is_dir($source)) { $this->unlink($source); return; } $this->removeDirectoryPhp($source); } /** * Copies a file or directory from $source to $target. * * @param string $source * @param string $target * @return bool */ public function copy($source, $target) { if (!is_dir($source)) { return copy($source, $target); } $it = new RecursiveDirectoryIterator($source, RecursiveDirectoryIterator::SKIP_DOTS); $ri = new RecursiveIteratorIterator($it, RecursiveIteratorIterator::SELF_FIRST); $this->ensureDirectoryExists($target); $result = true; /** @var RecursiveDirectoryIterator $ri */ foreach ($ri as $file) { $targetPath = $target . DIRECTORY_SEPARATOR . $ri->getSubPathname(); if ($file->isDir()) { $this->ensureDirectoryExists($targetPath); } else { $result = $result && copy($file->getPathname(), $targetPath); } } return $result; } /** * @param string $source * @param string $target * * @return void */ public function rename($source, $target) { if (true === @rename($source, $target)) { return; } if (!\function_exists('proc_open')) { $this->copyThenRemove($source, $target); return; } if (Platform::isWindows()) { // Try to copy & delete - this is a workaround for random "Access denied" errors. $command = sprintf('xcopy %s %s /E /I /Q /Y', ProcessExecutor::escape($source), ProcessExecutor::escape($target)); $result = $this->getProcess()->execute($command, $output); // clear stat cache because external processes aren't tracked by the php stat cache clearstatcache(); if (0 === $result) { $this->remove($source); return; } } else { // We do not use PHP's "rename" function here since it does not support // the case where $source, and $target are located on different partitions. $command = sprintf('mv %s %s', ProcessExecutor::escape($source), ProcessExecutor::escape($target)); $result = $this->getProcess()->execute($command, $output); // clear stat cache because external processes aren't tracked by the php stat cache clearstatcache(); if (0 === $result) { return; } } $this->copyThenRemove($source, $target); } /** * Returns the shortest path from $from to $to * * @param string $from * @param string $to * @param bool $directories if true, the source/target are considered to be directories * @throws \InvalidArgumentException * @return string */ public function findShortestPath($from, $to, $directories = false) { if (!$this->isAbsolutePath($from) || !$this->isAbsolutePath($to)) { throw new \InvalidArgumentException(sprintf('$from (%s) and $to (%s) must be absolute paths.', $from, $to)); } $from = lcfirst($this->normalizePath($from)); $to = lcfirst($this->normalizePath($to)); if ($directories) { $from = rtrim($from, '/') . '/dummy_file'; } if (\dirname($from) === \dirname($to)) { return './'.basename($to); } $commonPath = $to; while (strpos($from.'/', $commonPath.'/') !== 0 && '/' !== $commonPath && !Preg::isMatch('{^[a-z]:/?$}i', $commonPath)) { $commonPath = strtr(\dirname($commonPath), '\\', '/'); } if (0 !== strpos($from, $commonPath) || '/' === $commonPath) { return $to; } $commonPath = rtrim($commonPath, '/') . '/'; $sourcePathDepth = substr_count(substr($from, \strlen($commonPath)), '/'); $commonPathCode = str_repeat('../', $sourcePathDepth); return ($commonPathCode . substr($to, \strlen($commonPath))) ?: './'; } /** * Returns PHP code that, when executed in $from, will return the path to $to * * @param string $from * @param string $to * @param bool $directories if true, the source/target are considered to be directories * @param bool $staticCode * @throws \InvalidArgumentException * @return string */ public function findShortestPathCode($from, $to, $directories = false, $staticCode = false) { if (!$this->isAbsolutePath($from) || !$this->isAbsolutePath($to)) { throw new \InvalidArgumentException(sprintf('$from (%s) and $to (%s) must be absolute paths.', $from, $to)); } $from = lcfirst($this->normalizePath($from)); $to = lcfirst($this->normalizePath($to)); if ($from === $to) { return $directories ? '__DIR__' : '__FILE__'; } $commonPath = $to; while (strpos($from.'/', $commonPath.'/') !== 0 && '/' !== $commonPath && !Preg::isMatch('{^[a-z]:/?$}i', $commonPath) && '.' !== $commonPath) { $commonPath = strtr(\dirname($commonPath), '\\', '/'); } if (0 !== strpos($from, $commonPath) || '/' === $commonPath || '.' === $commonPath) { return var_export($to, true); } $commonPath = rtrim($commonPath, '/') . '/'; if (strpos($to, $from.'/') === 0) { return '__DIR__ . '.var_export(substr($to, \strlen($from)), true); } $sourcePathDepth = substr_count(substr($from, \strlen($commonPath)), '/') + $directories; if ($staticCode) { $commonPathCode = "__DIR__ . '".str_repeat('/..', $sourcePathDepth)."'"; } else { $commonPathCode = str_repeat('dirname(', $sourcePathDepth).'__DIR__'.str_repeat(')', $sourcePathDepth); } $relTarget = substr($to, \strlen($commonPath)); return $commonPathCode . (\strlen($relTarget) ? '.' . var_export('/' . $relTarget, true) : ''); } /** * Checks if the given path is absolute * * @param string $path * @return bool */ public function isAbsolutePath($path) { return strpos($path, '/') === 0 || substr($path, 1, 1) === ':' || strpos($path, '\\\\') === 0; } /** * Returns size of a file or directory specified by path. If a directory is * given, its size will be computed recursively. * * @param string $path Path to the file or directory * @throws \RuntimeException * @return int */ public function size($path) { if (!file_exists($path)) { throw new \RuntimeException("$path does not exist."); } if (is_dir($path)) { return $this->directorySize($path); } return filesize($path); } /** * Normalize a path. This replaces backslashes with slashes, removes ending * slash and collapses redundant separators and up-level references. * * @param string $path Path to the file or directory * @return string */ public function normalizePath($path) { $parts = array(); $path = strtr($path, '\\', '/'); $prefix = ''; $absolute = ''; // extract windows UNC paths e.g. \\foo\bar if (strpos($path, '//') === 0 && \strlen($path) > 2) { $absolute = '//'; $path = substr($path, 2); } // extract a prefix being a protocol://, protocol:, protocol://drive: or simply drive: if (Preg::isMatch('{^( [0-9a-z]{2,}+: (?: // (?: [a-z]: )? )? | [a-z]: )}ix', $path, $match)) { $prefix = $match[1]; $path = substr($path, \strlen($prefix)); } if (strpos($path, '/') === 0) { $absolute = '/'; $path = substr($path, 1); } $up = false; foreach (explode('/', $path) as $chunk) { if ('..' === $chunk && ($absolute !== '' || $up)) { array_pop($parts); $up = !(empty($parts) || '..' === end($parts)); } elseif ('.' !== $chunk && '' !== $chunk) { $parts[] = $chunk; $up = '..' !== $chunk; } } return $prefix.((string) $absolute).implode('/', $parts); } /** * Remove trailing slashes if present to avoid issues with symlinks * * And other possible unforeseen disasters, see https://github.com/composer/composer/pull/9422 * * @param string $path * @return string */ public static function trimTrailingSlash($path) { if (!Preg::isMatch('{^[/\\\\]+$}', $path)) { $path = rtrim($path, '/\\'); } return $path; } /** * Return if the given path is local * * @param string $path * @return bool */ public static function isLocalPath($path) { // on windows, \\foo indicates network paths so we exclude those from local paths, however it is unsafe // on linux as file:////foo (which would be a network path \\foo on windows) will resolve to /foo which could be a local path if (Platform::isWindows()) { return Preg::isMatch('{^(file://(?!//)|/(?!/)|/?[a-z]:[\\\\/]|\.\.[\\\\/]|[a-z0-9_.-]+[\\\\/])}i', $path); } return Preg::isMatch('{^(file://|/|/?[a-z]:[\\\\/]|\.\.[\\\\/]|[a-z0-9_.-]+[\\\\/])}i', $path); } /** * @param string $path * * @return string */ public static function getPlatformPath($path) { if (Platform::isWindows()) { $path = Preg::replace('{^(?:file:///([a-z]):?/)}i', 'file://$1:/', $path); } return (string) Preg::replace('{^file://}i', '', $path); } /** * Cross-platform safe version of is_readable() * * This will also check for readability by reading the file as is_readable can not be trusted on network-mounts * and \\wsl$ paths. See https://github.com/composer/composer/issues/8231 and https://bugs.php.net/bug.php?id=68926 * * @param string $path * @return bool */ public static function isReadable($path) { if (is_readable($path)) { return true; } if (is_file($path)) { return false !== Silencer::call('file_get_contents', $path, false, null, 0, 1); } if (is_dir($path)) { return false !== Silencer::call('opendir', $path); } // assume false otherwise return false; } /** * @param string $directory * * @return int */ protected function directorySize($directory) { $it = new RecursiveDirectoryIterator($directory, RecursiveDirectoryIterator::SKIP_DOTS); $ri = new RecursiveIteratorIterator($it, RecursiveIteratorIterator::CHILD_FIRST); $size = 0; foreach ($ri as $file) { if ($file->isFile()) { $size += $file->getSize(); } } return $size; } /** * @return ProcessExecutor */ protected function getProcess() { if (!$this->processExecutor) { $this->processExecutor = new ProcessExecutor(); } return $this->processExecutor; } /** * delete symbolic link implementation (commonly known as "unlink()") * * symbolic links on windows which link to directories need rmdir instead of unlink * * @param string $path * * @return bool */ private function unlinkImplementation($path) { if (Platform::isWindows() && is_dir($path) && is_link($path)) { return rmdir($path); } return unlink($path); } /** * Creates a relative symlink from $link to $target * * @param string $target The path of the binary file to be symlinked * @param string $link The path where the symlink should be created * @return bool */ public function relativeSymlink($target, $link) { if (!function_exists('symlink')) { return false; } $cwd = getcwd(); $relativePath = $this->findShortestPath($link, $target); chdir(\dirname($link)); $result = @symlink($relativePath, $link); chdir($cwd); return $result; } /** * return true if that directory is a symlink. * * @param string $directory * * @return bool */ public function isSymlinkedDirectory($directory) { if (!is_dir($directory)) { return false; } $resolved = $this->resolveSymlinkedDirectorySymlink($directory); return is_link($resolved); } /** * @param string $directory * * @return bool */ private function unlinkSymlinkedDirectory($directory) { $resolved = $this->resolveSymlinkedDirectorySymlink($directory); return $this->unlink($resolved); } /** * resolve pathname to symbolic link of a directory * * @param string $pathname directory path to resolve * * @return string resolved path to symbolic link or original pathname (unresolved) */ private function resolveSymlinkedDirectorySymlink($pathname) { if (!is_dir($pathname)) { return $pathname; } $resolved = rtrim($pathname, '/'); if (!\strlen($resolved)) { return $pathname; } return $resolved; } /** * Creates an NTFS junction. * * @param string $target * @param string $junction * * @return void */ public function junction($target, $junction) { if (!Platform::isWindows()) { throw new \LogicException(sprintf('Function %s is not available on non-Windows platform', __CLASS__)); } if (!is_dir($target)) { throw new IOException(sprintf('Cannot junction to "%s" as it is not a directory.', $target), 0, null, $target); } // Removing any previously junction to ensure clean execution. if (!is_dir($junction) || $this->isJunction($junction)) { @rmdir($junction); } $cmd = sprintf( 'mklink /J %s %s', ProcessExecutor::escape(str_replace('/', DIRECTORY_SEPARATOR, $junction)), ProcessExecutor::escape(realpath($target)) ); if ($this->getProcess()->execute($cmd, $output) !== 0) { throw new IOException(sprintf('Failed to create junction to "%s" at "%s".', $target, $junction), 0, null, $target); } clearstatcache(true, $junction); } /** * Returns whether the target directory is a Windows NTFS Junction. * * We test if the path is a directory and not an ordinary link, then check * that the mode value returned from lstat (which gives the status of the * link itself) is not a directory, by replicating the POSIX S_ISDIR test. * * This logic works because PHP does not set the mode value for a junction, * since there is no universal file type flag for it. Unfortunately an * uninitialized variable in PHP prior to 7.2.16 and 7.3.3 may cause a * random value to be returned. See https://bugs.php.net/bug.php?id=77552 * * If this random value passes the S_ISDIR test, then a junction will not be * detected and a recursive delete operation could lead to loss of data in * the target directory. Note that Windows rmdir can handle this situation * and will only delete the junction (from Windows 7 onwards). * * @param string $junction Path to check. * @return bool */ public function isJunction($junction) { if (!Platform::isWindows()) { return false; } // Important to clear all caches first clearstatcache(true, $junction); if (!is_dir($junction) || is_link($junction)) { return false; } $stat = lstat($junction); // S_ISDIR test (S_IFDIR is 0x4000, S_IFMT is 0xF000 bitmask) return $stat ? 0x4000 !== ($stat['mode'] & 0xF000) : false; } /** * Removes a Windows NTFS junction. * * @param string $junction * @return bool */ public function removeJunction($junction) { if (!Platform::isWindows()) { return false; } $junction = rtrim(str_replace('/', DIRECTORY_SEPARATOR, $junction), DIRECTORY_SEPARATOR); if (!$this->isJunction($junction)) { throw new IOException(sprintf('%s is not a junction and thus cannot be removed as one', $junction)); } return $this->rmdir($junction); } /** * @param string $path * @param string $content * * @return int|false */ public function filePutContentsIfModified($path, $content) { $currentContent = @file_get_contents($path); if (!$currentContent || ($currentContent != $content)) { return file_put_contents($path, $content); } return 0; } /** * Copy file using stream_copy_to_stream to work around https://bugs.php.net/bug.php?id=6463 * * @param string $source * @param string $target * * @return void */ public function safeCopy($source, $target) { if (!file_exists($target) || !file_exists($source) || !$this->filesAreEqual($source, $target)) { $source = fopen($source, 'r'); $target = fopen($target, 'w+'); stream_copy_to_stream($source, $target); fclose($source); fclose($target); } } /** * compare 2 files * https://stackoverflow.com/questions/3060125/can-i-use-file-get-contents-to-compare-two-files * * @param string $a * @param string $b * * @return bool */ private function filesAreEqual($a, $b) { // Check if filesize is different if (filesize($a) !== filesize($b)) { return false; } // Check if content is different $ah = fopen($a, 'rb'); $bh = fopen($b, 'rb'); $result = true; while (!feof($ah)) { if (fread($ah, 8192) != fread($bh, 8192)) { $result = false; break; } } fclose($ah); fclose($bh); return $result; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Package\PackageInterface; use Composer\Package\RootPackageInterface; class PackageSorter { /** * Sorts packages by dependency weight * * Packages of equal weight are sorted alphabetically * * @param PackageInterface[] $packages * @param array $weights Pre-set weights for some packages to give them more (negative number) or less (positive) weight offsets * @return PackageInterface[] sorted array */ public static function sortPackages(array $packages, array $weights = array()) { $usageList = array(); foreach ($packages as $package) { $links = $package->getRequires(); if ($package instanceof RootPackageInterface) { $links = array_merge($links, $package->getDevRequires()); } foreach ($links as $link) { $target = $link->getTarget(); $usageList[$target][] = $package->getName(); } } $computing = array(); $computed = array(); $computeImportance = function ($name) use (&$computeImportance, &$computing, &$computed, $usageList, $weights) { // reusing computed importance if (isset($computed[$name])) { return $computed[$name]; } // canceling circular dependency if (isset($computing[$name])) { return 0; } $computing[$name] = true; $weight = isset($weights[$name]) ? $weights[$name] : 0; if (isset($usageList[$name])) { foreach ($usageList[$name] as $user) { $weight -= 1 - $computeImportance($user); } } unset($computing[$name]); $computed[$name] = $weight; return $weight; }; $weightedPackages = array(); foreach ($packages as $index => $package) { $name = $package->getName(); $weight = $computeImportance($name); $weightedPackages[] = array('name' => $name, 'weight' => $weight, 'index' => $index); } usort($weightedPackages, function ($a, $b) { if ($a['weight'] !== $b['weight']) { return $a['weight'] - $b['weight']; } return strnatcasecmp($a['name'], $b['name']); }); $sortedPackages = array(); foreach ($weightedPackages as $pkg) { $sortedPackages[] = $packages[$pkg['index']]; } return $sortedPackages; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\CaBundle\CaBundle; use Composer\Pcre\Preg; /** * @author Chris Smith */ final class TlsHelper { /** * Match hostname against a certificate. * * @param mixed $certificate X.509 certificate * @param string $hostname Hostname in the URL * @param string $cn Set to the common name of the certificate iff match found * * @return bool */ public static function checkCertificateHost($certificate, $hostname, &$cn = null) { $names = self::getCertificateNames($certificate); if (empty($names)) { return false; } $combinedNames = array_merge($names['san'], array($names['cn'])); $hostname = strtolower($hostname); foreach ($combinedNames as $certName) { $matcher = self::certNameMatcher($certName); if ($matcher && $matcher($hostname)) { $cn = $names['cn']; return true; } } return false; } /** * Extract DNS names out of an X.509 certificate. * * @param mixed $certificate X.509 certificate * * @return array{cn: string, san: string[]}|null */ public static function getCertificateNames($certificate) { if (is_array($certificate)) { $info = $certificate; } elseif (CaBundle::isOpensslParseSafe()) { $info = openssl_x509_parse($certificate, false); } if (!isset($info['subject']['commonName'])) { return null; } $commonName = strtolower($info['subject']['commonName']); $subjectAltNames = array(); if (isset($info['extensions']['subjectAltName'])) { $subjectAltNames = Preg::split('{\s*,\s*}', $info['extensions']['subjectAltName']); $subjectAltNames = array_filter(array_map(function ($name) { if (0 === strpos($name, 'DNS:')) { return strtolower(ltrim(substr($name, 4))); } return null; }, $subjectAltNames)); $subjectAltNames = array_values($subjectAltNames); } return array( 'cn' => $commonName, 'san' => $subjectAltNames, ); } /** * Get the certificate pin. * * By Kevin McArthur of StormTide Digital Studios Inc. * @KevinSMcArthur / https://github.com/StormTide * * See https://tools.ietf.org/html/draft-ietf-websec-key-pinning-02 * * This method was adapted from Sslurp. * https://github.com/EvanDotPro/Sslurp * * (c) Evan Coury * * For the full copyright and license information, please see below: * * Copyright (c) 2013, Evan Coury * All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, * are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * @param string $certificate * @return string */ public static function getCertificateFingerprint($certificate) { $pubkeydetails = openssl_pkey_get_details(openssl_get_publickey($certificate)); $pubkeypem = $pubkeydetails['key']; //Convert PEM to DER before SHA1'ing $start = '-----BEGIN PUBLIC KEY-----'; $end = '-----END PUBLIC KEY-----'; $pemtrim = substr($pubkeypem, strpos($pubkeypem, $start) + strlen($start), (strlen($pubkeypem) - strpos($pubkeypem, $end)) * (-1)); $der = base64_decode($pemtrim); return sha1($der); } /** * Test if it is safe to use the PHP function openssl_x509_parse(). * * This checks if OpenSSL extensions is vulnerable to remote code execution * via the exploit documented as CVE-2013-6420. * * @return bool */ public static function isOpensslParseSafe() { return CaBundle::isOpensslParseSafe(); } /** * Convert certificate name into matching function. * * @param string $certName CN/SAN * * @return callable|null */ private static function certNameMatcher($certName) { $wildcards = substr_count($certName, '*'); if (0 === $wildcards) { // Literal match. return function ($hostname) use ($certName) { return $hostname === $certName; }; } if (1 === $wildcards) { $components = explode('.', $certName); if (3 > count($components)) { // Must have 3+ components return null; } $firstComponent = $components[0]; // Wildcard must be the last character. if ('*' !== $firstComponent[strlen($firstComponent) - 1]) { return null; } $wildcardRegex = preg_quote($certName); $wildcardRegex = str_replace('\\*', '[a-z0-9-]+', $wildcardRegex); $wildcardRegex = "{^{$wildcardRegex}$}"; return function ($hostname) use ($wildcardRegex) { return Preg::isMatch($wildcardRegex, $hostname); }; } return null; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\IO\IOInterface; use Composer\Pcre\Preg; use Symfony\Component\Process\Process; /** * @author Matt Whittom * * @phpstan-type RepoConfig array{unique_perforce_client_name?: string, depot?: string, branch?: string, p4user?: string, p4password?: string} */ class Perforce { /** @var string */ protected $path; /** @var ?string */ protected $p4Depot; /** @var ?string */ protected $p4Client; /** @var ?string */ protected $p4User; /** @var ?string */ protected $p4Password; /** @var string */ protected $p4Port; /** @var ?string */ protected $p4Stream; /** @var string */ protected $p4ClientSpec; /** @var ?string */ protected $p4DepotType; /** @var ?string */ protected $p4Branch; /** @var ProcessExecutor */ protected $process; /** @var string */ protected $uniquePerforceClientName; /** @var bool */ protected $windowsFlag; /** @var string */ protected $commandResult; /** @var IOInterface */ protected $io; /** @var ?Filesystem */ protected $filesystem; /** * @phpstan-param RepoConfig $repoConfig * @param string $port * @param string $path * @param ProcessExecutor $process * @param bool $isWindows * @param IOInterface $io */ public function __construct($repoConfig, $port, $path, ProcessExecutor $process, $isWindows, IOInterface $io) { $this->windowsFlag = $isWindows; $this->p4Port = $port; $this->initializePath($path); $this->process = $process; $this->initialize($repoConfig); $this->io = $io; } /** * @phpstan-param RepoConfig $repoConfig * @param string $port * @param string $path * @param ProcessExecutor $process * @param IOInterface $io * * @return self */ public static function create($repoConfig, $port, $path, ProcessExecutor $process, IOInterface $io) { return new Perforce($repoConfig, $port, $path, $process, Platform::isWindows(), $io); } /** * @param string $url * @param ProcessExecutor $processExecutor * * @return bool */ public static function checkServerExists($url, ProcessExecutor $processExecutor) { $output = null; return 0 === $processExecutor->execute('p4 -p ' . ProcessExecutor::escape($url) . ' info -s', $output); } /** * @phpstan-param RepoConfig $repoConfig * * @return void */ public function initialize($repoConfig) { $this->uniquePerforceClientName = $this->generateUniquePerforceClientName(); if (!$repoConfig) { return; } if (isset($repoConfig['unique_perforce_client_name'])) { $this->uniquePerforceClientName = $repoConfig['unique_perforce_client_name']; } if (isset($repoConfig['depot'])) { $this->p4Depot = $repoConfig['depot']; } if (isset($repoConfig['branch'])) { $this->p4Branch = $repoConfig['branch']; } if (isset($repoConfig['p4user'])) { $this->p4User = $repoConfig['p4user']; } else { $this->p4User = $this->getP4variable('P4USER'); } if (isset($repoConfig['p4password'])) { $this->p4Password = $repoConfig['p4password']; } } /** * @param string|null $depot * @param string|null $branch * * @return void */ public function initializeDepotAndBranch($depot, $branch) { if (isset($depot)) { $this->p4Depot = $depot; } if (isset($branch)) { $this->p4Branch = $branch; } } /** * @return non-empty-string */ public function generateUniquePerforceClientName() { return gethostname() . "_" . time(); } /** * @return void */ public function cleanupClientSpec() { $client = $this->getClient(); $task = 'client -d ' . ProcessExecutor::escape($client); $useP4Client = false; $command = $this->generateP4Command($task, $useP4Client); $this->executeCommand($command); $clientSpec = $this->getP4ClientSpec(); $fileSystem = $this->getFilesystem(); $fileSystem->remove($clientSpec); } /** * @param non-empty-string $command * * @return int */ protected function executeCommand($command) { $this->commandResult = ''; return $this->process->execute($command, $this->commandResult); } /** * @return string */ public function getClient() { if (!isset($this->p4Client)) { $cleanStreamName = str_replace(array('//', '/', '@'), array('', '_', ''), $this->getStream()); $this->p4Client = 'composer_perforce_' . $this->uniquePerforceClientName . '_' . $cleanStreamName; } return $this->p4Client; } /** * @return string */ protected function getPath() { return $this->path; } /** * @param string $path * * @return void */ public function initializePath($path) { $this->path = $path; $fs = $this->getFilesystem(); $fs->ensureDirectoryExists($path); } /** * @return string */ protected function getPort() { return $this->p4Port; } /** * @param string $stream * * @return void */ public function setStream($stream) { $this->p4Stream = $stream; $index = strrpos($stream, '/'); //Stream format is //depot/stream, while non-streaming depot is //depot if ($index > 2) { $this->p4DepotType = 'stream'; } } /** * @return bool */ public function isStream() { return is_string($this->p4DepotType) && (strcmp($this->p4DepotType, 'stream') === 0); } /** * @return string */ public function getStream() { if (!isset($this->p4Stream)) { if ($this->isStream()) { $this->p4Stream = '//' . $this->p4Depot . '/' . $this->p4Branch; } else { $this->p4Stream = '//' . $this->p4Depot; } } return $this->p4Stream; } /** * @param string $stream * * @return string */ public function getStreamWithoutLabel($stream) { $index = strpos($stream, '@'); if ($index === false) { return $stream; } return substr($stream, 0, $index); } /** * @return non-empty-string */ public function getP4ClientSpec() { return $this->path . '/' . $this->getClient() . '.p4.spec'; } /** * @return string|null */ public function getUser() { return $this->p4User; } /** * @param string|null $user * * @return void */ public function setUser($user) { $this->p4User = $user; } /** * @return void */ public function queryP4User() { $this->getUser(); if (strlen((string) $this->p4User) > 0) { return; } $this->p4User = $this->getP4variable('P4USER'); if (strlen((string) $this->p4User) > 0) { return; } $this->p4User = $this->io->ask('Enter P4 User:'); if ($this->windowsFlag) { $command = 'p4 set P4USER=' . $this->p4User; } else { $command = 'export P4USER=' . $this->p4User; } $this->executeCommand($command); } /** * @param string $name * @return ?string */ protected function getP4variable($name) { if ($this->windowsFlag) { $command = 'p4 set'; $this->executeCommand($command); $result = trim($this->commandResult); $resArray = explode(PHP_EOL, $result); foreach ($resArray as $line) { $fields = explode('=', $line); if (strcmp($name, $fields[0]) == 0) { $index = strpos($fields[1], ' '); if ($index === false) { $value = $fields[1]; } else { $value = substr($fields[1], 0, $index); } $value = trim($value); return $value; } } return null; } $command = 'echo $' . $name; $this->executeCommand($command); $result = trim($this->commandResult); return $result; } /** * @return string|null */ public function queryP4Password() { if (isset($this->p4Password)) { return $this->p4Password; } $password = $this->getP4variable('P4PASSWD'); if (strlen((string) $password) <= 0) { $password = $this->io->askAndHideAnswer('Enter password for Perforce user ' . $this->getUser() . ': '); } $this->p4Password = $password; return $password; } /** * @param string $command * @param bool $useClient * * @return non-empty-string */ public function generateP4Command($command, $useClient = true) { $p4Command = 'p4 '; $p4Command .= '-u ' . $this->getUser() . ' '; if ($useClient) { $p4Command .= '-c ' . $this->getClient() . ' '; } $p4Command .= '-p ' . $this->getPort() . ' ' . $command; return $p4Command; } /** * @return bool */ public function isLoggedIn() { $command = $this->generateP4Command('login -s', false); $exitCode = $this->executeCommand($command); if ($exitCode) { $errorOutput = $this->process->getErrorOutput(); $index = strpos($errorOutput, $this->getUser()); if ($index === false) { $index = strpos($errorOutput, 'p4'); if ($index === false) { return false; } throw new \Exception('p4 command not found in path: ' . $errorOutput); } throw new \Exception('Invalid user name: ' . $this->getUser()); } return true; } /** * @return void */ public function connectClient() { $p4CreateClientCommand = $this->generateP4Command( 'client -i < ' . ProcessExecutor::escape($this->getP4ClientSpec()) ); $this->executeCommand($p4CreateClientCommand); } /** * @param string|null $sourceReference * * @return void */ public function syncCodeBase($sourceReference) { $prevDir = getcwd(); chdir($this->path); $p4SyncCommand = $this->generateP4Command('sync -f '); if (null !== $sourceReference) { $p4SyncCommand .= '@' . $sourceReference; } $this->executeCommand($p4SyncCommand); chdir($prevDir); } /** * @param resource|false $spec * * @return void */ public function writeClientSpecToFile($spec) { fwrite($spec, 'Client: ' . $this->getClient() . PHP_EOL . PHP_EOL); fwrite($spec, 'Update: ' . date('Y/m/d H:i:s') . PHP_EOL . PHP_EOL); fwrite($spec, 'Access: ' . date('Y/m/d H:i:s') . PHP_EOL); fwrite($spec, 'Owner: ' . $this->getUser() . PHP_EOL . PHP_EOL); fwrite($spec, 'Description:' . PHP_EOL); fwrite($spec, ' Created by ' . $this->getUser() . ' from composer.' . PHP_EOL . PHP_EOL); fwrite($spec, 'Root: ' . $this->getPath() . PHP_EOL . PHP_EOL); fwrite($spec, 'Options: noallwrite noclobber nocompress unlocked modtime rmdir' . PHP_EOL . PHP_EOL); fwrite($spec, 'SubmitOptions: revertunchanged' . PHP_EOL . PHP_EOL); fwrite($spec, 'LineEnd: local' . PHP_EOL . PHP_EOL); if ($this->isStream()) { fwrite($spec, 'Stream:' . PHP_EOL); fwrite($spec, ' ' . $this->getStreamWithoutLabel($this->p4Stream) . PHP_EOL); } else { fwrite( $spec, 'View: ' . $this->getStream() . '/... //' . $this->getClient() . '/... ' . PHP_EOL ); } } /** * @return void */ public function writeP4ClientSpec() { $clientSpec = $this->getP4ClientSpec(); $spec = fopen($clientSpec, 'w'); try { $this->writeClientSpecToFile($spec); } catch (\Exception $e) { fclose($spec); throw $e; } fclose($spec); } /** * @param resource $pipe * @param mixed $name * * @return void */ protected function read($pipe, $name) { if (feof($pipe)) { return; } $line = fgets($pipe); while ($line !== false) { $line = fgets($pipe); } } /** * @param string|null $password * * @return int */ public function windowsLogin($password) { $command = $this->generateP4Command(' login -a'); // TODO in v3 generate command as an array if (method_exists('Symfony\Component\Process\Process', 'fromShellCommandline')) { $process = Process::fromShellCommandline($command, null, null, $password); } else { // @phpstan-ignore-next-line $process = new Process($command, null, null, $password); } return $process->run(); } /** * @return void */ public function p4Login() { $this->queryP4User(); if (!$this->isLoggedIn()) { $password = $this->queryP4Password(); if ($this->windowsFlag) { $this->windowsLogin($password); } else { $command = 'echo ' . ProcessExecutor::escape($password) . ' | ' . $this->generateP4Command(' login -a', false); $exitCode = $this->executeCommand($command); if ($exitCode) { throw new \Exception("Error logging in:" . $this->process->getErrorOutput()); } } } } /** * @param string $identifier * * @return mixed|void */ public function getComposerInformation($identifier) { $composerFileContent = $this->getFileContent('composer.json', $identifier); if (!$composerFileContent) { return; } return json_decode($composerFileContent, true); } /** * @param string $file * @param string $identifier * * @return string|null */ public function getFileContent($file, $identifier) { $path = $this->getFilePath($file, $identifier); $command = $this->generateP4Command(' print ' . ProcessExecutor::escape($path)); $this->executeCommand($command); $result = $this->commandResult; if (!trim($result)) { return null; } return $result; } /** * @param string $file * @param string $identifier * * @return string|null */ public function getFilePath($file, $identifier) { $index = strpos($identifier, '@'); if ($index === false) { return $identifier. '/' . $file; } $path = substr($identifier, 0, $index) . '/' . $file . substr($identifier, $index); $command = $this->generateP4Command(' files ' . ProcessExecutor::escape($path), false); $this->executeCommand($command); $result = $this->commandResult; $index2 = strpos($result, 'no such file(s).'); if ($index2 === false) { $index3 = strpos($result, 'change'); if ($index3 !== false) { $phrase = trim(substr($result, $index3)); $fields = explode(' ', $phrase); return substr($identifier, 0, $index) . '/' . $file . '@' . $fields[1]; } } return null; } /** * @return array{master: string} */ public function getBranches() { $possibleBranches = array(); if (!$this->isStream()) { $possibleBranches[$this->p4Branch] = $this->getStream(); } else { $command = $this->generateP4Command('streams '.ProcessExecutor::escape('//' . $this->p4Depot . '/...')); $this->executeCommand($command); $result = $this->commandResult; $resArray = explode(PHP_EOL, $result); foreach ($resArray as $line) { $resBits = explode(' ', $line); if (count($resBits) > 4) { $branch = Preg::replace('/[^A-Za-z0-9 ]/', '', $resBits[4]); $possibleBranches[$branch] = $resBits[1]; } } } $command = $this->generateP4Command('changes '. ProcessExecutor::escape($this->getStream() . '/...'), false); $this->executeCommand($command); $result = $this->commandResult; $resArray = explode(PHP_EOL, $result); $lastCommit = $resArray[0]; $lastCommitArr = explode(' ', $lastCommit); $lastCommitNum = $lastCommitArr[1]; return array('master' => $possibleBranches[$this->p4Branch] . '@'. $lastCommitNum); } /** * @return array */ public function getTags() { $command = $this->generateP4Command('labels'); $this->executeCommand($command); $result = $this->commandResult; $resArray = explode(PHP_EOL, $result); $tags = array(); foreach ($resArray as $line) { if (strpos($line, 'Label') !== false) { $fields = explode(' ', $line); $tags[$fields[1]] = $this->getStream() . '@' . $fields[1]; } } return $tags; } /** * @return bool */ public function checkStream() { $command = $this->generateP4Command('depots', false); $this->executeCommand($command); $result = $this->commandResult; $resArray = explode(PHP_EOL, $result); foreach ($resArray as $line) { if (strpos($line, 'Depot') !== false) { $fields = explode(' ', $line); if (strcmp($this->p4Depot, $fields[1]) === 0) { $this->p4DepotType = $fields[3]; return $this->isStream(); } } } return false; } /** * @param string $reference * @return mixed|null */ protected function getChangeList($reference) { $index = strpos($reference, '@'); if ($index === false) { return null; } $label = substr($reference, $index); $command = $this->generateP4Command(' changes -m1 ' . ProcessExecutor::escape($label)); $this->executeCommand($command); $changes = $this->commandResult; if (strpos($changes, 'Change') !== 0) { return null; } $fields = explode(' ', $changes); return $fields[1]; } /** * @param string $fromReference * @param string $toReference * @return mixed|null */ public function getCommitLogs($fromReference, $toReference) { $fromChangeList = $this->getChangeList($fromReference); if ($fromChangeList === null) { return null; } $toChangeList = $this->getChangeList($toReference); if ($toChangeList === null) { return null; } $index = strpos($fromReference, '@'); $main = substr($fromReference, 0, $index) . '/...'; $command = $this->generateP4Command('filelog ' . ProcessExecutor::escape($main . '@' . $fromChangeList. ',' . $toChangeList)); $this->executeCommand($command); return $this->commandResult; } /** * @return Filesystem */ public function getFilesystem() { if (null === $this->filesystem) { $this->filesystem = new Filesystem($this->process); } return $this->filesystem; } /** * @return void */ public function setFilesystem(Filesystem $fs) { $this->filesystem = $fs; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; /** * Temporarily suppress PHP error reporting, usually warnings and below. * * @author Niels Keurentjes */ class Silencer { /** * @var int[] Unpop stack */ private static $stack = array(); /** * Suppresses given mask or errors. * * @param int|null $mask Error levels to suppress, default value NULL indicates all warnings and below. * @return int The old error reporting level. */ public static function suppress($mask = null) { if (!isset($mask)) { $mask = E_WARNING | E_NOTICE | E_USER_WARNING | E_USER_NOTICE | E_DEPRECATED | E_USER_DEPRECATED | E_STRICT; } $old = error_reporting(); self::$stack[] = $old; error_reporting($old & ~$mask); return $old; } /** * Restores a single state. * * @return void */ public static function restore() { if (!empty(self::$stack)) { error_reporting(array_pop(self::$stack)); } } /** * Calls a specified function while silencing warnings and below. * * Future improvement: when PHP requirements are raised add Callable type hint (5.4) and variadic parameters (5.6) * * @param callable $callable Function to execute. * @throws \Exception Any exceptions from the callback are rethrown. * @return mixed Return value of the callback. */ public static function call($callable /*, ...$parameters */) { try { self::suppress(); $result = call_user_func_array($callable, array_slice(func_get_args(), 1)); self::restore(); return $result; } catch (\Exception $e) { // Use a finally block for this when requirements are raised to PHP 5.5 self::restore(); throw $e; } } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Pcre\Preg; use stdClass; /** * Tests URLs against NO_PROXY patterns */ class NoProxyPattern { /** * @var string[] */ protected $hostNames = array(); /** * @var (null|object)[] */ protected $rules = array(); /** * @var bool */ protected $noproxy; /** * @param string $pattern NO_PROXY pattern */ public function __construct($pattern) { $this->hostNames = Preg::split('{[\s,]+}', $pattern, -1, PREG_SPLIT_NO_EMPTY); $this->noproxy = empty($this->hostNames) || '*' === $this->hostNames[0]; } /** * Returns true if a URL matches the NO_PROXY pattern * * @param string $url * * @return bool */ public function test($url) { if ($this->noproxy) { return true; } if (!$urlData = $this->getUrlData($url)) { return false; } foreach ($this->hostNames as $index => $hostName) { if ($this->match($index, $hostName, $urlData)) { return true; } } return false; } /** * Returns false is the url cannot be parsed, otherwise a data object * * @param string $url * * @return bool|stdClass */ protected function getUrlData($url) { if (!$host = parse_url($url, PHP_URL_HOST)) { return false; } $port = parse_url($url, PHP_URL_PORT); if (empty($port)) { switch (parse_url($url, PHP_URL_SCHEME)) { case 'http': $port = 80; break; case 'https': $port = 443; break; } } $hostName = $host . ($port ? ':' . $port : ''); list($host, $port, $err) = $this->splitHostPort($hostName); if ($err || !$this->ipCheckData($host, $ipdata)) { return false; } return $this->makeData($host, $port, $ipdata); } /** * Returns true if the url is matched by a rule * * @param int $index * @param string $hostName * @param stdClass $url * * @return bool */ protected function match($index, $hostName, $url) { if (!$rule = $this->getRule($index, $hostName)) { // Data must have been misformatted return false; } if ($rule->ipdata) { // Match ipdata first if (!$url->ipdata) { return false; } if ($rule->ipdata->netmask) { return $this->matchRange($rule->ipdata, $url->ipdata); } $match = $rule->ipdata->ip === $url->ipdata->ip; } else { // Match host and port $haystack = substr($url->name, -strlen($rule->name)); $match = stripos($haystack, $rule->name) === 0; } if ($match && $rule->port) { $match = $rule->port === $url->port; } return $match; } /** * Returns true if the target ip is in the network range * * @param stdClass $network * @param stdClass $target * * @return bool */ protected function matchRange(stdClass $network, stdClass $target) { $net = unpack('C*', $network->ip); $mask = unpack('C*', $network->netmask); $ip = unpack('C*', $target->ip); if (false === $net) { throw new \RuntimeException('Could not parse network IP '.$network->ip); } if (false === $mask) { throw new \RuntimeException('Could not parse netmask '.$network->netmask); } if (false === $ip) { throw new \RuntimeException('Could not parse target IP '.$target->ip); } for ($i = 1; $i < 17; ++$i) { if (($net[$i] & $mask[$i]) !== ($ip[$i] & $mask[$i])) { return false; } } return true; } /** * Finds or creates rule data for a hostname * * @param int $index * @param string $hostName * * @return null|stdClass Null if the hostname is invalid */ private function getRule($index, $hostName) { if (array_key_exists($index, $this->rules)) { return $this->rules[$index]; } $this->rules[$index] = null; list($host, $port, $err) = $this->splitHostPort($hostName); if ($err || !$this->ipCheckData($host, $ipdata, true)) { return null; } $this->rules[$index] = $this->makeData($host, $port, $ipdata); return $this->rules[$index]; } /** * Creates an object containing IP data if the host is an IP address * * @param string $host * @param null|stdClass $ipdata Set by method if IP address found * @param bool $allowPrefix Whether a CIDR prefix-length is expected * * @return bool False if the host contains invalid data */ private function ipCheckData($host, &$ipdata, $allowPrefix = false) { $ipdata = null; $netmask = null; $prefix = null; $modified = false; // Check for a CIDR prefix-length if (strpos($host, '/') !== false) { list($host, $prefix) = explode('/', $host); if (!$allowPrefix || !$this->validateInt($prefix, 0, 128)) { return false; } $prefix = (int) $prefix; $modified = true; } // See if this is an ip address if (!filter_var($host, FILTER_VALIDATE_IP)) { return !$modified; } list($ip, $size) = $this->ipGetAddr($host); if ($prefix !== null) { // Check for a valid prefix if ($prefix > $size * 8) { return false; } list($ip, $netmask) = $this->ipGetNetwork($ip, $size, $prefix); } $ipdata = $this->makeIpData($ip, $size, $netmask); return true; } /** * Returns an array of the IP in_addr and its byte size * * IPv4 addresses are always mapped to IPv6, which simplifies handling * and comparison. * * @param string $host * * @return mixed[] in_addr, size */ private function ipGetAddr($host) { $ip = inet_pton($host); $size = strlen($ip); $mapped = $this->ipMapTo6($ip, $size); return array($mapped, $size); } /** * Returns the binary network mask mapped to IPv6 * * @param int $prefix CIDR prefix-length * @param int $size Byte size of in_addr * * @return string */ private function ipGetMask($prefix, $size) { $mask = ''; if ($ones = floor($prefix / 8)) { $mask = str_repeat(chr(255), (int) $ones); } if ($remainder = $prefix % 8) { $mask .= chr(0xff ^ (0xff >> $remainder)); } $mask = str_pad($mask, $size, chr(0)); return $this->ipMapTo6($mask, $size); } /** * Calculates and returns the network and mask * * @param string $rangeIp IP in_addr * @param int $size Byte size of in_addr * @param int $prefix CIDR prefix-length * * @return string[] network in_addr, binary mask */ private function ipGetNetwork($rangeIp, $size, $prefix) { $netmask = $this->ipGetMask($prefix, $size); // Get the network from the address and mask $mask = unpack('C*', $netmask); $ip = unpack('C*', $rangeIp); $net = ''; if (false === $mask) { throw new \RuntimeException('Could not parse netmask '.$netmask); } if (false === $ip) { throw new \RuntimeException('Could not parse range IP '.$rangeIp); } for ($i = 1; $i < 17; ++$i) { $net .= chr($ip[$i] & $mask[$i]); } return array($net, $netmask); } /** * Maps an IPv4 address to IPv6 * * @param string $binary in_addr * @param int $size Byte size of in_addr * * @return string Mapped or existing in_addr */ private function ipMapTo6($binary, $size) { if ($size === 4) { $prefix = str_repeat(chr(0), 10) . str_repeat(chr(255), 2); $binary = $prefix . $binary; } return $binary; } /** * Creates a rule data object * * @param string $host * @param int $port * @param null|stdClass $ipdata * * @return stdClass */ private function makeData($host, $port, $ipdata) { return (object) array( 'host' => $host, 'name' => '.' . ltrim($host, '.'), 'port' => $port, 'ipdata' => $ipdata, ); } /** * Creates an ip data object * * @param string $ip in_addr * @param int $size Byte size of in_addr * @param null|string $netmask Network mask * * @return stdClass */ private function makeIpData($ip, $size, $netmask) { return (object) array( 'ip' => $ip, 'size' => $size, 'netmask' => $netmask, ); } /** * Splits the hostname into host and port components * * @param string $hostName * * @return mixed[] host, port, if there was error */ private function splitHostPort($hostName) { // host, port, err $error = array('', '', true); $port = 0; $ip6 = ''; // Check for square-bracket notation if ($hostName[0] === '[') { $index = strpos($hostName, ']'); // The smallest ip6 address is :: if (false === $index || $index < 3) { return $error; } $ip6 = substr($hostName, 1, $index - 1); $hostName = substr($hostName, $index + 1); if (strpbrk($hostName, '[]') !== false || substr_count($hostName, ':') > 1) { return $error; } } if (substr_count($hostName, ':') === 1) { $index = strpos($hostName, ':'); $port = substr($hostName, $index + 1); $hostName = substr($hostName, 0, $index); if (!$this->validateInt($port, 1, 65535)) { return $error; } $port = (int) $port; } $host = $ip6 . $hostName; return array($host, $port, false); } /** * Wrapper around filter_var FILTER_VALIDATE_INT * * @param string $int * @param int $min * @param int $max * * @return bool */ private function validateInt($int, $min, $max) { $options = array( 'options' => array( 'min_range' => $min, 'max_range' => $max, ), ); return false !== filter_var($int, FILTER_VALIDATE_INT, $options); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util\Http; use Composer\Config; use Composer\Downloader\MaxFileSizeExceededException; use Composer\IO\IOInterface; use Composer\Downloader\TransportException; use Composer\Pcre\Preg; use Composer\Util\StreamContextFactory; use Composer\Util\AuthHelper; use Composer\Util\Url; use Composer\Util\HttpDownloader; use React\Promise\Promise; /** * @internal * @author Jordi Boggiano * @author Nicolas Grekas * @phpstan-type Attributes array{retryAuthFailure: bool, redirects: int, retries: int, storeAuth: bool} * @phpstan-type Job array{url: string, origin: string, attributes: Attributes, options: mixed[], progress: mixed[], curlHandle: resource, filename: string|false, headerHandle: resource, bodyHandle: resource, resolve: callable, reject: callable} */ class CurlDownloader { /** @var ?resource */ private $multiHandle; /** @var ?resource */ private $shareHandle; /** @var Job[] */ private $jobs = array(); /** @var IOInterface */ private $io; /** @var Config */ private $config; /** @var AuthHelper */ private $authHelper; /** @var float */ private $selectTimeout = 5.0; /** @var int */ private $maxRedirects = 20; /** @var int */ private $maxRetries = 3; /** @var ProxyManager */ private $proxyManager; /** @var bool */ private $supportsSecureProxy; /** @var array */ protected $multiErrors = array( CURLM_BAD_HANDLE => array('CURLM_BAD_HANDLE', 'The passed-in handle is not a valid CURLM handle.'), CURLM_BAD_EASY_HANDLE => array('CURLM_BAD_EASY_HANDLE', "An easy handle was not good/valid. It could mean that it isn't an easy handle at all, or possibly that the handle already is in used by this or another multi handle."), CURLM_OUT_OF_MEMORY => array('CURLM_OUT_OF_MEMORY', 'You are doomed.'), CURLM_INTERNAL_ERROR => array('CURLM_INTERNAL_ERROR', 'This can only be returned if libcurl bugs. Please report it to us!'), ); /** @var mixed[] */ private static $options = array( 'http' => array( 'method' => CURLOPT_CUSTOMREQUEST, 'content' => CURLOPT_POSTFIELDS, 'header' => CURLOPT_HTTPHEADER, 'timeout' => CURLOPT_TIMEOUT, ), 'ssl' => array( 'cafile' => CURLOPT_CAINFO, 'capath' => CURLOPT_CAPATH, 'verify_peer' => CURLOPT_SSL_VERIFYPEER, 'verify_peer_name' => CURLOPT_SSL_VERIFYHOST, 'local_cert' => CURLOPT_SSLCERT, 'local_pk' => CURLOPT_SSLKEY, 'passphrase' => CURLOPT_SSLKEYPASSWD, ), ); /** @var array */ private static $timeInfo = array( 'total_time' => true, 'namelookup_time' => true, 'connect_time' => true, 'pretransfer_time' => true, 'starttransfer_time' => true, 'redirect_time' => true, ); /** * @param mixed[] $options * @param bool $disableTls */ public function __construct(IOInterface $io, Config $config, array $options = array(), $disableTls = false) { $this->io = $io; $this->config = $config; $this->multiHandle = $mh = curl_multi_init(); if (function_exists('curl_multi_setopt')) { curl_multi_setopt($mh, CURLMOPT_PIPELINING, PHP_VERSION_ID >= 70400 ? /* CURLPIPE_MULTIPLEX */ 2 : /*CURLPIPE_HTTP1 | CURLPIPE_MULTIPLEX*/ 3); if (defined('CURLMOPT_MAX_HOST_CONNECTIONS') && !defined('HHVM_VERSION')) { curl_multi_setopt($mh, CURLMOPT_MAX_HOST_CONNECTIONS, 8); } } if (function_exists('curl_share_init')) { $this->shareHandle = $sh = curl_share_init(); curl_share_setopt($sh, CURLSHOPT_SHARE, CURL_LOCK_DATA_COOKIE); curl_share_setopt($sh, CURLSHOPT_SHARE, CURL_LOCK_DATA_DNS); curl_share_setopt($sh, CURLSHOPT_SHARE, CURL_LOCK_DATA_SSL_SESSION); } $this->authHelper = new AuthHelper($io, $config); $this->proxyManager = ProxyManager::getInstance(); $version = curl_version(); $features = $version['features']; $this->supportsSecureProxy = defined('CURL_VERSION_HTTPS_PROXY') && ($features & CURL_VERSION_HTTPS_PROXY); } /** * @param callable $resolve * @param callable $reject * @param string $origin * @param string $url * @param mixed[] $options * @param ?string $copyTo * * @return int internal job id */ public function download($resolve, $reject, $origin, $url, $options, $copyTo = null) { $attributes = array(); if (isset($options['retry-auth-failure'])) { $attributes['retryAuthFailure'] = $options['retry-auth-failure']; unset($options['retry-auth-failure']); } return $this->initDownload($resolve, $reject, $origin, $url, $options, $copyTo, $attributes); } /** * @param callable $resolve * @param callable $reject * @param string $origin * @param string $url * @param mixed[] $options * @param ?string $copyTo * * @param array{retryAuthFailure?: bool, redirects?: int, retries?: int, storeAuth?: bool} $attributes * * @return int internal job id */ private function initDownload($resolve, $reject, $origin, $url, $options, $copyTo = null, array $attributes = array()) { $attributes = array_merge(array( 'retryAuthFailure' => true, 'redirects' => 0, 'retries' => 0, 'storeAuth' => false, ), $attributes); $originalOptions = $options; // check URL can be accessed (i.e. is not insecure), but allow insecure Packagist calls to $hashed providers as file integrity is verified with sha256 if (!Preg::isMatch('{^http://(repo\.)?packagist\.org/p/}', $url) || (false === strpos($url, '$') && false === strpos($url, '%24'))) { $this->config->prohibitUrlByConfig($url, $this->io); } $curlHandle = curl_init(); $headerHandle = fopen('php://temp/maxmemory:32768', 'w+b'); if (false === $headerHandle) { throw new \RuntimeException('Failed to open a temp stream to store curl headers'); } if ($copyTo) { $errorMessage = ''; // @phpstan-ignore-next-line set_error_handler(function ($code, $msg) use (&$errorMessage) { if ($errorMessage) { $errorMessage .= "\n"; } $errorMessage .= Preg::replace('{^fopen$.*?$: }', '', $msg); }); $bodyHandle = fopen($copyTo.'~', 'w+b'); restore_error_handler(); if (!$bodyHandle) { throw new TransportException('The "'.$url.'" file could not be written to '.$copyTo.': '.$errorMessage); } } else { $bodyHandle = @fopen('php://temp/maxmemory:524288', 'w+b'); } curl_setopt($curlHandle, CURLOPT_URL, $url); curl_setopt($curlHandle, CURLOPT_FOLLOWLOCATION, false); curl_setopt($curlHandle, CURLOPT_CONNECTTIMEOUT, 10); curl_setopt($curlHandle, CURLOPT_TIMEOUT, max((int) ini_get("default_socket_timeout"), 300)); curl_setopt($curlHandle, CURLOPT_WRITEHEADER, $headerHandle); curl_setopt($curlHandle, CURLOPT_FILE, $bodyHandle); curl_setopt($curlHandle, CURLOPT_ENCODING, ""); // let cURL set the Accept-Encoding header to what it supports curl_setopt($curlHandle, CURLOPT_PROTOCOLS, CURLPROTO_HTTP | CURLPROTO_HTTPS); if (function_exists('curl_share_init')) { curl_setopt($curlHandle, CURLOPT_SHARE, $this->shareHandle); } if (!isset($options['http']['header'])) { $options['http']['header'] = array(); } $options['http']['header'] = array_diff($options['http']['header'], array('Connection: close')); $options['http']['header'][] = 'Connection: keep-alive'; $version = curl_version(); $features = $version['features']; if (0 === strpos($url, 'https://') && \defined('CURL_VERSION_HTTP2') && \defined('CURL_HTTP_VERSION_2_0') && (CURL_VERSION_HTTP2 & $features)) { curl_setopt($curlHandle, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_2_0); } $options['http']['header'] = $this->authHelper->addAuthenticationHeader($options['http']['header'], $origin, $url); $options = StreamContextFactory::initOptions($url, $options, true); foreach (self::$options as $type => $curlOptions) { foreach ($curlOptions as $name => $curlOption) { if (isset($options[$type][$name])) { if ($type === 'ssl' && $name === 'verify_peer_name') { curl_setopt($curlHandle, $curlOption, $options[$type][$name] === true ? 2 : $options[$type][$name]); } else { curl_setopt($curlHandle, $curlOption, $options[$type][$name]); } } } } // Always set CURLOPT_PROXY to enable/disable proxy handling // Any proxy authorization is included in the proxy url $proxy = $this->proxyManager->getProxyForRequest($url); curl_setopt($curlHandle, CURLOPT_PROXY, $proxy->getUrl()); // Curl needs certificate locations for secure proxies. // CURLOPT_PROXY_SSL_VERIFY_PEER/HOST are enabled by default if ($proxy->isSecure()) { if (!$this->supportsSecureProxy) { throw new TransportException('Connecting to a secure proxy using curl is not supported on PHP versions below 7.3.0.'); } if (!empty($options['ssl']['cafile'])) { curl_setopt($curlHandle, CURLOPT_PROXY_CAINFO, $options['ssl']['cafile']); } if (!empty($options['ssl']['capath'])) { curl_setopt($curlHandle, CURLOPT_PROXY_CAPATH, $options['ssl']['capath']); } } $progress = array_diff_key(curl_getinfo($curlHandle), self::$timeInfo); $this->jobs[(int) $curlHandle] = array( 'url' => $url, 'origin' => $origin, 'attributes' => $attributes, 'options' => $originalOptions, 'progress' => $progress, 'curlHandle' => $curlHandle, 'filename' => $copyTo, 'headerHandle' => $headerHandle, 'bodyHandle' => $bodyHandle, 'resolve' => $resolve, 'reject' => $reject, ); $usingProxy = $proxy->getFormattedUrl(' using proxy (%s)'); $ifModified = false !== stripos(implode(',', $options['http']['header']), 'if-modified-since:') ? ' if modified' : ''; if ($attributes['redirects'] === 0 && $attributes['retries'] === 0) { $this->io->writeError('Downloading ' . Url::sanitize($url) . $usingProxy . $ifModified, true, IOInterface::DEBUG); } $this->checkCurlResult(curl_multi_add_handle($this->multiHandle, $curlHandle)); // TODO progress return (int) $curlHandle; } /** * @param int $id * @return void */ public function abortRequest($id) { if (isset($this->jobs[$id], $this->jobs[$id]['curlHandle'])) { $job = $this->jobs[$id]; curl_multi_remove_handle($this->multiHandle, $job['curlHandle']); curl_close($job['curlHandle']); if (is_resource($job['headerHandle'])) { fclose($job['headerHandle']); } if (is_resource($job['bodyHandle'])) { fclose($job['bodyHandle']); } if ($job['filename']) { @unlink($job['filename'].'~'); } unset($this->jobs[$id]); } } /** * @return void */ public function tick() { static $timeoutWarning = false; if (!$this->jobs) { return; } $active = true; $this->checkCurlResult(curl_multi_exec($this->multiHandle, $active)); if (-1 === curl_multi_select($this->multiHandle, $this->selectTimeout)) { // sleep in case select returns -1 as it can happen on old php versions or some platforms where curl does not manage to do the select usleep(150); } while ($progress = curl_multi_info_read($this->multiHandle)) { $curlHandle = $progress['handle']; $result = $progress['result']; $i = (int) $curlHandle; if (!isset($this->jobs[$i])) { continue; } $progress = curl_getinfo($curlHandle); $job = $this->jobs[$i]; unset($this->jobs[$i]); $error = curl_error($curlHandle); $errno = curl_errno($curlHandle); curl_multi_remove_handle($this->multiHandle, $curlHandle); curl_close($curlHandle); $headers = null; $statusCode = null; $response = null; try { // TODO progress if (CURLE_OK !== $errno || $error || $result !== CURLE_OK) { $errno = $errno ?: $result; if (!$error && function_exists('curl_strerror')) { $error = curl_strerror($errno); } $progress['error_code'] = $errno; if ( (!isset($job['options']['http']['method']) || $job['options']['http']['method'] === 'GET') && ( in_array($errno, array(7 /* CURLE_COULDNT_CONNECT */, 16 /* CURLE_HTTP2 */, 92 /* CURLE_HTTP2_STREAM */, 6 /* CURLE_COULDNT_RESOLVE_HOST */), true) || ($errno === 35 /* CURLE_SSL_CONNECT_ERROR */ && false !== strpos($error, 'Connection reset by peer')) ) && $job['attributes']['retries'] < $this->maxRetries ) { $this->io->writeError('Retrying ('.($job['attributes']['retries'] + 1).') ' . Url::sanitize($job['url']) . ' due to curl error '. $errno, true, IOInterface::DEBUG); $this->restartJob($job, $job['url'], array('retries' => $job['attributes']['retries'] + 1)); continue; } if ($errno === 28 /* CURLE_OPERATION_TIMEDOUT */ && isset($progress['namelookup_time']) && $progress['namelookup_time'] == 0 && !$timeoutWarning) { $timeoutWarning = true; $this->io->writeError('A connection timeout was encountered. If you intend to run Composer without connecting to the internet, run the command again prefixed with COMPOSER_DISABLE_NETWORK=1 to make Composer run in offline mode.'); } throw new TransportException('curl error '.$errno.' while downloading '.Url::sanitize($progress['url']).': '.$error); } $statusCode = $progress['http_code']; rewind($job['headerHandle']); $headers = explode("\r\n", rtrim(stream_get_contents($job['headerHandle']))); fclose($job['headerHandle']); if ($statusCode === 0) { throw new \LogicException('Received unexpected http status code 0 without error for '.Url::sanitize($progress['url']).': headers '.var_export($headers, true).' curl info '.var_export($progress, true)); } // prepare response object if ($job['filename']) { $contents = $job['filename'].'~'; if ($statusCode >= 300) { rewind($job['bodyHandle']); $contents = stream_get_contents($job['bodyHandle']); } $response = new CurlResponse(array('url' => $progress['url']), $statusCode, $headers, $contents, $progress); $this->io->writeError('['.$statusCode.'] '.Url::sanitize($progress['url']), true, IOInterface::DEBUG); } else { rewind($job['bodyHandle']); $contents = stream_get_contents($job['bodyHandle']); $response = new CurlResponse(array('url' => $progress['url']), $statusCode, $headers, $contents, $progress); $this->io->writeError('['.$statusCode.'] '.Url::sanitize($progress['url']), true, IOInterface::DEBUG); } fclose($job['bodyHandle']); if ($response->getStatusCode() >= 400 && $response->getHeader('content-type') === 'application/json') { HttpDownloader::outputWarnings($this->io, $job['origin'], json_decode($response->getBody(), true)); } $result = $this->isAuthenticatedRetryNeeded($job, $response); if ($result['retry']) { $this->restartJob($job, $job['url'], array('storeAuth' => $result['storeAuth'])); continue; } // handle 3xx redirects, 304 Not Modified is excluded if ($statusCode >= 300 && $statusCode <= 399 && $statusCode !== 304 && $job['attributes']['redirects'] < $this->maxRedirects) { $location = $this->handleRedirect($job, $response); if ($location) { $this->restartJob($job, $location, array('redirects' => $job['attributes']['redirects'] + 1)); continue; } } // fail 4xx and 5xx responses and capture the response if ($statusCode >= 400 && $statusCode <= 599) { if ( (!isset($job['options']['http']['method']) || $job['options']['http']['method'] === 'GET') && in_array($statusCode, array(423, 425, 500, 502, 503, 504, 507, 510), true) && $job['attributes']['retries'] < $this->maxRetries ) { $this->io->writeError('Retrying ('.($job['attributes']['retries'] + 1).') ' . Url::sanitize($job['url']) . ' due to status code '. $statusCode, true, IOInterface::DEBUG); $this->restartJob($job, $job['url'], array('retries' => $job['attributes']['retries'] + 1)); continue; } throw $this->failResponse($job, $response, $response->getStatusMessage()); } if ($job['attributes']['storeAuth']) { $this->authHelper->storeAuth($job['origin'], $job['attributes']['storeAuth']); } // resolve promise if ($job['filename']) { rename($job['filename'].'~', $job['filename']); call_user_func($job['resolve'], $response); } else { call_user_func($job['resolve'], $response); } } catch (\Exception $e) { if ($e instanceof TransportException && $headers) { $e->setHeaders($headers); $e->setStatusCode($statusCode); } if ($e instanceof TransportException && $response) { $e->setResponse($response->getBody()); } if ($e instanceof TransportException && $progress) { $e->setResponseInfo($progress); } $this->rejectJob($job, $e); } } foreach ($this->jobs as $i => $curlHandle) { if (!isset($this->jobs[$i])) { continue; } $curlHandle = $this->jobs[$i]['curlHandle']; $progress = array_diff_key(curl_getinfo($curlHandle), self::$timeInfo); if ($this->jobs[$i]['progress'] !== $progress) { $this->jobs[$i]['progress'] = $progress; if (isset($this->jobs[$i]['options']['max_file_size'])) { // Compare max_file_size with the content-length header this value will be -1 until the header is parsed if ($this->jobs[$i]['options']['max_file_size'] < $progress['download_content_length']) { $this->rejectJob($this->jobs[$i], new MaxFileSizeExceededException('Maximum allowed download size reached. Content-length header indicates ' . $progress['download_content_length'] . ' bytes. Allowed ' . $this->jobs[$i]['options']['max_file_size'] . ' bytes')); } // Compare max_file_size with the download size in bytes if ($this->jobs[$i]['options']['max_file_size'] < $progress['size_download']) { $this->rejectJob($this->jobs[$i], new MaxFileSizeExceededException('Maximum allowed download size reached. Downloaded ' . $progress['size_download'] . ' of allowed ' . $this->jobs[$i]['options']['max_file_size'] . ' bytes')); } } // TODO progress } } } /** * @param Job $job * @return string */ private function handleRedirect(array $job, Response $response) { if ($locationHeader = $response->getHeader('location')) { if (parse_url($locationHeader, PHP_URL_SCHEME)) { // Absolute URL; e.g. https://example.com/composer $targetUrl = $locationHeader; } elseif (parse_url($locationHeader, PHP_URL_HOST)) { // Scheme relative; e.g. //example.com/foo $targetUrl = parse_url($job['url'], PHP_URL_SCHEME).':'.$locationHeader; } elseif ('/' === $locationHeader[0]) { // Absolute path; e.g. /foo $urlHost = parse_url($job['url'], PHP_URL_HOST); // Replace path using hostname as an anchor. $targetUrl = Preg::replace('{^(.+(?://|@)'.preg_quote($urlHost).'(?::\d+)?)(?:[/\?].*)?$}', '\1'.$locationHeader, $job['url']); } else { // Relative path; e.g. foo // This actually differs from PHP which seems to add duplicate slashes. $targetUrl = Preg::replace('{^(.+/)[^/?]*(?:\?.*)?$}', '\1'.$locationHeader, $job['url']); } } if (!empty($targetUrl)) { $this->io->writeError(sprintf('Following redirect (%u) %s', $job['attributes']['redirects'] + 1, Url::sanitize($targetUrl)), true, IOInterface::DEBUG); return $targetUrl; } throw new TransportException('The "'.$job['url'].'" file could not be downloaded, got redirect without Location ('.$response->getStatusMessage().')'); } /** * @param Job $job * @return array{retry: bool, storeAuth: string|bool} */ private function isAuthenticatedRetryNeeded(array $job, Response $response) { if (in_array($response->getStatusCode(), array(401, 403)) && $job['attributes']['retryAuthFailure']) { $result = $this->authHelper->promptAuthIfNeeded($job['url'], $job['origin'], $response->getStatusCode(), $response->getStatusMessage(), $response->getHeaders(), $job['attributes']['retries']); if ($result['retry']) { return $result; } } $locationHeader = $response->getHeader('location'); $needsAuthRetry = false; // check for bitbucket login page asking to authenticate if ( $job['origin'] === 'bitbucket.org' && !$this->authHelper->isPublicBitBucketDownload($job['url']) && substr($job['url'], -4) === '.zip' && (!$locationHeader || substr($locationHeader, -4) !== '.zip') && Preg::isMatch('{^text/html\b}i', $response->getHeader('content-type')) ) { $needsAuthRetry = 'Bitbucket requires authentication and it was not provided'; } // check for gitlab 404 when downloading archives if ( $response->getStatusCode() === 404 && in_array($job['origin'], $this->config->get('gitlab-domains'), true) && false !== strpos($job['url'], 'archive.zip') ) { $needsAuthRetry = 'GitLab requires authentication and it was not provided'; } if ($needsAuthRetry) { if ($job['attributes']['retryAuthFailure']) { $result = $this->authHelper->promptAuthIfNeeded($job['url'], $job['origin'], 401, null, array(), $job['attributes']['retries']); if ($result['retry']) { return $result; } } throw $this->failResponse($job, $response, $needsAuthRetry); } return array('retry' => false, 'storeAuth' => false); } /** * @param Job $job * @param string $url * * @param array{retryAuthFailure?: bool, redirects?: int, storeAuth?: bool} $attributes * * @return void */ private function restartJob(array $job, $url, array $attributes = array()) { if ($job['filename']) { @unlink($job['filename'].'~'); } $attributes = array_merge($job['attributes'], $attributes); $origin = Url::getOrigin($this->config, $url); $this->initDownload($job['resolve'], $job['reject'], $origin, $url, $job['options'], $job['filename'], $attributes); } /** * @param Job $job * @param string $errorMessage * @return TransportException */ private function failResponse(array $job, Response $response, $errorMessage) { if ($job['filename']) { @unlink($job['filename'].'~'); } $details = ''; if (in_array(strtolower($response->getHeader('content-type')), array('application/json', 'application/json; charset=utf-8'), true)) { $details = ':'.PHP_EOL.substr($response->getBody(), 0, 200).(strlen($response->getBody()) > 200 ? '...' : ''); } return new TransportException('The "'.$job['url'].'" file could not be downloaded ('.$errorMessage.')' . $details, $response->getStatusCode()); } /** * @param Job $job * @return void */ private function rejectJob(array $job, \Exception $e) { if (is_resource($job['headerHandle'])) { fclose($job['headerHandle']); } if (is_resource($job['bodyHandle'])) { fclose($job['bodyHandle']); } if ($job['filename']) { @unlink($job['filename'].'~'); } call_user_func($job['reject'], $e); } /** * @param int $code * @return void */ private function checkCurlResult($code) { if ($code != CURLM_OK && $code != CURLM_CALL_MULTI_PERFORM) { throw new \RuntimeException( isset($this->multiErrors[$code]) ? "cURL error: {$code} ({$this->multiErrors[$code][0]}): cURL message: {$this->multiErrors[$code][1]}" : 'Unexpected cURL error: ' . $code ); } } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util\Http; use Composer\Json\JsonFile; use Composer\Pcre\Preg; use Composer\Util\HttpDownloader; /** * @phpstan-import-type Request from HttpDownloader */ class Response { /** @var Request */ private $request; /** @var int */ private $code; /** @var string[] */ private $headers; /** @var ?string */ private $body; /** * @param Request $request * @param int $code * @param string[] $headers * @param ?string $body */ public function __construct(array $request, $code, array $headers, $body) { if (!isset($request['url'])) { // @phpstan-ignore-line throw new \LogicException('url key missing from request array'); } $this->request = $request; $this->code = (int) $code; $this->headers = $headers; $this->body = $body; } /** * @return int */ public function getStatusCode() { return $this->code; } /** * @return string|null */ public function getStatusMessage() { $value = null; foreach ($this->headers as $header) { if (Preg::isMatch('{^HTTP/\S+ \d+}i', $header)) { // In case of redirects, headers contain the headers of all responses // so we can not return directly and need to keep iterating $value = $header; } } return $value; } /** * @return string[] */ public function getHeaders() { return $this->headers; } /** * @param string $name * @return ?string */ public function getHeader($name) { return self::findHeaderValue($this->headers, $name); } /** * @return ?string */ public function getBody() { return $this->body; } /** * @return mixed */ public function decodeJson() { return JsonFile::parseJson($this->body, $this->request['url']); } /** * @return void * @phpstan-impure */ public function collect() { /** @phpstan-ignore-next-line */ $this->request = $this->code = $this->headers = $this->body = null; } /** * @param string[] $headers array of returned headers like from getLastHeaders() * @param string $name header name (case insensitive) * @return string|null */ public static function findHeaderValue(array $headers, $name) { $value = null; foreach ($headers as $header) { if (Preg::isMatch('{^'.preg_quote($name).':\s*(.+?)\s*$}i', $header, $match)) { $value = $match[1]; } } return $value; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util\Http; /** * Proxy discovery and helper class * * @internal * @author John Stevenson */ class ProxyHelper { /** * Returns proxy environment values * * @return array{string|null, string|null, string|null} httpProxy, httpsProxy, noProxy values * * @throws \RuntimeException on malformed url */ public static function getProxyData() { $httpProxy = null; $httpsProxy = null; // Handle http_proxy/HTTP_PROXY on CLI only for security reasons if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') { if ($env = self::getProxyEnv(array('http_proxy', 'HTTP_PROXY'), $name)) { $httpProxy = self::checkProxy($env, $name); } } // Prefer CGI_HTTP_PROXY if available if ($env = self::getProxyEnv(array('CGI_HTTP_PROXY'), $name)) { $httpProxy = self::checkProxy($env, $name); } // Handle https_proxy/HTTPS_PROXY if ($env = self::getProxyEnv(array('https_proxy', 'HTTPS_PROXY'), $name)) { $httpsProxy = self::checkProxy($env, $name); } else { $httpsProxy = $httpProxy; } // Handle no_proxy $noProxy = self::getProxyEnv(array('no_proxy', 'NO_PROXY'), $name); return array($httpProxy, $httpsProxy, $noProxy); } /** * Returns http context options for the proxy url * * @param string $proxyUrl * * @return array{http: array{proxy: string, header?: string}} */ public static function getContextOptions($proxyUrl) { $proxy = parse_url($proxyUrl); // Remove any authorization $proxyUrl = self::formatParsedUrl($proxy, false); $proxyUrl = str_replace(array('http://', 'https://'), array('tcp://', 'ssl://'), $proxyUrl); $options['http']['proxy'] = $proxyUrl; // Handle any authorization if (isset($proxy['user'])) { $auth = rawurldecode($proxy['user']); if (isset($proxy['pass'])) { $auth .= ':' . rawurldecode($proxy['pass']); } $auth = base64_encode($auth); // Set header as a string $options['http']['header'] = "Proxy-Authorization: Basic {$auth}"; } return $options; } /** * Sets/unsets request_fulluri value in http context options array * * @param string $requestUrl * @param mixed[] $options Set by method * * @return void */ public static function setRequestFullUri($requestUrl, array &$options) { if ('http' === parse_url($requestUrl, PHP_URL_SCHEME)) { $options['http']['request_fulluri'] = true; } else { unset($options['http']['request_fulluri']); } } /** * Searches $_SERVER for case-sensitive values * * @param string[] $names Names to search for * @param string|null $name Name of any found value * * @return string|null The found value */ private static function getProxyEnv(array $names, &$name) { foreach ($names as $name) { if (!empty($_SERVER[$name])) { return $_SERVER[$name]; } } return null; } /** * Checks and formats a proxy url from the environment * * @param string $proxyUrl * @param string $envName * @throws \RuntimeException on malformed url * @return string The formatted proxy url */ private static function checkProxy($proxyUrl, $envName) { $error = sprintf('malformed %s url', $envName); $proxy = parse_url($proxyUrl); // We need parse_url to have identified a host if (!isset($proxy['host'])) { throw new \RuntimeException($error); } $proxyUrl = self::formatParsedUrl($proxy, true); // We need a port because streams and curl use different defaults if (!parse_url($proxyUrl, PHP_URL_PORT)) { throw new \RuntimeException($error); } return $proxyUrl; } /** * Formats a url from its component parts * * @param array{scheme?: string, host: string, port?: int, user?: string, pass?: string} $proxy * @param bool $includeAuth * * @return string The formatted value */ private static function formatParsedUrl(array $proxy, $includeAuth) { $proxyUrl = isset($proxy['scheme']) ? strtolower($proxy['scheme']) . '://' : ''; if ($includeAuth && isset($proxy['user'])) { $proxyUrl .= $proxy['user']; if (isset($proxy['pass'])) { $proxyUrl .= ':' . $proxy['pass']; } $proxyUrl .= '@'; } $proxyUrl .= $proxy['host']; if (isset($proxy['port'])) { $proxyUrl .= ':' . $proxy['port']; } elseif (strpos($proxyUrl, 'http://') === 0) { $proxyUrl .= ':80'; } elseif (strpos($proxyUrl, 'https://') === 0) { $proxyUrl .= ':443'; } return $proxyUrl; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util\Http; use Composer\Util\Url; /** * @internal * @author John Stevenson */ class RequestProxy { /** @var mixed[] */ private $contextOptions; /** @var bool */ private $isSecure; /** @var string */ private $formattedUrl; /** @var string */ private $url; /** * @param string $url * @param mixed[] $contextOptions * @param string $formattedUrl */ public function __construct($url, array $contextOptions, $formattedUrl) { $this->url = $url; $this->contextOptions = $contextOptions; $this->formattedUrl = $formattedUrl; $this->isSecure = 0 === strpos($url, 'https://'); } /** * Returns an array of context options * * @return mixed[] */ public function getContextOptions() { return $this->contextOptions; } /** * Returns the safe proxy url from the last request * * @param string|null $format Output format specifier * @return string Safe proxy, no proxy or empty */ public function getFormattedUrl($format = '') { $result = ''; if ($this->formattedUrl) { $format = $format ?: '%s'; $result = sprintf($format, $this->formattedUrl); } return $result; } /** * Returns the proxy url * * @return string Proxy url or empty */ public function getUrl() { return $this->url; } /** * Returns true if this is a secure-proxy * * @return bool False if not secure or there is no proxy */ public function isSecure() { return $this->isSecure; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util\Http; use Composer\Downloader\TransportException; use Composer\Util\NoProxyPattern; use Composer\Util\Url; /** * @internal * @author John Stevenson */ class ProxyManager { /** @var ?string */ private $error = null; /** @var array{http: ?string, https: ?string} */ private $fullProxy; /** @var array{http: ?string, https: ?string} */ private $safeProxy; /** @var array{http: array{options: mixed[]|null}, https: array{options: mixed[]|null}} */ private $streams; /** @var bool */ private $hasProxy; /** @var ?string */ private $info = null; /** @var ?NoProxyPattern */ private $noProxyHandler = null; /** @var ?ProxyManager */ private static $instance = null; private function __construct() { $this->fullProxy = $this->safeProxy = array( 'http' => null, 'https' => null, ); $this->streams['http'] = $this->streams['https'] = array( 'options' => null, ); $this->hasProxy = false; $this->initProxyData(); } /** * @return ProxyManager */ public static function getInstance() { if (!self::$instance) { self::$instance = new self(); } return self::$instance; } /** * Clears the persistent instance * * @return void */ public static function reset() { self::$instance = null; } /** * Returns a RequestProxy instance for the request url * * @param string $requestUrl * @return RequestProxy */ public function getProxyForRequest($requestUrl) { if ($this->error) { throw new TransportException('Unable to use a proxy: '.$this->error); } $scheme = parse_url($requestUrl, PHP_URL_SCHEME) ?: 'http'; $proxyUrl = ''; $options = array(); $formattedProxyUrl = ''; if ($this->hasProxy && in_array($scheme, array('http', 'https'), true) && $this->fullProxy[$scheme]) { if ($this->noProxy($requestUrl)) { $formattedProxyUrl = 'excluded by no_proxy'; } else { $proxyUrl = $this->fullProxy[$scheme]; $options = $this->streams[$scheme]['options']; ProxyHelper::setRequestFullUri($requestUrl, $options); $formattedProxyUrl = $this->safeProxy[$scheme]; } } return new RequestProxy($proxyUrl, $options, $formattedProxyUrl); } /** * Returns true if a proxy is being used * * @return bool If false any error will be in $message */ public function isProxying() { return $this->hasProxy; } /** * Returns proxy configuration info which can be shown to the user * * @return string|null Safe proxy URL or an error message if setting up proxy failed or null if no proxy was configured */ public function getFormattedProxy() { return $this->hasProxy ? $this->info : $this->error; } /** * Initializes proxy values from the environment * * @return void */ private function initProxyData() { try { list($httpProxy, $httpsProxy, $noProxy) = ProxyHelper::getProxyData(); } catch (\RuntimeException $e) { $this->error = $e->getMessage(); return; } $info = array(); if ($httpProxy) { $info[] = $this->setData($httpProxy, 'http'); } if ($httpsProxy) { $info[] = $this->setData($httpsProxy, 'https'); } if ($this->hasProxy) { $this->info = implode(', ', $info); if ($noProxy) { $this->noProxyHandler = new NoProxyPattern($noProxy); } } } /** * Sets initial data * * @param non-empty-string $url Proxy url * @param 'http'|'https' $scheme Environment variable scheme * * @return non-empty-string */ private function setData($url, $scheme) { $safeProxy = Url::sanitize($url); $this->fullProxy[$scheme] = $url; $this->safeProxy[$scheme] = $safeProxy; $this->streams[$scheme]['options'] = ProxyHelper::getContextOptions($url); $this->hasProxy = true; return sprintf('%s=%s', $scheme, $safeProxy); } /** * Returns true if a url matches no_proxy value * * @param string $requestUrl * @return bool */ private function noProxy($requestUrl) { return $this->noProxyHandler && $this->noProxyHandler->test($requestUrl); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util\Http; /** * @phpstan-type CurlInfo array{url: mixed, content_type: mixed, http_code: mixed, header_size: mixed, request_size: mixed, filetime: mixed, ssl_verify_result: mixed, redirect_count: mixed, total_time: mixed, namelookup_time: mixed, connect_time: mixed, pretransfer_time: mixed, size_upload: mixed, size_download: mixed, speed_download: mixed, speed_upload: mixed, download_content_length: mixed, upload_content_length: mixed, starttransfer_time: mixed, redirect_time: mixed, certinfo: mixed, primary_ip: mixed, primary_port: mixed, local_ip: mixed, local_port: mixed, redirect_url: mixed} */ class CurlResponse extends Response { /** * @see https://www.php.net/curl_getinfo * @var CurlInfo */ private $curlInfo; /** * @param CurlInfo $curlInfo */ public function __construct(array $request, $code, array $headers, $body, array $curlInfo) { parent::__construct($request, $code, $headers, $body); $this->curlInfo = $curlInfo; } /** * @return CurlInfo */ public function getCurlInfo() { return $this->curlInfo; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Downloader\DownloaderInterface; use Composer\Package\PackageInterface; use React\Promise\PromiseInterface; class SyncHelper { /** * Helps you download + install a single package in a synchronous way * * This executes all the required steps and waits for promises to complete * * @param Loop $loop Loop instance which you can get from $composer->getLoop() * @param DownloaderInterface $downloader Downloader instance you can get from $composer->getDownloadManager()->getDownloader('zip') for example * @param string $path the installation path for the package * @param PackageInterface $package the package to install * @param PackageInterface|null $prevPackage the previous package if this is an update and not an initial installation * * @return void */ public static function downloadAndInstallPackageSync(Loop $loop, DownloaderInterface $downloader, $path, PackageInterface $package, PackageInterface $prevPackage = null) { $type = $prevPackage ? 'update' : 'install'; try { self::await($loop, $downloader->download($package, $path, $prevPackage)); self::await($loop, $downloader->prepare($type, $package, $path, $prevPackage)); if ($type === 'update') { self::await($loop, $downloader->update($package, $prevPackage, $path)); } else { self::await($loop, $downloader->install($package, $path)); } } catch (\Exception $e) { self::await($loop, $downloader->cleanup($type, $package, $path, $prevPackage)); throw $e; } self::await($loop, $downloader->cleanup($type, $package, $path, $prevPackage)); } /** * Waits for a promise to resolve * * @param Loop $loop Loop instance which you can get from $composer->getLoop() * @param PromiseInterface|null $promise * * @return void */ public static function await(Loop $loop, PromiseInterface $promise = null) { if ($promise) { $loop->wait(array($promise)); } } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Config; use Composer\Pcre\Preg; /** * @author Jordi Boggiano */ class Url { /** * @param Config $config * @param string $url * @param string $ref * @return string the updated URL */ public static function updateDistReference(Config $config, $url, $ref) { $host = parse_url($url, PHP_URL_HOST); if ($host === 'api.github.com' || $host === 'github.com' || $host === 'www.github.com') { if (Preg::isMatch('{^https?://(?:www\.)?github\.com/([^/]+)/([^/]+)/(zip|tar)ball/(.+)$}i', $url, $match)) { // update legacy github archives to API calls with the proper reference $url = 'https://api.github.com/repos/' . $match[1] . '/'. $match[2] . '/' . $match[3] . 'ball/' . $ref; } elseif (Preg::isMatch('{^https?://(?:www\.)?github\.com/([^/]+)/([^/]+)/archive/.+\.(zip|tar)(?:\.gz)?$}i', $url, $match)) { // update current github web archives to API calls with the proper reference $url = 'https://api.github.com/repos/' . $match[1] . '/'. $match[2] . '/' . $match[3] . 'ball/' . $ref; } elseif (Preg::isMatch('{^https?://api\.github\.com/repos/([^/]+)/([^/]+)/(zip|tar)ball(?:/.+)?$}i', $url, $match)) { // update api archives to the proper reference $url = 'https://api.github.com/repos/' . $match[1] . '/'. $match[2] . '/' . $match[3] . 'ball/' . $ref; } } elseif ($host === 'bitbucket.org' || $host === 'www.bitbucket.org') { if (Preg::isMatch('{^https?://(?:www\.)?bitbucket\.org/([^/]+)/([^/]+)/get/(.+)\.(zip|tar\.gz|tar\.bz2)$}i', $url, $match)) { // update Bitbucket archives to the proper reference $url = 'https://bitbucket.org/' . $match[1] . '/'. $match[2] . '/get/' . $ref . '.' . $match[4]; } } elseif ($host === 'gitlab.com' || $host === 'www.gitlab.com') { if (Preg::isMatch('{^https?://(?:www\.)?gitlab\.com/api/v[34]/projects/([^/]+)/repository/archive\.(zip|tar\.gz|tar\.bz2|tar)\?sha=.+$}i', $url, $match)) { // update Gitlab archives to the proper reference $url = 'https://gitlab.com/api/v4/projects/' . $match[1] . '/repository/archive.' . $match[2] . '?sha=' . $ref; } } elseif (in_array($host, $config->get('github-domains'), true)) { $url = Preg::replace('{(/repos/[^/]+/[^/]+/(zip|tar)ball)(?:/.+)?$}i', '$1/'.$ref, $url); } elseif (in_array($host, $config->get('gitlab-domains'), true)) { $url = Preg::replace('{(/api/v[34]/projects/[^/]+/repository/archive\.(?:zip|tar\.gz|tar\.bz2|tar)\?sha=).+$}i', '${1}'.$ref, $url); } return $url; } /** * @param string $url * @return string */ public static function getOrigin(Config $config, $url) { if (0 === strpos($url, 'file://')) { return $url; } $origin = (string) parse_url($url, PHP_URL_HOST); if ($port = parse_url($url, PHP_URL_PORT)) { $origin .= ':'.$port; } if (strpos($origin, '.github.com') === (strlen($origin) - 11)) { return 'github.com'; } if ($origin === 'repo.packagist.org') { return 'packagist.org'; } if ($origin === '') { $origin = $url; } // Gitlab can be installed in a non-root context (i.e. gitlab.com/foo). When downloading archives the originUrl // is the host without the path, so we look for the registered gitlab-domains matching the host here if ( is_array($config->get('gitlab-domains')) && false === strpos($origin, '/') && !in_array($origin, $config->get('gitlab-domains')) ) { foreach ($config->get('gitlab-domains') as $gitlabDomain) { if (0 === strpos($gitlabDomain, $origin)) { return $gitlabDomain; } } } return $origin; } /** * @param string $url * @return string */ public static function sanitize($url) { // GitHub repository rename result in redirect locations containing the access_token as GET parameter // e.g. https://api.github.com/repositories/9999999999?access_token=github_token $url = Preg::replace('{([&?]access_token=)[^&]+}', '$1***', $url); $url = Preg::replaceCallback('{^(?P[a-z0-9]+://)?(?P[^:/\s@]+):(?P[^@\s/]+)@}i', function ($m) { // if the username looks like a long (12char+) hex string, or a modern github token (e.g. ghp_xxx) we obfuscate that if (Preg::isMatch('{^([a-f0-9]{12,}|gh[a-z]_[a-zA-Z0-9_]+|github_pat_[a-zA-Z0-9_]+)$}', $m['user'])) { return $m['prefix'].'***:***@'; } return $m['prefix'].$m['user'].':***@'; }, $url); return $url; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Config; use Composer\IO\IOInterface; use Composer\Pcre\Preg; /** * @author Till Klampaeckel * @author Jordi Boggiano */ class Svn { const MAX_QTY_AUTH_TRIES = 5; /** * @var ?array{username: string, password: string} */ protected $credentials; /** * @var bool */ protected $hasAuth; /** * @var \Composer\IO\IOInterface */ protected $io; /** * @var string */ protected $url; /** * @var bool */ protected $cacheCredentials = true; /** * @var ProcessExecutor */ protected $process; /** * @var int */ protected $qtyAuthTries = 0; /** * @var \Composer\Config */ protected $config; /** * @var string|null */ private static $version; /** * @param string $url * @param \Composer\IO\IOInterface $io * @param Config $config * @param ProcessExecutor $process */ public function __construct($url, IOInterface $io, Config $config, ProcessExecutor $process = null) { $this->url = $url; $this->io = $io; $this->config = $config; $this->process = $process ?: new ProcessExecutor($io); } /** * @return void */ public static function cleanEnv() { // clean up env for OSX, see https://github.com/composer/composer/issues/2146#issuecomment-35478940 Platform::clearEnv('DYLD_LIBRARY_PATH'); } /** * Execute an SVN remote command and try to fix up the process with credentials * if necessary. * * @param string $command SVN command to run * @param string $url SVN url * @param string $cwd Working directory * @param string $path Target for a checkout * @param bool $verbose Output all output to the user * * @throws \RuntimeException * @return string */ public function execute($command, $url, $cwd = null, $path = null, $verbose = false) { // Ensure we are allowed to use this URL by config $this->config->prohibitUrlByConfig($url, $this->io); return $this->executeWithAuthRetry($command, $cwd, $url, $path, $verbose); } /** * Execute an SVN local command and try to fix up the process with credentials * if necessary. * * @param string $command SVN command to run * @param string $path Path argument passed thru to the command * @param string $cwd Working directory * @param bool $verbose Output all output to the user * * @throws \RuntimeException * @return string */ public function executeLocal($command, $path, $cwd = null, $verbose = false) { // A local command has no remote url return $this->executeWithAuthRetry($command, $cwd, '', $path, $verbose); } /** * @param string $svnCommand * @param string $cwd * @param string $url * @param string $path * @param bool $verbose * * @return ?string */ private function executeWithAuthRetry($svnCommand, $cwd, $url, $path, $verbose) { // Regenerate the command at each try, to use the newly user-provided credentials $command = $this->getCommand($svnCommand, $url, $path); $output = null; $io = $this->io; $handler = function ($type, $buffer) use (&$output, $io, $verbose) { if ($type !== 'out') { return null; } if (strpos($buffer, 'Redirecting to URL ') === 0) { return null; } $output .= $buffer; if ($verbose) { $io->writeError($buffer, false); } }; $status = $this->process->execute($command, $handler, $cwd); if (0 === $status) { return $output; } $errorOutput = $this->process->getErrorOutput(); $fullOutput = implode("\n", array($output, $errorOutput)); // the error is not auth-related if (false === stripos($fullOutput, 'Could not authenticate to server:') && false === stripos($fullOutput, 'authorization failed') && false === stripos($fullOutput, 'svn: E170001:') && false === stripos($fullOutput, 'svn: E215004:')) { throw new \RuntimeException($fullOutput); } if (!$this->hasAuth()) { $this->doAuthDance(); } // try to authenticate if maximum quantity of tries not reached if ($this->qtyAuthTries++ < self::MAX_QTY_AUTH_TRIES) { // restart the process return $this->executeWithAuthRetry($svnCommand, $cwd, $url, $path, $verbose); } throw new \RuntimeException( 'wrong credentials provided ('.$fullOutput.')' ); } /** * @param bool $cacheCredentials * @return void */ public function setCacheCredentials($cacheCredentials) { $this->cacheCredentials = $cacheCredentials; } /** * Repositories requests credentials, let's put them in. * * @throws \RuntimeException * @return \Composer\Util\Svn */ protected function doAuthDance() { // cannot ask for credentials in non interactive mode if (!$this->io->isInteractive()) { throw new \RuntimeException( 'can not ask for authentication in non interactive mode' ); } $this->io->writeError("The Subversion server ({$this->url}) requested credentials:"); $this->hasAuth = true; $this->credentials = array( 'username' => (string) $this->io->ask("Username: ", ''), 'password' => (string) $this->io->askAndHideAnswer("Password: "), ); $this->cacheCredentials = $this->io->askConfirmation("Should Subversion cache these credentials? (yes/no) "); return $this; } /** * A method to create the svn commands run. * * @param string $cmd Usually 'svn ls' or something like that. * @param string $url Repo URL. * @param string $path Target for a checkout * * @return string */ protected function getCommand($cmd, $url, $path = null) { $cmd = sprintf( '%s %s%s -- %s', $cmd, '--non-interactive ', $this->getCredentialString(), ProcessExecutor::escape($url) ); if ($path) { $cmd .= ' ' . ProcessExecutor::escape($path); } return $cmd; } /** * Return the credential string for the svn command. * * Adds --no-auth-cache when credentials are present. * * @return string */ protected function getCredentialString() { if (!$this->hasAuth()) { return ''; } return sprintf( ' %s--username %s --password %s ', $this->getAuthCache(), ProcessExecutor::escape($this->getUsername()), ProcessExecutor::escape($this->getPassword()) ); } /** * Get the password for the svn command. Can be empty. * * @throws \LogicException * @return string */ protected function getPassword() { if ($this->credentials === null) { throw new \LogicException("No svn auth detected."); } return $this->credentials['password']; } /** * Get the username for the svn command. * * @throws \LogicException * @return string */ protected function getUsername() { if ($this->credentials === null) { throw new \LogicException("No svn auth detected."); } return $this->credentials['username']; } /** * Detect Svn Auth. * * @return bool */ protected function hasAuth() { if (null !== $this->hasAuth) { return $this->hasAuth; } if (false === $this->createAuthFromConfig()) { $this->createAuthFromUrl(); } return (bool) $this->hasAuth; } /** * Return the no-auth-cache switch. * * @return string */ protected function getAuthCache() { return $this->cacheCredentials ? '' : '--no-auth-cache '; } /** * Create the auth params from the configuration file. * * @return bool */ private function createAuthFromConfig() { if (!$this->config->has('http-basic')) { return $this->hasAuth = false; } $authConfig = $this->config->get('http-basic'); $host = parse_url($this->url, PHP_URL_HOST); if (isset($authConfig[$host])) { $this->credentials = array( 'username' => $authConfig[$host]['username'], 'password' => $authConfig[$host]['password'], ); return $this->hasAuth = true; } return $this->hasAuth = false; } /** * Create the auth params from the url * * @return bool */ private function createAuthFromUrl() { $uri = parse_url($this->url); if (empty($uri['user'])) { return $this->hasAuth = false; } $this->credentials = array( 'username' => $uri['user'], 'password' => !empty($uri['pass']) ? $uri['pass'] : '', ); return $this->hasAuth = true; } /** * Returns the version of the svn binary contained in PATH * * @return string|null */ public function binaryVersion() { if (!self::$version) { if (0 === $this->process->execute('svn --version', $output)) { if (Preg::isMatch('{(\d+(?:\.\d+)+)}', $output, $match)) { self::$version = $match[1]; } } } return self::$version; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Config; use Composer\IO\IOInterface; use Composer\Downloader\TransportException; use Composer\Pcre\Preg; use Composer\Util\Http\Response; use Composer\Util\Http\CurlDownloader; use Composer\Composer; use Composer\Package\Version\VersionParser; use Composer\Semver\Constraint\Constraint; use Composer\Exception\IrrecoverableDownloadException; use React\Promise\Promise; use React\Promise\PromiseInterface; /** * @author Jordi Boggiano * @phpstan-type Request array{url: string, options?: mixed[], copyTo?: ?string} * @phpstan-type Job array{id: int, status: int, request: Request, sync: bool, origin: string, resolve?: callable, reject?: callable, curl_id?: int, response?: Response, exception?: TransportException} */ class HttpDownloader { const STATUS_QUEUED = 1; const STATUS_STARTED = 2; const STATUS_COMPLETED = 3; const STATUS_FAILED = 4; const STATUS_ABORTED = 5; /** @var IOInterface */ private $io; /** @var Config */ private $config; /** @var array */ private $jobs = array(); /** @var mixed[] */ private $options = array(); /** @var int */ private $runningJobs = 0; /** @var int */ private $maxJobs = 12; /** @var ?CurlDownloader */ private $curl; /** @var ?RemoteFilesystem */ private $rfs; /** @var int */ private $idGen = 0; /** @var bool */ private $disabled; /** @var bool */ private $allowAsync = false; /** * @param IOInterface $io The IO instance * @param Config $config The config * @param mixed[] $options The options * @param bool $disableTls */ public function __construct(IOInterface $io, Config $config, array $options = array(), $disableTls = false) { $this->io = $io; $this->disabled = (bool) Platform::getEnv('COMPOSER_DISABLE_NETWORK'); // Setup TLS options // The cafile option can be set via config.json if ($disableTls === false) { $this->options = StreamContextFactory::getTlsDefaults($options, $io); } // handle the other externally set options normally. $this->options = array_replace_recursive($this->options, $options); $this->config = $config; if (self::isCurlEnabled()) { $this->curl = new CurlDownloader($io, $config, $options, $disableTls); } $this->rfs = new RemoteFilesystem($io, $config, $options, $disableTls); if (is_numeric($maxJobs = Platform::getEnv('COMPOSER_MAX_PARALLEL_HTTP'))) { $this->maxJobs = max(1, min(50, (int) $maxJobs)); } } /** * Download a file synchronously * * @param string $url URL to download * @param mixed[] $options Stream context options e.g. https://www.php.net/manual/en/context.http.php * although not all options are supported when using the default curl downloader * @throws TransportException * @return Response */ public function get($url, $options = array()) { list($job) = $this->addJob(array('url' => $url, 'options' => $options, 'copyTo' => null), true); $this->wait($job['id']); $response = $this->getResponse($job['id']); // check for failed curl response (empty body but successful looking response) if ( $this->curl && PHP_VERSION_ID < 70000 && $response->getBody() === null && $response->getStatusCode() === 200 && $response->getHeader('content-length') !== '0' ) { $this->io->writeError('cURL downloader failed to return a response, disabling it and proceeding in slow mode.'); $this->curl = null; list($job) = $this->addJob(array('url' => $url, 'options' => $options, 'copyTo' => null), true); $this->wait($job['id']); $response = $this->getResponse($job['id']); } return $response; } /** * Create an async download operation * * @param string $url URL to download * @param mixed[] $options Stream context options e.g. https://www.php.net/manual/en/context.http.php * although not all options are supported when using the default curl downloader * @throws TransportException * @return PromiseInterface */ public function add($url, $options = array()) { list(, $promise) = $this->addJob(array('url' => $url, 'options' => $options, 'copyTo' => null)); return $promise; } /** * Copy a file synchronously * * @param string $url URL to download * @param string $to Path to copy to * @param mixed[] $options Stream context options e.g. https://www.php.net/manual/en/context.http.php * although not all options are supported when using the default curl downloader * @throws TransportException * @return Response */ public function copy($url, $to, $options = array()) { list($job) = $this->addJob(array('url' => $url, 'options' => $options, 'copyTo' => $to), true); $this->wait($job['id']); return $this->getResponse($job['id']); } /** * Create an async copy operation * * @param string $url URL to download * @param string $to Path to copy to * @param mixed[] $options Stream context options e.g. https://www.php.net/manual/en/context.http.php * although not all options are supported when using the default curl downloader * @throws TransportException * @return PromiseInterface */ public function addCopy($url, $to, $options = array()) { list(, $promise) = $this->addJob(array('url' => $url, 'options' => $options, 'copyTo' => $to)); return $promise; } /** * Retrieve the options set in the constructor * * @return mixed[] Options */ public function getOptions() { return $this->options; } /** * Merges new options * * @param mixed[] $options * @return void */ public function setOptions(array $options) { $this->options = array_replace_recursive($this->options, $options); } /** * @param Request $request * @param bool $sync * * @return array{Job, PromiseInterface} */ private function addJob($request, $sync = false) { $request['options'] = array_replace_recursive($this->options, $request['options']); /** @var Job */ $job = array( 'id' => $this->idGen++, 'status' => self::STATUS_QUEUED, 'request' => $request, 'sync' => $sync, 'origin' => Url::getOrigin($this->config, $request['url']), ); if (!$sync && !$this->allowAsync) { throw new \LogicException('You must use the HttpDownloader instance which is part of a Composer\Loop instance to be able to run async http requests'); } // capture username/password from URL if there is one if (Preg::isMatch('{^https?://([^:/]+):([^@/]+)@([^/]+)}i', $request['url'], $match)) { $this->io->setAuthentication($job['origin'], rawurldecode($match[1]), rawurldecode($match[2])); } $rfs = $this->rfs; if ($this->canUseCurl($job)) { $resolver = function ($resolve, $reject) use (&$job) { $job['status'] = HttpDownloader::STATUS_QUEUED; $job['resolve'] = $resolve; $job['reject'] = $reject; }; } else { $resolver = function ($resolve, $reject) use (&$job, $rfs) { // start job $url = $job['request']['url']; $options = $job['request']['options']; $job['status'] = HttpDownloader::STATUS_STARTED; if ($job['request']['copyTo']) { $rfs->copy($job['origin'], $url, $job['request']['copyTo'], false /* TODO progress */, $options); $headers = $rfs->getLastHeaders(); $response = new Http\Response($job['request'], $rfs->findStatusCode($headers), $headers, $job['request']['copyTo'].'~'); $resolve($response); } else { $body = $rfs->getContents($job['origin'], $url, false /* TODO progress */, $options); $headers = $rfs->getLastHeaders(); $response = new Http\Response($job['request'], $rfs->findStatusCode($headers), $headers, $body); $resolve($response); } }; } $downloader = $this; $curl = $this->curl; $canceler = function () use (&$job, $curl) { if ($job['status'] === HttpDownloader::STATUS_QUEUED) { $job['status'] = HttpDownloader::STATUS_ABORTED; } if ($job['status'] !== HttpDownloader::STATUS_STARTED) { return; } $job['status'] = HttpDownloader::STATUS_ABORTED; if (isset($job['curl_id'])) { $curl->abortRequest($job['curl_id']); } throw new IrrecoverableDownloadException('Download of ' . Url::sanitize($job['request']['url']) . ' canceled'); }; $promise = new Promise($resolver, $canceler); $promise = $promise->then(function ($response) use (&$job, $downloader) { $job['status'] = HttpDownloader::STATUS_COMPLETED; $job['response'] = $response; // TODO 3.0 this should be done directly on $this when PHP 5.3 is dropped $downloader->markJobDone(); return $response; }, function ($e) use (&$job, $downloader) { $job['status'] = HttpDownloader::STATUS_FAILED; $job['exception'] = $e; $downloader->markJobDone(); throw $e; }); $this->jobs[$job['id']] = &$job; if ($this->runningJobs < $this->maxJobs) { $this->startJob($job['id']); } return array($job, $promise); } /** * @param int $id * @return void */ private function startJob($id) { $job = &$this->jobs[$id]; if ($job['status'] !== self::STATUS_QUEUED) { return; } // start job $job['status'] = self::STATUS_STARTED; $this->runningJobs++; $resolve = $job['resolve']; $reject = $job['reject']; $url = $job['request']['url']; $options = $job['request']['options']; $origin = $job['origin']; if ($this->disabled) { if (isset($job['request']['options']['http']['header']) && false !== stripos(implode('', $job['request']['options']['http']['header']), 'if-modified-since')) { $resolve(new Response(array('url' => $url), 304, array(), '')); } else { $e = new TransportException('Network disabled, request canceled: '.Url::sanitize($url), 499); $e->setStatusCode(499); $reject($e); } return; } try { if ($job['request']['copyTo']) { $job['curl_id'] = $this->curl->download($resolve, $reject, $origin, $url, $options, $job['request']['copyTo']); } else { $job['curl_id'] = $this->curl->download($resolve, $reject, $origin, $url, $options); } } catch (\Exception $exception) { $reject($exception); } } /** * @private * @return void */ public function markJobDone() { $this->runningJobs--; } /** * Wait for current async download jobs to complete * * @param int|null $index For internal use only, the job id * * @return void */ public function wait($index = null) { do { $jobCount = $this->countActiveJobs($index); } while ($jobCount); } /** * @internal * * @return void */ public function enableAsync() { $this->allowAsync = true; } /** * @internal * * @param int|null $index For internal use only, the job id * @return int number of active (queued or started) jobs */ public function countActiveJobs($index = null) { if ($this->runningJobs < $this->maxJobs) { foreach ($this->jobs as $job) { if ($job['status'] === self::STATUS_QUEUED && $this->runningJobs < $this->maxJobs) { $this->startJob($job['id']); } } } if ($this->curl) { $this->curl->tick(); } if (null !== $index) { return $this->jobs[$index]['status'] < self::STATUS_COMPLETED ? 1 : 0; } $active = 0; foreach ($this->jobs as $job) { if ($job['status'] < self::STATUS_COMPLETED) { $active++; } elseif (!$job['sync']) { unset($this->jobs[$job['id']]); } } return $active; } /** * @param int $index Job id * @return Response */ private function getResponse($index) { if (!isset($this->jobs[$index])) { throw new \LogicException('Invalid request id'); } if ($this->jobs[$index]['status'] === self::STATUS_FAILED) { throw $this->jobs[$index]['exception']; } if (!isset($this->jobs[$index]['response'])) { throw new \LogicException('Response not available yet, call wait() first'); } $resp = $this->jobs[$index]['response']; unset($this->jobs[$index]); return $resp; } /** * @internal * * @param string $url * @param array{warning?: string, info?: string, warning-versions?: string, info-versions?: string, warnings?: array, infos?: array} $data * @return void */ public static function outputWarnings(IOInterface $io, $url, $data) { $cleanMessage = function ($msg) use ($io) { if (!$io->isDecorated()) { $msg = Preg::replace('{'.chr(27).'\\[[;\d]*m}u', '', $msg); } return $msg; }; // legacy warning/info keys foreach (array('warning', 'info') as $type) { if (empty($data[$type])) { continue; } if (!empty($data[$type . '-versions'])) { $versionParser = new VersionParser(); $constraint = $versionParser->parseConstraints($data[$type . '-versions']); $composer = new Constraint('==', $versionParser->normalize(Composer::getVersion())); if (!$constraint->matches($composer)) { continue; } } $io->writeError('<'.$type.'>'.ucfirst($type).' from '.Url::sanitize($url).': '.$cleanMessage($data[$type]).''); } // modern Composer 2.2+ format with support for multiple warning/info messages foreach (array('warnings', 'infos') as $key) { if (empty($data[$key])) { continue; } $versionParser = new VersionParser(); foreach ($data[$key] as $spec) { $type = substr($key, 0, -1); $constraint = $versionParser->parseConstraints($spec['versions']); $composer = new Constraint('==', $versionParser->normalize(Composer::getVersion())); if (!$constraint->matches($composer)) { continue; } $io->writeError('<'.$type.'>'.ucfirst($type).' from '.Url::sanitize($url).': '.$cleanMessage($spec['message']).''); } } } /** * @internal * * @return ?string[] */ public static function getExceptionHints(\Exception $e) { if (!$e instanceof TransportException) { return null; } if ( false !== strpos($e->getMessage(), 'Resolving timed out') || false !== strpos($e->getMessage(), 'Could not resolve host') ) { Silencer::suppress(); $testConnectivity = file_get_contents('https://8.8.8.8', false, stream_context_create(array( 'ssl' => array('verify_peer' => false), 'http' => array('follow_location' => false, 'ignore_errors' => true), ))); Silencer::restore(); if (false !== $testConnectivity) { return array( 'The following exception probably indicates you have misconfigured DNS resolver(s)', ); } return array( 'The following exception probably indicates you are offline or have misconfigured DNS resolver(s)', ); } return null; } /** * @param Job $job * @return bool */ private function canUseCurl(array $job) { if (!$this->curl) { return false; } if (!Preg::isMatch('{^https?://}i', $job['request']['url'])) { return false; } if (!empty($job['request']['options']['ssl']['allow_self_signed'])) { return false; } return true; } /** * @internal * @return bool */ public static function isCurlEnabled() { return \extension_loaded('curl') && \function_exists('curl_multi_exec') && \function_exists('curl_multi_init'); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; /** * @author Wissem Riahi */ class Tar { /** * @param string $pathToArchive * * @return string|null */ public static function getComposerJson($pathToArchive) { $phar = new \PharData($pathToArchive); if (!$phar->valid()) { return null; } return self::extractComposerJsonFromFolder($phar); } /** * @param \PharData $phar * * @throws \RuntimeException * * @return string */ private static function extractComposerJsonFromFolder(\PharData $phar) { if (isset($phar['composer.json'])) { return $phar['composer.json']->getContent(); } $topLevelPaths = array(); foreach ($phar as $folderFile) { $name = $folderFile->getBasename(); if ($folderFile->isDir()) { $topLevelPaths[$name] = true; if (\count($topLevelPaths) > 1) { throw new \RuntimeException('Archive has more than one top level directories, and no composer.json was found on the top level, so it\'s an invalid archive. Top level paths found were: '.implode(',', array_keys($topLevelPaths))); } } } $composerJsonPath = key($topLevelPaths).'/composer.json'; if ($topLevelPaths && isset($phar[$composerJsonPath])) { return $phar[$composerJsonPath]->getContent(); } throw new \RuntimeException('No composer.json found either at the top level or within the topmost directory'); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\IO\IOInterface; use Composer\Pcre\Preg; /** * Convert PHP errors into exceptions * * @author Artem Lopata */ class ErrorHandler { /** @var ?IOInterface */ private static $io; /** * Error handler * * @param int $level Level of the error raised * @param string $message Error message * @param string $file Filename that the error was raised in * @param int $line Line number the error was raised at * * @static * @throws \ErrorException * @return bool */ public static function handle($level, $message, $file, $line) { // error code is not included in error_reporting if (!(error_reporting() & $level)) { return true; } if (filter_var(ini_get('xdebug.scream'), FILTER_VALIDATE_BOOLEAN)) { $message .= "\n\nWarning: You have xdebug.scream enabled, the warning above may be". "\na legitimately suppressed error that you were not supposed to see."; } if ($level !== E_DEPRECATED && $level !== E_USER_DEPRECATED) { throw new \ErrorException($message, 0, $level, $file, $line); } if (self::$io) { // ignore symfony/* deprecation warnings // TODO remove in 2.3 if (Preg::isMatch('{^Return type of Symfony\\\\.*ReturnTypeWillChange}is', $message)) { return true; } if (strpos(strtr($file, '\\', '/'), 'vendor/symfony/') !== false) { return true; } self::$io->writeError('Deprecation Notice: '.$message.' in '.$file.':'.$line.''); if (self::$io->isVerbose()) { self::$io->writeError('Stack trace:'); self::$io->writeError(array_filter(array_map(function ($a) { if (isset($a['line'], $a['file'])) { return ' '.$a['file'].':'.$a['line'].''; } return null; }, array_slice(debug_backtrace(), 2)))); } } return true; } /** * Register error handler. * * @param IOInterface|null $io * * @return void */ public static function register(IOInterface $io = null) { set_error_handler(array(__CLASS__, 'handle')); // no E_DEPRECATED for this LTS series, or we get countless deprecation notices related to E_STRICT and explicit nullable types for PHP 8.4+ // also see bin/composer error_reporting(E_ALL & ~E_DEPRECATED | E_STRICT); self::$io = $io; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Config; use Composer\IO\IOInterface; use Composer\Downloader\TransportException; use Composer\Pcre\Preg; /** * @author Jordi Boggiano */ class AuthHelper { /** @var IOInterface */ protected $io; /** @var Config */ protected $config; /** @var array Map of origins to message displayed */ private $displayedOriginAuthentications = array(); /** @var array */ private $bitbucketRetry = array(); public function __construct(IOInterface $io, Config $config) { $this->io = $io; $this->config = $config; } /** * @param string $origin * @param string|bool $storeAuth * * @return void */ public function storeAuth($origin, $storeAuth) { $store = false; $configSource = $this->config->getAuthConfigSource(); if ($storeAuth === true) { $store = $configSource; } elseif ($storeAuth === 'prompt') { $answer = $this->io->askAndValidate( 'Do you want to store credentials for '.$origin.' in '.$configSource->getName().' ? [Yn] ', function ($value) { $input = strtolower(substr(trim($value), 0, 1)); if (in_array($input, array('y','n'))) { return $input; } throw new \RuntimeException('Please answer (y)es or (n)o'); }, null, 'y' ); if ($answer === 'y') { $store = $configSource; } } if ($store) { $store->addConfigSetting( 'http-basic.'.$origin, $this->io->getAuthentication($origin) ); } } /** * @param string $url * @param string $origin * @param int $statusCode HTTP status code that triggered this call * @param string|null $reason a message/description explaining why this was called * @param string[] $headers * @param int $retryCount the amount of retries already done on this URL * @return array|null containing retry (bool) and storeAuth (string|bool) keys, if retry is true the request should be * retried, if storeAuth is true then on a successful retry the authentication should be persisted to auth.json * @phpstan-return ?array{retry: bool, storeAuth: string|bool} */ public function promptAuthIfNeeded($url, $origin, $statusCode, $reason = null, $headers = array(), $retryCount = 0) { $storeAuth = false; if (in_array($origin, $this->config->get('github-domains'), true)) { $gitHubUtil = new GitHub($this->io, $this->config, null); $message = "\n"; $rateLimited = $gitHubUtil->isRateLimited($headers); $requiresSso = $gitHubUtil->requiresSso($headers); if ($requiresSso) { $ssoUrl = $gitHubUtil->getSsoUrl($headers); $message = 'GitHub API token requires SSO authorization. Authorize this token at ' . $ssoUrl . "\n"; $this->io->writeError($message); if (!$this->io->isInteractive()) { throw new TransportException('Could not authenticate against ' . $origin, 403); } $this->io->ask('After authorizing your token, confirm that you would like to retry the request'); return array('retry' => true, 'storeAuth' => $storeAuth); } if ($rateLimited) { $rateLimit = $gitHubUtil->getRateLimit($headers); if ($this->io->hasAuthentication($origin)) { $message = 'Review your configured GitHub OAuth token or enter a new one to go over the API rate limit.'; } else { $message = 'Create a GitHub OAuth token to go over the API rate limit.'; } $message = sprintf( 'GitHub API limit (%d calls/hr) is exhausted, could not fetch '.$url.'. '.$message.' You can also wait until %s for the rate limit to reset.', $rateLimit['limit'], $rateLimit['reset'] )."\n"; } else { $message .= 'Could not fetch '.$url.', please '; if ($this->io->hasAuthentication($origin)) { $message .= 'review your configured GitHub OAuth token or enter a new one to access private repos'; } else { $message .= 'create a GitHub OAuth token to access private repos'; } } if (!$gitHubUtil->authorizeOAuth($origin) && (!$this->io->isInteractive() || !$gitHubUtil->authorizeOAuthInteractively($origin, $message)) ) { throw new TransportException('Could not authenticate against '.$origin, 401); } } elseif (in_array($origin, $this->config->get('gitlab-domains'), true)) { $message = "\n".'Could not fetch '.$url.', enter your ' . $origin . ' credentials ' .($statusCode === 401 ? 'to access private repos' : 'to go over the API rate limit'); $gitLabUtil = new GitLab($this->io, $this->config, null); $auth = null; if ($this->io->hasAuthentication($origin)) { $auth = $this->io->getAuthentication($origin); if (in_array($auth['password'], array('gitlab-ci-token', 'private-token', 'oauth2'), true)) { throw new TransportException("Invalid credentials for '" . $url . "', aborting.", $statusCode); } } if (!$gitLabUtil->authorizeOAuth($origin) && (!$this->io->isInteractive() || !$gitLabUtil->authorizeOAuthInteractively(parse_url($url, PHP_URL_SCHEME), $origin, $message)) ) { throw new TransportException('Could not authenticate against '.$origin, 401); } if ($auth !== null && $this->io->hasAuthentication($origin)) { if ($auth === $this->io->getAuthentication($origin)) { throw new TransportException("Invalid credentials for '" . $url . "', aborting.", $statusCode); } } } elseif ($origin === 'bitbucket.org' || $origin === 'api.bitbucket.org') { $askForOAuthToken = true; $origin = 'bitbucket.org'; if ($this->io->hasAuthentication($origin)) { $auth = $this->io->getAuthentication($origin); if ($auth['username'] !== 'x-token-auth') { $bitbucketUtil = new Bitbucket($this->io, $this->config); $accessToken = $bitbucketUtil->requestToken($origin, $auth['username'], $auth['password']); if (!empty($accessToken)) { $this->io->setAuthentication($origin, 'x-token-auth', $accessToken); $askForOAuthToken = false; } } elseif (!isset($this->bitbucketRetry[$url])) { $askForOAuthToken = false; $this->bitbucketRetry[$url] = 1; } else { throw new TransportException('Could not authenticate against ' . $origin, 401); } } if ($askForOAuthToken) { $message = "\n".'Could not fetch ' . $url . ', please create a bitbucket OAuth token to ' . (($statusCode === 401 || $statusCode === 403) ? 'access private repos' : 'go over the API rate limit'); $bitBucketUtil = new Bitbucket($this->io, $this->config); if (!$bitBucketUtil->authorizeOAuth($origin) && (!$this->io->isInteractive() || !$bitBucketUtil->authorizeOAuthInteractively($origin, $message)) ) { throw new TransportException('Could not authenticate against ' . $origin, 401); } } } else { // 404s are only handled for github if ($statusCode === 404) { return null; } // fail if the console is not interactive if (!$this->io->isInteractive()) { if ($statusCode === 401) { $message = "The '" . $url . "' URL required authentication (HTTP 401).\nYou must be using the interactive console to authenticate"; } elseif ($statusCode === 403) { $message = "The '" . $url . "' URL could not be accessed (HTTP 403): " . $reason; } else { $message = "Unknown error code '" . $statusCode . "', reason: " . $reason; } throw new TransportException($message, $statusCode); } // fail if we already have auth if ($this->io->hasAuthentication($origin)) { // if two or more requests are started together for the same host, and the first // received authentication already, we let the others retry before failing them if ($retryCount === 0) { return array('retry' => true, 'storeAuth' => false); } throw new TransportException("Invalid credentials (HTTP $statusCode) for '$url', aborting.", $statusCode); } $this->io->writeError(' Authentication required ('.$origin.'):'); $username = $this->io->ask(' Username: '); $password = $this->io->askAndHideAnswer(' Password: '); $this->io->setAuthentication($origin, $username, $password); $storeAuth = $this->config->get('store-auths'); } return array('retry' => true, 'storeAuth' => $storeAuth); } /** * @param string[] $headers * @param string $origin * @param string $url * * @return string[] updated headers array */ public function addAuthenticationHeader(array $headers, $origin, $url) { if ($this->io->hasAuthentication($origin)) { $authenticationDisplayMessage = null; $auth = $this->io->getAuthentication($origin); if ($auth['password'] === 'bearer') { $headers[] = 'Authorization: Bearer '.$auth['username']; } elseif ('github.com' === $origin && 'x-oauth-basic' === $auth['password']) { // only add the access_token if it is actually a github API URL if (Preg::isMatch('{^https?://api\.github\.com/}', $url)) { $headers[] = 'Authorization: token '.$auth['username']; $authenticationDisplayMessage = 'Using GitHub token authentication'; } } elseif ( in_array($origin, $this->config->get('gitlab-domains'), true) && in_array($auth['password'], array('oauth2', 'private-token', 'gitlab-ci-token'), true) ) { if ($auth['password'] === 'oauth2') { $headers[] = 'Authorization: Bearer '.$auth['username']; $authenticationDisplayMessage = 'Using GitLab OAuth token authentication'; } else { $headers[] = 'PRIVATE-TOKEN: '.$auth['username']; $authenticationDisplayMessage = 'Using GitLab private token authentication'; } } elseif ( 'bitbucket.org' === $origin && $url !== Bitbucket::OAUTH2_ACCESS_TOKEN_URL && 'x-token-auth' === $auth['username'] ) { if (!$this->isPublicBitBucketDownload($url)) { $headers[] = 'Authorization: Bearer ' . $auth['password']; $authenticationDisplayMessage = 'Using Bitbucket OAuth token authentication'; } } else { $authStr = base64_encode($auth['username'] . ':' . $auth['password']); $headers[] = 'Authorization: Basic '.$authStr; $authenticationDisplayMessage = 'Using HTTP basic authentication with username "' . $auth['username'] . '"'; } if ($authenticationDisplayMessage && (!isset($this->displayedOriginAuthentications[$origin]) || $this->displayedOriginAuthentications[$origin] !== $authenticationDisplayMessage)) { $this->io->writeError($authenticationDisplayMessage, true, IOInterface::DEBUG); $this->displayedOriginAuthentications[$origin] = $authenticationDisplayMessage; } } elseif (in_array($origin, array('api.bitbucket.org', 'api.github.com'), true)) { return $this->addAuthenticationHeader($headers, str_replace('api.', '', $origin), $url); } return $headers; } /** * @link https://github.com/composer/composer/issues/5584 * * @param string $urlToBitBucketFile URL to a file at bitbucket.org. * * @return bool Whether the given URL is a public BitBucket download which requires no authentication. */ public function isPublicBitBucketDownload($urlToBitBucketFile) { $domain = parse_url($urlToBitBucketFile, PHP_URL_HOST); if (strpos($domain, 'bitbucket.org') === false) { // Bitbucket downloads are hosted on amazonaws. // We do not need to authenticate there at all return true; } $path = parse_url($urlToBitBucketFile, PHP_URL_PATH); // Path for a public download follows this pattern /{user}/{repo}/downloads/{whatever} // {@link https://blog.bitbucket.org/2009/04/12/new-feature-downloads/} $pathParts = explode('/', $path); return count($pathParts) >= 4 && $pathParts[3] == 'downloads'; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Package\Loader\ArrayLoader; use Composer\Package\Loader\ValidatingArrayLoader; use Composer\Package\Loader\InvalidPackageException; use Composer\Json\JsonValidationException; use Composer\IO\IOInterface; use Composer\Json\JsonFile; use Composer\Pcre\Preg; use Composer\Spdx\SpdxLicenses; /** * Validates a composer configuration. * * @author Robert SchÃ¶nthal * @author Jordi Boggiano */ class ConfigValidator { const CHECK_VERSION = 1; /** @var IOInterface */ private $io; public function __construct(IOInterface $io) { $this->io = $io; } /** * Validates the config, and returns the result. * * @param string $file The path to the file * @param int $arrayLoaderValidationFlags Flags for ArrayLoader validation * @param int $flags Flags for validation * * @return array{list, list, list} a triple containing the errors, publishable errors, and warnings */ public function validate($file, $arrayLoaderValidationFlags = ValidatingArrayLoader::CHECK_ALL, $flags = self::CHECK_VERSION) { $errors = array(); $publishErrors = array(); $warnings = array(); // validate json schema $laxValid = false; try { $json = new JsonFile($file, null, $this->io); $manifest = $json->read(); $json->validateSchema(JsonFile::LAX_SCHEMA); $laxValid = true; $json->validateSchema(); } catch (JsonValidationException $e) { foreach ($e->getErrors() as $message) { if ($laxValid) { $publishErrors[] = $message; } else { $errors[] = $message; } } } catch (\Exception $e) { $errors[] = $e->getMessage(); return array($errors, $publishErrors, $warnings); } // validate actual data if (empty($manifest['license'])) { $warnings[] = 'No license specified, it is recommended to do so. For closed-source software you may use "proprietary" as license.'; } else { $licenses = (array) $manifest['license']; // strip proprietary since it's not a valid SPDX identifier, but is accepted by composer foreach ($licenses as $key => $license) { if ('proprietary' === $license) { unset($licenses[$key]); } } $licenseValidator = new SpdxLicenses(); foreach ($licenses as $license) { $spdxLicense = $licenseValidator->getLicenseByIdentifier($license); if ($spdxLicense && $spdxLicense[3]) { if (Preg::isMatch('{^[AL]?GPL-[123](\.[01])?\+$}i', $license)) { $warnings[] = sprintf( 'License "%s" is a deprecated SPDX license identifier, use "'.str_replace('+', '', $license).'-or-later" instead', $license ); } elseif (Preg::isMatch('{^[AL]?GPL-[123](\.[01])?$}i', $license)) { $warnings[] = sprintf( 'License "%s" is a deprecated SPDX license identifier, use "'.$license.'-only" or "'.$license.'-or-later" instead', $license ); } else { $warnings[] = sprintf( 'License "%s" is a deprecated SPDX license identifier, see https://spdx.org/licenses/', $license ); } } } } if (($flags & self::CHECK_VERSION) && isset($manifest['version'])) { $warnings[] = 'The version field is present, it is recommended to leave it out if the package is published on Packagist.'; } if (!empty($manifest['name']) && Preg::isMatch('{[A-Z]}', $manifest['name'])) { $suggestName = Preg::replace('{(?:([a-z])([A-Z])|([A-Z])([A-Z][a-z]))}', '\\1\\3-\\2\\4', $manifest['name']); $suggestName = strtolower($suggestName); $publishErrors[] = sprintf( 'Name "%s" does not match the best practice (e.g. lower-cased/with-dashes). We suggest using "%s" instead. As such you will not be able to submit it to Packagist.', $manifest['name'], $suggestName ); } if (!empty($manifest['type']) && $manifest['type'] == 'composer-installer') { $warnings[] = "The package type 'composer-installer' is deprecated. Please distribute your custom installers as plugins from now on. See https://getcomposer.org/doc/articles/plugins.md for plugin documentation."; } // check for require-dev overrides if (isset($manifest['require'], $manifest['require-dev'])) { $requireOverrides = array_intersect_key($manifest['require'], $manifest['require-dev']); if (!empty($requireOverrides)) { $plural = (count($requireOverrides) > 1) ? 'are' : 'is'; $warnings[] = implode(', ', array_keys($requireOverrides)). " {$plural} required both in require and require-dev, this can lead to unexpected behavior"; } } // check for meaningless provide/replace satisfying requirements foreach (array('provide', 'replace') as $linkType) { if (isset($manifest[$linkType])) { foreach (array('require', 'require-dev') as $requireType) { if (isset($manifest[$requireType])) { foreach ($manifest[$linkType] as $provide => $constraint) { if (isset($manifest[$requireType][$provide])) { $warnings[] = 'The package ' . $provide . ' in '.$requireType.' is also listed in '.$linkType.' which satisfies the requirement. Remove it from '.$linkType.' if you wish to install it.'; } } } } } } // check for commit references $require = isset($manifest['require']) ? $manifest['require'] : array(); $requireDev = isset($manifest['require-dev']) ? $manifest['require-dev'] : array(); $packages = array_merge($require, $requireDev); foreach ($packages as $package => $version) { if (Preg::isMatch('/#/', $version)) { $warnings[] = sprintf( 'The package "%s" is pointing to a commit-ref, this is bad practice and can cause unforeseen issues.', $package ); } } // report scripts-descriptions for non-existent scripts $scriptsDescriptions = isset($manifest['scripts-descriptions']) ? $manifest['scripts-descriptions'] : array(); $scripts = isset($manifest['scripts']) ? $manifest['scripts'] : array(); foreach ($scriptsDescriptions as $scriptName => $scriptDescription) { if (!array_key_exists($scriptName, $scripts)) { $warnings[] = sprintf( 'Description for non-existent script "%s" found in "scripts-descriptions"', $scriptName ); } } // check for empty psr-0/psr-4 namespace prefixes if (isset($manifest['autoload']['psr-0'][''])) { $warnings[] = "Defining autoload.psr-0 with an empty namespace prefix is a bad idea for performance"; } if (isset($manifest['autoload']['psr-4'][''])) { $warnings[] = "Defining autoload.psr-4 with an empty namespace prefix is a bad idea for performance"; } $loader = new ValidatingArrayLoader(new ArrayLoader(), true, null, $arrayLoaderValidationFlags); try { if (!isset($manifest['version'])) { $manifest['version'] = '1.0.0'; } if (!isset($manifest['name'])) { $manifest['name'] = 'dummy/dummy'; } $loader->load($manifest); } catch (InvalidPackageException $e) { $errors = array_merge($errors, $e->getErrors()); } $warnings = array_merge($warnings, $loader->getWarnings()); return array($errors, $publishErrors, $warnings); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; /** * @author Andreas Schempp */ class Zip { /** * Gets content of the root composer.json inside a ZIP archive. * * @param string $pathToZip * * @return string|null */ public static function getComposerJson($pathToZip) { if (!extension_loaded('zip')) { throw new \RuntimeException('The Zip Util requires PHP\'s zip extension'); } $zip = new \ZipArchive(); if ($zip->open($pathToZip) !== true) { return null; } if (0 == $zip->numFiles) { $zip->close(); return null; } $foundFileIndex = self::locateFile($zip, 'composer.json'); $content = null; $configurationFileName = $zip->getNameIndex($foundFileIndex); $stream = $zip->getStream($configurationFileName); if (false !== $stream) { $content = stream_get_contents($stream); } $zip->close(); return $content; } /** * Find a file by name, returning the one that has the shortest path. * * @param \ZipArchive $zip * @param string $filename * @throws \RuntimeException * * @return int */ private static function locateFile(\ZipArchive $zip, $filename) { // return root composer.json if it is there and is a file if (false !== ($index = $zip->locateName($filename)) && $zip->getFromIndex($index) !== false) { return $index; } $topLevelPaths = array(); for ($i = 0; $i < $zip->numFiles; $i++) { $name = $zip->getNameIndex($i); $dirname = dirname($name); // ignore OSX specific resource fork folder if (strpos($name, '__MACOSX') !== false) { continue; } // handle archives with proper TOC if ($dirname === '.') { $topLevelPaths[$name] = true; if (\count($topLevelPaths) > 1) { throw new \RuntimeException('Archive has more than one top level directories, and no composer.json was found on the top level, so it\'s an invalid archive. Top level paths found were: '.implode(',', array_keys($topLevelPaths))); } continue; } // handle archives which do not have a TOC record for the directory itself if (false === strpos($dirname, '\\') && false === strpos($dirname, '/')) { $topLevelPaths[$dirname.'/'] = true; if (\count($topLevelPaths) > 1) { throw new \RuntimeException('Archive has more than one top level directories, and no composer.json was found on the top level, so it\'s an invalid archive. Top level paths found were: '.implode(',', array_keys($topLevelPaths))); } } } if ($topLevelPaths && false !== ($index = $zip->locateName(key($topLevelPaths).$filename)) && $zip->getFromIndex($index) !== false) { return $index; } throw new \RuntimeException('No composer.json found either at the top level or within the topmost directory'); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Factory; use Composer\IO\IOInterface; use Composer\Config; use Composer\Downloader\TransportException; use Composer\Pcre\Preg; /** * @author Jordi Boggiano */ class GitHub { /** @var IOInterface */ protected $io; /** @var Config */ protected $config; /** @var ProcessExecutor */ protected $process; /** @var HttpDownloader */ protected $httpDownloader; /** * Constructor. * * @param IOInterface $io The IO instance * @param Config $config The composer configuration * @param ProcessExecutor $process Process instance, injectable for mocking * @param HttpDownloader $httpDownloader Remote Filesystem, injectable for mocking */ public function __construct(IOInterface $io, Config $config, ProcessExecutor $process = null, HttpDownloader $httpDownloader = null) { $this->io = $io; $this->config = $config; $this->process = $process ?: new ProcessExecutor($io); $this->httpDownloader = $httpDownloader ?: Factory::createHttpDownloader($this->io, $config); } /** * Attempts to authorize a GitHub domain via OAuth * * @param string $originUrl The host this GitHub instance is located at * @return bool true on success */ public function authorizeOAuth($originUrl) { if (!in_array($originUrl, $this->config->get('github-domains'))) { return false; } // if available use token from git config if (0 === $this->process->execute('git config github.accesstoken', $output)) { $this->io->setAuthentication($originUrl, trim($output), 'x-oauth-basic'); return true; } return false; } /** * Authorizes a GitHub domain interactively via OAuth * * @param string $originUrl The host this GitHub instance is located at * @param string $message The reason this authorization is required * @throws \RuntimeException * @throws TransportException|\Exception * @return bool true on success */ public function authorizeOAuthInteractively($originUrl, $message = null) { if ($message) { $this->io->writeError($message); } $note = 'Composer'; if ($this->config->get('github-expose-hostname') === true && 0 === $this->process->execute('hostname', $output)) { $note .= ' on ' . trim($output); } $note .= ' ' . date('Y-m-d Hi'); $url = 'https://'.$originUrl.'/settings/tokens/new?scopes=&description=' . str_replace('%20', '+', rawurlencode($note)); $this->io->writeError(sprintf('When working with _public_ GitHub repositories only, head to %s to retrieve a token.', $url)); $this->io->writeError('This token will have read-only permission for public information only.'); $url = 'https://'.$originUrl.'/settings/tokens/new?scopes=repo&description=' . str_replace('%20', '+', rawurlencode($note)); $this->io->writeError(sprintf('When you need to access _private_ GitHub repositories as well, go to %s', $url)); $this->io->writeError('Note that such tokens have broad read/write permissions on your behalf, even if not needed by Composer.'); $this->io->writeError(sprintf('Tokens will be stored in plain text in "%s" for future use by Composer.', $this->config->getAuthConfigSource()->getName())); $this->io->writeError('For additional information, check https://getcomposer.org/doc/articles/authentication-for-private-packages.md#github-oauth'); $token = trim((string) $this->io->askAndHideAnswer('Token (hidden): ')); if ($token === '') { $this->io->writeError('No token given, aborting.'); $this->io->writeError('You can also add it manually later by using "composer config --global --auth github-oauth.github.com "'); return false; } $this->io->setAuthentication($originUrl, $token, 'x-oauth-basic'); try { $apiUrl = ('github.com' === $originUrl) ? 'api.github.com/' : $originUrl . '/api/v3/'; $this->httpDownloader->get('https://'. $apiUrl, array( 'retry-auth-failure' => false, )); } catch (TransportException $e) { if (in_array($e->getCode(), array(403, 401))) { $this->io->writeError('Invalid token provided.'); $this->io->writeError('You can also add it manually later by using "composer config --global --auth github-oauth.github.com "'); return false; } throw $e; } // store value in user config $this->config->getConfigSource()->removeConfigSetting('github-oauth.'.$originUrl); $this->config->getAuthConfigSource()->addConfigSetting('github-oauth.'.$originUrl, $token); $this->io->writeError('Token stored successfully.'); return true; } /** * Extract rate limit from response. * * @param string[] $headers Headers from Composer\Downloader\TransportException. * * @return array{limit: int|'?', reset: string} */ public function getRateLimit(array $headers) { $rateLimit = array( 'limit' => '?', 'reset' => '?', ); foreach ($headers as $header) { $header = trim($header); if (false === stripos($header, 'x-ratelimit-')) { continue; } list($type, $value) = explode(':', $header, 2); switch (strtolower($type)) { case 'x-ratelimit-limit': $rateLimit['limit'] = (int) trim($value); break; case 'x-ratelimit-reset': $rateLimit['reset'] = date('Y-m-d H:i:s', (int) trim($value)); break; } } return $rateLimit; } /** * Extract SSO URL from response. * * @param string[] $headers Headers from Composer\Downloader\TransportException. * * @return string|null */ public function getSsoUrl(array $headers) { foreach ($headers as $header) { $header = trim($header); if (false === stripos($header, 'x-github-sso: required')) { continue; } if (Preg::isMatch('{\burl=(?P[^\s;]+)}', $header, $match)) { return $match['url']; } } return null; } /** * Finds whether a request failed due to rate limiting * * @param string[] $headers Headers from Composer\Downloader\TransportException. * * @return bool */ public function isRateLimited(array $headers) { foreach ($headers as $header) { if (Preg::isMatch('{^x-ratelimit-remaining: *0$}i', trim($header))) { return true; } } return false; } /** * Finds whether a request failed due to lacking SSO authorization * * @see https://docs.github.com/en/rest/overview/other-authentication-methods#authenticating-for-saml-sso * * @param string[] $headers Headers from Composer\Downloader\TransportException. * * @return bool */ public function requiresSso(array $headers) { foreach ($headers as $header) { if (Preg::isMatch('{^x-github-sso: required}i', trim($header))) { return true; } } return false; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Config; use Composer\Downloader\MaxFileSizeExceededException; use Composer\IO\IOInterface; use Composer\Downloader\TransportException; use Composer\CaBundle\CaBundle; use Composer\Pcre\Preg; use Composer\Util\Http\Response; use Composer\Util\Http\ProxyManager; /** * @internal * @author FranÃ§ois Pluchino * @author Jordi Boggiano * @author Nils Adermann */ class RemoteFilesystem { /** @var IOInterface */ private $io; /** @var Config */ private $config; /** @var string */ private $scheme; /** @var int */ private $bytesMax; /** @var string */ private $originUrl; /** @var string */ private $fileUrl; /** @var ?string */ private $fileName; /** @var bool */ private $retry = false; /** @var bool */ private $progress; /** @var ?int */ private $lastProgress; /** @var mixed[] */ private $options = array(); /** @var array */ private $peerCertificateMap = array(); /** @var bool */ private $disableTls = false; /** @var string[] */ private $lastHeaders; /** @var bool */ private $storeAuth = false; /** @var AuthHelper */ private $authHelper; /** @var bool */ private $degradedMode = false; /** @var int */ private $redirects; /** @var int */ private $maxRedirects = 20; /** @var ProxyManager */ private $proxyManager; /** * Constructor. * * @param IOInterface $io The IO instance * @param Config $config The config * @param mixed[] $options The options * @param bool $disableTls * @param AuthHelper $authHelper */ public function __construct(IOInterface $io, Config $config, array $options = array(), $disableTls = false, AuthHelper $authHelper = null) { $this->io = $io; // Setup TLS options // The cafile option can be set via config.json if ($disableTls === false) { $this->options = StreamContextFactory::getTlsDefaults($options, $io); } else { $this->disableTls = true; } // handle the other externally set options normally. $this->options = array_replace_recursive($this->options, $options); $this->config = $config; $this->authHelper = isset($authHelper) ? $authHelper : new AuthHelper($io, $config); $this->proxyManager = ProxyManager::getInstance(); } /** * Copy the remote file in local. * * @param string $originUrl The origin URL * @param string $fileUrl The file URL * @param string $fileName the local filename * @param bool $progress Display the progression * @param mixed[] $options Additional context options * * @return bool true */ public function copy($originUrl, $fileUrl, $fileName, $progress = true, $options = array()) { return $this->get($originUrl, $fileUrl, $options, $fileName, $progress); } /** * Get the content. * * @param string $originUrl The origin URL * @param string $fileUrl The file URL * @param bool $progress Display the progression * @param mixed[] $options Additional context options * * @return bool|string The content */ public function getContents($originUrl, $fileUrl, $progress = true, $options = array()) { return $this->get($originUrl, $fileUrl, $options, null, $progress); } /** * Retrieve the options set in the constructor * * @return mixed[] Options */ public function getOptions() { return $this->options; } /** * Merges new options * * @param mixed[] $options * @return void */ public function setOptions(array $options) { $this->options = array_replace_recursive($this->options, $options); } /** * Check is disable TLS. * * @return bool */ public function isTlsDisabled() { return $this->disableTls === true; } /** * Returns the headers of the last request * * @return string[] */ public function getLastHeaders() { return $this->lastHeaders; } /** * @param string[] $headers array of returned headers like from getLastHeaders() * @return int|null */ public static function findStatusCode(array $headers) { $value = null; foreach ($headers as $header) { if (Preg::isMatch('{^HTTP/\S+ (\d+)}i', $header, $match)) { // In case of redirects, http_response_headers contains the headers of all responses // so we can not return directly and need to keep iterating $value = (int) $match[1]; } } return $value; } /** * @param string[] $headers array of returned headers like from getLastHeaders() * @return string|null */ public function findStatusMessage(array $headers) { $value = null; foreach ($headers as $header) { if (Preg::isMatch('{^HTTP/\S+ \d+}i', $header)) { // In case of redirects, http_response_headers contains the headers of all responses // so we can not return directly and need to keep iterating $value = $header; } } return $value; } /** * Get file content or copy action. * * @param string $originUrl The origin URL * @param string $fileUrl The file URL * @param mixed[] $additionalOptions context options * @param string $fileName the local filename * @param bool $progress Display the progression * * @throws TransportException|\Exception * @throws TransportException When the file could not be downloaded * * @return bool|string */ protected function get($originUrl, $fileUrl, $additionalOptions = array(), $fileName = null, $progress = true) { $this->scheme = parse_url($fileUrl, PHP_URL_SCHEME); $this->bytesMax = 0; $this->originUrl = $originUrl; $this->fileUrl = $fileUrl; $this->fileName = $fileName; $this->progress = $progress; $this->lastProgress = null; $retryAuthFailure = true; $this->lastHeaders = array(); $this->redirects = 1; // The first request counts. $tempAdditionalOptions = $additionalOptions; if (isset($tempAdditionalOptions['retry-auth-failure'])) { $retryAuthFailure = (bool) $tempAdditionalOptions['retry-auth-failure']; unset($tempAdditionalOptions['retry-auth-failure']); } $isRedirect = false; if (isset($tempAdditionalOptions['redirects'])) { $this->redirects = $tempAdditionalOptions['redirects']; $isRedirect = true; unset($tempAdditionalOptions['redirects']); } $options = $this->getOptionsForUrl($originUrl, $tempAdditionalOptions); unset($tempAdditionalOptions); $origFileUrl = $fileUrl; if (isset($options['gitlab-token'])) { $fileUrl .= (false === strpos($fileUrl, '?') ? '?' : '&') . 'access_token='.$options['gitlab-token']; unset($options['gitlab-token']); } if (isset($options['http'])) { $options['http']['ignore_errors'] = true; } if ($this->degradedMode && strpos($fileUrl, 'http://repo.packagist.org/') === 0) { // access packagist using the resolved IPv4 instead of the hostname to force IPv4 protocol $fileUrl = 'http://' . gethostbyname('repo.packagist.org') . substr($fileUrl, 20); $degradedPackagist = true; } $maxFileSize = null; if (isset($options['max_file_size'])) { $maxFileSize = $options['max_file_size']; unset($options['max_file_size']); } $ctx = StreamContextFactory::getContext($fileUrl, $options, array('notification' => array($this, 'callbackGet'))); $proxy = $this->proxyManager->getProxyForRequest($fileUrl); $usingProxy = $proxy->getFormattedUrl(' using proxy (%s)'); $this->io->writeError((strpos($origFileUrl, 'http') === 0 ? 'Downloading ' : 'Reading ') . Url::sanitize($origFileUrl) . $usingProxy, true, IOInterface::DEBUG); unset($origFileUrl, $proxy, $usingProxy); // Check for secure HTTP, but allow insecure Packagist calls to $hashed providers as file integrity is verified with sha256 if ((!Preg::isMatch('{^http://(repo\.)?packagist\.org/p/}', $fileUrl) || (false === strpos($fileUrl, '$') && false === strpos($fileUrl, '%24'))) && empty($degradedPackagist)) { $this->config->prohibitUrlByConfig($fileUrl, $this->io); } if ($this->progress && !$isRedirect) { $this->io->writeError("Downloading (connecting...)", false); } $errorMessage = ''; $errorCode = 0; $result = false; set_error_handler(function ($code, $msg) use (&$errorMessage) { if ($errorMessage) { $errorMessage .= "\n"; } $errorMessage .= Preg::replace('{^file_get_contents$.*?$: }', '', $msg); return true; }); $http_response_header = array(); try { $result = $this->getRemoteContents($originUrl, $fileUrl, $ctx, $http_response_header, $maxFileSize); if (!empty($http_response_header[0])) { $statusCode = self::findStatusCode($http_response_header); if ($statusCode >= 400 && Response::findHeaderValue($http_response_header, 'content-type') === 'application/json') { HttpDownloader::outputWarnings($this->io, $originUrl, json_decode($result, true)); } if (in_array($statusCode, array(401, 403)) && $retryAuthFailure) { $this->promptAuthAndRetry($statusCode, $this->findStatusMessage($http_response_header), $http_response_header); } } $contentLength = !empty($http_response_header[0]) ? Response::findHeaderValue($http_response_header, 'content-length') : null; if ($contentLength && Platform::strlen($result) < $contentLength) { // alas, this is not possible via the stream callback because STREAM_NOTIFY_COMPLETED is documented, but not implemented anywhere in PHP $e = new TransportException('Content-Length mismatch, received '.Platform::strlen($result).' bytes out of the expected '.$contentLength); $e->setHeaders($http_response_header); $e->setStatusCode(self::findStatusCode($http_response_header)); try { $e->setResponse($this->decodeResult($result, $http_response_header)); } catch (\Exception $discarded) { $e->setResponse($this->normalizeResult($result)); } $this->io->writeError('Content-Length mismatch, received '.Platform::strlen($result).' out of '.$contentLength.' bytes: (' . base64_encode($result).')', true, IOInterface::DEBUG); throw $e; } if (PHP_VERSION_ID < 50600 && !empty($options['ssl']['peer_fingerprint'])) { // Emulate fingerprint validation on PHP < 5.6 $params = stream_context_get_params($ctx); $expectedPeerFingerprint = $options['ssl']['peer_fingerprint']; $peerFingerprint = TlsHelper::getCertificateFingerprint($params['options']['ssl']['peer_certificate']); // Constant time compare??! if ($expectedPeerFingerprint !== $peerFingerprint) { throw new TransportException('Peer fingerprint did not match'); } } } catch (\Exception $e) { if ($e instanceof TransportException && !empty($http_response_header[0])) { $e->setHeaders($http_response_header); $e->setStatusCode(self::findStatusCode($http_response_header)); } if ($e instanceof TransportException && $result !== false) { $e->setResponse($this->decodeResult($result, $http_response_header)); } $result = false; } if ($errorMessage && !filter_var(ini_get('allow_url_fopen'), FILTER_VALIDATE_BOOLEAN)) { $errorMessage = 'allow_url_fopen must be enabled in php.ini ('.$errorMessage.')'; } restore_error_handler(); if (isset($e) && !$this->retry) { if (!$this->degradedMode && false !== strpos($e->getMessage(), 'Operation timed out')) { $this->degradedMode = true; $this->io->writeError(''); $this->io->writeError(array( ''.$e->getMessage().'', 'Retrying with degraded mode, check https://getcomposer.org/doc/articles/troubleshooting.md#degraded-mode for more info', )); return $this->get($this->originUrl, $this->fileUrl, $additionalOptions, $this->fileName, $this->progress); } throw $e; } $statusCode = null; $contentType = null; $locationHeader = null; if (!empty($http_response_header[0])) { $statusCode = self::findStatusCode($http_response_header); $contentType = Response::findHeaderValue($http_response_header, 'content-type'); $locationHeader = Response::findHeaderValue($http_response_header, 'location'); } // check for bitbucket login page asking to authenticate if ($originUrl === 'bitbucket.org' && !$this->authHelper->isPublicBitBucketDownload($fileUrl) && substr($fileUrl, -4) === '.zip' && (!$locationHeader || substr(parse_url($locationHeader, PHP_URL_PATH), -4) !== '.zip') && $contentType && Preg::isMatch('{^text/html\b}i', $contentType) ) { $result = false; if ($retryAuthFailure) { $this->promptAuthAndRetry(401); } } // check for gitlab 404 when downloading archives if ($statusCode === 404 && in_array($originUrl, $this->config->get('gitlab-domains'), true) && false !== strpos($fileUrl, 'archive.zip') ) { $result = false; if ($retryAuthFailure) { $this->promptAuthAndRetry(401); } } // handle 3xx redirects, 304 Not Modified is excluded $hasFollowedRedirect = false; if ($statusCode >= 300 && $statusCode <= 399 && $statusCode !== 304 && $this->redirects < $this->maxRedirects) { $hasFollowedRedirect = true; $result = $this->handleRedirect($http_response_header, $additionalOptions, $result); } // fail 4xx and 5xx responses and capture the response if ($statusCode && $statusCode >= 400 && $statusCode <= 599) { if (!$this->retry) { if ($this->progress && !$isRedirect) { $this->io->overwriteError("Downloading (failed)", false); } $e = new TransportException('The "'.$this->fileUrl.'" file could not be downloaded ('.$http_response_header[0].')', $statusCode); $e->setHeaders($http_response_header); $e->setResponse($this->decodeResult($result, $http_response_header)); $e->setStatusCode($statusCode); throw $e; } $result = false; } if ($this->progress && !$this->retry && !$isRedirect) { $this->io->overwriteError("Downloading (".($result === false ? 'failed' : '100%').")", false); } // decode gzip if ($result && extension_loaded('zlib') && strpos($fileUrl, 'http') === 0 && !$hasFollowedRedirect) { try { $result = $this->decodeResult($result, $http_response_header); } catch (\Exception $e) { if ($this->degradedMode) { throw $e; } $this->degradedMode = true; $this->io->writeError(array( '', 'Failed to decode response: '.$e->getMessage().'', 'Retrying with degraded mode, check https://getcomposer.org/doc/articles/troubleshooting.md#degraded-mode for more info', )); return $this->get($this->originUrl, $this->fileUrl, $additionalOptions, $this->fileName, $this->progress); } } // handle copy command if download was successful if (false !== $result && null !== $fileName && !$isRedirect) { if ('' === $result) { throw new TransportException('"'.$this->fileUrl.'" appears broken, and returned an empty 200 response'); } $errorMessage = ''; set_error_handler(function ($code, $msg) use (&$errorMessage) { if ($errorMessage) { $errorMessage .= "\n"; } $errorMessage .= Preg::replace('{^file_put_contents$.*?$: }', '', $msg); return true; }); $result = (bool) file_put_contents($fileName, $result); restore_error_handler(); if (false === $result) { throw new TransportException('The "'.$this->fileUrl.'" file could not be written to '.$fileName.': '.$errorMessage); } } // Handle SSL cert match issues if (false === $result && false !== strpos($errorMessage, 'Peer certificate') && PHP_VERSION_ID < 50600) { // Certificate name error, PHP doesn't support subjectAltName on PHP < 5.6 // The procedure to handle sAN for older PHP's is: // // 1. Open socket to remote server and fetch certificate (disabling peer // validation because PHP errors without giving up the certificate.) // // 2. Verifying the domain in the URL against the names in the sAN field. // If there is a match record the authority [host/port], certificate // common name, and certificate fingerprint. // // 3. Retry the original request but changing the CN_match parameter to // the common name extracted from the certificate in step 2. // // 4. To prevent any attempt at being hoodwinked by switching the // certificate between steps 2 and 3 the fingerprint of the certificate // presented in step 3 is compared against the one recorded in step 2. if (CaBundle::isOpensslParseSafe()) { $certDetails = $this->getCertificateCnAndFp($this->fileUrl, $options); if ($certDetails) { $this->peerCertificateMap[$this->getUrlAuthority($this->fileUrl)] = $certDetails; $this->retry = true; } } else { $this->io->writeError(''); $this->io->writeError(sprintf( 'Your version of PHP, %s, is affected by CVE-2013-6420 and cannot safely perform certificate validation, we strongly suggest you upgrade.', PHP_VERSION )); } } if ($this->retry) { $this->retry = false; $result = $this->get($this->originUrl, $this->fileUrl, $additionalOptions, $this->fileName, $this->progress); if ($this->storeAuth) { $this->authHelper->storeAuth($this->originUrl, $this->storeAuth); $this->storeAuth = false; } return $result; } if (false === $result) { $e = new TransportException('The "'.$this->fileUrl.'" file could not be downloaded: '.$errorMessage, $errorCode); if (!empty($http_response_header[0])) { $e->setHeaders($http_response_header); } if (!$this->degradedMode && false !== strpos($e->getMessage(), 'Operation timed out')) { $this->degradedMode = true; $this->io->writeError(''); $this->io->writeError(array( ''.$e->getMessage().'', 'Retrying with degraded mode, check https://getcomposer.org/doc/articles/troubleshooting.md#degraded-mode for more info', )); return $this->get($this->originUrl, $this->fileUrl, $additionalOptions, $this->fileName, $this->progress); } throw $e; } if (!empty($http_response_header[0])) { $this->lastHeaders = $http_response_header; } return $result; } /** * Get contents of remote URL. * * @param string $originUrl The origin URL * @param string $fileUrl The file URL * @param resource $context The stream context * @param string[] $responseHeaders * @param int $maxFileSize The maximum allowed file size * * @return string|false The response contents or false on failure */ protected function getRemoteContents($originUrl, $fileUrl, $context, array &$responseHeaders = null, $maxFileSize = null) { $result = false; try { $e = null; if ($maxFileSize !== null) { $result = file_get_contents($fileUrl, false, $context, 0, $maxFileSize); } else { // passing `null` to file_get_contents will convert `null` to `0` and return 0 bytes $result = file_get_contents($fileUrl, false, $context); } } catch (\Exception $e) { } catch (\Throwable $e) { } if ($maxFileSize !== null && Platform::strlen($result) >= $maxFileSize) { throw new MaxFileSizeExceededException('Maximum allowed download size reached. Downloaded ' . Platform::strlen($result) . ' of allowed ' . $maxFileSize . ' bytes'); } // https://www.php.net/manual/en/reserved.variables.httpresponseheader.php $responseHeaders = isset($http_response_header) ? $http_response_header : array(); if (null !== $e) { throw $e; } return $result; } /** * Get notification action. * * @param int $notificationCode The notification code * @param int $severity The severity level * @param string $message The message * @param int $messageCode The message code * @param int $bytesTransferred The loaded size * @param int $bytesMax The total size * * @return void * * @throws TransportException */ protected function callbackGet($notificationCode, $severity, $message, $messageCode, $bytesTransferred, $bytesMax) { switch ($notificationCode) { case STREAM_NOTIFY_FAILURE: if (400 === $messageCode) { // This might happen if your host is secured by ssl client certificate authentication // but you do not send an appropriate certificate throw new TransportException("The '" . $this->fileUrl . "' URL could not be accessed: " . $message, $messageCode); } break; case STREAM_NOTIFY_FILE_SIZE_IS: $this->bytesMax = $bytesMax; break; case STREAM_NOTIFY_PROGRESS: if ($this->bytesMax > 0 && $this->progress) { $progression = min(100, (int) round($bytesTransferred / $this->bytesMax * 100)); if ((0 === $progression % 5) && 100 !== $progression && $progression !== $this->lastProgress) { $this->lastProgress = $progression; $this->io->overwriteError("Downloading ($progression%)", false); } } break; default: break; } } /** * @param positive-int $httpStatus * @param string|null $reason * @param string[] $headers * * @return void */ protected function promptAuthAndRetry($httpStatus, $reason = null, $headers = array()) { $result = $this->authHelper->promptAuthIfNeeded($this->fileUrl, $this->originUrl, $httpStatus, $reason, $headers, 1 /** always pass 1 as RemoteFilesystem is single threaded there is no race condition possible */); $this->storeAuth = $result['storeAuth']; $this->retry = $result['retry']; if ($this->retry) { throw new TransportException('RETRY'); } } /** * @param string $originUrl * @param mixed[] $additionalOptions * * @return mixed[] */ protected function getOptionsForUrl($originUrl, $additionalOptions) { $tlsOptions = array(); // Setup remaining TLS options - the matching may need monitoring, esp. www vs none in CN if ($this->disableTls === false && PHP_VERSION_ID < 50600 && !stream_is_local($this->fileUrl)) { $host = parse_url($this->fileUrl, PHP_URL_HOST); if (PHP_VERSION_ID < 50304) { // PHP < 5.3.4 does not support follow_location, for those people // do some really nasty hard coded transformations. These will // still breakdown if the site redirects to a domain we don't // expect. if ($host === 'github.com' || $host === 'api.github.com') { $host = '*.github.com'; } } $tlsOptions['ssl']['CN_match'] = $host; $tlsOptions['ssl']['SNI_server_name'] = $host; $urlAuthority = $this->getUrlAuthority($this->fileUrl); if (isset($this->peerCertificateMap[$urlAuthority])) { // Handle subjectAltName on lesser PHP's. $certMap = $this->peerCertificateMap[$urlAuthority]; $this->io->writeError('', true, IOInterface::DEBUG); $this->io->writeError(sprintf( 'Using %s as CN for subjectAltName enabled host %s', $certMap['cn'], $urlAuthority ), true, IOInterface::DEBUG); $tlsOptions['ssl']['CN_match'] = $certMap['cn']; $tlsOptions['ssl']['peer_fingerprint'] = $certMap['fp']; } elseif (!CaBundle::isOpensslParseSafe() && $host === 'repo.packagist.org') { // handle subjectAltName for packagist.org's repo domain on very old PHPs $tlsOptions['ssl']['CN_match'] = 'packagist.org'; } } $headers = array(); if (extension_loaded('zlib')) { $headers[] = 'Accept-Encoding: gzip'; } $options = array_replace_recursive($this->options, $tlsOptions, $additionalOptions); if (!$this->degradedMode) { // degraded mode disables HTTP/1.1 which causes issues with some bad // proxies/software due to the use of chunked encoding $options['http']['protocol_version'] = 1.1; $headers[] = 'Connection: close'; } $headers = $this->authHelper->addAuthenticationHeader($headers, $originUrl, $this->fileUrl); $options['http']['follow_location'] = 0; if (isset($options['http']['header']) && !is_array($options['http']['header'])) { $options['http']['header'] = explode("\r\n", trim($options['http']['header'], "\r\n")); } foreach ($headers as $header) { $options['http']['header'][] = $header; } return $options; } /** * @param string[] $http_response_header * @param mixed[] $additionalOptions * @param string|false $result * * @return bool|string */ private function handleRedirect(array $http_response_header, array $additionalOptions, $result) { if ($locationHeader = Response::findHeaderValue($http_response_header, 'location')) { if (parse_url($locationHeader, PHP_URL_SCHEME)) { // Absolute URL; e.g. https://example.com/composer $targetUrl = $locationHeader; } elseif (parse_url($locationHeader, PHP_URL_HOST)) { // Scheme relative; e.g. //example.com/foo $targetUrl = $this->scheme.':'.$locationHeader; } elseif ('/' === $locationHeader[0]) { // Absolute path; e.g. /foo $urlHost = parse_url($this->fileUrl, PHP_URL_HOST); // Replace path using hostname as an anchor. $targetUrl = Preg::replace('{^(.+(?://|@)'.preg_quote($urlHost).'(?::\d+)?)(?:[/\?].*)?$}', '\1'.$locationHeader, $this->fileUrl); } else { // Relative path; e.g. foo // This actually differs from PHP which seems to add duplicate slashes. $targetUrl = Preg::replace('{^(.+/)[^/?]*(?:\?.*)?$}', '\1'.$locationHeader, $this->fileUrl); } } if (!empty($targetUrl)) { $this->redirects++; $this->io->writeError('', true, IOInterface::DEBUG); $this->io->writeError(sprintf('Following redirect (%u) %s', $this->redirects, Url::sanitize($targetUrl)), true, IOInterface::DEBUG); $additionalOptions['redirects'] = $this->redirects; return $this->get(parse_url($targetUrl, PHP_URL_HOST), $targetUrl, $additionalOptions, $this->fileName, $this->progress); } if (!$this->retry) { $e = new TransportException('The "'.$this->fileUrl.'" file could not be downloaded, got redirect without Location ('.$http_response_header[0].')'); $e->setHeaders($http_response_header); $e->setResponse($this->decodeResult($result, $http_response_header)); throw $e; } return false; } /** * Fetch certificate common name and fingerprint for validation of SAN. * * @todo Remove when PHP 5.6 is minimum supported version. * * @param string $url * @param mixed[] $options * * @return ?array{cn: string, fp: string} */ private function getCertificateCnAndFp($url, $options) { if (PHP_VERSION_ID >= 50600) { throw new \BadMethodCallException(sprintf( '%s must not be used on PHP >= 5.6', __METHOD__ )); } $context = StreamContextFactory::getContext($url, $options, array('options' => array( 'ssl' => array( 'capture_peer_cert' => true, 'verify_peer' => false, // Yes this is fucking insane! But PHP is lame. ), ), )); // Ideally this would just use stream_socket_client() to avoid sending a // HTTP request but that does not capture the certificate. if (false === $handle = @fopen($url, 'rb', false, $context)) { return null; } // Close non authenticated connection without reading any content. fclose($handle); $handle = null; $params = stream_context_get_params($context); if (!empty($params['options']['ssl']['peer_certificate'])) { $peerCertificate = $params['options']['ssl']['peer_certificate']; if (TlsHelper::checkCertificateHost($peerCertificate, parse_url($url, PHP_URL_HOST), $commonName)) { return array( 'cn' => $commonName, 'fp' => TlsHelper::getCertificateFingerprint($peerCertificate), ); } } return null; } /** * @param string $url * * @return string */ private function getUrlAuthority($url) { $defaultPorts = array( 'ftp' => 21, 'http' => 80, 'https' => 443, 'ssh2.sftp' => 22, 'ssh2.scp' => 22, ); $scheme = parse_url($url, PHP_URL_SCHEME); if (!isset($defaultPorts[$scheme])) { throw new \InvalidArgumentException(sprintf( 'Could not get default port for unknown scheme: %s', $scheme )); } $defaultPort = $defaultPorts[$scheme]; $port = parse_url($url, PHP_URL_PORT) ?: $defaultPort; return parse_url($url, PHP_URL_HOST).':'.$port; } /** * @param string|false $result * @param string[] $http_response_header * * @return string|null */ private function decodeResult($result, $http_response_header) { // decode gzip if ($result && extension_loaded('zlib')) { $contentEncoding = Response::findHeaderValue($http_response_header, 'content-encoding'); $decode = $contentEncoding && 'gzip' === strtolower($contentEncoding); if ($decode) { if (PHP_VERSION_ID >= 50400) { $result = zlib_decode($result); } else { // work around issue with gzuncompress & co that do not work with all gzip checksums $result = file_get_contents('compress.zlib://data:application/octet-stream;base64,'.base64_encode($result)); } if ($result === false) { throw new TransportException('Failed to decode zlib stream'); } } } return $this->normalizeResult($result); } /** * @param string|false $result * * @return string|null */ private function normalizeResult($result) { if ($result === false) { return null; } return $result; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\XdebugHandler\XdebugHandler; /** * Provides ini file location functions that work with and without a restart. * When the process has restarted it uses a tmp ini and stores the original * ini locations in an environment variable. * * @author John Stevenson */ class IniHelper { /** * Returns an array of php.ini locations with at least one entry * * The equivalent of calling php_ini_loaded_file then php_ini_scanned_files. * The loaded ini location is the first entry and may be empty. * * @return string[] */ public static function getAll() { return XdebugHandler::getAllIniFiles(); } /** * Describes the location of the loaded php.ini file(s) * * @return string */ public static function getMessage() { $paths = self::getAll(); if (empty($paths[0])) { array_shift($paths); } $ini = array_shift($paths); if (empty($ini)) { return 'A php.ini file does not exist. You will have to create one.'; } if (!empty($paths)) { return 'Your command-line PHP is using multiple ini files. Run `php --ini` to show them.'; } return 'The php.ini used by your command-line PHP is: '.$ini; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; @trigger_error('Composer\Util\MetadataMinifier is deprecated, use Composer\MetadataMinifier\MetadataMinifier from composer/metadata-minifier instead.', E_USER_DEPRECATED); /** * @deprecated Use Composer\MetadataMinifier\MetadataMinifier instead */ class MetadataMinifier extends \Composer\MetadataMinifier\MetadataMinifier { } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Pcre\Preg; /** * Platform helper for uniform platform-specific tests. * * @author Niels Keurentjes */ class Platform { /** @var ?bool */ private static $isVirtualBoxGuest = null; /** @var ?bool */ private static $isWindowsSubsystemForLinux = null; /** * getenv() equivalent but reads from the runtime global variables first * * @param string $name * @return string|false */ public static function getEnv($name) { if (array_key_exists($name, $_SERVER)) { return (string) $_SERVER[$name]; } if (array_key_exists($name, $_ENV)) { return (string) $_ENV[$name]; } return getenv($name); } /** * putenv() equivalent but updates the runtime global variables too * * @param string $name * @param string $value * @return void */ public static function putEnv($name, $value) { $value = (string) $value; putenv($name . '=' . $value); $_SERVER[$name] = $_ENV[$name] = $value; } /** * putenv('X') equivalent but updates the runtime global variables too * * @param string $name * @return void */ public static function clearEnv($name) { putenv($name); unset($_SERVER[$name], $_ENV[$name]); } /** * Parses tildes and environment variables in paths. * * @param string $path * @return string */ public static function expandPath($path) { if (Preg::isMatch('#^~[\\/]#', $path)) { return self::getUserDirectory() . substr($path, 1); } return Preg::replaceCallback('#^(\$|(?P%))(?P\w++)(?(percent)%)(?P.*)#', function ($matches) { // Treat HOME as an alias for USERPROFILE on Windows for legacy reasons if (Platform::isWindows() && $matches['var'] == 'HOME') { return (Platform::getEnv('HOME') ?: Platform::getEnv('USERPROFILE')) . $matches['path']; } return Platform::getEnv($matches['var']) . $matches['path']; }, $path); } /** * @throws \RuntimeException If the user home could not reliably be determined * @return string The formal user home as detected from environment parameters */ public static function getUserDirectory() { if (false !== ($home = self::getEnv('HOME'))) { return $home; } if (self::isWindows() && false !== ($home = self::getEnv('USERPROFILE'))) { return $home; } if (\function_exists('posix_getuid') && \function_exists('posix_getpwuid')) { $info = posix_getpwuid(posix_getuid()); return $info['dir']; } throw new \RuntimeException('Could not determine user directory'); } /** * @return bool Whether the host machine is running on the Windows Subsystem for Linux (WSL) */ public static function isWindowsSubsystemForLinux() { if (null === self::$isWindowsSubsystemForLinux) { self::$isWindowsSubsystemForLinux = false; // while WSL will be hosted within windows, WSL itself cannot be windows based itself. if (self::isWindows()) { return self::$isWindowsSubsystemForLinux = false; } if ( !ini_get('open_basedir') && is_readable('/proc/version') && false !== stripos(Silencer::call('file_get_contents', '/proc/version'), 'microsoft') && !file_exists('/.dockerenv') // docker running inside WSL should not be seen as WSL ) { return self::$isWindowsSubsystemForLinux = true; } } return self::$isWindowsSubsystemForLinux; } /** * @return bool Whether the host machine is running a Windows OS */ public static function isWindows() { return \defined('PHP_WINDOWS_VERSION_BUILD'); } /** * @param string $str * @return int return a guaranteed binary length of the string, regardless of silly mbstring configs */ public static function strlen($str) { static $useMbString = null; if (null === $useMbString) { $useMbString = \function_exists('mb_strlen') && ini_get('mbstring.func_overload'); } if ($useMbString) { return mb_strlen($str, '8bit'); } return \strlen($str); } /** * @param ?resource $fd Open file descriptor or null to default to STDOUT * @return bool */ public static function isTty($fd = null) { if ($fd === null) { $fd = defined('STDOUT') ? STDOUT : fopen('php://stdout', 'w'); } // detect msysgit/mingw and assume this is a tty because detection // does not work correctly, see https://github.com/composer/composer/issues/9690 if (in_array(strtoupper(self::getEnv('MSYSTEM') ?: ''), array('MINGW32', 'MINGW64'), true)) { return true; } // modern cross-platform function, includes the fstat // fallback so if it is present we trust it if (function_exists('stream_isatty')) { return stream_isatty($fd); } // only trusting this if it is positive, otherwise prefer fstat fallback if (function_exists('posix_isatty') && posix_isatty($fd)) { return true; } $stat = @fstat($fd); // Check if formatted mode is S_IFCHR return $stat ? 0020000 === ($stat['mode'] & 0170000) : false; } /** * @return void */ public static function workaroundFilesystemIssues() { if (self::isVirtualBoxGuest()) { usleep(200000); } } /** * Attempts detection of VirtualBox guest VMs * * This works based on the process' user being "vagrant", the COMPOSER_RUNTIME_ENV env var being set to "virtualbox", or lsmod showing the virtualbox guest additions are loaded * * @return bool */ private static function isVirtualBoxGuest() { if (null === self::$isVirtualBoxGuest) { self::$isVirtualBoxGuest = false; if (self::isWindows()) { return self::$isVirtualBoxGuest; } if (function_exists('posix_getpwuid') && function_exists('posix_geteuid')) { $processUser = posix_getpwuid(posix_geteuid()); if ($processUser && $processUser['name'] === 'vagrant') { return self::$isVirtualBoxGuest = true; } } if (self::getEnv('COMPOSER_RUNTIME_ENV') === 'virtualbox') { return self::$isVirtualBoxGuest = true; } if (defined('PHP_OS_FAMILY') && PHP_OS_FAMILY === 'Linux') { $process = new ProcessExecutor(); try { if (0 === $process->execute('lsmod | grep vboxguest', $ignoredOutput)) { return self::$isVirtualBoxGuest = true; } } catch (\Exception $e) { // noop } } } return self::$isVirtualBoxGuest; } /** * @return 'NUL'|'/dev/null' */ public static function getDevNull() { if (self::isWindows()) { return 'NUL'; } return '/dev/null'; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\IO\IOInterface; use Composer\Config; use Composer\Factory; use Composer\Downloader\TransportException; use Composer\Pcre\Preg; /** * @author Roshan Gautam */ class GitLab { /** @var IOInterface */ protected $io; /** @var Config */ protected $config; /** @var ProcessExecutor */ protected $process; /** @var HttpDownloader */ protected $httpDownloader; /** * Constructor. * * @param IOInterface $io The IO instance * @param Config $config The composer configuration * @param ProcessExecutor $process Process instance, injectable for mocking * @param HttpDownloader $httpDownloader Remote Filesystem, injectable for mocking */ public function __construct(IOInterface $io, Config $config, ProcessExecutor $process = null, HttpDownloader $httpDownloader = null) { $this->io = $io; $this->config = $config; $this->process = $process ?: new ProcessExecutor($io); $this->httpDownloader = $httpDownloader ?: Factory::createHttpDownloader($this->io, $config); } /** * Attempts to authorize a GitLab domain via OAuth. * * @param string $originUrl The host this GitLab instance is located at * * @return bool true on success */ public function authorizeOAuth($originUrl) { // before composer 1.9, origin URLs had no port number in them $bcOriginUrl = Preg::replace('{:\d+}', '', $originUrl); if (!in_array($originUrl, $this->config->get('gitlab-domains'), true) && !in_array($bcOriginUrl, $this->config->get('gitlab-domains'), true)) { return false; } // if available use token from git config if (0 === $this->process->execute('git config gitlab.accesstoken', $output)) { $this->io->setAuthentication($originUrl, trim($output), 'oauth2'); return true; } // if available use deploy token from git config if (0 === $this->process->execute('git config gitlab.deploytoken.user', $tokenUser) && 0 === $this->process->execute('git config gitlab.deploytoken.token', $tokenPassword)) { $this->io->setAuthentication($originUrl, trim($tokenUser), trim($tokenPassword)); return true; } // if available use token from composer config $authTokens = $this->config->get('gitlab-token'); if (isset($authTokens[$originUrl])) { $token = $authTokens[$originUrl]; } if (isset($authTokens[$bcOriginUrl])) { $token = $authTokens[$bcOriginUrl]; } if (isset($token)) { $username = is_array($token) && array_key_exists("username", $token) ? $token["username"] : $token; $password = is_array($token) && array_key_exists("token", $token) ? $token["token"] : 'private-token'; // Composer expects the GitLab token to be stored as username and 'private-token' or 'gitlab-ci-token' to be stored as password // Detect cases where this is reversed and resolve automatically resolve it if (in_array($username, array('private-token', 'gitlab-ci-token', 'oauth2'), true)) { $this->io->setAuthentication($originUrl, $password, $username); } else { $this->io->setAuthentication($originUrl, $username, $password); } return true; } return false; } /** * Authorizes a GitLab domain interactively via OAuth. * * @param string $scheme Scheme used in the origin URL * @param string $originUrl The host this GitLab instance is located at * @param string $message The reason this authorization is required * * @throws \RuntimeException * @throws TransportException|\Exception * * @return bool true on success */ public function authorizeOAuthInteractively($scheme, $originUrl, $message = null) { if ($message) { $this->io->writeError($message); } $this->io->writeError(sprintf('A token will be created and stored in "%s", your password will never be stored', $this->config->getAuthConfigSource()->getName())); $this->io->writeError('To revoke access to this token you can visit '.$scheme.'://'.$originUrl.'/-/profile/personal_access_tokens'); $attemptCounter = 0; while ($attemptCounter++ < 5) { try { $response = $this->createToken($scheme, $originUrl); } catch (TransportException $e) { // 401 is bad credentials, // 403 is max login attempts exceeded if (in_array($e->getCode(), array(403, 401))) { if (401 === $e->getCode()) { $response = json_decode($e->getResponse(), true); if (isset($response['error']) && $response['error'] === 'invalid_grant') { $this->io->writeError('Bad credentials. If you have two factor authentication enabled you will have to manually create a personal access token'); } else { $this->io->writeError('Bad credentials.'); } } else { $this->io->writeError('Maximum number of login attempts exceeded. Please try again later.'); } $this->io->writeError('You can also manually create a personal access token enabling the "read_api" scope at '.$scheme.'://'.$originUrl.'/profile/personal_access_tokens'); $this->io->writeError('Add it using "composer config --global --auth gitlab-token.'.$originUrl.' "'); continue; } throw $e; } $this->io->setAuthentication($originUrl, $response['access_token'], 'oauth2'); // store value in user config in auth file $this->config->getAuthConfigSource()->addConfigSetting('gitlab-oauth.'.$originUrl, $response['access_token']); return true; } throw new \RuntimeException('Invalid GitLab credentials 5 times in a row, aborting.'); } /** * @param string $scheme * @param string $originUrl * * @return array{access_token: non-empty-string, token_type: non-empty-string, expires_in: positive-int} * * @see https://docs.gitlab.com/ee/api/oauth2.html#resource-owner-password-credentials-flow */ private function createToken($scheme, $originUrl) { $username = $this->io->ask('Username: '); $password = $this->io->askAndHideAnswer('Password: '); $headers = array('Content-Type: application/x-www-form-urlencoded'); $apiUrl = $originUrl; $data = http_build_query(array( 'username' => $username, 'password' => $password, 'grant_type' => 'password', ), '', '&'); $options = array( 'retry-auth-failure' => false, 'http' => array( 'method' => 'POST', 'header' => $headers, 'content' => $data, ), ); $token = $this->httpDownloader->get($scheme.'://'.$apiUrl.'/oauth/token', $options)->decodeJson(); $this->io->writeError('Token successfully created'); return $token; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Util; use Composer\Composer; use Composer\CaBundle\CaBundle; use Composer\Downloader\TransportException; use Composer\Repository\PlatformRepository; use Composer\Util\Http\ProxyManager; use Psr\Log\LoggerInterface; /** * Allows the creation of a basic context supporting http proxy * * @author Jordan Alliot * @author Markus Tacker */ final class StreamContextFactory { /** * Creates a context supporting HTTP proxies * * @param string $url URL the context is to be used for * @phpstan-param array{http?: array{follow_location?: int, max_redirects?: int, header?: string|array}} $defaultOptions * @param mixed[] $defaultOptions Options to merge with the default * @param mixed[] $defaultParams Parameters to specify on the context * @throws \RuntimeException if https proxy required and OpenSSL uninstalled * @return resource Default context */ public static function getContext($url, array $defaultOptions = array(), array $defaultParams = array()) { $options = array('http' => array( // specify defaults again to try and work better with curlwrappers enabled 'follow_location' => 1, 'max_redirects' => 20, )); $options = array_replace_recursive($options, self::initOptions($url, $defaultOptions)); unset($defaultOptions['http']['header']); $options = array_replace_recursive($options, $defaultOptions); if (isset($options['http']['header'])) { $options['http']['header'] = self::fixHttpHeaderField($options['http']['header']); } return stream_context_create($options, $defaultParams); } /** * @param string $url * @param mixed[] $options * @param bool $forCurl When true, will not add proxy values as these are handled separately * @phpstan-return array{http: array{header: string[], proxy?: string, request_fulluri: bool}, ssl?: mixed[]} * @return array formatted as a stream context array */ public static function initOptions($url, array $options, $forCurl = false) { // Make sure the headers are in an array form if (!isset($options['http']['header'])) { $options['http']['header'] = array(); } if (is_string($options['http']['header'])) { $options['http']['header'] = explode("\r\n", $options['http']['header']); } // Add stream proxy options if there is a proxy if (!$forCurl) { $proxy = ProxyManager::getInstance()->getProxyForRequest($url); if ($proxyOptions = $proxy->getContextOptions()) { $isHttpsRequest = 0 === strpos($url, 'https://'); if ($proxy->isSecure()) { if (!extension_loaded('openssl')) { throw new TransportException('You must enable the openssl extension to use a secure proxy.'); } if ($isHttpsRequest) { throw new TransportException('You must enable the curl extension to make https requests through a secure proxy.'); } } elseif ($isHttpsRequest && !extension_loaded('openssl')) { throw new TransportException('You must enable the openssl extension to make https requests through a proxy.'); } // Header will be a Proxy-Authorization string or not set if (isset($proxyOptions['http']['header'])) { $options['http']['header'][] = $proxyOptions['http']['header']; unset($proxyOptions['http']['header']); } $options = array_replace_recursive($options, $proxyOptions); } } if (defined('HHVM_VERSION')) { $phpVersion = 'HHVM ' . HHVM_VERSION; } else { $phpVersion = 'PHP ' . PHP_MAJOR_VERSION . '.' . PHP_MINOR_VERSION . '.' . PHP_RELEASE_VERSION; } if ($forCurl) { $curl = curl_version(); $httpVersion = 'cURL '.$curl['version']; } else { $httpVersion = 'streams'; } if (!isset($options['http']['header']) || false === stripos(implode('', $options['http']['header']), 'user-agent')) { $platformPhpVersion = PlatformRepository::getPlatformPhpVersion(); $options['http']['header'][] = sprintf( 'User-Agent: Composer/%s (%s; %s; %s; %s%s%s)', Composer::getVersion(), function_exists('php_uname') ? php_uname('s') : 'Unknown', function_exists('php_uname') ? php_uname('r') : 'Unknown', $phpVersion, $httpVersion, $platformPhpVersion ? '; Platform-PHP '.$platformPhpVersion : '', Platform::getEnv('CI') ? '; CI' : '' ); } return $options; } /** * @param mixed[] $options * * @return mixed[] */ public static function getTlsDefaults(array $options, LoggerInterface $logger = null) { $ciphers = implode(':', array( 'ECDHE-RSA-AES128-GCM-SHA256', 'ECDHE-ECDSA-AES128-GCM-SHA256', 'ECDHE-RSA-AES256-GCM-SHA384', 'ECDHE-ECDSA-AES256-GCM-SHA384', 'DHE-RSA-AES128-GCM-SHA256', 'DHE-DSS-AES128-GCM-SHA256', 'kEDH+AESGCM', 'ECDHE-RSA-AES128-SHA256', 'ECDHE-ECDSA-AES128-SHA256', 'ECDHE-RSA-AES128-SHA', 'ECDHE-ECDSA-AES128-SHA', 'ECDHE-RSA-AES256-SHA384', 'ECDHE-ECDSA-AES256-SHA384', 'ECDHE-RSA-AES256-SHA', 'ECDHE-ECDSA-AES256-SHA', 'DHE-RSA-AES128-SHA256', 'DHE-RSA-AES128-SHA', 'DHE-DSS-AES128-SHA256', 'DHE-RSA-AES256-SHA256', 'DHE-DSS-AES256-SHA', 'DHE-RSA-AES256-SHA', 'AES128-GCM-SHA256', 'AES256-GCM-SHA384', 'AES128-SHA256', 'AES256-SHA256', 'AES128-SHA', 'AES256-SHA', 'AES', 'CAMELLIA', 'DES-CBC3-SHA', '!aNULL', '!eNULL', '!EXPORT', '!DES', '!RC4', '!MD5', '!PSK', '!aECDH', '!EDH-DSS-DES-CBC3-SHA', '!EDH-RSA-DES-CBC3-SHA', '!KRB5-DES-CBC3-SHA', )); /** * CN_match and SNI_server_name are only known once a URL is passed. * They will be set in the getOptionsForUrl() method which receives a URL. * * cafile or capath can be overridden by passing in those options to constructor. */ $defaults = array( 'ssl' => array( 'ciphers' => $ciphers, 'verify_peer' => true, 'verify_depth' => 7, 'SNI_enabled' => true, 'capture_peer_cert' => true, ), ); if (isset($options['ssl'])) { $defaults['ssl'] = array_replace_recursive($defaults['ssl'], $options['ssl']); } /** * Attempt to find a local cafile or throw an exception if none pre-set * The user may go download one if this occurs. */ if (!isset($defaults['ssl']['cafile']) && !isset($defaults['ssl']['capath'])) { $result = CaBundle::getSystemCaRootBundlePath($logger); if (is_dir($result)) { $defaults['ssl']['capath'] = $result; } else { $defaults['ssl']['cafile'] = $result; } } if (isset($defaults['ssl']['cafile']) && (!Filesystem::isReadable($defaults['ssl']['cafile']) || !CaBundle::validateCaFile($defaults['ssl']['cafile'], $logger))) { throw new TransportException('The configured cafile was not valid or could not be read.'); } if (isset($defaults['ssl']['capath']) && (!is_dir($defaults['ssl']['capath']) || !Filesystem::isReadable($defaults['ssl']['capath']))) { throw new TransportException('The configured capath was not valid or could not be read.'); } /** * Disable TLS compression to prevent CRIME attacks where supported. */ if (PHP_VERSION_ID >= 50413) { $defaults['ssl']['disable_compression'] = true; } return $defaults; } /** * A bug in PHP prevents the headers from correctly being sent when a content-type header is present and * NOT at the end of the array * * This method fixes the array by moving the content-type header to the end * * @link https://bugs.php.net/bug.php?id=61548 * @param string|string[] $header * @return string[] */ private static function fixHttpHeaderField($header) { if (!is_array($header)) { $header = explode("\r\n", $header); } uasort($header, function ($el) { return stripos($el, 'content-type') === 0 ? 1 : -1; }); return $header; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Exception; /** * @author Jordi Boggiano */ class IrrecoverableDownloadException extends \RuntimeException { } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Exception; /** * Specific exception for Composer\Util\HttpDownloader creation. * * @author Jordi Boggiano */ class NoSslException extends \RuntimeException { } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer; use Composer\Config\ConfigSourceInterface; use Composer\Downloader\TransportException; use Composer\IO\IOInterface; use Composer\Pcre\Preg; use Composer\Util\Platform; use Composer\Util\ProcessExecutor; /** * @author Jordi Boggiano */ class Config { const SOURCE_DEFAULT = 'default'; const SOURCE_COMMAND = 'command'; const SOURCE_UNKNOWN = 'unknown'; const RELATIVE_PATHS = 1; /** @var array */ public static $defaultConfig = array( 'process-timeout' => 300, 'use-include-path' => false, 'allow-plugins' => array(), 'use-parent-dir' => 'prompt', 'preferred-install' => 'dist', 'notify-on-install' => true, 'github-protocols' => array('https', 'ssh', 'git'), 'gitlab-protocol' => null, 'vendor-dir' => 'vendor', 'bin-dir' => '{$vendor-dir}/bin', 'cache-dir' => '{$home}/cache', 'data-dir' => '{$home}', 'cache-files-dir' => '{$cache-dir}/files', 'cache-repo-dir' => '{$cache-dir}/repo', 'cache-vcs-dir' => '{$cache-dir}/vcs', 'cache-ttl' => 15552000, // 6 months 'cache-files-ttl' => null, // fallback to cache-ttl 'cache-files-maxsize' => '300MiB', 'cache-read-only' => false, 'bin-compat' => 'auto', 'discard-changes' => false, 'autoloader-suffix' => null, 'sort-packages' => false, 'optimize-autoloader' => false, 'classmap-authoritative' => false, 'apcu-autoloader' => false, 'prepend-autoloader' => true, 'github-domains' => array('github.com'), 'bitbucket-expose-hostname' => true, 'disable-tls' => false, 'secure-http' => true, 'secure-svn-domains' => array(), 'cafile' => null, 'capath' => null, 'github-expose-hostname' => true, 'gitlab-domains' => array('gitlab.com'), 'store-auths' => 'prompt', 'platform' => array(), 'archive-format' => 'tar', 'archive-dir' => '.', 'htaccess-protect' => true, 'use-github-api' => true, 'lock' => true, 'platform-check' => 'php-only', // valid keys without defaults (auth config stuff): // bitbucket-oauth // github-oauth // gitlab-oauth // gitlab-token // http-basic // bearer ); /** @var array */ public static $defaultRepositories = array( 'packagist.org' => array( 'type' => 'composer', 'url' => 'https://repo.packagist.org', ), ); /** @var array */ private $config; /** @var ?string */ private $baseDir; /** @var array */ private $repositories; /** @var ConfigSourceInterface */ private $configSource; /** @var ConfigSourceInterface */ private $authConfigSource; /** @var bool */ private $useEnvironment; /** @var array */ private $warnedHosts = array(); /** @var array */ private $sourceOfConfigValue = array(); /** * @param bool $useEnvironment Use COMPOSER_ environment variables to replace config settings * @param string $baseDir Optional base directory of the config */ public function __construct($useEnvironment = true, $baseDir = null) { // load defaults $this->config = static::$defaultConfig; $this->repositories = static::$defaultRepositories; $this->useEnvironment = (bool) $useEnvironment; $this->baseDir = $baseDir; foreach ($this->config as $configKey => $configValue) { $this->setSourceOfConfigValue($configValue, $configKey, self::SOURCE_DEFAULT); } foreach ($this->repositories as $configKey => $configValue) { $this->setSourceOfConfigValue($configValue, 'repositories.' . $configKey, self::SOURCE_DEFAULT); } } /** * @return void */ public function setConfigSource(ConfigSourceInterface $source) { $this->configSource = $source; } /** * @return ConfigSourceInterface */ public function getConfigSource() { return $this->configSource; } /** * @return void */ public function setAuthConfigSource(ConfigSourceInterface $source) { $this->authConfigSource = $source; } /** * @return ConfigSourceInterface */ public function getAuthConfigSource() { return $this->authConfigSource; } /** * Merges new config values with the existing ones (overriding) * * @param array{config?: array, repositories?: array} $config * @param string $source * * @return void */ public function merge($config, $source = self::SOURCE_UNKNOWN) { // override defaults with given config if (!empty($config['config']) && is_array($config['config'])) { foreach ($config['config'] as $key => $val) { if (in_array($key, array('bitbucket-oauth', 'github-oauth', 'gitlab-oauth', 'gitlab-token', 'http-basic', 'bearer'), true) && isset($this->config[$key])) { $this->config[$key] = array_merge($this->config[$key], $val); $this->setSourceOfConfigValue($val, $key, $source); } elseif (in_array($key, array('allow-plugins'), true) && isset($this->config[$key]) && is_array($this->config[$key]) && is_array($val)) { // merging $val first to get the local config on top of the global one, then appending the global config, // then merging local one again to make sure the values from local win over global ones for keys present in both $this->config[$key] = array_merge($val, $this->config[$key], $val); $this->setSourceOfConfigValue($val, $key, $source); } elseif (in_array($key, array('gitlab-domains', 'github-domains'), true) && isset($this->config[$key])) { $this->config[$key] = array_unique(array_merge($this->config[$key], $val)); $this->setSourceOfConfigValue($val, $key, $source); } elseif ('preferred-install' === $key && isset($this->config[$key])) { if (is_array($val) || is_array($this->config[$key])) { if (is_string($val)) { $val = array('*' => $val); } if (is_string($this->config[$key])) { $this->config[$key] = array('*' => $this->config[$key]); $this->sourceOfConfigValue[$key . '*'] = $source; } $this->config[$key] = array_merge($this->config[$key], $val); $this->setSourceOfConfigValue($val, $key, $source); // the full match pattern needs to be last if (isset($this->config[$key]['*'])) { $wildcard = $this->config[$key]['*']; unset($this->config[$key]['*']); $this->config[$key]['*'] = $wildcard; } } else { $this->config[$key] = $val; $this->setSourceOfConfigValue($val, $key, $source); } } else { $this->config[$key] = $val; $this->setSourceOfConfigValue($val, $key, $source); } } } if (!empty($config['repositories']) && is_array($config['repositories'])) { $this->repositories = array_reverse($this->repositories, true); $newRepos = array_reverse($config['repositories'], true); foreach ($newRepos as $name => $repository) { // disable a repository by name if (false === $repository) { $this->disableRepoByName((string) $name); continue; } // disable a repository with an anonymous {"name": false} repo if (is_array($repository) && 1 === count($repository) && false === current($repository)) { $this->disableRepoByName((string) key($repository)); continue; } // auto-deactivate the default packagist.org repo if it gets redefined if (isset($repository['type'], $repository['url']) && $repository['type'] === 'composer' && Preg::isMatch('{^https?://(?:[a-z0-9-.]+\.)?packagist.org(/|$)}', $repository['url'])) { $this->disableRepoByName('packagist.org'); } // store repo if (is_int($name)) { $this->repositories[] = $repository; $this->setSourceOfConfigValue($repository, 'repositories.' . array_search($repository, $this->repositories, true), $source); } else { if ($name === 'packagist') { // BC support for default "packagist" named repo $this->repositories[$name . '.org'] = $repository; $this->setSourceOfConfigValue($repository, 'repositories.' . $name . '.org', $source); } else { $this->repositories[$name] = $repository; $this->setSourceOfConfigValue($repository, 'repositories.' . $name, $source); } } } $this->repositories = array_reverse($this->repositories, true); } } /** * @return array */ public function getRepositories() { return $this->repositories; } /** * Returns a setting * * @param string $key * @param int $flags Options (see class constants) * @throws \RuntimeException * * @return mixed */ public function get($key, $flags = 0) { switch ($key) { // strings/paths with env var and {$refs} support case 'vendor-dir': case 'bin-dir': case 'process-timeout': case 'data-dir': case 'cache-dir': case 'cache-files-dir': case 'cache-repo-dir': case 'cache-vcs-dir': case 'cafile': case 'capath': // convert foo-bar to COMPOSER_FOO_BAR and check if it exists since it overrides the local config $env = 'COMPOSER_' . strtoupper(strtr($key, '-', '_')); $val = $this->getComposerEnv($env); if ($val !== false) { $this->setSourceOfConfigValue($val, $key, $env); } $val = rtrim((string) $this->process(false !== $val ? $val : $this->config[$key], $flags), '/\\'); $val = Platform::expandPath($val); if (substr($key, -4) !== '-dir') { return $val; } return (($flags & self::RELATIVE_PATHS) == self::RELATIVE_PATHS) ? $val : $this->realpath($val); // booleans with env var support case 'cache-read-only': case 'htaccess-protect': // convert foo-bar to COMPOSER_FOO_BAR and check if it exists since it overrides the local config $env = 'COMPOSER_' . strtoupper(strtr($key, '-', '_')); $val = $this->getComposerEnv($env); if (false === $val) { $val = $this->config[$key]; } else { $this->setSourceOfConfigValue($val, $key, $env); } return $val !== 'false' && (bool) $val; // booleans without env var support case 'disable-tls': case 'secure-http': case 'use-github-api': case 'lock': // special case for secure-http if ($key === 'secure-http' && $this->get('disable-tls') === true) { return false; } return $this->config[$key] !== 'false' && (bool) $this->config[$key]; // ints without env var support case 'cache-ttl': return (int) $this->config[$key]; // numbers with kb/mb/gb support, without env var support case 'cache-files-maxsize': if (!Preg::isMatch('/^\s*([0-9.]+)\s*(?:([kmg])(?:i?b)?)?\s*$/i', $this->config[$key], $matches)) { throw new \RuntimeException( "Could not parse the value of '$key': {$this->config[$key]}" ); } $size = $matches[1]; if (isset($matches[2])) { switch (strtolower($matches[2])) { case 'g': $size *= 1024; // intentional fallthrough // no break case 'm': $size *= 1024; // intentional fallthrough // no break case 'k': $size *= 1024; break; } } return $size; // special cases below case 'cache-files-ttl': if (isset($this->config[$key])) { return (int) $this->config[$key]; } return (int) $this->config['cache-ttl']; case 'home': $val = Preg::replace('#^(\$HOME|~)(/|$)#', rtrim(Platform::getEnv('HOME') ?: Platform::getEnv('USERPROFILE'), '/\\') . '/', $this->config[$key]); return rtrim($this->process($val, $flags), '/\\'); case 'bin-compat': $value = $this->getComposerEnv('COMPOSER_BIN_COMPAT') ?: $this->config[$key]; if (!in_array($value, array('auto', 'full', 'proxy', 'symlink'))) { throw new \RuntimeException( "Invalid value for 'bin-compat': {$value}. Expected auto, full or proxy" ); } if ($value === 'symlink') { trigger_error('config.bin-compat "symlink" is deprecated since Composer 2.2, use auto, full (for Windows compatibility) or proxy instead.', E_USER_DEPRECATED); } return $value; case 'discard-changes': $env = $this->getComposerEnv('COMPOSER_DISCARD_CHANGES'); if ($env !== false) { if (!in_array($env, array('stash', 'true', 'false', '1', '0'), true)) { throw new \RuntimeException( "Invalid value for COMPOSER_DISCARD_CHANGES: {$env}. Expected 1, 0, true, false or stash" ); } if ('stash' === $env) { return 'stash'; } // convert string value to bool return $env !== 'false' && (bool) $env; } if (!in_array($this->config[$key], array(true, false, 'stash'), true)) { throw new \RuntimeException( "Invalid value for 'discard-changes': {$this->config[$key]}. Expected true, false or stash" ); } return $this->config[$key]; case 'github-protocols': $protos = $this->config['github-protocols']; if ($this->config['secure-http'] && false !== ($index = array_search('git', $protos))) { unset($protos[$index]); } if (reset($protos) === 'http') { throw new \RuntimeException('The http protocol for github is not available anymore, update your config\'s github-protocols to use "https", "git" or "ssh"'); } return $protos; case 'autoloader-suffix': if ($this->config[$key] === '') { // we need to guarantee null or non-empty-string return null; } return $this->process($this->config[$key], $flags); default: if (!isset($this->config[$key])) { return null; } return $this->process($this->config[$key], $flags); } } /** * @param int $flags * * @return array */ public function all($flags = 0) { $all = array( 'repositories' => $this->getRepositories(), ); foreach (array_keys($this->config) as $key) { $all['config'][$key] = $this->get($key, $flags); } return $all; } /** * @param string $key * @return string */ public function getSourceOfValue($key) { $this->get($key); return isset($this->sourceOfConfigValue[$key]) ? $this->sourceOfConfigValue[$key] : self::SOURCE_UNKNOWN; } /** * @param mixed $configValue * @param string $path * @param string $source * * @return void */ private function setSourceOfConfigValue($configValue, $path, $source) { $this->sourceOfConfigValue[$path] = $source; if (is_array($configValue)) { foreach ($configValue as $key => $value) { $this->setSourceOfConfigValue($value, $path . '.' . $key, $source); } } } /** * @return array */ public function raw() { return array( 'repositories' => $this->getRepositories(), 'config' => $this->config, ); } /** * Checks whether a setting exists * * @param string $key * @return bool */ public function has($key) { return array_key_exists($key, $this->config); } /** * Replaces {$refs} inside a config string * * @param string|int|null $value a config string that can contain {$refs-to-other-config} * @param int $flags Options (see class constants) * * @return string|int|null */ private function process($value, $flags) { $config = $this; if (!is_string($value)) { return $value; } return Preg::replaceCallback('#\{\$(.+)\}#', function ($match) use ($config, $flags) { return $config->get($match[1], $flags); }, $value); } /** * Turns relative paths in absolute paths without realpath() * * Since the dirs might not exist yet we can not call realpath or it will fail. * * @param string $path * @return string */ private function realpath($path) { if (Preg::isMatch('{^(?:/|[a-z]:|[a-z0-9.]+://)}i', $path)) { return $path; } return $this->baseDir ? $this->baseDir . '/' . $path : $path; } /** * Reads the value of a Composer environment variable * * This should be used to read COMPOSER_ environment variables * that overload config values. * * @param string $var * @return string|false */ private function getComposerEnv($var) { if ($this->useEnvironment) { return Platform::getEnv($var); } return false; } /** * @param string $name * * @return void */ private function disableRepoByName($name) { if (isset($this->repositories[$name])) { unset($this->repositories[$name]); } elseif ($name === 'packagist') { // BC support for default "packagist" named repo unset($this->repositories['packagist.org']); } } /** * Validates that the passed URL is allowed to be used by current config, or throws an exception. * * @param string $url * @param IOInterface $io * * @return void */ public function prohibitUrlByConfig($url, IOInterface $io = null) { // Return right away if the URL is malformed or custom (see issue #5173), but only for non-HTTP(S) URLs if (false === filter_var($url, FILTER_VALIDATE_URL) && !Preg::isMatch('{^https?://}', $url)) { return; } // Extract scheme and throw exception on known insecure protocols $scheme = parse_url($url, PHP_URL_SCHEME); $hostname = parse_url($url, PHP_URL_HOST); if (in_array($scheme, array('http', 'git', 'ftp', 'svn'))) { if ($this->get('secure-http')) { if ($scheme === 'svn') { if (in_array($hostname, $this->get('secure-svn-domains'), true)) { return; } throw new TransportException("Your configuration does not allow connections to $url. See https://getcomposer.org/doc/06-config.md#secure-svn-domains for details."); } throw new TransportException("Your configuration does not allow connections to $url. See https://getcomposer.org/doc/06-config.md#secure-http for details."); } if ($io) { $host = parse_url($url, PHP_URL_HOST); if (is_string($host)) { if (!isset($this->warnedHosts[$host])) { $io->writeError("Warning: Accessing $host over $scheme which is an insecure protocol."); } $this->warnedHosts[$host] = true; } } } } /** * Used by long-running custom scripts in composer.json * * "scripts": { * "watch": [ * "Composer\\Config::disableProcessTimeout", * "vendor/bin/long-running-script --watch" * ] * } * * @return void */ public static function disableProcessTimeout() { // Override global timeout set earlier by environment or config ProcessExecutor::setTimeout(0); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Autoload; /** * ClassLoader implements a PSR-0, PSR-4 and classmap class loader. * * $loader = new \Composer\Autoload\ClassLoader(); * * // register classes with namespaces * $loader->add('Symfony\Component', __DIR__.'/component'); * $loader->add('Symfony', __DIR__.'/framework'); * * // activate the autoloader * $loader->register(); * * // to enable searching the include path (eg. for PEAR packages) * $loader->setUseIncludePath(true); * * In this example, if you try to use a class in the Symfony\Component * namespace or one of its children (Symfony\Component\Console for instance), * the autoloader will first look for the class under the component/ * directory, and it will then fallback to the framework/ directory if not * found before giving up. * * This class is loosely based on the Symfony UniversalClassLoader. * * @author Fabien Potencier * @author Jordi Boggiano * @see https://www.php-fig.org/psr/psr-0/ * @see https://www.php-fig.org/psr/psr-4/ */ class ClassLoader { /** @var ?string */ private $vendorDir; // PSR-4 /** * @var array[] * @psalm-var array> */ private $prefixLengthsPsr4 = array(); /** * @var array[] * @psalm-var array> */ private $prefixDirsPsr4 = array(); /** * @var array[] * @psalm-var array */ private $fallbackDirsPsr4 = array(); // PSR-0 /** * @var array[] * @psalm-var array> */ private $prefixesPsr0 = array(); /** * @var array[] * @psalm-var array */ private $fallbackDirsPsr0 = array(); /** @var bool */ private $useIncludePath = false; /** * @var string[] * @psalm-var array */ private $classMap = array(); /** @var bool */ private $classMapAuthoritative = false; /** * @var bool[] * @psalm-var array */ private $missingClasses = array(); /** @var ?string */ private $apcuPrefix; /** * @var self[] */ private static $registeredLoaders = array(); /** * @param ?string $vendorDir */ public function __construct($vendorDir = null) { $this->vendorDir = $vendorDir; } /** * @return string[] */ public function getPrefixes() { if (!empty($this->prefixesPsr0)) { return call_user_func_array('array_merge', array_values($this->prefixesPsr0)); } return array(); } /** * @return array[] * @psalm-return array> */ public function getPrefixesPsr4() { return $this->prefixDirsPsr4; } /** * @return array[] * @psalm-return array */ public function getFallbackDirs() { return $this->fallbackDirsPsr0; } /** * @return array[] * @psalm-return array */ public function getFallbackDirsPsr4() { return $this->fallbackDirsPsr4; } /** * @return string[] Array of classname => path * @psalm-return array */ public function getClassMap() { return $this->classMap; } /** * @param string[] $classMap Class to filename map * @psalm-param array $classMap * * @return void */ public function addClassMap(array $classMap) { if ($this->classMap) { $this->classMap = array_merge($this->classMap, $classMap); } else { $this->classMap = $classMap; } } /** * Registers a set of PSR-0 directories for a given prefix, either * appending or prepending to the ones previously set for this prefix. * * @param string $prefix The prefix * @param string[]|string $paths The PSR-0 root directories * @param bool $prepend Whether to prepend the directories * * @return void */ public function add($prefix, $paths, $prepend = false) { if (!$prefix) { if ($prepend) { $this->fallbackDirsPsr0 = array_merge( (array) $paths, $this->fallbackDirsPsr0 ); } else { $this->fallbackDirsPsr0 = array_merge( $this->fallbackDirsPsr0, (array) $paths ); } return; } $first = $prefix[0]; if (!isset($this->prefixesPsr0[$first][$prefix])) { $this->prefixesPsr0[$first][$prefix] = (array) $paths; return; } if ($prepend) { $this->prefixesPsr0[$first][$prefix] = array_merge( (array) $paths, $this->prefixesPsr0[$first][$prefix] ); } else { $this->prefixesPsr0[$first][$prefix] = array_merge( $this->prefixesPsr0[$first][$prefix], (array) $paths ); } } /** * Registers a set of PSR-4 directories for a given namespace, either * appending or prepending to the ones previously set for this namespace. * * @param string $prefix The prefix/namespace, with trailing '\\' * @param string[]|string $paths The PSR-4 base directories * @param bool $prepend Whether to prepend the directories * * @throws \InvalidArgumentException * * @return void */ public function addPsr4($prefix, $paths, $prepend = false) { if (!$prefix) { // Register directories for the root namespace. if ($prepend) { $this->fallbackDirsPsr4 = array_merge( (array) $paths, $this->fallbackDirsPsr4 ); } else { $this->fallbackDirsPsr4 = array_merge( $this->fallbackDirsPsr4, (array) $paths ); } } elseif (!isset($this->prefixDirsPsr4[$prefix])) { // Register directories for a new namespace. $length = strlen($prefix); if ('\\' !== $prefix[$length - 1]) { throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); } $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; $this->prefixDirsPsr4[$prefix] = (array) $paths; } elseif ($prepend) { // Prepend directories for an already registered namespace. $this->prefixDirsPsr4[$prefix] = array_merge( (array) $paths, $this->prefixDirsPsr4[$prefix] ); } else { // Append directories for an already registered namespace. $this->prefixDirsPsr4[$prefix] = array_merge( $this->prefixDirsPsr4[$prefix], (array) $paths ); } } /** * Registers a set of PSR-0 directories for a given prefix, * replacing any others previously set for this prefix. * * @param string $prefix The prefix * @param string[]|string $paths The PSR-0 base directories * * @return void */ public function set($prefix, $paths) { if (!$prefix) { $this->fallbackDirsPsr0 = (array) $paths; } else { $this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths; } } /** * Registers a set of PSR-4 directories for a given namespace, * replacing any others previously set for this namespace. * * @param string $prefix The prefix/namespace, with trailing '\\' * @param string[]|string $paths The PSR-4 base directories * * @throws \InvalidArgumentException * * @return void */ public function setPsr4($prefix, $paths) { if (!$prefix) { $this->fallbackDirsPsr4 = (array) $paths; } else { $length = strlen($prefix); if ('\\' !== $prefix[$length - 1]) { throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); } $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; $this->prefixDirsPsr4[$prefix] = (array) $paths; } } /** * Turns on searching the include path for class files. * * @param bool $useIncludePath * * @return void */ public function setUseIncludePath($useIncludePath) { $this->useIncludePath = $useIncludePath; } /** * Can be used to check if the autoloader uses the include path to check * for classes. * * @return bool */ public function getUseIncludePath() { return $this->useIncludePath; } /** * Turns off searching the prefix and fallback directories for classes * that have not been registered with the class map. * * @param bool $classMapAuthoritative * * @return void */ public function setClassMapAuthoritative($classMapAuthoritative) { $this->classMapAuthoritative = $classMapAuthoritative; } /** * Should class lookup fail if not found in the current class map? * * @return bool */ public function isClassMapAuthoritative() { return $this->classMapAuthoritative; } /** * APCu prefix to use to cache found/not-found classes, if the extension is enabled. * * @param string|null $apcuPrefix * * @return void */ public function setApcuPrefix($apcuPrefix) { $this->apcuPrefix = function_exists('apcu_fetch') && filter_var(ini_get('apc.enabled'), FILTER_VALIDATE_BOOLEAN) ? $apcuPrefix : null; } /** * The APCu prefix in use, or null if APCu caching is not enabled. * * @return string|null */ public function getApcuPrefix() { return $this->apcuPrefix; } /** * Registers this instance as an autoloader. * * @param bool $prepend Whether to prepend the autoloader or not * * @return void */ public function register($prepend = false) { spl_autoload_register(array($this, 'loadClass'), true, $prepend); if (null === $this->vendorDir) { return; } if ($prepend) { self::$registeredLoaders = array($this->vendorDir => $this) + self::$registeredLoaders; } else { unset(self::$registeredLoaders[$this->vendorDir]); self::$registeredLoaders[$this->vendorDir] = $this; } } /** * Unregisters this instance as an autoloader. * * @return void */ public function unregister() { spl_autoload_unregister(array($this, 'loadClass')); if (null !== $this->vendorDir) { unset(self::$registeredLoaders[$this->vendorDir]); } } /** * Loads the given class or interface. * * @param string $class The name of the class * @return true|null True if loaded, null otherwise */ public function loadClass($class) { if ($file = $this->findFile($class)) { includeFile($file); return true; } return null; } /** * Finds the path to the file where the class is defined. * * @param string $class The name of the class * * @return string|false The path if found, false otherwise */ public function findFile($class) { // class map lookup if (isset($this->classMap[$class])) { return $this->classMap[$class]; } if ($this->classMapAuthoritative || isset($this->missingClasses[$class])) { return false; } if (null !== $this->apcuPrefix) { $file = apcu_fetch($this->apcuPrefix.$class, $hit); if ($hit) { return $file; } } $file = $this->findFileWithExtension($class, '.php'); // Search for Hack files if we are running on HHVM if (false === $file && defined('HHVM_VERSION')) { $file = $this->findFileWithExtension($class, '.hh'); } if (null !== $this->apcuPrefix) { apcu_add($this->apcuPrefix.$class, $file); } if (false === $file) { // Remember that this class does not exist. $this->missingClasses[$class] = true; } return $file; } /** * Returns the currently registered loaders indexed by their corresponding vendor directories. * * @return self[] */ public static function getRegisteredLoaders() { return self::$registeredLoaders; } /** * @param string $class * @param string $ext * @return string|false */ private function findFileWithExtension($class, $ext) { // PSR-4 lookup $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext; $first = $class[0]; if (isset($this->prefixLengthsPsr4[$first])) { $subPath = $class; while (false !== $lastPos = strrpos($subPath, '\\')) { $subPath = substr($subPath, 0, $lastPos); $search = $subPath . '\\'; if (isset($this->prefixDirsPsr4[$search])) { $pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1); foreach ($this->prefixDirsPsr4[$search] as $dir) { if (file_exists($file = $dir . $pathEnd)) { return $file; } } } } } // PSR-4 fallback dirs foreach ($this->fallbackDirsPsr4 as $dir) { if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) { return $file; } } // PSR-0 lookup if (false !== $pos = strrpos($class, '\\')) { // namespaced class name $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1) . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR); } else { // PEAR-like class name $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext; } if (isset($this->prefixesPsr0[$first])) { foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) { if (0 === strpos($class, $prefix)) { foreach ($dirs as $dir) { if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { return $file; } } } } } // PSR-0 fallback dirs foreach ($this->fallbackDirsPsr0 as $dir) { if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { return $file; } } // PSR-0 include paths. if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) { return $file; } return false; } } /** * Scope isolated include. * * Prevents access to $this/self from included files. * * @param string $file * @return void * @private */ function includeFile($file) { include $file; } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Autoload; use Composer\Pcre\Preg; /** * @author Jordi Boggiano * @internal */ class PhpFileCleaner { /** @var array */ private static $typeConfig; /** @var non-empty-string */ private static $restPattern; /** * @readonly * @var string */ private $contents; /** * @readonly * @var int */ private $len; /** * @readonly * @var int */ private $maxMatches; /** @var int */ private $index = 0; /** * @param string[] $types * @return void */ public static function setTypeConfig($types) { foreach ($types as $type) { self::$typeConfig[$type[0]] = array( 'name' => $type, 'length' => \strlen($type), 'pattern' => '{.\b(?])'.$type.'\s++[a-zA-Z_\x7f-\xff:][a-zA-Z0-9_\x7f-\xff:\-]*+}Ais', ); } self::$restPattern = '{[^?"\'contents = $contents; $this->len = \strlen($this->contents); $this->maxMatches = $maxMatches; } /** * @return string */ public function clean() { $clean = ''; while ($this->index < $this->len) { $this->skipToPhp(); $clean .= 'index < $this->len) { $char = $this->contents[$this->index]; if ($char === '?' && $this->peek('>')) { $clean .= '?>'; $this->index += 2; continue 2; } if ($char === '"') { $this->skipString('"'); $clean .= 'null'; continue; } if ($char === "'") { $this->skipString("'"); $clean .= 'null'; continue; } if ($char === "<" && $this->peek('<') && $this->match('{<<<[ \t]*+([\'"]?)([a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]*+)\\1(?:\r\n|\n|\r)}A', $match)) { $this->index += \strlen($match[0]); $this->skipHeredoc($match[2]); $clean .= 'null'; continue; } if ($char === '/') { if ($this->peek('/')) { $this->skipToNewline(); continue; } if ($this->peek('*')) { $this->skipComment(); continue; } } if ($this->maxMatches === 1 && isset(self::$typeConfig[$char])) { $type = self::$typeConfig[$char]; if ( \substr($this->contents, $this->index, $type['length']) === $type['name'] && Preg::isMatch($type['pattern'], $this->contents, $match, 0, $this->index - 1) ) { $clean .= $match[0]; return $clean; } } $this->index += 1; if ($this->match(self::$restPattern, $match)) { $clean .= $char . $match[0]; $this->index += \strlen($match[0]); } else { $clean .= $char; } } } return $clean; } /** * @return void */ private function skipToPhp() { while ($this->index < $this->len) { if ($this->contents[$this->index] === '<' && $this->peek('?')) { $this->index += 2; break; } $this->index += 1; } } /** * @param string $delimiter * @return void */ private function skipString($delimiter) { $this->index += 1; while ($this->index < $this->len) { if ($this->contents[$this->index] === '\\' && ($this->peek('\\') || $this->peek($delimiter))) { $this->index += 2; continue; } if ($this->contents[$this->index] === $delimiter) { $this->index += 1; break; } $this->index += 1; } } /** * @return void */ private function skipComment() { $this->index += 2; while ($this->index < $this->len) { if ($this->contents[$this->index] === '*' && $this->peek('/')) { $this->index += 2; break; } $this->index += 1; } } /** * @return void */ private function skipToNewline() { while ($this->index < $this->len) { if ($this->contents[$this->index] === "\r" || $this->contents[$this->index] === "\n") { return; } $this->index += 1; } } /** * @param string $delimiter * @return void */ private function skipHeredoc($delimiter) { $firstDelimiterChar = $delimiter[0]; $delimiterLength = \strlen($delimiter); $delimiterPattern = '{'.preg_quote($delimiter).'(?![a-zA-Z0-9_\x80-\xff])}A'; while ($this->index < $this->len) { // check if we find the delimiter after some spaces/tabs switch ($this->contents[$this->index]) { case "\t": case " ": $this->index += 1; continue 2; case $firstDelimiterChar: if ( \substr($this->contents, $this->index, $delimiterLength) === $delimiter && $this->match($delimiterPattern) ) { $this->index += $delimiterLength; return; } break; } // skip the rest of the line while ($this->index < $this->len) { $this->skipToNewline(); // skip newlines while ($this->index < $this->len && ($this->contents[$this->index] === "\r" || $this->contents[$this->index] === "\n")) { $this->index += 1; } break; } } } /** * @param string $char * @return bool */ private function peek($char) { return $this->index + 1 < $this->len && $this->contents[$this->index + 1] === $char; } /** * @param non-empty-string $regex * @param ?array $match * @return bool */ private function match($regex, array &$match = null) { return Preg::isMatch($regex, $this->contents, $match, 0, $this->index); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Autoload; use Composer\Config; use Composer\EventDispatcher\EventDispatcher; use Composer\Filter\PlatformRequirementFilter\IgnoreAllPlatformRequirementFilter; use Composer\Filter\PlatformRequirementFilter\PlatformRequirementFilterFactory; use Composer\Filter\PlatformRequirementFilter\PlatformRequirementFilterInterface; use Composer\Installer\InstallationManager; use Composer\IO\IOInterface; use Composer\Package\AliasPackage; use Composer\Package\PackageInterface; use Composer\Package\RootPackageInterface; use Composer\Pcre\Preg; use Composer\Repository\InstalledRepositoryInterface; use Composer\Semver\Constraint\Bound; use Composer\Util\Filesystem; use Composer\Util\Platform; use Composer\Script\ScriptEvents; use Composer\Util\PackageSorter; use Composer\Json\JsonFile; /** * @author Igor Wiedler * @author Jordi Boggiano */ class AutoloadGenerator { /** * @var EventDispatcher */ private $eventDispatcher; /** * @var ?IOInterface */ private $io; /** * @var ?bool */ private $devMode = null; /** * @var bool */ private $classMapAuthoritative = false; /** * @var bool */ private $apcu = false; /** * @var string|null */ private $apcuPrefix; /** * @var bool */ private $runScripts = false; /** * @var PlatformRequirementFilterInterface */ private $platformRequirementFilter; public function __construct(EventDispatcher $eventDispatcher, IOInterface $io = null) { $this->eventDispatcher = $eventDispatcher; $this->io = $io; $this->platformRequirementFilter = PlatformRequirementFilterFactory::ignoreNothing(); } /** * @param bool $devMode * @return void */ public function setDevMode($devMode = true) { $this->devMode = (bool) $devMode; } /** * Whether generated autoloader considers the class map authoritative. * * @param bool $classMapAuthoritative * @return void */ public function setClassMapAuthoritative($classMapAuthoritative) { $this->classMapAuthoritative = (bool) $classMapAuthoritative; } /** * Whether generated autoloader considers APCu caching. * * @param bool $apcu * @param string|null $apcuPrefix * @return void */ public function setApcu($apcu, $apcuPrefix = null) { $this->apcu = (bool) $apcu; $this->apcuPrefix = $apcuPrefix !== null ? (string) $apcuPrefix : $apcuPrefix; } /** * Whether to run scripts or not * * @param bool $runScripts * @return void */ public function setRunScripts($runScripts = true) { $this->runScripts = (bool) $runScripts; } /** * Whether platform requirements should be ignored. * * If this is set to true, the platform check file will not be generated * If this is set to false, the platform check file will be generated with all requirements * If this is set to string[], those packages will be ignored from the platform check file * * @param bool|string[] $ignorePlatformReqs * @return void * * @deprecated use setPlatformRequirementFilter instead */ public function setIgnorePlatformRequirements($ignorePlatformReqs) { trigger_error('AutoloadGenerator::setIgnorePlatformRequirements is deprecated since Composer 2.2, use setPlatformRequirementFilter instead.', E_USER_DEPRECATED); $this->setPlatformRequirementFilter(PlatformRequirementFilterFactory::fromBoolOrList($ignorePlatformReqs)); } /** * @return void */ public function setPlatformRequirementFilter(PlatformRequirementFilterInterface $platformRequirementFilter) { $this->platformRequirementFilter = $platformRequirementFilter; } /** * @param string $targetDir * @param bool $scanPsrPackages * @param string|null $suffix * @return int * @throws \Seld\JsonLint\ParsingException * @throws \RuntimeException */ public function dump(Config $config, InstalledRepositoryInterface $localRepo, RootPackageInterface $rootPackage, InstallationManager $installationManager, $targetDir, $scanPsrPackages = false, $suffix = null) { if ($this->classMapAuthoritative) { // Force scanPsrPackages when classmap is authoritative $scanPsrPackages = true; } // auto-set devMode based on whether dev dependencies are installed or not if (null === $this->devMode) { // we assume no-dev mode if no vendor dir is present or it is too old to contain dev information $this->devMode = false; $installedJson = new JsonFile($config->get('vendor-dir').'/composer/installed.json'); if ($installedJson->exists()) { $installedJson = $installedJson->read(); if (isset($installedJson['dev'])) { $this->devMode = $installedJson['dev']; } } } if ($this->runScripts) { // set COMPOSER_DEV_MODE in case not set yet so it is available in the dump-autoload event listeners if (!isset($_SERVER['COMPOSER_DEV_MODE'])) { Platform::putEnv('COMPOSER_DEV_MODE', $this->devMode ? '1' : '0'); } $this->eventDispatcher->dispatchScript(ScriptEvents::PRE_AUTOLOAD_DUMP, $this->devMode, array(), array( 'optimize' => (bool) $scanPsrPackages, )); } $filesystem = new Filesystem(); $filesystem->ensureDirectoryExists($config->get('vendor-dir')); // Do not remove double realpath() calls. // Fixes failing Windows realpath() implementation. // See https://bugs.php.net/bug.php?id=72738 $basePath = $filesystem->normalizePath(realpath(realpath(getcwd()))); $vendorPath = $filesystem->normalizePath(realpath(realpath($config->get('vendor-dir')))); $useGlobalIncludePath = (bool) $config->get('use-include-path'); $prependAutoloader = $config->get('prepend-autoloader') === false ? 'false' : 'true'; $targetDir = $vendorPath.'/'.$targetDir; $filesystem->ensureDirectoryExists($targetDir); $vendorPathCode = $filesystem->findShortestPathCode(realpath($targetDir), $vendorPath, true); $vendorPathCode52 = str_replace('__DIR__', 'dirname(__FILE__)', $vendorPathCode); $vendorPathToTargetDirCode = $filesystem->findShortestPathCode($vendorPath, realpath($targetDir), true); $appBaseDirCode = $filesystem->findShortestPathCode($vendorPath, $basePath, true); $appBaseDirCode = str_replace('__DIR__', '$vendorDir', $appBaseDirCode); $namespacesFile = <<getDevPackageNames(); $packageMap = $this->buildPackageMap($installationManager, $rootPackage, $localRepo->getCanonicalPackages()); if ($this->devMode) { // if dev mode is enabled, then we do not filter any dev packages out so disable this entirely $filteredDevPackages = false; } else { // if the list of dev package names is available we use that straight, otherwise pass true which means use legacy algo to figure them out $filteredDevPackages = $devPackageNames ?: true; } $autoloads = $this->parseAutoloads($packageMap, $rootPackage, $filteredDevPackages); // Process the 'psr-0' base directories. foreach ($autoloads['psr-0'] as $namespace => $paths) { $exportedPaths = array(); foreach ($paths as $path) { $exportedPaths[] = $this->getPathCode($filesystem, $basePath, $vendorPath, $path); } $exportedPrefix = var_export($namespace, true); $namespacesFile .= " $exportedPrefix => "; $namespacesFile .= "array(".implode(', ', $exportedPaths)."),\n"; } $namespacesFile .= ");\n"; // Process the 'psr-4' base directories. foreach ($autoloads['psr-4'] as $namespace => $paths) { $exportedPaths = array(); foreach ($paths as $path) { $exportedPaths[] = $this->getPathCode($filesystem, $basePath, $vendorPath, $path); } $exportedPrefix = var_export($namespace, true); $psr4File .= " $exportedPrefix => "; $psr4File .= "array(".implode(', ', $exportedPaths)."),\n"; } $psr4File .= ");\n"; $classmapFile = <<getAutoload(); if ($rootPackage->getTargetDir() && !empty($mainAutoload['psr-0'])) { $levels = substr_count($filesystem->normalizePath($rootPackage->getTargetDir()), '/') + 1; $prefixes = implode(', ', array_map(function ($prefix) { return var_export($prefix, true); }, array_keys($mainAutoload['psr-0']))); $baseDirFromTargetDirCode = $filesystem->findShortestPathCode($targetDir, $basePath, true); $targetDirLoader = <<addClassMapCode($filesystem, $basePath, $vendorPath, $dir, $excluded, null, null, $classMap, $ambiguousClasses, $scannedFiles); } if ($scanPsrPackages) { $namespacesToScan = array(); // Scan the PSR-0/4 directories for class files, and add them to the class map foreach (array('psr-4', 'psr-0') as $psrType) { foreach ($autoloads[$psrType] as $namespace => $paths) { $namespacesToScan[$namespace][] = array('paths' => $paths, 'type' => $psrType); } } krsort($namespacesToScan); foreach ($namespacesToScan as $namespace => $groups) { foreach ($groups as $group) { foreach ($group['paths'] as $dir) { $dir = $filesystem->normalizePath($filesystem->isAbsolutePath($dir) ? $dir : $basePath.'/'.$dir); if (!is_dir($dir)) { continue; } $classMap = $this->addClassMapCode($filesystem, $basePath, $vendorPath, $dir, $excluded, $namespace, $group['type'], $classMap, $ambiguousClasses, $scannedFiles); } } } } foreach ($ambiguousClasses as $className => $ambiguousPaths) { $cleanPath = str_replace(array('$vendorDir . \'', '$baseDir . \'', "',\n"), array($vendorPath, $basePath, ''), $classMap[$className]); $this->io->writeError( 'Warning: Ambiguous class resolution, "'.$className.'"'. ' was found '. (count($ambiguousPaths) + 1) .'x: in "'.$cleanPath.'" and "'. implode('", "', $ambiguousPaths) .'", the first will be used.' ); } $classMap['Composer\\InstalledVersions'] = "\$vendorDir . '/composer/InstalledVersions.php',\n"; ksort($classMap); foreach ($classMap as $class => $code) { $classmapFile .= ' '.var_export($class, true).' => '.$code; } $classmapFile .= ");\n"; if ('' === $suffix) { $suffix = null; } if (null === $suffix) { $suffix = $config->get('autoloader-suffix'); // carry over existing autoload.php's suffix if possible and none is configured if (null === $suffix && Filesystem::isReadable($vendorPath.'/autoload.php')) { $content = file_get_contents($vendorPath.'/autoload.php'); if (Preg::isMatch('{ComposerAutoloaderInit([^:\s]+)::}', $content, $match)) { $suffix = $match[1]; } } // generate one if we still haven't got a suffix if (null === $suffix) { $suffix = md5(uniqid('', true)); } } $filesystem->filePutContentsIfModified($targetDir.'/autoload_namespaces.php', $namespacesFile); $filesystem->filePutContentsIfModified($targetDir.'/autoload_psr4.php', $psr4File); $filesystem->filePutContentsIfModified($targetDir.'/autoload_classmap.php', $classmapFile); $includePathFilePath = $targetDir.'/include_paths.php'; if ($includePathFileContents = $this->getIncludePathsFile($packageMap, $filesystem, $basePath, $vendorPath, $vendorPathCode52, $appBaseDirCode)) { $filesystem->filePutContentsIfModified($includePathFilePath, $includePathFileContents); } elseif (file_exists($includePathFilePath)) { unlink($includePathFilePath); } $includeFilesFilePath = $targetDir.'/autoload_files.php'; if ($includeFilesFileContents = $this->getIncludeFilesFile($autoloads['files'], $filesystem, $basePath, $vendorPath, $vendorPathCode52, $appBaseDirCode)) { $filesystem->filePutContentsIfModified($includeFilesFilePath, $includeFilesFileContents); } elseif (file_exists($includeFilesFilePath)) { unlink($includeFilesFilePath); } $filesystem->filePutContentsIfModified($targetDir.'/autoload_static.php', $this->getStaticFile($suffix, $targetDir, $vendorPath, $basePath, $staticPhpVersion)); $checkPlatform = $config->get('platform-check') && !($this->platformRequirementFilter instanceof IgnoreAllPlatformRequirementFilter); $platformCheckContent = null; if ($checkPlatform) { $platformCheckContent = $this->getPlatformCheck($packageMap, $config->get('platform-check'), $devPackageNames); if (null === $platformCheckContent) { $checkPlatform = false; } } if ($checkPlatform) { $filesystem->filePutContentsIfModified($targetDir.'/platform_check.php', $platformCheckContent); } elseif (file_exists($targetDir.'/platform_check.php')) { unlink($targetDir.'/platform_check.php'); } $filesystem->filePutContentsIfModified($vendorPath.'/autoload.php', $this->getAutoloadFile($vendorPathToTargetDirCode, $suffix)); $filesystem->filePutContentsIfModified($targetDir.'/autoload_real.php', $this->getAutoloadRealFile(true, (bool) $includePathFileContents, $targetDirLoader, (bool) $includeFilesFileContents, $vendorPathCode, $appBaseDirCode, $suffix, $useGlobalIncludePath, $prependAutoloader, $staticPhpVersion, $checkPlatform)); $filesystem->safeCopy(__DIR__.'/ClassLoader.php', $targetDir.'/ClassLoader.php'); $filesystem->safeCopy(__DIR__.'/../../../LICENSE', $targetDir.'/LICENSE'); if ($this->runScripts) { $this->eventDispatcher->dispatchScript(ScriptEvents::POST_AUTOLOAD_DUMP, $this->devMode, array(), array( 'optimize' => (bool) $scanPsrPackages, )); } return count($classMap); } /** * @param string $basePath * @param string $vendorPath * @param string $dir * @param ?array $excluded * @param ?string $namespaceFilter * @param ?string $autoloadType * @param array $classMap * @param array> $ambiguousClasses * @param array $scannedFiles * @return array */ private function addClassMapCode(Filesystem $filesystem, $basePath, $vendorPath, $dir, $excluded, $namespaceFilter, $autoloadType, array $classMap, array &$ambiguousClasses, array &$scannedFiles) { foreach ($this->generateClassMap($dir, $excluded, $namespaceFilter, $autoloadType, true, $scannedFiles) as $class => $path) { $pathCode = $this->getPathCode($filesystem, $basePath, $vendorPath, $path).",\n"; if (!isset($classMap[$class])) { $classMap[$class] = $pathCode; } elseif ($this->io && $classMap[$class] !== $pathCode && !Preg::isMatch('{/(test|fixture|example|stub)s?/}i', strtr($classMap[$class].' '.$path, '\\', '/'))) { $ambiguousClasses[$class][] = $path; } } return $classMap; } /** * @param string $dir * @param ?array $excluded * @param ?string $namespaceFilter * @param ?string $autoloadType * @param bool $showAmbiguousWarning * @param array $scannedFiles * @return array */ private function generateClassMap($dir, $excluded, $namespaceFilter, $autoloadType, $showAmbiguousWarning, array &$scannedFiles) { if ($excluded) { // filter excluded patterns here to only use those matching $dir // exclude-from-classmap patterns are all realpath'd so we can only filter them if $dir exists so that realpath($dir) will work // if $dir does not exist, it should anyway not find anything there so no trouble if (file_exists($dir)) { // transform $dir in the same way that exclude-from-classmap patterns are transformed so we can match them against each other $dirMatch = preg_quote(strtr(realpath($dir), '\\', '/')); foreach ($excluded as $index => $pattern) { // extract the constant string prefix of the pattern here, until we reach a non-escaped regex special character $pattern = Preg::replace('{^(([^.+*?\[^\]$(){}=!<>|:\\\\#-]+|\\\\[.+*?\[^\]$(){}=!<>|:#-])*).*}', '$1', $pattern); // if the pattern is not a subset or superset of $dir, it is unrelated and we skip it if (0 !== strpos($pattern, $dirMatch) && 0 !== strpos($dirMatch, $pattern)) { unset($excluded[$index]); } } } $excluded = $excluded ? '{(' . implode('|', $excluded) . ')}' : null; } return ClassMapGenerator::createMap($dir, $excluded, $showAmbiguousWarning ? $this->io : null, $namespaceFilter, $autoloadType, $scannedFiles); } /** * @param InstallationManager $installationManager * @param PackageInterface[] $packages * @return array */ public function buildPackageMap(InstallationManager $installationManager, PackageInterface $rootPackage, array $packages) { // build package => install path map $packageMap = array(array($rootPackage, '')); foreach ($packages as $package) { if ($package instanceof AliasPackage) { continue; } $this->validatePackage($package); $packageMap[] = array( $package, $installationManager->getInstallPath($package), ); } return $packageMap; } /** * @return void * @throws \InvalidArgumentException Throws an exception, if the package has illegal settings. */ protected function validatePackage(PackageInterface $package) { $autoload = $package->getAutoload(); if (!empty($autoload['psr-4']) && null !== $package->getTargetDir()) { $name = $package->getName(); $package->getTargetDir(); throw new \InvalidArgumentException("PSR-4 autoloading is incompatible with the target-dir property, remove the target-dir in package '$name'."); } if (!empty($autoload['psr-4'])) { foreach ($autoload['psr-4'] as $namespace => $dirs) { if ($namespace !== '' && '\\' !== substr($namespace, -1)) { throw new \InvalidArgumentException("psr-4 namespaces must end with a namespace separator, '$namespace' does not, use '$namespace\\'."); } } } } /** * Compiles an ordered list of namespace => path mappings * * @param array $packageMap array of array(package, installDir-relative-to-composer.json) * @param RootPackageInterface $rootPackage root package instance * @param bool|string[] $filteredDevPackages If an array, the list of packages that must be removed. If bool, whether to filter out require-dev packages * @return array * @phpstan-return array{ * 'psr-0': array>, * 'psr-4': array>, * 'classmap': array, * 'files': array, * 'exclude-from-classmap': array, * } */ public function parseAutoloads(array $packageMap, PackageInterface $rootPackage, $filteredDevPackages = false) { $rootPackageMap = array_shift($packageMap); if (is_array($filteredDevPackages)) { $packageMap = array_filter($packageMap, function ($item) use ($filteredDevPackages) { return !in_array($item[0]->getName(), $filteredDevPackages, true); }); } elseif ($filteredDevPackages) { $packageMap = $this->filterPackageMap($packageMap, $rootPackage); } $sortedPackageMap = $this->sortPackageMap($packageMap); $sortedPackageMap[] = $rootPackageMap; array_unshift($packageMap, $rootPackageMap); $psr0 = $this->parseAutoloadsType($packageMap, 'psr-0', $rootPackage); $psr4 = $this->parseAutoloadsType($packageMap, 'psr-4', $rootPackage); $classmap = $this->parseAutoloadsType(array_reverse($sortedPackageMap), 'classmap', $rootPackage); $files = $this->parseAutoloadsType($sortedPackageMap, 'files', $rootPackage); $exclude = $this->parseAutoloadsType($sortedPackageMap, 'exclude-from-classmap', $rootPackage); krsort($psr0); krsort($psr4); return array( 'psr-0' => $psr0, 'psr-4' => $psr4, 'classmap' => $classmap, 'files' => $files, 'exclude-from-classmap' => $exclude, ); } /** * Registers an autoloader based on an autoload-map returned by parseAutoloads * * @param array $autoloads see parseAutoloads return value * @param ?string $vendorDir * @return ClassLoader */ public function createLoader(array $autoloads, $vendorDir = null) { $loader = new ClassLoader($vendorDir); if (isset($autoloads['psr-0'])) { foreach ($autoloads['psr-0'] as $namespace => $path) { $loader->add($namespace, $path); } } if (isset($autoloads['psr-4'])) { foreach ($autoloads['psr-4'] as $namespace => $path) { $loader->addPsr4($namespace, $path); } } if (isset($autoloads['classmap'])) { $excluded = null; if (!empty($autoloads['exclude-from-classmap'])) { $excluded = $autoloads['exclude-from-classmap']; } $scannedFiles = array(); foreach ($autoloads['classmap'] as $dir) { try { $loader->addClassMap($this->generateClassMap($dir, $excluded, null, null, false, $scannedFiles)); } catch (\RuntimeException $e) { $this->io->writeError(''.$e->getMessage().''); } } } return $loader; } /** * @param array $packageMap * @param string $basePath * @param string $vendorPath * @param string $vendorPathCode * @param string $appBaseDirCode * @return ?string */ protected function getIncludePathsFile(array $packageMap, Filesystem $filesystem, $basePath, $vendorPath, $vendorPathCode, $appBaseDirCode) { $includePaths = array(); foreach ($packageMap as $item) { list($package, $installPath) = $item; if (null !== $package->getTargetDir() && strlen($package->getTargetDir()) > 0) { $installPath = substr($installPath, 0, -strlen('/'.$package->getTargetDir())); } foreach ($package->getIncludePaths() as $includePath) { $includePath = trim($includePath, '/'); $includePaths[] = empty($installPath) ? $includePath : $installPath.'/'.$includePath; } } if (!$includePaths) { return null; } $includePathsCode = ''; foreach ($includePaths as $path) { $includePathsCode .= " " . $this->getPathCode($filesystem, $basePath, $vendorPath, $path) . ",\n"; } return << $files * @param string $basePath * @param string $vendorPath * @param string $vendorPathCode * @param string $appBaseDirCode * @return ?string */ protected function getIncludeFilesFile(array $files, Filesystem $filesystem, $basePath, $vendorPath, $vendorPathCode, $appBaseDirCode) { $filesCode = ''; foreach ($files as $fileIdentifier => $functionFile) { $filesCode .= ' ' . var_export($fileIdentifier, true) . ' => ' . $this->getPathCode($filesystem, $basePath, $vendorPath, $functionFile) . ",\n"; } if (!$filesCode) { return null; } return <<isAbsolutePath($path)) { $path = $basePath . '/' . $path; } $path = $filesystem->normalizePath($path); $baseDir = ''; if (strpos($path.'/', $vendorPath.'/') === 0) { $path = substr($path, strlen($vendorPath)); $baseDir = '$vendorDir'; if ($path !== false) { $baseDir .= " . "; } } else { $path = $filesystem->normalizePath($filesystem->findShortestPath($basePath, $path, true)); if (!$filesystem->isAbsolutePath($path)) { $baseDir = '$baseDir . '; $path = '/' . $path; } } if (strpos($path, '.phar') !== false) { $baseDir = "'phar://' . " . $baseDir; } return $baseDir . var_export($path, true); } /** * @param array $packageMap * @param bool $checkPlatform * @param string[] $devPackageNames * @return ?string */ protected function getPlatformCheck(array $packageMap, $checkPlatform, array $devPackageNames) { $lowestPhpVersion = Bound::zero(); $requiredExtensions = array(); $extensionProviders = array(); foreach ($packageMap as $item) { $package = $item[0]; foreach (array_merge($package->getReplaces(), $package->getProvides()) as $link) { if (Preg::isMatch('{^ext-(.+)$}iD', $link->getTarget(), $match)) { $extensionProviders[$match[1]][] = $link->getConstraint(); } } } foreach ($packageMap as $item) { $package = $item[0]; // skip dev dependencies platform requirements as platform-check really should only be a production safeguard if (in_array($package->getName(), $devPackageNames, true)) { continue; } foreach ($package->getRequires() as $link) { if ($this->platformRequirementFilter->isIgnored($link->getTarget())) { continue; } if ('php' === $link->getTarget()) { $constraint = $link->getConstraint(); if ($constraint->getLowerBound()->compareTo($lowestPhpVersion, '>')) { $lowestPhpVersion = $constraint->getLowerBound(); } } if ($checkPlatform === true && Preg::isMatch('{^ext-(.+)$}iD', $link->getTarget(), $match)) { // skip extension checks if they have a valid provider/replacer if (isset($extensionProviders[$match[1]])) { foreach ($extensionProviders[$match[1]] as $provided) { if ($provided->matches($link->getConstraint())) { continue 2; } } } if ($match[1] === 'zend-opcache') { $match[1] = 'zend opcache'; } $extension = var_export($match[1], true); if ($match[1] === 'pcntl' || $match[1] === 'readline') { $requiredExtensions[$extension] = "PHP_SAPI !== 'cli' || extension_loaded($extension) || \$missingExtensions[] = $extension;\n"; } else { $requiredExtensions[$extension] = "extension_loaded($extension) || \$missingExtensions[] = $extension;\n"; } } } } ksort($requiredExtensions); $formatToPhpVersionId = function (Bound $bound) { if ($bound->isZero()) { return 0; } if ($bound->isPositiveInfinity()) { return 99999; } $version = str_replace('-', '.', $bound->getVersion()); $chunks = array_map('intval', explode('.', $version)); return $chunks[0] * 10000 + $chunks[1] * 100 + $chunks[2]; }; $formatToHumanReadable = function (Bound $bound) { if ($bound->isZero()) { return 0; } if ($bound->isPositiveInfinity()) { return 99999; } $version = str_replace('-', '.', $bound->getVersion()); $chunks = explode('.', $version); $chunks = array_slice($chunks, 0, 3); return implode('.', $chunks); }; $requiredPhp = ''; $requiredPhpError = ''; if (!$lowestPhpVersion->isZero()) { $operator = $lowestPhpVersion->isInclusive() ? '>=' : '>'; $requiredPhp = 'PHP_VERSION_ID '.$operator.' '.$formatToPhpVersionId($lowestPhpVersion); $requiredPhpError = '"'.$operator.' '.$formatToHumanReadable($lowestPhpVersion).'"'; } if ($requiredPhp) { $requiredPhp = <<= $staticPhpVersion && !defined('HHVM_VERSION') && (!function_exists('zend_loader_file_encoded') || !zend_loader_file_encoded()); if (\$useStaticLoader) { require __DIR__ . '/autoload_static.php'; call_user_func(\Composer\Autoload\ComposerStaticInit$suffix::getInitializer(\$loader)); } else { STATIC_INIT; if (!$this->classMapAuthoritative) { $file .= <<<'PSR04' $map = require __DIR__ . '/autoload_namespaces.php'; foreach ($map as $namespace => $path) { $loader->set($namespace, $path); } $map = require __DIR__ . '/autoload_psr4.php'; foreach ($map as $namespace => $path) { $loader->setPsr4($namespace, $path); } PSR04; } if ($useClassMap) { $file .= <<<'CLASSMAP' $classMap = require __DIR__ . '/autoload_classmap.php'; if ($classMap) { $loader->addClassMap($classMap); } CLASSMAP; } $file .= " }\n\n"; if ($this->classMapAuthoritative) { $file .= <<<'CLASSMAPAUTHORITATIVE' $loader->setClassMapAuthoritative(true); CLASSMAPAUTHORITATIVE; } if ($this->apcu) { $apcuPrefix = var_export(($this->apcuPrefix !== null ? $this->apcuPrefix : substr(base64_encode(md5(uniqid('', true), true)), 0, -3)), true); $file .= <<setApcuPrefix($apcuPrefix); APCU; } if ($useGlobalIncludePath) { $file .= <<<'INCLUDEPATH' $loader->setUseIncludePath(true); INCLUDEPATH; } if ($targetDirLoader) { $file .= <<register($prependAutoloader); REGISTER_LOADER; if ($useIncludeFiles) { $file .= << \$file) { composerRequire$suffix(\$fileIdentifier, \$file); } INCLUDE_FILES; } $file .= << $path) { $loader->set($namespace, $path); } $map = require $targetDir . '/autoload_psr4.php'; foreach ($map as $namespace => $path) { $loader->setPsr4($namespace, $path); } $classMap = require $targetDir . '/autoload_classmap.php'; if ($classMap) { $loader->addClassMap($classMap); } $filesystem = new Filesystem(); $vendorPathCode = ' => ' . $filesystem->findShortestPathCode(realpath($targetDir), $vendorPath, true, true) . " . '/"; $vendorPharPathCode = ' => \'phar://\' . ' . $filesystem->findShortestPathCode(realpath($targetDir), $vendorPath, true, true) . " . '/"; $appBaseDirCode = ' => ' . $filesystem->findShortestPathCode(realpath($targetDir), $basePath, true, true) . " . '/"; $appBaseDirPharCode = ' => \'phar://\' . ' . $filesystem->findShortestPathCode(realpath($targetDir), $basePath, true, true) . " . '/"; $absoluteVendorPathCode = ' => ' . substr(var_export(rtrim($vendorDir, '\\/') . '/', true), 0, -1); $absoluteVendorPharPathCode = ' => ' . substr(var_export(rtrim('phar://' . $vendorDir, '\\/') . '/', true), 0, -1); $absoluteAppBaseDirCode = ' => ' . substr(var_export(rtrim($baseDir, '\\/') . '/', true), 0, -1); $absoluteAppBaseDirPharCode = ' => ' . substr(var_export(rtrim('phar://' . $baseDir, '\\/') . '/', true), 0, -1); $initializer = ''; $prefix = "\0Composer\Autoload\ClassLoader\0"; $prefixLen = strlen($prefix); if (file_exists($targetDir . '/autoload_files.php')) { $maps = array('files' => require $targetDir . '/autoload_files.php'); } else { $maps = array(); } foreach ((array) $loader as $prop => $value) { if (is_array($value) && \count($value) !== 0 && 0 === strpos($prop, $prefix)) { $maps[substr($prop, $prefixLen)] = $value; } } foreach ($maps as $prop => $value) { if (count($value) > 32767) { // Static arrays are limited to 32767 values on PHP 5.6 // See https://bugs.php.net/68057 $staticPhpVersion = 70000; } $value = strtr( var_export($value, true), array( $absoluteVendorPathCode => $vendorPathCode, $absoluteVendorPharPathCode => $vendorPharPathCode, $absoluteAppBaseDirCode => $appBaseDirCode, $absoluteAppBaseDirPharCode => $appBaseDirPharCode, ) ); $value = ltrim(Preg::replace('/^ */m', ' $0$0', $value)); $file .= sprintf(" public static $%s = %s;\n\n", $prop, $value); if ('files' !== $prop) { $initializer .= " \$loader->$prop = ComposerStaticInit$suffix::\$$prop;\n"; } } return $file . << $packageMap * @param string $type one of: 'psr-0'|'psr-4'|'classmap'|'files' * @return array|array>|array */ protected function parseAutoloadsType(array $packageMap, $type, RootPackageInterface $rootPackage) { $autoloads = array(); foreach ($packageMap as $item) { list($package, $installPath) = $item; $autoload = $package->getAutoload(); if ($this->devMode && $package === $rootPackage) { $autoload = array_merge_recursive($autoload, $package->getDevAutoload()); } // skip misconfigured packages if (!isset($autoload[$type]) || !is_array($autoload[$type])) { continue; } if (null !== $package->getTargetDir() && $package !== $rootPackage) { $installPath = substr($installPath, 0, -strlen('/'.$package->getTargetDir())); } foreach ($autoload[$type] as $namespace => $paths) { foreach ((array) $paths as $path) { if (($type === 'files' || $type === 'classmap' || $type === 'exclude-from-classmap') && $package->getTargetDir() && !Filesystem::isReadable($installPath.'/'.$path)) { // remove target-dir from file paths of the root package if ($package === $rootPackage) { $targetDir = str_replace('\\', '[\\\\/]', preg_quote(str_replace(array('/', '\\'), '', $package->getTargetDir()))); $path = ltrim(Preg::replace('{^'.$targetDir.'}', '', ltrim($path, '\\/')), '\\/'); } else { // add target-dir from file paths that don't have it $path = $package->getTargetDir() . '/' . $path; } } if ($type === 'exclude-from-classmap') { // first escape user input $path = Preg::replace('{/+}', '/', preg_quote(trim(strtr($path, '\\', '/'), '/'))); // add support for wildcards * and ** $path = strtr($path, array('\\*\\*' => '.+?', '\\*' => '[^/]+?')); // add support for up-level relative paths $updir = null; $path = Preg::replaceCallback( '{^((?:(?:\\\\\\.){1,2}+/)+)}', function ($matches) use (&$updir) { if (isset($matches[1])) { // undo preg_quote for the matched string $updir = str_replace('\\.', '.', $matches[1]); } return ''; }, $path ); if (empty($installPath)) { $installPath = strtr(getcwd(), '\\', '/'); } $resolvedPath = realpath($installPath . '/' . $updir); if (false === $resolvedPath) { continue; } $autoloads[] = preg_quote(strtr($resolvedPath, '\\', '/')) . '/' . $path . '($|/)'; continue; } $relativePath = empty($installPath) ? (empty($path) ? '.' : $path) : $installPath.'/'.$path; if ($type === 'files') { $autoloads[$this->getFileIdentifier($package, $path)] = $relativePath; continue; } if ($type === 'classmap') { $autoloads[] = $relativePath; continue; } $autoloads[$namespace][] = $relativePath; } } } return $autoloads; } /** * @param string $path * @return string */ protected function getFileIdentifier(PackageInterface $package, $path) { return md5($package->getName() . ':' . $path); } /** * Filters out dev-dependencies * * @param array $packageMap * @param RootPackageInterface $rootPackage * @return array * * @phpstan-param array $packageMap */ protected function filterPackageMap(array $packageMap, RootPackageInterface $rootPackage) { $packages = array(); $include = array(); $replacedBy = array(); foreach ($packageMap as $item) { $package = $item[0]; $name = $package->getName(); $packages[$name] = $package; foreach ($package->getReplaces() as $replace) { $replacedBy[$replace->getTarget()] = $name; } } $add = function (PackageInterface $package) use (&$add, $packages, &$include, $replacedBy) { foreach ($package->getRequires() as $link) { $target = $link->getTarget(); if (isset($replacedBy[$target])) { $target = $replacedBy[$target]; } if (!isset($include[$target])) { $include[$target] = true; if (isset($packages[$target])) { $add($packages[$target]); } } } }; $add($rootPackage); return array_filter( $packageMap, function ($item) use ($include) { $package = $item[0]; foreach ($package->getNames() as $name) { if (isset($include[$name])) { return true; } } return false; } ); } /** * Sorts packages by dependency weight * * Packages of equal weight are sorted alphabetically * * @param array $packageMap * @return array */ protected function sortPackageMap(array $packageMap) { $packages = array(); $paths = array(); foreach ($packageMap as $item) { list($package, $path) = $item; $name = $package->getName(); $packages[$name] = $package; $paths[$name] = $path; } $sortedPackages = PackageSorter::sortPackages($packages); $sortedPackageMap = array(); foreach ($sortedPackages as $package) { $name = $package->getName(); $sortedPackageMap[] = array($packages[$name], $paths[$name]); } return $sortedPackageMap; } } /** * @param string $fileIdentifier * @param string $file * @return void */ function composerRequire($fileIdentifier, $file) { if (empty($GLOBALS['__composer_autoload_files'][$fileIdentifier])) { $GLOBALS['__composer_autoload_files'][$fileIdentifier] = true; require $file; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ /* * This file is copied from the Symfony package. * * (c) Fabien Potencier */ namespace Composer\Autoload; use Composer\Pcre\Preg; use Symfony\Component\Finder\Finder; use Composer\IO\IOInterface; use Composer\Util\Filesystem; /** * ClassMapGenerator * * @author Gyula Sallai * @author Jordi Boggiano */ class ClassMapGenerator { /** * Generate a class map file * * @param \Traversable|array $dirs Directories or a single path to search in * @param string $file The name of the class map file * @return void */ public static function dump($dirs, $file) { $maps = array(); foreach ($dirs as $dir) { $maps = array_merge($maps, static::createMap($dir)); } file_put_contents($file, sprintf('|string|array $path The path to search in or an iterator * @param string $excluded Regex that matches file paths to be excluded from the classmap * @param ?IOInterface $io IO object * @param ?string $namespace Optional namespace prefix to filter by * @param ?string $autoloadType psr-0|psr-4 Optional autoload standard to use mapping rules * @param array $scannedFiles * @return array A class map array * @throws \RuntimeException When the path is neither an existing file nor directory */ public static function createMap($path, $excluded = null, IOInterface $io = null, $namespace = null, $autoloadType = null, &$scannedFiles = array()) { $basePath = $path; if (is_string($path)) { if (is_file($path)) { $path = array(new \SplFileInfo($path)); } elseif (is_dir($path) || strpos($path, '*') !== false) { $path = Finder::create()->files()->followLinks()->name('/\.(php|inc|hh)$/')->in($path); } else { throw new \RuntimeException( 'Could not scan for classes inside "'.$path. '" which does not appear to be a file nor a folder' ); } } elseif (null !== $autoloadType) { throw new \RuntimeException('Path must be a string when specifying an autoload type'); } $map = array(); $filesystem = new Filesystem(); $cwd = realpath(getcwd()); foreach ($path as $file) { $filePath = $file->getPathname(); if (!in_array(pathinfo($filePath, PATHINFO_EXTENSION), array('php', 'inc', 'hh'))) { continue; } if (!$filesystem->isAbsolutePath($filePath)) { $filePath = $cwd . '/' . $filePath; $filePath = $filesystem->normalizePath($filePath); } else { $filePath = Preg::replace('{[\\\\/]{2,}}', '/', $filePath); } $realPath = realpath($filePath); // if a list of scanned files is given, avoid scanning twice the same file to save cycles and avoid generating warnings // in case a PSR-0/4 declaration follows another more specific one, or a classmap declaration, which covered this file already if (isset($scannedFiles[$realPath])) { continue; } // check the realpath of the file against the excluded paths as the path might be a symlink and the excluded path is realpath'd so symlink are resolved if ($excluded && Preg::isMatch($excluded, strtr($realPath, '\\', '/'))) { continue; } // check non-realpath of file for directories symlink in project dir if ($excluded && Preg::isMatch($excluded, strtr($filePath, '\\', '/'))) { continue; } $classes = self::findClasses($filePath); if (null !== $autoloadType) { $classes = self::filterByNamespace($classes, $filePath, $namespace, $autoloadType, $basePath, $io); // if no valid class was found in the file then we do not mark it as scanned as it might still be matched by another rule later if ($classes) { $scannedFiles[$realPath] = true; } } else { // classmap autoload rules always collect all classes so for these we definitely do not want to scan again $scannedFiles[$realPath] = true; } foreach ($classes as $class) { // skip classes not within the given namespace prefix if (null === $autoloadType && null !== $namespace && '' !== $namespace && 0 !== strpos($class, $namespace)) { continue; } if (!isset($map[$class])) { $map[$class] = $filePath; } elseif ($io && $map[$class] !== $filePath && !Preg::isMatch('{/(test|fixture|example|stub)s?/}i', strtr($map[$class].' '.$filePath, '\\', '/'))) { $io->writeError( 'Warning: Ambiguous class resolution, "'.$class.'"'. ' was found in both "'.$map[$class].'" and "'.$filePath.'", the first will be used.' ); } } } return $map; } /** * Remove classes which could not have been loaded by namespace autoloaders * * @param array $classes found classes in given file * @param string $filePath current file * @param string $baseNamespace prefix of given autoload mapping * @param string $namespaceType psr-0|psr-4 * @param string $basePath root directory of given autoload mapping * @param ?IOInterface $io IO object * @return array valid classes */ private static function filterByNamespace($classes, $filePath, $baseNamespace, $namespaceType, $basePath, $io) { $validClasses = array(); $rejectedClasses = array(); $realSubPath = substr($filePath, strlen($basePath) + 1); $realSubPath = substr($realSubPath, 0, strrpos($realSubPath, '.')); foreach ($classes as $class) { // silently skip if ns doesn't have common root if ('' !== $baseNamespace && 0 !== strpos($class, $baseNamespace)) { continue; } // transform class name to file path and validate if ('psr-0' === $namespaceType) { $namespaceLength = strrpos($class, '\\'); if (false !== $namespaceLength) { $namespace = substr($class, 0, $namespaceLength + 1); $className = substr($class, $namespaceLength + 1); $subPath = str_replace('\\', DIRECTORY_SEPARATOR, $namespace) . str_replace('_', DIRECTORY_SEPARATOR, $className); } else { $subPath = str_replace('_', DIRECTORY_SEPARATOR, $class); } } elseif ('psr-4' === $namespaceType) { $subNamespace = ('' !== $baseNamespace) ? substr($class, strlen($baseNamespace)) : $class; $subPath = str_replace('\\', DIRECTORY_SEPARATOR, $subNamespace); } else { throw new \RuntimeException("namespaceType must be psr-0 or psr-4, $namespaceType given"); } if ($subPath === $realSubPath) { $validClasses[] = $class; } else { $rejectedClasses[] = $class; } } // warn only if no valid classes, else silently skip invalid if (empty($validClasses)) { foreach ($rejectedClasses as $class) { if ($io) { $io->writeError("Class $class located in ".Preg::replace('{^'.preg_quote(getcwd()).'}', '.', $filePath, 1)." does not comply with $namespaceType autoloading standard. Skipping."); } } return array(); } return $validClasses; } /** * Extract the classes in the given file * * @param string $path The file to check * @throws \RuntimeException * @return array The found classes */ private static function findClasses($path) { $extraTypes = self::getExtraTypes(); // Use @ here instead of Silencer to actively suppress 'unhelpful' output // @link https://github.com/composer/composer/pull/4886 $contents = @php_strip_whitespace($path); if (!$contents) { if (!file_exists($path)) { $message = 'File at "%s" does not exist, check your classmap definitions'; } elseif (!Filesystem::isReadable($path)) { $message = 'File at "%s" is not readable, check its permissions'; } elseif ('' === trim(file_get_contents($path))) { // The input file was really empty and thus contains no classes return array(); } else { $message = 'File at "%s" could not be parsed as PHP, it may be binary or corrupted'; } $error = error_get_last(); if (isset($error['message'])) { $message .= PHP_EOL . 'The following message may be helpful:' . PHP_EOL . $error['message']; } throw new \RuntimeException(sprintf($message, $path)); } // return early if there is no chance of matching anything in this file Preg::matchAll('{\b(?:class|interface'.$extraTypes.')\s}i', $contents, $matches); if (!$matches) { return array(); } $p = new PhpFileCleaner($contents, count($matches[0])); $contents = $p->clean(); unset($p); Preg::matchAll('{ (?: \b(?])(?Pclass|interface'.$extraTypes.') \s++ (?P[a-zA-Z_\x7f-\xff:][a-zA-Z0-9_\x7f-\xff:\-]*+) | \b(?])(?Pnamespace) (?P\s++[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*+(?:\s*+\\\\\s*+[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*+)*+)? \s*+ [\{;] ) }ix', $contents, $matches); $classes = array(); $namespace = ''; for ($i = 0, $len = count($matches['type']); $i < $len; $i++) { if (!empty($matches['ns'][$i])) { $namespace = str_replace(array(' ', "\t", "\r", "\n"), '', $matches['nsname'][$i]) . '\\'; } else { $name = $matches['name'][$i]; // skip anon classes extending/implementing if ($name === 'extends' || $name === 'implements') { continue; } if ($name[0] === ':') { // This is an XHP class, https://github.com/facebook/xhp $name = 'xhp'.substr(str_replace(array('-', ':'), array('_', '__'), $name), 1); } elseif (strtolower($matches['type'][$i]) === 'enum') { // something like: // enum Foo: int { HERP = '123'; } // The regex above captures the colon, which isn't part of // the class name. // or: // enum Foo:int { HERP = '123'; } // The regex above captures the colon and type, which isn't part of // the class name. $colonPos = strrpos($name, ':'); if (false !== $colonPos) { $name = substr($name, 0, $colonPos); } } $classes[] = ltrim($namespace . $name, '\\'); } } return $classes; } /** * @return string */ private static function getExtraTypes() { static $extraTypes = null; if (null === $extraTypes) { $extraTypes = PHP_VERSION_ID < 50400 ? '' : '|trait'; if (PHP_VERSION_ID >= 80100 || (defined('HHVM_VERSION') && version_compare(HHVM_VERSION, '3.3', '>='))) { $extraTypes .= '|enum'; } PhpFileCleaner::setTypeConfig(array_merge(array('class', 'interface'), array_filter(explode('|', $extraTypes)))); } return $extraTypes; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Plugin; use Composer\EventDispatcher\Event; use Symfony\Component\Console\Input\InputInterface; /** * The pre command run event. * * @author Jordi Boggiano */ class PreCommandRunEvent extends Event { /** * @var InputInterface */ private $input; /** * @var string */ private $command; /** * Constructor. * * @param string $name The event name * @param InputInterface $input * @param string $command The command about to be executed */ public function __construct($name, InputInterface $input, $command) { parent::__construct($name); $this->input = $input; $this->command = $command; } /** * Returns the console input * * @return InputInterface */ public function getInput() { return $this->input; } /** * Returns the command about to be executed * * @return string */ public function getCommand() { return $this->command; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Plugin; use Composer\EventDispatcher\Event; use Composer\Package\PackageInterface; /** * The post file download event. * * @author Nils Adermann */ class PostFileDownloadEvent extends Event { /** * @var string */ private $fileName; /** * @var string|null */ private $checksum; /** * @var string */ private $url; /** * @var mixed */ private $context; /** * @var string */ private $type; /** * Constructor. * * @param string $name The event name * @param string|null $fileName The file name * @param string|null $checksum The checksum * @param string $url The processed url * @param string $type The type (package or metadata). * @param mixed $context Additional context for the download. */ public function __construct($name, $fileName, $checksum, $url, $type, $context = null) { /** @phpstan-ignore-next-line */ if ($context === null && $type instanceof PackageInterface) { $context = $type; $type = 'package'; trigger_error('PostFileDownloadEvent::__construct should receive a $type=package and the package object in $context since Composer 2.1.', E_USER_DEPRECATED); } parent::__construct($name); $this->fileName = $fileName; $this->checksum = $checksum; $this->url = $url; $this->context = $context; $this->type = $type; } /** * Retrieves the target file name location. * * If this download is of type metadata, null is returned. * * @return string|null */ public function getFileName() { return $this->fileName; } /** * Gets the checksum. * * @return string|null */ public function getChecksum() { return $this->checksum; } /** * Gets the processed URL. * * @return string */ public function getUrl() { return $this->url; } /** * Returns the context of this download, if any. * * If this download is of type package, the package object is returned. If * this download is of type metadata, an array{response: Response, repository: RepositoryInterface} is returned. * * @return mixed */ public function getContext() { return $this->context; } /** * Get the package. * * If this download is of type metadata, null is returned. * * @return \Composer\Package\PackageInterface|null The package. * @deprecated Use getContext instead */ public function getPackage() { trigger_error('PostFileDownloadEvent::getPackage is deprecated since Composer 2.1, use getContext instead.', E_USER_DEPRECATED); $context = $this->getContext(); return $context instanceof PackageInterface ? $context : null; } /** * Returns the type of this download (package, metadata). * * @return string */ public function getType() { return $this->type; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Plugin\Capability; /** * Commands Provider Interface * * This capability will receive an array with 'composer' and 'io' keys as * constructor argument. Those contain Composer\Composer and Composer\IO\IOInterface * instances. It also contains a 'plugin' key containing the plugin instance that * created the capability. * * @author JÃ©rÃ©my DerussÃ© */ interface CommandProvider extends Capability { /** * Retrieves an array of commands * * @return \Composer\Command\BaseCommand[] */ public function getCommands(); } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Plugin\Capability; /** * Marker interface for Plugin capabilities. * Every new Capability which is added to the Plugin API must implement this interface. * * @api */ interface Capability { } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Plugin; /** * The Plugin Events. * * @author Nils Adermann */ class PluginEvents { /** * The INIT event occurs after a Composer instance is done being initialized * * The event listener method receives a * Composer\EventDispatcher\Event instance. * * @var string */ const INIT = 'init'; /** * The COMMAND event occurs as a command begins * * The event listener method receives a * Composer\Plugin\CommandEvent instance. * * @var string */ const COMMAND = 'command'; /** * The PRE_FILE_DOWNLOAD event occurs before downloading a file * * The event listener method receives a * Composer\Plugin\PreFileDownloadEvent instance. * * @var string */ const PRE_FILE_DOWNLOAD = 'pre-file-download'; /** * The POST_FILE_DOWNLOAD event occurs after downloading a package dist file * * The event listener method receives a * Composer\Plugin\PostFileDownloadEvent instance. * * @var string */ const POST_FILE_DOWNLOAD = 'post-file-download'; /** * The PRE_COMMAND_RUN event occurs before a command is executed and lets you modify the input arguments/options * * The event listener method receives a * Composer\Plugin\PreCommandRunEvent instance. * * @var string */ const PRE_COMMAND_RUN = 'pre-command-run'; /** * The PRE_POOL_CREATE event occurs before the Pool of packages is created, and lets * you filter the list of packages which is going to enter the Solver * * The event listener method receives a * Composer\Plugin\PrePoolCreateEvent instance. * * @var string */ const PRE_POOL_CREATE = 'pre-pool-create'; } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Plugin; use Composer\EventDispatcher\Event; use Composer\Repository\RepositoryInterface; use Composer\DependencyResolver\Request; use Composer\Package\BasePackage; /** * The pre command run event. * * @author Jordi Boggiano */ class PrePoolCreateEvent extends Event { /** * @var RepositoryInterface[] */ private $repositories; /** * @var Request */ private $request; /** * @var int[] array of stability => BasePackage::STABILITY_* value * @phpstan-var array */ private $acceptableStabilities; /** * @var int[] array of package name => BasePackage::STABILITY_* value * @phpstan-var array */ private $stabilityFlags; /** * @var array[] of package => version => [alias, alias_normalized] * @phpstan-var array> */ private $rootAliases; /** * @var string[] * @phpstan-var array */ private $rootReferences; /** * @var BasePackage[] */ private $packages; /** * @var BasePackage[] */ private $unacceptableFixedPackages; /** * @param string $name The event name * @param RepositoryInterface[] $repositories * @param int[] $acceptableStabilities array of stability => BasePackage::STABILITY_* value * @param int[] $stabilityFlags array of package name => BasePackage::STABILITY_* value * @param array[] $rootAliases array of package => version => [alias, alias_normalized] * @param string[] $rootReferences * @param BasePackage[] $packages * @param BasePackage[] $unacceptableFixedPackages * * @phpstan-param array $acceptableStabilities * @phpstan-param array $stabilityFlags * @phpstan-param array> $rootAliases * @phpstan-param array $rootReferences */ public function __construct($name, array $repositories, Request $request, array $acceptableStabilities, array $stabilityFlags, array $rootAliases, array $rootReferences, array $packages, array $unacceptableFixedPackages) { parent::__construct($name); $this->repositories = $repositories; $this->request = $request; $this->acceptableStabilities = $acceptableStabilities; $this->stabilityFlags = $stabilityFlags; $this->rootAliases = $rootAliases; $this->rootReferences = $rootReferences; $this->packages = $packages; $this->unacceptableFixedPackages = $unacceptableFixedPackages; } /** * @return RepositoryInterface[] */ public function getRepositories() { return $this->repositories; } /** * @return Request */ public function getRequest() { return $this->request; } /** * @return int[] array of stability => BasePackage::STABILITY_* value * @phpstan-return array */ public function getAcceptableStabilities() { return $this->acceptableStabilities; } /** * @return int[] array of package name => BasePackage::STABILITY_* value * @phpstan-return array */ public function getStabilityFlags() { return $this->stabilityFlags; } /** * @return array[] of package => version => [alias, alias_normalized] * @phpstan-return array> */ public function getRootAliases() { return $this->rootAliases; } /** * @return string[] * @phpstan-return array */ public function getRootReferences() { return $this->rootReferences; } /** * @return BasePackage[] */ public function getPackages() { return $this->packages; } /** * @return BasePackage[] */ public function getUnacceptableFixedPackages() { return $this->unacceptableFixedPackages; } /** * @param BasePackage[] $packages * * @return void */ public function setPackages(array $packages) { $this->packages = $packages; } /** * @param BasePackage[] $packages * * @return void */ public function setUnacceptableFixedPackages(array $packages) { $this->unacceptableFixedPackages = $packages; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Plugin; use Composer\EventDispatcher\Event; use Symfony\Component\Console\Input\InputInterface; use Symfony\Component\Console\Output\OutputInterface; /** * An event for all commands. * * @author Nils Adermann */ class CommandEvent extends Event { /** * @var string */ private $commandName; /** * @var InputInterface */ private $input; /** * @var OutputInterface */ private $output; /** * Constructor. * * @param string $name The event name * @param string $commandName The command name * @param InputInterface $input * @param OutputInterface $output * @param mixed[] $args Arguments passed by the user * @param mixed[] $flags Optional flags to pass data not as argument */ public function __construct($name, $commandName, $input, $output, array $args = array(), array $flags = array()) { parent::__construct($name, $args, $flags); $this->commandName = $commandName; $this->input = $input; $this->output = $output; } /** * Returns the command input interface * * @return InputInterface */ public function getInput() { return $this->input; } /** * Retrieves the command output interface * * @return OutputInterface */ public function getOutput() { return $this->output; } /** * Retrieves the name of the command being run * * @return string */ public function getCommandName() { return $this->commandName; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Plugin; use Composer\Composer; use Composer\EventDispatcher\EventSubscriberInterface; use Composer\Installer\InstallerInterface; use Composer\IO\IOInterface; use Composer\Package\BasePackage; use Composer\Package\CompletePackage; use Composer\Package\Locker; use Composer\Package\Package; use Composer\Package\Version\VersionParser; use Composer\Pcre\Preg; use Composer\Repository\RepositoryInterface; use Composer\Repository\InstalledRepository; use Composer\Repository\RootPackageRepository; use Composer\Package\PackageInterface; use Composer\Package\Link; use Composer\Semver\Constraint\Constraint; use Composer\Plugin\Capability\Capability; use Composer\Util\PackageSorter; /** * Plugin manager * * @author Nils Adermann * @author Jordi Boggiano */ class PluginManager { /** @var Composer */ protected $composer; /** @var IOInterface */ protected $io; /** @var ?Composer */ protected $globalComposer; /** @var VersionParser */ protected $versionParser; /** @var bool|'local'|'global' */ protected $disablePlugins = false; /** @var array */ protected $plugins = array(); /** @var array> */ protected $registeredPlugins = array(); /** * @var array|null */ private $allowPluginRules; /** * @var array|null */ private $allowGlobalPluginRules; /** @var int */ private static $classCounter = 0; /** * Initializes plugin manager * * @param IOInterface $io * @param Composer $composer * @param Composer $globalComposer * @param bool|'local'|'global' $disablePlugins Whether plugins should not be loaded, can be set to local or global to only disable local/global plugins */ public function __construct(IOInterface $io, Composer $composer, Composer $globalComposer = null, $disablePlugins = false) { $this->io = $io; $this->composer = $composer; $this->globalComposer = $globalComposer; $this->versionParser = new VersionParser(); $this->disablePlugins = $disablePlugins; $this->allowPluginRules = $this->parseAllowedPlugins($composer->getConfig()->get('allow-plugins'), $composer->getLocker()); $this->allowGlobalPluginRules = $this->parseAllowedPlugins($globalComposer !== null ? $globalComposer->getConfig()->get('allow-plugins') : false, $globalComposer !== null ? $globalComposer->getLocker() : null); } /** * Loads all plugins from currently installed plugin packages * * @return void */ public function loadInstalledPlugins() { if (!$this->arePluginsDisabled('local')) { $repo = $this->composer->getRepositoryManager()->getLocalRepository(); $this->loadRepository($repo, false); } if (!$this->arePluginsDisabled('global')) { $globalRepo = $this->globalComposer !== null ? $this->globalComposer->getRepositoryManager()->getLocalRepository() : null; if ($globalRepo !== null) { $this->loadRepository($globalRepo, true); } } } /** * Deactivate all plugins from currently installed plugin packages * * @return void */ public function deactivateInstalledPlugins() { if (!$this->arePluginsDisabled('local')) { $repo = $this->composer->getRepositoryManager()->getLocalRepository(); $this->deactivateRepository($repo, false); } if (!$this->arePluginsDisabled('global')) { $globalRepo = $this->globalComposer ? $this->globalComposer->getRepositoryManager()->getLocalRepository() : null; if ($globalRepo !== null) { $this->deactivateRepository($globalRepo, true); } } } /** * Gets all currently active plugin instances * * @return array plugins */ public function getPlugins() { return $this->plugins; } /** * Gets global composer or null when main composer is not fully loaded * * @return Composer|null */ public function getGlobalComposer() { return $this->globalComposer; } /** * Register a plugin package, activate it etc. * * If it's of type composer-installer it is registered as an installer * instead for BC * * @param PackageInterface $package * @param bool $failOnMissingClasses By default this silently skips plugins that can not be found, but if set to true it fails with an exception * @param bool $isGlobalPlugin Set to true to denote plugins which are installed in the global Composer directory * * @return void * * @throws \UnexpectedValueException */ public function registerPackage(PackageInterface $package, $failOnMissingClasses = false, $isGlobalPlugin = false) { if ($this->arePluginsDisabled($isGlobalPlugin ? 'global' : 'local')) { return; } if ($package->getType() === 'composer-plugin') { $requiresComposer = null; foreach ($package->getRequires() as $link) { /** @var Link $link */ if ('composer-plugin-api' === $link->getTarget()) { $requiresComposer = $link->getConstraint(); break; } } if (!$requiresComposer) { throw new \RuntimeException("Plugin ".$package->getName()." is missing a require statement for a version of the composer-plugin-api package."); } $currentPluginApiVersion = $this->getPluginApiVersion(); $currentPluginApiConstraint = new Constraint('==', $this->versionParser->normalize($currentPluginApiVersion)); if ($requiresComposer->getPrettyString() === $this->getPluginApiVersion()) { $this->io->writeError('The "' . $package->getName() . '" plugin requires composer-plugin-api '.$this->getPluginApiVersion().', this *WILL* break in the future and it should be fixed ASAP (require ^'.$this->getPluginApiVersion().' instead for example).'); } elseif (!$requiresComposer->matches($currentPluginApiConstraint)) { $this->io->writeError('The "' . $package->getName() . '" plugin '.($isGlobalPlugin ? '(installed globally) ' : '').'was skipped because it requires a Plugin API version ("' . $requiresComposer->getPrettyString() . '") that does not match your Composer installation ("' . $currentPluginApiVersion . '"). You may need to run composer update with the "--no-plugins" option.'); return; } if ($package->getName() === 'symfony/flex' && Preg::isMatch('{^[0-9.]+$}', $package->getVersion()) && version_compare($package->getVersion(), '1.9.8', '<')) { $this->io->writeError('The "' . $package->getName() . '" plugin '.($isGlobalPlugin ? '(installed globally) ' : '').'was skipped because it is not compatible with Composer 2+. Make sure to update it to version 1.9.8 or greater.'); return; } } $extra = $package->getExtra(); if (!$this->isPluginAllowed($package->getName(), $isGlobalPlugin, isset($extra['plugin-optional']) && true === $extra['plugin-optional'])) { $this->io->writeError('Skipped loading "'.$package->getName() . '" '.($isGlobalPlugin ? '(installed globally) ' : '').'as it is not in config.allow-plugins', true, IOInterface::DEBUG); return; } $oldInstallerPlugin = ($package->getType() === 'composer-installer'); if (isset($this->registeredPlugins[$package->getName()])) { return; } $this->registeredPlugins[$package->getName()] = array(); $extra = $package->getExtra(); if (empty($extra['class'])) { throw new \UnexpectedValueException('Error while installing '.$package->getPrettyName().', composer-plugin packages should have a class defined in their extra key to be usable.'); } $classes = is_array($extra['class']) ? $extra['class'] : array($extra['class']); $localRepo = $this->composer->getRepositoryManager()->getLocalRepository(); $globalRepo = $this->globalComposer !== null ? $this->globalComposer->getRepositoryManager()->getLocalRepository() : null; $rootPackage = clone $this->composer->getPackage(); // clear files autoload rules from the root package as the root dependencies are not // necessarily all present yet when booting this runtime autoloader $rootPackageAutoloads = $rootPackage->getAutoload(); $rootPackageAutoloads['files'] = array(); $rootPackage->setAutoload($rootPackageAutoloads); $rootPackageAutoloads = $rootPackage->getDevAutoload(); $rootPackageAutoloads['files'] = array(); $rootPackage->setDevAutoload($rootPackageAutoloads); unset($rootPackageAutoloads); $rootPackageRepo = new RootPackageRepository($rootPackage); $installedRepo = new InstalledRepository(array($localRepo, $rootPackageRepo)); if ($globalRepo) { $installedRepo->addRepository($globalRepo); } $autoloadPackages = array($package->getName() => $package); $autoloadPackages = $this->collectDependencies($installedRepo, $autoloadPackages, $package); $generator = $this->composer->getAutoloadGenerator(); $autoloads = array(array($rootPackage, '')); foreach ($autoloadPackages as $autoloadPackage) { if ($autoloadPackage === $rootPackage) { continue; } $downloadPath = $this->getInstallPath($autoloadPackage, $globalRepo && $globalRepo->hasPackage($autoloadPackage)); $autoloads[] = array($autoloadPackage, $downloadPath); } $map = $generator->parseAutoloads($autoloads, $rootPackage); $classLoader = $generator->createLoader($map, $this->composer->getConfig()->get('vendor-dir')); $classLoader->register(false); foreach ($map['files'] as $fileIdentifier => $file) { // exclude laminas/laminas-zendframework-bridge:src/autoload.php as it breaks Composer in some conditions // see https://github.com/composer/composer/issues/10349 and https://github.com/composer/composer/issues/10401 // this hack can be removed once this deprecated package stop being installed if ($fileIdentifier === '7e9bd612cc444b3eed788ebbe46263a0') { continue; } \Composer\Autoload\composerRequire($fileIdentifier, $file); } foreach ($classes as $class) { if (class_exists($class, false)) { $class = trim($class, '\\'); $path = $classLoader->findFile($class); $code = file_get_contents($path); $separatorPos = strrpos($class, '\\'); $className = $class; if ($separatorPos) { $className = substr($class, $separatorPos + 1); } $code = Preg::replace('{^((?:(?:final|readonly)\s+)*(?:\s*))class\s+('.preg_quote($className).')}mi', '$1class $2_composer_tmp'.self::$classCounter, $code, 1); $code = strtr($code, array( '__FILE__' => var_export($path, true), '__DIR__' => var_export(dirname($path), true), '__CLASS__' => var_export($class, true), )); $code = Preg::replace('/^\s*<\?(php)?/i', '', $code, 1); eval($code); $class .= '_composer_tmp'.self::$classCounter; self::$classCounter++; } if ($oldInstallerPlugin) { if (!is_a($class, 'Composer\Installer\InstallerInterface', true)) { throw new \RuntimeException('Could not activate plugin "'.$package->getName().'" as "'.$class.'" does not implement Composer\Installer\InstallerInterface'); } $this->io->writeError('Loading "'.$package->getName() . '" '.($isGlobalPlugin ? '(installed globally) ' : '').'which is a legacy composer-installer built for Composer 1.x, it is likely to cause issues as you are running Composer 2.x.'); $installer = new $class($this->io, $this->composer); $this->composer->getInstallationManager()->addInstaller($installer); $this->registeredPlugins[$package->getName()][] = $installer; } elseif (class_exists($class)) { if (!is_a($class, 'Composer\Plugin\PluginInterface', true)) { throw new \RuntimeException('Could not activate plugin "'.$package->getName().'" as "'.$class.'" does not implement Composer\Plugin\PluginInterface'); } $plugin = new $class(); $this->addPlugin($plugin, $isGlobalPlugin, $package); $this->registeredPlugins[$package->getName()][] = $plugin; } elseif ($failOnMissingClasses) { throw new \UnexpectedValueException('Plugin '.$package->getName().' could not be initialized, class not found: '.$class); } } } /** * Deactivates a plugin package * * If it's of type composer-installer it is unregistered from the installers * instead for BC * * @param PackageInterface $package * * @return void * * @throws \UnexpectedValueException */ public function deactivatePackage(PackageInterface $package) { if (!isset($this->registeredPlugins[$package->getName()])) { return; } $plugins = $this->registeredPlugins[$package->getName()]; foreach ($plugins as $plugin) { if ($plugin instanceof InstallerInterface) { $this->composer->getInstallationManager()->removeInstaller($plugin); } else { $this->removePlugin($plugin); } } unset($this->registeredPlugins[$package->getName()]); } /** * Uninstall a plugin package * * If it's of type composer-installer it is unregistered from the installers * instead for BC * * @param PackageInterface $package * * @return void * * @throws \UnexpectedValueException */ public function uninstallPackage(PackageInterface $package) { if (!isset($this->registeredPlugins[$package->getName()])) { return; } $plugins = $this->registeredPlugins[$package->getName()]; foreach ($plugins as $plugin) { if ($plugin instanceof InstallerInterface) { $this->composer->getInstallationManager()->removeInstaller($plugin); } else { $this->removePlugin($plugin); $this->uninstallPlugin($plugin); } } unset($this->registeredPlugins[$package->getName()]); } /** * Returns the version of the internal composer-plugin-api package. * * @return string */ protected function getPluginApiVersion() { return PluginInterface::PLUGIN_API_VERSION; } /** * Adds a plugin, activates it and registers it with the event dispatcher * * Ideally plugin packages should be registered via registerPackage, but if you use Composer * programmatically and want to register a plugin class directly this is a valid way * to do it. * * @param PluginInterface $plugin plugin instance * @param bool $isGlobalPlugin * @param ?PackageInterface $sourcePackage Package from which the plugin comes from * * @return void */ public function addPlugin(PluginInterface $plugin, $isGlobalPlugin = false, PackageInterface $sourcePackage = null) { if ($this->arePluginsDisabled($isGlobalPlugin ? 'global' : 'local')) { return; } if ($sourcePackage === null) { trigger_error('Calling PluginManager::addPlugin without $sourcePackage is deprecated, if you are using this please get in touch with us to explain the use case', E_USER_DEPRECATED); } else { $extra = $sourcePackage->getExtra(); if (!$this->isPluginAllowed($sourcePackage->getName(), $isGlobalPlugin, isset($extra['plugin-optional']) && true === $extra['plugin-optional'])) { $this->io->writeError('Skipped loading "'.get_class($plugin).' from '.$sourcePackage->getName() . '" '.($isGlobalPlugin ? '(installed globally) ' : '').' as it is not in config.allow-plugins', true, IOInterface::DEBUG); return; } } $details = array(); if ($sourcePackage) { $details[] = 'from '.$sourcePackage->getName(); } if ($isGlobalPlugin) { $details[] = 'installed globally'; } $this->io->writeError('Loading plugin '.get_class($plugin).($details ? ' ('.implode(', ', $details).')' : ''), true, IOInterface::DEBUG); $this->plugins[] = $plugin; $plugin->activate($this->composer, $this->io); if ($plugin instanceof EventSubscriberInterface) { $this->composer->getEventDispatcher()->addSubscriber($plugin); } } /** * Removes a plugin, deactivates it and removes any listener the plugin has set on the plugin instance * * Ideally plugin packages should be deactivated via deactivatePackage, but if you use Composer * programmatically and want to deregister a plugin class directly this is a valid way * to do it. * * @param PluginInterface $plugin plugin instance * * @return void */ public function removePlugin(PluginInterface $plugin) { $index = array_search($plugin, $this->plugins, true); if ($index === false) { return; } $this->io->writeError('Unloading plugin '.get_class($plugin), true, IOInterface::DEBUG); unset($this->plugins[$index]); $plugin->deactivate($this->composer, $this->io); $this->composer->getEventDispatcher()->removeListener($plugin); } /** * Notifies a plugin it is being uninstalled and should clean up * * Ideally plugin packages should be uninstalled via uninstallPackage, but if you use Composer * programmatically and want to deregister a plugin class directly this is a valid way * to do it. * * @param PluginInterface $plugin plugin instance * * @return void */ public function uninstallPlugin(PluginInterface $plugin) { $this->io->writeError('Uninstalling plugin '.get_class($plugin), true, IOInterface::DEBUG); $plugin->uninstall($this->composer, $this->io); } /** * Load all plugins and installers from a repository * * If a plugin requires another plugin, the required one will be loaded first * * Note that plugins in the specified repository that rely on events that * have fired prior to loading will be missed. This means you likely want to * call this method as early as possible. * * @param RepositoryInterface $repo Repository to scan for plugins to install * @param bool $isGlobalRepo * * @return void * * @throws \RuntimeException */ private function loadRepository(RepositoryInterface $repo, $isGlobalRepo) { $packages = $repo->getPackages(); $weights = array(); foreach ($packages as $package) { if ($package->getType() === 'composer-plugin') { $extra = $package->getExtra(); if ($package->getName() === 'composer/installers' || (isset($extra['plugin-modifies-install-path']) && $extra['plugin-modifies-install-path'] === true)) { $weights[$package->getName()] = -10000; } } } $sortedPackages = PackageSorter::sortPackages($packages, $weights); foreach ($sortedPackages as $package) { if (!($package instanceof CompletePackage)) { continue; } if ('composer-plugin' === $package->getType()) { $this->registerPackage($package, false, $isGlobalRepo); // Backward compatibility } elseif ('composer-installer' === $package->getType()) { $this->registerPackage($package, false, $isGlobalRepo); } } } /** * Deactivate all plugins and installers from a repository * * If a plugin requires another plugin, the required one will be deactivated last * * @param RepositoryInterface $repo Repository to scan for plugins to install * @param bool $isGlobalRepo * * @return void */ private function deactivateRepository(RepositoryInterface $repo, $isGlobalRepo) { $packages = $repo->getPackages(); $sortedPackages = array_reverse(PackageSorter::sortPackages($packages)); foreach ($sortedPackages as $package) { if (!($package instanceof CompletePackage)) { continue; } if ('composer-plugin' === $package->getType()) { $this->deactivatePackage($package); // Backward compatibility } elseif ('composer-installer' === $package->getType()) { $this->deactivatePackage($package); } } } /** * Recursively generates a map of package names to packages for all deps * * @param InstalledRepository $installedRepo Set of local repos * @param array $collected Current state of the map for recursion * @param PackageInterface $package The package to analyze * * @return array Map of package names to packages */ private function collectDependencies(InstalledRepository $installedRepo, array $collected, PackageInterface $package) { foreach ($package->getRequires() as $requireLink) { foreach ($installedRepo->findPackagesWithReplacersAndProviders($requireLink->getTarget()) as $requiredPackage) { if (!isset($collected[$requiredPackage->getName()])) { $collected[$requiredPackage->getName()] = $requiredPackage; $collected = $this->collectDependencies($installedRepo, $collected, $requiredPackage); } } } return $collected; } /** * Retrieves the path a package is installed to. * * @param PackageInterface $package * @param bool $global Whether this is a global package * * @return string Install path */ private function getInstallPath(PackageInterface $package, $global = false) { if (!$global) { return $this->composer->getInstallationManager()->getInstallPath($package); } return $this->globalComposer->getInstallationManager()->getInstallPath($package); } /** * @param PluginInterface $plugin * @param string $capability * @throws \RuntimeException On empty or non-string implementation class name value * @return null|string The fully qualified class of the implementation or null if Plugin is not of Capable type or does not provide it */ protected function getCapabilityImplementationClassName(PluginInterface $plugin, $capability) { if (!($plugin instanceof Capable)) { return null; } $capabilities = (array) $plugin->getCapabilities(); if (!empty($capabilities[$capability]) && is_string($capabilities[$capability]) && trim($capabilities[$capability])) { return trim($capabilities[$capability]); } if ( array_key_exists($capability, $capabilities) && (empty($capabilities[$capability]) || !is_string($capabilities[$capability]) || !trim($capabilities[$capability])) ) { throw new \UnexpectedValueException('Plugin '.get_class($plugin).' provided invalid capability class name(s), got '.var_export($capabilities[$capability], true)); } return null; } /** * @template CapabilityClass of Capability * @param PluginInterface $plugin * @param class-string $capabilityClassName The fully qualified name of the API interface which the plugin may provide * an implementation of. * @param array $ctorArgs Arguments passed to Capability's constructor. * Keeping it an array will allow future values to be passed w\o changing the signature. * @return null|Capability * @phpstan-param class-string $capabilityClassName * @phpstan-return null|CapabilityClass */ public function getPluginCapability(PluginInterface $plugin, $capabilityClassName, array $ctorArgs = array()) { if ($capabilityClass = $this->getCapabilityImplementationClassName($plugin, $capabilityClassName)) { if (!class_exists($capabilityClass)) { throw new \RuntimeException("Cannot instantiate Capability, as class $capabilityClass from plugin ".get_class($plugin)." does not exist."); } $ctorArgs['plugin'] = $plugin; $capabilityObj = new $capabilityClass($ctorArgs); // FIXME these could use is_a and do the check *before* instantiating once drop support for php<5.3.9 if (!$capabilityObj instanceof Capability || !$capabilityObj instanceof $capabilityClassName) { throw new \RuntimeException( 'Class ' . $capabilityClass . ' must implement both Composer\Plugin\Capability\Capability and '. $capabilityClassName . '.' ); } return $capabilityObj; } return null; } /** * @template CapabilityClass of Capability * @param class-string $capabilityClassName The fully qualified name of the API interface which the plugin may provide * an implementation of. * @param array $ctorArgs Arguments passed to Capability's constructor. * Keeping it an array will allow future values to be passed w\o changing the signature. * @return CapabilityClass[] */ public function getPluginCapabilities($capabilityClassName, array $ctorArgs = array()) { $capabilities = array(); foreach ($this->getPlugins() as $plugin) { if ($capability = $this->getPluginCapability($plugin, $capabilityClassName, $ctorArgs)) { $capabilities[] = $capability; } } return $capabilities; } /** * @param array|bool $allowPluginsConfig * @return array|null */ private function parseAllowedPlugins($allowPluginsConfig, Locker $locker = null) { if (array() === $allowPluginsConfig && $locker !== null && $locker->isLocked() && version_compare($locker->getPluginApi(), '2.2.0', '<')) { return null; } if (true === $allowPluginsConfig) { return array('{}' => true); } if (false === $allowPluginsConfig) { return array('{}' => false); } $rules = array(); foreach ($allowPluginsConfig as $pattern => $allow) { $rules[BasePackage::packageNameToRegexp($pattern)] = $allow; } return $rules; } /** * @internal * * @param 'local'|'global' $type * @return bool */ public function arePluginsDisabled($type) { return $this->disablePlugins === true || $this->disablePlugins === $type; } /** * @internal * * @param string $package * @param bool $isGlobalPlugin * @param bool $optional * @return bool */ public function isPluginAllowed($package, $isGlobalPlugin, $optional = false) { if ($isGlobalPlugin) { $rules = &$this->allowGlobalPluginRules; } else { $rules = &$this->allowPluginRules; } // This is a BC mode for lock files created pre-Composer-2.2 where the expectation of // an allow-plugins config being present cannot be made. if ($rules === null) { if (!$this->io->isInteractive()) { $this->io->writeError('For additional security you should declare the allow-plugins config with a list of packages names that are allowed to run code. See https://getcomposer.org/allow-plugins'); $this->io->writeError('This warning will become an exception once you run composer update!'); $rules = array('{}' => true); // if no config is defined we allow all plugins for BC return true; } // keep going and prompt the user $rules = array(); } foreach ($rules as $pattern => $allow) { if (Preg::isMatch($pattern, $package)) { return $allow === true; } } if ($package === 'composer/package-versions-deprecated') { return false; } if ($this->io->isInteractive()) { $composer = $isGlobalPlugin && $this->globalComposer !== null ? $this->globalComposer : $this->composer; $this->io->writeError(''.$package.($isGlobalPlugin ? ' (installed globally)' : '').' contains a Composer plugin which is currently not in your allow-plugins config. See https://getcomposer.org/allow-plugins'); while (true) { switch ($answer = $this->io->ask('Do you trust "'.$package.'" to execute code and wish to enable it now? (writes "allow-plugins" to composer.json) [y,n,d,?] ', '?')) { case 'y': case 'n': case 'd': $allow = $answer === 'y'; // persist answer in current rules to avoid prompting again if the package gets reloaded $rules[BasePackage::packageNameToRegexp($package)] = $allow; // persist answer in composer.json if it wasn't simply discarded if ($answer === 'y' || $answer === 'n') { $composer->getConfig()->getConfigSource()->addConfigSetting('allow-plugins.'.$package, $allow); } return $allow; case '?': default: $this->io->writeError(array( 'y - add package to allow-plugins in composer.json and let it run immediately', 'n - add package (as disallowed) to allow-plugins in composer.json to suppress further prompts', 'd - discard this, do not change composer.json and do not allow the plugin to run', '? - print help' )); break; } } } elseif ($optional) { return false; } throw new PluginBlockedException( $package.($isGlobalPlugin ? ' (installed globally)' : '').' contains a Composer plugin which is blocked by your allow-plugins config. You may add it to the list if you consider it safe.'.PHP_EOL. 'You can run "composer '.($isGlobalPlugin ? 'global ' : '').'config --no-plugins allow-plugins.'.$package.' [true|false]" to enable it (true) or disable it explicitly and suppress this exception (false)'.PHP_EOL. 'See https://getcomposer.org/allow-plugins' ); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Plugin; use Composer\Composer; use Composer\IO\IOInterface; /** * Plugin interface * * @author Nils Adermann */ interface PluginInterface { /** * Version number of the internal composer-plugin-api package * * This is used to denote the API version of Plugin specific * features, but is also bumped to a new major if Composer * includes a major break in internal APIs which are susceptible * to be used by plugins. * * @var string */ const PLUGIN_API_VERSION = '2.2.0'; /** * Apply plugin modifications to Composer * * @param Composer $composer * @param IOInterface $io * * @return void */ public function activate(Composer $composer, IOInterface $io); /** * Remove any hooks from Composer * * This will be called when a plugin is deactivated before being * uninstalled, but also before it gets upgraded to a new version * so the old one can be deactivated and the new one activated. * * @param Composer $composer * @param IOInterface $io * * @return void */ public function deactivate(Composer $composer, IOInterface $io); /** * Prepare the plugin to be uninstalled * * This will be called after deactivate. * * @param Composer $composer * @param IOInterface $io * * @return void */ public function uninstall(Composer $composer, IOInterface $io); } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Plugin; use Composer\EventDispatcher\Event; use Composer\Util\HttpDownloader; /** * The pre file download event. * * @author Nils Adermann */ class PreFileDownloadEvent extends Event { /** * @var HttpDownloader */ private $httpDownloader; /** * @var string */ private $processedUrl; /** * @var string|null */ private $customCacheKey; /** * @var string */ private $type; /** * @var mixed */ private $context; /** * @var mixed[] */ private $transportOptions = array(); /** * Constructor. * * @param string $name The event name * @param HttpDownloader $httpDownloader * @param string $processedUrl * @param string $type * @param mixed $context */ public function __construct($name, HttpDownloader $httpDownloader, $processedUrl, $type, $context = null) { parent::__construct($name); $this->httpDownloader = $httpDownloader; $this->processedUrl = $processedUrl; $this->type = $type; $this->context = $context; } /** * @return HttpDownloader */ public function getHttpDownloader() { return $this->httpDownloader; } /** * Retrieves the processed URL that will be downloaded. * * @return string */ public function getProcessedUrl() { return $this->processedUrl; } /** * Sets the processed URL that will be downloaded. * * @param string $processedUrl New processed URL * * @return void */ public function setProcessedUrl($processedUrl) { $this->processedUrl = $processedUrl; } /** * Retrieves a custom package cache key for this download. * * @return string|null */ public function getCustomCacheKey() { return $this->customCacheKey; } /** * Sets a custom package cache key for this download. * * @param string|null $customCacheKey New cache key * * @return void */ public function setCustomCacheKey($customCacheKey) { $this->customCacheKey = $customCacheKey; } /** * Returns the type of this download (package, metadata). * * @return string */ public function getType() { return $this->type; } /** * Returns the context of this download, if any. * * If this download is of type package, the package object is returned. * If the type is metadata, an array{repository: RepositoryInterface} is returned. * * @return mixed */ public function getContext() { return $this->context; } /** * Returns transport options for the download. * * Only available for events with type metadata, for packages set the transport options on the package itself. * * @return mixed[] */ public function getTransportOptions() { return $this->transportOptions; } /** * Sets transport options for the download. * * Only available for events with type metadata, for packages set the transport options on the package itself. * * @param mixed[] $options * * @return void */ public function setTransportOptions(array $options) { $this->transportOptions = $options; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Plugin; use UnexpectedValueException; class PluginBlockedException extends UnexpectedValueException { } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Plugin; /** * Plugins which need to expose various implementations * of the Composer Plugin Capabilities must have their * declared Plugin class implementing this interface. * * @api */ interface Capable { /** * Method by which a Plugin announces its API implementations, through an array * with a special structure. * * The key must be a string, representing a fully qualified class/interface name * which Composer Plugin API exposes. * The value must be a string as well, representing the fully qualified class name * of the implementing class. * * @tutorial * * return array( * 'Composer\Plugin\Capability\CommandProvider' => 'My\CommandProvider', * 'Composer\Plugin\Capability\Validator' => 'My\Validator', * ); * * @return string[] */ public function getCapabilities(); } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\SelfUpdate; use Composer\IO\IOInterface; use Composer\Pcre\Preg; use Composer\Util\HttpDownloader; use Composer\Config; /** * @author Jordi Boggiano */ class Versions { /** @var string[] */ public static $channels = array('stable', 'preview', 'snapshot', '1', '2', '2.2'); /** @var HttpDownloader */ private $httpDownloader; /** @var Config */ private $config; /** @var string */ private $channel; /** @var array>|null */ private $versionsData = null; public function __construct(Config $config, HttpDownloader $httpDownloader) { $this->httpDownloader = $httpDownloader; $this->config = $config; } /** * @return string */ public function getChannel() { if ($this->channel) { return $this->channel; } $channelFile = $this->config->get('home').'/update-channel'; if (file_exists($channelFile)) { $channel = trim(file_get_contents($channelFile)); if (in_array($channel, array('stable', 'preview', 'snapshot', '2.2'), true)) { return $this->channel = $channel; } } return $this->channel = 'stable'; } /** * @param string $channel * * @return void */ public function setChannel($channel, IOInterface $io = null) { if (!in_array($channel, self::$channels, true)) { throw new \InvalidArgumentException('Invalid channel '.$channel.', must be one of: ' . implode(', ', self::$channels)); } $channelFile = $this->config->get('home').'/update-channel'; $this->channel = $channel; $storedChannel = Preg::isMatch('{^\d+$}D', $channel) ? 'stable' : $channel; $previouslyStored = file_exists($channelFile) ? trim((string) file_get_contents($channelFile)) : null; // rewrite '2' and '1' channels to stable for future self-updates, but LTS ones like '2.2' remain pinned file_put_contents($channelFile, $storedChannel.PHP_EOL); if ($io !== null && $previouslyStored !== $storedChannel) { $io->writeError('Storing "'.$storedChannel.'" as default update channel for the next self-update run.'); } } /** * @param string|null $channel * * @return array{path: string, version: string, min-php: int, eol?: true} */ public function getLatest($channel = null) { $versions = $this->getVersionsData(); foreach ($versions[$channel ?: $this->getChannel()] as $version) { if ($version['min-php'] <= PHP_VERSION_ID) { return $version; } } throw new \UnexpectedValueException('There is no version of Composer available for your PHP version ('.PHP_VERSION.')'); } /** * @return array> */ private function getVersionsData() { if (null === $this->versionsData) { if ($this->config->get('disable-tls') === true) { $protocol = 'http'; } else { $protocol = 'https'; } $this->versionsData = $this->httpDownloader->get($protocol . '://getcomposer.org/versions')->decodeJson(); } return $this->versionsData; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\SelfUpdate; use Composer\Pcre\Preg; /** * @author Jordi Boggiano */ class Keys { /** * @param string $path * * @return string */ public static function fingerprint($path) { $hash = strtoupper(hash('sha256', Preg::replace('{\s}', '', file_get_contents($path)))); return implode(' ', array( substr($hash, 0, 8), substr($hash, 8, 8), substr($hash, 16, 8), substr($hash, 24, 8), '', // Extra space substr($hash, 32, 8), substr($hash, 40, 8), substr($hash, 48, 8), substr($hash, 56, 8), )); } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer; use Composer\Autoload\ClassLoader; use Composer\Semver\VersionParser; /** * This class is copied in every Composer installed project and available to all * * See also https://getcomposer.org/doc/07-runtime.md#installed-versions * * To require its presence, you can require `composer-runtime-api ^2.0` */ class InstalledVersions { /** * @var mixed[]|null * @psalm-var array{root: array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}, versions: array}|array{}|null */ private static $installed; /** * @var bool|null */ private static $canGetVendors; /** * @var array[] * @psalm-var array}> */ private static $installedByVendor = array(); /** * Returns a list of all package names which are present, either by being installed, replaced or provided * * @return string[] * @psalm-return list */ public static function getInstalledPackages() { $packages = array(); foreach (self::getInstalled() as $installed) { $packages[] = array_keys($installed['versions']); } if (1 === \count($packages)) { return $packages[0]; } return array_keys(array_flip(\call_user_func_array('array_merge', $packages))); } /** * Returns a list of all package names with a specific type e.g. 'library' * * @param string $type * @return string[] * @psalm-return list */ public static function getInstalledPackagesByType($type) { $packagesByType = array(); foreach (self::getInstalled() as $installed) { foreach ($installed['versions'] as $name => $package) { if (isset($package['type']) && $package['type'] === $type) { $packagesByType[] = $name; } } } return $packagesByType; } /** * Checks whether the given package is installed * * This also returns true if the package name is provided or replaced by another package * * @param string $packageName * @param bool $includeDevRequirements * @return bool */ public static function isInstalled($packageName, $includeDevRequirements = true) { foreach (self::getInstalled() as $installed) { if (isset($installed['versions'][$packageName])) { return $includeDevRequirements || empty($installed['versions'][$packageName]['dev_requirement']); } } return false; } /** * Checks whether the given package satisfies a version constraint * * e.g. If you want to know whether version 2.3+ of package foo/bar is installed, you would call: * * Composer\InstalledVersions::satisfies(new VersionParser, 'foo/bar', '^2.3') * * @param VersionParser $parser Install composer/semver to have access to this class and functionality * @param string $packageName * @param string|null $constraint A version constraint to check for, if you pass one you have to make sure composer/semver is required by your package * @return bool */ public static function satisfies(VersionParser $parser, $packageName, $constraint) { $constraint = $parser->parseConstraints($constraint); $provided = $parser->parseConstraints(self::getVersionRanges($packageName)); return $provided->matches($constraint); } /** * Returns a version constraint representing all the range(s) which are installed for a given package * * It is easier to use this via isInstalled() with the $constraint argument if you need to check * whether a given version of a package is installed, and not just whether it exists * * @param string $packageName * @return string Version constraint usable with composer/semver */ public static function getVersionRanges($packageName) { foreach (self::getInstalled() as $installed) { if (!isset($installed['versions'][$packageName])) { continue; } $ranges = array(); if (isset($installed['versions'][$packageName]['pretty_version'])) { $ranges[] = $installed['versions'][$packageName]['pretty_version']; } if (array_key_exists('aliases', $installed['versions'][$packageName])) { $ranges = array_merge($ranges, $installed['versions'][$packageName]['aliases']); } if (array_key_exists('replaced', $installed['versions'][$packageName])) { $ranges = array_merge($ranges, $installed['versions'][$packageName]['replaced']); } if (array_key_exists('provided', $installed['versions'][$packageName])) { $ranges = array_merge($ranges, $installed['versions'][$packageName]['provided']); } return implode(' || ', $ranges); } throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed'); } /** * @param string $packageName * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as version, use satisfies or getVersionRanges if you need to know if a given version is present */ public static function getVersion($packageName) { foreach (self::getInstalled() as $installed) { if (!isset($installed['versions'][$packageName])) { continue; } if (!isset($installed['versions'][$packageName]['version'])) { return null; } return $installed['versions'][$packageName]['version']; } throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed'); } /** * @param string $packageName * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as version, use satisfies or getVersionRanges if you need to know if a given version is present */ public static function getPrettyVersion($packageName) { foreach (self::getInstalled() as $installed) { if (!isset($installed['versions'][$packageName])) { continue; } if (!isset($installed['versions'][$packageName]['pretty_version'])) { return null; } return $installed['versions'][$packageName]['pretty_version']; } throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed'); } /** * @param string $packageName * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as reference */ public static function getReference($packageName) { foreach (self::getInstalled() as $installed) { if (!isset($installed['versions'][$packageName])) { continue; } if (!isset($installed['versions'][$packageName]['reference'])) { return null; } return $installed['versions'][$packageName]['reference']; } throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed'); } /** * @param string $packageName * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as install path. Packages of type metapackages also have a null install path. */ public static function getInstallPath($packageName) { foreach (self::getInstalled() as $installed) { if (!isset($installed['versions'][$packageName])) { continue; } return isset($installed['versions'][$packageName]['install_path']) ? $installed['versions'][$packageName]['install_path'] : null; } throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed'); } /** * @return array * @psalm-return array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string} */ public static function getRootPackage() { $installed = self::getInstalled(); return $installed[0]['root']; } /** * Returns the raw installed.php data for custom implementations * * @deprecated Use getAllRawData() instead which returns all datasets for all autoloaders present in the process. getRawData only returns the first dataset loaded, which may not be what you expect. * @return array[] * @psalm-return array{root: array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}, versions: array} */ public static function getRawData() { @trigger_error('getRawData only returns the first dataset loaded, which may not be what you expect. Use getAllRawData() instead which returns all datasets for all autoloaders present in the process.', E_USER_DEPRECATED); if (null === self::$installed) { // only require the installed.php file if this file is loaded from its dumped location, // and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937 if (substr(__DIR__, -8, 1) !== 'C') { self::$installed = include __DIR__ . '/installed.php'; } else { self::$installed = array(); } } return self::$installed; } /** * Returns the raw data of all installed.php which are currently loaded for custom implementations * * @return array[] * @psalm-return list}> */ public static function getAllRawData() { return self::getInstalled(); } /** * Lets you reload the static array from another file * * This is only useful for complex integrations in which a project needs to use * this class but then also needs to execute another project's autoloader in process, * and wants to ensure both projects have access to their version of installed.php. * * A typical case would be PHPUnit, where it would need to make sure it reads all * the data it needs from this class, then call reload() with * `require $CWD/vendor/composer/installed.php` (or similar) as input to make sure * the project in which it runs can then also use this class safely, without * interference between PHPUnit's dependencies and the project's dependencies. * * @param array[] $data A vendor/composer/installed.php data set * @return void * * @psalm-param array{root: array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}, versions: array} $data */ public static function reload($data) { self::$installed = $data; self::$installedByVendor = array(); } /** * @return array[] * @psalm-return list}> */ private static function getInstalled() { if (null === self::$canGetVendors) { self::$canGetVendors = method_exists('Composer\Autoload\ClassLoader', 'getRegisteredLoaders'); } $installed = array(); $copiedLocalDir = false; if (self::$canGetVendors) { foreach (ClassLoader::getRegisteredLoaders() as $vendorDir => $loader) { if (isset(self::$installedByVendor[$vendorDir])) { $installed[] = self::$installedByVendor[$vendorDir]; } elseif (is_file($vendorDir.'/composer/installed.php')) { /** @var array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array} $required */ $required = require $vendorDir.'/composer/installed.php'; self::$installedByVendor[$vendorDir] = $required; $installed[] = $required; if (strtr($vendorDir.'/composer', '\\', '/') === strtr(__DIR__, '\\', '/')) { self::$installed = $required; $copiedLocalDir = true; } } } } if (null === self::$installed) { // only require the installed.php file if this file is loaded from its dumped location, // and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937 if (substr(__DIR__, -8, 1) !== 'C') { /** @var array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array} $required */ $required = require __DIR__ . '/installed.php'; self::$installed = $required; } else { self::$installed = array(); } } if (self::$installed !== array() && !$copiedLocalDir) { $installed[] = self::$installed; } return $installed; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Script; /** * The Script Events. * * @author FranÃ§ois Pluchino * @author Jordi Boggiano */ class ScriptEvents { /** * The PRE_INSTALL_CMD event occurs before the install command is executed. * * The event listener method receives a Composer\Script\Event instance. * * @var string */ const PRE_INSTALL_CMD = 'pre-install-cmd'; /** * The POST_INSTALL_CMD event occurs after the install command is executed. * * The event listener method receives a Composer\Script\Event instance. * * @var string */ const POST_INSTALL_CMD = 'post-install-cmd'; /** * The PRE_UPDATE_CMD event occurs before the update command is executed. * * The event listener method receives a Composer\Script\Event instance. * * @var string */ const PRE_UPDATE_CMD = 'pre-update-cmd'; /** * The POST_UPDATE_CMD event occurs after the update command is executed. * * The event listener method receives a Composer\Script\Event instance. * * @var string */ const POST_UPDATE_CMD = 'post-update-cmd'; /** * The PRE_STATUS_CMD event occurs before the status command is executed. * * The event listener method receives a Composer\Script\Event instance. * * @var string */ const PRE_STATUS_CMD = 'pre-status-cmd'; /** * The POST_STATUS_CMD event occurs after the status command is executed. * * The event listener method receives a Composer\Script\Event instance. * * @var string */ const POST_STATUS_CMD = 'post-status-cmd'; /** * The PRE_AUTOLOAD_DUMP event occurs before the autoload file is generated. * * The event listener method receives a Composer\Script\Event instance. * * @var string */ const PRE_AUTOLOAD_DUMP = 'pre-autoload-dump'; /** * The POST_AUTOLOAD_DUMP event occurs after the autoload file has been generated. * * The event listener method receives a Composer\Script\Event instance. * * @var string */ const POST_AUTOLOAD_DUMP = 'post-autoload-dump'; /** * The POST_ROOT_PACKAGE_INSTALL event occurs after the root package has been installed. * * The event listener method receives a Composer\Script\Event instance. * * @var string */ const POST_ROOT_PACKAGE_INSTALL = 'post-root-package-install'; /** * The POST_CREATE_PROJECT event occurs after the create-project command has been executed. * Note: Event occurs after POST_INSTALL_CMD * * The event listener method receives a Composer\Script\Event instance. * * @var string */ const POST_CREATE_PROJECT_CMD = 'post-create-project-cmd'; /** * The PRE_ARCHIVE_CMD event occurs before the update command is executed. * * The event listener method receives a Composer\Script\Event instance. * * @var string */ const PRE_ARCHIVE_CMD = 'pre-archive-cmd'; /** * The POST_ARCHIVE_CMD event occurs after the status command is executed. * * The event listener method receives a Composer\Script\Event instance. * * @var string */ const POST_ARCHIVE_CMD = 'post-archive-cmd'; } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Script; use Composer\Composer; use Composer\IO\IOInterface; use Composer\EventDispatcher\Event as BaseEvent; /** * The script event class * * @author FranÃ§ois Pluchino * @author Nils Adermann */ class Event extends BaseEvent { /** * @var Composer The composer instance */ private $composer; /** * @var IOInterface The IO instance */ private $io; /** * @var bool Dev mode flag */ private $devMode; /** * @var BaseEvent */ private $originatingEvent; /** * Constructor. * * @param string $name The event name * @param Composer $composer The composer object * @param IOInterface $io The IOInterface object * @param bool $devMode Whether or not we are in dev mode * @param array $args Arguments passed by the user * @param mixed[] $flags Optional flags to pass data not as argument */ public function __construct($name, Composer $composer, IOInterface $io, $devMode = false, array $args = array(), array $flags = array()) { parent::__construct($name, $args, $flags); $this->composer = $composer; $this->io = $io; $this->devMode = $devMode; } /** * Returns the composer instance. * * @return Composer */ public function getComposer() { return $this->composer; } /** * Returns the IO instance. * * @return IOInterface */ public function getIO() { return $this->io; } /** * Return the dev mode flag * * @return bool */ public function isDevMode() { return $this->devMode; } /** * Set the originating event. * * @return ?BaseEvent */ public function getOriginatingEvent() { return $this->originatingEvent; } /** * Set the originating event. * * @param BaseEvent $event * @return $this */ public function setOriginatingEvent(BaseEvent $event) { $this->originatingEvent = $this->calculateOriginatingEvent($event); return $this; } /** * Returns the upper-most event in chain. * * @param BaseEvent $event * @return BaseEvent */ private function calculateOriginatingEvent(BaseEvent $event) { if ($event instanceof Event && $event->getOriginatingEvent()) { return $this->calculateOriginatingEvent($event->getOriginatingEvent()); } return $event; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Config; use Composer\Json\JsonFile; use Composer\Json\JsonManipulator; use Composer\Json\JsonValidationException; use Composer\Pcre\Preg; use Composer\Util\Filesystem; use Composer\Util\Silencer; /** * JSON Configuration Source * * @author Jordi Boggiano * @author Beau Simensen */ class JsonConfigSource implements ConfigSourceInterface { /** * @var JsonFile */ private $file; /** * @var bool */ private $authConfig; /** * Constructor * * @param JsonFile $file * @param bool $authConfig */ public function __construct(JsonFile $file, $authConfig = false) { $this->file = $file; $this->authConfig = $authConfig; } /** * @inheritDoc */ public function getName() { return $this->file->getPath(); } /** * @inheritDoc */ public function addRepository($name, $config, $append = true) { $this->manipulateJson('addRepository', $name, $config, $append, function (&$config, $repo, $repoConfig) use ($append) { // if converting from an array format to hashmap format, and there is a {"packagist.org":false} repo, we have // to convert it to "packagist.org": false key on the hashmap otherwise it fails schema validation if (isset($config['repositories'])) { foreach ($config['repositories'] as $index => $val) { if ($index === $repo) { continue; } if (is_numeric($index) && ($val === array('packagist' => false) || $val === array('packagist.org' => false))) { unset($config['repositories'][$index]); $config['repositories']['packagist.org'] = false; break; } } } if ($append) { $config['repositories'][$repo] = $repoConfig; } else { $config['repositories'] = array($repo => $repoConfig) + $config['repositories']; } }); } /** * @inheritDoc */ public function removeRepository($name) { $this->manipulateJson('removeRepository', $name, function (&$config, $repo) { unset($config['repositories'][$repo]); }); } /** * @inheritDoc */ public function addConfigSetting($name, $value) { $authConfig = $this->authConfig; $this->manipulateJson('addConfigSetting', $name, $value, function (&$config, $key, $val) use ($authConfig) { if (Preg::isMatch('{^(bitbucket-oauth|github-oauth|gitlab-oauth|gitlab-token|bearer|http-basic|platform)\.}', $key)) { list($key, $host) = explode('.', $key, 2); if ($authConfig) { $config[$key][$host] = $val; } else { $config['config'][$key][$host] = $val; } } else { $config['config'][$key] = $val; } }); } /** * @inheritDoc */ public function removeConfigSetting($name) { $authConfig = $this->authConfig; $this->manipulateJson('removeConfigSetting', $name, function (&$config, $key) use ($authConfig) { if (Preg::isMatch('{^(bitbucket-oauth|github-oauth|gitlab-oauth|gitlab-token|bearer|http-basic|platform)\.}', $key)) { list($key, $host) = explode('.', $key, 2); if ($authConfig) { unset($config[$key][$host]); } else { unset($config['config'][$key][$host]); } } else { unset($config['config'][$key]); } }); } /** * @inheritDoc */ public function addProperty($name, $value) { $this->manipulateJson('addProperty', $name, $value, function (&$config, $key, $val) { if (strpos($key, 'extra.') === 0 || strpos($key, 'scripts.') === 0) { $bits = explode('.', $key); $last = array_pop($bits); $arr = &$config[reset($bits)]; foreach ($bits as $bit) { if (!isset($arr[$bit])) { $arr[$bit] = array(); } $arr = &$arr[$bit]; } $arr[$last] = $val; } else { $config[$key] = $val; } }); } /** * @inheritDoc */ public function removeProperty($name) { $this->manipulateJson('removeProperty', $name, function (&$config, $key) { if (strpos($key, 'extra.') === 0 || strpos($key, 'scripts.') === 0) { $bits = explode('.', $key); $last = array_pop($bits); $arr = &$config[reset($bits)]; foreach ($bits as $bit) { if (!isset($arr[$bit])) { return; } $arr = &$arr[$bit]; } unset($arr[$last]); } else { unset($config[$key]); } }); } /** * @inheritDoc */ public function addLink($type, $name, $value) { $this->manipulateJson('addLink', $type, $name, $value, function (&$config, $type, $name, $value) { $config[$type][$name] = $value; }); } /** * @inheritDoc */ public function removeLink($type, $name) { $this->manipulateJson('removeSubNode', $type, $name, function (&$config, $type, $name) { unset($config[$type][$name]); }); $this->manipulateJson('removeMainKeyIfEmpty', $type, function (&$config, $type) { if (0 === count($config[$type])) { unset($config[$type]); } }); } /** * @param string $method * @param mixed ...$args * @param callable $fallback * * @return void */ protected function manipulateJson($method, $args, $fallback) { $args = func_get_args(); // remove method & fallback array_shift($args); $fallback = array_pop($args); if ($this->file->exists()) { if (!is_writable($this->file->getPath())) { throw new \RuntimeException(sprintf('The file "%s" is not writable.', $this->file->getPath())); } if (!Filesystem::isReadable($this->file->getPath())) { throw new \RuntimeException(sprintf('The file "%s" is not readable.', $this->file->getPath())); } $contents = file_get_contents($this->file->getPath()); } elseif ($this->authConfig) { $contents = "{\n}\n"; } else { $contents = "{\n \"config\": {\n }\n}\n"; } $manipulator = new JsonManipulator($contents); $newFile = !$this->file->exists(); // override manipulator method for auth config files if ($this->authConfig && $method === 'addConfigSetting') { $method = 'addSubNode'; list($mainNode, $name) = explode('.', $args[0], 2); $args = array($mainNode, $name, $args[1]); } elseif ($this->authConfig && $method === 'removeConfigSetting') { $method = 'removeSubNode'; list($mainNode, $name) = explode('.', $args[0], 2); $args = array($mainNode, $name); } // try to update cleanly if (call_user_func_array(array($manipulator, $method), $args)) { file_put_contents($this->file->getPath(), $manipulator->getContents()); } else { // on failed clean update, call the fallback and rewrite the whole file $config = $this->file->read(); $this->arrayUnshiftRef($args, $config); call_user_func_array($fallback, $args); // avoid ending up with arrays for keys that should be objects foreach (array('require', 'require-dev', 'conflict', 'provide', 'replace', 'suggest', 'config', 'autoload', 'autoload-dev', 'scripts', 'scripts-descriptions', 'support') as $prop) { if (isset($config[$prop]) && $config[$prop] === array()) { $config[$prop] = new \stdClass; } } foreach (array('psr-0', 'psr-4') as $prop) { if (isset($config['autoload'][$prop]) && $config['autoload'][$prop] === array()) { $config['autoload'][$prop] = new \stdClass; } if (isset($config['autoload-dev'][$prop]) && $config['autoload-dev'][$prop] === array()) { $config['autoload-dev'][$prop] = new \stdClass; } } foreach (array('platform', 'http-basic', 'bearer', 'gitlab-token', 'gitlab-oauth', 'github-oauth', 'preferred-install') as $prop) { if (isset($config['config'][$prop]) && $config['config'][$prop] === array()) { $config['config'][$prop] = new \stdClass; } } $this->file->write($config); } try { $this->file->validateSchema(JsonFile::LAX_SCHEMA); } catch (JsonValidationException $e) { // restore contents to the original state file_put_contents($this->file->getPath(), $contents); throw new \RuntimeException('Failed to update composer.json with a valid format, reverting to the original content. Please report an issue to us with details (command you run and a copy of your composer.json). '.PHP_EOL.implode(PHP_EOL, $e->getErrors()), 0, $e); } if ($newFile) { Silencer::call('chmod', $this->file->getPath(), 0600); } } /** * Prepend a reference to an element to the beginning of an array. * * @param mixed[] $array * @param mixed $value * @return int */ private function arrayUnshiftRef(&$array, &$value) { $return = array_unshift($array, ''); $array[0] = &$value; return $return; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Config; /** * Configuration Source Interface * * @author Jordi Boggiano * @author Beau Simensen */ interface ConfigSourceInterface { /** * Add a repository * * @param string $name Name * @param mixed[]|false $config Configuration * @param bool $append Whether the repo should be appended (true) or prepended (false) * * @return void */ public function addRepository($name, $config, $append = true); /** * Remove a repository * * @param string $name * * @return void */ public function removeRepository($name); /** * Add a config setting * * @param string $name Name * @param mixed $value Value * * @return void */ public function addConfigSetting($name, $value); /** * Remove a config setting * * @param string $name * * @return void */ public function removeConfigSetting($name); /** * Add a property * * @param string $name Name * @param string $value Value * * @return void */ public function addProperty($name, $value); /** * Remove a property * * @param string $name * * @return void */ public function removeProperty($name); /** * Add a package link * * @param string $type Type (require, require-dev, provide, suggest, replace, conflict) * @param string $name Name * @param string $value Value * * @return void */ public function addLink($type, $name, $value); /** * Remove a package link * * @param string $type Type (require, require-dev, provide, suggest, replace, conflict) * @param string $name Name * * @return void */ public function removeLink($type, $name); /** * Gives a user-friendly name to this source (file path or so) * * @return string */ public function getName(); } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Question; use Composer\Pcre\Preg; use Symfony\Component\Console\Exception\InvalidArgumentException; use Symfony\Component\Console\Question\Question; /** * Represents a yes/no question * Enforces strict responses rather than non-standard answers counting as default * Based on Symfony\Component\Console\Question\ConfirmationQuestion * * @author Theo Tonge */ class StrictConfirmationQuestion extends Question { /** @var non-empty-string */ private $trueAnswerRegex; /** @var non-empty-string */ private $falseAnswerRegex; /** * Constructor.s * * @param string $question The question to ask to the user * @param bool $default The default answer to return, true or false * @param non-empty-string $trueAnswerRegex A regex to match the "yes" answer * @param non-empty-string $falseAnswerRegex A regex to match the "no" answer */ public function __construct($question, $default = true, $trueAnswerRegex = '/^y(?:es)?$/i', $falseAnswerRegex = '/^no?$/i') { parent::__construct($question, (bool) $default); $this->trueAnswerRegex = $trueAnswerRegex; $this->falseAnswerRegex = $falseAnswerRegex; $this->setNormalizer($this->getDefaultNormalizer()); $this->setValidator($this->getDefaultValidator()); } /** * Returns the default answer normalizer. * * @return callable */ private function getDefaultNormalizer() { $default = $this->getDefault(); $trueRegex = $this->trueAnswerRegex; $falseRegex = $this->falseAnswerRegex; return function ($answer) use ($default, $trueRegex, $falseRegex) { if (is_bool($answer)) { return $answer; } if (empty($answer) && !empty($default)) { return $default; } if (Preg::isMatch($trueRegex, $answer)) { return true; } if (Preg::isMatch($falseRegex, $answer)) { return false; } return null; }; } /** * Returns the default answer validator. * * @return callable */ private function getDefaultValidator() { return function ($answer) { if (!is_bool($answer)) { throw new InvalidArgumentException('Please answer yes, y, no, or n.'); } return $answer; }; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Json; use Exception; /** * @author Jordi Boggiano */ class JsonValidationException extends Exception { /** * @var string[] */ protected $errors; /** * @param string $message * @param string[] $errors */ public function __construct($message, $errors = array(), Exception $previous = null) { $this->errors = $errors; parent::__construct((string) $message, 0, $previous); } /** * @return string[] */ public function getErrors() { return $this->errors; } } * Jordi Boggiano * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Composer\Json; use Composer\Pcre\Preg; use Composer\Repository\PlatformRepository; /** * @author Jordi Boggiano */ class JsonManipulator { /** @var string */ private static $DEFINES = '(?(DEFINE) (? -? (?= [1-9]|0(?!\d) ) \d++ (\.\d++)? ([eE] [+-]?+ \d++)? ) (? true | false | null ) (? " ([^"\\\\]*+ | \\\\ ["\\\\bfnrt\/] | \\\\ u [0-9A-Fa-f]{4} )* " ) (? \[ (?: (?&json) \s*+ (?: , (?&json) \s*+ )*+ )?+ \s*+ \] ) (? \s*+ (?&string) \s*+ : (?&json) \s*+ ) (?