diff --git a/plugins/README.md b/plugins/README.md index 03982f4..7efcb5a 100644 --- a/plugins/README.md +++ b/plugins/README.md @@ -4,6 +4,8 @@ WordPress plugins for the Headless WordPress Toolkit. Each plugin is paired with ## Plugins +- `hwp-previews`: WordPress plugin for previewing posts in a headless environment + - `hwp-cli`: WordPress plugin for CLI operations and status endpoints - NPM Package: `@placeholder/cli` - Features: REST API endpoints, admin interface diff --git a/plugins/hwp-previews.zip b/plugins/hwp-previews.zip new file mode 100644 index 0000000..c93a868 Binary files /dev/null and b/plugins/hwp-previews.zip differ diff --git a/plugins/hwp-previews/.editorconfig b/plugins/hwp-previews/.editorconfig new file mode 100644 index 0000000..465c828 --- /dev/null +++ b/plugins/hwp-previews/.editorconfig @@ -0,0 +1,18 @@ +# 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 + + +[*.md] +trim_trailing_whitespace = false diff --git a/plugins/hwp-previews/.gitignore b/plugins/hwp-previews/.gitignore new file mode 100644 index 0000000..61ead86 --- /dev/null +++ b/plugins/hwp-previews/.gitignore @@ -0,0 +1 @@ +/vendor diff --git a/plugins/hwp-previews/README.md b/plugins/hwp-previews/README.md new file mode 100644 index 0000000..365153d --- /dev/null +++ b/plugins/hwp-previews/README.md @@ -0,0 +1,139 @@ +# HWP Previews + +**Headless Previews** solution for WordPress: fully configurable preview URLs via the settings page. + +[![Version](https://img.shields.io/badge/version-0.0.1-blue)]() [![License](https://img.shields.io/badge/license-GPLv2%2B-lightgrey)]() + +--- + +## Table of Contents + +* [Overview](#overview) +* [Features](#features) +* [Configuration](#configuration) +* [Hooks & Extensibility](#hooks--extensibility) +* [Integration](#integration) + +## Overview + +HWP Previews is a robust and extensible WordPress plugin that centralizes all preview configurations into a user-friendly settings interface. +It empowers site administrators and developers to tailor preview behaviors for each public post type independently, facilitating seamless headless or decoupled workflows. +With HWP Previews, you can define dynamic URL templates, enforce unique slugs for drafts, allow all post statuses be used as parent and extend functionality through flexible hooks and filters, ensuring a consistent and conflict-free preview experience across diverse environments. + +--- + +## Features + +* **Enable/Disable Previews**: Turn preview functionality on or off for each public post type (including custom types). +* **Custom URL Templates**: Define preview URLs using placeholder tokens for dynamic content. Default tokens include: + + * `{ID}` – Post ID + * `{author_ID}` – Post author’s user ID + * `{status}` – Post status slug + * `{slug}` – Post slug + * `{parent_ID}` – Parent post ID (hierarchical types) + * `{type}` – Post type slug + * `{uri}` – Page URI/path + * `{template}` – Template filename + +* **Unique Post Slugs**: Force unique slugs for all post statuses in the post status config. +* **Parent Status**: Allow posts of **all** statuses to be used as parent within hierarchical post types. +* **Default Post Statuses Config**: `publish`, `future`, `draft`, `pending`, `private`, `auto-draft` (modifiable via core hook). +* **Parameter Registry**: Register, unregister, or customize URL tokens through the `hwp_previews_core` action. +* **Iframe Template for Previews**: Allows enable previews in the iframe on the WP Admin side. User can override the iframe preview template via `hwp_previews_template_path` filter. + +--- + +## Configuration + +### Default Post Types Config: +All public post types are enabled by default on the settings page. It is filterable via `hwp_previews_filter_post_type_setting` filter hook. + +### Default Post Statuses Config: +Post statuses are `publish`, `future`, `draft`, `pending`, `private`, `auto-draft` (modifiable via core hook). + +### Configure HWP Previews Plugin: +Navigate in WP Admin to **Settings › HWP Previews**. For each public post type, configure: + +* **Enable HWP Previews** – Master switch +* **Unique Post Slugs** – Force unique slugs for all post statuses in the post status config. +* **Allow All Statuses as Parent** – (Hierarchical types only) +* **Preview URL Template** – Custom URL with tokens like `{ID}`, `{slug}` +* **Load Previews in Iframe** – Toggle iframe-based preview rendering + +_Note: Retrieving of settings is cached for performance._ + +--- + +## Hooks & Extensibility + +### Filter: Post Types List + +Modify which post types appear in the settings UI: + +```php +// Removes attachment post type from the settings page configuration. + +add_filter( 'hwp_previews_filter_post_type_setting', 'hwp_previews_filter_post_type_setting_callback' ); +function hwp_previews_filter_post_type_setting_callback( $post_types ) { + if ( isset( $post_types['attachment'] ) ) { + unset( $post_types['attachment'] ); + } + return $post_types; +} +``` + +### Action: Core Registry + +Register or unregister URL parameters, and adjust types/statuses: + +```php +add_action( 'hwp_previews_core', 'modify_preview_url_parameters' ); +function modify_preview_url_parameters( + \HWP\Previews\Preview\Parameter\Preview_Parameter_Registry $registry +) { + // Remove default parameter + $registry->unregister( 'author_ID' ); + + // Add custom parameter + $registry->register( new \HWP\Previews\Preview\Parameter\Preview_Parameter( + 'current_time', + static fn( \WP_Post $post ) => (string) time(), + __( 'Current Unix timestamp', 'your-domain' ) + ) ); +} +``` + +Modify post types and statuses: + +```php +add_action( 'hwp_previews_core', 'modify_post_types_and_statuses_configs', 10, 3 ); +function modify_post_types_and_statuses_configs( + \HWP\Previews\Preview\Parameter\Preview_Parameter_Registry $registry, + \HWP\Previews\Post\Type\Post_Types_Config $types, + \HWP\Previews\Post\Status\Post_Statuses_Config $statuses +) { + // Limit to pages only + $types->set_post_types( [ 'page' ] ); + // Only include drafts + $statuses->set_post_statuses( [ 'draft' ] ); +} +``` + +### Filter: Iframe Template Path + +Use your own template for iframe previews: + +```php +add_filter( 'hwp_previews_template_path', function( $default_path ) { + return get_stylesheet_directory() . '/my-preview-template.php'; +}); +``` + +--- + +## Integration + + + +--- diff --git a/plugins/hwp-previews/assets/js/hwp-previews.js b/plugins/hwp-previews/assets/js/hwp-previews.js new file mode 100644 index 0000000..b6735e8 --- /dev/null +++ b/plugins/hwp-previews/assets/js/hwp-previews.js @@ -0,0 +1 @@ +console.log('hwp-preview-test'); diff --git a/plugins/hwp-previews/autoload.php b/plugins/hwp-previews/autoload.php new file mode 100644 index 0000000..7ec1ef5 --- /dev/null +++ b/plugins/hwp-previews/autoload.php @@ -0,0 +1,50 @@ +' . esc_html( $class ) . '', + '' . esc_html( $file ) . '' + ), + '1.0.0' + ); + + error_log( sprintf( 'HWP Previews: Failed to load class %s, file %s not found', $class, $file ) ); + } +} ); \ No newline at end of file diff --git a/plugins/hwp-previews/composer.json b/plugins/hwp-previews/composer.json new file mode 100644 index 0000000..a1e25f5 --- /dev/null +++ b/plugins/hwp-previews/composer.json @@ -0,0 +1,87 @@ +{ + "name": "hwp/previews", + "version": "1.0.0", + "type": "wordpress-plugin", + "description": "This is a WordPress plugin that provides a preview....", + "keywords": [ + "package", + "dependency", + "autoload" + ], + "homepage": "https://wpengine.com/", + "license": "GPL-2.0-or-later", + "authors": [ + { + "name": "WP Engine Headless OSS Development Team", + "email": "headless-oss@wpengine.com", + "homepage": "https://wpengine.com/" + } + ], + "minimum-stability": "dev", + "prefer-stable": true, + "require": { + "php": "^7.4 || ^8.0" + }, + "require-dev": { + "automattic/vipwpcs": "^3.0", + "dealerdirect/phpcodesniffer-composer-installer": "^1.0", + "humanmade/psalm-plugin-wordpress": "^3.1", + "johnpbloch/wordpress-core": "^6.8", + "phpcompatibility/phpcompatibility-wp": "^2.0", + "phpstan/phpstan-strict-rules": "^2.0", + "slevomat/coding-standard": "^8.0", + "szepeviktor/phpstan-wordpress": "^2.0" + }, + "config": { + "allow-plugins": { + "dealerdirect/phpcodesniffer-composer-installer": true, + "phpstan/extension-installer": true + }, + "optimize-autoloader": true, + "platform": { + "php": "7.4" + }, + "preferred-install": "dist", + "sort-packages": true + }, + "extra": { + "phpstan": { + "includes": [ + "phpstan/rules.neon" + ] + } + }, + "autoload": { + "psr-4": { + "HWP\\Previews\\": "src/" + } + }, + "autoload-dev": { + "psr-4": { + "HWP\\Previews\\Unit\\": "tests/unit/", + "HWP\\Previews\\Integration\\": "tests/integration/", + "HWP\\Previews\\PHPStan\\": "phpstan/", + "HWPStandard\\": "phpcs/HWPStandard" + } + }, + "scripts": { + "php:lint": "vendor/bin/phpcs", + "php:lint:i": [ + "php ./vendor/bin/phpcs -i" + ], + "php:lint:fix": "vendor/bin/phpcbf", + "php:stan": [ + "phpstan analyze --ansi --memory-limit=2G -v" + ], + "php:psalm": "psalm" + }, + "scripts-descriptions": { + }, + "support": { + "docs": "https://github.com/composer/composer/docs", + "email": "headless-oss@wpengine.com", + "forum": "https://github.com/composer/composer/forum", + "issues": "https://github.com/composer/composer/issues", + "security": "https://github.com/composer/composer/security/policy" + } +} diff --git a/plugins/hwp-previews/composer.lock b/plugins/hwp-previews/composer.lock new file mode 100644 index 0000000..59169e0 --- /dev/null +++ b/plugins/hwp-previews/composer.lock @@ -0,0 +1,3527 @@ +{ + "_readme": [ + "This file locks the dependencies of your project to a known state", + "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies", + "This file is @generated automatically" + ], + "content-hash": "a833cde255a62cc18472ed252c99b7be", + "packages": [], + "packages-dev": [ + { + "name": "amphp/amp", + "version": "v2.6.4", + "source": { + "type": "git", + "url": "https://github.com/amphp/amp.git", + "reference": "ded3d9be08f526089eb7ee8d9f16a9768f9dec2d" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/amphp/amp/zipball/ded3d9be08f526089eb7ee8d9f16a9768f9dec2d", + "reference": "ded3d9be08f526089eb7ee8d9f16a9768f9dec2d", + "shasum": "" + }, + "require": { + "php": ">=7.1" + }, + "require-dev": { + "amphp/php-cs-fixer-config": "dev-master", + "amphp/phpunit-util": "^1", + "ext-json": "*", + "jetbrains/phpstorm-stubs": "^2019.3", + "phpunit/phpunit": "^7 | ^8 | ^9", + "react/promise": "^2", + "vimeo/psalm": "^3.12" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "2.x-dev" + } + }, + "autoload": { + "files": [ + "lib/functions.php", + "lib/Internal/functions.php" + ], + "psr-4": { + "Amp\\": "lib" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Daniel Lowrey", + "email": "rdlowrey@php.net" + }, + { + "name": "Aaron Piotrowski", + "email": "aaron@trowski.com" + }, + { + "name": "Bob Weinand", + "email": "bobwei9@hotmail.com" + }, + { + "name": "Niklas Keller", + "email": "me@kelunik.com" + } + ], + "description": "A non-blocking concurrency framework for PHP applications.", + "homepage": "https://amphp.org/amp", + "keywords": [ + "async", + "asynchronous", + "awaitable", + "concurrency", + "event", + "event-loop", + "future", + "non-blocking", + "promise" + ], + "support": { + "irc": "irc://irc.freenode.org/amphp", + "issues": "https://github.com/amphp/amp/issues", + "source": "https://github.com/amphp/amp/tree/v2.6.4" + }, + "funding": [ + { + "url": "https://github.com/amphp", + "type": "github" + } + ], + "time": "2024-03-21T18:52:26+00:00" + }, + { + "name": "amphp/byte-stream", + "version": "v1.8.2", + "source": { + "type": "git", + "url": "https://github.com/amphp/byte-stream.git", + "reference": "4f0e968ba3798a423730f567b1b50d3441c16ddc" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/amphp/byte-stream/zipball/4f0e968ba3798a423730f567b1b50d3441c16ddc", + "reference": "4f0e968ba3798a423730f567b1b50d3441c16ddc", + "shasum": "" + }, + "require": { + "amphp/amp": "^2", + "php": ">=7.1" + }, + "require-dev": { + "amphp/php-cs-fixer-config": "dev-master", + "amphp/phpunit-util": "^1.4", + "friendsofphp/php-cs-fixer": "^2.3", + "jetbrains/phpstorm-stubs": "^2019.3", + "phpunit/phpunit": "^6 || ^7 || ^8", + "psalm/phar": "^3.11.4" + }, + "type": "library", + "autoload": { + "files": [ + "lib/functions.php" + ], + "psr-4": { + "Amp\\ByteStream\\": "lib" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Aaron Piotrowski", + "email": "aaron@trowski.com" + }, + { + "name": "Niklas Keller", + "email": "me@kelunik.com" + } + ], + "description": "A stream abstraction to make working with non-blocking I/O simple.", + "homepage": "https://amphp.org/byte-stream", + "keywords": [ + "amp", + "amphp", + "async", + "io", + "non-blocking", + "stream" + ], + "support": { + "issues": "https://github.com/amphp/byte-stream/issues", + "source": "https://github.com/amphp/byte-stream/tree/v1.8.2" + }, + "funding": [ + { + "url": "https://github.com/amphp", + "type": "github" + } + ], + "time": "2024-04-13T18:00:56+00:00" + }, + { + "name": "automattic/vipwpcs", + "version": "3.0.1", + "source": { + "type": "git", + "url": "https://github.com/Automattic/VIP-Coding-Standards.git", + "reference": "2b1d206d81b74ed999023cffd924f862ff2753c8" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/Automattic/VIP-Coding-Standards/zipball/2b1d206d81b74ed999023cffd924f862ff2753c8", + "reference": "2b1d206d81b74ed999023cffd924f862ff2753c8", + "shasum": "" + }, + "require": { + "php": ">=5.4", + "phpcsstandards/phpcsextra": "^1.2.1", + "phpcsstandards/phpcsutils": "^1.0.11", + "sirbrillig/phpcs-variable-analysis": "^2.11.18", + "squizlabs/php_codesniffer": "^3.9.2", + "wp-coding-standards/wpcs": "^3.1.0" + }, + "require-dev": { + "php-parallel-lint/php-console-highlighter": "^1.0.0", + "php-parallel-lint/php-parallel-lint": "^1.3.2", + "phpcompatibility/php-compatibility": "^9", + "phpcsstandards/phpcsdevtools": "^1.0", + "phpunit/phpunit": "^4 || ^5 || ^6 || ^7 || ^8 || ^9" + }, + "type": "phpcodesniffer-standard", + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Contributors", + "homepage": "https://github.com/Automattic/VIP-Coding-Standards/graphs/contributors" + } + ], + "description": "PHP_CodeSniffer rules (sniffs) to enforce WordPress VIP minimum coding conventions", + "keywords": [ + "phpcs", + "standards", + "static analysis", + "wordpress" + ], + "support": { + "issues": "https://github.com/Automattic/VIP-Coding-Standards/issues", + "source": "https://github.com/Automattic/VIP-Coding-Standards", + "wiki": "https://github.com/Automattic/VIP-Coding-Standards/wiki" + }, + "time": "2024-05-10T20:31:09+00:00" + }, + { + "name": "composer/pcre", + "version": "3.3.2", + "source": { + "type": "git", + "url": "https://github.com/composer/pcre.git", + "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/composer/pcre/zipball/b2bed4734f0cc156ee1fe9c0da2550420d99a21e", + "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e", + "shasum": "" + }, + "require": { + "php": "^7.4 || ^8.0" + }, + "conflict": { + "phpstan/phpstan": "<1.11.10" + }, + "require-dev": { + "phpstan/phpstan": "^1.12 || ^2", + "phpstan/phpstan-strict-rules": "^1 || ^2", + "phpunit/phpunit": "^8 || ^9" + }, + "type": "library", + "extra": { + "phpstan": { + "includes": [ + "extension.neon" + ] + }, + "branch-alias": { + "dev-main": "3.x-dev" + } + }, + "autoload": { + "psr-4": { + "Composer\\Pcre\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Jordi Boggiano", + "email": "j.boggiano@seld.be", + "homepage": "http://seld.be" + } + ], + "description": "PCRE wrapping library that offers type-safe preg_* replacements.", + "keywords": [ + "PCRE", + "preg", + "regex", + "regular expression" + ], + "support": { + "issues": "https://github.com/composer/pcre/issues", + "source": "https://github.com/composer/pcre/tree/3.3.2" + }, + "funding": [ + { + "url": "https://packagist.com", + "type": "custom" + }, + { + "url": "https://github.com/composer", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/composer/composer", + "type": "tidelift" + } + ], + "time": "2024-11-12T16:29:46+00:00" + }, + { + "name": "composer/semver", + "version": "3.4.3", + "source": { + "type": "git", + "url": "https://github.com/composer/semver.git", + "reference": "4313d26ada5e0c4edfbd1dc481a92ff7bff91f12" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/composer/semver/zipball/4313d26ada5e0c4edfbd1dc481a92ff7bff91f12", + "reference": "4313d26ada5e0c4edfbd1dc481a92ff7bff91f12", + "shasum": "" + }, + "require": { + "php": "^5.3.2 || ^7.0 || ^8.0" + }, + "require-dev": { + "phpstan/phpstan": "^1.11", + "symfony/phpunit-bridge": "^3 || ^7" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-main": "3.x-dev" + } + }, + "autoload": { + "psr-4": { + "Composer\\Semver\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nils Adermann", + "email": "naderman@naderman.de", + "homepage": "http://www.naderman.de" + }, + { + "name": "Jordi Boggiano", + "email": "j.boggiano@seld.be", + "homepage": "http://seld.be" + }, + { + "name": "Rob Bast", + "email": "rob.bast@gmail.com", + "homepage": "http://robbast.nl" + } + ], + "description": "Semver library that offers utilities, version constraint parsing and validation.", + "keywords": [ + "semantic", + "semver", + "validation", + "versioning" + ], + "support": { + "irc": "ircs://irc.libera.chat:6697/composer", + "issues": "https://github.com/composer/semver/issues", + "source": "https://github.com/composer/semver/tree/3.4.3" + }, + "funding": [ + { + "url": "https://packagist.com", + "type": "custom" + }, + { + "url": "https://github.com/composer", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/composer/composer", + "type": "tidelift" + } + ], + "time": "2024-09-19T14:15:21+00:00" + }, + { + "name": "composer/xdebug-handler", + "version": "3.0.5", + "source": { + "type": "git", + "url": "https://github.com/composer/xdebug-handler.git", + "reference": "6c1925561632e83d60a44492e0b344cf48ab85ef" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/composer/xdebug-handler/zipball/6c1925561632e83d60a44492e0b344cf48ab85ef", + "reference": "6c1925561632e83d60a44492e0b344cf48ab85ef", + "shasum": "" + }, + "require": { + "composer/pcre": "^1 || ^2 || ^3", + "php": "^7.2.5 || ^8.0", + "psr/log": "^1 || ^2 || ^3" + }, + "require-dev": { + "phpstan/phpstan": "^1.0", + "phpstan/phpstan-strict-rules": "^1.1", + "phpunit/phpunit": "^8.5 || ^9.6 || ^10.5" + }, + "type": "library", + "autoload": { + "psr-4": { + "Composer\\XdebugHandler\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "John Stevenson", + "email": "john-stevenson@blueyonder.co.uk" + } + ], + "description": "Restarts a process without Xdebug.", + "keywords": [ + "Xdebug", + "performance" + ], + "support": { + "irc": "ircs://irc.libera.chat:6697/composer", + "issues": "https://github.com/composer/xdebug-handler/issues", + "source": "https://github.com/composer/xdebug-handler/tree/3.0.5" + }, + "funding": [ + { + "url": "https://packagist.com", + "type": "custom" + }, + { + "url": "https://github.com/composer", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/composer/composer", + "type": "tidelift" + } + ], + "time": "2024-05-06T16:37:16+00:00" + }, + { + "name": "dealerdirect/phpcodesniffer-composer-installer", + "version": "v1.0.0", + "source": { + "type": "git", + "url": "https://github.com/PHPCSStandards/composer-installer.git", + "reference": "4be43904336affa5c2f70744a348312336afd0da" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/PHPCSStandards/composer-installer/zipball/4be43904336affa5c2f70744a348312336afd0da", + "reference": "4be43904336affa5c2f70744a348312336afd0da", + "shasum": "" + }, + "require": { + "composer-plugin-api": "^1.0 || ^2.0", + "php": ">=5.4", + "squizlabs/php_codesniffer": "^2.0 || ^3.1.0 || ^4.0" + }, + "require-dev": { + "composer/composer": "*", + "ext-json": "*", + "ext-zip": "*", + "php-parallel-lint/php-parallel-lint": "^1.3.1", + "phpcompatibility/php-compatibility": "^9.0", + "yoast/phpunit-polyfills": "^1.0" + }, + "type": "composer-plugin", + "extra": { + "class": "PHPCSStandards\\Composer\\Plugin\\Installers\\PHPCodeSniffer\\Plugin" + }, + "autoload": { + "psr-4": { + "PHPCSStandards\\Composer\\Plugin\\Installers\\PHPCodeSniffer\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Franck Nijhof", + "email": "franck.nijhof@dealerdirect.com", + "homepage": "http://www.frenck.nl", + "role": "Developer / IT Manager" + }, + { + "name": "Contributors", + "homepage": "https://github.com/PHPCSStandards/composer-installer/graphs/contributors" + } + ], + "description": "PHP_CodeSniffer Standards Composer Installer Plugin", + "homepage": "http://www.dealerdirect.com", + "keywords": [ + "PHPCodeSniffer", + "PHP_CodeSniffer", + "code quality", + "codesniffer", + "composer", + "installer", + "phpcbf", + "phpcs", + "plugin", + "qa", + "quality", + "standard", + "standards", + "style guide", + "stylecheck", + "tests" + ], + "support": { + "issues": "https://github.com/PHPCSStandards/composer-installer/issues", + "source": "https://github.com/PHPCSStandards/composer-installer" + }, + "time": "2023-01-05T11:28:13+00:00" + }, + { + "name": "dnoegel/php-xdg-base-dir", + "version": "v0.1.1", + "source": { + "type": "git", + "url": "https://github.com/dnoegel/php-xdg-base-dir.git", + "reference": "8f8a6e48c5ecb0f991c2fdcf5f154a47d85f9ffd" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/dnoegel/php-xdg-base-dir/zipball/8f8a6e48c5ecb0f991c2fdcf5f154a47d85f9ffd", + "reference": "8f8a6e48c5ecb0f991c2fdcf5f154a47d85f9ffd", + "shasum": "" + }, + "require": { + "php": ">=5.3.2" + }, + "require-dev": { + "phpunit/phpunit": "~7.0|~6.0|~5.0|~4.8.35" + }, + "type": "library", + "autoload": { + "psr-4": { + "XdgBaseDir\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "implementation of xdg base directory specification for php", + "support": { + "issues": "https://github.com/dnoegel/php-xdg-base-dir/issues", + "source": "https://github.com/dnoegel/php-xdg-base-dir/tree/v0.1.1" + }, + "time": "2019-12-04T15:06:13+00:00" + }, + { + "name": "doctrine/deprecations", + "version": "1.1.5", + "source": { + "type": "git", + "url": "https://github.com/doctrine/deprecations.git", + "reference": "459c2f5dd3d6a4633d3b5f46ee2b1c40f57d3f38" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/doctrine/deprecations/zipball/459c2f5dd3d6a4633d3b5f46ee2b1c40f57d3f38", + "reference": "459c2f5dd3d6a4633d3b5f46ee2b1c40f57d3f38", + "shasum": "" + }, + "require": { + "php": "^7.1 || ^8.0" + }, + "conflict": { + "phpunit/phpunit": "<=7.5 || >=13" + }, + "require-dev": { + "doctrine/coding-standard": "^9 || ^12 || ^13", + "phpstan/phpstan": "1.4.10 || 2.1.11", + "phpstan/phpstan-phpunit": "^1.0 || ^2", + "phpunit/phpunit": "^7.5 || ^8.5 || ^9.6 || ^10.5 || ^11.5 || ^12", + "psr/log": "^1 || ^2 || ^3" + }, + "suggest": { + "psr/log": "Allows logging deprecations via PSR-3 logger implementation" + }, + "type": "library", + "autoload": { + "psr-4": { + "Doctrine\\Deprecations\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "A small layer on top of trigger_error(E_USER_DEPRECATED) or PSR-3 logging with options to disable all deprecations or selectively for packages.", + "homepage": "https://www.doctrine-project.org/", + "support": { + "issues": "https://github.com/doctrine/deprecations/issues", + "source": "https://github.com/doctrine/deprecations/tree/1.1.5" + }, + "time": "2025-04-07T20:06:18+00:00" + }, + { + "name": "felixfbecker/advanced-json-rpc", + "version": "v3.2.1", + "source": { + "type": "git", + "url": "https://github.com/felixfbecker/php-advanced-json-rpc.git", + "reference": "b5f37dbff9a8ad360ca341f3240dc1c168b45447" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/felixfbecker/php-advanced-json-rpc/zipball/b5f37dbff9a8ad360ca341f3240dc1c168b45447", + "reference": "b5f37dbff9a8ad360ca341f3240dc1c168b45447", + "shasum": "" + }, + "require": { + "netresearch/jsonmapper": "^1.0 || ^2.0 || ^3.0 || ^4.0", + "php": "^7.1 || ^8.0", + "phpdocumentor/reflection-docblock": "^4.3.4 || ^5.0.0" + }, + "require-dev": { + "phpunit/phpunit": "^7.0 || ^8.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "AdvancedJsonRpc\\": "lib/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "ISC" + ], + "authors": [ + { + "name": "Felix Becker", + "email": "felix.b@outlook.com" + } + ], + "description": "A more advanced JSONRPC implementation", + "support": { + "issues": "https://github.com/felixfbecker/php-advanced-json-rpc/issues", + "source": "https://github.com/felixfbecker/php-advanced-json-rpc/tree/v3.2.1" + }, + "time": "2021-06-11T22:34:44+00:00" + }, + { + "name": "felixfbecker/language-server-protocol", + "version": "v1.5.3", + "source": { + "type": "git", + "url": "https://github.com/felixfbecker/php-language-server-protocol.git", + "reference": "a9e113dbc7d849e35b8776da39edaf4313b7b6c9" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/felixfbecker/php-language-server-protocol/zipball/a9e113dbc7d849e35b8776da39edaf4313b7b6c9", + "reference": "a9e113dbc7d849e35b8776da39edaf4313b7b6c9", + "shasum": "" + }, + "require": { + "php": ">=7.1" + }, + "require-dev": { + "phpstan/phpstan": "*", + "squizlabs/php_codesniffer": "^3.1", + "vimeo/psalm": "^4.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.x-dev" + } + }, + "autoload": { + "psr-4": { + "LanguageServerProtocol\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "ISC" + ], + "authors": [ + { + "name": "Felix Becker", + "email": "felix.b@outlook.com" + } + ], + "description": "PHP classes for the Language Server Protocol", + "keywords": [ + "language", + "microsoft", + "php", + "server" + ], + "support": { + "issues": "https://github.com/felixfbecker/php-language-server-protocol/issues", + "source": "https://github.com/felixfbecker/php-language-server-protocol/tree/v1.5.3" + }, + "time": "2024-04-30T00:40:11+00:00" + }, + { + "name": "fidry/cpu-core-counter", + "version": "1.2.0", + "source": { + "type": "git", + "url": "https://github.com/theofidry/cpu-core-counter.git", + "reference": "8520451a140d3f46ac33042715115e290cf5785f" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/theofidry/cpu-core-counter/zipball/8520451a140d3f46ac33042715115e290cf5785f", + "reference": "8520451a140d3f46ac33042715115e290cf5785f", + "shasum": "" + }, + "require": { + "php": "^7.2 || ^8.0" + }, + "require-dev": { + "fidry/makefile": "^0.2.0", + "fidry/php-cs-fixer-config": "^1.1.2", + "phpstan/extension-installer": "^1.2.0", + "phpstan/phpstan": "^1.9.2", + "phpstan/phpstan-deprecation-rules": "^1.0.0", + "phpstan/phpstan-phpunit": "^1.2.2", + "phpstan/phpstan-strict-rules": "^1.4.4", + "phpunit/phpunit": "^8.5.31 || ^9.5.26", + "webmozarts/strict-phpunit": "^7.5" + }, + "type": "library", + "autoload": { + "psr-4": { + "Fidry\\CpuCoreCounter\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Théo FIDRY", + "email": "theo.fidry@gmail.com" + } + ], + "description": "Tiny utility to get the number of CPU cores.", + "keywords": [ + "CPU", + "core" + ], + "support": { + "issues": "https://github.com/theofidry/cpu-core-counter/issues", + "source": "https://github.com/theofidry/cpu-core-counter/tree/1.2.0" + }, + "funding": [ + { + "url": "https://github.com/theofidry", + "type": "github" + } + ], + "time": "2024-08-06T10:04:20+00:00" + }, + { + "name": "humanmade/psalm-plugin-wordpress", + "version": "3.1.2", + "source": { + "type": "git", + "url": "https://github.com/psalm/psalm-plugin-wordpress.git", + "reference": "3f4689ad5264eee7b37121053cec810a3754f7e4" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/psalm/psalm-plugin-wordpress/zipball/3f4689ad5264eee7b37121053cec810a3754f7e4", + "reference": "3f4689ad5264eee7b37121053cec810a3754f7e4", + "shasum": "" + }, + "require": { + "ext-simplexml": "*", + "php-stubs/wordpress-globals": "^0.2.0", + "php-stubs/wordpress-stubs": "^6.0", + "php-stubs/wp-cli-stubs": "^2.7", + "vimeo/psalm": "^5 || ^6", + "wp-hooks/wordpress-core": "^1.3.0" + }, + "require-dev": { + "humanmade/coding-standards": "^1.2", + "phpunit/phpunit": "^9.0", + "psalm/plugin-phpunit": "^0.18.4" + }, + "type": "psalm-plugin", + "extra": { + "psalm": { + "pluginClass": "PsalmWordPress\\Plugin" + } + }, + "autoload": { + "psr-4": { + "PsalmWordPress\\": [ + "." + ] + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "kkmuffme", + "role": "Maintainer" + }, + { + "name": "Joe Hoyle", + "role": "Creator" + } + ], + "description": "WordPress stubs and plugin for Psalm static analysis.", + "support": { + "issues": "https://github.com/psalm/psalm-plugin-wordpress/issues", + "source": "https://github.com/psalm/psalm-plugin-wordpress" + }, + "time": "2024-04-01T10:36:11+00:00" + }, + { + "name": "johnpbloch/wordpress-core", + "version": "6.8.0", + "source": { + "type": "git", + "url": "https://github.com/johnpbloch/wordpress-core.git", + "reference": "74197a5012b0a72834ffc58bb32ef0045f15a26c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/johnpbloch/wordpress-core/zipball/74197a5012b0a72834ffc58bb32ef0045f15a26c", + "reference": "74197a5012b0a72834ffc58bb32ef0045f15a26c", + "shasum": "" + }, + "require": { + "ext-json": "*", + "php": ">=7.2.24" + }, + "provide": { + "wordpress/core-implementation": "6.8.0" + }, + "type": "wordpress-core", + "notification-url": "https://packagist.org/downloads/", + "license": [ + "GPL-2.0-or-later" + ], + "authors": [ + { + "name": "WordPress Community", + "homepage": "https://wordpress.org/about/" + } + ], + "description": "WordPress is open source software you can use to create a beautiful website, blog, or app.", + "homepage": "https://wordpress.org/", + "keywords": [ + "blog", + "cms", + "wordpress" + ], + "support": { + "forum": "https://wordpress.org/support/", + "irc": "irc://irc.freenode.net/wordpress", + "issues": "https://core.trac.wordpress.org/", + "source": "https://core.trac.wordpress.org/browser", + "wiki": "https://codex.wordpress.org/" + }, + "time": "2025-04-15T15:47:20+00:00" + }, + { + "name": "netresearch/jsonmapper", + "version": "v4.5.0", + "source": { + "type": "git", + "url": "https://github.com/cweiske/jsonmapper.git", + "reference": "8e76efb98ee8b6afc54687045e1b8dba55ac76e5" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/cweiske/jsonmapper/zipball/8e76efb98ee8b6afc54687045e1b8dba55ac76e5", + "reference": "8e76efb98ee8b6afc54687045e1b8dba55ac76e5", + "shasum": "" + }, + "require": { + "ext-json": "*", + "ext-pcre": "*", + "ext-reflection": "*", + "ext-spl": "*", + "php": ">=7.1" + }, + "require-dev": { + "phpunit/phpunit": "~7.5 || ~8.0 || ~9.0 || ~10.0", + "squizlabs/php_codesniffer": "~3.5" + }, + "type": "library", + "autoload": { + "psr-0": { + "JsonMapper": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "OSL-3.0" + ], + "authors": [ + { + "name": "Christian Weiske", + "email": "cweiske@cweiske.de", + "homepage": "http://github.com/cweiske/jsonmapper/", + "role": "Developer" + } + ], + "description": "Map nested JSON structures onto PHP classes", + "support": { + "email": "cweiske@cweiske.de", + "issues": "https://github.com/cweiske/jsonmapper/issues", + "source": "https://github.com/cweiske/jsonmapper/tree/v4.5.0" + }, + "time": "2024-09-08T10:13:13+00:00" + }, + { + "name": "nikic/php-parser", + "version": "v4.19.4", + "source": { + "type": "git", + "url": "https://github.com/nikic/PHP-Parser.git", + "reference": "715f4d25e225bc47b293a8b997fe6ce99bf987d2" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/715f4d25e225bc47b293a8b997fe6ce99bf987d2", + "reference": "715f4d25e225bc47b293a8b997fe6ce99bf987d2", + "shasum": "" + }, + "require": { + "ext-tokenizer": "*", + "php": ">=7.1" + }, + "require-dev": { + "ircmaxell/php-yacc": "^0.0.7", + "phpunit/phpunit": "^7.0 || ^8.0 || ^9.0" + }, + "bin": [ + "bin/php-parse" + ], + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "4.9-dev" + } + }, + "autoload": { + "psr-4": { + "PhpParser\\": "lib/PhpParser" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Nikita Popov" + } + ], + "description": "A PHP parser written in PHP", + "keywords": [ + "parser", + "php" + ], + "support": { + "issues": "https://github.com/nikic/PHP-Parser/issues", + "source": "https://github.com/nikic/PHP-Parser/tree/v4.19.4" + }, + "time": "2024-09-29T15:01:53+00:00" + }, + { + "name": "php-stubs/wordpress-globals", + "version": "v0.2.0", + "source": { + "type": "git", + "url": "https://github.com/php-stubs/wordpress-globals.git", + "reference": "748a1fb2ae8fda94844bd0545935095dbf404b32" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-stubs/wordpress-globals/zipball/748a1fb2ae8fda94844bd0545935095dbf404b32", + "reference": "748a1fb2ae8fda94844bd0545935095dbf404b32", + "shasum": "" + }, + "require-dev": { + "php": "~7.1" + }, + "suggest": { + "php-stubs/wordpress-stubs": "Up-to-date WordPress function and class declaration stubs", + "szepeviktor/phpstan-wordpress": "WordPress extensions for PHPStan" + }, + "type": "library", + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Global variables and global constants from WordPress core.", + "homepage": "https://github.com/php-stubs/wordpress-globals", + "keywords": [ + "PHPStan", + "constants", + "globals", + "static analysis", + "wordpress" + ], + "support": { + "issues": "https://github.com/php-stubs/wordpress-globals/issues", + "source": "https://github.com/php-stubs/wordpress-globals/tree/master" + }, + "time": "2020-01-13T06:12:59+00:00" + }, + { + "name": "php-stubs/wordpress-stubs", + "version": "v6.8.0", + "source": { + "type": "git", + "url": "https://github.com/php-stubs/wordpress-stubs.git", + "reference": "1824db4d1d00d32c0119175d2369d9425dbc4953" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-stubs/wordpress-stubs/zipball/1824db4d1d00d32c0119175d2369d9425dbc4953", + "reference": "1824db4d1d00d32c0119175d2369d9425dbc4953", + "shasum": "" + }, + "conflict": { + "phpdocumentor/reflection-docblock": "5.6.1" + }, + "require-dev": { + "dealerdirect/phpcodesniffer-composer-installer": "^1.0", + "nikic/php-parser": "^4.13", + "php": "^7.4 || ^8.0", + "php-stubs/generator": "^0.8.3", + "phpdocumentor/reflection-docblock": "^5.4.1", + "phpstan/phpstan": "^2.1", + "phpunit/phpunit": "^9.5", + "szepeviktor/phpcs-psr-12-neutron-hybrid-ruleset": "^1.1.1", + "wp-coding-standards/wpcs": "3.1.0 as 2.3.0" + }, + "suggest": { + "paragonie/sodium_compat": "Pure PHP implementation of libsodium", + "symfony/polyfill-php80": "Symfony polyfill backporting some PHP 8.0+ features to lower PHP versions", + "szepeviktor/phpstan-wordpress": "WordPress extensions for PHPStan" + }, + "type": "library", + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "WordPress function and class declaration stubs for static analysis.", + "homepage": "https://github.com/php-stubs/wordpress-stubs", + "keywords": [ + "PHPStan", + "static analysis", + "wordpress" + ], + "support": { + "issues": "https://github.com/php-stubs/wordpress-stubs/issues", + "source": "https://github.com/php-stubs/wordpress-stubs/tree/v6.8.0" + }, + "time": "2025-04-17T15:13:53+00:00" + }, + { + "name": "php-stubs/wp-cli-stubs", + "version": "v2.11.0", + "source": { + "type": "git", + "url": "https://github.com/php-stubs/wp-cli-stubs.git", + "reference": "f27ff9e8e29d7962cb070e58de70dfaf63183007" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-stubs/wp-cli-stubs/zipball/f27ff9e8e29d7962cb070e58de70dfaf63183007", + "reference": "f27ff9e8e29d7962cb070e58de70dfaf63183007", + "shasum": "" + }, + "require": { + "php-stubs/wordpress-stubs": "^4.7 || ^5.0 || ^6.0" + }, + "require-dev": { + "php": "~7.3 || ~8.0", + "php-stubs/generator": "^0.8.0" + }, + "suggest": { + "symfony/polyfill-php73": "Symfony polyfill backporting some PHP 7.3+ features to lower PHP versions", + "szepeviktor/phpstan-wordpress": "WordPress extensions for PHPStan" + }, + "type": "library", + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "WP-CLI function and class declaration stubs for static analysis.", + "homepage": "https://github.com/php-stubs/wp-cli-stubs", + "keywords": [ + "PHPStan", + "static analysis", + "wordpress", + "wp-cli" + ], + "support": { + "issues": "https://github.com/php-stubs/wp-cli-stubs/issues", + "source": "https://github.com/php-stubs/wp-cli-stubs/tree/v2.11.0" + }, + "time": "2024-11-25T10:09:13+00:00" + }, + { + "name": "phpcompatibility/php-compatibility", + "version": "9.3.5", + "source": { + "type": "git", + "url": "https://github.com/PHPCompatibility/PHPCompatibility.git", + "reference": "9fb324479acf6f39452e0655d2429cc0d3914243" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/PHPCompatibility/PHPCompatibility/zipball/9fb324479acf6f39452e0655d2429cc0d3914243", + "reference": "9fb324479acf6f39452e0655d2429cc0d3914243", + "shasum": "" + }, + "require": { + "php": ">=5.3", + "squizlabs/php_codesniffer": "^2.3 || ^3.0.2" + }, + "conflict": { + "squizlabs/php_codesniffer": "2.6.2" + }, + "require-dev": { + "phpunit/phpunit": "~4.5 || ^5.0 || ^6.0 || ^7.0" + }, + "suggest": { + "dealerdirect/phpcodesniffer-composer-installer": "^0.5 || This Composer plugin will sort out the PHPCS 'installed_paths' automatically.", + "roave/security-advisories": "dev-master || Helps prevent installing dependencies with known security issues." + }, + "type": "phpcodesniffer-standard", + "notification-url": "https://packagist.org/downloads/", + "license": [ + "LGPL-3.0-or-later" + ], + "authors": [ + { + "name": "Wim Godden", + "homepage": "https://github.com/wimg", + "role": "lead" + }, + { + "name": "Juliette Reinders Folmer", + "homepage": "https://github.com/jrfnl", + "role": "lead" + }, + { + "name": "Contributors", + "homepage": "https://github.com/PHPCompatibility/PHPCompatibility/graphs/contributors" + } + ], + "description": "A set of sniffs for PHP_CodeSniffer that checks for PHP cross-version compatibility.", + "homepage": "http://techblog.wimgodden.be/tag/codesniffer/", + "keywords": [ + "compatibility", + "phpcs", + "standards" + ], + "support": { + "issues": "https://github.com/PHPCompatibility/PHPCompatibility/issues", + "source": "https://github.com/PHPCompatibility/PHPCompatibility" + }, + "time": "2019-12-27T09:44:58+00:00" + }, + { + "name": "phpcompatibility/phpcompatibility-paragonie", + "version": "1.3.3", + "source": { + "type": "git", + "url": "https://github.com/PHPCompatibility/PHPCompatibilityParagonie.git", + "reference": "293975b465e0e709b571cbf0c957c6c0a7b9a2ac" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/PHPCompatibility/PHPCompatibilityParagonie/zipball/293975b465e0e709b571cbf0c957c6c0a7b9a2ac", + "reference": "293975b465e0e709b571cbf0c957c6c0a7b9a2ac", + "shasum": "" + }, + "require": { + "phpcompatibility/php-compatibility": "^9.0" + }, + "require-dev": { + "dealerdirect/phpcodesniffer-composer-installer": "^1.0", + "paragonie/random_compat": "dev-master", + "paragonie/sodium_compat": "dev-master" + }, + "suggest": { + "dealerdirect/phpcodesniffer-composer-installer": "^1.0 || This Composer plugin will sort out the PHP_CodeSniffer 'installed_paths' automatically.", + "roave/security-advisories": "dev-master || Helps prevent installing dependencies with known security issues." + }, + "type": "phpcodesniffer-standard", + "notification-url": "https://packagist.org/downloads/", + "license": [ + "LGPL-3.0-or-later" + ], + "authors": [ + { + "name": "Wim Godden", + "role": "lead" + }, + { + "name": "Juliette Reinders Folmer", + "role": "lead" + } + ], + "description": "A set of rulesets for PHP_CodeSniffer to check for PHP cross-version compatibility issues in projects, while accounting for polyfills provided by the Paragonie polyfill libraries.", + "homepage": "http://phpcompatibility.com/", + "keywords": [ + "compatibility", + "paragonie", + "phpcs", + "polyfill", + "standards", + "static analysis" + ], + "support": { + "issues": "https://github.com/PHPCompatibility/PHPCompatibilityParagonie/issues", + "security": "https://github.com/PHPCompatibility/PHPCompatibilityParagonie/security/policy", + "source": "https://github.com/PHPCompatibility/PHPCompatibilityParagonie" + }, + "funding": [ + { + "url": "https://github.com/PHPCompatibility", + "type": "github" + }, + { + "url": "https://github.com/jrfnl", + "type": "github" + }, + { + "url": "https://opencollective.com/php_codesniffer", + "type": "open_collective" + } + ], + "time": "2024-04-24T21:30:46+00:00" + }, + { + "name": "phpcompatibility/phpcompatibility-wp", + "version": "2.1.6", + "source": { + "type": "git", + "url": "https://github.com/PHPCompatibility/PHPCompatibilityWP.git", + "reference": "80ccb1a7640995edf1b87a4409fa584cd5869469" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/PHPCompatibility/PHPCompatibilityWP/zipball/80ccb1a7640995edf1b87a4409fa584cd5869469", + "reference": "80ccb1a7640995edf1b87a4409fa584cd5869469", + "shasum": "" + }, + "require": { + "phpcompatibility/php-compatibility": "^9.0", + "phpcompatibility/phpcompatibility-paragonie": "^1.0" + }, + "require-dev": { + "dealerdirect/phpcodesniffer-composer-installer": "^1.0" + }, + "suggest": { + "dealerdirect/phpcodesniffer-composer-installer": "^1.0 || This Composer plugin will sort out the PHP_CodeSniffer 'installed_paths' automatically.", + "roave/security-advisories": "dev-master || Helps prevent installing dependencies with known security issues." + }, + "type": "phpcodesniffer-standard", + "notification-url": "https://packagist.org/downloads/", + "license": [ + "LGPL-3.0-or-later" + ], + "authors": [ + { + "name": "Wim Godden", + "role": "lead" + }, + { + "name": "Juliette Reinders Folmer", + "role": "lead" + } + ], + "description": "A ruleset for PHP_CodeSniffer to check for PHP cross-version compatibility issues in projects, while accounting for polyfills provided by WordPress.", + "homepage": "http://phpcompatibility.com/", + "keywords": [ + "compatibility", + "phpcs", + "standards", + "static analysis", + "wordpress" + ], + "support": { + "issues": "https://github.com/PHPCompatibility/PHPCompatibilityWP/issues", + "security": "https://github.com/PHPCompatibility/PHPCompatibilityWP/security/policy", + "source": "https://github.com/PHPCompatibility/PHPCompatibilityWP" + }, + "funding": [ + { + "url": "https://github.com/PHPCompatibility", + "type": "github" + }, + { + "url": "https://github.com/jrfnl", + "type": "github" + }, + { + "url": "https://opencollective.com/php_codesniffer", + "type": "open_collective" + } + ], + "time": "2025-01-16T22:34:19+00:00" + }, + { + "name": "phpcsstandards/phpcsextra", + "version": "1.2.1", + "source": { + "type": "git", + "url": "https://github.com/PHPCSStandards/PHPCSExtra.git", + "reference": "11d387c6642b6e4acaf0bd9bf5203b8cca1ec489" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/PHPCSStandards/PHPCSExtra/zipball/11d387c6642b6e4acaf0bd9bf5203b8cca1ec489", + "reference": "11d387c6642b6e4acaf0bd9bf5203b8cca1ec489", + "shasum": "" + }, + "require": { + "php": ">=5.4", + "phpcsstandards/phpcsutils": "^1.0.9", + "squizlabs/php_codesniffer": "^3.8.0" + }, + "require-dev": { + "php-parallel-lint/php-console-highlighter": "^1.0", + "php-parallel-lint/php-parallel-lint": "^1.3.2", + "phpcsstandards/phpcsdevcs": "^1.1.6", + "phpcsstandards/phpcsdevtools": "^1.2.1", + "phpunit/phpunit": "^4.5 || ^5.0 || ^6.0 || ^7.0 || ^8.0 || ^9.0" + }, + "type": "phpcodesniffer-standard", + "extra": { + "branch-alias": { + "dev-stable": "1.x-dev", + "dev-develop": "1.x-dev" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "LGPL-3.0-or-later" + ], + "authors": [ + { + "name": "Juliette Reinders Folmer", + "homepage": "https://github.com/jrfnl", + "role": "lead" + }, + { + "name": "Contributors", + "homepage": "https://github.com/PHPCSStandards/PHPCSExtra/graphs/contributors" + } + ], + "description": "A collection of sniffs and standards for use with PHP_CodeSniffer.", + "keywords": [ + "PHP_CodeSniffer", + "phpcbf", + "phpcodesniffer-standard", + "phpcs", + "standards", + "static analysis" + ], + "support": { + "issues": "https://github.com/PHPCSStandards/PHPCSExtra/issues", + "security": "https://github.com/PHPCSStandards/PHPCSExtra/security/policy", + "source": "https://github.com/PHPCSStandards/PHPCSExtra" + }, + "funding": [ + { + "url": "https://github.com/PHPCSStandards", + "type": "github" + }, + { + "url": "https://github.com/jrfnl", + "type": "github" + }, + { + "url": "https://opencollective.com/php_codesniffer", + "type": "open_collective" + } + ], + "time": "2023-12-08T16:49:07+00:00" + }, + { + "name": "phpcsstandards/phpcsutils", + "version": "1.0.12", + "source": { + "type": "git", + "url": "https://github.com/PHPCSStandards/PHPCSUtils.git", + "reference": "87b233b00daf83fb70f40c9a28692be017ea7c6c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/PHPCSStandards/PHPCSUtils/zipball/87b233b00daf83fb70f40c9a28692be017ea7c6c", + "reference": "87b233b00daf83fb70f40c9a28692be017ea7c6c", + "shasum": "" + }, + "require": { + "dealerdirect/phpcodesniffer-composer-installer": "^0.4.1 || ^0.5 || ^0.6.2 || ^0.7 || ^1.0", + "php": ">=5.4", + "squizlabs/php_codesniffer": "^3.10.0 || 4.0.x-dev@dev" + }, + "require-dev": { + "ext-filter": "*", + "php-parallel-lint/php-console-highlighter": "^1.0", + "php-parallel-lint/php-parallel-lint": "^1.3.2", + "phpcsstandards/phpcsdevcs": "^1.1.6", + "yoast/phpunit-polyfills": "^1.1.0 || ^2.0.0" + }, + "type": "phpcodesniffer-standard", + "extra": { + "branch-alias": { + "dev-stable": "1.x-dev", + "dev-develop": "1.x-dev" + } + }, + "autoload": { + "classmap": [ + "PHPCSUtils/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "LGPL-3.0-or-later" + ], + "authors": [ + { + "name": "Juliette Reinders Folmer", + "homepage": "https://github.com/jrfnl", + "role": "lead" + }, + { + "name": "Contributors", + "homepage": "https://github.com/PHPCSStandards/PHPCSUtils/graphs/contributors" + } + ], + "description": "A suite of utility functions for use with PHP_CodeSniffer", + "homepage": "https://phpcsutils.com/", + "keywords": [ + "PHP_CodeSniffer", + "phpcbf", + "phpcodesniffer-standard", + "phpcs", + "phpcs3", + "standards", + "static analysis", + "tokens", + "utility" + ], + "support": { + "docs": "https://phpcsutils.com/", + "issues": "https://github.com/PHPCSStandards/PHPCSUtils/issues", + "security": "https://github.com/PHPCSStandards/PHPCSUtils/security/policy", + "source": "https://github.com/PHPCSStandards/PHPCSUtils" + }, + "funding": [ + { + "url": "https://github.com/PHPCSStandards", + "type": "github" + }, + { + "url": "https://github.com/jrfnl", + "type": "github" + }, + { + "url": "https://opencollective.com/php_codesniffer", + "type": "open_collective" + } + ], + "time": "2024-05-20T13:34:27+00:00" + }, + { + "name": "phpdocumentor/reflection-common", + "version": "2.2.0", + "source": { + "type": "git", + "url": "https://github.com/phpDocumentor/ReflectionCommon.git", + "reference": "1d01c49d4ed62f25aa84a747ad35d5a16924662b" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/phpDocumentor/ReflectionCommon/zipball/1d01c49d4ed62f25aa84a747ad35d5a16924662b", + "reference": "1d01c49d4ed62f25aa84a747ad35d5a16924662b", + "shasum": "" + }, + "require": { + "php": "^7.2 || ^8.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-2.x": "2.x-dev" + } + }, + "autoload": { + "psr-4": { + "phpDocumentor\\Reflection\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Jaap van Otterdijk", + "email": "opensource@ijaap.nl" + } + ], + "description": "Common reflection classes used by phpdocumentor to reflect the code structure", + "homepage": "http://www.phpdoc.org", + "keywords": [ + "FQSEN", + "phpDocumentor", + "phpdoc", + "reflection", + "static analysis" + ], + "support": { + "issues": "https://github.com/phpDocumentor/ReflectionCommon/issues", + "source": "https://github.com/phpDocumentor/ReflectionCommon/tree/2.x" + }, + "time": "2020-06-27T09:03:43+00:00" + }, + { + "name": "phpdocumentor/reflection-docblock", + "version": "5.6.2", + "source": { + "type": "git", + "url": "https://github.com/phpDocumentor/ReflectionDocBlock.git", + "reference": "92dde6a5919e34835c506ac8c523ef095a95ed62" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/phpDocumentor/ReflectionDocBlock/zipball/92dde6a5919e34835c506ac8c523ef095a95ed62", + "reference": "92dde6a5919e34835c506ac8c523ef095a95ed62", + "shasum": "" + }, + "require": { + "doctrine/deprecations": "^1.1", + "ext-filter": "*", + "php": "^7.4 || ^8.0", + "phpdocumentor/reflection-common": "^2.2", + "phpdocumentor/type-resolver": "^1.7", + "phpstan/phpdoc-parser": "^1.7|^2.0", + "webmozart/assert": "^1.9.1" + }, + "require-dev": { + "mockery/mockery": "~1.3.5 || ~1.6.0", + "phpstan/extension-installer": "^1.1", + "phpstan/phpstan": "^1.8", + "phpstan/phpstan-mockery": "^1.1", + "phpstan/phpstan-webmozart-assert": "^1.2", + "phpunit/phpunit": "^9.5", + "psalm/phar": "^5.26" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "5.x-dev" + } + }, + "autoload": { + "psr-4": { + "phpDocumentor\\Reflection\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Mike van Riel", + "email": "me@mikevanriel.com" + }, + { + "name": "Jaap van Otterdijk", + "email": "opensource@ijaap.nl" + } + ], + "description": "With this component, a library can provide support for annotations via DocBlocks or otherwise retrieve information that is embedded in a DocBlock.", + "support": { + "issues": "https://github.com/phpDocumentor/ReflectionDocBlock/issues", + "source": "https://github.com/phpDocumentor/ReflectionDocBlock/tree/5.6.2" + }, + "time": "2025-04-13T19:20:35+00:00" + }, + { + "name": "phpdocumentor/type-resolver", + "version": "1.10.0", + "source": { + "type": "git", + "url": "https://github.com/phpDocumentor/TypeResolver.git", + "reference": "679e3ce485b99e84c775d28e2e96fade9a7fb50a" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/phpDocumentor/TypeResolver/zipball/679e3ce485b99e84c775d28e2e96fade9a7fb50a", + "reference": "679e3ce485b99e84c775d28e2e96fade9a7fb50a", + "shasum": "" + }, + "require": { + "doctrine/deprecations": "^1.0", + "php": "^7.3 || ^8.0", + "phpdocumentor/reflection-common": "^2.0", + "phpstan/phpdoc-parser": "^1.18|^2.0" + }, + "require-dev": { + "ext-tokenizer": "*", + "phpbench/phpbench": "^1.2", + "phpstan/extension-installer": "^1.1", + "phpstan/phpstan": "^1.8", + "phpstan/phpstan-phpunit": "^1.1", + "phpunit/phpunit": "^9.5", + "rector/rector": "^0.13.9", + "vimeo/psalm": "^4.25" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-1.x": "1.x-dev" + } + }, + "autoload": { + "psr-4": { + "phpDocumentor\\Reflection\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Mike van Riel", + "email": "me@mikevanriel.com" + } + ], + "description": "A PSR-5 based resolver of Class names, Types and Structural Element Names", + "support": { + "issues": "https://github.com/phpDocumentor/TypeResolver/issues", + "source": "https://github.com/phpDocumentor/TypeResolver/tree/1.10.0" + }, + "time": "2024-11-09T15:12:26+00:00" + }, + { + "name": "phpstan/phpdoc-parser", + "version": "2.1.0", + "source": { + "type": "git", + "url": "https://github.com/phpstan/phpdoc-parser.git", + "reference": "9b30d6fd026b2c132b3985ce6b23bec09ab3aa68" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/phpstan/phpdoc-parser/zipball/9b30d6fd026b2c132b3985ce6b23bec09ab3aa68", + "reference": "9b30d6fd026b2c132b3985ce6b23bec09ab3aa68", + "shasum": "" + }, + "require": { + "php": "^7.4 || ^8.0" + }, + "require-dev": { + "doctrine/annotations": "^2.0", + "nikic/php-parser": "^5.3.0", + "php-parallel-lint/php-parallel-lint": "^1.2", + "phpstan/extension-installer": "^1.0", + "phpstan/phpstan": "^2.0", + "phpstan/phpstan-phpunit": "^2.0", + "phpstan/phpstan-strict-rules": "^2.0", + "phpunit/phpunit": "^9.6", + "symfony/process": "^5.2" + }, + "type": "library", + "autoload": { + "psr-4": { + "PHPStan\\PhpDocParser\\": [ + "src/" + ] + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "PHPDoc parser with support for nullable, intersection and generic types", + "support": { + "issues": "https://github.com/phpstan/phpdoc-parser/issues", + "source": "https://github.com/phpstan/phpdoc-parser/tree/2.1.0" + }, + "time": "2025-02-19T13:28:12+00:00" + }, + { + "name": "phpstan/phpstan", + "version": "2.1.12", + "source": { + "type": "git", + "url": "https://github.com/phpstan/phpstan.git", + "reference": "96dde49e967c0c22812bcfa7bda4ff82c09f3b0c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/phpstan/phpstan/zipball/96dde49e967c0c22812bcfa7bda4ff82c09f3b0c", + "reference": "96dde49e967c0c22812bcfa7bda4ff82c09f3b0c", + "shasum": "" + }, + "require": { + "php": "^7.4|^8.0" + }, + "conflict": { + "phpstan/phpstan-shim": "*" + }, + "bin": [ + "phpstan", + "phpstan.phar" + ], + "type": "library", + "autoload": { + "files": [ + "bootstrap.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "PHPStan - PHP Static Analysis Tool", + "keywords": [ + "dev", + "static analysis" + ], + "support": { + "docs": "https://phpstan.org/user-guide/getting-started", + "forum": "https://github.com/phpstan/phpstan/discussions", + "issues": "https://github.com/phpstan/phpstan/issues", + "security": "https://github.com/phpstan/phpstan/security/policy", + "source": "https://github.com/phpstan/phpstan-src" + }, + "funding": [ + { + "url": "https://github.com/ondrejmirtes", + "type": "github" + }, + { + "url": "https://github.com/phpstan", + "type": "github" + } + ], + "time": "2025-04-16T13:19:18+00:00" + }, + { + "name": "phpstan/phpstan-strict-rules", + "version": "2.0.4", + "source": { + "type": "git", + "url": "https://github.com/phpstan/phpstan-strict-rules.git", + "reference": "3e139cbe67fafa3588e1dbe27ca50f31fdb6236a" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/phpstan/phpstan-strict-rules/zipball/3e139cbe67fafa3588e1dbe27ca50f31fdb6236a", + "reference": "3e139cbe67fafa3588e1dbe27ca50f31fdb6236a", + "shasum": "" + }, + "require": { + "php": "^7.4 || ^8.0", + "phpstan/phpstan": "^2.0.4" + }, + "require-dev": { + "php-parallel-lint/php-parallel-lint": "^1.2", + "phpstan/phpstan-deprecation-rules": "^2.0", + "phpstan/phpstan-phpunit": "^2.0", + "phpunit/phpunit": "^9.6" + }, + "type": "phpstan-extension", + "extra": { + "phpstan": { + "includes": [ + "rules.neon" + ] + } + }, + "autoload": { + "psr-4": { + "PHPStan\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Extra strict and opinionated rules for PHPStan", + "support": { + "issues": "https://github.com/phpstan/phpstan-strict-rules/issues", + "source": "https://github.com/phpstan/phpstan-strict-rules/tree/2.0.4" + }, + "time": "2025-03-18T11:42:40+00:00" + }, + { + "name": "psr/container", + "version": "1.1.2", + "source": { + "type": "git", + "url": "https://github.com/php-fig/container.git", + "reference": "513e0666f7216c7459170d56df27dfcefe1689ea" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/container/zipball/513e0666f7216c7459170d56df27dfcefe1689ea", + "reference": "513e0666f7216c7459170d56df27dfcefe1689ea", + "shasum": "" + }, + "require": { + "php": ">=7.4.0" + }, + "type": "library", + "autoload": { + "psr-4": { + "Psr\\Container\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "https://www.php-fig.org/" + } + ], + "description": "Common Container Interface (PHP FIG PSR-11)", + "homepage": "https://github.com/php-fig/container", + "keywords": [ + "PSR-11", + "container", + "container-interface", + "container-interop", + "psr" + ], + "support": { + "issues": "https://github.com/php-fig/container/issues", + "source": "https://github.com/php-fig/container/tree/1.1.2" + }, + "time": "2021-11-05T16:50:12+00:00" + }, + { + "name": "psr/log", + "version": "1.1.4", + "source": { + "type": "git", + "url": "https://github.com/php-fig/log.git", + "reference": "d49695b909c3b7628b6289db5479a1c204601f11" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/php-fig/log/zipball/d49695b909c3b7628b6289db5479a1c204601f11", + "reference": "d49695b909c3b7628b6289db5479a1c204601f11", + "shasum": "" + }, + "require": { + "php": ">=5.3.0" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.1.x-dev" + } + }, + "autoload": { + "psr-4": { + "Psr\\Log\\": "Psr/Log/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "PHP-FIG", + "homepage": "https://www.php-fig.org/" + } + ], + "description": "Common interface for logging libraries", + "homepage": "https://github.com/php-fig/log", + "keywords": [ + "log", + "psr", + "psr-3" + ], + "support": { + "source": "https://github.com/php-fig/log/tree/1.1.4" + }, + "time": "2021-05-03T11:20:27+00:00" + }, + { + "name": "sebastian/diff", + "version": "4.0.6", + "source": { + "type": "git", + "url": "https://github.com/sebastianbergmann/diff.git", + "reference": "ba01945089c3a293b01ba9badc29ad55b106b0bc" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sebastianbergmann/diff/zipball/ba01945089c3a293b01ba9badc29ad55b106b0bc", + "reference": "ba01945089c3a293b01ba9badc29ad55b106b0bc", + "shasum": "" + }, + "require": { + "php": ">=7.3" + }, + "require-dev": { + "phpunit/phpunit": "^9.3", + "symfony/process": "^4.2 || ^5" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "4.0-dev" + } + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Sebastian Bergmann", + "email": "sebastian@phpunit.de" + }, + { + "name": "Kore Nordmann", + "email": "mail@kore-nordmann.de" + } + ], + "description": "Diff implementation", + "homepage": "https://github.com/sebastianbergmann/diff", + "keywords": [ + "diff", + "udiff", + "unidiff", + "unified diff" + ], + "support": { + "issues": "https://github.com/sebastianbergmann/diff/issues", + "source": "https://github.com/sebastianbergmann/diff/tree/4.0.6" + }, + "funding": [ + { + "url": "https://github.com/sebastianbergmann", + "type": "github" + } + ], + "time": "2024-03-02T06:30:58+00:00" + }, + { + "name": "sirbrillig/phpcs-variable-analysis", + "version": "v2.12.0", + "source": { + "type": "git", + "url": "https://github.com/sirbrillig/phpcs-variable-analysis.git", + "reference": "4debf5383d9ade705e0a25121f16c3fecaf433a7" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/sirbrillig/phpcs-variable-analysis/zipball/4debf5383d9ade705e0a25121f16c3fecaf433a7", + "reference": "4debf5383d9ade705e0a25121f16c3fecaf433a7", + "shasum": "" + }, + "require": { + "php": ">=5.4.0", + "squizlabs/php_codesniffer": "^3.5.6" + }, + "require-dev": { + "dealerdirect/phpcodesniffer-composer-installer": "^0.7 || ^1.0", + "phpcsstandards/phpcsdevcs": "^1.1", + "phpstan/phpstan": "^1.7", + "phpunit/phpunit": "^4.8.36 || ^5.7.21 || ^6.5 || ^7.0 || ^8.0 || ^9.0 || ^10.5.32 || ^11.3.3", + "vimeo/psalm": "^0.2 || ^0.3 || ^1.1 || ^4.24 || ^5.0" + }, + "type": "phpcodesniffer-standard", + "autoload": { + "psr-4": { + "VariableAnalysis\\": "VariableAnalysis/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-2-Clause" + ], + "authors": [ + { + "name": "Sam Graham", + "email": "php-codesniffer-variableanalysis@illusori.co.uk" + }, + { + "name": "Payton Swick", + "email": "payton@foolord.com" + } + ], + "description": "A PHPCS sniff to detect problems with variables.", + "keywords": [ + "phpcs", + "static analysis" + ], + "support": { + "issues": "https://github.com/sirbrillig/phpcs-variable-analysis/issues", + "source": "https://github.com/sirbrillig/phpcs-variable-analysis", + "wiki": "https://github.com/sirbrillig/phpcs-variable-analysis/wiki" + }, + "time": "2025-03-17T16:17:38+00:00" + }, + { + "name": "slevomat/coding-standard", + "version": "8.17.0", + "source": { + "type": "git", + "url": "https://github.com/slevomat/coding-standard.git", + "reference": "ace04a4e2e20c9bc26ad14d6c4c737cde6056ec0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/slevomat/coding-standard/zipball/ace04a4e2e20c9bc26ad14d6c4c737cde6056ec0", + "reference": "ace04a4e2e20c9bc26ad14d6c4c737cde6056ec0", + "shasum": "" + }, + "require": { + "dealerdirect/phpcodesniffer-composer-installer": "^0.6.2 || ^0.7 || ^1.0", + "php": "^7.4 || ^8.0", + "phpstan/phpdoc-parser": "^2.1.0", + "squizlabs/php_codesniffer": "^3.12.1" + }, + "require-dev": { + "phing/phing": "3.0.1", + "php-parallel-lint/php-parallel-lint": "1.4.0", + "phpstan/phpstan": "2.1.11", + "phpstan/phpstan-deprecation-rules": "2.0.1", + "phpstan/phpstan-phpunit": "2.0.6", + "phpstan/phpstan-strict-rules": "2.0.4", + "phpunit/phpunit": "9.6.8|10.5.45|11.4.4|11.5.17|12.1.2" + }, + "type": "phpcodesniffer-standard", + "extra": { + "branch-alias": { + "dev-master": "8.x-dev" + } + }, + "autoload": { + "psr-4": { + "SlevomatCodingStandard\\": "SlevomatCodingStandard/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "Slevomat Coding Standard for PHP_CodeSniffer complements Consistence Coding Standard by providing sniffs with additional checks.", + "keywords": [ + "dev", + "phpcs" + ], + "support": { + "issues": "https://github.com/slevomat/coding-standard/issues", + "source": "https://github.com/slevomat/coding-standard/tree/8.17.0" + }, + "funding": [ + { + "url": "https://github.com/kukulich", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/slevomat/coding-standard", + "type": "tidelift" + } + ], + "time": "2025-04-10T06:06:16+00:00" + }, + { + "name": "spatie/array-to-xml", + "version": "2.17.1", + "source": { + "type": "git", + "url": "https://github.com/spatie/array-to-xml.git", + "reference": "5cbec9c6ab17e320c58a259f0cebe88bde4a7c46" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/spatie/array-to-xml/zipball/5cbec9c6ab17e320c58a259f0cebe88bde4a7c46", + "reference": "5cbec9c6ab17e320c58a259f0cebe88bde4a7c46", + "shasum": "" + }, + "require": { + "ext-dom": "*", + "php": "^7.4|^8.0" + }, + "require-dev": { + "mockery/mockery": "^1.2", + "pestphp/pest": "^1.21", + "phpunit/phpunit": "^9.0", + "spatie/pest-plugin-snapshots": "^1.1" + }, + "type": "library", + "autoload": { + "psr-4": { + "Spatie\\ArrayToXml\\": "src" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Freek Van der Herten", + "email": "freek@spatie.be", + "homepage": "https://freek.dev", + "role": "Developer" + } + ], + "description": "Convert an array to xml", + "homepage": "https://github.com/spatie/array-to-xml", + "keywords": [ + "array", + "convert", + "xml" + ], + "support": { + "source": "https://github.com/spatie/array-to-xml/tree/2.17.1" + }, + "funding": [ + { + "url": "https://spatie.be/open-source/support-us", + "type": "custom" + }, + { + "url": "https://github.com/spatie", + "type": "github" + } + ], + "time": "2022-12-26T08:22:07+00:00" + }, + { + "name": "squizlabs/php_codesniffer", + "version": "3.12.2", + "source": { + "type": "git", + "url": "https://github.com/PHPCSStandards/PHP_CodeSniffer.git", + "reference": "6d4cf6032d4b718f168c90a96e36c7d0eaacb2aa" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/PHPCSStandards/PHP_CodeSniffer/zipball/6d4cf6032d4b718f168c90a96e36c7d0eaacb2aa", + "reference": "6d4cf6032d4b718f168c90a96e36c7d0eaacb2aa", + "shasum": "" + }, + "require": { + "ext-simplexml": "*", + "ext-tokenizer": "*", + "ext-xmlwriter": "*", + "php": ">=5.4.0" + }, + "require-dev": { + "phpunit/phpunit": "^4.0 || ^5.0 || ^6.0 || ^7.0 || ^8.0 || ^9.3.4" + }, + "bin": [ + "bin/phpcbf", + "bin/phpcs" + ], + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "3.x-dev" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "BSD-3-Clause" + ], + "authors": [ + { + "name": "Greg Sherwood", + "role": "Former lead" + }, + { + "name": "Juliette Reinders Folmer", + "role": "Current lead" + }, + { + "name": "Contributors", + "homepage": "https://github.com/PHPCSStandards/PHP_CodeSniffer/graphs/contributors" + } + ], + "description": "PHP_CodeSniffer tokenizes PHP, JavaScript and CSS files and detects violations of a defined set of coding standards.", + "homepage": "https://github.com/PHPCSStandards/PHP_CodeSniffer", + "keywords": [ + "phpcs", + "standards", + "static analysis" + ], + "support": { + "issues": "https://github.com/PHPCSStandards/PHP_CodeSniffer/issues", + "security": "https://github.com/PHPCSStandards/PHP_CodeSniffer/security/policy", + "source": "https://github.com/PHPCSStandards/PHP_CodeSniffer", + "wiki": "https://github.com/PHPCSStandards/PHP_CodeSniffer/wiki" + }, + "funding": [ + { + "url": "https://github.com/PHPCSStandards", + "type": "github" + }, + { + "url": "https://github.com/jrfnl", + "type": "github" + }, + { + "url": "https://opencollective.com/php_codesniffer", + "type": "open_collective" + }, + { + "url": "https://thanks.dev/u/gh/phpcsstandards", + "type": "thanks_dev" + } + ], + "time": "2025-04-13T04:10:18+00:00" + }, + { + "name": "symfony/console", + "version": "v5.4.47", + "source": { + "type": "git", + "url": "https://github.com/symfony/console.git", + "reference": "c4ba980ca61a9eb18ee6bcc73f28e475852bb1ed" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/console/zipball/c4ba980ca61a9eb18ee6bcc73f28e475852bb1ed", + "reference": "c4ba980ca61a9eb18ee6bcc73f28e475852bb1ed", + "shasum": "" + }, + "require": { + "php": ">=7.2.5", + "symfony/deprecation-contracts": "^2.1|^3", + "symfony/polyfill-mbstring": "~1.0", + "symfony/polyfill-php73": "^1.9", + "symfony/polyfill-php80": "^1.16", + "symfony/service-contracts": "^1.1|^2|^3", + "symfony/string": "^5.1|^6.0" + }, + "conflict": { + "psr/log": ">=3", + "symfony/dependency-injection": "<4.4", + "symfony/dotenv": "<5.1", + "symfony/event-dispatcher": "<4.4", + "symfony/lock": "<4.4", + "symfony/process": "<4.4" + }, + "provide": { + "psr/log-implementation": "1.0|2.0" + }, + "require-dev": { + "psr/log": "^1|^2", + "symfony/config": "^4.4|^5.0|^6.0", + "symfony/dependency-injection": "^4.4|^5.0|^6.0", + "symfony/event-dispatcher": "^4.4|^5.0|^6.0", + "symfony/lock": "^4.4|^5.0|^6.0", + "symfony/process": "^4.4|^5.0|^6.0", + "symfony/var-dumper": "^4.4|^5.0|^6.0" + }, + "suggest": { + "psr/log": "For using the console logger", + "symfony/event-dispatcher": "", + "symfony/lock": "", + "symfony/process": "" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\Console\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Eases the creation of beautiful and testable command line interfaces", + "homepage": "https://symfony.com", + "keywords": [ + "cli", + "command-line", + "console", + "terminal" + ], + "support": { + "source": "https://github.com/symfony/console/tree/v5.4.47" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-11-06T11:30:55+00:00" + }, + { + "name": "symfony/deprecation-contracts", + "version": "v2.5.4", + "source": { + "type": "git", + "url": "https://github.com/symfony/deprecation-contracts.git", + "reference": "605389f2a7e5625f273b53960dc46aeaf9c62918" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/605389f2a7e5625f273b53960dc46aeaf9c62918", + "reference": "605389f2a7e5625f273b53960dc46aeaf9c62918", + "shasum": "" + }, + "require": { + "php": ">=7.1" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/contracts", + "name": "symfony/contracts" + }, + "branch-alias": { + "dev-main": "2.5-dev" + } + }, + "autoload": { + "files": [ + "function.php" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "A generic function and convention to trigger deprecation notices", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/deprecation-contracts/tree/v2.5.4" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-09-25T14:11:13+00:00" + }, + { + "name": "symfony/filesystem", + "version": "v5.4.45", + "source": { + "type": "git", + "url": "https://github.com/symfony/filesystem.git", + "reference": "57c8294ed37d4a055b77057827c67f9558c95c54" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/filesystem/zipball/57c8294ed37d4a055b77057827c67f9558c95c54", + "reference": "57c8294ed37d4a055b77057827c67f9558c95c54", + "shasum": "" + }, + "require": { + "php": ">=7.2.5", + "symfony/polyfill-ctype": "~1.8", + "symfony/polyfill-mbstring": "~1.8", + "symfony/polyfill-php80": "^1.16" + }, + "require-dev": { + "symfony/process": "^5.4|^6.4" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\Filesystem\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Provides basic utilities for the filesystem", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/filesystem/tree/v5.4.45" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-10-22T13:05:35+00:00" + }, + { + "name": "symfony/polyfill-ctype", + "version": "v1.31.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-ctype.git", + "reference": "a3cc8b044a6ea513310cbd48ef7333b384945638" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/a3cc8b044a6ea513310cbd48ef7333b384945638", + "reference": "a3cc8b044a6ea513310cbd48ef7333b384945638", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "provide": { + "ext-ctype": "*" + }, + "suggest": { + "ext-ctype": "For best performance" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Ctype\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Gert de Pagter", + "email": "BackEndTea@gmail.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill for ctype functions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "ctype", + "polyfill", + "portable" + ], + "support": { + "source": "https://github.com/symfony/polyfill-ctype/tree/v1.31.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-09-09T11:45:10+00:00" + }, + { + "name": "symfony/polyfill-intl-grapheme", + "version": "v1.31.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-intl-grapheme.git", + "reference": "b9123926e3b7bc2f98c02ad54f6a4b02b91a8abe" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/b9123926e3b7bc2f98c02ad54f6a4b02b91a8abe", + "reference": "b9123926e3b7bc2f98c02ad54f6a4b02b91a8abe", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "suggest": { + "ext-intl": "For best performance" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Intl\\Grapheme\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill for intl's grapheme_* functions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "grapheme", + "intl", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.31.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-09-09T11:45:10+00:00" + }, + { + "name": "symfony/polyfill-intl-normalizer", + "version": "v1.31.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-intl-normalizer.git", + "reference": "3833d7255cc303546435cb650316bff708a1c75c" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/3833d7255cc303546435cb650316bff708a1c75c", + "reference": "3833d7255cc303546435cb650316bff708a1c75c", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "suggest": { + "ext-intl": "For best performance" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Intl\\Normalizer\\": "" + }, + "classmap": [ + "Resources/stubs" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill for intl's Normalizer class and related functions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "intl", + "normalizer", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.31.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-09-09T11:45:10+00:00" + }, + { + "name": "symfony/polyfill-mbstring", + "version": "v1.31.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-mbstring.git", + "reference": "85181ba99b2345b0ef10ce42ecac37612d9fd341" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/85181ba99b2345b0ef10ce42ecac37612d9fd341", + "reference": "85181ba99b2345b0ef10ce42ecac37612d9fd341", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "provide": { + "ext-mbstring": "*" + }, + "suggest": { + "ext-mbstring": "For best performance" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Mbstring\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill for the Mbstring extension", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "mbstring", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.31.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-09-09T11:45:10+00:00" + }, + { + "name": "symfony/polyfill-php73", + "version": "v1.31.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-php73.git", + "reference": "0f68c03565dcaaf25a890667542e8bd75fe7e5bb" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/0f68c03565dcaaf25a890667542e8bd75fe7e5bb", + "reference": "0f68c03565dcaaf25a890667542e8bd75fe7e5bb", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Php73\\": "" + }, + "classmap": [ + "Resources/stubs" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill backporting some PHP 7.3+ features to lower PHP versions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-php73/tree/v1.31.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-09-09T11:45:10+00:00" + }, + { + "name": "symfony/polyfill-php80", + "version": "v1.31.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-php80.git", + "reference": "60328e362d4c2c802a54fcbf04f9d3fb892b4cf8" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/60328e362d4c2c802a54fcbf04f9d3fb892b4cf8", + "reference": "60328e362d4c2c802a54fcbf04f9d3fb892b4cf8", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Php80\\": "" + }, + "classmap": [ + "Resources/stubs" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Ion Bazan", + "email": "ion.bazan@gmail.com" + }, + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill backporting some PHP 8.0+ features to lower PHP versions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-php80/tree/v1.31.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-09-09T11:45:10+00:00" + }, + { + "name": "symfony/service-contracts", + "version": "v2.5.4", + "source": { + "type": "git", + "url": "https://github.com/symfony/service-contracts.git", + "reference": "f37b419f7aea2e9abf10abd261832cace12e3300" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/service-contracts/zipball/f37b419f7aea2e9abf10abd261832cace12e3300", + "reference": "f37b419f7aea2e9abf10abd261832cace12e3300", + "shasum": "" + }, + "require": { + "php": ">=7.2.5", + "psr/container": "^1.1", + "symfony/deprecation-contracts": "^2.1|^3" + }, + "conflict": { + "ext-psr": "<1.1|>=2" + }, + "suggest": { + "symfony/service-implementation": "" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/contracts", + "name": "symfony/contracts" + }, + "branch-alias": { + "dev-main": "2.5-dev" + } + }, + "autoload": { + "psr-4": { + "Symfony\\Contracts\\Service\\": "" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Generic abstractions related to writing services", + "homepage": "https://symfony.com", + "keywords": [ + "abstractions", + "contracts", + "decoupling", + "interfaces", + "interoperability", + "standards" + ], + "support": { + "source": "https://github.com/symfony/service-contracts/tree/v2.5.4" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-09-25T14:11:13+00:00" + }, + { + "name": "symfony/string", + "version": "v5.4.47", + "source": { + "type": "git", + "url": "https://github.com/symfony/string.git", + "reference": "136ca7d72f72b599f2631aca474a4f8e26719799" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/string/zipball/136ca7d72f72b599f2631aca474a4f8e26719799", + "reference": "136ca7d72f72b599f2631aca474a4f8e26719799", + "shasum": "" + }, + "require": { + "php": ">=7.2.5", + "symfony/polyfill-ctype": "~1.8", + "symfony/polyfill-intl-grapheme": "~1.0", + "symfony/polyfill-intl-normalizer": "~1.0", + "symfony/polyfill-mbstring": "~1.0", + "symfony/polyfill-php80": "~1.15" + }, + "conflict": { + "symfony/translation-contracts": ">=3.0" + }, + "require-dev": { + "symfony/error-handler": "^4.4|^5.0|^6.0", + "symfony/http-client": "^4.4|^5.0|^6.0", + "symfony/translation-contracts": "^1.1|^2", + "symfony/var-exporter": "^4.4|^5.0|^6.0" + }, + "type": "library", + "autoload": { + "files": [ + "Resources/functions.php" + ], + "psr-4": { + "Symfony\\Component\\String\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Provides an object-oriented API to strings and deals with bytes, UTF-8 code points and grapheme clusters in a unified way", + "homepage": "https://symfony.com", + "keywords": [ + "grapheme", + "i18n", + "string", + "unicode", + "utf-8", + "utf8" + ], + "support": { + "source": "https://github.com/symfony/string/tree/v5.4.47" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2024-11-10T20:33:58+00:00" + }, + { + "name": "szepeviktor/phpstan-wordpress", + "version": "v2.0.1", + "source": { + "type": "git", + "url": "https://github.com/szepeviktor/phpstan-wordpress.git", + "reference": "f7beb13cd22998e3d913fdb897a1e2553ccd637e" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/szepeviktor/phpstan-wordpress/zipball/f7beb13cd22998e3d913fdb897a1e2553ccd637e", + "reference": "f7beb13cd22998e3d913fdb897a1e2553ccd637e", + "shasum": "" + }, + "require": { + "php": "^7.4 || ^8.0", + "php-stubs/wordpress-stubs": "^6.6.2", + "phpstan/phpstan": "^2.0" + }, + "require-dev": { + "composer/composer": "^2.1.14", + "dealerdirect/phpcodesniffer-composer-installer": "^1.0", + "php-parallel-lint/php-parallel-lint": "^1.1", + "phpstan/phpstan-strict-rules": "^2.0", + "phpunit/phpunit": "^9.0", + "szepeviktor/phpcs-psr-12-neutron-hybrid-ruleset": "^1.0", + "wp-coding-standards/wpcs": "3.1.0 as 2.3.0" + }, + "suggest": { + "swissspidy/phpstan-no-private": "Detect usage of internal core functions, classes and methods" + }, + "type": "phpstan-extension", + "extra": { + "phpstan": { + "includes": [ + "extension.neon" + ] + } + }, + "autoload": { + "psr-4": { + "SzepeViktor\\PHPStan\\WordPress\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "description": "WordPress extensions for PHPStan", + "keywords": [ + "PHPStan", + "code analyse", + "code analysis", + "static analysis", + "wordpress" + ], + "support": { + "issues": "https://github.com/szepeviktor/phpstan-wordpress/issues", + "source": "https://github.com/szepeviktor/phpstan-wordpress/tree/v2.0.1" + }, + "time": "2024-12-01T02:13:05+00:00" + }, + { + "name": "vimeo/psalm", + "version": "5.26.1", + "source": { + "type": "git", + "url": "https://github.com/vimeo/psalm.git", + "reference": "d747f6500b38ac4f7dfc5edbcae6e4b637d7add0" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/vimeo/psalm/zipball/d747f6500b38ac4f7dfc5edbcae6e4b637d7add0", + "reference": "d747f6500b38ac4f7dfc5edbcae6e4b637d7add0", + "shasum": "" + }, + "require": { + "amphp/amp": "^2.4.2", + "amphp/byte-stream": "^1.5", + "composer-runtime-api": "^2", + "composer/semver": "^1.4 || ^2.0 || ^3.0", + "composer/xdebug-handler": "^2.0 || ^3.0", + "dnoegel/php-xdg-base-dir": "^0.1.1", + "ext-ctype": "*", + "ext-dom": "*", + "ext-json": "*", + "ext-libxml": "*", + "ext-mbstring": "*", + "ext-simplexml": "*", + "ext-tokenizer": "*", + "felixfbecker/advanced-json-rpc": "^3.1", + "felixfbecker/language-server-protocol": "^1.5.2", + "fidry/cpu-core-counter": "^0.4.1 || ^0.5.1 || ^1.0.0", + "netresearch/jsonmapper": "^1.0 || ^2.0 || ^3.0 || ^4.0", + "nikic/php-parser": "^4.17", + "php": "^7.4 || ~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0", + "sebastian/diff": "^4.0 || ^5.0 || ^6.0", + "spatie/array-to-xml": "^2.17.0 || ^3.0", + "symfony/console": "^4.1.6 || ^5.0 || ^6.0 || ^7.0", + "symfony/filesystem": "^5.4 || ^6.0 || ^7.0" + }, + "conflict": { + "nikic/php-parser": "4.17.0" + }, + "provide": { + "psalm/psalm": "self.version" + }, + "require-dev": { + "amphp/phpunit-util": "^2.0", + "bamarni/composer-bin-plugin": "^1.4", + "brianium/paratest": "^6.9", + "ext-curl": "*", + "mockery/mockery": "^1.5", + "nunomaduro/mock-final-classes": "^1.1", + "php-parallel-lint/php-parallel-lint": "^1.2", + "phpstan/phpdoc-parser": "^1.6", + "phpunit/phpunit": "^9.6", + "psalm/plugin-mockery": "^1.1", + "psalm/plugin-phpunit": "^0.18", + "slevomat/coding-standard": "^8.4", + "squizlabs/php_codesniffer": "^3.6", + "symfony/process": "^4.4 || ^5.0 || ^6.0 || ^7.0" + }, + "suggest": { + "ext-curl": "In order to send data to shepherd", + "ext-igbinary": "^2.0.5 is required, used to serialize caching data" + }, + "bin": [ + "psalm", + "psalm-language-server", + "psalm-plugin", + "psalm-refactor", + "psalter" + ], + "type": "project", + "extra": { + "branch-alias": { + "dev-1.x": "1.x-dev", + "dev-2.x": "2.x-dev", + "dev-3.x": "3.x-dev", + "dev-4.x": "4.x-dev", + "dev-master": "5.x-dev" + } + }, + "autoload": { + "psr-4": { + "Psalm\\": "src/Psalm/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Matthew Brown" + } + ], + "description": "A static analysis tool for finding errors in PHP applications", + "keywords": [ + "code", + "inspection", + "php", + "static analysis" + ], + "support": { + "docs": "https://psalm.dev/docs", + "issues": "https://github.com/vimeo/psalm/issues", + "source": "https://github.com/vimeo/psalm" + }, + "time": "2024-09-08T18:53:08+00:00" + }, + { + "name": "webmozart/assert", + "version": "1.11.0", + "source": { + "type": "git", + "url": "https://github.com/webmozarts/assert.git", + "reference": "11cb2199493b2f8a3b53e7f19068fc6aac760991" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/webmozarts/assert/zipball/11cb2199493b2f8a3b53e7f19068fc6aac760991", + "reference": "11cb2199493b2f8a3b53e7f19068fc6aac760991", + "shasum": "" + }, + "require": { + "ext-ctype": "*", + "php": "^7.2 || ^8.0" + }, + "conflict": { + "phpstan/phpstan": "<0.12.20", + "vimeo/psalm": "<4.6.1 || 4.6.2" + }, + "require-dev": { + "phpunit/phpunit": "^8.5.13" + }, + "type": "library", + "extra": { + "branch-alias": { + "dev-master": "1.10-dev" + } + }, + "autoload": { + "psr-4": { + "Webmozart\\Assert\\": "src/" + } + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Bernhard Schussek", + "email": "bschussek@gmail.com" + } + ], + "description": "Assertions to validate method input/output with nice error messages.", + "keywords": [ + "assert", + "check", + "validate" + ], + "support": { + "issues": "https://github.com/webmozarts/assert/issues", + "source": "https://github.com/webmozarts/assert/tree/1.11.0" + }, + "time": "2022-06-03T18:03:27+00:00" + }, + { + "name": "wp-coding-standards/wpcs", + "version": "3.1.0", + "source": { + "type": "git", + "url": "https://github.com/WordPress/WordPress-Coding-Standards.git", + "reference": "9333efcbff231f10dfd9c56bb7b65818b4733ca7" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/WordPress/WordPress-Coding-Standards/zipball/9333efcbff231f10dfd9c56bb7b65818b4733ca7", + "reference": "9333efcbff231f10dfd9c56bb7b65818b4733ca7", + "shasum": "" + }, + "require": { + "ext-filter": "*", + "ext-libxml": "*", + "ext-tokenizer": "*", + "ext-xmlreader": "*", + "php": ">=5.4", + "phpcsstandards/phpcsextra": "^1.2.1", + "phpcsstandards/phpcsutils": "^1.0.10", + "squizlabs/php_codesniffer": "^3.9.0" + }, + "require-dev": { + "php-parallel-lint/php-console-highlighter": "^1.0.0", + "php-parallel-lint/php-parallel-lint": "^1.3.2", + "phpcompatibility/php-compatibility": "^9.0", + "phpcsstandards/phpcsdevtools": "^1.2.0", + "phpunit/phpunit": "^4.0 || ^5.0 || ^6.0 || ^7.0 || ^8.0 || ^9.0" + }, + "suggest": { + "ext-iconv": "For improved results", + "ext-mbstring": "For improved results" + }, + "type": "phpcodesniffer-standard", + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Contributors", + "homepage": "https://github.com/WordPress/WordPress-Coding-Standards/graphs/contributors" + } + ], + "description": "PHP_CodeSniffer rules (sniffs) to enforce WordPress coding conventions", + "keywords": [ + "phpcs", + "standards", + "static analysis", + "wordpress" + ], + "support": { + "issues": "https://github.com/WordPress/WordPress-Coding-Standards/issues", + "source": "https://github.com/WordPress/WordPress-Coding-Standards", + "wiki": "https://github.com/WordPress/WordPress-Coding-Standards/wiki" + }, + "funding": [ + { + "url": "https://opencollective.com/php_codesniffer", + "type": "custom" + } + ], + "time": "2024-03-25T16:39:00+00:00" + }, + { + "name": "wp-hooks/wordpress-core", + "version": "1.10.0", + "source": { + "type": "git", + "url": "https://github.com/wp-hooks/wordpress-core-hooks.git", + "reference": "127af21a918a52bcead7ce9b743b17b5d64eb148" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/wp-hooks/wordpress-core-hooks/zipball/127af21a918a52bcead7ce9b743b17b5d64eb148", + "reference": "127af21a918a52bcead7ce9b743b17b5d64eb148", + "shasum": "" + }, + "replace": { + "johnbillion/wp-hooks": "*" + }, + "require-dev": { + "erusev/parsedown": "1.8.0-beta-7", + "oomphinc/composer-installers-extender": "^2", + "roots/wordpress-core-installer": "^1.0.0", + "roots/wordpress-full": "6.8", + "wp-hooks/generator": "1.0.0" + }, + "type": "library", + "extra": { + "wp-hooks": { + "ignore-files": [ + "wp-admin/includes/deprecated.php", + "wp-admin/includes/ms-deprecated.php", + "wp-content/", + "wp-includes/deprecated.php", + "wp-includes/ID3/", + "wp-includes/ms-deprecated.php", + "wp-includes/pomo/", + "wp-includes/random_compat/", + "wp-includes/Requests/", + "wp-includes/SimplePie/", + "wp-includes/sodium_compat/", + "wp-includes/Text/" + ], + "ignore-hooks": [ + "load-categories.php", + "load-edit-link-categories.php", + "load-edit-tags.php", + "load-page-new.php", + "load-page.php", + "option_enable_xmlrpc", + "edit_post_{$field}", + "pre_post_{$field}", + "post_{$field}", + "pre_option_enable_xmlrpc", + "$page_hook", + "$hook", + "$hook_name" + ] + }, + "wordpress-install-dir": "vendor/wordpress/wordpress" + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "GPL-3.0-or-later" + ], + "authors": [ + { + "name": "John Blackbourn", + "homepage": "https://johnblackbourn.com/" + } + ], + "description": "All the actions and filters from WordPress core in machine-readable JSON format.", + "support": { + "issues": "https://github.com/wp-hooks/wordpress-core-hooks/issues", + "source": "https://github.com/wp-hooks/wordpress-core-hooks/tree/1.10.0" + }, + "funding": [ + { + "url": "https://github.com/sponsors/johnbillion", + "type": "github" + } + ], + "time": "2025-04-16T22:20:41+00:00" + } + ], + "aliases": [], + "minimum-stability": "dev", + "stability-flags": {}, + "prefer-stable": true, + "prefer-lowest": false, + "platform": { + "php": "^7.4 || ^8.0" + }, + "platform-dev": {}, + "platform-overrides": { + "php": "7.4" + }, + "plugin-api-version": "2.6.0" +} diff --git a/plugins/hwp-previews/hwp-previews.php b/plugins/hwp-previews/hwp-previews.php new file mode 100644 index 0000000..cc3dd05 --- /dev/null +++ b/plugins/hwp-previews/hwp-previews.php @@ -0,0 +1,32 @@ + HWP\Previews\Plugin::get_instance( + '0.0.1', + plugin_dir_path( __FILE__ ), + plugin_dir_url( __FILE__ ) +)->init(), 5, 0 ); diff --git a/plugins/hwp-previews/package.xml b/plugins/hwp-previews/package.xml new file mode 100644 index 0000000..ae19026 --- /dev/null +++ b/plugins/hwp-previews/package.xml @@ -0,0 +1,4461 @@ + + + xdebug + pecl.php.net + Xdebug is a debugging and productivity extension for PHP + Xdebug and provides a range of features to improve the PHP development +experience. + +Step Debugging + A way to step through your code in your IDE or editor while the script is + executing. + +Improvements to PHP's error reporting + An improved var_dump() function, stack traces for Notices, Warnings, Errors + and Exceptions to highlight the code path to the error + +Tracing + Writes every function call, with arguments and invocation location to disk. + Optionally also includes every variable assignment and return value for + each function. + +Profiling + Allows you, with the help of visualisation tools, to analyse the + performance of your PHP application and find bottlenecks. + +Code Coverage Analysis + To show which parts of your code base are executed when running unit tests + with PHP Unit. + + Derick Rethans + derick + derick@xdebug.org + yes + + 2025-03-09 + + + 3.4.2 + 3.4.2 + + + stable + stable + + Xdebug-1.03 + +Sun, Mar 09, 2025 - Xdebug 3.4.2 + += Fixed bugs: + + - Fixed issue #2313: var_dump does not output some Russian characters + - Fixed issue #2314: Class properties with hooks are always shown as null + - Fixed issue #2315: xdebug_dump_superglobals() leaks memory + - Fixed issue #2317: Code coverage leaks memory + - Fixed issue #2321: Segfault when null is assigned to a superglobal + - Fixed issue #2323: xdebug_notify() does not respect xdebug.var_display_max_* Settings + - Fixed issue #2327: Segmentation Fault 139 if exception thrown in callback since PHP 8.4 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 8.0.0 + 8.4.99 + + + 1.9.1 + + + + xdebug + + + + 2025-01-06 + + + 3.4.1 + 3.4.1 + + + stable + stable + + Xdebug-1.03 + +Mon, Jan 06, 2025 - Xdebug 3.4.1 + += Fixed bugs: + + - Fixed issue #2306: Segmentation fault on each HTTP request when not listening to debugging connections + - Fixed issue #2307: Segmentation fault due to a superglobal being a reference while checking for triggers + - Fixed issue #2309: Installation on Windows with PHP PIE failing + - Fixed issue #2310: xdebug 3.4.0 crashes php8.1-fpm after script execution + + + + 2024-11-28 + + + 3.4.0 + 3.4.0 + + + stable + stable + + Xdebug-1.03 + +Thu, Nov 28, 2024 - Xdebug 3.4.0 + ++ New features: + + - Fixed issue #2239: Add 'XDEBUG_IGNORE' GET/POST/COOKIE/ENV to make the step debugger ignore that specific request + - Fixed issue #2281: PHP 8.4 support + ++ Improvements + + - Fixed issue #2261: Send control socket location in init packet + += Fixed bugs: + + - Fixed issue #2262: PHP 8.4: Closure names need different wrapping algorithm + - Fixed issue #2283: SoapClient usage causes segfault with codecoverage + - Fixed issue #2294: Nette Tester always crashes in all test jobs when running with XDebug 3.4.0beta1 active + - Fixed issue #2304: Seg fault on throw exception + - Fixed issue #2305: Segfault when checking whether to ignore creating a debug connection during shutdown functions + + + + 2024-10-04 + + + 3.4.0beta1 + 3.4.0beta1 + + + beta + beta + + Xdebug-1.03 + +Fri, Oct 04, 2024 - Xdebug 3.4.0beta1 + += Fixed bugs: + + - Fixed issue #2261: Send control socket location in init packet + - Fixed issue #2281: PHP 8.4 support + + + + 2024-05-31 + + + 3.4.0alpha1 + 3.4.0alpha1 + + + beta + beta + + Xdebug-1.03 + +Fri, May 31, 2024 - Xdebug 3.4.0alpha1 + += Fixed bugs: + + - Fixed issue #2239: Add 'XDEBUG_IGNORE' GET/POST/COOKIE/ENV to make the step debugger ignore that specific request + - Fixed issue #2262: PHP 8.4: Closure names need different wrapping algorithm + + + + 2024-04-15 + + + 3.3.2 + 3.3.2 + + + stable + stable + + Xdebug-1.03 + +Mon, Apr 15, 2024 - Xdebug 3.3.2 + += Fixed bugs: + + - Fixed issue #2216: With PHP8.3 and Apache 2.4.58 error_reporting() causing Apache process to hang + - Fixed issue #2230: Crash when xdebug and blackfire extensions are active + - Fixed issue #2233: High and continuous Apache server CPU use + + + + 2023-12-14 + + + 3.3.1 + 3.3.1 + + + stable + stable + + Xdebug-1.03 + +Thu, Dec 14, 2023 - Xdebug 3.3.1 + += Fixed bugs: + + - Fixed issue #2220: Test failure + - Fixed issue #2221: Crash when other extensions run PHP code without the stack being initialised yet + - Fixed issue #2223: Xdebug's constants are not available with `xdebug.mode=off` + - Fixed issue #2226: xdebug_get_function_stack(['from_exception']) does not always find stored trace + - Fixed issue #2227: Crash with return value and observers + - Fixed issue #2228: Return value can not be fetched with property_get if top frame is an internal function + + + + 2023-11-30 + + + 3.3.0 + 3.3.0 + + + stable + stable + + Xdebug-1.03 + +Thu, Nov 30, 2023 - Xdebug 3.3.0 + ++ New features: + + - Fixed issue #2171: Support for PHP 8.3 + - Fixed issue #1732: Add support for flame graph outputs + - Fixed issue #2219: Add control socket on Linux to obtain information and initiate debugger or breakpoint + - Fixed issue #1562: Add 'local_vars' option to 'xdebug_get_function_stack' to include variables for each st + - Fixed issue #2194: Add 'params_as_values' option to 'xdebug_get_function_stack' to return data as values + - Fixed issue #2195: Add 'from_exception' option to 'xdebug_get_function_stack' to return the stack trace where an exception was thrown + ++ Improvements: + + - Fixed issue #2077: Bring back xdebug.collect_params + - Fixed issue #2170: Show contents of Spl's ArrayIterator + - Fixed issue #2172: Show contents of SplDoublyLinkedList and SplPriorityQueue + - Fixed issue #2183: Bubble up exception message when using code evalution through protocol + - Fixed issue #2188: Step over with fibers does still step into fiber routines + - Fixed issue #2197: Add time index and memory to output of xdebug_get_function_stack + - Fixed issue #2203: Increase default max nesting time out from 256 to 512 + - Fixed issue #2206: Optimise debugger breakpoints checking + - Fixed issue #2207: Add filenames for include and friends to flamegraph output + - Fixed issue #2217: xdebug://gateway pseudo host does not support IPv6 + += Fixed bugs: + + - Fixed issue #450: "Incomplete" backtraces when an exception gets rethrown + - Fixed issue #476: Exception chaining does not work properly + - Fixed issue #1155: Local variables are not shown when execution break in error_handler + - Fixed issue #2000: Debugger evaluate expression: "can't evaluate expression" + - Fixed issue #2027: Branch/path code coverage for traits drops trait name since 3.1.0 + - Fixed issue #2132: Errors when mountinfo does not have enough information for finding systemd private tmp directory + - Fixed issue #2200: PECL package file has wrong max PHP version number, and peclweb refuses the package + - Fixed issue #2208: Superfluous `...` (three omission dots) in var_dump() + - Fixed issue #2210: Flamegraphs crash when using `start_with_request` + - Fixed issue #2211: File wrappers get wrong filename location in stack. + - Fixed issue #2214: Array keys aren't escaped in traces + + + + 2023-10-19 + + + 3.3.0alpha3 + 3.3.0alpha3 + + + beta + beta + + Xdebug-1.03 + +Thu, Oct 19, 2023 - Xdebug 3.3.0alpha3 + += Fixed bugs: + + - Fixed issue #1732: Add support for flame graph outputs + - Fixed issue #2000: Debugger evaluate expression: "can't evaluate expression" + - Fixed issue #2077: Bring back xdebug.collect_params + - Fixed issue #2203: Increase default max nesting time out from 256 to 512 + - Fixed issue #2206: Optimise debugger breakpoints checking + + + + 2023-09-06 + + + 3.3.0alpha2 + 3.3.0alpha2 + + + beta + beta + + Xdebug-1.03 + +Wed, Sep 06, 2023 - Xdebug 3.3.0alpha2 + += Fixed bugs: + + - Fixed issue #2200: PECL package file has wrong max PHP version number, and peclweb refuses the package + + + + 2023-09-06 + + + 3.3.0alpha1 + 3.3.0alpha1 + + + beta + beta + + Xdebug-1.03 + +Wed, Sep 06, 2023 - Xdebug 3.3.0alpha1 + ++ New features: + + - Fixed issue #2171: Support for PHP 8.3 + ++ Improvements: + + - Fixed issue #1562: Add 'local_vars' option to 'xdebug_get_function_stack' to include variables for each st + - Fixed issue #2170: Show contents of Spl's ArrayIterator while debugging + - Fixed issue #2172: Show contents of SplDoublyLinkedList and SplPriorityQueue while debugging + - Fixed issue #2183: Bubble up exception message when using code evalution through protocol + - Fixed issue #2188: Step over with fibers does still step into fiber routines + - Fixed issue #2194: Add 'params_as_values' option to 'xdebug_get_function_stack' to return data as values + - Fixed issue #2195: Add 'from_exception' option to 'xdebug_get_function_stack' to return the stack trace where an exception was thrown + - Fixed issue #2197: Add time index and memory to output of xdebug_get_function_stack + += Fixed bugs: + + - Fixed issue #450: "Incomplete" backtraces when an exception gets rethrown + - Fixed issue #476: Exception chaining does not work properly + - Fixed issue #2132: Errors when mountinfo does not have enough information for finding systemd private tmp directory + + + + 2023-07-14 + + + 3.2.2 + 3.2.2 + + + stable + stable + + Xdebug-1.03 + +Fri, Jul 14, 2023 - Xdebug 3.2.2 + += Fixed bugs: + + - Fixed issue #2175: Crash with EXC_BAD_ACCESS in xdebug_str_create + - Fixed issue #2180: Crash on extended SplFixedArray + - Fixed issue #2182: Segfault with ArrayObject on stack + - Fixed issue #2186: Segfault with trampoline functions and debugger activation + + + + 2023-03-21 + + + 3.2.1 + 3.2.1 + + + stable + stable + + Xdebug-1.03 + +Tue, Mar 21, 2023 - Xdebug 3.2.1 + += Fixed bugs: + + - Fixed issue #2144: Xdebug 3.2.0 ignores xdebug.mode and enables all features + - Fixed issue #2145: Xdebug 3.2.0 crash PHP on Windows if xdebug.mode = off + - Fixed issue #2146: apache2 segfaulting with version 3.2.0 on PHP 8.0 + - Fixed issue #2148: Icon for link to docs in xdebug_info() HTML output does not always render correctly + + + + 2022-12-08 + + + 3.2.0 + 3.2.0 + + + stable + stable + + BSD style + +Thu, Dec 08, 2022 - Xdebug 3.2.0 + ++ New features: + + - Fixed issue #1819: Allow a list of headers in 'xdebug.client_discovery_header' + - Fixed issue #2079: Add pseudo hosts xdebug://gateway and xdebug://nameserver + - Fixed issue #2086: Include return value in return breakpoint interruption response + - Fixed issue #2087: Introduce step for the return state and virtual property for return value + ++ Improvements: + + - Fixed issue #2062: Xdebug now records whether systemd's PrivateTmp is used in its diagnostics information + - Fixed issue #2104: Add support for PHP 8.2 "SensitiveParameter" attribute + - Fixed issue #2117: Removed emulated properties for closures, as PHP 8.2 adds debug information for them + - Fixed issue #2122: Local variables are now available when using start_upon_error + - Fixed issue #2123: Add warning in log and diagnositics information when a breakpoint is set on a non-existing file + - Fixed issue #2138: Step debugger now disconnects and continues running the script, when the debugging client closes the connection + - Fixed issue #2136: Duplicate line/conditional breakpoints are now rejected + +- Deprecations: + + - Fixed issue #2014: Drop support for PHP 7.2 + - Fixed issue #2102: Drop support for PHP 7.3 + - Fixed issue #2103: Drop support for PHP 7.4 + += Fixed bugs: + + - Fixed issue #2002: xdebug_trace_handler_t handler members are not always checked for NULL when executing + - Fixed issue #2045: Inapproriate frowny face + - Fixed issue #2089: Alpine Linux does not support res_ninit + - Fixed issue #2093: Fatal error: linux/rtnetlink.h: No such file or directory linux/rtnetlink.h + - Fixed issue #2098: With breakpoint_include_return_value enabled step_out break at every function + - Fixed issue #2105: 3.2.0alpha1 package misses the php-header.h file + - Fixed issue #2108: Segfault on PHP8.1 with PHPUnit 10 when path coverage is enabled + - Fixed issue #2113: Crash at step_into after thrown exception with return value debugging en + - Fixed issue #2121: Xdebug does not use local independent float-to-string functions + - Fixed issue #2124: Xdebug incorrectly reports that there are no children for static closure properties, even though there are + - Fixed issue #2125: Crash with PHP 8.2 on 32-bit due to change in "not set" value with CATCH opcode + - Fixed issue #2126: Problems with retrieving global variables + - Fixed issue #2127: Tracing does not handle NUL char in anonymous closure scope + - Fixed issue #2133: Warning with regards to extra NUL character in xdebug_setcookie call + - Fixed issue #2134: Xdebug stops at the line where the exception is created, not where it is thrown + - Fixed issue #2135: Xdebug stops twice at the same line after a call breakpoint or xdebug_break() + + + + 2022-11-10 + + + 3.2.0RC2 + 3.2.0RC2 + + + beta + beta + + BSD style + +Thu, Nov 10, 2022 - Xdebug 3.2.0RC2 + += Fixed bugs: + + - Fixed issue #2100: "Fatal error: debuginfo() must return an array" when Exception is thrown from debugInfo in PHP 8.x + - Fixed issue #2101: When a temporary breakpoint is hit, breakpoint_list should show it as disabled + - Fixed issue #2126: Problems with retrieving global variables + - Fixed issue #2127: Tracing does not handle NUL char in anonymous closure scope + - Fixed issue #2129: Cannot read snapshot Gzip-compressed data is corrupt + - Fixed issue #2133: Warning with regards to extra NUL character in xdebug_setcookie call + - Fixed issue #2134: Xdebug stops at the line where the exception is created, not where it is thrown + - Fixed issue #2135: Xdebug stops twice at the same line after a call breakpoint or xdebug_break() + - Fixed issue #2136: Duplicate line/conditional breakpoints are not rejected + + + + 2022-10-10 + + + 3.2.0RC1 + 3.2.0RC1 + + + beta + beta + + BSD style + +Mon, Oct 10, 2022 - Xdebug 3.2.0RC1 + += Fixed bugs: + + - Fixed issue #2113: Crash at step_into after thrown exception with return value debugging en + - Fixed issue #2117: Removed emulated properties for closures, as PHP 8.2 adds debug information for them + - Fixed issue #2121: Xdebug does not use local independent float-to-string functions + - Fixed issue #2122: Local variables are not available when using start_upon_error + - Fixed issue #2123: Add warning in log and diagnositics information when a breakpoint is set on a non-existing file + - Fixed issue #2124: Xdebug incorrectly reports that there are no children for static closure properties, even thought there are + - Fixed issue #2125: Crash with PHP 8.2 on 32-bit due to change in "not set" value with CATCH opcode + + + + 2022-08-24 + + + 3.2.0alpha3 + 3.2.0alpha3 + + + beta + beta + + BSD style + +Wed, Aug 24, 2022 - Xdebug 3.2.0alpha3 + ++ Improvements: + + - Fixed issue #2112: Force 'return_value' breakpoint information and step to 'on' temporarily + + + + 2022-07-25 + + + 3.2.0alpha2 + 3.2.0alpha2 + + + beta + beta + + BSD style + +Mon, Jul 25, 2022 - Xdebug 3.2.0alpha2 + += Fixed bugs: + + - Fixed issue #2105: 3.2.0alpha1 package misses the php-header.h file + + + + 2022-07-20 + + + 3.2.0alpha1 + 3.2.0alpha1 + + + beta + beta + + BSD style + +Wed, Jul 20, 2022 - Xdebug 3.2.0alpha1 + ++ New features: + + - Fixed issue #1819: Allow a list of headers in 'xdebug.client_discovery_header' + - Fixed issue #2079: Add pseudo hosts xdebug://gateway and xdebug://nameserver + - Fixed issue #2087: Introduce step for the return state and virtual property for return value + - Fixed issue #2104: Add support for PHP 8.2 "SensitiveParameter" attribute + ++ Improvements: + + - Fixed issue #2086: Include return value in return breakpoint interruption response + +- Removed features: + + - Fixed issue #2014: Drop support for PHP 7.2 + - Fixed issue #2102: Drop support for PHP 7.3 + - Fixed issue #2103: Drop support for PHP 7.4 + += Fixed bugs: + + - Fixed issue #2002: xdebug_trace_handler_t handler members are not always checked for NULL when executing + - Fixed issue #2045: Inapproriate frowny face + - Fixed issue #2062: Profiler can't able to write cachegrind file at /tmp + - Fixed issue #2089: Alpine Linux does not support res_ninit + - Fixed issue #2093: Fatal error: linux/rtnetlink.h: No such file or directory linux/rtnetlink.h + - Fixed issue #2098: With breakpoint_include_return_value enabled step_out break at every function + + + + 2022-11-08 + + + 3.1.6 + 3.1.6 + + + stable + stable + + BSD style + +Tue, Nov 08, 2022 - Xdebug 3.1.6 + += Fixed bugs: + + - Fixed issue #2100: "Fatal error: debuginfo() must return an array" when Exception is thrown from debugInfo in PHP 8.x + - Fixed issue #2101: When a temporary breakpoint is hit, breakpoint_list should show it as disabled + - Fixed issue #2129: Cannot read snapshot Gzip-compressed data is corrupt + + + + 2022-06-06 + + + 3.1.5 + 3.1.5 + + + stable + stable + + BSD style + +Mon, Jun 06, 2022 - Xdebug 3.1.5 + += Fixed bugs: + + - Fixed issue #2056: Install documentation gives wrong arch for installation on M1 Macs + - Fixed issue #2082: phpize --clean removes required clocks.m4 file + - Fixed issue #2083: Constant defined with an enum case produce double "facet" attribute in context_get response + - Fixed issue #2085: Crash when used with source guardian encoded files + - Fixed issue #2090: Segfault in __callStatic() after FFI initialization + + + + 2022-04-04 + + + 3.1.4 + 3.1.4 + + + stable + stable + + BSD style + +Mon, Apr 04, 2022 - Xdebug 3.1.4 + += Fixed bugs: + + - Fixed issue #2006: Removing second call breakpoint with same function name + - Fixed issue #2060: XDebug breaks the Symfony "PhpFilesAdapter" cache adapter + - Fixed issue #2061: Possible use after free with GC Stats + - Fixed issue #2063: Can't inspect ArrayObject storage elements + - Fixed issue #2064: Segmentation fault in symfony cache + - Fixed issue #2068: Debug session can be started with "XDEBUG_SESSION_START=anything" when xdebug.trigger_value is set + - Fixed issue #2069: Warn when profiler_append is used together with zlib compression + - Fixed issue #2075: Code coverage misses static array assignment lines + + + + 2022-02-01 + + + 3.1.3 + 3.1.3 + + + stable + stable + + BSD style + +Tue, Feb 01, 2022 - Xdebug 3.1.3 + += Fixed bugs: + + - Fixed issue #2049: evaling broken code (still) causes unhandled exception in PHP 7.4 + - Fixed issue #2052: Memory leak when a trace file can't be opened because xdebug.trace_output_name is invalid + - Fixed issue #2054: Slowdown when calling a function with long string parameters + - Fixed issue #2055: Debugger creates XML with double facet attribute + + + + 2021-12-01 + + + 3.1.2 + 3.1.2 + + + stable + stable + + BSD style + +Wed, Dec 01, 2021 - Xdebug 3.1.2 + += Fixed bugs: + + - Fixed issue #2036: Segfault on fiber switch in finally block in garbage collected fiber + - Fixed issue #2037: Crash when profile file can not be created + - Fixed issue #2041: __debugInfo is not used for var_dump output + - Fixed issue #2046: Segault on xdebug_get_function_stack inside a Fiber + + + + 2021-10-15 + + + 3.1.1 + 3.1.1 + + + stable + stable + + BSD style + +Fri, Oct 15, 2021 - Xdebug 3.1.1 + += Fixed bugs: + + - Fixed issue #2016: apache gives no output with xdebug 3.1.0b2 installed + - Fixed issue #2024: Apache restarts in a loop under PHP 8.1.0 RC3 + - Fixed issue #2029: incorrect and inaccurate date and time displayed in xdebug.log and trace files + - Fixed issue #2030: PhpStorm step-debug not working on PHP 8.0.11 + - Fixed issue #2032: Use runtime PHP version in DBGp and info pages instead of compiled-against version + - Fixed issue #2034: Xdebug throws a Segmentation fault when 'set_time_limit' function is disabled + - Fixed issue #2035: Xdebug block everything with localhost in XAMMP + + + + 2021-10-04 + + + 3.1.0 + 3.1.0 + + + stable + stable + + BSD style + +Mon, Oct 04, 2021 - Xdebug 3.1.0 + += Fixed bugs: + + - Fixed issue #1472: Add assignments to computer readable trace format + - Fixed issue #1537: Add links to documentation to various different "features" after wizard has run + - Fixed issue #1738: Add xdebug_notify() function to send data through DBGp to a debugging client + - Fixed issue #1853: Enable profile compression for cachegrind files + - Fixed issue #1890: Add connected client and protocol features to diagnostic page + - Fixed issue #1898: API for querying the currently active mode(s) + - Fixed issue #1933: Allow for cloud ID to be set through the trigger + - Fixed issue #1938: Branches in traits aren't marked as executed + - Fixed issue #1948: Do not redirect warning and error messages to PHP's error log if an Xdebug log is active + - Fixed issue #1949: private properties for internal classes can't be fetched for debugging + - Fixed issue #1963: php exit code = -1073741819 when xdebug.mode = off (Windows Thread Safe Only) + - Fixed issue #1969: Provide breakpoint ID / info in DBGp run command responses + - Fixed issue #1970: xdebug_get_function_stack with unnamed (internal) parameters have wrong index + - Fixed issue #1972: Add support for PHP 8.1 Fibers + - Fixed issue #1974: Add gzip support to trace files + - Fixed issue #1976: Switch debug session cookie to Lax, and remove expiry time + - Fixed issue #1978: Xdebug's log messages are cut off at 512 bytes + - Fixed issue #1980: PHP 8.1: Mark enum classes as "enum" + - Fixed issue #1986: Add support for multiple trigger values + - Fixed issue #1989: Profiling does not output correct class when parent keyword is used + - Fixed issue #1992: Code Coverage with filter produces Segmentation fault on xdebug_stop_code_coverage() + - Fixed issue #1993: eval-ing broken code causes stepping to break + - Fixed issue #1996: Add support for Closure visualisation in traces, debugging, and Xdebug's var_dump + - Fixed issue #1997: Added xdebug_connect_to_client() to attempt a debugging connect while running code + - Fixed issue #1998: Double facet attribute generated for enums that are stored in properties + - Fixed issue #1999: Add "readonly" facet to PHP 8.1 readonly properties + - Fixed issue #2001: Add 'xdebug.use_compression' setting to turn on/off compression for profiling files + - Fixed issue #2004: Figure out what "XDEBUG_SHOW_FNAME_TODO" define is for + - Fixed issue #2007: xdebug 3.x fails to build on OS X 10.11 or earlier due to clock_gettime_nsec_np requirement + - Fixed issue #2008: Using the XDEBUG_SESSION cookie could bypass shared-secret checks + - Fixed issue #2009: xdebug_stop_code_coverage's argument has type mismatch + - Fixed issue #2011: Closures as protected properties have double facet XML attribute + - Fixed issue #2013: Support PHP 8.1 + - Fixed issue #2018: zlib compression support on Windows + - Fixed issue #2019: Xdebug crash because of uninitialized memory + - Fixed issue #2020: segfault if xdebug.dump.GET=* and integer key without value in URL + - Fixed issue #2021: Segmentation fault due to NULL bytes in internal anonymous class names + - Fixed issue #2025: Anonymous classes which extend are not detected as anonymous classes since PHP 8.0 + + + + 2021-09-07 + + + 3.1.0beta2 + 3.1.0beta2 + + + beta + beta + + BSD style + +Tue, Sep 07, 2021 - Xdebug 3.1.0beta2 + += Fixed bugs: + - This is a packaging fix only release. The package missed a file that were needed + for building on PHP 7.2 and 8.1. + + + + 2021-09-05 + + + 3.1.0beta1 + 3.1.0beta1 + + + beta + beta + + BSD style + +Sun, Sep 05, 2021 - Xdebug 3.1.0beta1 + ++ New features: + + - Fixed issue #1738: Add xdebug_notify() function to send data through DBGp to a debugging client + - Fixed issue #1853: Enable profile compression for cachegrind files + - Fixed issue #1898: API for querying the currently active mode(s) + - Fixed issue #1972: Add support for PHP 8.1 Fibers + - Fixed issue #1974: Add gzip support to trace files + - Fixed issue #1997: Added xdebug_connect_to_client() to attempt a debugging connect while running code + - Fixed issue #2001: Add 'xdebug.use_compression' setting to turn on/off compression for profiling files + - Fixed issue #2013: Support PHP 8.1 + ++ Improvements: + + - Fixed issue #1472: Add assignments to computer readable trace format + - Fixed issue #1890: Add connected client and protocol features to diagnostic page + - Fixed issue #1933: Allow for cloud ID to be set through the trigger + - Fixed issue #1969: Provide breakpoint ID / info in DBGp run command responses + - Fixed issue #1976: Switch debug session cookie to Lax, and remove expiry time + - Fixed issue #1980: PHP 8.1: Mark enum classes as "enum" + - Fixed issue #1986: Add support for multiple trigger values + - Fixed issue #1996: Add support for Closure visualisation in traces, debugging, and Xdebug's var_dump + - Fixed issue #1999: Add "readonly" facet to PHP 8.1 readonly properties + += Fixed bugs: + + - Fixed issue #1938: Branches in traits aren't marked as executed + - Fixed issue #1948: Do not redirect warning and error messages to PHP's error log if an Xdebug log is active + - Fixed issue #1949: private properties for internal classes can't be fetched for debugging + - Fixed issue #1963: php exit code = -1073741819 when xdebug.mode = off (Windows Thread Safe Only) + - Fixed issue #1970: xdebug_get_function_stack with unnamed (internal) parameters have wrong index + - Fixed issue #1978: Xdebug's log messages are cut off at 512 bytes + - Fixed issue #1989: Profiling does not output correct class when parent keyword is used + - Fixed issue #1992: Code Coverage with filter produces Segmentation fault on xdebug_stop_code_coverage() + - Fixed issue #1993: eval-ing broken code causes stepping to break + - Fixed issue #1998: Double facet attribute generated for enums that are stored in properties + - Fixed issue #2004: Figure out what "XDEBUG_SHOW_FNAME_TODO" define is for + - Fixed issue #2008: Using the XDEBUG_SESSION cookie could bypass shared-secret checks + - Fixed issue #2009: xdebug_stop_code_coverage's argument has type mismatch + - Fixed issue #2011: Closures as protected properties have double facet XML attribute + ++ Documentation + + - Fixed issue #1537: Add links to documentation to various different "features" after wizard has run + + + + 2021-04-08 + + + 3.0.4 + 3.0.4 + + + stable + stable + + BSD style + +Thu, Apr 08, 2021 - Xdebug 3.0.4 + += Fixed bugs: + + - Fixed issue #1802: Improve xdebug.org home page + - Fixed issue #1944: tracing is started without trigger, when profiler is also enabled + - Fixed issue #1947: xdebug_info() settings section does not show the modes that are overridden by XDEBUG_MODE + - Fixed issue #1950: Assignment trace with ASSIGN_OBJ_REF crashes + - Fixed issue #1954: Calling xdebug_start_trace without mode including tracing results in a fatal error + + + + 2021-02-22 + + + 3.0.3 + 3.0.3 + + + stable + stable + + BSD style + +Mon, Feb 22, 2021 - Xdebug 3.0.3 + += Fixed bugs: + + - Fixed issue #1930: No local variables with trigger and xdebug_break() + - Fixed issue #1931: xdebug_info() output misses configuration settings if phpinfo() has been called + - Fixed issue #1932: One line in multi-line string concatenation is not covered + - Fixed issue #1940: Wrong type used for showing GC Stats reports + + + + 2021-01-04 + + + 3.0.2 + 3.0.2 + + + stable + stable + + BSD style + +Mon, Jan 04, 2021 - Xdebug 3.0.2 + += Fixed bugs: + + - Fixed issue #1907: Empty exception message when setting the $message property to a stringable object + - Fixed issue #1910: Code coverage misses constructor property promotion code + - Fixed issue #1914: Compillation failure on OpenBSD + - Fixed issue #1915: Debugger should only start with XDEBUG_SESSION and not XDEBUG_PROFILE + - Fixed issue #1918: Warn if PHP's Garbage Collection is disabled in gc_stats mode + - Fixed issue #1919: Crash when enabling filter without the right mode active + - Fixed issue #1921: Xdebug does not start step debugging if start_with_request=trigger + - Fixed issue #1922: Code coverage misses array assignment lines + - Fixed issue #1924: Deprecated INI settings displayed in phpinfo() + - Fixed issue #1925: xdebug.start_with_request and start_upon_error display inconsistent values + - Fixed issue #1926: Add Xdebug mode's source to xdebug_info() output + - Fixed issue #1927: Crash when calling xdebug_stop_trace without a trace in progress + - Fixed issue #1928: xdebug_stop_gcstats() can also return false + + + + 2020-12-04 + + + 3.0.1 + 3.0.1 + + + stable + stable + + BSD style + +Fri, Dec 4, 2020 - xdebug 3.0.1 + += Fixed bugs: + + - Fixed issue #1893: Crash with ext-fiber and xdebug.mode=coverage + - Fixed issue #1896: Segfault with closures that are not created from user code + - Fixed issue #1897: Crash when removing a breakpoint + - Fixed issue #1900: Update README and add run-xdebug-tests.php to package + - Fixed issue #1901: Stack traces are shown (with a broken time) when Xdebug's mode includes 'debug' but not 'develop' or 'trace' + - Fixed issue #1902: Compillation failure on AIX + - Fixed issue #1903: Constants should always be available, regardless of which mode Xdebug is in + - Fixed issue #1904: Profile and trace files using %t or %u do not get the right names + - Fixed issue #1905: Debugger does not disable request timeouts + + + + 2020-11-25 + + + 3.0.0 + 3.0.0 + + + stable + stable + + BSD style + +Wed, Nov 25, 2020 - xdebug 3.0.0 + +Xdebug 3 includes major changes in functionality compared to Xdebug 2. The +primary way how you turn on functionality is through the new xdebug.mode PHP +configuration setting. This made it possible to massively increase performance +in many of Xdebug's sub systems as Xdebug is now much more conservative in +which hooks are enabled. + +Configuration changes, massive performance improvements, and PHP 8 support are +the primary features in Xdebug 3, but there is much more. The upgrade guide +lists the changes in great detail, please read it: + +https://xdebug.org/docs/upgrade_guide + +------------- + ++ New features: + + - Implemented issue #1762: Introduce feature modes + - Implemented issue #1793: Add xdebug.start_upon_error setting to cover the removed xdebug.remote_mode=jit feature. + - Implemented issue #1797: Implement generic logging + - Implemented issue #1801: Rename mode 'display' to mode 'develop' + - Implemented issue #1831: Add diagnostics function xdebug_info() + - Implemented issue #1833: Add links to documentation in diagnostic log + - Implemented issue #1837: Support for associative variadic variable names (PHP 8) + - Implemented issue #1841: Add support for PHP 8 'match' keyword + ++ Improvements: + + - Implemented issue #1680: Update var dumping routines to include relevant information for interned strings and immutable arrays + - Implemented issue #1712: Add unit to profiler data types + - Implemented issue #1743: Figuring out whether a call is a closure uses string comparisions instead of checking the ACC flag (Benjamin Eberlei) + - Implemented issue #1752: Use a stack pool to manage stack entries instead of allocating and deallocating entries + - Implemented issue #1755: Overload pcntl_fork() to prevent performance degradation by calling xdebug_get_pid often (Carlos Granados) + - Implemented issue #1781: Include 'Xdebug' in max nesting level error message + - Implemented issue #1783: Stacktrace needs vertical scrolling on small screens (Tobias Tom) + - Implemented issue #1789: Provide PHP stubs for Xdebug's functions + - Implemented issue #1807: Document Xdebug installation with yum and apt + - Implemented issue #1813: Make sure that the xdebug_init_*_globals don't do more than they need to, and that init is only done when xdebug.mode != off + - Implemented issue #1817: Switch filename storage from char*/size_t to zend_string* + - Implemented issue #1818: Switch variable storage from char*/size_t to zend_string* + - Implemented issue #1820: Increase time tracing precision (Michael Vorisek) + - Implemented issue #1824: Allow Xdebug's mode to be set through an environment variable + - Implemented issue #1825: Improve profiler performance by not calling fflush after every function (Michael Vorisek) + - Implemented issue #1826: Reduce profiler memory allocation and call overhead + - Implemented issue #1829: Switch to 10ns profiler resolution (Michael Vorisek) + - Implemented issue #1832: If connect back host can not be contacted, fallback to remote_host/port + - Implemented issue #1858: Only open/close log if there is an actual message to log + - Implemented issue #1860: Allow xdebug.cloud_id to be set through an environment variable + - Implemented issue #1814: Don't obtain the current time when it's not needed + - Implemented issue #1835: Add current trace and profile file name, to diagnostic page + - Implemented issue #1885: Change xdebug.start_with_ settings to PHP_INI_SYSTEM|PHP_INI_PERDIR + - Implemented issue #1889: max_nesting_level should only trigger in "develop" mode + +- Removed features: + + - Implemented issue #1795: Deprecate PHP 7.1 support + + - Implemented issue #1786: Remove idekey value fallback to USER/USERNAME environment variable + - Implemented issue #1809: Remove "overload_var_dump" setting + - Implemented issue #1810: Remove collect_vars and xdebug_get_declared_vars() + - Implemented issue #1812: Remove show_mem_delta setting + - Implemented issue #1838: Remove collect_params setting, and always default it to "4" + - Implemented issue #1847: Remove xdebug.remote_cookie_expire_time setting + - Implemented issue #1016: Removed support for pause-execution (introduced in beta1) + - Implemented issue #1868: Remove xdebug_disable and xdebug_enabled + - Implemented issue #1883: Function xdebug_is_enabled has been removed + += Changes: + + - Implemented issue #1378: Unfortunate coupling of default_enable=1 and remote_mode=jit + - Implemented issue #1773: Replace all xdebug.*_output_dir settings with xdebug.output_dir + - Implemented issue #1785: Replace xdebug.remote_mode and xdebug.auto_trace with generic "start-with-request" setting + - Implemented issue #1791: Replace xdebug.*trigger*, xdebug.*trigger_value*, with xdebug.start_with_request=trigger and xdebug.trigger_value + - Implemented issue #1792: Change start_with_request=always/never to start_with_request=yes/no + - Implemented issue #1794: Replace the filter's blacklist/whitelist with exclude/include + - Implemented issue #1811: Remove xdebug.collect_includes setting and always include them + - Implemented issue #1843: Adjust XDEBUG_CONFIG checks, and document what can be set through it + - Implemented issue #1844: Add deprecation warning for removed and renamed configuration setting names + - Implemented issue #1845: Rename xdebug.remote_{host,port} to xdebug.client_{host,port} + - Implemented issue #1846: Rename setting xdebug.remote_timeout to xdebug.connect_timeout_ms + - Implemented issue #1848: Change default Xdebug port from 9000 to 9003 + - Implemented issue #1850: Change array variable output in tracing to use modern [] syntax + - Implemented issue #1856: Rename xdebug.remote_connect_back to xdebug.discover_client_host + - Implemented issue #1857: Rename xdebug.remote_addr_header to xdebug.client_discovery_header + += Fixed bugs: + + - Fixed issue #1608: XDEBUG_CONFIG env var make sessions automatically START ever (at least send the XDEBUG_SESSION cookie) + - Fixed issue #1726: Memory leaks spotted in various places in typical error code paths + - Fixed issue #1757: Pause-execution feature degrades performance + - Fixed issue #1864: Incompatibility with PCS and protobuf extensions + - Fixed issue #1870: XDEBUG_SESSION_START URL parameter does not override XDEBUG_SESSION cookie + - Fixed issue #1871: The "idekey" is not set when debugging is started through XDEBUG_SESSION cookie + - Fixed issue #1873: xdebug_info() segfaults if the diagnostic buffer is empty + - Fixed issue #1874: Incompatibility with protobuf extension + - Fixed issue #1875: Overflow with large amounts of elements for variadics + - Fixed issue #1878: Compilation failure: Socket options TCP_KEEPCNT and TCP_KEEPINTVL do not exist on Solaris 10 Sparc + - Fixed issue #1880: Bundled unit test tests/debugger/bug00886.phar misses to load phar extension + - Fixed issue #1887: Crash bug with xdebug_call_class and xdebug_call_file + - Fixed issue #1756: Php process won't exit after running connected to a client + - Fixed issue #1823: Profiler generates negative data for memory usage + - Fixed issue #1834: Return type must be bool in overloaded set_time_limit + - Fixed issue #1888: Make headers sticky in xdebug_info() output + ++ Documentation + + - Fixed issue #1865: Document XDEBUG_TRIGGER environment variable + - Fixed issue #1866: Document comma separated xdebug.mode values + - Fixed issue #1884: Document where Xdebug's settings can be set + - Fixed issue #1892: Document changed/removed ini settings in the upgrade guide with the links provided + + + + 2020-11-16 + + + 3.0.0RC1 + 3.0.0RC1 + + + beta + beta + + BSD style + +Mon, Nov 16, 2020 - xdebug 3.0.0RC1 + +This is a BETA release, and not ready for production environments. + +Xdebug 3 has many changes. Please read the upgrade guide at +https://3.xdebug.org/docs/upgrade_guide + +Xdebug 3 documentation is available at https://3.xdebug.org/docs + +------------- + ++ Improvements: + + - Implemented issue #1814: Don't obtain the current time when it's not needed + - Implemented issue #1885: Change xdebug.start_with_ settings to PHP_INI_SYSTEM|PHP_INI_PERDIR + +- Removed features: + + - Implemented issue #1016: Removed support for pause-execution (introduced in beta1) + - Implemented issue #1868: Remove xdebug_disable and xdebug_enabled + - Implemented issue #1883: Function xdebug_is_enabled has been removed + += Fixed bugs: + + - Fixed issue #1608: XDEBUG_CONFIG env var make sessions automatically START ever (at least send the XDEBUG_SESSION cookie) + - Fixed issue #1757: Pause-execution feature degrades performance + - Fixed issue #1864: Incompatibility with PCS and protobuf extensions + - Fixed issue #1870: XDEBUG_SESSION_START URL parameter does not override XDEBUG_SESSION cookie + - Fixed issue #1871: The "idekey" is not set when debugging is started through XDEBUG_SESSION cookie + - Fixed issue #1873: xdebug_info() segfaults if the diagnostic buffer is empty + - Fixed issue #1874: Incompatibility with protobuf extension + - Fixed issue #1875: Overflow with large amounts of elements for variadics + - Fixed issue #1878: Compilation failure: Socket options TCP_KEEPCNT and TCP_KEEPINTVL do not exist on Solaris 10 Sparc + - Fixed issue #1880: Bundled unit test tests/debugger/bug00886.phar misses to load phar extension + - Fixed issue #1887: Crash bug with xdebug_call_class and xdebug_call_file + ++ Documentation + + - Fixed issue #1865: Document XDEBUG_TRIGGER environment variable + - Fixed issue #1866: Document comma separated xdebug.mode values + - Fixed issue #1884: Document where Xdebug's settings can be set + + + + 2020-10-14 + + + 3.0.0beta1 + 3.0.0beta1 + + + beta + beta + + BSD style + +Wed, Oct 14, 2020 - xdebug 3.0.0beta1 + +This is a BETA release, and not ready for production environments. + +Xdebug 3 has many changes. Please read the upgrade guide at +https://3.xdebug.org/docs/upgrade_guide + +Xdebug 3 documentation is available at https://3.xdebug.org/docs + +------------- + ++ New features: + + - Implemented issue #1762: Introduce feature modes + - Implemented issue #1793: Add xdebug.start_upon_error setting to cover the removed xdebug.remote_mode=jit feature. + - Implemented issue #1797: Implement generic logging + - Implemented issue #1801: Rename mode 'display' to mode 'develop' + - Implemented issue #1831: Add diagnostics function xdebug_info() + - Implemented issue #1833: Add links to documentation in diagnostic log + - Implemented issue #1837: Support for associative variadic variable names (PHP 8) + - Implemented issue #1841: Add support for PHP 8 'match' keyword + +- Removed features: + + - Implemented issue #1795: Deprecate PHP 7.1 support + + - Implemented issue #1786: Remove idekey value fallback to USER/USERNAME environment variable + - Implemented issue #1809: Remove "overload_var_dump" setting + - Implemented issue #1810: Remove collect_vars and xdebug_get_declared_vars() + - Implemented issue #1812: Remove show_mem_delta setting + - Implemented issue #1838: Remove collect_params setting, and always default it to "4" + - Implemented issue #1847: Remove xdebug.remote_cookie_expire_time setting + += Changes: + + - Implemented issue #1378: Unfortunate coupling of default_enable=1 and remote_mode=jit + - Implemented issue #1773: Replace all xdebug.*_output_dir settings with xdebug.output_dir + - Implemented issue #1785: Replace xdebug.remote_mode and xdebug.auto_trace with generic "start-with-request" setting + - Implemented issue #1791: Replace xdebug.*trigger*, xdebug.*trigger_value*, with xdebug.start_with_request=trigger and xdebug.trigger_value + - Implemented issue #1792: Change start_with_request=always/never to start_with_request=yes/no + - Implemented issue #1794: Replace the filter's blacklist/whitelist with exclude/include + - Implemented issue #1811: Remove xdebug.collect_includes setting and always include them + - Implemented issue #1844: Add deprecation warning for removed and renamed configuration setting names + - Implemented issue #1845: Rename xdebug.remote_{host,port} to xdebug.client_{host,port} + - Implemented issue #1846: Rename setting xdebug.remote_timeout to xdebug.connect_timeout_ms + - Implemented issue #1848: Change default Xdebug port from 9000 to 9003 + - Implemented issue #1850: Change array variable output in tracing to use modern [] syntax + - Implemented issue #1856: Rename xdebug.remote_connect_back to xdebug.discover_client_host + - Implemented issue #1857: Rename xdebug.remote_addr_header to xdebug.client_discovery_header + ++ Improvements: + + - Implemented issue #1680: Update var dumping routines to include relevant information for interned strings and immutable arrays + - Implemented issue #1712: Add unit to profiler data types + - Implemented issue #1743: Figuring out whether a call is a closure uses string comparisions instead of checking the ACC flag (Benjamin Eberlei) + - Implemented issue #1752: Use a stack pool to manage stack entries instead of allocating and deallocating entries + - Implemented issue #1755: Overload pcntl_fork() to prevent performance degradation by calling xdebug_get_pid often (Carlos Granados) + - Implemented issue #1781: Include 'Xdebug' in max nesting level error message + - Implemented issue #1783: Stacktrace needs vertical scrolling on small screens (Tobias Tom) + - Implemented issue #1789: Provide PHP stubs for Xdebug's functions + - Implemented issue #1807: Document Xdebug installation with yum and apt + - Implemented issue #1813: Make sure that the xdebug_init_*_globals don't do more than they need to, and that init is only done when xdebug.mode != off + - Implemented issue #1817: Switch filename storage from char*/size_t to zend_string* + - Implemented issue #1818: Switch variable storage from char*/size_t to zend_string* + - Implemented issue #1820: Increase time tracing precision (Michael Vorisek) + - Implemented issue #1824: Allow Xdebug's mode to be set through an environment variable + - Implemented issue #1825: Improve profiler performance by not calling fflush after every function (Michael Vorisek) + - Implemented issue #1826: Reduce profiler memory allocation and call overhead + - Implemented issue #1829: Switch to 10ns profiler resolution (Michael Vorisek) + - Implemented issue #1832: If connect back host can not be contacted, fallback to remote_host/port + - Implemented issue #1858: Only open/close log if there is an actual message to log + - Implemented issue #1860: Allow xdebug.cloud_id to be set through an environment variable + += Fixed bugs: + + - Fixed issue #1756: Php process won't exit after running connected to a client + - Fixed issue #1823: Profiler generates negative data for memory usage + - Fixed issue #1834: Return type must be bool in overloaded set_time_limit + + + + 2020-09-28 + + + 2.9.8 + 2.9.8 + + + stable + stable + + BSD style + +Mon, Sep 28, 2020 - xdebug 2.9.8 + += Fixed bugs: + + - Fixed issue #1851: Paths are not counted as coveraged with loops calling function + - Fixed issue #1855: Build issues on FreeBSD + + + + 2020-09-16 + + + 2.9.7 + 2.9.7 + + + stable + stable + + BSD style + +Wed, Sep 16, 2020 - xdebug 2.9.7 + += Fixed bugs: + + - Fixed issue #1839: Add keepalive options to debugging socket + + + + 2020-05-29 + + + 2.9.6 + 2.9.6 + + + stable + stable + + BSD style + +Fri, May 29, 2020 - xdebug 2.9.6 + += Fixed bugs: + + - Fixed issue #1782: Cookie "XDEBUG_SESSION" will be soon rejected because it has the "sameSite" attribute set to none + - Fixed issue #1787: Branch coverage data does not always follow the lines/functions format + - Fixed issue #1790: Segfault in var_dump() or while debugging with protobuf extension + + + + 2020-04-25 + + + 2.9.5 + 2.9.5 + + + stable + stable + + BSD style + +Sat, Apr 25, 2020 - xdebug 2.9.5 + += Fixed bugs: + + - Fixed issue #1772: Crash with exception thrown inside a destructor + - Fixed issue #1775: Segfault when another extension compiles a PHP file during RINIT + - Fixed issue #1779: Nested multi-line built-in function in namespace are not covered + + + + 2020-03-23 + + + 2.9.4 + 2.9.4 + + + stable + stable + + BSD style + +Mon, Mar 23, 2020 - xdebug 2.9.4 + += Fixed bugs: + + - Fixed issue #1763: Crash while setting opcode overrides in ZTS mode. + - Fixed issue #1766: Using the DBGp detach command disables remote debugging for the whole process. + + + + 2020-03-13 + + + 2.9.3 + 2.9.3 + + + stable + stable + + BSD style + +Fri, Mar 13, 2020 - xdebug 2.9.3 + += Fixed bugs: + + - Fixed issue #1753: Resolved breakpoints use information from wrong files + - Fixed issue #1758: Xdebug changes error_get_last results inside a try catch + - Fixed issue #1759: User registered opcode handlers should call ones already set by other extensions + + + + 2020-01-31 + + + 2.9.2 + 2.9.2 + + + stable + stable + + BSD style + +Fri, Jan 31, 2020 - xdebug 2.9.2 + += Fixed bugs: + + - Fixed issue #1735: DBGp eval warning promoted to Exception can cause out-of-sync responses + - Fixed issue #1736: Segmentation fault when other extensions run PHP in RINIT + - Fixed issue #1739: Tracing footer not written + + + + 2020-01-16 + + + 2.9.1 + 2.9.1 + + + stable + stable + + BSD style + +Thu, Jan 16, 2020 - xdebug 2.9.1 + += Fixed bugs: + + - Fixed issue #1721: Header may not contain NUL bytes in Unknown on line 0 + - Fixed issue #1727: Debugger stops more often than expected due to resolving breakpoints + - Fixed issue #1728: INIT_STATIC_METHOD_CALL is not overloaded + - Fixed issue #1731: var_dump with DateTime does not output properties (Ryan Mauger) + - Fixed issue #1733: SEND_VAR_NO_REF_EX opcode, used for require(), is not overloaded + - Fixed issue #1734: Segfault with DBGp "source" with a out-of-range start line number + + + + 2019-12-09 + + + 2.9.0 + 2.9.0 + + + stable + stable + + BSD style + +Mon, Dec 9, 2019 - xdebug 2.9.0 + ++ Improvements: + + - Fixed issue #1723: Class/function pre-analysis for code coverage speed improvements + +- Removed features: + + - Fixed issue #1301: Removed aggregated profiler feature + - Fixed issue #1720: Remove superfluous xdebug.remote_handler setting + += Fixed bugs: + + - Fixed issue #1722: Build warning issues on FreeBSD + - Fixed issue #1724: Missing property types and uninitialised values in variable dumping routines + + + + 2019-12-02 + + + 2.8.1 + 2.8.1 + + + stable + stable + + BSD style + +Mon, Dec 2, 2019 - xdebug 2.8.1 + += Fixed bugs: + + - Fixed issue #1717: Code coverage turned slow after update from 2.7.2 to 2.8.0 + + + + 2019-10-31 + + + 2.8.0 + 2.8.0 + + + stable + stable + + BSD style + +Thu, Oct 31, 2019 - xdebug 2.8.0 + += Fixed bugs: + + - Fixed issue #1665: Segfault with garbage collection and complex function arguments + - Fixed issue #1699: Crash during debugging Phalcon project + - Fixed issue #1705: Crash while debugging with ionCube being used + - Fixed issue #1708: Crash on evaluating object with properties + - Fixed issue #1709: Wrong data type breaks tests on Big Endian build + - Fixed issue #1713: INIT_FCALL is not overloaded in code coverage + + + + 2019-08-26 + + + 2.8.0beta2 + 2.8.0beta2 + + + beta + beta + + BSD style + +Mon, Aug 26, 2019 - xdebug 2.8.0beta2 + += Fixed bugs: + + - Fixed issue #1540: Code coverage should not run when turned off in php.ini + - Fixed issue #1573: Using an exception_handler creates an extra broken profiler file + - Fixed issue #1589: function names used in auto_prepend_file missing from profile file + - Fixed issue #1613: Wrong name displayed for Recoverable fatal error + - Fixed issue #1652: Problems with detach in debugger init stage + - Fixed issue #1676: Xdebug doesn't write trace footer for shutdown functions + - Fixed issue #1689: Traces show return values and exit information for functions without entry information + - Fixed issue #1691: Code Coverage misses fluent interface function call + - Fixed issue #1698: Switch PHP 7.4 Windows builds back to VS17 + - Fixed issue #1700: Xdebug abuses possibilty immutable class flags + + + + 2019-07-25 + + + 2.8.0beta1 + 2.8.0beta1 + + + beta + beta + + BSD style + +Thu, Jul 25, 2019 - xdebug 2.8.0beta1 + += Fixed bugs: + + - Fixed issue #1679: Code Coverage misses static property as function + argument + - Fixed issue #1682: Invalid NULL byte in debugger XML with anonymous classes + - Fixed issue #1683: Xdebug does not compile due to changes to ASSIGN_ADD and + friends operations in PHP 7.4alpha3 + - Fixed issue #1687: Use appropriate process ID for logging and "right + process" tracking + - Fixed issue #1688: Improve performance by using getpid() only when step + debugger is active + + + + 2019-06-28 + + + 2.8.0alpha1 + 2.8.0alpha1 + + + beta + beta + + BSD style + +Fri, May 28, 2019 - xdebug 2.8.0alpha1 + ++ Added features: + + - Implemented issue #1599: Add support for PHP 7.4 + ++ Improvements: + + - Implemented issue #1388: Support 'resolved' flag for breakpoints + - Implemented issue #1664: Run breakpoint resolver when after a new breakpoint is added as well + += Fixed bugs: + + - Fixed issue #1660: Return breakpoints for methods don't break immediately + +- Removed features: + + - Fixed issue #1666: Remove xdebug.extended_info setting + + + + 2019-05-06 + + + 2.7.2 + 2.7.2 + + + stable + stable + + BSD style + +Mon, May 6, 2019 - xdebug 2.7.2 + += Fixed bugs: + + - Fixed issue #1488: Rewrite DBGp 'property_set' to always use eval + - Fixed issue #1586: error_reporting()'s return value is incorrect during debugger's 'eval' command + - Fixed issue #1615: Turn off Zend OPcache when remote debugger is turned on + - Fixed issue #1656: remote_connect_back alters header if multiple values are present + - Fixed issue #1662: __debugInfo should not be used for user-defined classes + + + + 2019-04-05 + + + 2.7.1 + 2.7.1 + + + stable + stable + + BSD style + +Wed, Apr 5, 2019 - xdebug 2.7.1 + += Fixed bugs: + + - Fixed issue #1646: Missing newline in error message + - Fixed issue #1647: Memory corruption when a conditional breakpoint is used + - Fixed issue #1641: Perfomance degradation with getpid syscall (Kees Hoekzema) + + + + 2019-03-06 + + + 2.7.0 + 2.7.0 + + + stable + stable + + BSD style + +Wed, Mar 6, 2019 - xdebug 2.7.0 + += Fixed bugs: + + - Fixed issue #1520: Xdebug does not handle variables and properties with "-" in their name + - Fixed issue #1577: Code coverage path analysis with chained catch fails in PHP 7.3 + - Fixed issue #1639: Compile warning/error on GCC 8 or Clang due to "break intentionally missing" + - Fixed issue #1642: Debugger gives: "Warning: Header may not contain NUL bytes" + + + + 2019-02-15 + + + 2.7.0RC2 + 2.7.0RC2 + + + beta + beta + + BSD style + +Fri, Feb 15, 2019 - xdebug 2.7.0RC2 + += Fixed bugs: + + - Fixed issue #1551: Property with value null is not represented well + - Fixed issue #1621: Xdebug fails to compile cleanly on 32-bit platforms + - Fixed issue #1625: Work around ABI conflicts in PHP 7.3.0/PHP 7.3.1 + - Fixed issue #1628: The PHP function name being constructed to record when GC Collection runs, is not freed + - Fixed issue #1629: SOAP Client/Server detection code does not handle inherited classes + + + + 2019-02-01 + + + 2.7.0RC1 + 2.7.0RC1 + + + beta + beta + + BSD style + +Fri, Feb 1, 2019 - xdebug 2.7.0RC1 + += Fixed bugs: + + - Fixed issue #1571: File/line information is not shown for closures in namespaces. + - Fixed issue #1578: Compile error due to redefinition of "zif_handler" with old GCCs. + - Fixed issue #1583: Xdebug crashes when OPcache's compact literals optimisation is on. + - Fixed issue #1598: Make path/branch coverage work with OPcache loaded for PHP 7.3 and later. + - Fixed issue #1620: Division by zero when GC Stats Collection runs with memory manager disabled. + + + + 2018-09-20 + + + 2.7.0beta1 + 2.7.0beta1 + + + beta + beta + + BSD style + +Thu, Sep 20, 2018 - xdebug 2.7.0beta1 + ++ Improvements: + + - Fixed issue #1519: PHP 7.3 support + + + + 2018-04-01 + + + 2.7.0alpha1 + 2.7.0alpha1 + + + beta + beta + + BSD style + +Sun, Apr 1, 2018 - xdebug 2.7.0alpha1 + += Improvements: + + - Fixed issue #938: Support remote debugging for PHP scripts that fork. (Sponsored by Brad Wilson) + - Fixed issue #1487: Re-enable IPv6 test on Travis. + += Fixed bugs: + + - Fixed issue #1526: Namespace filter does equality match instead of prefix match. + - Fixed issue #1532: SIGABRT when using remote debugging and an error is thrown in eval(). + - Fixed issue #1543: Various memory leaks due to changes in (internal) string handling. + + + + 2018-08-01 + + + 2.6.1 + 2.6.1 + + + stable + stable + + BSD style + +Wed, Aug 1, 2018 - xdebug 2.6.1 + += Fixed bugs: + + - Fixed issue #1525: Namespace filter does equality match instead of prefix match + - Fixed issue #1532: SIGABRT when using remote debugging and an error is thrown in eval() (Philip Hofstetter) + - Fixed issue #1543: Various memory leaks due to changes in (internal) string handling + - Fixed issue #1556: Crash when register_shutdown_function() is called with a function named call_user_func* + - Fixed issue #1557: Remove 'return' in void xdebug_build_fname + - Fixed issue #1568: Can't debug object properties that have numeric keys + ++ Improvements: + + - Fixed issue #1487: Re-enable IPv6 test on Travis + + + + 2018-01-29 + + + 2.6.0 + 2.6.0 + + + stable + stable + + BSD style + +Mon, Jan 29, 2018 - xdebug 2.6.0 + += Fixed bugs: + + - Fixed issue #1522: Remote debugging test failures on s390 (Big Endian). + + + + 2018-01-23 + + + 2.6.0RC2 + 2.6.0RC2 + + + beta + beta + + BSD style + +Tue, Jan 23, 2018 - xdebug 2.6.0RC2 + += Fixed bugs: + + - Fixed issue #1521: xdebug_gc_stats.* missing from 2.6.0RC1 tarball + + + + 2018-01-22 + + + 2.6.0RC1 + 2.6.0RC1 + + + beta + beta + + BSD style + +Mon, Jan 22, 2018 - xdebug 2.6.0RC1 + ++ Added features: + + - Fixed issue #1506: Add garbage collection statistics feature (Benjamin Eberlei). + - Fixed issue #1507: Add functions to access Zend Engine garbage collection metrics (Benjamin Eberlei). + ++ Improvements: + + - Fixed issue #1510: Change switch/case "break intentionally missing" comments to use GCC 7's new "fallthrough" attribute. + - Fixed issue #1511: Detect and use compiler flags through new configure option. + += Fixed bugs: + + - Fixed issue #1335: Debugging with PhpStorm sometimes gives "can not get property". + - Fixed issue #1454: Invalid memory read or segfaults from a __call() method. + - Fixed issue #1508: Code coverage filter not checked in xdebug_common_assign_dim handler. + - Fixed issue #1509: Code coverage missing for case inside switch with PHP 7.2. + - Fixed issue #1512: Xdebug does not properly encode and escape properties with quotes and \0 characters. + - Fixed issue #1514: Variable names with a NULL char are cut off at NULL char. + - Fixed issue #1515: Object property names with a NULL char are cut off at NULL char. + - Fixed issue #1516: Can't fetch variables or object properties which have \0 characters in them. + - Fixed issue #1517: Notifications incorrectly specify the error type in "type_string" instead of "type". + + + + 2017-12-28 + + + 2.6.0beta1 + 2.6.0beta1 + + + beta + beta + + BSD style + +Thu, Dec 28, 2017 - xdebug 2.6.0beta1 + ++ Added features: + + - Fixed issue #1059: Add filter capabilities to tracing, stack traces, and code coverage. + - Fixed issue #1437: Add X-Profile-File-Name header when a profile file has been generated. + ++ Improvements: + + - Fixed issue #1493: Run test suite in AppVeyor for Windows CI. + - Fixed issue #1498: Use new ZEND_EXTENSION API in config.w32 build scripts. (Kalle) + += Fixed bugs: + + - Fixed issue #702: Check whether variables tracing also works with =&. + - Fixed issue #1501: Xdebug var dump tries casting properties. + - Fixed issue #1502: SEND_REF lines are not marked as covered. + + + + 2017-12-02 + + + 2.6.0alpha1 + 2.6.0alpha1 + + + beta + beta + + BSD style + +Sat, Dec 2, 2017 - xdebug 2.6.0alpha1 + ++ Added features: + + - Implemented issue #474: Added "memory" output to profiling files, to find out where memory is allocated. + - Implemented issue #575: Dump super globals contents to error log upon errors, just like when this would happen for stack traces. + - Implemented issue #964: Parse X-Forwarded-For for the first IP address when selecting the remote_connect_back host (Steve Easley). + - Implemented issue #990: Add DBGp: notifications for notices and warnings to be shown in IDEs. + - Implemented issue #1312: Implement extended_properties feature to remote debugging to support names and values with low ASCII values. + - Implemented issue #1323: Added xdebug.filename_format setting to configure the formatting of filenames when tracing. + - Implemented issue #1379: Added support for Unix domain sockets to xdebug.remote_host (Sara Golemon). + - Implemented issue #1380: Added xdebug_is_debugger_active() that returns true when debugger is connected. + - Implemented issue #1391: Added support for earlier stack frames through new argument for xdebug_call_* functions. + - Implemented issue #1420: Handle PHP 7.2's new methods for switch/case + - Implemented issue #1470: Added xdebug.remote_timeout to make connect timeout configurable. + - Implemented issue #1495: Make var_dump() also use the new xdebug.filename_format when formatting filenames. + ++ Improvements: + + - Implemented issue #847: Added support for "%s" specifier for xdebug.trace_output_name. + - Implemented issue #1384: Compile warning on Ubuntu 16.04 with GCC 5.4.x. + - Implemented issue #1401: Improved error message in case the connection breaks. + - Implemented issue #1430: Change DBGp tests to use TEST_PHP_EXECUTABLE instead of hard coded 'php' + - Implemented issue #1484: Use FD_CLOEXEC with debugging sockets to prevent FDs from leaking to forked processes (Chris Wright). + - Improve the foldexpr in xt.vim to fold lines correctly (Donie Leigh). + += Fixed bugs: + + - Fixed issue #1272: property_get doesn't return @attributes for SimpleXMLElement. + - Fixed issue #1305: Property names with quotes can not be fetch while debugging. + - Fixed issue #1431: Fix "use after free" with in add_name_attribute_or_element. + - Fixed issue #1432: Fixed memory leak with xdebug_path_info_dtor. + - Fixed issue #1449: Debugging breaks with array element keys containing low-ASCII variables. + - Fixed issue #1471: Tracing crashes with return_assignments and ternairy operator. + - Fixed issue #1474: Crashes due to variable resolving/reading mechanism not taking care of temporary hash tables correctly (Nikita Popov, Derick). + - Fixed issue #1481: Fixed s390x and ppc64 builds (Remi Collet). + - Fixed issue #1486: Crash on ZEND_SWITCH_LONG / ZEND_SWITCH_STRING with more than 32 cases. + - Fixed issue #1496: Rewrite README.rst to be more clear on how to install and build Xdebug. + +~ Changes: + + - Fixed issue #1411: Use Error (Throwable) instead of fatal error when maximum nesting level is reached. + +- Removed features: + + - Implemented issue #1377: Drop support for PHP 5.5 and 5.6, only PHP 7 is now supported + + + + 2017-06-21 + + + 2.5.5 + 2.5.5 + + + stable + stable + + BSD style + += Fixed bugs: + + - Fixed issue #1439: TYPE_CHECK needs overloading due to smart branches + - Fixed issue #1444: Code Coverage misses a variable in a multi-line function + call + - Fixed issue #1446: Code Coverage misses elseif if it uses an isset with a + property + + + + 2017-05-15 + + + 2.5.4 + 2.5.4 + + + stable + stable + + BSD style + +Mon, May 15, 2017 - xdebug 2.5.4 + += Fixed bugs: + + - Fixed issue #799: Function traces report base class instead of object name + - Fixed issue #1421: Fix set_time_limit hanging on PHP 5.6 when pcntl_exec + does not exist (Frode E. Moe) + - Fixed issue #1429: Code coverage does not cover null coalesce + - Fixed issue #1434: Code coverage segfaults on 32-bit arch + + + + 2017-04-18 + + + 2.5.3 + 2.5.3 + + + stable + stable + + BSD style + +Mon, Apr 18, 2017 - xdebug 2.5.3 + += Fixed bugs: + + - Fixed issue #1421: Xdebug crashes when it is loaded without pcntl being + present + + + + 2017-04-17 + + + 2.5.2 + 2.5.2 + + + stable + stable + + BSD style + +Mon, Apr 17, 2017 - xdebug 2.5.2 + += Fixed bugs: + + - Fixed issue #701: Functions as array indexes show ??? in trace + - Fixed issue #1403: Code coverage does not cover BIND_STATIC + - Fixed issue #1404: Execution time is calculated incorrectly + - Fixed issue #1413: Code coverage mishap with PHP 7.1.3 + - Fixed issue #1414: Missing variable assignment in traces with OPcache + loaded + - Fixed issue #1415: Crash with multiple catch constructs with OPcache loaded + - Fixed issue #1416: Trace files should not include the first result of a + generator if it hasn't started yet + - Fixed issue #1417: Fetching properties of static class contexts fails due + to incorrect fetch mode + - Fixed issue #1419: Summary not written when script ended with + "pcntl_exec()" + + + + 2017-04-17 + + + 2.5.2 + 2.5.2 + + + stable + stable + + BSD style + +Sun, Feb 26, 2017 - xdebug 2.5.1 + += Fixed bugs: + + - Fixed issue #1057: Add xdebug.ini of all settings to package + - Fixed issue #1165: DBGp: step_out skips subsequent function calls + - Fixed issue #1180: Code coverage crashes with non-standard start/stops + - Fixed issue #1278: Xdebug with PHP 7 does not handle prefill-from-oparray + for XDEBUG_CC_UNUSED + - Fixed issue #1300: Xdebug functions are not exposing their signature to + Reflection + - Fixed issue #1313: Arguments to __call() trampoline picked from the wrong + memory location + - Fixed issue #1329: While printing out a stack with and function parameters, + XDebug reads uninitialized zvals or free()d memory + - Fixed issue #1381: Code Coverage misses line due to missing FETCH_DIM_W + overload + - Fixed issue #1385: can not fetch IS_INDIRECT properties + - Fixed issue #1386: Executable code not shown as executed/executable + - Fixed issue #1392: Unable to compile on FreeBSD due to missing struct + definition + - Fixed issue #1394: Code coverage does not cover instanceof (in elseif) + + + + 2016-12-04 + + + 2.5.0 + 2.5.0 + + + stable + stable + + BSD style + +Sun, Dec 4, 2016 - xdebug 2.5.0 + ++ Added features: + + - Implemented issue #1232: add memory delta to HTML traces + - Implemented issue #1365: Allow remote_connect_back to be set through + XDEBUG_CONFIG + += Fixed bugs: + + - Fixed issue #1168: Added defensive check to prevent infinite loop + - Fixed issue #1242: Xdebug on Windows with Eclipse has issues with + breakpoint IDs + - Fixed issue #1343: Wrong values of numerical keys outside 32bit range + - Fixed issue #1357: Function signature using variadics is reported as being + not executed + - Fixed issue #1361: Remote debugging connection issues with Windows (Anatol + Belski) + - Fixed issue #1373: Crash in zend_hash_apply_with_arguments when debugging, + due to unset symbol table + + + + 2016-11-12 + + + 2.5.0RC1 + 2.5.0RC1 + + + stable + stable + + BSD style + +Sat, Nov 12, 2016 - xdebug 2.5.0RC1 + ++ Added features: + + - Implemented issue #998: Added support for IPv6 (Thomas Vanhaniemi) + - Implemented issue #1297: Initial PHP 7.1 support + += Fixed bugs: + + - Fixed issue #1295: Apache crashes (SIGSEGV) when trying to establish + connection when sockfd is large + - Fixed issue #1303: POLLRDHUP is not supported outside of Gnu/Linux + - Fixed issue #1331: Segfault in code coverage + +- Removed features: + + - Support for PHP versions lower than PHP 5.5 has been dropped + + + + 2016-08-02 + + + 2.4.1 + 2.4.1 + + + stable + stable + + BSD style + +Tue, Aug 02, 2016 - xdebug 2.4.1 + += Fixed bugs: + + - Fixed issue #1106: A thrown Exception after a class with __debugInfo gives + 2 errors + - Fixed issue #1241: FAST_CALL/FAST_RET take #2 + - Fixed issue #1246: Path and branch coverage should be initialised per + request, not globally + - Fixed issue #1263: Code coverage segmentation fault with opcache enabled + - Fixed issue #1277: Crash when using a userland function from RSHUTDOWN with + profiling enabled + - Fixed issue #1282: var_dump() of integers > 32 bit is broken on Windows + - Fixed issue #1288: Segfault when uncaught exception message does not + contain " in " + - Fixed issue #1291: Debugclient installation fails on Mac OS X + - Fixed issue #1326: Tracing and generators crashes with PHP 7.x + - Fixed issue #1333: Profiler accesses memory structures after freeing + + + + 2016-01-25 + + + 2.4.0RC4 + 2.4.0RC4 + + + beta + beta + + BSD style + +Mon, Jan 25, 2016 - xdebug 2.4.0RC4 + += Fixed bugs: + + - Fixed issue #1220: Segmentation fault if var_dump() output is too large. + - Fixed issue #1223: Xdebug crashes on PHP 7 when doing a DBGp eval command. + - Fixed issue #1229: Issues with GCC 4.8, which in -O2 move removes some + required code. + - Fixed issue #1235: Xdebug does not compile against PHP 7.1-dev due to + ZEND_FETCH_STATIC_PROP*. + - Fixed issue #1236: Can't remove breakpoints with negative IDs. + - Fixed issue #1238: Xdebug crashes with SIGSEGV while enumerating references + in variables. + - Fixed issue #1239: Crash due to changes with the CATCH opcode's jump + mechanism in 7.1 + - Fixed issue #1241: Xdebug doesn't handle FAST_RET and FAST_CALL opcodes for + branch/dead code analysis, and path coverage. + - Fixed issue #1245: xdebug_dump_superglobals dumps *uninitialized* with PHP + 7. + - Fixed issue #1250: Add PHP version descriptors to debugging log and profile + files. + + + + 2016-03-03 + + + 2.4.0 + 2.4.0 + + + stable + stable + + BSD style + +Thu, Mar 03, 2016 - xdebug 2.4.0 + += Fixed bugs: + + - Fixed issue #1258: Case in PHP 7.0 and code coverage + - Fixed issue #1261: segmentation fault in xdebug.so with PHP 7.0 version of + 'pkgtools' due to spl_autoload() + - Fixed issue #1262: overload_var_dump=0 messes with xdebug_var_dump() + - Fixed issue #1266: xdebug_dump_superglobals() always dumps empty stack on + PHP 7 + - Fixed issue #1267: AIX build issues + - Fixed issue #1270: String parsing marked not covered with PHP 7 + + + + 2015-12-12 + + + 2.4.0RC3 + 2.4.0RC3 + + + beta + beta + + BSD style + +Wed, Dec 12, 2015 - xdebug 2.4.0RC3 + += Fixed bugs: + + - Fixed issue #1221: Sort out Windows x64 PHP 7 support + - Fixed issue #1229: Detect GCC 4.8 and disable optimisations when it is found + += Others: + + - Made the test suite work for Windows too. Finally, after 13 years. + + + + 2015-12-02 + + + 2.4.0RC2 + 2.4.0RC2 + + + beta + beta + + BSD style + +Wed, Dec 02, 2015 - xdebug 2.4.0RC2 + += Fixed bugs: + + - Fixed issue #1181: Remote debugging does not handle exceptions after using + zend_read_property + - Fixed issue #1189: Remove address attribute from remote debugging responses + - Fixed issue #1194: The error message is doubly HTML-encoded with assert() + - Fixed issue #1210: Segfault with code coverage dead code analysis and + foreach on PHP 7 + - Fixed issue #1215: SIGSEGV if xdebug.trace_output_dir directory does not + exist + - Fixed issue #1217: xdebug.show_error_trace should not be enabled by default + - Fixed issue #1218: Xdebug messes with the exception code, by casting it to + int + - Fixed issue #1219: Set default value for xdebug.overload_var_dump to 2 to + include file / line numbers by default + - Use long for PHP 5, and zend_long for PHP 7 for ini settings in the globals + + + + 2015-11-21 + + + 2.4.0RC1 + 2.4.0RC1 + + + beta + beta + + BSD style + +Sat, Nov 21, 2015 - xdebug 2.4.0RC1 + += Fixed bugs: + + - Fixed issue #1195: Segfault with code coverage and foreach + - Fixed issue #1200: Additional opcodes need to be overloaded for PHP 7 + - Fixed issue #1202: Anonymous classes are not handled properly while remote debugging + - Fixed issue #1203: Accessing static property of a class that has no static properties crashes while remote debugging + - Fixed issue #1209: Segfault with building a function name for create_function + - Restored Windows support (Includes patches by Jan Ehrhardt) + + + + 2015-11-05 + + + 2.4.0beta1 + 2.4.0beta1 + + + beta + beta + + BSD style + +Thu, Sep 05, 2015 - xdebug 2.4.0beta1 + ++ Added features: + + - Implemented issue #1109: Added support for PHP 7. + - Implemented issue #1153: Add function monitor functionality. + - Implemented issue #1183: Add xdebug.show_error_trace setting to + allow/disallow to show a stack trace for every Error (throwable) + += Fixed bugs: + + - Fixed issue #1070: Too many open files error with php-fpm: connections not + closed. (Patch by Sean Dubois) + - Fixed issue #1123: With Xdebug 2.3.1, PHPUnit with coverage is + exponentially slower than without + - Fixed issue #1166: Using $this in __debugInfo() causes infinite recursion + - Fixed issue #1173: Segmentation fault in xdebug_get_monitored_functions() + - Fixed issue #1182: Using PHPStorm with PHP 7 RC1 and xdebug 2.4-dev break + points are passed by including setting break point at start of script + - Fixed issue #1192: Dead code analysis does not work for generators with + 'return;' + + + + 2015-06-19 + + + 2.3.3 + 2.3.3 + + + stable + stable + + BSD style + +Fri, Jun 19, 2015 - xdebug 2.3.3 + += Fixed bugs: + + - Fixed issue #1130: Escaping issues with docrefs and HTML characters in + error messages + - Fixed issue #1133: PDO exception code value type is changed + - Fixed issue #1137: Windows does not support %zu formatting for sprintf + - Fixed issue #1140: Tracing with __debugInfo() crashes Xdebug due to a stack + overflow + - Fixed issue #1148: Can't disable max_nesting_function + - Fixed issue #1151: Crash when another extension calls call_user_function() + during RINIT + + - Fixed crash with code coverage (Antony Dovgal) + - Fixed usage of virtual_file_ex and STR_FREE (Remi Collet) + - Reset overloaded opcodes at the end of each request (Eran Ifrah) + += Improvements: + + - Fixed issue #686: Not possible to inspect SplObjectStorage instances with + Xdebug + - Fixed issue #864: No attributes are shown if an object extends + ArrayIterator + - Fixed issue #996: Can't evaluate property of class that extends ArrayObject + - Fixed issue #1134: Allow introspection of ArrayObject implementation's + internal storage + - Get rid of setlocale hack, by using %F instead of %f (and speed up tracing + by 15-20%) + + + + 2015-03-22 + + + 2.3.2 + 2.3.2 + + + stable + stable + + BSD style + +Sun, Mar 22, 2015 - xdebug 2.3.2 + += Fixed bugs: + + - Fixed issue #1117: Path/branch coverage sometimes crashes + - Fixed issue #1121: Segfaults with path/branch coverage + + + + 2015-02-24 + + + 2.3.1 + 2.3.1 + + + stable + stable + + BSD style + +Tue, Feb 24, 2015 - xdebug 2.3.1 + += Fixed bugs: + + - Fixed issue #1112: Setting an invalid xdebug.trace_format causes Xdebug to + crash + - Fixed issue #1113: xdebug.*_trigger do no longer work, due to NULL not + being an empty string + + + + 2015-02-22 + + + 2.3.0 + 2.3.0 + + + stable + stable + + BSD style + +Sun, Feb 22, 2015 - xdebug 2.3.0 + += Fixed bugs: + + - Fixed bug #932: Added an error message in case the remote debug log + couldn't be opened + - Fixed bug #982: Incorrect file paths in exception stack trace + - Fixed bug #1094: Segmentation fault when attempting to use branch/path + coverage + - Fixed bug #1101: Debugger is not triggered on xdebug_break() in JIT mode + - Fixed bug #1102: Stop Xdebug from crashing when debugging PHP Code with + "php -r". + - Fixed bug #1103: XDEBUG_SESSION_STOP_NO_EXEC only stops first script + executed with auto_prepend|append_files + - Fixed bug #1104: One character non-public properties cause issues with + debugging + - Fixed bug #1105: Setting properties without specifying a type only works in + topmost frame (Dominik del Bondio) + - Fixed bug #1095: Crash when using a non-associate array key in GLOBALS + - Fixed bug #1111: eval does not work when debugger is stopped in + xdebug_throw_exception_hook (Dominik del Bondio) + ++ Added features: + + - General + + - Implemented issue #304: File name and line number info for overloaded + var_dump() + - Implemented issue #310: Allow class vars and array keys with + xdebug_debug_zval() + - Implemented issue #722: Add stack trace limit setting. + - Implemented issue #1003: Add option to xdebug_print_function_stack() to + suppress filename and line number + - Implemented issue #1004: Ability to halt on warning/notice + - Implemented issue #1023: Add support for PHP 5.6 variadics + - Implemented issue #1024: Add support for PHP 5.6's ASSIGN_POW + + - Debugging + + - Implemented issue #406: Added support for remote debugging user-defined + constants + - Implemented issue #495: Added support for the wildcard exception name '*' + - Implemented issue #1066: Better error message for SELinux preventing + debugging connections + - Implemented issue #1084: Added support for extended classes to trigger + exception breakpoints + - Implemented issue #1084: Added exception code as extra element to + debugger XML + + - Tracing + + - Implemented issue #341: Added the time index and memory usage for + function returns in normal tracefiles + - Implemented issue #644: Shared secret for profiler_enable_trigger and + trace_enable_trigger with *_value option + - Implemented issue #971: Added the trace file option + "XDEBUG_TRACE_NAKED_FILENAME" to xdebug_start_trace() to prevent the + ".xt" extension from being added + - Implemented issue #1021: Added support for return values to computerized + trace files + - Implemented issue #1022: Added support for serialized variables as format + in trace files in the form of option "5" for "xdebug.collect_params" + + - Code coverage + + - Implemented issue #380: Added xdebug_code_coverage_started() + - Implemented issue #1034: Add collected path and branch information to + xdebug_get_code_coverage() output + + - Profiling + + - Implement issue #1054: Support for filename and function name compression + in cachegrind files + ++ Changes: + + - Implemented issue #863: Support xdebug.overload_var_dump through + ini_set() + - Implemented issue #973: Use case-insensitive filename comparison on all + systems (Galen Wright-Watson) + - Implemented issue #1015: Added the xdebug.force_display_errors and + xdebug.force_error_reporting php.ini-only settings to always override + PHP's settings for display_errors and error_reporting + - Implemented issue #1057: Removed trailing whitespace from example + xdebug.ini + - Implemented issue #1096: Improve performance improvement for handling + breakpoints by ignoring locales (Daniel Sloof) + - Implemented issue #1100: Raise default max_nesting_level to 256 + +- Removed features: + + - Support for PHP versions lower than PHP 5.4 have been dropped. + + + + 2015-01-21 + + + 2.2.7 + 2.2.7 + + + stable + stable + + BSD style + +Thu, Jan 22, 2014 - xdebug 2.2.7 + += Fixed bugs: + + - Fixed bug #1083: Segfault when requesting a variable for a context that did + not have them. + - Fixed bug #1087: zend_execute_script or zend_eval_string in RINIT segfaults. + - Fixed bug #1088: Xdebug won't show dead and not executed lines at the second + time. + - Fixed bug #1098: Xdebug doesn't make use of __debugInfo. + - Fixed segfaults with ZTS on PHP 5.6. + + + + 2014-11-14 + + + 2.2.6 + 2.2.6 + + + stable + stable + + BSD style + +Fri, Nov 14, 2014 - xdebug 2.2.6 + += Fixed bugs: + + - Fixed bug #1048: Can not get $GLOBAL variable by property_value on function + context. + - Fixed bug #1073 and #1075: Segmentation fault with internal functions + calling internal functions. + - Fixed bug #1085: Fixed the tracefile analyser as the format version had been + bumbed. + - Fixed memory leaks + + + + 2014-04-29 + + + 2.2.5 + 2.2.5 + + + stable + stable + + BSD style + +Tue, Apr 29, 2014 - xdebug 2.2.5 + += Fixed bugs: + + - Fixed bug #1040: Fixed uninitialized sa value. + - Fixed building on hurd-i386. + + + + 2014-02-28 + + + 2.2.4 + 2.2.4 + + + stable + stable + + BSD style + +Fri, Feb 28, 2014 - xdebug 2.2.4 + += Fixed bugs: + + - Fixed bug #785: Profiler does not handle closures and call_user_func_array well. + - Fixed bug #963: Xdebug waits too long for response from remote client + - Fixed bug #976: XDebug crashes if current varibles scope contains COM object. + - Fixed bug #978: Inspection of array with negative keys fails + - Fixed bug #979: property_value -m 0 should mean all bytes, not 0 bytes + - Fixed bug #987: Hidden property names not shown. + + + + 2013-05-22 + + + 2.2.3 + 2.2.3 + + + stable + stable + + BSD style + +Tue, May 21, 2013 - xdebug 2.2.3 + ++ Added features: + + - Support for PHP 5.5. + += Fixed bugs: + + - Fixed bug #923: Xdebug + Netbeans + ext/MongoDB crash on MongoCursor instance + - Fixed bug #929: Directory name management in xdebug.profiler_output_dir + - Fixed bug #931: xdebug_str_add does not check for NULL str before calling strlen on it + - Fixed bug #935: Document the return value from xdebug_get_code_coverage() + - Fixed bug #947: Newlines converted when html_errors = 0 + + + + 2013-03-23 + + + 2.2.2 + 2.2.2 + + + stable + stable + + BSD style + +Sat, Mar 23, 2013 - xdebug 2.2.2 + ++ Added features: + + - Support for PHP 5.5. + += Fixed bugs: + + - Fixed bug #598: Use HTTP_X_FORWARDED_FOR to determine remote debugger. + - Fixed bug #625: xdebug_get_headers() -> Headers are reset unexpectedly. + - Fixed bug #811: PHP Documentation Link. + - Fixed bug #818: Require a php script in the PHP_RINIT causes Xdebug to crash. + - Fixed bug #903: xdebug_get_headers() returns replaced headers. + - Fixed bug #905: Support PHP 5.5 and generators. + - Fixed bug #920: AM_CONFIG_HEADER is depreciated. + + + + + 2.2.1 + 2.2.1 + + + stable + stable + + 2012-07-14 + BSD style + += Fixed bugs: + + - Fixed bug #843: Text output depends on php locale. + - Fixed bug #838/#839/#840: Debugging static properties crashes Xdebug. + - Fixed bug #821: Variable assignments (beginning with =>) should be + indented one more scope. + - Fixed bug #811: PHP Documentation Link. + - Fixed bug #800: var_dump(get_class(new foo\bar')) add an extra "\" in + class name. + + + + + 2.2.0 + 2.2.0 + + + stable + stable + + 2012-05-08 + BSD style + +Tue, May 08, 2012 - xdebug 2.2.0 + ++ Added features: + + - Support for PHP 5.4. + + - Added ANSI colour output for the shell. (Including patches by Michael + Maclean) + - Added var_dump() overloading on the command line (issue #457). + + - Added better support for closures in stack and function traces. + - Added the size of arrays to the overloaded variable output, so that you + know how many elements there are. + - Added support for X-HTTP-FORWARDED-FOR before falling back to REMOTE_ADDR + (issue #660). (Patch by Hannes Magnusson) + - Added the method call type to xdebug_get_function_stack() (issue #695). + - Added extra information to error printouts to tell that the error + suppression operator has been ignored due to xdebug.scream. + - Added a error-specific CSS class to stack traces. + ++ New settings: + + - xdebug.cli_color for colouring output on the command line (Unix only). + - Added xdebug.trace_enable_trigger to triger function traces through a + GET/POST/COOKIE parameter (issue #517). (Patch by Patrick Allaert) + - Added support for the 'U' format specifier for function trace and + profiler filenames. + ++ Changes: + + - Improved performance by lazy-initializing data structures. + - Improved code coverage performance. (Including some patches by Taavi + Burns) + - Improved compatibility with KCacheGrind. + - Improved logging of remote debugging connections, by added connection + success/failure logging to the xdebug.remote_log functionality. + += Fixed bugs: + + - Fixed bug #827: Enabling Xdebug causes phpt tests to fail because of + var_dump() formatting issues. + - Fixed bug #823: Single quotes are escaped in var_dumped string output. + - Fixed issue #819: Xdebug 2.2.0RC2 can't stand on a breakpoint more than 30 seconds. + - Fixed bug #801: Segfault with streamwrapper and unclosed $fp on + destruction. + - Fixed issue #797: Xdebug crashes when fetching static properties. + - Fixed bug #794: Allow coloured output on Windows. + - Fixed bug #784: Unlimited feature for var_display_max_data and + var_display_max_depth is undocumented. + - Fixed bug #774: Apache crashes on header() calls. + - Fixed bug #764: Tailored Installation instructions do not work. + - Fixed bug #758: php_value xdebug.idekey is ignored in .htaccess files + - Fixed bug #728: Profiler reports __call() invocations confusingly/wrongly. + - Fixed bug #687: Xdebug does not show dynamically defined variable. + - Fixed bug #662: idekey is set to running user. + - Fixed bug #627: Added the realpath check. + + + + + 2.2.0RC2 + 2.2.0RC2 + + + stable + stable + + 2012-04-22 + BSD style + +Tue, Apr 22, 2012 - xdebug 2.2.0rc2 + += Fixed bugs: + + - Fixed bug #801: Segfault with streamwrapper and unclosed $fp on + destruction. + - Fixed bug #794: Allow coloured output on Windows. + - Fixed bug #784: Unlimited feature for var_display_max_data and + var_display_max_depth is undocumented. + - Fixed bug #774: Apache crashes on header() calls. + - Fixed bug #764: Tailored Installation instructions do not work. + - Fixed bug #758: php_value xdebug.idekey is ignored in .htaccess files + - Fixed bug #662: idekey is set to running user. + + + + + 2.2.0RC1 + 2.2.0RC1 + + + stable + stable + + 2012-03-12 + BSD style + +Tue, Mar 13, 2012 - xdebug 2.2.0rc1 + ++ Added features: + + - Support for PHP 5.4. + + - Added ANSI colour output for the shell. (Including patches by Michael + Maclean) + - Added var_dump() overloading on the command line (issue #457). + + - Added better support for closures in stack and function traces. + - Added the size of arrays to the overloaded variable output, so that you + know how many elements there are. + - Added support for X-HTTP-FORWARDED-FOR before falling back to REMOTE_ADDR + (issue #660). (Patch by Hannes Magnusson) + - Added the method call type to xdebug_get_function_stack() (issue #695). + - Added extra information to error printouts to tell that the error + suppression operator has been ignored due to xdebug.scream. + - Added a error-specific CSS class to stack traces. + + ++ New settings: + + - xdebug.cli_color for colouring output on the command line (Unix only). + - Added xdebug.trace_enable_trigger to triger function traces through a + GET/POST/COOKIE parameter (issue #517). (Patch by Patrick Allaert) + - Added support for the 'U' format specifier for function trace and + profiler filenames. + ++ Changes: + + - Improved performance by lazy-initializing data structures. + - Improved code coverage performance. (Including some patches by Taavi + Burns) + - Improved compatibility with KCacheGrind. + - Improved logging of remote debugging connections, by added connection + success/failure logging to the xdebug.remote_log functionality. + += Fixed bugs: + + - No additional bug fixes besides the ones from the 2.1 branch up til + Xdebug 2.1.4. + + + + + 2.1.4 + 2.1.4 + + + stable + stable + + 2012-03-12 + BSD style + += Fixed bugs: + + - Fixed bug #788: Collect errors eats fatal errors. + - Fixed bug #787: Segmentation Fault with PHP header_remove(). + - Fixed bug #778: Xdebug session in Eclipse crash whenever it run into + simplexml_load_string call. + - Fixed bug #756: Added support for ZEND_*_*_OBJ and self::*. + - Fixed bug #747: Still problem with error message and soap client / soap + server. + - Fixed bug #744: new lines in a PHP file from Windows are displayed with + an extra white line with var_dump(). + - Fixed an issue with debugging and the eval command. + - Fixed compilation with ZTS on PHP < 5.3 + + + + + 2.1.3 + 2.1.3 + + + stable + stable + + 2012-01-25 + BSD style + += Fixed bugs: + + - Fixed bug #725: EG(current_execute_data) is not checked in xdebug.c, + xdebug_statement_call. + - Fixed bug #723: xdebug is stricter than PHP regarding Exception property + types. + - Fixed bug #714: Cachegrind files have huge (wrong) numbers in some lines. + - Fixed bug #709: Xdebug doesn't understand E_USER_DEPRECATED. + - Fixed bug #698: Allow xdebug.remote_connect_back to be set in .htaccess. + - Fixed bug #690: Function traces are not appended to file with + xdebug_start_trace() and xdebug.trace_options=1. + - Fixed bug #623: Static properties of a class can be evaluated only with + difficulty. + - Fixed bug #614/#619: Viewing private variables in base classes through + the debugger. + - Fixed bug #609: Xdebug and SOAP extension's error handlers conflict. + - Fixed bug #606/#678/#688/#689/#704: crash after using eval on an + unparsable, or un-executable statement. + - Fixed bug #305: xdebug exception handler doesn't properly handle special + chars. + ++ Changes: + + - Changed xdebug_break() to hint to the statement execution trap instead of + breaking forcefully adding an extra stackframe. + - Prevent Xdebug 2.1.x to build with PHP 5.4. + + + + + 2.1.2 + 2.1.2 + + + stable + stable + + 2011-07-28 + BSD style + += Fixed bugs: + + - Fixed bug #622: Working with eval() code is inconvenient and difficult. + - Fixed bug #684: xdebug_var_dump - IE does not support &. + - Fixed bug #693: Cachegrind files not written when filename is very long. + - Fixed bug #697: Incorrect code coverage of function arguments when using + XDEBUG_CC_UNUSED. + - Fixed bug #699: Xdebug gets the filename wrong for the countable + interface. + - Fixed bug #703 by adding another opcode to the list that needs to be + overridden. + + + + + 2.1.2 + 2.1.2 + + + stable + stable + + 2011-07-28 + BSD style + += Fixed bugs: + + - Fixed bug #622: Working with eval() code is inconvenient and difficult. + - Fixed bug #684: xdebug_var_dump - IE does not support &. + - Fixed bug #693: Cachegrind files not written when filename is very long. + - Fixed bug #697: Incorrect code coverage of function arguments when using + XDEBUG_CC_UNUSED. + - Fixed bug #699: Xdebug gets the filename wrong for the countable + interface. + - Fixed bug #703 by adding another opcode to the list that needs to be + overridden. + + + + + 2.1.1 + 2.1.1 + + + stable + stable + + 2011-03-28 + BSD style + +Mon, Mar 28, 2011 - xdebug 2.1.1 + += Fixed bugs: + + - Fixed ZTS compilation. + + + + + 2.1.1RC1 + 2.1.1RC1 + + + beta + beta + + 2011-03-22 + BSD style + +Tue, Mar 22, 2011 - xdebug 2.1.1rc1 + += Fixed bugs: + + = Debugger + - Fixed bug #518: Removed CLASSNAME pseudo-property optional. + - Fixed bug #592: Xdebug crashes with run after detach. + - Fixed bug #596: Call breakpoint never works with instance methods, only + static methods. + - Fixed JIT mode in the debugger so that it works for xdebug_break() too. + + = Profiler + - Fixed bug #631: Summary not written when script ended with "exit()". + - Fixed bug #639: Xdebug profiling: output not correct - missing 'cfl='. + - Fixed bug #642: Fixed line numbers for offsetGet, offsetSet, + __get/__set/__isset/__unset and __call in profile files and stack + traces/function traces. + - Fixed bug #643: Profiler gets line numbers wrong. + - Fixed bug #653: XDebug profiler crashes with %H in file name and non + standard port. + + = Others + - Fixed bug #651: Incorrect code coverage after empty() in conditional. + - Fixed bug #654: Xdebug hides error message in CLI. + - Fixed bug #665: Xdebug does not respect display_errors=stderr. + Patch by Ben Spencer <dangerous.ben@gmail.com> + - Fixed bug #670: Xdebug crashes with broken "break x" code. + + + + + 2.1.0 + 2.1.0 + + + stable + stable + + 2010-06-29 + BSD style + +Tue, Jun 29, 2010 - xdebug 2.1.0 + += Fixed bugs: + - Fixed bug #562: Incorrect coverage information for closure function + headers. + - Fixed bug #566: Xdebug crashes when using conditional breakpoints. + - Fixed bug #567: xdebug_debug_zval and xdebug_debug_zval_stdout don't work + with PHP 5.3. (Patch by Endo Hiroaki). + - Fixed bug #570: undefined symbol: zend_memrchr. + + + + + 2.1.0RC1 + 2.1.0RC1 + + + beta + beta + + 2010-02-27 + BSD style + +Thu, Apr 06, 2010 - xdebug 2.1.0rc1 + += Fixed bugs: + - Fixed bug #494: Private attributes of parent class unavailable when + inheriting. + - Fixed bug #400: Xdebug shows errors, even when PHP is request startup + mode. + - Fixed bug #421: xdebug sends back invalid characters in xml sometimes. + - Fixed bug #475: Property names with null chars are not sent fully to the + client. + - Fixed bug #480: Issues with the reserved resource in multi threaded + environments (Patch by Francis.Grolemund@netapp.com). + - Fixed bug #558: PHP segfaults when running a nested eval. + + + + + 2.1.0beta3 + 2.1.0beta3 + + + beta + beta + + 2010-02-27 + BSD style + +Sat, Feb 27, 2010 - xdebug 2.1.0beta3 + += Fixed bugs: + - Fixed memory corruption issues. + - Fixed a threading related issue for code-coverage. + - Fixed bug #532: XDebug breaks header() function. + - DBGP: Prevent Xdebug from returning properties when a too high page number + has been requested. + + + + + 2.1.0beta2 + 2.1.0beta2 + + + beta + beta + + 2010-02-03 + BSD style + +Wed, Feb 03, 2010 - xdebug 2.1.0beta2 + += Fixed bugs: + - Fixed memory leak in breakpoint handling. + - Fixed bug #528: Core dump generated with remote_connect_back option set + and CLI usage. + - Fixed bug #515: declare(ticks) statement confuses code coverage. + - Fixed bug #512: DBGP: breakpoint_get doesn't return conditions in its + response. + - Possible fix for bug #507/#517: Crashes because of uninitalised header + globals. + - Fixed bug #501: Xdebug's variable tracing misses POST_INC and variants. + + + + + 2.1.0beta1 + 2.1.0beta1 + + + beta + beta + + 2010-01-03 + BSD style + +Sun, Jan 03, 2010 - xdebug 2.1.0beta1 + ++ Added features: + - Added error display collection and suppressions. + - Added the recording of headers being set in scripts. + - Added variable assignment tracing. + - Added the ability to turn of the default overriding of var_dump(). + - Added "Scream" support, which disables the @ operator. + - Added a trace-file analysing script. + - Added support for debugging into phars. + - Added a default xdebug.ini. (Patch by Martin Schuhfu + <martins@spot-media.de>) + - Added function parameters in computerized function traces. + - PHP 5.3 compatibility. + - Improved code coverage accuracy. + + + New functions: + - xdebug_get_formatted_function_stack(), which returns a formatted function + stack instead of displaying it. + - xdebug_get_headers(), which returns all headers that have been set in a + script, both explicitly with things like header(), but also implicitly + for things like setcookie(). + - xdebug_start_error_collection(), xdebug_stop_error_collection() and + xdebug_get_collected_errors(), which allow you to collect all notices, + warnings and error messages that Xdebug generates from PHP's + error_reporting functionality so that you can output them at a later + point in your script by hand. + + + New settings: + - xdebug.collect_assignments, which enables the emitting of variable + assignments in function traces. + - xdebug.file_line_format, to generate a link with a specific format for + every filename that Xdebug outputs. + - xdebug.overload_var_dump, which allows you to turn off Xdebug's version + of var_dump(). + - xdebug.remote_cookie_expire_time, that controls the length of a + remote debugging session. (Patch by Rick Pannen <pannen@gmail.com>) + - xdebug.scream, which makes the @ operator to be ignored. + ++ Changes: + - Added return values for xdebug_start_code_coverage() and + xdebug_stop_code_coverage() to indicate whether the action was + successful. xdebug_start_code_coverage() will return TRUE if the call + enabled code coverage, and FALSE if it was already enabled. + xdebug_stop_code_coverage() will return FALSE when code coverage wasn't + started yet and TRUE if it was turned on. + - Added an optional argument to xdebug_print_function_stack() to display + your own message. (Patch by Mikko Koppanen). + - All HTML output as generated by Xdebug now has a HTML "class" attribute + for easy CSS formatting. + +- Removed features: + - Support for PHP versions lower than PHP 5.1 have been dropped. + - The PHP3 and GDB debugger engines have been removed. + += Fixed bugs: + - Fixed support for showing $this in remote debugging sessions. + - Fixed bug in formatting the display of "Variables in the local scope". + - Possible fix for a threading issue where the headers gathering function + would create stack overflows. + - Possible fix for #324: xdebug_dump_superglobals() only dumps superglobals + that were accessed before, and #478: XDebug 2.0.x can't use %R in + xdebug.profiler_output_name if register_long_arrays is off. + + - Fixed bug #505: %s in xdebug.trace_output_name breaks functions traces. + - Fixed bug #494: Private attributes of parent class unavailable when + inheriting. + - Fixed bug #486: feature_get -n breakpoint_types returns out of date list. + - Fixed bug #476: Xdebug doesn't support PHP 5.3's exception chaining. + - Fixed bug #472: Dead Code Analysis for code coverage messed up after goto. + - Fixed bug #470: Catch blocks marked as dead code unless executed. + - Fixed bug #469: context_get for function variables always appear as + "uninitialized". + - Fixed bug #468: Property_get on $GLOBALS works only at top-level, by + adding GLOBALS to the super globals context. + - Fixed bug #453: Memory leaks. + - Fixed bug #445: error_prepend_string and error_append_string are ignored + by xdebug_error_cb. (Patch by Kent Davidson <kent@marketruler.com>) + - Fixed bug #442: configure: error: "you have strange libedit". + - Fixed bug #439: Xdebug crash in xdebug_header_handler. + - Fixed bug #423: Conflicts with funcall. + - Fixed bug #419: Make use of P_tmpdir if defined instead of hard coded + '/tmp'. + - Fixed bug #417: Response of context_get may lack page and pagesize + attributes. + - Fixed bug #411: Class/function breakpoint setting does not follow the + specs. + - Fixed bug #393: eval returns array data at the previous page request. + - Fixed bug #391: Xdebug doesn't stop executing script on catchable fatal + errors. + - Fixed bug #389: Destructors called on fatal error. + - Fixed bug #368: Xdebug's debugger bails out on a parse error with the + eval command. + - Fixed bug #356: Temporary breakpoints persist. + - Fixed bug #355: Function numbers in trace files weren't unique. + - Fixed bug #340: Segfault while throwing an Exception. + - Fixed bug #328: Private properties are incorrectly enumerated in case of + extended classes. + - Fixed bug #249: Xdebug's error handler messes up with the SOAP + extension's error handler. + ++ DBGP: + - Fixed cases where private properties where shown for objects, but not + accessible. + - Added a patch by Lucas Nealan (lucas@php.net) and Brian Shire + (shire@php.net) of Facebook to allow connections to the initiating + request's IP address for remote debugging. + - Added the -p argument to the eval command as well, pending inclusion into + DBGP. + - Added the retrieval of a file's execution lines. I added a new + un-official method called xcmd_get_executable_lines which requires the + stack depth as argument (-d). You can only fetch this information for + stack frames as it needs an available op-array which is only available + when a function is executed. + - Added a fake "CLASSNAME" property to objects that are returned in debug + requests to facilitate deficiencies in IDEs that fail to show the "classname" + XML attribute. + + + + + 2.0.5 + 2.0.5 + + + stable + stable + + 2009-07-03 + BSD style + +Fri, Jul 03, 2009 - xdebug 2.0.5 + += Fixed bugs: + - Fixed bug #425: memory leak (around 40MB for each request) when using + xdebug_start_trace. + - Fixed bug #422: Segfaults when using code coverage with a parse error in + the script. + - Fixed bug #418: compilation breaks with CodeWarrior for NetWare. + - Fixed bug #403: 'call' and 'return' breakpoints triggers both on call and + return for class method breakpoints. + - Fixed TSRM issues for PHP 5.2 and PHP 5.3. (Original patch by Elizabeth + M. Smith). + - Fixed odd crash bugs, due to GCC 4 sensitivity. + + + + + 2.0.4 + 2.0.4 + + + stable + stable + + 2008-12-30 + BSD style + +Tue, Dec 30, 2008 - xdebug 2.0.4 + += Fixed bugs: + - Fixed for strange jump positions in path analysis. + - Fixed issues with code coverage crashing on parse errors. + - Fixed code code coverage by overriding more opcodes. + - Fixed issues with Xdebug stalling/crashing when detaching from remote + debugging. + - Fixed crash on Vista where memory was freed with routines from a different + standard-C library than it was allocated with. (Patch by Eric Promislow + <ericp@activestate.com>). + - Link against the correct CRT library. (Patch by Eric Promislow + <ericp@activestate.com>). + - Sort the symbol elements according to name. (Patch by Eric Promislow + <ericp@activestate.com>). + - Fixed support for mapped-drive UNC paths for Windows. (Patch by Eric + Promislow <ericp@activestate.com>). + - Fixed a segfault in interactive mode while including a file. + - Fixed a crash in super global dumping in case somebody was strange enough + to reassign them to a value type other than an Array. + - Simplify version checking for libtool. (Patch by PGNet + <pgnet.trash@gmail.com>). + - Fixed display of unused returned variables from functions in PHP 5.3. + - Include config.w32 in the packages as well. + - Fixed .dsp for building with PHP 4. + ++ Added features: + - Support debugging into phars. + - Basic PHP 5.3 support. + + + + + 2.0.3 + 2.0.3 + + + stable + stable + + 2008-04-09 + BSD style + +Wed, Apr 09, 2008 - xdebug 2.0.3 + += Fixed bugs: + - Fixed bug #338: Crash with: xdebug.remote_handler=req. + - Fixed bug #334: Code Coverage Regressions. + - Fixed abstract method detection for PHP 5.3. + - Fixed code coverage dead-code detection. + - Ignore ZEND_ADD_INTERFACE, which is on a different line in PHP >= 5.3 for + some weird reason. + ++ Changes: + - Added a CSS-class for xdebug's var_dump(). + - Added support for the new E_DEPRECATED. + + + + + 2.0.2 + 2.0.2 + + + stable + stable + + 2007-11-11 + BSD style + +Sun, Nov 11, 2007 - xdebug 2.0.2 + += Fixed bugs: + - Fixed bug #325: DBGP: "detach" stops further sessions being established + from Apache. + - Fixed bug #321: Code coverage crashes on empty PHP files. + - Fixed bug #318: Segmentation Fault in code coverage analysis. + - Fixed bug #315: Xdebug crashes when including a file that doesn't exist. + - Fixed bug #314: PHP CLI Error Logging thwarted when XDebug Loaded. + - Fixed bug #300: Direction of var_dump(). + - Always set the transaction_id and command. (Related to bug #313). + + + + + 2.0.1 + 2.0.1 + + + stable + stable + + 2007-10-29 + BSD style + +Sat, Oct 20, 2007 - xdebug 2.0.1 + ++ Changes: + - Improved code coverage performance dramatically. + - PHP 5.3 compatibility (no namespaces yet though). + += Fixed bugs: + - Fixed bug #301: Loading would cause SIGBUS on Solaris 10 SPARC. (Patch by + Sean Chalmers) + - Fixed bug #300: Xdebug does not force LTR rendering for its tables. + - Fixed bug #299: Computerized traces don't have a newline for return + entries if memory limit is not enabled. + - Fixed bug #298: xdebug_var_dump() doesn't handle entity replacements + correctly concerning string length. + - Fixed a memory free error related to remote debugging conditions. + (Related to bug #297). + + + + + 2.0.0 + 2.0.0 + + + stable + stable + + 2007-07-18 + BSD style + +Wed, Jul 18, 2007 - xdebug 2.0.0 + ++ Changes: + - Put back the disabling of stack traces - apperently people were relying + on this. This brings back xdebug_enable(), xdebug_disable() and + xdebug_is_enabled(). + - xdebug.collect_params is no longer a boolean setting. Although it worked + fine, phpinfo() showed only just On or Off here. + - Fixed the Xdebug version of raw_url_encode to not encode : and \. This is + not necessary according to the RFCs and it makes debug breakpoints work + on Windows. + += Fixed bugs: + - Fixed bug #291: Tests that use SPL do not skip when SPL is not available. + - Fixed bug #290: Function calls leak memory. + - Fixed bug #289: Xdebug terminates connection when eval() is run in the + init stage. + - Fixed bug #284: Step_over on breakpointed line made Xdebug break twice. + - Fixed bug #283: Xdebug always returns $this with the value of last stack + frame. + - Fixed bug #282: %s is not usable for xdebug.profiler_output_name on + Windows in all stack frames. + - Fixed bug #280: var_dump() doesn't display key of array as expected. + - Fixed bug #278: Code Coverage Issue. + - Fixed bug #273: Remote debugging: context_get does not return context id. + - Fixed bug #270: Debugger aborts when PHP's eval() is encountered. + - Fixed bug #265: XDebug breaks error_get_last() . + - Fixed bug #261: Code coverage issues by overloading zend_assign_dim. + ++ DBGP: + - Added support for "breakpoint_languages". + + + + + 2.0.0RC4 + 2.0.0RC4 + + + beta + beta + + 2007-05-17 + BSD style + +Wed, May 17, 2007 - xdebug 2.0.0rc4 ++ Changes: + - Use microseconds instead of a tenths of microseconds to avoid confusion in + profile information. + - Changed xdebug.profiler_output_name and xdebug.trace_output_name to use + modifier tags: + %c = crc32 of the current working directory + %p = pid + %r = random number + %s = script name + %t = timestamp (seconds) + %u = timestamp (microseconds) + %H = $_SERVER['HTTP_HOST'] + %R = $_SERVER['REQUEST_URI'] + %S = session_id (from $_COOKIE if set) + %% = literal % + += Fixed bugs: + - Fixed bug #255: Call Stack Table doesn't show Location on Windows. + - Fixed bug #251: Using the source command with an invalid filename returns + unexpected result. + - Fixed bug #243: show_exception_trace="0" ignored. + - Fixed bug #241: Crash in xdebug_get_function_stack(). + - Fixed bug #240: Crash with xdebug.remote_log on Windows. + - Fixed a segfault in rendering stack traces to error logs. + - Fixed a bug that prevented variable names from being recorded for remote + debug session while xdebug.collect_vars was turned off. + - Fixed xdebug_dump_superglobals() in case no super globals were + configured. + +- Removed functions: + - Removed support for Memory profiling as that didn't work properly. + - Get rid of xdebug.default_enable setting and associated functions: + xdebug_disable() and xdebug_enable(). + ++ Added features: + - Implemented support for four different xdebug.collect_params settings for + stack traces and function traces. + - Allow to trigger profiling by the XDEBUG_PROFILE cookie. + ++ DBGP: + - Correctly add namespace definitions to XML. + - Added the xdebug namespace that adds extra information to breakpoints if + available. + - Stopped the use of >error> elements for exception breakpoints, as that + violates the protocol. + + + + + 2.0.0RC3 + 2.0.0RC3 + + + beta + beta + + 2007-01-31 + BSD style + +Wed, Jan 31, 2007 - xdebug 2.0.0rc3 ++ Changes: + - Removed the bogus "xdebug.allowed_clients" setting - it was not + implemented. + - Optimized used variable collection by switching to a linked list instead + of a hash. This is about 30% faster, but it needed a quick conversion to + hash in the case the information had to be shown to remove duplicate + variable names. + += Fixed bugs: + - Fixed bug #232: PHP log_errors functionality lost after enabling xdebug + error handler when CLI is used. + - Fixed problems with opening files - the filename could cause double free + issues. + - Fixed memory tracking as memory_limit is always enabled in PHP 5.2.1 and + later. + - Fixed a segfault that occurred when creating printable stack traces and + collect_params was turned off. + + + + + 2.0.0RC2 + 2.0.0RC2 + + + beta + beta + + 2006-12-24 + BSD style + +Sun, Dec 24, 2006 - xdebug 2.0.0rc2 ++ Added new features: + - Implemented the "xdebug.var_display_max_children" setting. The default is + set to 128 children. + - Added types to fancy var dumping function. + - Implemented FR #210: Add a way to stop the debug session without having + to execute a script. The GET/POST parameter "XDEBUG_SESSION_STOP_NO_EXEC" + works in the same way as XDEBUG_SESSION_STOP, except that the script will + not be executed. + - DBGP: Allow postmortem analysis. + - DBGP: Added the non-standard function xcmd_profiler_name_get. + ++ Changes: + - Fixed the issue where xdebug_get_declared_vars() did not know about + variables there are in the declared function header, but were not used in + the code. Due to this change expected arguments that were not send to a + function will now show up as ??? in stack and function traces in PHP 5.1 + and PHP 5.2. + - Allow xdebug.var_display_max_data and xdebug.var_display_max_depth + settings of -1 which will unlimit those settings. + - DBGP: Sort super globals in Globals overview. + - DBGP: Fixed a bug where error messages where not added upon errors in the + protocol. + - DBGP: Change context 1 from globals (superglobals + vars in bottom most + stack frame) to just superglobals. + += Fixed bugs: + - Fixed linking error on AIX by adding libm. + - Fixed dead code analysis for THROW. + - Fixed oparray prefill caching for code coverage. + - Fixed the xdebug.remote_log feature work. + - DBGP: Fixed a bug where $this did not appear in the local scoped context. + - DBGP: Reimplemented property_set to use the same symbol fetching function + as property_get. We now only use eval in case no type (-t) argument was + given. + - DBGP: Fixed some issues with finding out the classname, which is + important for fetching private properties. + - DBGP: Fixed usage of uninitialized memory that prevented looking up + numerical array keys while fetching array elements not work properly. + - Fixed bug #228: Binary safety for stream output and property fetches. + - Fixed bug #227: The SESSION super global does not show up in the Globals + scope. + - Fixed bug #225: xdebug dumps core when protocol is GDB. + - Fixed bug #224: Compile failure on Solaris. + - Fixed bug #219: Memory usage delta in traces don't work on PHP 5.2.0. + - Fixed bug #215: Cannot retrieve nested arrays when the array key is a + numeric index. + - Fixed bug #214: The depth level of arrays was incorrectly checked so it + would show the first page of a level too deep as well. + - Fixed bug #213: Dead code analysis doesn't take catches for throws into + account. + - Fixed bug #211: When starting a new session with a different idekey, the + cookie is not updated. + - Fixed bug #209: Additional remote debugging session started when + triggering shutdown function. + - Fixed bug #208: Socket connection attempted when XDEBUG_SESSION_STOP. + - Fixed PECL bug #8989: Compile error with PHP 5 and GCC 2.95. + + + + + 2.0.0rc1 + 2.0.0rc1 + + + beta + beta + + 2006-10-08 + BSD style + ++ Added new features: + - Implemented FR #70: Provide optional depth on xdebug_call_* functions. + - Partially implemented FR #50: Resource limiting for variable display. By + default only two levels of nested variables and max string lengths of 512 + are shown. This can be changed by setting the ini settings + xdebug.var_display_max_depth and xdebug.var_display_max_data. + - Implemented breakpoints for different types of PHP errors. You can now + set an 'exception' breakpoint on "Fatal error", "Warning", "Notice" etc. + This is related to bug #187. + - Added the xdebug_print_function_trace() function to display a stack trace on + demand. + - Reintroduce HTML tracing by adding a new tracing option "XDEBUG_TRACE_HTML" + (4). + - Made xdebug_stop_trace() return the trace file name, so that the + following works: <?php echo file_get_contents( xdebug_stop_trace() ); ?> + - Added the xdebug.collect_vars setting to tell Xdebug to collect + information about which variables are used in a scope. Now you don't need + to show variables with xdebug.show_local_vars anymore for + xdebug_get_declared_vars() to work. + - Make the filename parameter to the xdebug_start_trace() function + optional. If left empty it will use the same algorithm to pick a filename + as when you are using the xdebug.auto_trace setting. + ++ Changes: + - Implemented dead code analysis during code coverage for: + * abstract methods. + * dead code after return, throw and exit. + * implicit returns when a normal return is present. + - Improved readability of stack traces. + - Use PG(html_errors) instead of checking whether we run with CLI when + deciding when to use HTML messages or plain text messages. + += Fixed bugs: + - Fixed bug #203: PHP errors with HTML content processed incorrectly. This + patch backs out the change that was made to fix bug #182. + - Fixed bug #198: Segfault when trying to use a non-existing debug handler. + - Fixed bug #197: Race condition fixes created too many files. + - Fixed bug #196: Profile timing on Windows does not work. + - Fixed bug #195: CLI Error after debugging session. + - Fixed bug #193: Compile problems with PHP 5.2. + - Fixed bug #191: File/line breakpoints are case-sensitive on Windows. + - Fixed bug #181: Xdebug doesn't handle uncaught exception output + correctly. + - Fixed bug #173: Coverage produces wrong coverage. + - Fixed a typo that prevented the XDEBUG_CONFIG option "profiler_enable" + from working. + + + + + 2.0.0beta6 + 2.0.0beta6 + + + beta + beta + + 2006-06-30 + BSD style + ++ Added new features: + - Implemented FR #137: feature_get for general commands doesn't have a text field. + - Implemented FR #131: XDebug needs to implement paged child object requests. + - Implemented FR #124: Add backtrace dumping information when exception thrown. + - Implemented FR #70: Add feature_get breakpoint_types. + - Added profiling aggregation functions (patch by Andrei Zmievski) + - Implemented the "timestamp" option for the xdebug.trace_output_name and + xdebug.profiler_output_name settings. + - Added the xdebug.remote_log setting that allows you to log debugger + communication to a log file for debugging. This can also be set through + the "remote_log" element in the XDEBUG_CONFIG environment variable. + - Added a "script" value to the profiler_output_name option. This will write + the profiler output to a filename that consists of the script's full path + (using underscores). ie: /var/www/index.php becomes + var_www_index_php_cachegrind.out. (Patch by Brian Shire). + - DBGp: Implemented support for hit conditions for breakpoints. + - DBGp: Added support for conditions for file/line breakpoints. + - DBGp: Added support for hit value checking to file/line breakpoints. + - DBGp: Added support for "exception" breakpoints. ++ Performance improvements: + - Added a cache that prevents the code coverage functionality from running a + "which code is executable check" on every function call, even if they + were executed multiple times. This should speed up code coverage a lot. + - Speedup Xdebug but only gathering information about variables in scopes when + either remote debugging is used, or show_local_vars is enabled. += Fixed bugs: + - Fixed bug #184: problem with control chars in code traces + - Fixed bug #183: property_get -n $this->somethingnonexistent crashes the + debugger. + - Fixed bug #182: Errors are not html escaped when being displayed. + - Fixed bug #180: collected includes not shown in trace files. (Patch by + Cristian Rodriguez) + - Fixed bug #178: $php_errormsg and Track errors unavailable. + - Fixed bug #177: debugclient fails to compile due to Bison. + - Fixed bug #176: Segfault using SplTempFileObject. + - Fixed bug #173: Xdebug segfaults using SPL ArrayIterator. + - Fixed bug #171: set_time_limit stack overflow on 2nd request. + - Fixed bug #168: Xdebug's DBGp crashes on an eval command where the + result is an array. + - Fixed bug #125: show_mem_delta does not calculate correct negative values on + 64bit machines. + - Fixed bug #121: property_get -n $r[2] returns the whole hash. + - Fixed bug #111: xdebug does not ignore set_time_limit() function during debug + session. + - Fixed bug #87: Warning about headers when "register_shutdown_function" used. + - Fixed PECL bug #6940 (XDebug ignores set_time_limit) + - Fixed Komodo bug 45484: no member data for objects in PHP debugger. + - Suppress NOP/EXT_NOP from being marked as executable code with Code + Coverage. + + + + + 2.0.0beta5 + 2.0.0beta5 + + + beta + beta + + 2005-12-31 + BSD style + ++ Added new features: + - Implemented FR #161: var_dump doesn't show lengths for strings. + - Implemented FR #158: Function calls from the {main} scope always have the + line number 0. + - Implemented FR #156: it's impossible to know the time taken by the last + func call in xdebug trace mode 0. + - Implemented FR #153: xdebug_get_declared_vars(). + += Fixed bugs: + - Fixed shutdown crash with ZTS on Win32 + - Fixed bad memory leak when a E_ERROR of exceeding memory_limit was + thrown. + - Fixed bug #154: GCC 4.0.2 optimizes too much out with -O2. + - Fixed bug #141: Remote context_get causes segfault. + + + + + 2.0.0beta4 + 2.0.0beta4 + + + beta + beta + + 2005-09-24 + BSD style + ++ Added new features: + - Added xdebug_debug_zval_stdout(). + - Added xdebug_get_profile_filename() function which returns the current + profiler dump file. + - Updated for latest 5.1 and 6.0 CVS versions of PHP. + - Added FR #148: Option to append to cachegrind files, instead of + overwriting. + - Implemented FR #114: Rename tests/*.php to tests/*.inc + +- Changed features: + - Allow "xdebug.default_enable" to be set everywhere. + += Fixed bugs: + - DBGP: Xdebug should return "array" with property get, which is defined + in the typemap to the common type "hash". + - Fixed bug #142: xdebug crashes with implicit destructor calls. + - Fixed bug #136: The "type" attribute is missing from stack_get returns. + - Fixed bug #133: PHP scripts exits with 0 on PHP error. + - Fixed bug #132: use of eval causes a segmentation fault. + + + + + 2.0.0beta3 + 2.0.0beta3 + + + beta + beta + + 2005-05-12 + BSD style + ++ Added new features: + - Added the possibility to trigger the profiler by setting + "xdebug.profiler_enable_trigger" to 1 and using XDEBUG_PROFILE as a get + parameter. + += Fixed bugs: + - Fixed a segfault for when an attribute value is NULL on XML string + generation. + - Fixed bug #118: Segfault with exception when remote debugging. + - Fixed bug #117: var_dump dows not work with "private". + - Fixed bug #109: DBGP's eval will abort the script when the eval statement + is invalid. + - Fixed bug #108: log_only still displays some text for errors in included + files. + - Fixed bug #107: Code Coverage only detects executable code in used + functions and classes. + - Fixed bug #103: crash when running the DBGp command 'eval' on a global + variable + - Fixed bug #95: Segfault when deinitializing Xdebug module. + (Patch by Maxim Poltarak <demiurg@gmail.com>) + + + + + 2.0.0beta2 + 2.0.0beta2 + + + beta + beta + + 2004-11-28 + BSD style + ++ Added new features: + - DBGP: Added error messages to returned errors (in most cases) + ++ Added new functions: + - xdebug_debug_zval() to debug zvals by printing its refcounts and is_ref + values. + += Changed features: + - xdebug_code_coverage_stop() will now clean up the code coverage array, + unless you specify FALSE as parameter. + - The proper Xdebug type is "hash" for associative arrays. + - Extended the code-coverage functionality by returning lines with + executable code on them, but where not executed with a count value of -1. + += Fixed bugs: + - DBGP: Make property_get and property_value finally work as they should, + including retrieving information from different depths then the most top + stack frame. + - DBGP: Fix eval'ed $varnames in property_get. + - DBGP: Support the -d option for property_get. + - Fixed the exit handler hook to use the new "5.1" way of handling it; + which fortunately also works with PHP 5.0. + - Fixed bug #102: Problems with configure for automake 1.8. + - Fixed bug #101: crash with set_exeception_handler() and uncatched exceptions. + - Fixed bug #99: unset variables return the name as a string with property_get. + - Fixed bug #98: 'longname' attribute not returned for uninitialized + property in context_get request. + - Fixed bug #94: xdebug_sprintf misbehaves with x86_64/glibc-2.3.3 + - Fixed bug #93: Crash in lookup_hostname on x86_64 + - Fixed bug #92: xdebug_disable() doesn't disable the exception handler. + - Fixed bug #68: Summary not written when script ended with "exit()". + + + + + 2.0.0beta1 + 2.0.0beta1 + + + beta + beta + + 2004-09-15 + BSD style + ++ Added new features: + - Added support for the new DBGp protocol for communicating with the debug + engine. + - A computerized trace format for easier parsing by external programs. + - The ability to set remote debugging features via the environment. This + allows an IDE to emulate CGI and still pass the configuration through to + the debugger. In CGI mode, PHP does not allow -d arguments. + - Reimplementation of the tracing code, you can now only trace to file; this greatly + enhances performance as no string representation of variables need to be + kept in memory any more. + - Re-implemented profiling support. Xdebug outputs information the same way + that cachegrind does so it is possible to use Kcachegrind as front-end. + - Xdebug emits warnings when it was not loaded as a Zend extension. + - Added showing private, protected and public to the fancy var_dump() + replacement function. + - Added the setting of the TCP_NODELAY socket option to stop delays in + transferring data to the remote debugger client. (Patch by Christof J. Reetz) + + DebugClient: Added setting for port to listen on and implemented running + the previous command when pressing just enter. + ++ Added new functions: + - xdebug_get_stack_depth() to return the current stack depth level. + - xdebug_get_tracefile_name() to retrieve the name of the tracefile. This + is useful in case auto trace is enabled and you want to clean the trace + file. + - xdebug_peak_memory_usage() which returns the peak memory + used in a script. (Only works when --enable-memory-limit was enabled) + ++ Added feature requests: + - FR #5: xdebug_break() function which interupts the script for the debug + engine. + - FR #30: Dump current scope information in stack traces on error. + - FR #88: Make the url parameter XDEBUG_SESSION_START optional. So it can + be disabled and the user does not need to add it. + ++ Added new php.ini settings: + - xdebug.auto_trace_file: to configure a trace file to write to as addition + to the xdebug.auto_trace setting which just turns on tracing. + - xdebug.collect_includes: separates collecting + names of include files from the xdebug.collect_params setting. + - xdebug.collect_return: showing return values in traces. + - xdebug.dump_global: with which you can turn off dumping of super globals + even in you have that configured. + - xdebug.extended_info: turns off the generation of extended opcodes that + are needed for stepping and breakpoints for the remote debugger. This is + useful incase you want to profile memory usage as the generation of this + extended info increases memory usage of oparrrays by about 33%. + - xdebug.profiler_output_dir: profiler output directory. + - xdebug.profiler_enable: enable the profiler. + - xdebug.show_local_vars: turn off the showing of local variables in the + top most stack frame on errors. + - xdebug.show_mem_delta: show differences between current and previous + memory usage on a function call level. + - xdebug.trace_options: to configure extra + options for trace dumping: + o XDEBUG_TRACE_APPEND option (1) + += Changed features: + - xdebug_start_trace() now returns the filename of the tracefile (.xt is + added to the requested name). + - Changed default debugging protocol to dbgp instead of gdb. + - Changed default debugger port from 17869 to 9000. + - Changed trace file naming: xdebug.trace_output_dir is now used to + configure a directory to dump automatic traces; the trace file name now + also includes the pid (xdebug.trace_output_name=pid) or a crc32 checksum + of the current working dir (xdebug.trace_output_name=crc32) and traces + are not being appended to an existing file anymore, but simply + overwritten. + - Removed $this and $GLOBALS from showing variables in the local scope. + +- Removed functions: + - xdebug_get_function_trace/xdebug_dump_function_trace() because of the new + idea of tracing. + += Fixed bugs: + - Fixed bug #89: var_dump shows empty strings garbled. + - Fixed bug #85: Xdebug segfaults when no idekey is set. + - Fixed bug #83: More than 32 parameters functions make xdebug crash. + - Fixed bug #75: xdebug's var_dump implementation is not binary safe. + - Fixed bug #73: komodo beta 4.3.7 crash. + - Fixed bug #72: breakpoint_get returns wrong structure. + - Fixed bug #69: Integer overflow in cachegrind summary. + - Fixed bug #67: Filenames in Xdebug break URI RFC with spaces. + - Fixed bug #64: Missing include of xdebug_compat.h. + - Fixed bug #57: Crash with overloading functions. + - Fixed bug #54: source command did not except missing -f parameter. + - Fixed bug #53: Feature get misusing the supported attribute. + - Fixed bug #51: Only start a debug session if XDEBUG_SESSION_START is + passed as GET or POST parameter, or the DBGP_COOKIE is send to the server. + Passing XDEBUG_SESSION_STOP as GET/POST parameter will end the debug + session and removes the cookie again. The cookie is also passed to the + remote handler backends; for DBGp it is added to the <init> packet. + - Fixed bug #49: Included file's names should not be stored by address. + - Fixed bug #44: Script time-outs should be disabled when debugging. + = Fixed bug #36: GDB handler using print causes segfault with wrong syntax + - Fixed bug #33: Implemented the use of the ZEND_POST_DEACTIVATE hook. Now we + can handle destructors safely too. + - Fixed bug #32: Unusual dynamic variables cause xdebug to crash. + + + + + 1.3.1 + 1.3.1 + + + stable + stable + + 2004-04-06 + BSD style + += Fixed profiler to aggregate class/method calls correctly. (Robert Beenen) += Fixed debugclient to initialize socket structure correctly. (Brandon Philips + and David Sklar) += GDB: Fixed bug where the source file wasn't closed after a "source" command. + (Derick) + + + + + 1.3.0 + 1.3.0 + + + stable + stable + + 2003-09-17 + BSD style + += Fixed segfault where a function name didn't exist in case of a + "call_user_function". (Derick) += Fixed reading a filename in case of an callback to a PHP function from an + internal function (like "array_map()"). (Derick) + + + + + 1.3.0rc1 + 1.3.0rc1 + + + beta + beta + + 2003-09-17 + BSD style + += Fixed bug with wrong file names for functions called from call_user_*(). + (Derick) ++ Added the option "dump_superglobals" to the remote debugger. If you set this + option to 0 the "show-local" and similar commands will not return any data + from superglobals anymore. (Derick) += Fixed bug #2: "pear package" triggers a segfault. (Derick) += Fixed crash bug when a function had sprintf style parameters (ie. + strftime()). (Derick) ++ Added "id" attribute to <var /> elements in responses from the remove + debugger when the response method is XML. This makes it possible to + distinguish between unique elements by use of recursion for example. (Derick) += Improved performance greatly by doing lazy folding of variables outside + trace mode. (Derick) += Fixed a bug with "quit", if it was used it disabled the extension for the + current process. (Derick) ++ Added the "full" argument to the remote command "backtrace". When this + argument is passed, the local variables will be returned to for each frame in + the stack. (Derick) ++ Implemented xdebug_time_index() which returns the time passed since the + start of the script. This change also changes the output of the tracing + functions as the start time will no longer be the first function call, but + the real start time of the script. (Derick) ++ Implemented the "show-local" command (shows all local variables in the + current scope including all contents). (Derick) ++ Implemented conditions for breakpoints in the "break" command. (Derick) + + + + + 1.2.0 + 1.2.0 + + + stable + stable + + 2003-04-21 + BSD style + += Fixed compilation on MacOSX. (Derick) + + + + + 1.2.0rc2 + 1.2.0rc2 + + + beta + beta + + 2003-04-15 + BSD style + += Fixed handling Windows paths in the debugger. (Derick) += Fixed getting zvals out of Zend Engine 2. (Derick) + + + + + 1.2.0rc1 + 1.2.0rc1 + + + beta + beta + + 2003-04-06 + BSD style + ++ Added code coverage functions to check which lines and how often they were + touched during execution. (Derick) ++ Made Xdebug compatible with Zend Engine 2. (Derick) ++ Added dumping of super globals on errors. (Harald Radi) ++ Added XML protocol for the debugger client. (Derick) += Fixed handling of "continue" (so that it also continues with the script). + (Derick) ++ Additions to the remote debugger: "eval" (evaluate any PHP code from the + debugger client). (Derick) ++ Added profiling support to xdebug. This introduces 3 new functions, + xdebug_start_profiling() that begins profiling process, + xdebug_stop_profiling() that ends the profiling process and + xdebug_dump_function_trace() that dumps the profiling data. (Ilia) ++ Implemented the "kill" (kills the running script) and "delete" (removes + a breakpoint on a specified element) command. (Derick) + + + + + 1.1.0 + 1.1.0 + + + stable + stable + + 2002-11-11 + BSD style + ++ Implemented the "list" (source listing), "print" (printing variable + contents), "show" (show all variables in the scope), "step" (step through + execution), "pwd" (print working directory), "next" (step over) and "finish" + (step out) commands for the remote debugger. (Derick) += Fixed lots of small bugs, under them memory leaks and crash bugs. (Derick) + + + + + 1.1.0pre2 + 1.1.0pre2 + + + beta + beta + + 2002-10-29 + BSD style + ++ Implemented class::method, object->method and file.ext:line style + breakpoints. (Derick) ++ Added xdebug.collect_params setting. If this setting is on (the default) + then Xdebug collects all parameters passed to functions, otherwise they + are not collected at all. (Derick) ++ Implemented correct handling of include/require and eval. (Derick) + + + + + 1.1.0pre1 + 1.1.0pre1 + + + beta + beta + + 2002-10-22 + BSD style + ++ Added automatic starting of function traces (xdebug.auto_trace, defaulting to + "off"). (Derick) +- Xdebug no longer supports PHP versions below PHP 4.3.0pre1. (Derick) ++ Added gdb compatible debugger handler with support for simple (function only) + breakpoints. (Derick) += Implemented a new way to get class names and file names. (Derick, Thies C. + Arntzen <thies@thieso.net>) ++ Added time-index and memory footprint to CLI dumps. (Derick) ++ Implemented remote debugger handler abstraction. (Derick) ++ Added a php3 compatible debugger handler. (Derick) + + + + + 1.0.0rc1 + 1.0.0rc1 + + + beta + beta + + 2002-09-01 + BSD style + ++ Implemented gathering of parameters to internal functions (only available + in combination with PHP 4.3.0-dev). (Derick) += Implemented a new way to get class names and file names. (Derick, Thies C. + Arntzen >thies@thieso.net<) ++ Added support for error messages with stack trace in syslog. (Sergio + Ballestrero >s.ballestrero@planetweb.it<) += Windows compilation fixes. (Derick) + + + + + 0.9.0 + 0.9.0 + + + beta + beta + + 2002-06-16 + BSD style + += Fixed a memory leak in delayed included files. (Derick) +- Added support for PHP 4.1.2. (Derick) += Rewrote xdebug_get_function_stack() and xdebug_get_function_trace() to return + data in multidimensional arrays. (Derick) += Fixed compiling without memory limit enabled (Sander Roobol, Derick) +- Add support for classnames, variable include files and variable + function names. (Derick) +- Implemented links to the PHP Manual in traces. (Derick) +- Added timestamps and memory usage to function traces. (Derick) += Fixed crash when using an user defined session handler. (Derick) ++ Implemented variable function names ($a = 'foo'; $f();) for use in + traces. (Derick) + + + + + 0.8.0 + 0.8.0 + + + beta + beta + + 2002-05-26 + BSD style + ++ Implemented much better parameter tracing for user defined + functions. (Derick) += Renamed xdebug_get_function_trace() to xdebug_dump_function_trace(). + (Derick) += Implemented new xdebug_get_function_trace() to return the function trace in + an array. (Derick) ++ Added a parameter to xdebug_start_trace(). When this parameter is used, + xdebug will dump a function trace to the filename which this parameter + speficies. (Derick) +- Fix a problem with nested member functions. (Derick) += Make configure scripts work with PHP 4.2.x. (Derick) ++ Implemented handling single-dimensional constant arrays passed to a + function. (Derick) += Fix function traces in windows. (Derick) ++ Implemented function traces, which you can start and stop with + xdebug_start_trace() and xdebug_stop_trace(). You can view the trace by using + the return array from xdebug_get_function_trace(). (Derick) += Fixed segfaults with xdebug_call_*(). (Derick) + + + + + 0.7.0 + 0.7.0 + + + beta + beta + + 2002-05-08 + BSD style + ++ Implemented handling of static method calls (foo::bar). (Derick) ++ Added correct handling of include(_once)/require(_once) and eval(). + (Derick) ++ Added ini setting to change the default setting for enabling showing + enhanced error messages. (Defaults to "On"). (Derick) ++ Added the functions xdebug_enable() and xdebug_disable() to change the + showing of stack traces from within your code. (Derick) += Fixed the extension to show all errors. (Derick) ++ Implemented xdebug_memory_usage() which returns the memory in use by PHPs + engine. (Derick) + + + + diff --git a/plugins/hwp-previews/phpcs.xml b/plugins/hwp-previews/phpcs.xml new file mode 100644 index 0000000..97a3228 --- /dev/null +++ b/plugins/hwp-previews/phpcs.xml @@ -0,0 +1,327 @@ + + + + + + + + Coding standards for the HWP Previews plugin + ./hwp-previews.php + ./src/ + ./templates/ + */languages/* + */phpunit.xml* + **/tests/** + */vendor/* + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 4 + warning + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/plugins/hwp-previews/phpcs/HWPStandard/Sniffs/ControlStructures/ElseKeywordSniff.php b/plugins/hwp-previews/phpcs/HWPStandard/Sniffs/ControlStructures/ElseKeywordSniff.php new file mode 100644 index 0000000..98bd26d --- /dev/null +++ b/plugins/hwp-previews/phpcs/HWPStandard/Sniffs/ControlStructures/ElseKeywordSniff.php @@ -0,0 +1,47 @@ +getTokens(); + $token = $tokens[$stackPtr]; + + if ($token['code'] === T_ELSE) { + $warning = 'Usage of "else" detected; consider refactoring to avoid else branches'; + $phpcsFile->addWarning($warning, $stackPtr, 'ElseDetected'); + + return; + } + + if ($token['code'] === T_ELSEIF) { + $warning = 'Usage of "elseif" detected; consider refactoring to avoid else branches'; + $phpcsFile->addWarning($warning, $stackPtr, 'ElseIfDetected'); + } + } +} diff --git a/plugins/hwp-previews/phpcs/HWPStandard/ruleset.xml b/plugins/hwp-previews/phpcs/HWPStandard/ruleset.xml new file mode 100644 index 0000000..8947039 --- /dev/null +++ b/plugins/hwp-previews/phpcs/HWPStandard/ruleset.xml @@ -0,0 +1,4 @@ + + + HWP custom coding standard. + diff --git a/plugins/hwp-previews/phpstan.neon.dist b/plugins/hwp-previews/phpstan.neon.dist new file mode 100644 index 0000000..cdcfd02 --- /dev/null +++ b/plugins/hwp-previews/phpstan.neon.dist @@ -0,0 +1,35 @@ +includes: + - vendor/szepeviktor/phpstan-wordpress/extension.neon + - vendor/phpstan/phpstan-strict-rules/rules.neon + +services: + - + class: HWP\Previews\PHPStan\Rules\ClassConstantVarAnnotationRule + tags: [phpstan.rules.rule] + +parameters: + # Analysis Rules + treatPhpDocTypesAsCertain: false + inferPrivatePropertyTypeFromConstructor: true + checkExplicitMixedMissingReturn: true + checkMissingTypehints: true + checkFunctionNameCase: true + checkInternalClassCaseSensitivity: true + checkTooWideReturnTypesInProtectedAndPublicMethods: true + polluteScopeWithAlwaysIterableForeach: false + polluteScopeWithLoopInitialAssignments: false + reportAlwaysTrueInLastCondition: true + reportStaticMethodSignatures: true + reportWrongPhpDocTypeInVarTag: true + + # Configuration + level: 8 + phpVersion: + min: 70400 + max: 80400 + paths: + - hwp-previews.php + - src/ + ignoreErrors: + - + identifier: empty.notAllowed diff --git a/plugins/hwp-previews/phpstan/Rules/ClassConstantVarAnnotationRule.php b/plugins/hwp-previews/phpstan/Rules/ClassConstantVarAnnotationRule.php new file mode 100644 index 0000000..f469fb3 --- /dev/null +++ b/plugins/hwp-previews/phpstan/Rules/ClassConstantVarAnnotationRule.php @@ -0,0 +1,41 @@ + + */ +class ClassConstantVarAnnotationRule implements Rule +{ + public function getNodeType(): string + { + return Node\Stmt\ClassConst::class; + } + + public function processNode(Node $node, Scope $scope): array + { + $docComment = $node->getDocComment(); + if (!$docComment instanceof Doc) { + return [ + RuleErrorBuilder::message('Class constant must have a @var annotation in its docblock.')->build(), + ]; + } + + $docText = $docComment->getText(); + if (!preg_match('/@var\s+\S+/', $docText)) { + return [ + RuleErrorBuilder::message('Class constant docblock must contain a non-empty @var annotation.')->build(), + ]; + } + + return []; + } +} diff --git a/plugins/hwp-previews/psalm.xml b/plugins/hwp-previews/psalm.xml new file mode 100644 index 0000000..b4fb463 --- /dev/null +++ b/plugins/hwp-previews/psalm.xml @@ -0,0 +1,20 @@ + + + + + + + + + + + + diff --git a/plugins/hwp-previews/src/Plugin.php b/plugins/hwp-previews/src/Plugin.php new file mode 100644 index 0000000..5edf4ec --- /dev/null +++ b/plugins/hwp-previews/src/Plugin.php @@ -0,0 +1,696 @@ + + */ + public const SETTINGS_FIELDS = [ + self::ENABLED_FIELD => 'bool', + self::UNIQUE_POST_SLUGS_FIELD => 'bool', + self::POST_STATUSES_AS_PARENT_FIELD => 'bool', + self::PREVIEW_URL_FIELD => 'string', + self::IN_IFRAME_FIELD => 'bool', + ]; + + /** + * Post statuses that are applicable for previews. + * + * @var array + */ + public const POST_STATUSES = [ + 'publish', + 'future', + 'draft', + 'pending', + 'private', + 'auto-draft', + ]; + + /** + * Settings object used for value retrieving. + * + * @var \HWP\Previews\Settings\Preview_Settings + */ + private Preview_Settings $settings; + + /** + * Post types configuration. + * + * @var \HWP\Previews\Post\Type\Contracts\Post_Types_Config_Interface + */ + private Post_Types_Config_Interface $types_config; + + /** + * Post statuses configuration. + * + * @var \HWP\Previews\Post\Status\Contracts\Post_Statuses_Config_Interface + */ + private Post_Statuses_Config_Interface $statuses_config; + + /** + * Preview parameter registry. + * + * @var \HWP\Previews\Preview\Parameter\Preview_Parameter_Registry + */ + private Preview_Parameter_Registry $parameters; + + /** + * Preview link service class that handles the generation of preview links. + * + * @var \HWP\Previews\Preview\Link\Preview_Link_Service + */ + private Preview_Link_Service $link_service; + + /** + * The version of the plugin. + * + * @var string + */ + private string $version; + + /** + * The directory path of the plugin. + * + * @var string + */ + private string $dir_path; + + /** + * The URL of the plugin. + * + * @var string + */ + private string $plugin_url; + + /** + * The instance of the plugin. + * + * @var \HWP\Previews\Plugin|null + */ + private static ?Plugin $instance = null; + + /** + * Constructor. + * + * @param string $version The version of the plugin. + * @param string $dir_path The directory path of the plugin. + * @param string $plugin_url The URL of the plugin. + */ + private function __construct( string $version, string $dir_path, string $plugin_url ) { + $this->version = $version; + $this->dir_path = $dir_path; + $this->plugin_url = $plugin_url; + + // Initialize the settings object with a cache group. + $this->settings = new Preview_Settings( + new Settings_Cache_Group( self::SETTINGS_KEY, self::SETTINGS_GROUP, self::SETTINGS_FIELDS ) + ); + + // Initialize the post types and statuses configurations. + $this->types_config = ( new Post_Types_Config( new Post_Type_Inspector() ) )->set_post_types( $this->settings->post_types_enabled() ); + $this->statuses_config = ( new Post_Statuses_Config() )->set_post_statuses( self::POST_STATUSES ); + + // Initialize the preview parameter registry. + $this->parameters = new Preview_Parameter_Registry(); + + // Initialize the preview link service. + $this->link_service = new Preview_Link_Service( + $this->types_config, + $this->statuses_config, + new Preview_Link_Placeholder_Resolver( $this->parameters ) + ); + } + + /** + * Get the instance of this class. Passes the version, directory path, and plugin URL to the constructor. + * + * @param string $version The version of the plugin. + * @param string $dir_path The directory path of the plugin. + * @param string $plugin_url The URL of the plugin. + * + * @return \HWP\Previews\Plugin + */ + public static function get_instance( string $version, string $dir_path, string $plugin_url ): Plugin { + if ( self::$instance === null ) { + self::$instance = new self( $version, $dir_path, $plugin_url ); + } + + return self::$instance; + } + + /** + * Initialize the plugin functionality. + */ + public function init(): void { + // Init core functionality. + $this->init_core_functionality(); + + // Settings. + $this->register_settings_pages(); + $this->register_settings_fields(); + + // JS. + $this->enqueue_plugin_js(); + + // Functionality. + $this->enable_unique_post_slug(); + $this->enable_post_statuses_as_parent(); + $this->enable_preview_in_iframe(); + $this->enable_preview_functionality(); + } + + /** + * Enqueues the JavaScript file for the plugin admin area. + * Todo: if more complexity is added, consider using a separate class Sript_Enqueue. + * + * @return void + */ + public function enqueue_plugin_js(): void { + add_action( 'admin_enqueue_scripts', function ( string $hook ) { + if ( $hook !== 'toplevel_page_' . self::PLUGIN_MENU_SLUG ) { + return; + } + + wp_enqueue_script( + self::PLUGIN_JS_HANDLE, + trailingslashit( $this->plugin_url ) . self::PLUGIN_JS_SRC, + [], + $this->version, + true + ); + } ); + } + + /** + * Enable unique post slugs for post statuses specified in the post statuses config. + * + * @return void + */ + public function enable_unique_post_slug(): void { + add_filter( 'wp_insert_post_data', function ( $data, $postarr ) { + $post = new WP_Post( new Post_Data_Model( $data, (int) ( $postarr['ID'] ?? 0 ) ) ); + + // Check if the correspondent setting is enabled. + if ( ! $this->settings->unique_post_slugs( $post->post_type ) ) { + return $data; + } + + $post_slug = ( new Post_Slug_Manager( + $this->types_config, + $this->statuses_config, + new Post_Slug_Repository() + ) )->force_unique_post_slug( $post ); + + if ( ! empty( $post_slug ) ) { + $data['post_name'] = $post_slug; + } + + return $data; + }, 10, 2 ); + } + + /** + * Replace the preview link in the REST response. + * + * @param \WP_REST_Response $response The REST response object. + * @param \WP_Post $post The post object. + * + * @return \WP_REST_Response + */ + public function filter_rest_prepare_link( WP_REST_Response $response, WP_Post $post ): WP_REST_Response { + if ( $this->settings->in_iframe( $post->post_type ) ) { + return $response; + } + + $preview_url = $this->generate_preview_url( $post ); + if ( ! empty( $preview_url ) ) { + $response->data['link'] = $preview_url; + } + + return $response; + } + + /** + * Setups default preview parameters on the 'init' hook. + * Creates custom action hook 'hwp_previews_core'. + * + * @return void + */ + private function init_core_functionality(): void { + add_action( 'init', function (): void { + + // Register default preview parameters. + $this->setup_default_preview_parameters(); + + + /** + * Allows access to the parameters registry, types config, statuses config. + */ + do_action( 'hwp_previews_core', $this->parameters, $this->types_config, $this->statuses_config ); + }, 5, 0 ); + } + + /** + * Registers default preview parameters on the init hook. + * Uses 'hwp_previews_parameters_registry' action to allow modification of the parameters registry. + * + * @return void + */ + private function setup_default_preview_parameters(): void { + $this->parameters + ->register( + new Preview_Parameter( 'ID', static fn( WP_Post $post ) => (string) $post->ID, __( 'Post ID.', 'hwp-previews' ) ) + )->register( + new Preview_Parameter( 'author_ID', static fn( WP_Post $post ) => $post->post_author, __( 'ID of post author..', 'hwp-previews' ) ) + )->register( + new Preview_Parameter( 'status', static fn( WP_Post $post ) => $post->post_status, __( 'The post\'s status..', 'hwp-previews' ) ) + )->register( + new Preview_Parameter( 'slug', static fn( WP_Post $post ) => $post->post_name, __( 'The post\'s slug.', 'hwp-previews' ) ) + )->register( + new Preview_Parameter( 'parent_ID', static fn( WP_Post $post ) => (string) $post->post_parent, __( 'ID of a post\'s parent post.', 'hwp-previews' ) ) + )->register( + new Preview_Parameter( 'type', static fn( WP_Post $post ) => $post->post_type, __( 'The post\'s type, like post or page.', 'hwp-previews' ) ) + )->register( + new Preview_Parameter( 'uri', static fn( WP_Post $post ) => (string) get_page_uri( $post ), __( 'The URI path for a page.', 'hwp-previews' ) ) + )->register( + new Preview_Parameter( 'template', static fn( WP_Post $post ) => (string) get_page_template_slug( $post ), __( 'Specific template filename for a given post.', 'hwp-previews' ) ) + ); + } + + /** + * Registers settings pages and subpages. + * + * @return void + */ + private function register_settings_pages(): void { + add_action( 'admin_menu', function (): void { + /** + * Array of post types where key is the post type slug and value is the label. + * + * @var array $post_types + */ + $post_types = apply_filters( 'hwp_previews_filter_post_type_setting', $this->types_config->get_public_post_types() ); + + $this->create_settings_page( $post_types )->register_page(); + $this->create_settings_subpage()->register_page(); + } ); + } + + /** + * Registers settings fields. + * + * @return void + */ + private function register_settings_fields(): void { + add_action( 'admin_init', function (): void { + + /** + * Array of post types where key is the post type slug and value is the label. + * + * @var array $post_types + */ + $post_types = apply_filters( 'hwp_previews_filter_post_type_setting', $this->types_config->get_public_post_types() ); + + /** + * Register setting itself. + */ + $this->create_tabbed_settings( $post_types )->register_settings(); + + /** + * Register settings sections and fields for each post type. + */ + foreach ( $post_types as $post_type => $label ) { + $this->create_setting_section( $post_type, $label )->register_section( self::SETTINGS_KEY, $post_type, "hwp-previews-{$post_type}" ); + } + }, 10, 0 ); + } + + /** + * Enable post statuses specified in the post statuses config as parent for the post types specified in the post types config. + * + * @return void + */ + private function enable_post_statuses_as_parent(): void { + $post_parent_manager = new Post_Parent_Manager( $this->types_config, $this->statuses_config ); + + $post_parent_manager_callback = function ( array $args ) use ( $post_parent_manager ): array { + if ( empty( $args['post_type'] ) ) { + return $args; + } + + $post_type = (string) $args['post_type']; + + // Check if the correspondent setting is enabled. + if ( ! $this->settings->post_statuses_as_parent( $post_type ) ) { + return $args; + } + + $post_statuses = $post_parent_manager->get_post_statuses_as_parent( $post_type ); + if ( ! empty( $post_statuses ) ) { + $args['post_status'] = $post_statuses; + } + + return $args; + }; + + add_filter( 'page_attributes_dropdown_pages_args', $post_parent_manager_callback ); + add_filter( 'quick_edit_dropdown_pages_args', $post_parent_manager_callback ); + + // And for Gutenberg. + foreach ( $this->types_config->get_post_types() as $post_type ) { + if ( ! $this->types_config->gutenberg_editor_enabled( $post_type ) ) { + continue; + } + add_filter( 'rest_' . $post_type . '_query', $post_parent_manager_callback ); + } + } + + /** + * Enable preview functionality in iframe. + * + * @return void + */ + private function enable_preview_in_iframe(): void { + $template_resolver = new Preview_Template_Resolver( $this->types_config, $this->statuses_config ); + + add_filter( 'template_include', function ( $template ) use ( $template_resolver ) { + if ( ! is_preview() ) { + return $template; + } + + $post = get_post(); + if ( ! $post instanceof WP_Post ) { + return $template; + } + + // Check if the correspondent setting is enabled. + if ( ! $this->settings->in_iframe( $post->post_type ) ) { + return $template; + } + + /** + * The filter 'hwp_previews_template_path' allows to change the template directory path. + */ + $template_dir_path = (string) apply_filters( + 'hwp_previews_template_path', + $this->dir_path . 'templates/hwp-preview.php' + ); + + $preview_template = $template_resolver->resolve_template_path( $post, $template_dir_path ); + + if ( empty( $preview_template ) ) { + return $template; + } + + set_query_var( $template_resolver::HWP_PREVIEWS_IFRAME_PREVIEW_URL, $this->generate_preview_url( $post ) ); + + return $preview_template; + }, 999 ); + } + + /** + * Swaps the preview link for the post types specified in the post types config. + * Is being enabled only if the preview is not in iframe. Otherwise preview functionality is resolved on the template redirect level. + * + * @return void + */ + private function enable_preview_functionality(): void { + add_filter( 'preview_post_link', function ( $link, $post ) { + // If iframe option is enabled, we need to resolve preview on the template redirect level. + if ( $this->settings->in_iframe( $post->post_type ) ) { + return $link; + } + + $url = $this->generate_preview_url( $post ); + + return ! empty( $url ) ? $url : $link; + }, 10, 2 ); + + /** + * Hack Function that changes the preview link for draft articles, + * this must be removed when properly fixed https://github.com/WordPress/gutenberg/issues/13998. + */ + foreach ( $this->types_config->get_public_post_types() as $key => $label ) { + add_filter( 'rest_prepare_' . $key, [ $this, 'filter_rest_prepare_link' ], 10, 2 ); + } + } + + /** + * Generates the preview URL for the given post based on the preview URL template provided in settings. + * + * @param \WP_Post $post The post object. + * + * @return string The generated preview URL. + */ + private function generate_preview_url( WP_Post $post ): string { + // Check if the correspondent setting is enabled. + $url = $this->settings->url_template( $post->post_type ); + + if ( empty( $url ) ) { + return ''; + } + + return $this->link_service->generate_preview_post_link( $url, $post ); + } + + /** + * Creates the settings page. + * + * @param array $post_types The post types to be used in the settings page. + * + * @return \HWP\Previews\Settings\Menu\Menu_Page + */ + private function create_settings_page( array $post_types ): Menu_Page { + return new Menu_Page( + __( 'HWP Previews Settings', 'hwp-previews' ), + 'HWP Previews', + self::PLUGIN_MENU_SLUG, + $this->dir_path . 'templates/admin/settings-page-main.php', + [ + self::SETTINGS_ARGS => [ + 'tabs' => $post_types, + 'current_tab' => $this->get_current_tab( $post_types ), + 'params' => $this->parameters->get_descriptions(), + ], + ], + 'dashicons-welcome-view-site' + ); + } + + /** + * Get the current tab for the settings page. + * + * @param array $post_types The post types to be used in the settings page. + * @param string $tab The name of the tab. + * + * @return string + */ + private function get_current_tab( $post_types, string $tab = 'tab' ): string { + // phpcs:disable WordPress.Security.NonceVerification.Recommended + if ( isset( $_GET[ $tab ] ) && is_string( $_GET[ $tab ] ) ) { + return sanitize_key( $_GET[ $tab ] ); + } + + return ! empty( $post_types ) ? (string) key( $post_types ) : ''; + } + + /** + * Creates the settings subpage. + * + * @return \HWP\Previews\Settings\Menu\Submenu_Page + */ + private function create_settings_subpage(): Submenu_Page { + return new Submenu_Page( + self::PLUGIN_MENU_SLUG, + __( 'Testing Tool', 'hwp-previews' ), + 'Testing Tool', + 'hwp-previews-testing-tool', + $this->dir_path . 'templates/admin/settings-page-testing-tool.php' + ); + } + + /** + * Creates the tabbed settings object. + * + * @param array $post_types Post Types as a tabs. + * + * @return \HWP\Previews\Settings\Tabbed_Settings + */ + private function create_tabbed_settings( array $post_types ): Tabbed_Settings { + return new Tabbed_Settings( + self::SETTINGS_GROUP, + self::SETTINGS_KEY, + array_keys( $post_types ), + self::SETTINGS_FIELDS + ); + } + + /** + * Creates the settings section for a specific post type. + * + * @param string $post_type The post type slug. + * @param string $label The label for the post type. + * + * @return \HWP\Previews\Settings\Settings_Section + */ + private function create_setting_section( string $post_type, string $label ): Settings_Section { + return new Settings_Section( + 'hwp_previews_section_' . $post_type, + '', + 'hwp-previews-' . $post_type, + $this->create_settings_fields( $post_type, $label, is_post_type_hierarchical( $post_type ) ) + ); + } + + /** + * Creates the settings fields for a specific post type. + * + * @param string $post_type The post type slug. + * @param string $label The label for the post type. + * @param bool $is_hierarchical Whether the post type is hierarchical. + * + * @return array<\HWP\Previews\Settings\Fields\Abstract_Settings_Field> + */ + private function create_settings_fields( string $post_type, string $label, bool $is_hierarchical ): array { + $fields = []; + + $fields[] = new Checkbox_Field( + 'enabled', + // translators: %s is the label of the post type. + sprintf( __( 'Enable HWP Previews for %s', 'hwp-previews' ), $label ) + ); + $fields[] = new Checkbox_Field( 'unique_post_slugs', __( 'Enable unique post slugs for all post statuses', 'hwp-previews' ) ); + + if ( $is_hierarchical ) { + $fields[] = new Checkbox_Field( 'post_statuses_as_parent', __( 'Allow all post statuses in parents option', 'hwp-previews' ) ); + } + + $fields[] = new Checkbox_Field( 'in_iframe', sprintf( __( 'Load previews in iframe', 'hwp-previews' ), $label ) ); + $fields[] = new Text_Input_Field( + 'preview_url', + // translators: %s is the label of the post type. + sprintf( __( 'Preview URL for %s', 'hwp-previews' ), $label ), + "https://example.com/{$post_type}?preview=true&post_id={ID}&name={slug}", + 'large-text code hwp-previews-url' // The class is being used as a query for the JS. + ); + + return $fields; + } + +} diff --git a/plugins/hwp-previews/src/Post/Data/Post_Data_Model.php b/plugins/hwp-previews/src/Post/Data/Post_Data_Model.php new file mode 100644 index 0000000..d1c54e1 --- /dev/null +++ b/plugins/hwp-previews/src/Post/Data/Post_Data_Model.php @@ -0,0 +1,63 @@ + $data Array of data to hydrate the model. + * @param int $post_id Post ID. + */ + public function __construct( array $data, int $post_id = 0 ) { + $this->ID = (int) ( $data['ID'] ?? $post_id ); + $this->post_status = (string) ( $data['post_status'] ?? '' ); + $this->post_type = (string) ( $data['post_type'] ?? '' ); + $this->post_name = (string) ( $data['post_name'] ?? '' ); + $this->post_title = (string) ( $data['post_title'] ?? '' ); + } + +} diff --git a/plugins/hwp-previews/src/Post/Parent/Contracts/Post_Parent_Manager_Interface.php b/plugins/hwp-previews/src/Post/Parent/Contracts/Post_Parent_Manager_Interface.php new file mode 100644 index 0000000..0bf7380 --- /dev/null +++ b/plugins/hwp-previews/src/Post/Parent/Contracts/Post_Parent_Manager_Interface.php @@ -0,0 +1,18 @@ + + */ + public function get_post_statuses_as_parent( string $post_type ): array; + +} diff --git a/plugins/hwp-previews/src/Post/Parent/Post_Parent_Manager.php b/plugins/hwp-previews/src/Post/Parent/Post_Parent_Manager.php new file mode 100644 index 0000000..43e53c2 --- /dev/null +++ b/plugins/hwp-previews/src/Post/Parent/Post_Parent_Manager.php @@ -0,0 +1,68 @@ + + */ + public const POST_STATUSES = [ 'publish', 'future', 'draft', 'pending', 'private' ]; + + /** + * Post types configuration. + * + * @var \HWP\Previews\Post\Type\Contracts\Post_Types_Config_Interface + */ + private Post_Types_Config_Interface $post_types; + + /** + * Post statuses configuration. + * + * @var \HWP\Previews\Post\Status\Contracts\Post_Statuses_Config_Interface + */ + private Post_Statuses_Config_Interface $post_statuses; + + /** + * Post_Parent_Manager constructor. + * + * @param \HWP\Previews\Post\Type\Contracts\Post_Types_Config_Interface $post_types Post types configuration. + * @param \HWP\Previews\Post\Status\Contracts\Post_Statuses_Config_Interface $post_statuses Post statuses configuration. + */ + public function __construct( Post_Types_Config_Interface $post_types, Post_Statuses_Config_Interface $post_statuses ) { + $this->post_types = $post_types; + $this->post_statuses = $post_statuses; + } + + /** + * Get the post statuses that can be used as parent for a given post type. + * + * @param string $post_type Post Type slug. + * + * @return array + */ + public function get_post_statuses_as_parent( string $post_type ): array { + if ( + ! $this->post_types->is_post_type_applicable( $post_type ) || + ! $this->post_types->is_hierarchical( $post_type ) + ) { + return []; + } + + return array_intersect( self::POST_STATUSES, $this->post_statuses->get_post_statuses() ); + } + +} diff --git a/plugins/hwp-previews/src/Post/Slug/Contracts/Post_Slug_Manager_Interface.php b/plugins/hwp-previews/src/Post/Slug/Contracts/Post_Slug_Manager_Interface.php new file mode 100644 index 0000000..fdb2b03 --- /dev/null +++ b/plugins/hwp-previews/src/Post/Slug/Contracts/Post_Slug_Manager_Interface.php @@ -0,0 +1,35 @@ + $reserved_slugs Array of reserved slugs. + * + * @return string + */ + public function generate_unique_slug( string $slug, string $post_type, int $post_id, array $reserved_slugs ): string; + +} diff --git a/plugins/hwp-previews/src/Post/Slug/Contracts/Post_Slug_Repository_Interface.php b/plugins/hwp-previews/src/Post/Slug/Contracts/Post_Slug_Repository_Interface.php new file mode 100644 index 0000000..8c8b95a --- /dev/null +++ b/plugins/hwp-previews/src/Post/Slug/Contracts/Post_Slug_Repository_Interface.php @@ -0,0 +1,18 @@ +types = $types; + $this->statuses = $statuses; + $this->slug_repository = $slug_repository; + } + + /** + * Forces unique slug for a post. + * + * @param \WP_Post $post The post object. + * + * @return string The unique slug. + */ + public function force_unique_post_slug( WP_Post $post ): string { + if ( + ! (bool) $post->ID || + ! $this->types->is_post_type_applicable( $post->post_type ) || + ! $this->statuses->is_post_status_applicable( $post->post_status ) + ) { + return ''; + } + + global $wp_rewrite; + + $slug = empty( $post->post_name ) ? sanitize_title( $post->post_title, "$post->post_status-$post->ID" ) : $post->post_name; + $feeds = is_array( $wp_rewrite->feeds ) ? $wp_rewrite->feeds : []; + + return $this->generate_unique_slug( $slug, $post->post_type, $post->ID, array_merge( $feeds, [ 'embed' ] ) ); + } + + /** + * Generates a unique slug for a post. + * + * @see wp-includes/post.php + * + * @param string $slug . + * @param string $post_type . + * @param int $post_id . + * @param array $reserved_slugs . + * + * @return string + */ + public function generate_unique_slug( string $slug, string $post_type, int $post_id, array $reserved_slugs ): string { + if ( empty( $slug ) ) { + $slug = 'undefined'; + } + + if ( ! $this->slug_repository->is_slug_taken( $slug, $post_type, $post_id ) && ! in_array( $slug, $reserved_slugs, true ) ) { + return $slug; + } + + $suffix = 2; + do { + $new_slug = _truncate_post_slug( $slug, 200 - ( strlen( (string) $suffix ) + 1 ) ) . "-$suffix"; + ++$suffix; + } while ( $this->slug_repository->is_slug_taken( $new_slug, $post_type, $post_id ) ); + + return $new_slug; + } + +} diff --git a/plugins/hwp-previews/src/Post/Slug/Post_Slug_Repository.php b/plugins/hwp-previews/src/Post/Slug/Post_Slug_Repository.php new file mode 100644 index 0000000..f57459c --- /dev/null +++ b/plugins/hwp-previews/src/Post/Slug/Post_Slug_Repository.php @@ -0,0 +1,41 @@ +get_var( // phpcs:ignore WordPress.DB + $wpdb->prepare( + "SELECT post_name FROM {$wpdb->posts} WHERE post_name = %s AND post_type = %s AND ID != %d LIMIT 1", + $slug, + $post_type, + $post_id + ) + ); + } + +} diff --git a/plugins/hwp-previews/src/Post/Status/Contracts/Post_Statuses_Config_Interface.php b/plugins/hwp-previews/src/Post/Status/Contracts/Post_Statuses_Config_Interface.php new file mode 100644 index 0000000..eafd1b6 --- /dev/null +++ b/plugins/hwp-previews/src/Post/Status/Contracts/Post_Statuses_Config_Interface.php @@ -0,0 +1,30 @@ + $post_statuses The post statuses to set. + */ + public function set_post_statuses( array $post_statuses ): self; + + /** + * Get the post statuses that are applicable for the plugin. + * + * @return array + */ + public function get_post_statuses(): array; + + /** + * Check if a given post status is applicable for the plugin. + * + * @param string $post_status Post status slug. + */ + public function is_post_status_applicable( string $post_status ): bool; + +} diff --git a/plugins/hwp-previews/src/Post/Status/Post_Statuses_Config.php b/plugins/hwp-previews/src/Post/Status/Post_Statuses_Config.php new file mode 100644 index 0000000..ffa9d94 --- /dev/null +++ b/plugins/hwp-previews/src/Post/Status/Post_Statuses_Config.php @@ -0,0 +1,54 @@ + + */ + private array $post_statuses = []; + + /** + * Sets the post statuses that are applicable for the plugin. + * + * @param array $post_statuses Post statuses that are applicable for the plugin. + * + * @return $this + */ + public function set_post_statuses( array $post_statuses ): self { + $this->post_statuses = $post_statuses; + + return $this; + } + + /** + * Get the post statuses that are applicable for the plugin. + * + * @return array Post statuses. + */ + public function get_post_statuses(): array { + return $this->post_statuses; + } + + /** + * Verifies if the post status is applicable according to the configuration. + * + * @param string $post_status Post status to check. + * + * @return bool + */ + public function is_post_status_applicable( string $post_status ): bool { + return in_array( $post_status, $this->post_statuses, true ); + } + +} diff --git a/plugins/hwp-previews/src/Post/Type/Contracts/Post_Type_Inspector_Interface.php b/plugins/hwp-previews/src/Post/Type/Contracts/Post_Type_Inspector_Interface.php new file mode 100644 index 0000000..93de33f --- /dev/null +++ b/plugins/hwp-previews/src/Post/Type/Contracts/Post_Type_Inspector_Interface.php @@ -0,0 +1,29 @@ + $post_types The post type to check. + */ + public function set_post_types( array $post_types ): self; + + /** + * Get the post types that are applicable for previews. + * + * @return array Post types that are applicable for previews. + */ + public function get_post_types(): array; + + /** + * Check if a post type is applicable for previews. + * + * @param string $post_type The post type to check. + */ + public function is_post_type_applicable( string $post_type ): bool; + + /** + * Check if a post type is hierarchical. + * + * @param string $post_type The post type. + */ + public function is_hierarchical( string $post_type ): bool; + + /** + * Check if a post type supports Gutenberg. + * + * @param string $post_type Post Type slug. + */ + public function gutenberg_editor_enabled( string $post_type ): bool; + + /** + * Gets all publicly available post types as key value array, where key is a post type slug and value is a label. + * + * @return array + */ + public function get_public_post_types(): array; + +} diff --git a/plugins/hwp-previews/src/Post/Type/Post_Type_Inspector.php b/plugins/hwp-previews/src/Post/Type/Post_Type_Inspector.php new file mode 100644 index 0000000..56c4cf9 --- /dev/null +++ b/plugins/hwp-previews/src/Post/Type/Post_Type_Inspector.php @@ -0,0 +1,55 @@ +show_in_rest ) || + empty( $post_type->supports ) || + ! is_array( $post_type->supports ) || + ! in_array( 'editor', $post_type->supports, true ) + ) { + return false; + } + + return $post_type->show_in_rest; + } + + /** + * Checks if the post type is supported by Classic Editor. + * + * @param string $post_type Post Type slug. + * + * @return bool + */ + public function is_classic_editor_forced( string $post_type ): bool { + if ( + ! function_exists( 'is_plugin_active' ) || + ! is_plugin_active( 'classic-editor/classic-editor.php' ) + ) { + return false; + } + + // If this post type is listed in Classic Editor settings, Gutenberg is disabled. + $settings = (array) get_option( 'classic-editor-settings', [] ); + + return ! empty( $settings['post_types'] ) && + is_array( $settings['post_types'] ) && + in_array( $post_type, $settings['post_types'], true ); + } + +} diff --git a/plugins/hwp-previews/src/Post/Type/Post_Types_Config.php b/plugins/hwp-previews/src/Post/Type/Post_Types_Config.php new file mode 100644 index 0000000..b131078 --- /dev/null +++ b/plugins/hwp-previews/src/Post/Type/Post_Types_Config.php @@ -0,0 +1,116 @@ + + */ + private array $post_types = []; + + /** + * Post type inspector. + * + * @var \HWP\Previews\Post\Type\Contracts\Post_Type_Inspector_Interface + */ + private Post_Type_Inspector_Interface $inspector; + + /** + * Class constructor. + * + * @param \HWP\Previews\Post\Type\Contracts\Post_Type_Inspector_Interface $inspector Post Type inspector. + */ + public function __construct( Post_Type_Inspector_Interface $inspector ) { + $this->inspector = $inspector; + } + + /** + * Sets the post types that are applicable for preview links. + * + * @param array $post_types Post types that are applicable for preview links. + * + * @return $this + */ + public function set_post_types( array $post_types ): self { + $this->post_types = $post_types; + + return $this; + } + + /** + * Get the post types that are applicable for preview links. + * + * @return array + */ + public function get_post_types(): array { + return $this->post_types; + } + + /** + * Check if the post type is applicable for preview links. + * + * @param string $post_type Post Type slug. + * + * @return bool + */ + public function is_post_type_applicable( string $post_type ): bool { + return in_array( $post_type, $this->post_types, true ) && post_type_exists( $post_type ); + } + + /** + * Check if the post type is hierarchical. + * + * @param string $post_type Post Type slug. + * + * @return bool + */ + public function is_hierarchical( string $post_type ): bool { + return is_post_type_hierarchical( $post_type ); + } + + /** + * Check if the post type supports Gutenberg editor and if the classic editor is not being forced. + * + * @param string $post_type Post Type slug. + * + * @return bool + */ + public function gutenberg_editor_enabled( string $post_type ): bool { + $post_type_object = get_post_type_object( $post_type ); + if ( ! $post_type_object instanceof WP_Post_Type ) { + return false; + } + + return $this->inspector->is_gutenberg_supported( $post_type_object ) && + ! $this->inspector->is_classic_editor_forced( $post_type ); + } + + /** + * Gets all publicly available post types as key value array, where key is a post type slug and value is a label. + * + * @return array + */ + public function get_public_post_types(): array { + $post_types = get_post_types( [ 'public' => true ], 'objects' ); + $result = []; + + foreach ( $post_types as $post_type ) { + $result[ $post_type->name ] = $post_type->label; + } + + return $result; + } + +} diff --git a/plugins/hwp-previews/src/Preview/Link/Preview_Link_Placeholder_Resolver.php b/plugins/hwp-previews/src/Preview/Link/Preview_Link_Placeholder_Resolver.php new file mode 100644 index 0000000..0cc1c8e --- /dev/null +++ b/plugins/hwp-previews/src/Preview/Link/Preview_Link_Placeholder_Resolver.php @@ -0,0 +1,76 @@ +registry = $registry; + } + + /** + * Replace all {PLACEHOLDER} tokens in template string with urlencoded string values from callbacks. + * + * @param string $template The string containing {KEY} placeholders. + * @param \WP_Post $post The post object to resolve the tokens against. + * + * @return string + */ + public function resolve_placeholders(string $template, WP_Post $post ): string { + return (string) preg_replace_callback( + self::PLACEHOLDER_REGEX, + fn(array $matches): string => rawurlencode( $this->resolve_token( $matches[1], $post ) ), + $template + ); + } + + /** + * Resolve individual token by key. + * + * @param string $key The token key without braces. + * @param \WP_Post $post Post object to resolve the token against. + * + * @return string + */ + private function resolve_token( string $key, WP_Post $post ): string { + $parameter = $this->registry->get( $key ); + if ( ! $parameter instanceof Preview_Parameter_Interface ) { + return self::PLACEHOLDER_NOT_FOUND; + } + + return $parameter->get_value( $post ); + } + +} diff --git a/plugins/hwp-previews/src/Preview/Link/Preview_Link_Service.php b/plugins/hwp-previews/src/Preview/Link/Preview_Link_Service.php new file mode 100644 index 0000000..094327c --- /dev/null +++ b/plugins/hwp-previews/src/Preview/Link/Preview_Link_Service.php @@ -0,0 +1,74 @@ +types = $types; + $this->statuses = $statuses; + $this->resolver = $resolver; + } + + /** + * Generate a preview post link. + * + * @param string $preview_url_template Preview URL template. + * @param \WP_Post $post The post object. + * + * @return string + */ + public function generate_preview_post_link( string $preview_url_template, WP_Post $post ): string { + if ( + empty( $preview_url_template ) || + ! $this->types->is_post_type_applicable( $post->post_type ) || + ! $this->statuses->is_post_status_applicable( $post->post_status ) + ) { + return ''; + } + + return $this->resolver->resolve_placeholders( $preview_url_template, $post ); + } + +} diff --git a/plugins/hwp-previews/src/Preview/Parameter/Contracts/Preview_Parameter_Builder_Interface.php b/plugins/hwp-previews/src/Preview/Parameter/Contracts/Preview_Parameter_Builder_Interface.php new file mode 100644 index 0000000..d025728 --- /dev/null +++ b/plugins/hwp-previews/src/Preview/Parameter/Contracts/Preview_Parameter_Builder_Interface.php @@ -0,0 +1,27 @@ + + */ + public function build_preview_args( WP_Post $post, string $page_uri, string $token ): array; + +} diff --git a/plugins/hwp-previews/src/Preview/Parameter/Contracts/Preview_Parameter_Interface.php b/plugins/hwp-previews/src/Preview/Parameter/Contracts/Preview_Parameter_Interface.php new file mode 100644 index 0000000..6db8d07 --- /dev/null +++ b/plugins/hwp-previews/src/Preview/Parameter/Contracts/Preview_Parameter_Interface.php @@ -0,0 +1,41 @@ +name = $name; + $this->description = $description; + $this->callback = $callback; + } + + /** + * Get the name of the parameter. + * + * @inheritDoc + */ + public function get_name(): string { + return $this->name; + } + + /** + * Get the description of the parameter. + * + * @inheritDoc + */ + public function get_description(): string { + return $this->description; + } + + /** + * Get the value of the parameter for a given post. + * No need to URL-encode here. + * + * @param \WP_Post $post The post object. + * + * @return string + */ + public function get_value( WP_Post $post ): string { + return call_user_func( $this->callback, $post ); + } + +} diff --git a/plugins/hwp-previews/src/Preview/Parameter/Preview_Parameter_Registry.php b/plugins/hwp-previews/src/Preview/Parameter/Preview_Parameter_Registry.php new file mode 100644 index 0000000..925d25c --- /dev/null +++ b/plugins/hwp-previews/src/Preview/Parameter/Preview_Parameter_Registry.php @@ -0,0 +1,85 @@ + + */ + private array $parameters = []; + + /** + * Register a parameter. + * + * @param \HWP\Previews\Preview\Parameter\Contracts\Preview_Parameter_Interface $parameter The parameter object. + * + * @return self + */ + public function register( Preview_Parameter_Interface $parameter ): self { + $this->parameters[ $parameter->get_name() ] = $parameter; + + return $this; + } + + /** + * Unregister a parameter. + * + * @param string $name The parameter name. + * + * @return self + */ + public function unregister( string $name ): self { + if ( isset( $this->parameters[ $name ] ) ) { + unset( $this->parameters[ $name ] ); + } + + return $this; + } + + /** + * Get all registered parameters. + * + * @return array + */ + public function get_all(): array { + return $this->parameters; + } + + /** + * Get all registered parameters as an array of their names and descriptions. + * + * @return array + */ + public function get_descriptions(): array { + $descriptions = []; + foreach ( $this->parameters as $parameter ) { + $descriptions[ $parameter->get_name() ] = $parameter->get_description(); + } + + return $descriptions; + } + + /** + * Get a specific parameter by name. Returns null if not found. + * + * @param string $name The parameter name. + * + * @return \HWP\Previews\Preview\Parameter\Contracts\Preview_Parameter_Interface|null + */ + public function get( string $name ): ?Preview_Parameter_Interface { + return $this->parameters[ $name ] ?? null; + } + +} diff --git a/plugins/hwp-previews/src/Preview/Template/Contracts/Preview_Template_Resolver_Interface.php b/plugins/hwp-previews/src/Preview/Template/Contracts/Preview_Template_Resolver_Interface.php new file mode 100644 index 0000000..0daa850 --- /dev/null +++ b/plugins/hwp-previews/src/Preview/Template/Contracts/Preview_Template_Resolver_Interface.php @@ -0,0 +1,21 @@ +types = $types; + $this->statuses = $statuses; + } + + /** + * Resolves the template path for the preview. + * + * @param \WP_Post $post The post object. + * @param string $template_path The template path. + * + * @return string The resolved template path. + */ + public function resolve_template_path( WP_Post $post, string $template_path ): string { + if ( + empty( $template_path ) || + ! $this->types->is_post_type_applicable( $post->post_type ) || + ! $this->statuses->is_post_status_applicable( $post->post_status ) || + ! is_preview() + ) { + return ''; + } + + return file_exists( $template_path ) ? $template_path : ''; + } + +} diff --git a/plugins/hwp-previews/src/Settings/Contracts/General_Settings_Interface.php b/plugins/hwp-previews/src/Settings/Contracts/General_Settings_Interface.php new file mode 100644 index 0000000..1937e60 --- /dev/null +++ b/plugins/hwp-previews/src/Settings/Contracts/General_Settings_Interface.php @@ -0,0 +1,23 @@ + $default_value Default post types. + * + * @return array + */ + public function post_types_enabled( array $default_value = [] ): array; + + /** + * Gets URL template for the given post type. + * + * @param string $post_type Post type slug. + * @param string $default_value Default URL template. + * + * @return string + */ + public function url_template( string $post_type, string $default_value = '' ): string; + + /** + * If the post type post statuses should have unique slug for the post type. + * + * @param string $post_type Post type slug. + * @param bool $default_value Default value. + * + * @return bool + */ + public function unique_post_slugs( string $post_type, bool $default_value = false ): bool; + + /** + * It the specified post statuses should be allowed to be used as parent post statuses. + * + * @param string $post_type Post type slug. + * @param bool $default_value Default value. + * + * @return bool + */ + public function post_statuses_as_parent( string $post_type, bool $default_value = false ): bool; + + /** + * If the post type preview supposed to be opened in iframe on WP Admin side. + * + * @param string $post_type Post type slug. + * @param bool $default_value Default value. + * + * @return bool + */ + public function in_iframe( string $post_type, bool $default_value = false ): bool; + +} diff --git a/plugins/hwp-previews/src/Settings/Fields/Abstract_Settings_Field.php b/plugins/hwp-previews/src/Settings/Fields/Abstract_Settings_Field.php new file mode 100644 index 0000000..9ddc07d --- /dev/null +++ b/plugins/hwp-previews/src/Settings/Fields/Abstract_Settings_Field.php @@ -0,0 +1,152 @@ + $option_value Settings value. + * @param string $setting_key The settings key. + * @param string $post_type The post type. + * + * @return void + */ + abstract protected function render_field( array $option_value, string $setting_key, string $post_type ): void; + + /** + * Constructor. + * + * @param string $id The settings field ID. + * @param string $title The settings field title. + * @param string $css_class The settings field class. + */ + public function __construct( + string $id, + string $title, + string $css_class = '' + ) { + $this->id = $id; + $this->title = $title; + $this->class = $css_class; + } + + /** + * Set the settings key. + * + * @param string $settings_key The settings key. + * + * @return $this + */ + public function set_settings_key( string $settings_key ): self { + $this->settings_key = $settings_key; + + return $this; + } + + /** + * Set the post type. + * + * @param string $post_type The post type. + * + * @return $this + */ + public function set_post_type( string $post_type ): self { + $this->post_type = $post_type; + + return $this; + } + + /** + * Register the settings field. + * + * @param string $section The settings section. + * @param string $page The settings page. + * + * @return void + */ + public function register_settings_field( string $section, string $page ): void { + + add_settings_field( + $this->id, + $this->title, + [ $this, 'settings_field_callback' ], + $page, + $section + ); + } + + /** + * Callback for the settings field. + * + * @return void + */ + public function settings_field_callback(): void { + $this->render_field( + $this->get_setting_value( $this->settings_key, $this->post_type ), + $this->settings_key, + $this->post_type + ); + } + + /** + * Get the settings value. + * + * @param string $settings_key The settings key. + * @param string $post_type The post type. + * + * @return array + */ + private function get_setting_value( string $settings_key, string $post_type ): array { + $value = get_option( $settings_key, [] ); + + if ( + empty( $value ) || + ! isset( $value[ $post_type ] ) || + ! is_array( $value[ $post_type ] ) + ) { + return []; + } + + return $value[ $post_type ]; + } + +} diff --git a/plugins/hwp-previews/src/Settings/Fields/Checkbox_Field.php b/plugins/hwp-previews/src/Settings/Fields/Checkbox_Field.php new file mode 100644 index 0000000..38505b9 --- /dev/null +++ b/plugins/hwp-previews/src/Settings/Fields/Checkbox_Field.php @@ -0,0 +1,54 @@ +default = $default_value; + } + + /** + * Render the checkbox settings field. + * + * @param array $option_value Settings value. + * @param string $setting_key The settings key. + * @param string $post_type The post type. + * + * @return void + */ + protected function render_field( $option_value, $setting_key, $post_type ): void { + $enabled = isset( $option_value[ $this->id ] ) + ? (bool) $option_value[ $this->id ] + : $this->default; + + printf( + '', + esc_attr( $setting_key ), + esc_attr( $post_type ), + esc_attr( $this->id ), + checked( 1, $enabled, false ), + sanitize_html_class( $this->class ) + ); + } + +} diff --git a/plugins/hwp-previews/src/Settings/Fields/Text_Input_Field.php b/plugins/hwp-previews/src/Settings/Fields/Text_Input_Field.php new file mode 100644 index 0000000..c012329 --- /dev/null +++ b/plugins/hwp-previews/src/Settings/Fields/Text_Input_Field.php @@ -0,0 +1,51 @@ +default = $default_value; + } + + /** + * Render the field. + * + * @param array $option_value The value of the field. + * @param string $setting_key The settings key. + * @param string $post_type The post type. + * + * @return void + */ + protected function render_field( array $option_value, string $setting_key, string $post_type ): void { + printf( + '', + esc_attr( $setting_key ), + esc_attr( $post_type ), + esc_attr( $this->id ), + esc_attr( (string) ( $option_value[ $this->id ] ?? $this->default ) ), + esc_attr( $this->default ), + esc_attr( $this->class ) + ); + } + +} diff --git a/plugins/hwp-previews/src/Settings/Menu/Menu_Page.php b/plugins/hwp-previews/src/Settings/Menu/Menu_Page.php new file mode 100644 index 0000000..427cc91 --- /dev/null +++ b/plugins/hwp-previews/src/Settings/Menu/Menu_Page.php @@ -0,0 +1,127 @@ +> + */ + protected array $args; + + /** + * The name of a Dashicons helper class to use a font icon. + * + * @var string + */ + protected string $icon; + + /** + * Constructor. + * + * @param string $page_title The text to be displayed in the title tags of the page when the menu is selected. + * @param string $menu_title The text to be used for the menu. + * @param string $menu_slug The slug name to refer to this menu by. Should be unique for this menu and only include lowercase alphanumeric, dashes, and underscores characters to be compatible with sanitize_key(). + * @param string $template The template that will be included in the callback. + * @param array> $args The args array for the template. + * @param string $icon The name of a Dashicons helper class to use a font icon. + */ + public function __construct( + string $page_title, + string $menu_title, + string $menu_slug, + string $template, + array $args = [], + string $icon = 'dashicons-admin-generic' + ) { + $this->page_title = $page_title; + $this->menu_title = $menu_title; + $this->menu_slug = $menu_slug; + $this->template = $template; + $this->args = $args; + $this->icon = $icon; + } + + /** + * Registers the menu page in the WordPress admin. + * + * @return void + */ + public function register_page(): void { + add_menu_page( + $this->page_title, + $this->menu_title, + 'manage_options', + $this->menu_slug, + [ $this, 'registration_callback' ], + $this->icon + ); + } + + /** + * Callback function to display the content of the menu page. + * + * @return void + */ + public function registration_callback(): void { + if ( empty( $this->template ) || ! file_exists( $this->template ) ) { + printf( + '

%s

', + esc_html__( 'The HWP Previews Settings template does not exist.', 'hwp-previews' ) + ); + + return; + } + $this->set_query_vars(); + + // phpcs:ignore WordPressVIPMinimum.Files.IncludingFile.UsingVariable -- $this->template is validated and defined within the class + include_once $this->template; + } + + /** + * Sets the query vars for the template. + * + * @return void + */ + protected function set_query_vars(): void { + foreach ( $this->args as $query_var => $args ) { + set_query_var( $query_var, $args ); + } + } + +} diff --git a/plugins/hwp-previews/src/Settings/Menu/Submenu_Page.php b/plugins/hwp-previews/src/Settings/Menu/Submenu_Page.php new file mode 100644 index 0000000..989f7a8 --- /dev/null +++ b/plugins/hwp-previews/src/Settings/Menu/Submenu_Page.php @@ -0,0 +1,54 @@ + $args An array of arguments to be passed to the template. + */ + public function __construct( + string $parent_slug, + string $page_title, + string $menu_title, + string $menu_slug, + string $template, + array $args = [] + ) { + $this->parent_slug = $parent_slug; + parent::__construct( $page_title, $menu_title, $menu_slug, $template, $args ); + } + + /** + * Register the submenu page. Should be called on the 'admin_menu' action. + * + * @return void + */ + public function register_page(): void { + add_submenu_page( + $this->parent_slug, + $this->page_title, + $this->menu_title, + 'manage_options', + $this->menu_slug, + [ $this, 'registration_callback' ] + ); + } + +} diff --git a/plugins/hwp-previews/src/Settings/Preview_Settings.php b/plugins/hwp-previews/src/Settings/Preview_Settings.php new file mode 100644 index 0000000..8291102 --- /dev/null +++ b/plugins/hwp-previews/src/Settings/Preview_Settings.php @@ -0,0 +1,91 @@ +group = $group; + } + + /** + * Get all post types that are enabled in the settings. + * + * @param array $default_value Default post types to return if none are enabled. + * + * @return array + */ + public function post_types_enabled( array $default_value = [] ): array { + $value = $this->group->get_cache_settings(); + + $post_types = array_filter( $value, static fn( $item ) => isset( $item[ Plugin::ENABLED_FIELD ] ) && $item[ Plugin::ENABLED_FIELD ] === true ); + + return ! empty( $post_types ) ? array_keys( $post_types ) : $default_value; + } + + /** + * Get Unique Post Slugs setting value for the given post type. + * + * @param string $post_type The post type to get the setting for. + * @param bool $default_value The default value to return if the setting is not set. + * + * @return bool + */ + public function unique_post_slugs( string $post_type, bool $default_value = false ): bool { + return $this->group->get_bool( Plugin::UNIQUE_POST_SLUGS_FIELD, $post_type, $default_value ); + } + + /** + * Get Post Statuses as Parent setting value for the given post type. + * + * @param string $post_type The post type to get the setting for. + * @param bool $default_value The default value to return if the setting is not set. + * + * @return bool + */ + public function post_statuses_as_parent( string $post_type, bool $default_value = false ): bool { + return $this->group->get_bool( Plugin::POST_STATUSES_AS_PARENT_FIELD, $post_type, $default_value ); + } + + /** + * Show In iframe value for the given post type. + * + * @param string $post_type The post type to get the setting for. + * @param bool $default_value The default value to return if the setting is not set. + * + * @return bool + */ + public function in_iframe( string $post_type, bool $default_value = false ): bool { + return $this->group->get_bool( Plugin::IN_IFRAME_FIELD, $post_type, $default_value ); + } + + /** + * URL template setting value for the given post type. + * + * @param string $post_type The post type to get the setting for. + * @param string $default_value The default value to return if the setting is not set. + * + * @return string + */ + public function url_template( string $post_type, string $default_value = '' ): string { + return $this->group->get_string( Plugin::PREVIEW_URL_FIELD, $post_type, $default_value ); + } + +} diff --git a/plugins/hwp-previews/src/Settings/Settings_Cache_Group.php b/plugins/hwp-previews/src/Settings/Settings_Cache_Group.php new file mode 100644 index 0000000..dc3c524 --- /dev/null +++ b/plugins/hwp-previews/src/Settings/Settings_Cache_Group.php @@ -0,0 +1,113 @@ + + */ + private array $settings_config; + + /** + * Constructor. + * Adds a settings group to the list of non-persistent groups. + * + * @param string $option Option name. + * @param string $group Group name. + * @param array $settings_config Array of settings config where keys are allowed options and values are types. + */ + public function __construct( string $option, string $group, array $settings_config ) { + $this->option = $option; + $this->group = $group; + $this->settings_config = $settings_config; + + wp_cache_add_non_persistent_groups( [ $this->group ] ); + } + + /** + * Gets settings from the cache or database. + * + * @return array + */ + public function get_cache_settings(): array { + + $value = wp_cache_get( $this->option, $this->group ); + + if ( $value === false ) { + $value = (array) get_option( $this->option, [] ); + wp_cache_set( $this->option, $value, $this->group ); + } + + return $value; + } + + /** + * Gets a setting value from the cache or database. + * + * @param string $name The name of a bool setting. + * @param string $post_type The post type slug. + * @param bool $default_value The default value to return if the setting is not found. + * + * @return bool + */ + public function get_bool( string $name, string $post_type, bool $default_value = false ): bool { + $value = $this->get_cache_settings(); + + if ( ! $this->is_setting_of_type( $name, 'bool' ) || empty( $value[ $post_type ][ $name ] ) ) { + return $default_value; + } + + return (bool) $value[ $post_type ][ $name ]; + } + + /** + * Gets a setting value from the cache or database. + * + * @param string $name The name of a string setting. + * @param string $post_type The post type slug. + * @param string $default_value The default value to return if the setting is not found. + * + * @return string + */ + public function get_string( string $name, string $post_type, string $default_value = '' ): string { + $value = $this->get_cache_settings(); + + if ( ! $this->is_setting_of_type( $name, 'string' ) || empty( $value[ $post_type ][ $name ] ) ) { + return $default_value; + } + + return (string) $value[ $post_type ][ $name ]; + } + + /** + * Verifies if a setting allowed in the settings config and compares the type is correct. + * + * @param string $name The name of a setting. + * @param string $type The type of the setting. + * + * @return bool + */ + private function is_setting_of_type( string $name, string $type ): bool { + return array_key_exists( $name, $this->settings_config ) && $this->settings_config[ $name ] === $type; + } + +} diff --git a/plugins/hwp-previews/src/Settings/Settings_Section.php b/plugins/hwp-previews/src/Settings/Settings_Section.php new file mode 100644 index 0000000..a02957f --- /dev/null +++ b/plugins/hwp-previews/src/Settings/Settings_Section.php @@ -0,0 +1,82 @@ + + */ + private array $fields; + + /** + * Constructor. + * + * @param string $id Page slug. + * @param string $title Settings section title. + * @param string $page The slug of the settings page. + * @param array<\HWP\Previews\Settings\Fields\Abstract_Settings_Field> $fields Array of fields to be registered in the section. + */ + public function __construct( + string $id, + string $title, + string $page, + array $fields + ) { + $this->id = $id; + $this->title = $title; + $this->page = $page; + $this->fields = $fields; + } + + /** + * Register the settings section. + * + * @param string $settings_key The settings key. + * @param string $post_type The post type. + * @param string $page The page slug. + * + * @return void + */ + public function register_section( string $settings_key, string $post_type, string $page ): void { + add_settings_section( + $this->id, + $this->title, + static fn() => null, + $this->page + ); + + foreach ( $this->fields as $field ) { + $field->set_settings_key( $settings_key ); + $field->set_post_type( $post_type ); + + $field->register_settings_field( $this->id, $page ); + } + } + +} diff --git a/plugins/hwp-previews/src/Settings/Tabbed_Settings.php b/plugins/hwp-previews/src/Settings/Tabbed_Settings.php new file mode 100644 index 0000000..f916667 --- /dev/null +++ b/plugins/hwp-previews/src/Settings/Tabbed_Settings.php @@ -0,0 +1,135 @@ + + */ + private array $tabs; + + /** + * Array of sanitization options where keys area options and values are types. + * + * @var array + */ + private array $sanitization_options; + + /** + * Constructor. + * + * @param string $option_group Settings option group. + * @param string $option_name Settings option name. + * @param array $tabs Tabs array as items allowed in the settings. + * @param array $sanitization_options Array of sanitization options where keys are options and values are types. + */ + public function __construct( + string $option_group, + string $option_name, + array $tabs, + array $sanitization_options + ) { + $this->option_group = $option_group; + $this->option_name = $option_name; + $this->tabs = $tabs; + $this->sanitization_options = $sanitization_options; + } + + /** + * Register settings. + * + * @return void + */ + public function register_settings(): void { + register_setting( + $this->option_group, + $this->option_name, + [ + 'sanitize_callback' => [ $this, 'sanitize_settings' ], + 'type' => 'array', + 'default' => [], + ] + ); + } + + /** + * Sanitize and merge new settings per-tab, pruning unknown fields. + * + * @param array $new_input New settings input for the specific tab that comes from the form for the sanitization. + * + * @return array + */ + public function sanitize_settings( array $new_input ): array { + $old_input = (array) get_option( $this->option_name, [] ); + + // Remove redundant tabs. + $old_input = array_intersect_key( $old_input, array_flip( $this->tabs ) ); + + $tab = array_keys( $new_input ); + if ( ! isset( $tab[0] ) ) { + return $old_input; // Wrong settings structure. + } + + $tab_to_sanitize = (string) $tab[0]; + if ( ! is_array( $new_input[ $tab_to_sanitize ] ) ) { + return $old_input; // Wrong settings structure. + } + + // Sanitize the fields in the tab. + $sanitized_fields = []; + foreach ( $new_input[ $tab_to_sanitize ] as $key => $value ) { + if ( ! isset( $this->sanitization_options[ (string) $key ] ) ) { + continue; + } + + $sanitized_fields[ $key ] = $this->sanitize_field( (string) $key, $value ); + } + + // Merge the sanitized fields with the old input. + $old_input[ $tab_to_sanitize ] = $sanitized_fields; + + return $old_input; + } + + /** + * Sanitize a single field value by type. + * + * @param string $key Field key. + * @param mixed $value Raw value. + * + * @return bool|int|string + */ + private function sanitize_field( string $key, $value ) { + $type = $this->sanitization_options[ $key ]; + + switch ( $type ) { + case 'bool': + return ! empty( $value ); + case 'int': + return intval( $value ); + case 'text': + default: + return sanitize_text_field( (string) $value ); + } + } + +} diff --git a/plugins/hwp-previews/src/Shared/Abstract_Model.php b/plugins/hwp-previews/src/Shared/Abstract_Model.php new file mode 100644 index 0000000..a7920e5 --- /dev/null +++ b/plugins/hwp-previews/src/Shared/Abstract_Model.php @@ -0,0 +1,28 @@ +|object|null $value The value to set. + * + * @return void + * + * @throws \Exception When attempting to modify a readonly property. + */ + public function __set( string $name, $value ): void { + throw new Exception( 'Cannot modify readonly property: ' . esc_html( $name ) ); + } + +} diff --git a/plugins/hwp-previews/templates/admin.php b/plugins/hwp-previews/templates/admin.php new file mode 100644 index 0000000..854073d --- /dev/null +++ b/plugins/hwp-previews/templates/admin.php @@ -0,0 +1,38 @@ + + +
+

+

+ +
+ +
+

+ $tab_label ) : ?> + + + + +

+ +
diff --git a/plugins/hwp-previews/templates/admin/settings-page-main.php b/plugins/hwp-previews/templates/admin/settings-page-main.php new file mode 100644 index 0000000..53cfa09 --- /dev/null +++ b/plugins/hwp-previews/templates/admin/settings-page-main.php @@ -0,0 +1,80 @@ + + +
+

+ +

+ $tab_label ) { + $url = admin_url( 'admin.php?page=hwp-previews&tab=' . $tab_key ); + $class = add_cssclass( $current_tab === $tab_key ? 'nav-tab-active' : '', 'nav-tab' ); + echo '' . esc_html( $tab_label ) . ''; + } ?> +

+ +
+
+
+
+
+
+ +
+
+
+
+ + +
+
+
+

+
+
+ $desc ) : ?> + + + + +
+
+
+
+
+
+
+
+ + +
diff --git a/plugins/hwp-previews/templates/admin/settings-page-testing.php b/plugins/hwp-previews/templates/admin/settings-page-testing.php new file mode 100644 index 0000000..d7fed13 --- /dev/null +++ b/plugins/hwp-previews/templates/admin/settings-page-testing.php @@ -0,0 +1,13 @@ + + +
+

+

+ +
diff --git a/plugins/hwp-previews/templates/hwp-preview.php b/plugins/hwp-previews/templates/hwp-preview.php new file mode 100644 index 0000000..874402b --- /dev/null +++ b/plugins/hwp-previews/templates/hwp-preview.php @@ -0,0 +1,40 @@ + + + +> + + + + + + + +
+ +
+ + + +