diff --git a/.gitignore b/.gitignore
index 8cab6437249f7487868e28a48cee512320fa11af..f9c48edc9de13601df7538cb851496f90a9d3a58 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
.idea
vendor
.phpcs-cache
+composer.lock
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5b848f8e30b66bdeeadd148ee47c7cef51fd7421..3d60cbf5543236da3ea0370e4e38a4fdca53d465 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
# WP Migrations Changelog
+## [1.1.0] - 09-11-2024
+### Added
+- New method to migration classes: `is_needed()` which can return false to skip specific migration version execution.
+### Removed
+- Removed `AbstractMigration::down()` as in WordPress context it is impossible to execute down migrations reliably and the method was never actually used.
+
## [1.0.4] - 06-10-2023
### Fixed
- Respect status returned from migration. If any error occurred (migration returned false or threw), break migration process.
diff --git a/composer.json b/composer.json
index b0f3c7d968c4f9564c93bf991bad93c384ad7984..49f4b2a7059e090f2edf239640ee329cf437ba0d 100644
--- a/composer.json
+++ b/composer.json
@@ -1,24 +1,24 @@
{
- "name": "wpdesk/wp-migrations",
- "type": "library",
+ "name": "wpdesk/wp-migrations",
+ "type": "library",
"description": "Doctrine Migrations clone suited for WordPress purposes.",
"license": "MIT",
- "authors": [
- {
- "name": "Bart Jaskulski",
- "email": "bartek.jaskulski@wpdesk.net"
- }
- ],
- "require": {
+ "authors": [
+ {
+ "name": "Bart Jaskulski",
+ "email": "bartek.jaskulski@wpdesk.net"
+ }
+ ],
+ "require": {
"php": "^7.1|^8",
- "ext-json": "*",
- "psr/log": "^1"
- },
- "autoload": {
- "psr-4": {
- "WPDesk\\Migrations\\": "src"
- }
- },
+ "ext-json": "*",
+ "psr/log": "^1"
+ },
+ "autoload": {
+ "psr-4": {
+ "WPDesk\\Migrations\\": "src"
+ }
+ },
"autoload-dev": {
"psr-4": {
"WPDesk\\Migrations\\Tests\\": "tests"
@@ -27,12 +27,10 @@
"tests/stubs"
]
},
- "require-dev": {
- "szepeviktor/phpstan-wordpress": "^1.1",
- "wpdesk/wp-code-sniffer": "^1.2",
- "phpstan/phpstan": "^1.10",
- "phpstan/extension-installer": "^1.3"
- },
+ "require-dev": {
+ "wpdesk/wp-code-sniffer": "^1.2",
+ "wpdesk/phpstan-rules": "^1"
+ },
"scripts": {
"style:fix": "phpcbf",
"test:phpstan": "phpstan --configuration=phpstan.neon.dist --memory-limit=-1 analyze",
@@ -44,10 +42,17 @@
"@test:phpunit"
]
},
- "config": {
- "allow-plugins": {
- "dealerdirect/phpcodesniffer-composer-installer": true,
- "phpstan/extension-installer": true
- }
- }
+ "config": {
+ "gitlab-domains": ["gitlab.wpdesk.dev"],
+ "allow-plugins": {
+ "dealerdirect/phpcodesniffer-composer-installer": true,
+ "phpstan/extension-installer": true
+ }
+ },
+ "repositories": {
+ "wpdesk": {
+ "type": "composer",
+ "url": "https://gitlab.wpdesk.dev/api/v4/group/wpdesk/-/packages/composer/"
+ }
+ }
}
diff --git a/composer.lock b/composer.lock
deleted file mode 100644
index d88aa037cf65978920d03624ab53a14f659506a0..0000000000000000000000000000000000000000
--- a/composer.lock
+++ /dev/null
@@ -1,910 +0,0 @@
-{
- "_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": "5cdb7792e111b0e3f0be5af431a13af4",
- "packages": [
- {
- "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"
- }
- ],
- "packages-dev": [
- {
- "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": "php-stubs/wordpress-stubs",
- "version": "v6.3.0",
- "source": {
- "type": "git",
- "url": "https://github.com/php-stubs/wordpress-stubs.git",
- "reference": "adda7609e71d5f4dc7b87c74f8ec9e3437d2e92c"
- },
- "dist": {
- "type": "zip",
- "url": "https://api.github.com/repos/php-stubs/wordpress-stubs/zipball/adda7609e71d5f4dc7b87c74f8ec9e3437d2e92c",
- "reference": "adda7609e71d5f4dc7b87c74f8ec9e3437d2e92c",
- "shasum": ""
- },
- "require-dev": {
- "nikic/php-parser": "^4.13",
- "php": "^7.4 || ~8.0.0",
- "php-stubs/generator": "^0.8.3",
- "phpdocumentor/reflection-docblock": "^5.3",
- "phpstan/phpstan": "^1.10.12",
- "phpunit/phpunit": "^9.5"
- },
- "suggest": {
- "paragonie/sodium_compat": "Pure PHP implementation of libsodium",
- "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.3.0"
- },
- "time": "2023-08-10T16:34:11+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.2",
- "source": {
- "type": "git",
- "url": "https://github.com/PHPCompatibility/PHPCompatibilityParagonie.git",
- "reference": "bba5a9dfec7fcfbd679cfaf611d86b4d3759da26"
- },
- "dist": {
- "type": "zip",
- "url": "https://api.github.com/repos/PHPCompatibility/PHPCompatibilityParagonie/zipball/bba5a9dfec7fcfbd679cfaf611d86b4d3759da26",
- "reference": "bba5a9dfec7fcfbd679cfaf611d86b4d3759da26",
- "shasum": ""
- },
- "require": {
- "phpcompatibility/php-compatibility": "^9.0"
- },
- "require-dev": {
- "dealerdirect/phpcodesniffer-composer-installer": "^0.7",
- "paragonie/random_compat": "dev-master",
- "paragonie/sodium_compat": "dev-master"
- },
- "suggest": {
- "dealerdirect/phpcodesniffer-composer-installer": "^0.7 || 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",
- "source": "https://github.com/PHPCompatibility/PHPCompatibilityParagonie"
- },
- "time": "2022-10-25T01:46:02+00:00"
- },
- {
- "name": "phpcompatibility/phpcompatibility-wp",
- "version": "2.1.4",
- "source": {
- "type": "git",
- "url": "https://github.com/PHPCompatibility/PHPCompatibilityWP.git",
- "reference": "b6c1e3ee1c35de6c41a511d5eb9bd03e447480a5"
- },
- "dist": {
- "type": "zip",
- "url": "https://api.github.com/repos/PHPCompatibility/PHPCompatibilityWP/zipball/b6c1e3ee1c35de6c41a511d5eb9bd03e447480a5",
- "reference": "b6c1e3ee1c35de6c41a511d5eb9bd03e447480a5",
- "shasum": ""
- },
- "require": {
- "phpcompatibility/php-compatibility": "^9.0",
- "phpcompatibility/phpcompatibility-paragonie": "^1.0"
- },
- "require-dev": {
- "dealerdirect/phpcodesniffer-composer-installer": "^0.7"
- },
- "suggest": {
- "dealerdirect/phpcodesniffer-composer-installer": "^0.7 || 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",
- "source": "https://github.com/PHPCompatibility/PHPCompatibilityWP"
- },
- "time": "2022-10-24T09:00:36+00:00"
- },
- {
- "name": "phpcsstandards/phpcsextra",
- "version": "1.1.2",
- "source": {
- "type": "git",
- "url": "https://github.com/PHPCSStandards/PHPCSExtra.git",
- "reference": "746c3190ba8eb2f212087c947ba75f4f5b9a58d5"
- },
- "dist": {
- "type": "zip",
- "url": "https://api.github.com/repos/PHPCSStandards/PHPCSExtra/zipball/746c3190ba8eb2f212087c947ba75f4f5b9a58d5",
- "reference": "746c3190ba8eb2f212087c947ba75f4f5b9a58d5",
- "shasum": ""
- },
- "require": {
- "php": ">=5.4",
- "phpcsstandards/phpcsutils": "^1.0.8",
- "squizlabs/php_codesniffer": "^3.7.1"
- },
- "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"
- },
- "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",
- "source": "https://github.com/PHPCSStandards/PHPCSExtra"
- },
- "time": "2023-09-20T22:06:18+00:00"
- },
- {
- "name": "phpcsstandards/phpcsutils",
- "version": "1.0.8",
- "source": {
- "type": "git",
- "url": "https://github.com/PHPCSStandards/PHPCSUtils.git",
- "reference": "69465cab9d12454e5e7767b9041af0cd8cd13be7"
- },
- "dist": {
- "type": "zip",
- "url": "https://api.github.com/repos/PHPCSStandards/PHPCSUtils/zipball/69465cab9d12454e5e7767b9041af0cd8cd13be7",
- "reference": "69465cab9d12454e5e7767b9041af0cd8cd13be7",
- "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.7.1 || 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.0.5 || ^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",
- "source": "https://github.com/PHPCSStandards/PHPCSUtils"
- },
- "time": "2023-07-16T21:39:41+00:00"
- },
- {
- "name": "phpstan/extension-installer",
- "version": "1.3.1",
- "source": {
- "type": "git",
- "url": "https://github.com/phpstan/extension-installer.git",
- "reference": "f45734bfb9984c6c56c4486b71230355f066a58a"
- },
- "dist": {
- "type": "zip",
- "url": "https://api.github.com/repos/phpstan/extension-installer/zipball/f45734bfb9984c6c56c4486b71230355f066a58a",
- "reference": "f45734bfb9984c6c56c4486b71230355f066a58a",
- "shasum": ""
- },
- "require": {
- "composer-plugin-api": "^2.0",
- "php": "^7.2 || ^8.0",
- "phpstan/phpstan": "^1.9.0"
- },
- "require-dev": {
- "composer/composer": "^2.0",
- "php-parallel-lint/php-parallel-lint": "^1.2.0",
- "phpstan/phpstan-strict-rules": "^0.11 || ^0.12 || ^1.0"
- },
- "type": "composer-plugin",
- "extra": {
- "class": "PHPStan\\ExtensionInstaller\\Plugin"
- },
- "autoload": {
- "psr-4": {
- "PHPStan\\ExtensionInstaller\\": "src/"
- }
- },
- "notification-url": "https://packagist.org/downloads/",
- "license": [
- "MIT"
- ],
- "description": "Composer plugin for automatic installation of PHPStan extensions",
- "support": {
- "issues": "https://github.com/phpstan/extension-installer/issues",
- "source": "https://github.com/phpstan/extension-installer/tree/1.3.1"
- },
- "time": "2023-05-24T08:59:17+00:00"
- },
- {
- "name": "phpstan/phpstan",
- "version": "1.10.37",
- "source": {
- "type": "git",
- "url": "https://github.com/phpstan/phpstan.git",
- "reference": "058ba07e92f744d4dcf6061ae75283d0c6456f2e"
- },
- "dist": {
- "type": "zip",
- "url": "https://api.github.com/repos/phpstan/phpstan/zipball/058ba07e92f744d4dcf6061ae75283d0c6456f2e",
- "reference": "058ba07e92f744d4dcf6061ae75283d0c6456f2e",
- "shasum": ""
- },
- "require": {
- "php": "^7.2|^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"
- },
- {
- "url": "https://tidelift.com/funding/github/packagist/phpstan/phpstan",
- "type": "tidelift"
- }
- ],
- "time": "2023-10-02T16:18:37+00:00"
- },
- {
- "name": "squizlabs/php_codesniffer",
- "version": "3.7.2",
- "source": {
- "type": "git",
- "url": "https://github.com/squizlabs/PHP_CodeSniffer.git",
- "reference": "ed8e00df0a83aa96acf703f8c2979ff33341f879"
- },
- "dist": {
- "type": "zip",
- "url": "https://api.github.com/repos/squizlabs/PHP_CodeSniffer/zipball/ed8e00df0a83aa96acf703f8c2979ff33341f879",
- "reference": "ed8e00df0a83aa96acf703f8c2979ff33341f879",
- "shasum": ""
- },
- "require": {
- "ext-simplexml": "*",
- "ext-tokenizer": "*",
- "ext-xmlwriter": "*",
- "php": ">=5.4.0"
- },
- "require-dev": {
- "phpunit/phpunit": "^4.0 || ^5.0 || ^6.0 || ^7.0"
- },
- "bin": [
- "bin/phpcs",
- "bin/phpcbf"
- ],
- "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": "lead"
- }
- ],
- "description": "PHP_CodeSniffer tokenizes PHP, JavaScript and CSS files and detects violations of a defined set of coding standards.",
- "homepage": "https://github.com/squizlabs/PHP_CodeSniffer",
- "keywords": [
- "phpcs",
- "standards",
- "static analysis"
- ],
- "support": {
- "issues": "https://github.com/squizlabs/PHP_CodeSniffer/issues",
- "source": "https://github.com/squizlabs/PHP_CodeSniffer",
- "wiki": "https://github.com/squizlabs/PHP_CodeSniffer/wiki"
- },
- "time": "2023-02-22T23:07:41+00:00"
- },
- {
- "name": "symfony/polyfill-php73",
- "version": "v1.28.0",
- "source": {
- "type": "git",
- "url": "https://github.com/symfony/polyfill-php73.git",
- "reference": "fe2f306d1d9d346a7fee353d0d5012e401e984b5"
- },
- "dist": {
- "type": "zip",
- "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/fe2f306d1d9d346a7fee353d0d5012e401e984b5",
- "reference": "fe2f306d1d9d346a7fee353d0d5012e401e984b5",
- "shasum": ""
- },
- "require": {
- "php": ">=7.1"
- },
- "type": "library",
- "extra": {
- "branch-alias": {
- "dev-main": "1.28-dev"
- },
- "thanks": {
- "name": "symfony/polyfill",
- "url": "https://github.com/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.28.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": "2023-01-26T09:26:14+00:00"
- },
- {
- "name": "szepeviktor/phpstan-wordpress",
- "version": "v1.3.0",
- "source": {
- "type": "git",
- "url": "https://github.com/szepeviktor/phpstan-wordpress.git",
- "reference": "5b5cc77ed51fdaf64efe3f00b5aae4b709d2cfa9"
- },
- "dist": {
- "type": "zip",
- "url": "https://api.github.com/repos/szepeviktor/phpstan-wordpress/zipball/5b5cc77ed51fdaf64efe3f00b5aae4b709d2cfa9",
- "reference": "5b5cc77ed51fdaf64efe3f00b5aae4b709d2cfa9",
- "shasum": ""
- },
- "require": {
- "php": "^7.2 || ^8.0",
- "php-stubs/wordpress-stubs": "^4.7 || ^5.0 || ^6.0",
- "phpstan/phpstan": "^1.10.0",
- "symfony/polyfill-php73": "^1.12.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": "^1.2",
- "phpunit/phpunit": "^8.0 || ^9.0",
- "szepeviktor/phpcs-psr-12-neutron-hybrid-ruleset": "^0.8"
- },
- "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/v1.3.0"
- },
- "time": "2023-04-23T06:15:06+00:00"
- },
- {
- "name": "wp-coding-standards/wpcs",
- "version": "3.0.1",
- "source": {
- "type": "git",
- "url": "https://github.com/WordPress/WordPress-Coding-Standards.git",
- "reference": "b4caf9689f1a0e4a4c632679a44e638c1c67aff1"
- },
- "dist": {
- "type": "zip",
- "url": "https://api.github.com/repos/WordPress/WordPress-Coding-Standards/zipball/b4caf9689f1a0e4a4c632679a44e638c1c67aff1",
- "reference": "b4caf9689f1a0e4a4c632679a44e638c1c67aff1",
- "shasum": ""
- },
- "require": {
- "ext-filter": "*",
- "ext-libxml": "*",
- "ext-tokenizer": "*",
- "ext-xmlreader": "*",
- "php": ">=5.4",
- "phpcsstandards/phpcsextra": "^1.1.0",
- "phpcsstandards/phpcsutils": "^1.0.8",
- "squizlabs/php_codesniffer": "^3.7.2"
- },
- "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"
- },
- "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/thewpcc/contribute/wp-php-63406",
- "type": "custom"
- }
- ],
- "time": "2023-09-14T07:06:09+00:00"
- },
- {
- "name": "wpdesk/wp-code-sniffer",
- "version": "1.2.8",
- "source": {
- "type": "git",
- "url": "https://gitlab.wpdesk.dev/wpdesk/wp-code-sniffer",
- "reference": "6ba84cfac401d7e6b26fd3bcd17aa12a9447b075"
- },
- "require": {
- "php": ">=7.0",
- "phpcompatibility/phpcompatibility-wp": "^2.1.1",
- "squizlabs/php_codesniffer": "^3.6",
- "wp-coding-standards/wpcs": "^3"
- },
- "require-dev": {
- "roave/security-advisories": "dev-latest"
- },
- "type": "phpcodesniffer-standard",
- "notification-url": "https://packagist.org/downloads/",
- "license": [
- "MIT"
- ],
- "authors": [
- {
- "name": "grola",
- "email": "grola@wpdesk.net"
- }
- ],
- "description": "Library for WP Desk Coding Standards in plugins.",
- "homepage": "https://gitlab.com/wpdesk/wp-code-sniffer",
- "keywords": [
- "admin",
- "code sniffer",
- "phpcs",
- "wordpress"
- ],
- "time": "2023-09-14T07:53:00+00:00"
- }
- ],
- "aliases": [],
- "minimum-stability": "stable",
- "stability-flags": [],
- "prefer-stable": false,
- "prefer-lowest": false,
- "platform": {
- "php": "^7.1|^8",
- "ext-json": "*"
- },
- "platform-dev": [],
- "plugin-api-version": "2.6.0"
-}
diff --git a/src/AbstractMigration.php b/src/AbstractMigration.php
index 7a827027b656318e3b28e7148df98d3c90f33c7a..a83514d98901369c90a2808d34b04c3d50efe46a 100644
--- a/src/AbstractMigration.php
+++ b/src/AbstractMigration.php
@@ -20,5 +20,12 @@ abstract class AbstractMigration {
abstract public function up(): bool;
- public function down(): void {}
+ /**
+ * Allow to skip migration if it is not needed. Tracking of migration version just by wp_options
+ * value may be subject to random issues, so as a backup, this method can be used to avoid
+ * errornous migrations like creating alredy exising columns.
+ */
+ public function is_needed(): bool {
+ return true;
+ }
}
diff --git a/src/AbstractMigrationsRepository.php b/src/AbstractMigrationsRepository.php
index d4eb634b74c54ccd681668cdd215867ea90106aa..7ed454597ebd52c3be2c09b44b5a31b1657f2333 100644
--- a/src/AbstractMigrationsRepository.php
+++ b/src/AbstractMigrationsRepository.php
@@ -34,6 +34,7 @@ abstract class AbstractMigrationsRepository implements MigrationsRepository {
$this->migrations_source = $migrations_source;
}
+ /** @param class-string<AbstractMigration> $migration_class_name */
public function register_migration( string $migration_class_name ): void {
$migration = $this->version_factory->create_version( $migration_class_name );
$version = new Version( $migration_class_name );
diff --git a/src/ArrayMigrationsRepository.php b/src/ArrayMigrationsRepository.php
index 531b3125c315fbe31e86536345e830964e578b83..05e42450e63819ecb4ccaef07b1569f423633fcc 100644
--- a/src/ArrayMigrationsRepository.php
+++ b/src/ArrayMigrationsRepository.php
@@ -6,6 +6,7 @@ namespace WPDesk\Migrations;
class ArrayMigrationsRepository extends AbstractMigrationsRepository {
protected function load_migrations(): void {
+ /** @var class-string<AbstractMigration> $class */
foreach ( $this->migrations_source as $class ) {
$this->register_migration( $class );
}
diff --git a/src/FilesystemMigrationsRepository.php b/src/FilesystemMigrationsRepository.php
index 83d1f017de89ff36b0e419f274ac0aa98880098e..b3b91c25abfa0c037ce9a8d9f19373d3cc5e3e3d 100644
--- a/src/FilesystemMigrationsRepository.php
+++ b/src/FilesystemMigrationsRepository.php
@@ -28,7 +28,7 @@ final class FilesystemMigrationsRepository extends AbstractMigrationsRepository
$this->migration_finder = $migration_finder;
}
- /** @param string[] $migrations */
+ /** @param class-string<AbstractMigration>[] $migrations */
private function register_migrations( array $migrations ): void {
foreach ( $migrations as $migration ) {
$this->register_migration( $migration );
diff --git a/src/Finder/GlobFinder.php b/src/Finder/GlobFinder.php
index a1ba30049adaa6364cd5d5afd3d5bb00ea019889..69c868ba92e84242a2cfcee21a518fd875e2a219 100644
--- a/src/Finder/GlobFinder.php
+++ b/src/Finder/GlobFinder.php
@@ -33,7 +33,7 @@ final class GlobFinder implements MigrationFinder {
foreach ( $files as $file ) {
require_once $file;
$real_file = realpath( $file );
- if ( ! $real_file ) {
+ if ( $real_file === false ) {
continue;
}
$included_files[] = $real_file;
diff --git a/src/MigrationsRepository.php b/src/MigrationsRepository.php
index 72e38178612a41c9d7c3f517937cd9516ee174e6..119cd35becc813b198789c4911c9a05f4756ff2f 100644
--- a/src/MigrationsRepository.php
+++ b/src/MigrationsRepository.php
@@ -2,12 +2,11 @@
namespace WPDesk\Migrations;
-use WPDesk\Migrations\Version\Version;
-
interface MigrationsRepository {
/** @return iterable<AvailableMigration> */
public function get_migrations(): iterable;
+ /** @param class-string<AbstractMigration> $migration_class_name */
public function register_migration( string $migration_class_name ): void;
}
diff --git a/src/Version/MigrationFactory.php b/src/Version/MigrationFactory.php
index 5c0827922f2b0572573d4d55ab5b53fa2984c1c9..397ef78740bf4174f197f21ee5c6b8b74b0c7972 100644
--- a/src/Version/MigrationFactory.php
+++ b/src/Version/MigrationFactory.php
@@ -6,5 +6,6 @@ use WPDesk\Migrations\AbstractMigration;
interface MigrationFactory {
+ /** @param class-string<AbstractMigration> $migration_class */
public function create_version( string $migration_class ): AbstractMigration;
}
diff --git a/src/WpdbLogger.php b/src/WpdbLogger.php
index 47119c0d76e99f3d4defc5f144ef208e9fb9156c..f15b8211e084d4fa3ffaf5a0222f46efcfff36b5 100644
--- a/src/WpdbLogger.php
+++ b/src/WpdbLogger.php
@@ -20,8 +20,8 @@ class WpdbLogger implements \Psr\Log\LoggerInterface {
$this->log_name = $log_name;
}
- public function log( $level, $message, array $context = [] ) {
- if ( empty( $this->log ) ) {
+ public function log( $level, $message, array $context = [] ): void {
+ if ( count( $this->log ) === 0 ) {
$this->log = json_decode(
get_option(
$this->log_name,
diff --git a/src/WpdbMigrator.php b/src/WpdbMigrator.php
index d35821f4cda842760a14c975ba08e5f478e88075..33b40dc4a8c9a8a7a6981fcca683042d6fe51751 100644
--- a/src/WpdbMigrator.php
+++ b/src/WpdbMigrator.php
@@ -94,7 +94,7 @@ class WpdbMigrator implements Migrator {
if ( $last_migration === false ) {
return false;
}
- if ( $this->comparator->compare( $last_migration->get_version(), $this->get_current_version() ) ) {
+ if ( $this->comparator->compare( $last_migration->get_version(), $this->get_current_version() ) > 0 ) {
return true;
}
return false;
@@ -133,7 +133,12 @@ class WpdbMigrator implements Migrator {
$this->logger->info( sprintf( 'DB update %s:%s', $current_version, $migration->get_version() ) );
- $success = $migration->get_migration()->up();
+ $success = null;
+ if ( $migration->get_migration()->is_needed() ) {
+ $success = $migration->get_migration()->up();
+ } else {
+ $success = true;
+ }
if ( $success ) {
$this->logger->info( sprintf( 'DB update %s:%s -> ', $current_version, $migration->get_version() ) . 'OK' );