diff options
Diffstat (limited to 'build')
82 files changed, 7071 insertions, 3004 deletions
diff --git a/build/autoloaderchecker.sh b/build/autoloaderchecker.sh index 7d8fd98cd60..75db26f07ce 100755 --- a/build/autoloaderchecker.sh +++ b/build/autoloaderchecker.sh @@ -34,6 +34,13 @@ echo echo "Regenerating main autoloader" $COMPOSER_COMMAND dump-autoload -d $REPODIR +FOUND_COMPOSER_BIN=$(grep --recursive --fixed-strings 'Bamarni\\Composer\\Bin' $REPODIR/lib/composer/composer/) +if [ -n "$FOUND_COMPOSER_BIN" ]; then + echo "The main autoloader contains the composer bin plugin" + echo "Run composer again with --no-dev and commit the result" + exit 1 +fi + for app in ${REPODIR}/apps/*; do if git check-ignore ${app} -q ; then echo diff --git a/build/buildjsdocs.sh b/build/buildjsdocs.sh deleted file mode 100755 index e40ecd7242b..00000000000 --- a/build/buildjsdocs.sh +++ /dev/null @@ -1,40 +0,0 @@ -#!/usr/bin/env bash -# -# SPDX-FileCopyrightText: 2018 Nextcloud GmbH and Nextcloud contributors -# SPDX-FileCopyrightText: 2014-2015 ownCloud, Inc. -# SPDX-License-Identifier: AGPL-3.0-only -# -# Run JS tests -# -NPM="$(which npm 2>/dev/null)" -OUTPUT_DIR="jsdocs" - -JS_FILES="../core/js/*.js ../core/js/**/*.js ../apps/*/js/*.js" - -if test -z "$NPM" -then - echo 'Node JS >= 0.8 is required to build the documentation' >&2 - exit 1 -fi - -# update/install test packages -$NPM install --prefix . --link jsdoc || exit 3 - -JSDOC_BIN="$(which jsdoc 2>/dev/null)" - -# If not installed globally, try local version -if test -z "$JSDOC_BIN" -then - JSDOC_BIN="./node_modules/jsdoc/jsdoc.js" -fi - -if test -z "$JSDOC_BIN" -then - echo 'jsdoc executable not found' >&2 - exit 2 -fi - -mkdir -p "$OUTPUT_DIR" - -NODE_PATH="./node_modules" $JSDOC_BIN -d "$OUTPUT_DIR" $JS_FILES - diff --git a/build/ca-bundle-etag.txt b/build/ca-bundle-etag.txt index 31d064a95ab..ba96dde8437 100644 --- a/build/ca-bundle-etag.txt +++ b/build/ca-bundle-etag.txt @@ -1 +1 @@ -"3872c-62a8921bd828d" +"366fb-639ef23dca9b2" diff --git a/build/files-checker.php b/build/files-checker.php index 3231334efc3..08d9acf2fd8 100644 --- a/build/files-checker.php +++ b/build/files-checker.php @@ -1,4 +1,6 @@ <?php + +declare(strict_types=1); /** * SPDX-FileCopyrightText: 2017 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later @@ -9,6 +11,7 @@ $expectedFiles = [ '..', '.devcontainer', '.editorconfig', + '.envrc', '.eslintignore', '.eslintrc.js', '.git', @@ -24,8 +27,6 @@ $expectedFiles = [ '.npmignore', '.php-cs-fixer.dist.php', '.pre-commit-config.yaml', - '.reuse', - '.scrutinizer.yml', '.tag', '.tx', '.user.ini', @@ -40,6 +41,7 @@ $expectedFiles = [ 'DESIGN.md', 'Makefile', 'README.md', + 'REUSE.toml', 'SECURITY.md', 'apps', 'autotest-checkers.sh', @@ -60,6 +62,8 @@ $expectedFiles = [ 'cypress.d.ts', 'cypress', 'dist', + 'flake.lock', + 'flake.nix', 'index.html', 'index.php', 'lib', @@ -67,6 +71,7 @@ $expectedFiles = [ 'occ', 'ocs', 'ocs-provider', + 'openapi.json', 'package-lock.json', 'package.json', 'psalm-ncu.xml', @@ -83,7 +88,7 @@ $expectedFiles = [ 'tsconfig.json', 'vendor-bin', 'version.php', - 'vitest.config.ts', + 'vitest.config.mts', 'webpack.common.js', 'webpack.config.js', 'webpack.modules.js', diff --git a/build/gen-coverage-badge.php b/build/gen-coverage-badge.php index 73d2a37e025..602ab83b281 100644 --- a/build/gen-coverage-badge.php +++ b/build/gen-coverage-badge.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2020 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. diff --git a/build/htaccess-checker.php b/build/htaccess-checker.php index b0c7a1bd735..963b3edb34b 100644 --- a/build/htaccess-checker.php +++ b/build/htaccess-checker.php @@ -1,4 +1,6 @@ <?php + +declare(strict_types=1); /** * SPDX-FileCopyrightText: 2016 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later diff --git a/build/integration/composer.lock b/build/integration/composer.lock index 64678c07151..cc8427c78eb 100644 --- a/build/integration/composer.lock +++ b/build/integration/composer.lock @@ -9,23 +9,24 @@ "packages-dev": [ { "name": "behat/behat", - "version": "v3.16.0", + "version": "v3.23.0", "source": { "type": "git", "url": "https://github.com/Behat/Behat.git", - "reference": "18f5f44c80d1cf5711ec27019afcb26b8bc6c3b0" + "reference": "c465af8756adaaa6d962c3176a0a6c594361809b" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/Behat/Behat/zipball/18f5f44c80d1cf5711ec27019afcb26b8bc6c3b0", - "reference": "18f5f44c80d1cf5711ec27019afcb26b8bc6c3b0", + "url": "https://api.github.com/repos/Behat/Behat/zipball/c465af8756adaaa6d962c3176a0a6c594361809b", + "reference": "c465af8756adaaa6d962c3176a0a6c594361809b", "shasum": "" }, "require": { - "behat/gherkin": "^4.10.0", - "behat/transliterator": "^1.5", + "behat/gherkin": "^4.12.0", "composer-runtime-api": "^2.2", + "composer/xdebug-handler": "^1.4 || ^2.0 || ^3.0", "ext-mbstring": "*", + "nikic/php-parser": "^4.19.2 || ^5.2", "php": "8.1.* || 8.2.* || 8.3.* || 8.4.* ", "psr/container": "^1.0 || ^2.0", "symfony/config": "^5.4 || ^6.4 || ^7.0", @@ -36,11 +37,13 @@ "symfony/yaml": "^5.4 || ^6.4 || ^7.0" }, "require-dev": { - "herrera-io/box": "~1.6.1", + "friendsofphp/php-cs-fixer": "^3.68", + "phpstan/phpstan": "^2.0", "phpunit/phpunit": "^9.6", + "rector/rector": "^2.0", + "sebastian/diff": "^4.0", "symfony/polyfill-php84": "^1.31", - "symfony/process": "^5.4 || ^6.4 || ^7.0", - "vimeo/psalm": "^4.8" + "symfony/process": "^5.4 || ^6.4 || ^7.0" }, "suggest": { "ext-dom": "Needed to output test results in JUnit format." @@ -59,7 +62,9 @@ "Behat\\Hook\\": "src/Behat/Hook/", "Behat\\Step\\": "src/Behat/Step/", "Behat\\Behat\\": "src/Behat/Behat/", - "Behat\\Testwork\\": "src/Behat/Testwork/" + "Behat\\Config\\": "src/Behat/Config/", + "Behat\\Testwork\\": "src/Behat/Testwork/", + "Behat\\Transformation\\": "src/Behat/Transformation/" } }, "notification-url": "https://packagist.org/downloads/", @@ -91,31 +96,37 @@ ], "support": { "issues": "https://github.com/Behat/Behat/issues", - "source": "https://github.com/Behat/Behat/tree/v3.16.0" + "source": "https://github.com/Behat/Behat/tree/v3.23.0" }, - "time": "2024-11-08T12:25:17+00:00" + "time": "2025-07-15T16:58:54+00:00" }, { "name": "behat/gherkin", - "version": "v4.10.0", + "version": "v4.14.0", "source": { "type": "git", "url": "https://github.com/Behat/Gherkin.git", - "reference": "cbb83c4c435dd8d05a161f2a5ae322e61b2f4db6" + "reference": "34c9b59c59355a7b4c53b9f041c8dbd1c8acc3b4" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/Behat/Gherkin/zipball/cbb83c4c435dd8d05a161f2a5ae322e61b2f4db6", - "reference": "cbb83c4c435dd8d05a161f2a5ae322e61b2f4db6", + "url": "https://api.github.com/repos/Behat/Gherkin/zipball/34c9b59c59355a7b4c53b9f041c8dbd1c8acc3b4", + "reference": "34c9b59c59355a7b4c53b9f041c8dbd1c8acc3b4", "shasum": "" }, "require": { - "php": "~7.2|~8.0" + "composer-runtime-api": "^2.2", + "php": "8.1.* || 8.2.* || 8.3.* || 8.4.*" }, "require-dev": { - "cucumber/cucumber": "dev-gherkin-24.1.0", - "phpunit/phpunit": "~8|~9", - "symfony/yaml": "~3|~4|~5|~6|~7" + "cucumber/gherkin-monorepo": "dev-gherkin-v32.1.1", + "friendsofphp/php-cs-fixer": "^3.65", + "mikey179/vfsstream": "^1.6", + "phpstan/extension-installer": "^1", + "phpstan/phpstan": "^2", + "phpstan/phpstan-phpunit": "^2", + "phpunit/phpunit": "^10.5", + "symfony/yaml": "^5.4 || ^6.4 || ^7.0" }, "suggest": { "symfony/yaml": "If you want to parse features, represented in YAML files" @@ -127,8 +138,8 @@ } }, "autoload": { - "psr-0": { - "Behat\\Gherkin": "src/" + "psr-4": { + "Behat\\Gherkin\\": "src/" } }, "notification-url": "https://packagist.org/downloads/", @@ -139,11 +150,11 @@ { "name": "Konstantin Kudryashov", "email": "ever.zet@gmail.com", - "homepage": "http://everzet.com" + "homepage": "https://everzet.com" } ], "description": "Gherkin DSL parser for PHP", - "homepage": "http://behat.org/", + "homepage": "https://behat.org/", "keywords": [ "BDD", "Behat", @@ -154,58 +165,154 @@ ], "support": { "issues": "https://github.com/Behat/Gherkin/issues", - "source": "https://github.com/Behat/Gherkin/tree/v4.10.0" + "source": "https://github.com/Behat/Gherkin/tree/v4.14.0" }, - "time": "2024-10-19T14:46:06+00:00" + "time": "2025-05-23T15:06:40+00:00" }, { - "name": "behat/transliterator", - "version": "v1.5.0", + "name": "composer/pcre", + "version": "3.3.2", "source": { "type": "git", - "url": "https://github.com/Behat/Transliterator.git", - "reference": "baac5873bac3749887d28ab68e2f74db3a4408af" + "url": "https://github.com/composer/pcre.git", + "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/Behat/Transliterator/zipball/baac5873bac3749887d28ab68e2f74db3a4408af", - "reference": "baac5873bac3749887d28ab68e2f74db3a4408af", + "url": "https://api.github.com/repos/composer/pcre/zipball/b2bed4734f0cc156ee1fe9c0da2550420d99a21e", + "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e", "shasum": "" }, "require": { - "php": ">=7.2" + "php": "^7.4 || ^8.0" + }, + "conflict": { + "phpstan/phpstan": "<1.11.10" }, "require-dev": { - "chuyskywalker/rolling-curl": "^3.1", - "php-yaoi/php-yaoi": "^1.0", - "phpunit/phpunit": "^8.5.25 || ^9.5.19" + "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-master": "1.x-dev" + "dev-main": "3.x-dev" } }, "autoload": { "psr-4": { - "Behat\\Transliterator\\": "src/Behat/Transliterator" + "Composer\\Pcre\\": "src" } }, "notification-url": "https://packagist.org/downloads/", "license": [ - "Artistic-1.0" + "MIT" ], - "description": "String transliterator", + "authors": [ + { + "name": "Jordi Boggiano", + "email": "j.boggiano@seld.be", + "homepage": "http://seld.be" + } + ], + "description": "PCRE wrapping library that offers type-safe preg_* replacements.", "keywords": [ - "i18n", - "slug", - "transliterator" + "PCRE", + "preg", + "regex", + "regular expression" ], "support": { - "issues": "https://github.com/Behat/Transliterator/issues", - "source": "https://github.com/Behat/Transliterator/tree/v1.5.0" + "issues": "https://github.com/composer/pcre/issues", + "source": "https://github.com/composer/pcre/tree/3.3.2" }, - "time": "2022-03-30T09:27:43+00:00" + "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/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": "dms/phpunit-arraysubset-asserts", @@ -323,16 +430,16 @@ }, { "name": "guzzlehttp/guzzle", - "version": "7.9.2", + "version": "7.9.3", "source": { "type": "git", "url": "https://github.com/guzzle/guzzle.git", - "reference": "d281ed313b989f213357e3be1a179f02196ac99b" + "reference": "7b2f29fe81dc4da0ca0ea7d42107a0845946ea77" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/guzzle/guzzle/zipball/d281ed313b989f213357e3be1a179f02196ac99b", - "reference": "d281ed313b989f213357e3be1a179f02196ac99b", + "url": "https://api.github.com/repos/guzzle/guzzle/zipball/7b2f29fe81dc4da0ca0ea7d42107a0845946ea77", + "reference": "7b2f29fe81dc4da0ca0ea7d42107a0845946ea77", "shasum": "" }, "require": { @@ -429,7 +536,7 @@ ], "support": { "issues": "https://github.com/guzzle/guzzle/issues", - "source": "https://github.com/guzzle/guzzle/tree/7.9.2" + "source": "https://github.com/guzzle/guzzle/tree/7.9.3" }, "funding": [ { @@ -445,20 +552,20 @@ "type": "tidelift" } ], - "time": "2024-07-24T11:22:20+00:00" + "time": "2025-03-27T13:37:11+00:00" }, { "name": "guzzlehttp/promises", - "version": "2.0.4", + "version": "2.2.0", "source": { "type": "git", "url": "https://github.com/guzzle/promises.git", - "reference": "f9c436286ab2892c7db7be8c8da4ef61ccf7b455" + "reference": "7c69f28996b0a6920945dd20b3857e499d9ca96c" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/guzzle/promises/zipball/f9c436286ab2892c7db7be8c8da4ef61ccf7b455", - "reference": "f9c436286ab2892c7db7be8c8da4ef61ccf7b455", + "url": "https://api.github.com/repos/guzzle/promises/zipball/7c69f28996b0a6920945dd20b3857e499d9ca96c", + "reference": "7c69f28996b0a6920945dd20b3857e499d9ca96c", "shasum": "" }, "require": { @@ -512,7 +619,7 @@ ], "support": { "issues": "https://github.com/guzzle/promises/issues", - "source": "https://github.com/guzzle/promises/tree/2.0.4" + "source": "https://github.com/guzzle/promises/tree/2.2.0" }, "funding": [ { @@ -528,20 +635,20 @@ "type": "tidelift" } ], - "time": "2024-10-17T10:06:22+00:00" + "time": "2025-03-27T13:27:01+00:00" }, { "name": "guzzlehttp/psr7", - "version": "2.7.0", + "version": "2.7.1", "source": { "type": "git", "url": "https://github.com/guzzle/psr7.git", - "reference": "a70f5c95fb43bc83f07c9c948baa0dc1829bf201" + "reference": "c2270caaabe631b3b44c85f99e5a04bbb8060d16" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/guzzle/psr7/zipball/a70f5c95fb43bc83f07c9c948baa0dc1829bf201", - "reference": "a70f5c95fb43bc83f07c9c948baa0dc1829bf201", + "url": "https://api.github.com/repos/guzzle/psr7/zipball/c2270caaabe631b3b44c85f99e5a04bbb8060d16", + "reference": "c2270caaabe631b3b44c85f99e5a04bbb8060d16", "shasum": "" }, "require": { @@ -628,7 +735,7 @@ ], "support": { "issues": "https://github.com/guzzle/psr7/issues", - "source": "https://github.com/guzzle/psr7/tree/2.7.0" + "source": "https://github.com/guzzle/psr7/tree/2.7.1" }, "funding": [ { @@ -644,7 +751,7 @@ "type": "tidelift" } ], - "time": "2024-07-18T11:15:46+00:00" + "time": "2025-03-27T12:30:47+00:00" }, { "name": "myclabs/deep-copy", @@ -708,16 +815,16 @@ }, { "name": "nikic/php-parser", - "version": "v5.3.1", + "version": "v5.5.0", "source": { "type": "git", "url": "https://github.com/nikic/PHP-Parser.git", - "reference": "8eea230464783aa9671db8eea6f8c6ac5285794b" + "reference": "ae59794362fe85e051a58ad36b289443f57be7a9" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/8eea230464783aa9671db8eea6f8c6ac5285794b", - "reference": "8eea230464783aa9671db8eea6f8c6ac5285794b", + "url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/ae59794362fe85e051a58ad36b289443f57be7a9", + "reference": "ae59794362fe85e051a58ad36b289443f57be7a9", "shasum": "" }, "require": { @@ -760,9 +867,9 @@ ], "support": { "issues": "https://github.com/nikic/PHP-Parser/issues", - "source": "https://github.com/nikic/PHP-Parser/tree/v5.3.1" + "source": "https://github.com/nikic/PHP-Parser/tree/v5.5.0" }, - "time": "2024-10-08T18:51:32+00:00" + "time": "2025-05-31T08:24:38+00:00" }, { "name": "phar-io/manifest", @@ -3071,16 +3178,16 @@ }, { "name": "symfony/config", - "version": "v6.4.14", + "version": "v6.4.22", "source": { "type": "git", "url": "https://github.com/symfony/config.git", - "reference": "4e55e7e4ffddd343671ea972216d4509f46c22ef" + "reference": "af5917a3b1571f54689e56677a3f06440d2fe4c7" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/config/zipball/4e55e7e4ffddd343671ea972216d4509f46c22ef", - "reference": "4e55e7e4ffddd343671ea972216d4509f46c22ef", + "url": "https://api.github.com/repos/symfony/config/zipball/af5917a3b1571f54689e56677a3f06440d2fe4c7", + "reference": "af5917a3b1571f54689e56677a3f06440d2fe4c7", "shasum": "" }, "require": { @@ -3126,7 +3233,7 @@ "description": "Helps you find, load, combine, autofill and validate configuration values of any kind", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/config/tree/v6.4.14" + "source": "https://github.com/symfony/config/tree/v6.4.22" }, "funding": [ { @@ -3142,20 +3249,20 @@ "type": "tidelift" } ], - "time": "2024-11-04T11:33:53+00:00" + "time": "2025-05-14T06:00:01+00:00" }, { "name": "symfony/console", - "version": "v6.4.14", + "version": "v6.4.23", "source": { "type": "git", "url": "https://github.com/symfony/console.git", - "reference": "897c2441ed4eec8a8a2c37b943427d24dba3f26b" + "reference": "9056771b8eca08d026cd3280deeec3cfd99c4d93" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/console/zipball/897c2441ed4eec8a8a2c37b943427d24dba3f26b", - "reference": "897c2441ed4eec8a8a2c37b943427d24dba3f26b", + "url": "https://api.github.com/repos/symfony/console/zipball/9056771b8eca08d026cd3280deeec3cfd99c4d93", + "reference": "9056771b8eca08d026cd3280deeec3cfd99c4d93", "shasum": "" }, "require": { @@ -3220,7 +3327,7 @@ "terminal" ], "support": { - "source": "https://github.com/symfony/console/tree/v6.4.14" + "source": "https://github.com/symfony/console/tree/v6.4.23" }, "funding": [ { @@ -3236,20 +3343,20 @@ "type": "tidelift" } ], - "time": "2024-11-05T15:34:40+00:00" + "time": "2025-06-27T19:37:22+00:00" }, { "name": "symfony/dependency-injection", - "version": "v6.4.13", + "version": "v6.4.23", "source": { "type": "git", "url": "https://github.com/symfony/dependency-injection.git", - "reference": "728ae8f4e190133ce99d6d5f0bc1e8c8bd7c7a96" + "reference": "0d9f24f3de0a83573fce5c9ed025d6306c6e166b" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/dependency-injection/zipball/728ae8f4e190133ce99d6d5f0bc1e8c8bd7c7a96", - "reference": "728ae8f4e190133ce99d6d5f0bc1e8c8bd7c7a96", + "url": "https://api.github.com/repos/symfony/dependency-injection/zipball/0d9f24f3de0a83573fce5c9ed025d6306c6e166b", + "reference": "0d9f24f3de0a83573fce5c9ed025d6306c6e166b", "shasum": "" }, "require": { @@ -3257,7 +3364,7 @@ "psr/container": "^1.1|^2.0", "symfony/deprecation-contracts": "^2.5|^3", "symfony/service-contracts": "^2.5|^3.0", - "symfony/var-exporter": "^6.2.10|^7.0" + "symfony/var-exporter": "^6.4.20|^7.2.5" }, "conflict": { "ext-psr": "<1.1|>=2", @@ -3301,7 +3408,7 @@ "description": "Allows you to standardize and centralize the way objects are constructed in your application", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/dependency-injection/tree/v6.4.13" + "source": "https://github.com/symfony/dependency-injection/tree/v6.4.23" }, "funding": [ { @@ -3317,20 +3424,20 @@ "type": "tidelift" } ], - "time": "2024-10-25T15:07:50+00:00" + "time": "2025-06-23T06:49:06+00:00" }, { "name": "symfony/deprecation-contracts", - "version": "v3.5.0", + "version": "v3.6.0", "source": { "type": "git", "url": "https://github.com/symfony/deprecation-contracts.git", - "reference": "0e0d29ce1f20deffb4ab1b016a7257c4f1e789a1" + "reference": "63afe740e99a13ba87ec199bb07bbdee937a5b62" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/0e0d29ce1f20deffb4ab1b016a7257c4f1e789a1", - "reference": "0e0d29ce1f20deffb4ab1b016a7257c4f1e789a1", + "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/63afe740e99a13ba87ec199bb07bbdee937a5b62", + "reference": "63afe740e99a13ba87ec199bb07bbdee937a5b62", "shasum": "" }, "require": { @@ -3338,12 +3445,12 @@ }, "type": "library", "extra": { - "branch-alias": { - "dev-main": "3.5-dev" - }, "thanks": { - "name": "symfony/contracts", - "url": "https://github.com/symfony/contracts" + "url": "https://github.com/symfony/contracts", + "name": "symfony/contracts" + }, + "branch-alias": { + "dev-main": "3.6-dev" } }, "autoload": { @@ -3368,7 +3475,7 @@ "description": "A generic function and convention to trigger deprecation notices", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/deprecation-contracts/tree/v3.5.0" + "source": "https://github.com/symfony/deprecation-contracts/tree/v3.6.0" }, "funding": [ { @@ -3384,7 +3491,7 @@ "type": "tidelift" } ], - "time": "2024-04-18T09:32:20+00:00" + "time": "2024-09-25T14:21:43+00:00" }, { "name": "symfony/event-dispatcher", @@ -3468,16 +3575,16 @@ }, { "name": "symfony/event-dispatcher-contracts", - "version": "v3.5.0", + "version": "v3.6.0", "source": { "type": "git", "url": "https://github.com/symfony/event-dispatcher-contracts.git", - "reference": "8f93aec25d41b72493c6ddff14e916177c9efc50" + "reference": "59eb412e93815df44f05f342958efa9f46b1e586" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/event-dispatcher-contracts/zipball/8f93aec25d41b72493c6ddff14e916177c9efc50", - "reference": "8f93aec25d41b72493c6ddff14e916177c9efc50", + "url": "https://api.github.com/repos/symfony/event-dispatcher-contracts/zipball/59eb412e93815df44f05f342958efa9f46b1e586", + "reference": "59eb412e93815df44f05f342958efa9f46b1e586", "shasum": "" }, "require": { @@ -3486,12 +3593,12 @@ }, "type": "library", "extra": { - "branch-alias": { - "dev-main": "3.5-dev" - }, "thanks": { - "name": "symfony/contracts", - "url": "https://github.com/symfony/contracts" + "url": "https://github.com/symfony/contracts", + "name": "symfony/contracts" + }, + "branch-alias": { + "dev-main": "3.6-dev" } }, "autoload": { @@ -3524,7 +3631,7 @@ "standards" ], "support": { - "source": "https://github.com/symfony/event-dispatcher-contracts/tree/v3.5.0" + "source": "https://github.com/symfony/event-dispatcher-contracts/tree/v3.6.0" }, "funding": [ { @@ -3540,7 +3647,7 @@ "type": "tidelift" } ], - "time": "2024-04-18T09:32:20+00:00" + "time": "2024-09-25T14:21:43+00:00" }, { "name": "symfony/filesystem", @@ -3610,7 +3717,7 @@ }, { "name": "symfony/polyfill-ctype", - "version": "v1.31.0", + "version": "v1.32.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-ctype.git", @@ -3634,8 +3741,8 @@ "type": "library", "extra": { "thanks": { - "name": "symfony/polyfill", - "url": "https://github.com/symfony/polyfill" + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" } }, "autoload": { @@ -3669,7 +3776,7 @@ "portable" ], "support": { - "source": "https://github.com/symfony/polyfill-ctype/tree/v1.31.0" + "source": "https://github.com/symfony/polyfill-ctype/tree/v1.32.0" }, "funding": [ { @@ -3689,7 +3796,7 @@ }, { "name": "symfony/polyfill-intl-grapheme", - "version": "v1.31.0", + "version": "v1.32.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-intl-grapheme.git", @@ -3710,8 +3817,8 @@ "type": "library", "extra": { "thanks": { - "name": "symfony/polyfill", - "url": "https://github.com/symfony/polyfill" + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" } }, "autoload": { @@ -3747,7 +3854,7 @@ "shim" ], "support": { - "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.31.0" + "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.32.0" }, "funding": [ { @@ -3767,7 +3874,7 @@ }, { "name": "symfony/polyfill-intl-normalizer", - "version": "v1.31.0", + "version": "v1.32.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-intl-normalizer.git", @@ -3788,8 +3895,8 @@ "type": "library", "extra": { "thanks": { - "name": "symfony/polyfill", - "url": "https://github.com/symfony/polyfill" + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" } }, "autoload": { @@ -3828,7 +3935,7 @@ "shim" ], "support": { - "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.31.0" + "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.32.0" }, "funding": [ { @@ -3848,19 +3955,20 @@ }, { "name": "symfony/polyfill-mbstring", - "version": "v1.31.0", + "version": "v1.32.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-mbstring.git", - "reference": "85181ba99b2345b0ef10ce42ecac37612d9fd341" + "reference": "6d857f4d76bd4b343eac26d6b539585d2bc56493" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/85181ba99b2345b0ef10ce42ecac37612d9fd341", - "reference": "85181ba99b2345b0ef10ce42ecac37612d9fd341", + "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/6d857f4d76bd4b343eac26d6b539585d2bc56493", + "reference": "6d857f4d76bd4b343eac26d6b539585d2bc56493", "shasum": "" }, "require": { + "ext-iconv": "*", "php": ">=7.2" }, "provide": { @@ -3872,8 +3980,8 @@ "type": "library", "extra": { "thanks": { - "name": "symfony/polyfill", - "url": "https://github.com/symfony/polyfill" + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" } }, "autoload": { @@ -3908,7 +4016,7 @@ "shim" ], "support": { - "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.31.0" + "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.32.0" }, "funding": [ { @@ -3924,20 +4032,20 @@ "type": "tidelift" } ], - "time": "2024-09-09T11:45:10+00:00" + "time": "2024-12-23T08:48:59+00:00" }, { "name": "symfony/service-contracts", - "version": "v3.5.0", + "version": "v3.6.0", "source": { "type": "git", "url": "https://github.com/symfony/service-contracts.git", - "reference": "bd1d9e59a81d8fa4acdcea3f617c581f7475a80f" + "reference": "f021b05a130d35510bd6b25fe9053c2a8a15d5d4" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/service-contracts/zipball/bd1d9e59a81d8fa4acdcea3f617c581f7475a80f", - "reference": "bd1d9e59a81d8fa4acdcea3f617c581f7475a80f", + "url": "https://api.github.com/repos/symfony/service-contracts/zipball/f021b05a130d35510bd6b25fe9053c2a8a15d5d4", + "reference": "f021b05a130d35510bd6b25fe9053c2a8a15d5d4", "shasum": "" }, "require": { @@ -3950,12 +4058,12 @@ }, "type": "library", "extra": { - "branch-alias": { - "dev-main": "3.5-dev" - }, "thanks": { - "name": "symfony/contracts", - "url": "https://github.com/symfony/contracts" + "url": "https://github.com/symfony/contracts", + "name": "symfony/contracts" + }, + "branch-alias": { + "dev-main": "3.6-dev" } }, "autoload": { @@ -3991,7 +4099,7 @@ "standards" ], "support": { - "source": "https://github.com/symfony/service-contracts/tree/v3.5.0" + "source": "https://github.com/symfony/service-contracts/tree/v3.6.0" }, "funding": [ { @@ -4007,20 +4115,20 @@ "type": "tidelift" } ], - "time": "2024-04-18T09:32:20+00:00" + "time": "2025-04-25T09:37:31+00:00" }, { "name": "symfony/string", - "version": "v6.4.13", + "version": "v6.4.21", "source": { "type": "git", "url": "https://github.com/symfony/string.git", - "reference": "38371c60c71c72b3d64d8d76f6b1bb81a2cc3627" + "reference": "73e2c6966a5aef1d4892873ed5322245295370c6" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/string/zipball/38371c60c71c72b3d64d8d76f6b1bb81a2cc3627", - "reference": "38371c60c71c72b3d64d8d76f6b1bb81a2cc3627", + "url": "https://api.github.com/repos/symfony/string/zipball/73e2c6966a5aef1d4892873ed5322245295370c6", + "reference": "73e2c6966a5aef1d4892873ed5322245295370c6", "shasum": "" }, "require": { @@ -4077,7 +4185,7 @@ "utf8" ], "support": { - "source": "https://github.com/symfony/string/tree/v6.4.13" + "source": "https://github.com/symfony/string/tree/v6.4.21" }, "funding": [ { @@ -4093,20 +4201,20 @@ "type": "tidelift" } ], - "time": "2024-09-25T14:18:03+00:00" + "time": "2025-04-18T15:23:29+00:00" }, { "name": "symfony/translation", - "version": "v6.4.13", + "version": "v6.4.23", "source": { "type": "git", "url": "https://github.com/symfony/translation.git", - "reference": "bee9bfabfa8b4045a66bf82520e492cddbaffa66" + "reference": "de8afa521e04a5220e9e58a1dc99971ab7cac643" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/translation/zipball/bee9bfabfa8b4045a66bf82520e492cddbaffa66", - "reference": "bee9bfabfa8b4045a66bf82520e492cddbaffa66", + "url": "https://api.github.com/repos/symfony/translation/zipball/de8afa521e04a5220e9e58a1dc99971ab7cac643", + "reference": "de8afa521e04a5220e9e58a1dc99971ab7cac643", "shasum": "" }, "require": { @@ -4172,7 +4280,7 @@ "description": "Provides tools to internationalize your application", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/translation/tree/v6.4.13" + "source": "https://github.com/symfony/translation/tree/v6.4.23" }, "funding": [ { @@ -4188,20 +4296,20 @@ "type": "tidelift" } ], - "time": "2024-09-27T18:14:25+00:00" + "time": "2025-06-26T21:24:02+00:00" }, { "name": "symfony/translation-contracts", - "version": "v3.5.0", + "version": "v3.6.0", "source": { "type": "git", "url": "https://github.com/symfony/translation-contracts.git", - "reference": "b9d2189887bb6b2e0367a9fc7136c5239ab9b05a" + "reference": "df210c7a2573f1913b2d17cc95f90f53a73d8f7d" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/b9d2189887bb6b2e0367a9fc7136c5239ab9b05a", - "reference": "b9d2189887bb6b2e0367a9fc7136c5239ab9b05a", + "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/df210c7a2573f1913b2d17cc95f90f53a73d8f7d", + "reference": "df210c7a2573f1913b2d17cc95f90f53a73d8f7d", "shasum": "" }, "require": { @@ -4209,12 +4317,12 @@ }, "type": "library", "extra": { - "branch-alias": { - "dev-main": "3.5-dev" - }, "thanks": { - "name": "symfony/contracts", - "url": "https://github.com/symfony/contracts" + "url": "https://github.com/symfony/contracts", + "name": "symfony/contracts" + }, + "branch-alias": { + "dev-main": "3.6-dev" } }, "autoload": { @@ -4250,7 +4358,7 @@ "standards" ], "support": { - "source": "https://github.com/symfony/translation-contracts/tree/v3.5.0" + "source": "https://github.com/symfony/translation-contracts/tree/v3.6.0" }, "funding": [ { @@ -4266,20 +4374,20 @@ "type": "tidelift" } ], - "time": "2024-04-18T09:32:20+00:00" + "time": "2024-09-27T08:32:26+00:00" }, { "name": "symfony/var-exporter", - "version": "v6.4.13", + "version": "v6.4.22", "source": { "type": "git", "url": "https://github.com/symfony/var-exporter.git", - "reference": "0f605f72a363f8743001038a176eeb2a11223b51" + "reference": "f28cf841f5654955c9f88ceaf4b9dc29571988a9" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/var-exporter/zipball/0f605f72a363f8743001038a176eeb2a11223b51", - "reference": "0f605f72a363f8743001038a176eeb2a11223b51", + "url": "https://api.github.com/repos/symfony/var-exporter/zipball/f28cf841f5654955c9f88ceaf4b9dc29571988a9", + "reference": "f28cf841f5654955c9f88ceaf4b9dc29571988a9", "shasum": "" }, "require": { @@ -4327,7 +4435,7 @@ "serialize" ], "support": { - "source": "https://github.com/symfony/var-exporter/tree/v6.4.13" + "source": "https://github.com/symfony/var-exporter/tree/v6.4.22" }, "funding": [ { @@ -4343,20 +4451,20 @@ "type": "tidelift" } ], - "time": "2024-09-25T14:18:03+00:00" + "time": "2025-05-14T13:00:13+00:00" }, { "name": "symfony/yaml", - "version": "v6.4.13", + "version": "v6.4.23", "source": { "type": "git", "url": "https://github.com/symfony/yaml.git", - "reference": "e99b4e94d124b29ee4cf3140e1b537d2dad8cec9" + "reference": "93e29e0deb5f1b2e360adfb389a20d25eb81a27b" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/yaml/zipball/e99b4e94d124b29ee4cf3140e1b537d2dad8cec9", - "reference": "e99b4e94d124b29ee4cf3140e1b537d2dad8cec9", + "url": "https://api.github.com/repos/symfony/yaml/zipball/93e29e0deb5f1b2e360adfb389a20d25eb81a27b", + "reference": "93e29e0deb5f1b2e360adfb389a20d25eb81a27b", "shasum": "" }, "require": { @@ -4399,7 +4507,7 @@ "description": "Loads and dumps YAML files", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/yaml/tree/v6.4.13" + "source": "https://github.com/symfony/yaml/tree/v6.4.23" }, "funding": [ { @@ -4415,7 +4523,7 @@ "type": "tidelift" } ], - "time": "2024-09-25T14:18:03+00:00" + "time": "2025-06-03T06:46:12+00:00" }, { "name": "theseer/tokenizer", @@ -4470,11 +4578,11 @@ ], "aliases": [], "minimum-stability": "stable", - "stability-flags": [], + "stability-flags": {}, "prefer-stable": false, "prefer-lowest": false, - "platform": [], - "platform-dev": [], + "platform": {}, + "platform-dev": {}, "platform-overrides": { "php": "8.1" }, diff --git a/build/integration/config/behat.yml b/build/integration/config/behat.yml index 21e0cdb3309..0a3fe4fd823 100644 --- a/build/integration/config/behat.yml +++ b/build/integration/config/behat.yml @@ -16,7 +16,7 @@ default: - "%paths.base%/../features" contexts: - FeatureContext: - baseUrl: http://localhost:8080/ocs/ + baseUrl: http://localhost:8080/ocs/ admin: - admin - admin @@ -39,7 +39,7 @@ default: - "%paths.base%/../comments_features" contexts: - FeatureContext: - baseUrl: http://localhost:8080/ocs/ + baseUrl: http://localhost:8080/ocs/ admin: - admin - admin @@ -62,7 +62,7 @@ default: - "%paths.base%/../dav_features" contexts: - DavFeatureContext: - baseUrl: http://localhost:8080/ocs/ + baseUrl: http://localhost:8080/ocs/ admin: - admin - admin @@ -80,12 +80,14 @@ default: - CommandLineContext: baseUrl: http://localhost:8080 ocPath: ../../ + - PrincipalPropertySearchContext: + baseUrl: http://localhost:8080 federation: paths: - "%paths.base%/../federation_features" contexts: - FederationContext: - baseUrl: http://localhost:8080/ocs/ + baseUrl: http://localhost:8080/ocs/ admin: - admin - admin @@ -95,7 +97,7 @@ default: - "%paths.base%/../files_features" contexts: - FeatureContext: - baseUrl: http://localhost:8080/ocs/ + baseUrl: http://localhost:8080/ocs/ admin: - admin - admin @@ -113,12 +115,28 @@ default: - CommandLineContext: baseUrl: http://localhost:8080 ocPath: ../../ + - MetadataContext: + baseUrl: http://localhost:8080 + admin: + - admin + - admin + regular_user_password: 123456 + files_conversion: + paths: + - "%paths.base%/../file_conversions" + contexts: + - ConversionsContext: + baseUrl: http://localhost:8080 + admin: + - admin + - admin + regular_user_password: 123456 capabilities: paths: - "%paths.base%/../capabilities_features" contexts: - CapabilitiesContext: - baseUrl: http://localhost:8080/ocs/ + baseUrl: http://localhost:8080/ocs/ admin: - admin - admin @@ -128,7 +146,7 @@ default: - "%paths.base%/../collaboration_features" contexts: - CollaborationContext: - baseUrl: http://localhost:8080/ocs/ + baseUrl: http://localhost:8080/ocs/ admin: - admin - admin @@ -138,7 +156,7 @@ default: - "%paths.base%/../sharees_features" contexts: - ShareesContext: - baseUrl: http://localhost:8080/ocs/ + baseUrl: http://localhost:8080/ocs/ admin: - admin - admin @@ -148,7 +166,7 @@ default: - "%paths.base%/../sharing_features" contexts: - SharingContext: - baseUrl: http://localhost:8080/ocs/ + baseUrl: http://localhost:8080/ocs/ admin: - admin - admin @@ -159,7 +177,7 @@ default: - "%paths.base%/../videoverification_features" contexts: - SharingContext: - baseUrl: http://localhost:8080/ocs/ + baseUrl: http://localhost:8080/ocs/ admin: - admin - admin @@ -170,7 +188,7 @@ default: - "%paths.base%/../setup_features" contexts: - SetupContext: - baseUrl: http://localhost:8080/ocs/ + baseUrl: http://localhost:8080/ocs/ admin: - admin - admin @@ -220,10 +238,41 @@ default: - "%paths.base%/../remoteapi_features" contexts: - FeatureContext: - baseUrl: http://localhost:8080/ocs/ + baseUrl: http://localhost:8080/ocs/ admin: - admin - admin regular_user_password: 123456 - RemoteContext: - remote: http://localhost:8080 + remote: http://localhost:8080 + + ratelimiting: + paths: + - "%paths.base%/../ratelimiting_features" + contexts: + - RateLimitingContext: + baseUrl: http://localhost:8080 + admin: + - admin + - admin + regular_user_password: 123456 + routing: + paths: + - "%paths.base%/../routing_features" + contexts: + - RoutingContext: + baseUrl: http://localhost:8080 + admin: + - admin + - admin + regular_user_password: 123456 + theming: + paths: + - "%paths.base%/../theming_features" + contexts: + - FeatureContext: + baseUrl: http://localhost:8080 + admin: + - admin + - admin + regular_user_password: 123456 diff --git a/build/integration/data/clouds.jpg b/build/integration/data/clouds.jpg Binary files differnew file mode 100644 index 00000000000..2433b140766 --- /dev/null +++ b/build/integration/data/clouds.jpg diff --git a/build/integration/data/clouds.jpg.license b/build/integration/data/clouds.jpg.license new file mode 100644 index 00000000000..d7c54c39d02 --- /dev/null +++ b/build/integration/data/clouds.jpg.license @@ -0,0 +1,2 @@ +SPDX-FileCopyrightText: 2019 CHUTTERSNAP <https://unsplash.com/@chuttersnap> <https://unsplash.com/photos/blue-clouds-under-white-sky-9AqIdzEc9pY>" +SPDX-License-Identifier: LicenseRef-Unsplash diff --git a/build/integration/dav_features/caldav.feature b/build/integration/dav_features/caldav.feature index 031685b580d..f324f720bbd 100644 --- a/build/integration/dav_features/caldav.feature +++ b/build/integration/dav_features/caldav.feature @@ -87,3 +87,8 @@ Feature: caldav When "user0" requests principal "users/user0" on the endpoint "/remote.php/dav/principals/" Then The CalDAV response should be multi status And The CalDAV response should contain a property "{urn:ietf:params:xml:ns:caldav}schedule-default-calendar-URL" with a href value "/remote.php/dav/calendars/user0/MyCalendar2/" + + Scenario: Should create default calendar on first login + Given user "first-login" exists + When "first-login" requests calendar "first-login/personal" on the endpoint "/remote.php/dav/calendars/" + Then The CalDAV HTTP status code should be "207" diff --git a/build/integration/dav_features/carddav.feature b/build/integration/dav_features/carddav.feature index ffee11a284f..35e85639817 100644 --- a/build/integration/dav_features/carddav.feature +++ b/build/integration/dav_features/carddav.feature @@ -49,7 +49,6 @@ Feature: carddav |X-Frame-Options|SAMEORIGIN| |X-Permitted-Cross-Domain-Policies|none| |X-Robots-Tag|noindex, nofollow| - |X-XSS-Protection|1; mode=block| Scenario: Exporting the picture of ones own contact Given "admin" creates an addressbook named "MyAddressbook" with statuscode "201" @@ -63,7 +62,6 @@ Feature: carddav |X-Frame-Options|SAMEORIGIN| |X-Permitted-Cross-Domain-Policies|none| |X-Robots-Tag|noindex, nofollow| - |X-XSS-Protection|1; mode=block| Scenario: Create addressbook request for non-existing addressbook of another user Given user "user0" exists @@ -79,3 +77,7 @@ Feature: carddav Then The CardDAV HTTP status code should be "404" And The CardDAV exception is "Sabre\DAV\Exception\NotFound" And The CardDAV error message is "File not found: admin in 'addressbooks'" + + Scenario: Should create default addressbook on first login + Given user "first-login" exists + Then "first-login" requests addressbook "first-login/contacts" with statuscode "207" on the endpoint "/remote.php/dav/addressbooks/users/" diff --git a/build/integration/dav_features/dav-v2.feature b/build/integration/dav_features/dav-v2.feature index 2c74030c462..dbd2295497f 100644 --- a/build/integration/dav_features/dav-v2.feature +++ b/build/integration/dav_features/dav-v2.feature @@ -12,15 +12,15 @@ Feature: dav-v2 When User "user0" moves file "/textfile0.txt" to "/FOLDER/textfile0.txt" Then the HTTP status code should be "201" - Scenario: Moving and overwriting it's parent - Given using new dav path - And As an "admin" - And user "user0" exists - And As an "user0" - And user "user0" created a folder "/test" - And user "user0" created a folder "/test/test" - When User "user0" moves file "/test/test" to "/test" - Then the HTTP status code should be "403" + Scenario: Moving and overwriting it's parent + Given using new dav path + And As an "admin" + And user "user0" exists + And As an "user0" + And user "user0" created a folder "/test" + And user "user0" created a folder "/test/test" + When User "user0" moves file "/test/test" to "/test" + Then the HTTP status code should be "403" Scenario: download a file with range using new endpoint Given using new dav path @@ -41,7 +41,6 @@ Feature: dav-v2 |X-Frame-Options|SAMEORIGIN| |X-Permitted-Cross-Domain-Policies|none| |X-Robots-Tag|noindex, nofollow| - |X-XSS-Protection|1; mode=block| And Downloaded content should start with "Welcome to your Nextcloud account!" Scenario: Doing a GET with a web login should work without CSRF token on the new backend @@ -103,32 +102,61 @@ Feature: dav-v2 | shareType | 0 | | permissions | 31 | | shareWith | user0 | - And user "user0" accepts last share + And user "user0" accepts last share And As an "user0" When User "user0" uploads file "data/textfile.txt" to "/testquota/asdf.txt" Then the HTTP status code should be "201" + Scenario: Uploading a file with very long filename + Given using new dav path + And As an "admin" + And user "user0" exists + And user "user0" has a quota of "10 MB" + And As an "user0" + When User "user0" uploads file "data/textfile.txt" to "/long-filename-with-250-characters-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.txt" + Then the HTTP status code should be "201" + + Scenario: Uploading a file with a too long filename + Given using new dav path + And As an "admin" + And user "user0" exists + And user "user0" has a quota of "10 MB" + And As an "user0" + When User "user0" uploads file "data/textfile.txt" to "/long-filename-with-251-characters-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.txt" + Then the HTTP status code should be "400" + Scenario: Create a search query on image Given using new dav path And As an "admin" - And user "user0" exists - And As an "user0" - When User "user0" uploads file "data/textfile.txt" to "/testquota/asdf.txt" - Then Image search should work - And the response should be empty - When User "user0" uploads file "data/green-square-256.png" to "/image.png" + And user "user0" exists + And As an "user0" + When User "user0" uploads file "data/textfile.txt" to "/testquota/asdf.txt" + Then Image search should work + And the response should be empty + When User "user0" uploads file "data/green-square-256.png" to "/image.png" Then Image search should work - And the single response should contain a property "{DAV:}getcontenttype" with value "image/png" - - Scenario: Create a search query on favorite - Given using new dav path - And As an "admin" - And user "user0" exists - And As an "user0" - When User "user0" uploads file "data/green-square-256.png" to "/fav_image.png" - Then Favorite search should work - And the response should be empty - When user "user0" favorites element "/fav_image.png" - Then Favorite search should work - And the single response should contain a property "{http://owncloud.org/ns}favorite" with value "1" + And the single response should contain a property "{DAV:}getcontenttype" with value "image/png" + Scenario: Create a search query on favorite + Given using new dav path + And As an "admin" + And user "user0" exists + And As an "user0" + When User "user0" uploads file "data/green-square-256.png" to "/fav_image.png" + Then Favorite search should work + And the response should be empty + When user "user0" favorites element "/fav_image.png" + Then Favorite search should work + And the single response should contain a property "{http://owncloud.org/ns}favorite" with value "1" + + Scenario: Create a search query on favorite + Given using new dav path + And As an "admin" + And user "user0" exists + And As an "user0" + When User "user0" uploads file "data/green-square-256.png" to "/fav_image.png" + Then Favorite search should work + And the response should be empty + When user "user0" favorites element "/fav_image.png" + Then Favorite search should work + And the single response should contain a property "{http://owncloud.org/ns}favorite" with value "1" diff --git a/build/integration/dav_features/principal-property-search.feature b/build/integration/dav_features/principal-property-search.feature new file mode 100644 index 00000000000..b2195489263 --- /dev/null +++ b/build/integration/dav_features/principal-property-search.feature @@ -0,0 +1,13 @@ +# SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors +# SPDX-License-Identifier: AGPL-3.0-or-later + +Feature: principal-property-search + Background: + Given user "user0" exists + Given As an "admin" + Given invoking occ with "app:enable --force testing" + + Scenario: Find a principal by a given displayname + When searching for a principal matching "user0" + Then The search HTTP status code should be "207" + And The search response should contain "<d:href>/remote.php/dav/principals/users/user0/</d:href>" diff --git a/build/integration/dav_features/webdav-related.feature b/build/integration/dav_features/webdav-related.feature index f97cc8f6f71..12fd3d44c4f 100644 --- a/build/integration/dav_features/webdav-related.feature +++ b/build/integration/dav_features/webdav-related.feature @@ -38,15 +38,42 @@ Feature: webdav-related Then the HTTP status code should be "204" And Downloaded content when downloading file "/textfile0.txt" with range "bytes=0-6" should be "Welcome" - Scenario: Moving and overwriting it's parent - Given using old dav path - And As an "admin" - And user "user0" exists - And As an "user0" - And user "user0" created a folder "/test" - And user "user0" created a folder "/test/test" - When User "user0" moves file "/test/test" to "/test" - Then the HTTP status code should be "403" + Scenario: Moving and overwriting it's parent + Given using old dav path + And As an "admin" + And user "user0" exists + And As an "user0" + And user "user0" created a folder "/test" + And user "user0" created a folder "/test/test" + When User "user0" moves file "/test/test" to "/test" + Then the HTTP status code should be "403" + + Scenario: Moving a file from shared folder to root folder + Given using old dav path + And user "user0" exists + And user "user1" exists + And user "user0" created a folder "/testshare" + And User "user0" copies file "/welcome.txt" to "/testshare/welcome.txt" + And as "user0" creating a share with + | path | testshare | + | shareType | 0 | + | shareWith | user1 | + When User "user1" moves file "/testshare/welcome.txt" to "/movedwelcome.txt" + Then As an "user1" + And Downloaded content when downloading file "/movedwelcome.txt" with range "bytes=0-6" should be "Welcome" + + Scenario: Moving a file from root folder to shared folder + Given using old dav path + And user "user0" exists + And user "user1" exists + And user "user0" created a folder "/testshare" + And as "user0" creating a share with + | path | testshare | + | shareType | 0 | + | shareWith | user1 | + When User "user1" moves file "/welcome.txt" to "/testshare/movedwelcome.txt" + Then As an "user1" + And Downloaded content when downloading file "/testshare/movedwelcome.txt" with range "bytes=0-6" should be "Welcome" Scenario: Moving a file to a folder with no permissions Given using old dav path @@ -264,7 +291,6 @@ Feature: webdav-related |X-Frame-Options|SAMEORIGIN| |X-Permitted-Cross-Domain-Policies|none| |X-Robots-Tag|noindex, nofollow| - |X-XSS-Protection|1; mode=block| And Downloaded content should start with "Welcome to your Nextcloud account!" Scenario: Doing a GET with a web login should work without CSRF token on the old backend @@ -679,7 +705,7 @@ Feature: webdav-related And user "user0" uploads new chunk v2 file "2" to id "chunking-random" And user "user0" uploads new chunk v2 file "4" to id "chunking-random" And user "user0" moves new chunk v2 file with id "chunking-random" - Then the upload should fail on object storage + Then the upload should fail on object storage @s3-multipart Scenario: Upload chunked file with special characters with new chunking v2 diff --git a/build/integration/features/bootstrap/Activity.php b/build/integration/features/bootstrap/Activity.php new file mode 100644 index 00000000000..4172776304d --- /dev/null +++ b/build/integration/features/bootstrap/Activity.php @@ -0,0 +1,32 @@ +<?php + +declare(strict_types=1); + +/** + * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors + * SPDX-License-Identifier: AGPL-3.0-or-later + */ + +use Behat\Gherkin\Node\TableNode; +use PHPUnit\Framework\Assert; + +trait Activity { + use BasicStructure; + + /** + * @Then last activity should be + * @param TableNode $activity + */ + public function lastActivityIs(TableNode $activity): void { + $this->sendRequestForJSON('GET', '/apps/activity/api/v2/activity'); + $this->theHTTPStatusCodeShouldBe('200'); + $data = json_decode($this->response->getBody()->getContents(), true); + $activities = $data['ocs']['data']; + /* Sort by id */ + uasort($activities, fn ($a, $b) => $a['activity_id'] <=> $b['activity_id']); + $lastActivity = array_pop($activities); + foreach ($activity->getRowsHash() as $key => $value) { + Assert::assertEquals($value, $lastActivity[$key]); + } + } +} diff --git a/build/integration/features/bootstrap/AppConfiguration.php b/build/integration/features/bootstrap/AppConfiguration.php index 5f39c58ffeb..e8580ed537b 100644 --- a/build/integration/features/bootstrap/AppConfiguration.php +++ b/build/integration/features/bootstrap/AppConfiguration.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. diff --git a/build/integration/features/bootstrap/Avatar.php b/build/integration/features/bootstrap/Avatar.php index ffc391c0d45..beebf1c024a 100644 --- a/build/integration/features/bootstrap/Avatar.php +++ b/build/integration/features/bootstrap/Avatar.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2020 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later @@ -240,10 +241,10 @@ trait Avatar { } private function isSameColor(array $firstColor, array $secondColor, int $allowedDelta = 1) { - if ($this->isSameColorComponent($firstColor['red'], $secondColor['red'], $allowedDelta) && - $this->isSameColorComponent($firstColor['green'], $secondColor['green'], $allowedDelta) && - $this->isSameColorComponent($firstColor['blue'], $secondColor['blue'], $allowedDelta) && - $this->isSameColorComponent($firstColor['alpha'], $secondColor['alpha'], $allowedDelta)) { + if ($this->isSameColorComponent($firstColor['red'], $secondColor['red'], $allowedDelta) + && $this->isSameColorComponent($firstColor['green'], $secondColor['green'], $allowedDelta) + && $this->isSameColorComponent($firstColor['blue'], $secondColor['blue'], $allowedDelta) + && $this->isSameColorComponent($firstColor['alpha'], $secondColor['alpha'], $allowedDelta)) { return true; } @@ -251,8 +252,8 @@ trait Avatar { } private function isSameColorComponent(int $firstColorComponent, int $secondColorComponent, int $allowedDelta) { - if ($firstColorComponent >= ($secondColorComponent - $allowedDelta) && - $firstColorComponent <= ($secondColorComponent + $allowedDelta)) { + if ($firstColorComponent >= ($secondColorComponent - $allowedDelta) + && $firstColorComponent <= ($secondColorComponent + $allowedDelta)) { return true; } diff --git a/build/integration/features/bootstrap/BasicStructure.php b/build/integration/features/bootstrap/BasicStructure.php index b51c0a6a34c..59a4312913e 100644 --- a/build/integration/features/bootstrap/BasicStructure.php +++ b/build/integration/features/bootstrap/BasicStructure.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. @@ -8,6 +9,7 @@ use Behat\Gherkin\Node\TableNode; use GuzzleHttp\Client; use GuzzleHttp\Cookie\CookieJar; use GuzzleHttp\Exception\ClientException; +use GuzzleHttp\Exception\ServerException; use PHPUnit\Framework\Assert; use Psr\Http\Message\ResponseInterface; @@ -18,6 +20,7 @@ trait BasicStructure { use Avatar; use Download; use Mail; + use Theming; /** @var string */ private $currentUser = ''; @@ -120,7 +123,11 @@ trait BasicStructure { * @return string */ public function getOCSResponse($response) { - return simplexml_load_string($response->getBody())->meta[0]->statuscode; + $body = simplexml_load_string((string)$response->getBody()); + if ($body === false) { + throw new \RuntimeException('Could not parse OCS response, body is not valid XML'); + } + return $body->meta[0]->statuscode; } /** @@ -170,6 +177,8 @@ trait BasicStructure { $this->response = $client->request($verb, $fullUrl, $options); } catch (ClientException $ex) { $this->response = $ex->getResponse(); + } catch (ServerException $ex) { + $this->response = $ex->getResponse(); } } @@ -185,8 +194,8 @@ trait BasicStructure { $options = []; if ($this->currentUser === 'admin') { $options['auth'] = ['admin', 'admin']; - } elseif (strpos($this->currentUser, 'guest') !== 0) { - $options['auth'] = [$this->currentUser, self::TEST_PASSWORD]; + } elseif (strpos($this->currentUser, 'anonymous') !== 0) { + $options['auth'] = [$this->currentUser, $this->regularUser]; } if ($body instanceof TableNode) { $fd = $body->getRowsHash(); diff --git a/build/integration/features/bootstrap/CalDavContext.php b/build/integration/features/bootstrap/CalDavContext.php index 80f8c53fc4e..459c35089fa 100644 --- a/build/integration/features/bootstrap/CalDavContext.php +++ b/build/integration/features/bootstrap/CalDavContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. diff --git a/build/integration/features/bootstrap/CapabilitiesContext.php b/build/integration/features/bootstrap/CapabilitiesContext.php index ae32056e17f..7d09ab6ddcf 100644 --- a/build/integration/features/bootstrap/CapabilitiesContext.php +++ b/build/integration/features/bootstrap/CapabilitiesContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. diff --git a/build/integration/features/bootstrap/CardDavContext.php b/build/integration/features/bootstrap/CardDavContext.php index a59f0d56f96..733c98dca02 100644 --- a/build/integration/features/bootstrap/CardDavContext.php +++ b/build/integration/features/bootstrap/CardDavContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. diff --git a/build/integration/features/bootstrap/ChecksumsContext.php b/build/integration/features/bootstrap/ChecksumsContext.php index 3392f8545d9..c8abf91127e 100644 --- a/build/integration/features/bootstrap/ChecksumsContext.php +++ b/build/integration/features/bootstrap/ChecksumsContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. diff --git a/build/integration/features/bootstrap/CommandLine.php b/build/integration/features/bootstrap/CommandLine.php index 84b3dfd447f..924d723daa6 100644 --- a/build/integration/features/bootstrap/CommandLine.php +++ b/build/integration/features/bootstrap/CommandLine.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. diff --git a/build/integration/features/bootstrap/CommandLineContext.php b/build/integration/features/bootstrap/CommandLineContext.php index 5ea8d12a970..e7764356270 100644 --- a/build/integration/features/bootstrap/CommandLineContext.php +++ b/build/integration/features/bootstrap/CommandLineContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. @@ -109,19 +110,6 @@ class CommandLineContext implements \Behat\Behat\Context\Context { } /** - * @When /^transferring ownership of path "([^"]+)" from "([^"]+)" to "([^"]+)" with received shares$/ - */ - public function transferringOwnershipPathWithIncomingShares($path, $user1, $user2) { - $path = '--path=' . $path; - if ($this->runOcc(['files:transfer-ownership', $path, $user1, $user2, '--transfer-incoming-shares=1']) === 0) { - $this->lastTransferPath = $this->findLastTransferFolderForUser($user1, $user2); - } else { - // failure - $this->lastTransferPath = null; - } - } - - /** * @When /^using received transfer folder of "([^"]+)" as dav path$/ */ public function usingTransferFolderAsDavPath($user) { diff --git a/build/integration/features/bootstrap/CommentsContext.php b/build/integration/features/bootstrap/CommentsContext.php index 17795a48fb4..53001b1c204 100644 --- a/build/integration/features/bootstrap/CommentsContext.php +++ b/build/integration/features/bootstrap/CommentsContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. diff --git a/build/integration/features/bootstrap/ContactsMenu.php b/build/integration/features/bootstrap/ContactsMenu.php index 4fc3c03c5e9..f6bf6b9422b 100644 --- a/build/integration/features/bootstrap/ContactsMenu.php +++ b/build/integration/features/bootstrap/ContactsMenu.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2021 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later diff --git a/build/integration/features/bootstrap/ConversionsContext.php b/build/integration/features/bootstrap/ConversionsContext.php new file mode 100644 index 00000000000..ccd14c460f8 --- /dev/null +++ b/build/integration/features/bootstrap/ConversionsContext.php @@ -0,0 +1,60 @@ +<?php + +/** + * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors + * SPDX-FileCopyrightText: 2016 ownCloud, Inc. + * SPDX-License-Identifier: AGPL-3.0-or-later + */ +require __DIR__ . '/../../vendor/autoload.php'; + +use Behat\Behat\Context\Context; +use Behat\Behat\Context\SnippetAcceptingContext; +use Behat\Gherkin\Node\TableNode; + +class ConversionsContext implements Context, SnippetAcceptingContext { + use AppConfiguration; + use BasicStructure; + use WebDav; + + /** @BeforeScenario */ + public function setUpScenario() { + $this->asAn('admin'); + $this->setStatusTestingApp(true); + } + + /** @AfterScenario */ + public function tearDownScenario() { + $this->asAn('admin'); + $this->setStatusTestingApp(false); + } + + protected function resetAppConfigs() { + } + + /** + * @When /^user "([^"]*)" converts file "([^"]*)" to "([^"]*)"$/ + */ + public function userConvertsTheSavedFileId(string $user, string $path, string $mime) { + $this->userConvertsTheSavedFileIdTo($user, $path, $mime, null); + } + + /** + * @When /^user "([^"]*)" converts file "([^"]*)" to "([^"]*)" and saves it to "([^"]*)"$/ + */ + public function userConvertsTheSavedFileIdTo(string $user, string $path, string $mime, ?string $destination) { + try { + $fileId = $this->getFileIdForPath($user, $path); + } catch (Exception $e) { + // return a fake value to keep going and be able to test the error + $fileId = 0; + } + + $data = [['fileId', $fileId], ['targetMimeType', $mime]]; + if ($destination !== null) { + $data[] = ['destination', $destination]; + } + + $this->asAn($user); + $this->sendingToWith('post', '/apps/files/api/v1/convert', new TableNode($data)); + } +} diff --git a/build/integration/features/bootstrap/DavFeatureContext.php b/build/integration/features/bootstrap/DavFeatureContext.php index acca52ccafc..ec6085cff98 100644 --- a/build/integration/features/bootstrap/DavFeatureContext.php +++ b/build/integration/features/bootstrap/DavFeatureContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later diff --git a/build/integration/features/bootstrap/Download.php b/build/integration/features/bootstrap/Download.php index 2a66f7c3d89..549a033346e 100644 --- a/build/integration/features/bootstrap/Download.php +++ b/build/integration/features/bootstrap/Download.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2018 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later diff --git a/build/integration/features/bootstrap/ExternalStorage.php b/build/integration/features/bootstrap/ExternalStorage.php index b1e4c92810b..8fe2653a026 100644 --- a/build/integration/features/bootstrap/ExternalStorage.php +++ b/build/integration/features/bootstrap/ExternalStorage.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later diff --git a/build/integration/features/bootstrap/FakeSMTPHelper.php b/build/integration/features/bootstrap/FakeSMTPHelper.php index caf2139faab..32387869edd 100644 --- a/build/integration/features/bootstrap/FakeSMTPHelper.php +++ b/build/integration/features/bootstrap/FakeSMTPHelper.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2020 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later diff --git a/build/integration/features/bootstrap/FeatureContext.php b/build/integration/features/bootstrap/FeatureContext.php index 59f1d0068dd..ab37556f931 100644 --- a/build/integration/features/bootstrap/FeatureContext.php +++ b/build/integration/features/bootstrap/FeatureContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. @@ -13,9 +14,16 @@ require __DIR__ . '/../../vendor/autoload.php'; * Features context. */ class FeatureContext implements Context, SnippetAcceptingContext { + use AppConfiguration; use ContactsMenu; use ExternalStorage; use Search; use WebDav; use Trashbin; + + protected function resetAppConfigs(): void { + $this->deleteServerConfig('bruteForce', 'whitelist_0'); + $this->deleteServerConfig('bruteForce', 'whitelist_1'); + $this->deleteServerConfig('bruteforcesettings', 'apply_allowlist_to_ratelimit'); + } } diff --git a/build/integration/features/bootstrap/FederationContext.php b/build/integration/features/bootstrap/FederationContext.php index bbd81396df5..95dc8119ad6 100644 --- a/build/integration/features/bootstrap/FederationContext.php +++ b/build/integration/features/bootstrap/FederationContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. @@ -7,6 +8,7 @@ use Behat\Behat\Context\Context; use Behat\Behat\Context\SnippetAcceptingContext; use Behat\Gherkin\Node\TableNode; +use PHPUnit\Framework\Assert; require __DIR__ . '/../../vendor/autoload.php'; @@ -168,8 +170,52 @@ class FederationContext implements Context, SnippetAcceptingContext { self::$phpFederatedServerPid = ''; } + /** + * @BeforeScenario @TrustedFederation + */ + public function theServersAreTrustingEachOther() { + $this->asAn('admin'); + // Trust the remote server on the local server + $this->usingServer('LOCAL'); + $this->sendRequestForJSON('POST', '/apps/federation/trusted-servers', ['url' => 'http://localhost:' . getenv('PORT')]); + Assert::assertTrue(($this->response->getStatusCode() === 200 || $this->response->getStatusCode() === 409)); + + // Trust the local server on the remote server + $this->usingServer('REMOTE'); + $this->sendRequestForJSON('POST', '/apps/federation/trusted-servers', ['url' => 'http://localhost:' . getenv('PORT_FED')]); + // If the server is already trusted, we expect a 409 + Assert::assertTrue(($this->response->getStatusCode() === 200 || $this->response->getStatusCode() === 409)); + } + + /** + * @AfterScenario @TrustedFederation + */ + public function theServersAreNoLongerTrustingEachOther() { + $this->asAn('admin'); + // Untrust the remote servers on the local server + $this->usingServer('LOCAL'); + $this->sendRequestForJSON('GET', '/apps/federation/trusted-servers'); + $this->theHTTPStatusCodeShouldBe('200'); + $trustedServersIDs = array_map(fn ($server) => $server->id, json_decode($this->response->getBody())->ocs->data); + foreach ($trustedServersIDs as $id) { + $this->sendRequestForJSON('DELETE', '/apps/federation/trusted-servers/' . $id); + $this->theHTTPStatusCodeShouldBe('200'); + } + + // Untrust the local server on the remote server + $this->usingServer('REMOTE'); + $this->sendRequestForJSON('GET', '/apps/federation/trusted-servers'); + $this->theHTTPStatusCodeShouldBe('200'); + $trustedServersIDs = array_map(fn ($server) => $server->id, json_decode($this->response->getBody())->ocs->data); + foreach ($trustedServersIDs as $id) { + $this->sendRequestForJSON('DELETE', '/apps/federation/trusted-servers/' . $id); + $this->theHTTPStatusCodeShouldBe('200'); + } + } + protected function resetAppConfigs() { $this->deleteServerConfig('files_sharing', 'incoming_server2server_group_share_enabled'); $this->deleteServerConfig('files_sharing', 'outgoing_server2server_group_share_enabled'); + $this->deleteServerConfig('files_sharing', 'federated_trusted_share_auto_accept'); } } diff --git a/build/integration/features/bootstrap/FilesDropContext.php b/build/integration/features/bootstrap/FilesDropContext.php index 1b9d598645f..0c437f28a72 100644 --- a/build/integration/features/bootstrap/FilesDropContext.php +++ b/build/integration/features/bootstrap/FilesDropContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later @@ -15,7 +16,7 @@ class FilesDropContext implements Context, SnippetAcceptingContext { /** * @When Dropping file :path with :content */ - public function droppingFileWith($path, $content, $nickName = null) { + public function droppingFileWith($path, $content, $nickname = null) { $client = new Client(); $options = []; if (count($this->lastShareData->data->element) > 0) { @@ -28,11 +29,11 @@ class FilesDropContext implements Context, SnippetAcceptingContext { $fullUrl = str_replace('//', '/', $base . "/public.php/dav/files/$token/$path"); $options['headers'] = [ - 'X-REQUESTED-WITH' => 'XMLHttpRequest' + 'X-REQUESTED-WITH' => 'XMLHttpRequest', ]; - if ($nickName) { - $options['headers']['X-NC-NICKNAME'] = $nickName; + if ($nickname) { + $options['headers']['X-NC-NICKNAME'] = $nickname; } $options['body'] = \GuzzleHttp\Psr7\Utils::streamFor($content); @@ -43,20 +44,20 @@ class FilesDropContext implements Context, SnippetAcceptingContext { $this->response = $e->getResponse(); } } - - + + /** * @When Dropping file :path with :content as :nickName */ - public function droppingFileWithAs($path, $content, $nickName) { - $this->droppingFileWith($path, $content, $nickName); + public function droppingFileWithAs($path, $content, $nickname) { + $this->droppingFileWith($path, $content, $nickname); } /** * @When Creating folder :folder in drop */ - public function creatingFolderInDrop($folder) { + public function creatingFolderInDrop($folder, $nickname = null) { $client = new Client(); $options = []; if (count($this->lastShareData->data->element) > 0) { @@ -69,13 +70,25 @@ class FilesDropContext implements Context, SnippetAcceptingContext { $fullUrl = str_replace('//', '/', $base . "/public.php/dav/files/$token/$folder"); $options['headers'] = [ - 'X-REQUESTED-WITH' => 'XMLHttpRequest' + 'X-REQUESTED-WITH' => 'XMLHttpRequest', ]; + if ($nickname) { + $options['headers']['X-NC-NICKNAME'] = $nickname; + } + try { $this->response = $client->request('MKCOL', $fullUrl, $options); } catch (\GuzzleHttp\Exception\ClientException $e) { $this->response = $e->getResponse(); } } + + + /** + * @When Creating folder :folder in drop as :nickName + */ + public function creatingFolderInDropWithNickname($folder, $nickname) { + return $this->creatingFolderInDrop($folder, $nickname); + } } diff --git a/build/integration/features/bootstrap/LDAPContext.php b/build/integration/features/bootstrap/LDAPContext.php index f0181b36c71..986dced77a1 100644 --- a/build/integration/features/bootstrap/LDAPContext.php +++ b/build/integration/features/bootstrap/LDAPContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2017 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later diff --git a/build/integration/features/bootstrap/Mail.php b/build/integration/features/bootstrap/Mail.php index d28c24730ba..d48ed6399c5 100644 --- a/build/integration/features/bootstrap/Mail.php +++ b/build/integration/features/bootstrap/Mail.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2020 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later diff --git a/build/integration/features/bootstrap/MetadataContext.php b/build/integration/features/bootstrap/MetadataContext.php new file mode 100644 index 00000000000..32042590c86 --- /dev/null +++ b/build/integration/features/bootstrap/MetadataContext.php @@ -0,0 +1,124 @@ +<?php + +/** + * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors + * SPDX-License-Identifier: AGPL-3.0-or-later + */ + +use Behat\Behat\Context\Context; +use Behat\Step\Then; +use Behat\Step\When; +use PHPUnit\Framework\Assert; +use Sabre\DAV\Client as SClient; + +require __DIR__ . '/../../vendor/autoload.php'; + +class MetadataContext implements Context { + private string $davPath = '/remote.php/dav'; + + public function __construct( + private string $baseUrl, + private array $admin, + private string $regular_user_password, + ) { + // in case of ci deployment we take the server url from the environment + $testServerUrl = getenv('TEST_SERVER_URL'); + if ($testServerUrl !== false) { + $this->baseUrl = substr($testServerUrl, 0, -5); + } + } + + #[When('User :user sets the :metadataKey prop with value :metadataValue on :fileName')] + public function userSetsProp(string $user, string $metadataKey, string $metadataValue, string $fileName) { + $client = new SClient([ + 'baseUri' => $this->baseUrl, + 'userName' => $user, + 'password' => '123456', + 'authType' => SClient::AUTH_BASIC, + ]); + + $body = '<?xml version="1.0"?> +<d:propertyupdate xmlns:d="DAV:" xmlns:nc="http://nextcloud.com/ns"> + <d:set> + <d:prop> + <nc:' . $metadataKey . '>' . $metadataValue . '</nc:' . $metadataKey . '> + </d:prop> + </d:set> +</d:propertyupdate>'; + + $davUrl = $this->getDavUrl($user, $fileName); + $client->request('PROPPATCH', $this->baseUrl . $davUrl, $body); + } + + #[When('User :user deletes the :metadataKey prop on :fileName')] + public function userDeletesProp(string $user, string $metadataKey, string $fileName) { + $client = new SClient([ + 'baseUri' => $this->baseUrl, + 'userName' => $user, + 'password' => '123456', + 'authType' => SClient::AUTH_BASIC, + ]); + + $body = '<?xml version="1.0"?> +<d:propertyupdate xmlns:d="DAV:" xmlns:nc="http://nextcloud.com/ns"> + <d:remove> + <d:prop> + <nc:' . $metadataKey . '></nc:' . $metadataKey . '> + </d:prop> + </d:remove> +</d:propertyupdate>'; + + $davUrl = $this->getDavUrl($user, $fileName); + $client->request('PROPPATCH', $this->baseUrl . $davUrl, $body); + } + + #[Then('User :user should see the prop :metadataKey equal to :metadataValue for file :fileName')] + public function checkPropForFile(string $user, string $metadataKey, string $metadataValue, string $fileName) { + $client = new SClient([ + 'baseUri' => $this->baseUrl, + 'userName' => $user, + 'password' => '123456', + 'authType' => SClient::AUTH_BASIC, + ]); + + $body = '<?xml version="1.0"?> +<d:propfind xmlns:d="DAV:" xmlns:nc="http://nextcloud.com/ns"> + <d:prop> + <nc:' . $metadataKey . '></nc:' . $metadataKey . '> + </d:prop> +</d:propfind>'; + + $davUrl = $this->getDavUrl($user, $fileName); + $response = $client->request('PROPFIND', $this->baseUrl . $davUrl, $body); + $parsedResponse = $client->parseMultistatus($response['body']); + + Assert::assertEquals($parsedResponse[$davUrl]['200']['{http://nextcloud.com/ns}' . $metadataKey], $metadataValue); + } + + #[Then('User :user should not see the prop :metadataKey for file :fileName')] + public function checkPropDoesNotExistsForFile(string $user, string $metadataKey, string $fileName) { + $client = new SClient([ + 'baseUri' => $this->baseUrl, + 'userName' => $user, + 'password' => '123456', + 'authType' => SClient::AUTH_BASIC, + ]); + + $body = '<?xml version="1.0"?> +<d:propfind xmlns:d="DAV:" xmlns:nc="http://nextcloud.com/ns"> + <d:prop> + <nc:' . $metadataKey . '></nc:' . $metadataKey . '> + </d:prop> +</d:propfind>'; + + $davUrl = $this->getDavUrl($user, $fileName); + $response = $client->request('PROPFIND', $this->baseUrl . $davUrl, $body); + $parsedResponse = $client->parseMultistatus($response['body']); + + Assert::assertEquals($parsedResponse[$davUrl]['404']['{http://nextcloud.com/ns}' . $metadataKey], null); + } + + private function getDavUrl(string $user, string $fileName) { + return $this->davPath . '/files/' . $user . $fileName; + } +} diff --git a/build/integration/features/bootstrap/PrincipalPropertySearchContext.php b/build/integration/features/bootstrap/PrincipalPropertySearchContext.php new file mode 100644 index 00000000000..9dfd9379240 --- /dev/null +++ b/build/integration/features/bootstrap/PrincipalPropertySearchContext.php @@ -0,0 +1,141 @@ +<?php + +/** + * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors + * SPDX-License-Identifier: AGPL-3.0-or-later + */ + +require __DIR__ . '/../../vendor/autoload.php'; + +use Behat\Behat\Context\Context; +use GuzzleHttp\BodySummarizer; +use GuzzleHttp\Client; +use GuzzleHttp\HandlerStack; +use GuzzleHttp\Middleware; +use GuzzleHttp\Utils; +use Psr\Http\Message\ResponseInterface; + +class PrincipalPropertySearchContext implements Context { + private string $baseUrl; + private Client $client; + private ResponseInterface $response; + + public function __construct(string $baseUrl) { + $this->baseUrl = $baseUrl; + + // in case of ci deployment we take the server url from the environment + $testServerUrl = getenv('TEST_SERVER_URL'); + if ($testServerUrl !== false) { + $this->baseUrl = substr($testServerUrl, 0, -5); + } + } + + /** @BeforeScenario */ + public function setUpScenario(): void { + $this->client = $this->createGuzzleInstance(); + } + + /** + * Create a Guzzle client with a higher truncateAt value to read full error responses. + */ + private function createGuzzleInstance(): Client { + $bodySummarizer = new BodySummarizer(2048); + + $stack = new HandlerStack(Utils::chooseHandler()); + $stack->push(Middleware::httpErrors($bodySummarizer), 'http_errors'); + $stack->push(Middleware::redirect(), 'allow_redirects'); + $stack->push(Middleware::cookies(), 'cookies'); + $stack->push(Middleware::prepareBody(), 'prepare_body'); + + return new Client(['handler' => $stack]); + } + + /** + * @When searching for a principal matching :match + * @param string $match + * @throws \Exception + */ + public function principalPropertySearch(string $match) { + $davUrl = $this->baseUrl . '/remote.php/dav/'; + $user = 'admin'; + $password = 'admin'; + + $this->response = $this->client->request( + 'REPORT', + $davUrl, + [ + 'body' => '<x0:principal-property-search xmlns:x0="DAV:" test="anyof"> + <x0:property-search> + <x0:prop> + <x0:displayname/> + <x2:email-address xmlns:x2="http://sabredav.org/ns"/> + </x0:prop> + <x0:match>' . $match . '</x0:match> + </x0:property-search> + <x0:prop> + <x0:displayname/> + <x1:calendar-user-type xmlns:x1="urn:ietf:params:xml:ns:caldav"/> + <x1:calendar-user-address-set xmlns:x1="urn:ietf:params:xml:ns:caldav"/> + <x0:principal-URL/> + <x0:alternate-URI-set/> + <x2:email-address xmlns:x2="http://sabredav.org/ns"/> + <x3:language xmlns:x3="http://nextcloud.com/ns"/> + <x1:calendar-home-set xmlns:x1="urn:ietf:params:xml:ns:caldav"/> + <x1:schedule-inbox-URL xmlns:x1="urn:ietf:params:xml:ns:caldav"/> + <x1:schedule-outbox-URL xmlns:x1="urn:ietf:params:xml:ns:caldav"/> + <x1:schedule-default-calendar-URL xmlns:x1="urn:ietf:params:xml:ns:caldav"/> + <x3:resource-type xmlns:x3="http://nextcloud.com/ns"/> + <x3:resource-vehicle-type xmlns:x3="http://nextcloud.com/ns"/> + <x3:resource-vehicle-make xmlns:x3="http://nextcloud.com/ns"/> + <x3:resource-vehicle-model xmlns:x3="http://nextcloud.com/ns"/> + <x3:resource-vehicle-is-electric xmlns:x3="http://nextcloud.com/ns"/> + <x3:resource-vehicle-range xmlns:x3="http://nextcloud.com/ns"/> + <x3:resource-vehicle-seating-capacity xmlns:x3="http://nextcloud.com/ns"/> + <x3:resource-contact-person xmlns:x3="http://nextcloud.com/ns"/> + <x3:resource-contact-person-vcard xmlns:x3="http://nextcloud.com/ns"/> + <x3:room-type xmlns:x3="http://nextcloud.com/ns"/> + <x3:room-seating-capacity xmlns:x3="http://nextcloud.com/ns"/> + <x3:room-building-address xmlns:x3="http://nextcloud.com/ns"/> + <x3:room-building-story xmlns:x3="http://nextcloud.com/ns"/> + <x3:room-building-room-number xmlns:x3="http://nextcloud.com/ns"/> + <x3:room-features xmlns:x3="http://nextcloud.com/ns"/> + </x0:prop> + <x0:apply-to-principal-collection-set/> +</x0:principal-property-search> +', + 'auth' => [ + $user, + $password, + ], + 'headers' => [ + 'Content-Type' => 'application/xml; charset=UTF-8', + 'Depth' => '0', + ], + ] + ); + } + + /** + * @Then The search HTTP status code should be :code + * @param string $code + * @throws \Exception + */ + public function theHttpStatusCodeShouldBe(string $code): void { + if ((int)$code !== $this->response->getStatusCode()) { + throw new \Exception('Expected ' . (int)$code . ' got ' . $this->response->getStatusCode()); + } + } + + /** + * @Then The search response should contain :needle + * @param string $needle + * @throws \Exception + */ + public function theResponseShouldContain(string $needle): void { + $body = $this->response->getBody()->getContents(); + + if (str_contains($body, $needle) === false) { + throw new \Exception('Response does not contain "' . $needle . '"'); + } + } +} diff --git a/build/integration/features/bootstrap/Provisioning.php b/build/integration/features/bootstrap/Provisioning.php index 9e3e8ccfd8b..935ad2a4a1d 100644 --- a/build/integration/features/bootstrap/Provisioning.php +++ b/build/integration/features/bootstrap/Provisioning.php @@ -1,9 +1,12 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. * SPDX-License-Identifier: AGPL-3.0-or-later */ + +use Behat\Gherkin\Node\TableNode; use GuzzleHttp\Client; use GuzzleHttp\Message\ResponseInterface; use PHPUnit\Framework\Assert; @@ -124,7 +127,7 @@ trait Provisioning { * @Then /^user "([^"]*)" has$/ * * @param string $user - * @param \Behat\Gherkin\Node\TableNode|null $settings + * @param TableNode|null $settings */ public function userHasSetting($user, $settings) { $fullUrl = $this->baseUrl . "v{$this->apiVersion}.php/cloud/users/$user"; @@ -145,12 +148,43 @@ trait Provisioning { if (isset($value['element']) && in_array($setting[0], ['additional_mail', 'additional_mailScope'], true)) { $expectedValues = explode(';', $setting[1]); foreach ($expectedValues as $expected) { - Assert::assertTrue(in_array($expected, $value['element'], true)); + Assert::assertTrue(in_array($expected, $value['element'], true), 'Data wrong for field: ' . $setting[0]); } } elseif (isset($value[0])) { - Assert::assertEqualsCanonicalizing($setting[1], $value[0]); + Assert::assertEqualsCanonicalizing($setting[1], $value[0], 'Data wrong for field: ' . $setting[0]); } else { - Assert::assertEquals('', $setting[1]); + Assert::assertEquals('', $setting[1], 'Data wrong for field: ' . $setting[0]); + } + } + } + + /** + * @Then /^user "([^"]*)" has the following profile data$/ + */ + public function userHasProfileData(string $user, ?TableNode $settings): void { + $fullUrl = $this->baseUrl . "v{$this->apiVersion}.php/profile/$user"; + $client = new Client(); + $options = []; + if ($this->currentUser === 'admin') { + $options['auth'] = $this->adminUser; + } else { + $options['auth'] = [$this->currentUser, $this->regularUser]; + } + $options['headers'] = [ + 'OCS-APIREQUEST' => 'true', + 'Accept' => 'application/json', + ]; + + $response = $client->get($fullUrl, $options); + $body = $response->getBody()->getContents(); + $data = json_decode($body, true); + $data = $data['ocs']['data']; + foreach ($settings->getRows() as $setting) { + Assert::assertArrayHasKey($setting[0], $data, 'Profile data field missing: ' . $setting[0]); + if ($setting[1] === 'NULL') { + Assert::assertNull($data[$setting[0]], 'Profile data wrong for field: ' . $setting[0]); + } else { + Assert::assertEquals($setting[1], $data[$setting[0]], 'Profile data wrong for field: ' . $setting[0]); } } } @@ -159,7 +193,7 @@ trait Provisioning { * @Then /^group "([^"]*)" has$/ * * @param string $user - * @param \Behat\Gherkin\Node\TableNode|null $settings + * @param TableNode|null $settings */ public function groupHasSetting($group, $settings) { $fullUrl = $this->baseUrl . "v{$this->apiVersion}.php/cloud/groups/details?search=$group"; @@ -191,7 +225,7 @@ trait Provisioning { * @Then /^user "([^"]*)" has editable fields$/ * * @param string $user - * @param \Behat\Gherkin\Node\TableNode|null $fields + * @param TableNode|null $fields */ public function userHasEditableFields($user, $fields) { $fullUrl = $this->baseUrl . "v{$this->apiVersion}.php/cloud/user/fields"; @@ -221,9 +255,9 @@ trait Provisioning { * @Then /^search users by phone for region "([^"]*)" with$/ * * @param string $user - * @param \Behat\Gherkin\Node\TableNode|null $settings + * @param TableNode|null $settings */ - public function searchUserByPhone($region, \Behat\Gherkin\Node\TableNode $searchTable) { + public function searchUserByPhone($region, TableNode $searchTable) { $fullUrl = $this->baseUrl . "v{$this->apiVersion}.php/cloud/users/search/by-phone"; $client = new Client(); $options = []; @@ -624,10 +658,10 @@ trait Provisioning { /** * @Then /^users returned are$/ - * @param \Behat\Gherkin\Node\TableNode|null $usersList + * @param TableNode|null $usersList */ public function theUsersShouldBe($usersList) { - if ($usersList instanceof \Behat\Gherkin\Node\TableNode) { + if ($usersList instanceof TableNode) { $users = $usersList->getRows(); $usersSimplified = $this->simplifyArray($users); $respondedArray = $this->getArrayOfUsersResponded($this->response); @@ -637,10 +671,10 @@ trait Provisioning { /** * @Then /^phone matches returned are$/ - * @param \Behat\Gherkin\Node\TableNode|null $usersList + * @param TableNode|null $usersList */ public function thePhoneUsersShouldBe($usersList) { - if ($usersList instanceof \Behat\Gherkin\Node\TableNode) { + if ($usersList instanceof TableNode) { $users = $usersList->getRowsHash(); $listCheckedElements = simplexml_load_string($this->response->getBody())->data; $respondedArray = json_decode(json_encode($listCheckedElements), true); @@ -650,10 +684,10 @@ trait Provisioning { /** * @Then /^detailed users returned are$/ - * @param \Behat\Gherkin\Node\TableNode|null $usersList + * @param TableNode|null $usersList */ public function theDetailedUsersShouldBe($usersList) { - if ($usersList instanceof \Behat\Gherkin\Node\TableNode) { + if ($usersList instanceof TableNode) { $users = $usersList->getRows(); $usersSimplified = $this->simplifyArray($users); $respondedArray = $this->getArrayOfDetailedUsersResponded($this->response); @@ -664,10 +698,10 @@ trait Provisioning { /** * @Then /^groups returned are$/ - * @param \Behat\Gherkin\Node\TableNode|null $groupsList + * @param TableNode|null $groupsList */ public function theGroupsShouldBe($groupsList) { - if ($groupsList instanceof \Behat\Gherkin\Node\TableNode) { + if ($groupsList instanceof TableNode) { $groups = $groupsList->getRows(); $groupsSimplified = $this->simplifyArray($groups); $respondedArray = $this->getArrayOfGroupsResponded($this->response); @@ -677,10 +711,10 @@ trait Provisioning { /** * @Then /^subadmin groups returned are$/ - * @param \Behat\Gherkin\Node\TableNode|null $groupsList + * @param TableNode|null $groupsList */ public function theSubadminGroupsShouldBe($groupsList) { - if ($groupsList instanceof \Behat\Gherkin\Node\TableNode) { + if ($groupsList instanceof TableNode) { $groups = $groupsList->getRows(); $groupsSimplified = $this->simplifyArray($groups); $respondedArray = $this->getArrayOfSubadminsResponded($this->response); @@ -690,10 +724,10 @@ trait Provisioning { /** * @Then /^apps returned are$/ - * @param \Behat\Gherkin\Node\TableNode|null $appList + * @param TableNode|null $appList */ public function theAppsShouldBe($appList) { - if ($appList instanceof \Behat\Gherkin\Node\TableNode) { + if ($appList instanceof TableNode) { $apps = $appList->getRows(); $appsSimplified = $this->simplifyArray($apps); $respondedArray = $this->getArrayOfAppsResponded($this->response); @@ -703,7 +737,7 @@ trait Provisioning { /** * @Then /^subadmin users returned are$/ - * @param \Behat\Gherkin\Node\TableNode|null $groupsList + * @param TableNode|null $groupsList */ public function theSubadminUsersShouldBe($groupsList) { $this->theSubadminGroupsShouldBe($groupsList); @@ -882,7 +916,7 @@ trait Provisioning { * @param string $quota */ public function userHasAQuotaOf($user, $quota) { - $body = new \Behat\Gherkin\Node\TableNode([ + $body = new TableNode([ 0 => ['key', 'quota'], 1 => ['value', $quota], ]); @@ -950,7 +984,7 @@ trait Provisioning { /** * @Then /^user "([^"]*)" has not$/ */ - public function userHasNotSetting($user, \Behat\Gherkin\Node\TableNode $settings) { + public function userHasNotSetting($user, TableNode $settings) { $fullUrl = $this->baseUrl . "v{$this->apiVersion}.php/cloud/users/$user"; $client = new Client(); $options = []; diff --git a/build/integration/features/bootstrap/RateLimitingContext.php b/build/integration/features/bootstrap/RateLimitingContext.php new file mode 100644 index 00000000000..15c8c5c8379 --- /dev/null +++ b/build/integration/features/bootstrap/RateLimitingContext.php @@ -0,0 +1,31 @@ +<?php + +/** + * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors + * SPDX-License-Identifier: AGPL-3.0-or-later + */ +use Behat\Behat\Context\Context; + +class RateLimitingContext implements Context { + use BasicStructure; + use CommandLine; + use Provisioning; + + /** + * @BeforeScenario @RateLimiting + */ + public function enableRateLimiting() { + // Enable rate limiting for the tests. + // Ratelimiting is disabled by default, so we need to enable it + $this->runOcc(['config:system:set', 'ratelimit.protection.enabled', '--value', 'true', '--type', 'bool']); + } + + /** + * @AfterScenario @RateLimiting + */ + public function disableRateLimiting() { + // Restore the default rate limiting configuration. + // Ratelimiting is disabled by default, so we need to disable it + $this->runOcc(['config:system:set', 'ratelimit.protection.enabled', '--value', 'false', '--type', 'bool']); + } +} diff --git a/build/integration/features/bootstrap/RemoteContext.php b/build/integration/features/bootstrap/RemoteContext.php index ae9da4b3614..6102f686ea7 100644 --- a/build/integration/features/bootstrap/RemoteContext.php +++ b/build/integration/features/bootstrap/RemoteContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2017 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later diff --git a/build/integration/features/bootstrap/RoutingContext.php b/build/integration/features/bootstrap/RoutingContext.php new file mode 100644 index 00000000000..762570547e0 --- /dev/null +++ b/build/integration/features/bootstrap/RoutingContext.php @@ -0,0 +1,19 @@ +<?php + +/** + * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors + * SPDX-License-Identifier: AGPL-3.0-or-later + */ +use Behat\Behat\Context\Context; +use Behat\Behat\Context\SnippetAcceptingContext; + +require __DIR__ . '/../../vendor/autoload.php'; + +class RoutingContext implements Context, SnippetAcceptingContext { + use Provisioning; + use AppConfiguration; + use CommandLine; + + protected function resetAppConfigs(): void { + } +} diff --git a/build/integration/features/bootstrap/Search.php b/build/integration/features/bootstrap/Search.php index 47259be769c..49a4fe92822 100644 --- a/build/integration/features/bootstrap/Search.php +++ b/build/integration/features/bootstrap/Search.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2018 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later diff --git a/build/integration/features/bootstrap/SetupContext.php b/build/integration/features/bootstrap/SetupContext.php index 96cb00d8601..aa131cec597 100644 --- a/build/integration/features/bootstrap/SetupContext.php +++ b/build/integration/features/bootstrap/SetupContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later diff --git a/build/integration/features/bootstrap/ShareesContext.php b/build/integration/features/bootstrap/ShareesContext.php index e152a749bfa..37e0e63e547 100644 --- a/build/integration/features/bootstrap/ShareesContext.php +++ b/build/integration/features/bootstrap/ShareesContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. diff --git a/build/integration/features/bootstrap/Sharing.php b/build/integration/features/bootstrap/Sharing.php index a58a1b4fda3..0cc490ff110 100644 --- a/build/integration/features/bootstrap/Sharing.php +++ b/build/integration/features/bootstrap/Sharing.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. @@ -54,8 +55,12 @@ trait Sharing { $fd = $body->getRowsHash(); if (array_key_exists('expireDate', $fd)) { $dateModification = $fd['expireDate']; - if (!empty($dateModification)) { + if ($dateModification === 'null') { + $fd['expireDate'] = null; + } elseif (!empty($dateModification)) { $fd['expireDate'] = date('Y-m-d', strtotime($dateModification)); + } else { + $fd['expireDate'] = ''; } } $options['form_params'] = $fd; @@ -332,6 +337,8 @@ trait Sharing { return $this->isExpectedUrl((string)$data->$field, 'index.php/s/'); } elseif ($contentExpected == $data->$field) { return true; + } else { + print($data->$field); } return false; } @@ -557,18 +564,18 @@ trait Sharing { ]; $expectedFields = array_merge($defaultExpectedFields, $body->getRowsHash()); - if (!array_key_exists('uid_file_owner', $expectedFields) && - array_key_exists('uid_owner', $expectedFields)) { + if (!array_key_exists('uid_file_owner', $expectedFields) + && array_key_exists('uid_owner', $expectedFields)) { $expectedFields['uid_file_owner'] = $expectedFields['uid_owner']; } - if (!array_key_exists('displayname_file_owner', $expectedFields) && - array_key_exists('displayname_owner', $expectedFields)) { + if (!array_key_exists('displayname_file_owner', $expectedFields) + && array_key_exists('displayname_owner', $expectedFields)) { $expectedFields['displayname_file_owner'] = $expectedFields['displayname_owner']; } - if (array_key_exists('share_type', $expectedFields) && - $expectedFields['share_type'] == 10 /* IShare::TYPE_ROOM */ && - array_key_exists('share_with', $expectedFields)) { + if (array_key_exists('share_type', $expectedFields) + && $expectedFields['share_type'] == 10 /* IShare::TYPE_ROOM */ + && array_key_exists('share_with', $expectedFields)) { if ($expectedFields['share_with'] === 'private_conversation') { $expectedFields['share_with'] = 'REGEXP /^private_conversation_[0-9a-f]{6}$/'; } else { diff --git a/build/integration/features/bootstrap/SharingContext.php b/build/integration/features/bootstrap/SharingContext.php index 97c2a35ad84..a9dd99108a9 100644 --- a/build/integration/features/bootstrap/SharingContext.php +++ b/build/integration/features/bootstrap/SharingContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later @@ -17,6 +18,7 @@ class SharingContext implements Context, SnippetAcceptingContext { use Trashbin; use AppConfiguration; use CommandLine; + use Activity; protected function resetAppConfigs() { $this->deleteServerConfig('core', 'shareapi_default_permissions'); @@ -27,6 +29,9 @@ class SharingContext implements Context, SnippetAcceptingContext { $this->deleteServerConfig('core', 'shareapi_default_expire_date'); $this->deleteServerConfig('core', 'shareapi_expire_after_n_days'); $this->deleteServerConfig('core', 'link_defaultExpDays'); + $this->deleteServerConfig('core', 'shareapi_allow_federation_on_public_shares'); + $this->deleteServerConfig('files_sharing', 'outgoing_server2server_share_enabled'); + $this->deleteServerConfig('core', 'shareapi_allow_view_without_download'); $this->runOcc(['config:system:delete', 'share_folder']); } diff --git a/build/integration/features/bootstrap/TagsContext.php b/build/integration/features/bootstrap/TagsContext.php index 262271e3710..c64626de68d 100644 --- a/build/integration/features/bootstrap/TagsContext.php +++ b/build/integration/features/bootstrap/TagsContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. @@ -255,9 +256,9 @@ class TagsContext implements \Behat\Behat\Context\Context { foreach ($table->getRowsHash() as $rowDisplayName => $row) { foreach ($tags as $key => $tag) { if ( - $tag['display-name'] === $rowDisplayName && - $tag['user-visible'] === $row[0] && - $tag['user-assignable'] === $row[1] + $tag['display-name'] === $rowDisplayName + && $tag['user-visible'] === $row[0] + && $tag['user-assignable'] === $row[1] ) { unset($tags[$key]); } diff --git a/build/integration/features/bootstrap/TalkContext.php b/build/integration/features/bootstrap/TalkContext.php index fe248e1af7c..6f351c30ccf 100644 --- a/build/integration/features/bootstrap/TalkContext.php +++ b/build/integration/features/bootstrap/TalkContext.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2020 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later diff --git a/build/integration/features/bootstrap/Theming.php b/build/integration/features/bootstrap/Theming.php new file mode 100644 index 00000000000..f44a6533a1b --- /dev/null +++ b/build/integration/features/bootstrap/Theming.php @@ -0,0 +1,49 @@ +<?php + +/** + * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors + * SPDX-License-Identifier: AGPL-3.0-or-later + */ +require __DIR__ . '/../../vendor/autoload.php'; + +trait Theming { + + private bool $undoAllThemingChangesAfterScenario = false; + + /** + * @AfterScenario + */ + public function undoAllThemingChanges() { + if (!$this->undoAllThemingChangesAfterScenario) { + return; + } + + $this->loggingInUsingWebAs('admin'); + $this->sendingAToWithRequesttoken('POST', '/index.php/apps/theming/ajax/undoAllChanges'); + + $this->undoAllThemingChangesAfterScenario = false; + } + + /** + * @When logged in admin uploads theming image for :key from file :source + * + * @param string $key + * @param string $source + */ + public function loggedInAdminUploadsThemingImageForFromFile(string $key, string $source) { + $this->undoAllThemingChangesAfterScenario = true; + + $file = \GuzzleHttp\Psr7\Utils::streamFor(fopen($source, 'r')); + + $this->sendingAToWithRequesttoken('POST', '/index.php/apps/theming/ajax/uploadImage?key=' . $key, + [ + 'multipart' => [ + [ + 'name' => 'image', + 'contents' => $file + ] + ] + ]); + $this->theHTTPStatusCodeShouldBe('200'); + } +} diff --git a/build/integration/features/bootstrap/Trashbin.php b/build/integration/features/bootstrap/Trashbin.php index 6c8fd5e4fb6..dfcc23289a7 100644 --- a/build/integration/features/bootstrap/Trashbin.php +++ b/build/integration/features/bootstrap/Trashbin.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2017 ownCloud GmbH diff --git a/build/integration/features/bootstrap/WebDav.php b/build/integration/features/bootstrap/WebDav.php index e71502b6b0c..2cb37002ac0 100644 --- a/build/integration/features/bootstrap/WebDav.php +++ b/build/integration/features/bootstrap/WebDav.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. @@ -262,7 +263,11 @@ trait WebDav { 'Accept' => 'application/zip' ]; - $this->response = $client->request('GET', $fullUrl, $options); + try { + $this->response = $client->request('GET', $fullUrl, $options); + } catch (\GuzzleHttp\Exception\ClientException $e) { + $this->response = $e->getResponse(); + } } /** diff --git a/build/integration/features/contacts-menu.feature b/build/integration/features/contacts-menu.feature index f01b34aa1ba..772c0e5405c 100644 --- a/build/integration/features/contacts-menu.feature +++ b/build/integration/features/contacts-menu.feature @@ -71,8 +71,6 @@ Feature: contacts-menu And searched contact "1" is named "Test name" And searched contact "2" is named "user2" - - Scenario: users can not be found by display name if visibility is private Given user "user0" exists And user "user1" exists @@ -80,11 +78,11 @@ Feature: contacts-menu And Logging in using web as "user1" And Sending a "PUT" to "/settings/users/user1/settings" with requesttoken | displayname | Test name | - | displaynameScope | private | + | displaynameScope | v2-private | And Logging in using web as "user2" And Sending a "PUT" to "/settings/users/user2/settings" with requesttoken | displayname | Another test name | - | displaynameScope | contacts | + | displaynameScope | v2-federated | When Logging in using web as "user0" And searching for contacts matching with "test" # Disabled because it regularly fails on drone: @@ -98,11 +96,11 @@ Feature: contacts-menu And Logging in using web as "user1" And Sending a "PUT" to "/settings/users/user1/settings" with requesttoken | email | test@example.com | - | emailScope | private | + | emailScope | v2-private | And Logging in using web as "user2" And Sending a "PUT" to "/settings/users/user2/settings" with requesttoken | email | another_test@example.com | - | emailScope | contacts | + | emailScope | v2-federated | # Disabled because it regularly fails on drone: # When Logging in using web as "user0" # And searching for contacts matching with "test" @@ -116,15 +114,15 @@ Feature: contacts-menu And Logging in using web as "user1" And Sending a "PUT" to "/settings/users/user1/settings" with requesttoken | displayname | Test name | - | displaynameScope | contacts | + | displaynameScope | v2-federated | | email | test@example.com | - | emailScope | private | + | emailScope | v2-private | And Logging in using web as "user2" And Sending a "PUT" to "/settings/users/user2/settings" with requesttoken | displayname | Another test name | - | displaynameScope | private | + | displaynameScope | v2-private | | email | another_test@example.com | - | emailScope | contacts | + | emailScope | v2-federated | When Logging in using web as "user0" And searching for contacts matching with "test" Then the list of searched contacts has "2" contacts @@ -140,9 +138,9 @@ Feature: contacts-menu And Logging in using web as "user1" And Sending a "PUT" to "/settings/users/user1/settings" with requesttoken | displayname | Test name | - | displaynameScope | private | + | displaynameScope | v2-private | And Sending a "PUT" to "/settings/users/user1/settings" with requesttoken - | displaynameScope | contacts | + | displaynameScope | v2-federated | When Logging in using web as "user0" And searching for contacts matching with "test" Then the list of searched contacts has "1" contacts @@ -154,9 +152,9 @@ Feature: contacts-menu And Logging in using web as "user1" And Sending a "PUT" to "/settings/users/user1/settings" with requesttoken | email | test@example.com | - | emailScope | private | + | emailScope | v2-private | And Sending a "PUT" to "/settings/users/user1/settings" with requesttoken - | emailScope | contacts | + | emailScope | v2-federated | # Disabled because it regularly fails on drone: # When Logging in using web as "user0" # And searching for contacts matching with "test" @@ -170,7 +168,7 @@ Feature: contacts-menu And user "user1" exists And Logging in using web as "user1" And Sending a "PUT" to "/settings/users/user1/settings" with requesttoken - | displaynameScope | private | + | displaynameScope | v2-private | And As an "admin" And sending "PUT" to "/cloud/users/user1" with | key | displayname | @@ -185,7 +183,7 @@ Feature: contacts-menu And user "user1" exists And Logging in using web as "user1" And Sending a "PUT" to "/settings/users/user1/settings" with requesttoken - | emailScope | private | + | emailScope | v2-private | And As an "admin" And sending "PUT" to "/cloud/users/user1" with | key | email | diff --git a/build/integration/features/provisioning-v1.feature b/build/integration/features/provisioning-v1.feature index 12498bedd7f..8fcfb076497 100644 --- a/build/integration/features/provisioning-v1.feature +++ b/build/integration/features/provisioning-v1.feature @@ -4,6 +4,9 @@ Feature: provisioning Background: Given using api version "1" + Given parameter "whitelist_0" of app "bruteForce" is set to "127.0.0.1" + Given parameter "whitelist_1" of app "bruteForce" is set to "::1" + Given parameter "apply_allowlist_to_ratelimit" of app "bruteforcesettings" is set to "true" Scenario: Getting an not existing user Given As an "admin" @@ -69,7 +72,8 @@ Feature: provisioning | phone | | address | | website | - | twitter | + | twitter | + | bluesky | | fediverse | | organisation | | role | @@ -86,6 +90,7 @@ Feature: provisioning | address | | website | | twitter | + | bluesky | | fediverse | | organisation | | role | @@ -101,6 +106,7 @@ Feature: provisioning | address | | website | | twitter | + | bluesky | | fediverse | | organisation | | role | @@ -155,6 +161,9 @@ Feature: provisioning And sending "PUT" to "/cloud/users/brand-new-user" with | key | twitter | | value | Nextcloud | + And sending "PUT" to "/cloud/users/brand-new-user" with + | key | bluesky | + | value | nextcloud.bsky.social | And the OCS status code should be "100" And the HTTP status code should be "200" Then user "brand-new-user" has @@ -165,7 +174,37 @@ Feature: provisioning | phone | +4971125242890 | | address | Foo Bar Town | | website | https://nextcloud.com | - | twitter | Nextcloud | + | twitter | Nextcloud | + | bluesky | nextcloud.bsky.social | + And sending "PUT" to "/cloud/users/brand-new-user" with + | key | organisation | + | value | Nextcloud GmbH | + And sending "PUT" to "/cloud/users/brand-new-user" with + | key | role | + | value | Engineer | + And the OCS status code should be "100" + And the HTTP status code should be "200" + Then user "brand-new-user" has the following profile data + | userId | brand-new-user | + | displayname | Brand New User | + | organisation | Nextcloud GmbH | + | role | Engineer | + | address | Foo Bar Town | + | timezone | UTC | + | timezoneOffset | 0 | + | pronouns | NULL | + + Scenario: Edit a user with mixed case emails + Given As an "admin" + And user "brand-new-user" exists + And sending "PUT" to "/cloud/users/brand-new-user" with + | key | email | + | value | mixed-CASE@Nextcloud.com | + And the OCS status code should be "100" + And the HTTP status code should be "200" + Then user "brand-new-user" has + | id | brand-new-user | + | email | mixed-case@nextcloud.com | Scenario: Edit a user account properties scopes Given user "brand-new-user" exists @@ -180,6 +219,11 @@ Feature: provisioning | value | v2-local | Then the OCS status code should be "100" And the HTTP status code should be "200" + When sending "PUT" to "/cloud/users/brand-new-user" with + | key | blueskyScope | + | value | v2-local | + Then the OCS status code should be "100" + And the HTTP status code should be "200" When sending "PUT" to "/cloud/users/brand-new-user" with | key | addressScope | | value | v2-federated | @@ -190,21 +234,6 @@ Feature: provisioning | value | v2-published | Then the OCS status code should be "100" And the HTTP status code should be "200" - When sending "PUT" to "/cloud/users/brand-new-user" with - | key | websiteScope | - | value | public | - Then the OCS status code should be "100" - And the HTTP status code should be "200" - When sending "PUT" to "/cloud/users/brand-new-user" with - | key | displaynameScope | - | value | contacts | - Then the OCS status code should be "100" - And the HTTP status code should be "200" - When sending "PUT" to "/cloud/users/brand-new-user" with - | key | avatarScope | - | value | private | - Then the OCS status code should be "100" - And the HTTP status code should be "200" And sending "PUT" to "/cloud/users/brand-new-user" with | key | email | | value | no-reply@nextcloud.com | @@ -230,12 +259,10 @@ Feature: provisioning Then user "brand-new-user" has | id | brand-new-user | | phoneScope | v2-private | - | twitterScope | v2-local | + | twitterScope | v2-local | + | blueskyScope | v2-local | | addressScope | v2-federated | | emailScope | v2-published | - | websiteScope | v2-published | - | displaynameScope | v2-federated | - | avatarScope | v2-local | Scenario: Edit a user account multivalue property scopes Given user "brand-new-user" exists @@ -450,6 +477,7 @@ Feature: provisioning Then groups returned are | España | | admin | + | hidden_group | | new-group | Scenario: create a subadmin @@ -604,6 +632,7 @@ Feature: provisioning | settings | | sharebymail | | systemtags | + | testing | | theming | | twofactor_backupcodes | | updatenotification | @@ -629,6 +658,7 @@ Feature: provisioning And the HTTP status code should be "200" Scenario: enable an app + Given invoking occ with "app:disable testing" Given As an "admin" And app "testing" is disabled When sending "POST" to "/cloud/apps/testing" @@ -643,12 +673,14 @@ Feature: provisioning And the HTTP status code should be "200" Scenario: disable an app + Given invoking occ with "app:enable testing" Given As an "admin" And app "testing" is enabled When sending "DELETE" to "/cloud/apps/testing" Then the OCS status code should be "100" And the HTTP status code should be "200" And app "testing" is disabled + Given invoking occ with "app:enable testing" Scenario: disable an user Given As an "admin" diff --git a/build/integration/federation_features/federated.feature b/build/integration/federation_features/federated.feature index 81a3d3abd02..d3a414cb804 100644 --- a/build/integration/federation_features/federated.feature +++ b/build/integration/federation_features/federated.feature @@ -8,7 +8,7 @@ Feature: federated Scenario: Federate share a file with another server Given Using server "REMOTE" And user "user1" exists - And Using server "LOCAL" + Given Using server "LOCAL" And user "user0" exists When User "user0" from server "LOCAL" shares "/textfile0.txt" with user "user1" from server "REMOTE" Then the OCS status code should be "100" @@ -30,6 +30,12 @@ Feature: federated | displayname_owner | user0 | | share_with | user1@REMOTE | | share_with_displayname | user1 | + Given Using server "REMOTE" + And As an "user1" + And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" + And the list of returned shares has 0 shares + When sending "GET" to "/apps/files_sharing/api/v1/remote_shares/pending" + Then the list of returned shares has 1 shares Scenario: Federated group share a file with another server Given Using server "REMOTE" @@ -40,7 +46,7 @@ Feature: federated And As an "admin" And Add user "gs-user1" to the group "group1" And Add user "gs-user2" to the group "group1" - And Using server "LOCAL" + Given Using server "LOCAL" And parameter "outgoing_server2server_group_share_enabled" of app "files_sharing" is set to "yes" And user "gs-user0" exists When User "gs-user0" from server "LOCAL" shares "/textfile0.txt" with group "group1" from server "REMOTE" @@ -64,11 +70,10 @@ Feature: federated | share_with | group1@REMOTE | | share_with_displayname | group1@REMOTE | - Scenario: Federate share a file with local server Given Using server "LOCAL" And user "user0" exists - And Using server "REMOTE" + Given Using server "REMOTE" And user "user1" exists When User "user1" from server "REMOTE" shares "/textfile0.txt" with user "user0" from server "LOCAL" Then the OCS status code should be "100" @@ -94,10 +99,10 @@ Feature: federated Scenario: Remote sharee can see the pending share Given Using server "REMOTE" And user "user1" exists - And Using server "LOCAL" + Given Using server "LOCAL" And user "user0" exists And User "user0" from server "LOCAL" shares "/textfile0.txt" with user "user1" from server "REMOTE" - And Using server "REMOTE" + Given Using server "REMOTE" And As an "user1" When sending "GET" to "/apps/files_sharing/api/v1/remote_shares/pending" Then the OCS status code should be "100" @@ -122,11 +127,11 @@ Feature: federated And As an "admin" And Add user "gs-user1" to the group "group1" And Add user "gs-user2" to the group "group1" - And Using server "LOCAL" + Given Using server "LOCAL" And parameter "outgoing_server2server_group_share_enabled" of app "files_sharing" is set to "yes" And user "gs-user0" exists When User "gs-user0" from server "LOCAL" shares "/textfile0.txt" with group "group1" from server "REMOTE" - And Using server "REMOTE" + Given Using server "REMOTE" And As an "gs-user1" When sending "GET" to "/apps/files_sharing/api/v1/remote_shares/pending" Then the OCS status code should be "100" @@ -159,7 +164,7 @@ Feature: federated Scenario: accept a pending remote share Given Using server "REMOTE" And user "user1" exists - And Using server "LOCAL" + Given Using server "LOCAL" And user "user0" exists And User "user0" from server "LOCAL" shares "/textfile0.txt" with user "user1" from server "REMOTE" When User "user1" from server "REMOTE" accepts last pending share @@ -175,7 +180,7 @@ Feature: federated And As an "admin" And Add user "gs-user1" to the group "group1" And Add user "gs-user2" to the group "group1" - And Using server "LOCAL" + Given Using server "LOCAL" And parameter "outgoing_server2server_group_share_enabled" of app "files_sharing" is set to "yes" And user "gs-user0" exists When User "gs-user0" from server "LOCAL" shares "/textfile0.txt" with group "group1" from server "REMOTE" @@ -187,45 +192,45 @@ Feature: federated Given Using server "REMOTE" And user "user1" exists And user "user2" exists - And Using server "LOCAL" + Given Using server "LOCAL" And user "user0" exists And User "user0" from server "LOCAL" shares "/textfile0.txt" with user "user1" from server "REMOTE" And User "user1" from server "REMOTE" accepts last pending share - And Using server "REMOTE" + Given Using server "REMOTE" And As an "user1" When creating a share with | path | /textfile0 (2).txt | | shareType | 0 | | shareWith | user2 | | permissions | 19 | - #Then the OCS status code should be "100" - #And the HTTP status code should be "200" - #And Share fields of last share match with - # | id | A_NUMBER | - # | item_type | file | - # | item_source | A_NUMBER | - # | share_type | 0 | - # | file_source | A_NUMBER | - # | path | /textfile0 (2).txt | - # | permissions | 19 | - # | stime | A_NUMBER | - # | storage | A_NUMBER | - # | mail_send | 1 | - # | uid_owner | user1 | - # | file_parent | A_NUMBER | - # | displayname_owner | user1 | - # | share_with | user2 | - # | share_with_displayname | user2 | + # Then the OCS status code should be "100" + # And the HTTP status code should be "200" + # And Share fields of last share match with + # | id | A_NUMBER | + # | item_type | file | + # | item_source | A_NUMBER | + # | share_type | 0 | + # | file_source | A_NUMBER | + # | path | /textfile0 (2).txt | + # | permissions | 19 | + # | stime | A_NUMBER | + # | storage | A_NUMBER | + # | mail_send | 1 | + # | uid_owner | user1 | + # | file_parent | A_NUMBER | + # | displayname_owner | user1 | + # | share_with | user2 | + # | share_with_displayname | user2 | Scenario: Overwrite a federated shared file as recipient Given Using server "REMOTE" And user "user1" exists And user "user2" exists - And Using server "LOCAL" + Given Using server "LOCAL" And user "user0" exists And User "user0" from server "LOCAL" shares "/textfile0.txt" with user "user1" from server "REMOTE" And User "user1" from server "REMOTE" accepts last pending share - And Using server "REMOTE" + Given Using server "REMOTE" And As an "user1" And User "user1" modifies text of "/textfile0.txt" with text "BLABLABLA" When User "user1" uploads file "../../data/user1/files/textfile0.txt" to "/textfile0 (2).txt" @@ -236,16 +241,16 @@ Feature: federated Given Using server "REMOTE" And user "user1" exists And user "user2" exists - And Using server "LOCAL" + Given Using server "LOCAL" And user "user0" exists And User "user0" from server "LOCAL" shares "/PARENT" with user "user1" from server "REMOTE" And User "user1" from server "REMOTE" accepts last pending share - And Using server "REMOTE" + Given Using server "REMOTE" And As an "user1" And User "user1" modifies text of "/textfile0.txt" with text "BLABLABLA" - #When User "user1" uploads file "../../data/user1/files/textfile0.txt" to "/PARENT (2)/textfile0.txt" - #And Downloading file "/PARENT (2)/textfile0.txt" with range "bytes=0-8" - #Then Downloaded content should be "BLABLABLA" + When User "user1" uploads file "../../data/user1/files/textfile0.txt" to "/PARENT (2)/textfile0.txt" + And Downloading file "/PARENT (2)/textfile0.txt" with range "bytes=0-8" + Then Downloaded content should be "BLABLABLA" Scenario: List federated share from another server not accepted yet Given Using server "LOCAL" @@ -256,7 +261,7 @@ Feature: federated # server may have its own /textfile0.txt" file) And User "user1" copies file "/textfile0.txt" to "/remote-share.txt" And User "user1" from server "REMOTE" shares "/remote-share.txt" with user "user0" from server "LOCAL" - And Using server "LOCAL" + Given Using server "LOCAL" When As an "user0" And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" Then the list of returned shares has 0 shares @@ -270,7 +275,7 @@ Feature: federated # server may have its own /textfile0.txt" file) And User "user1" copies file "/textfile0.txt" to "/remote-share.txt" And User "user1" from server "REMOTE" shares "/remote-share.txt" with user "user0" from server "LOCAL" - And Using server "LOCAL" + Given Using server "LOCAL" And User "user0" from server "LOCAL" accepts last pending share When As an "user0" And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" @@ -296,7 +301,7 @@ Feature: federated # server may have its own /textfile0.txt" file) And User "user1" copies file "/textfile0.txt" to "/remote-share.txt" And User "user1" from server "REMOTE" shares "/remote-share.txt" with user "user0" from server "LOCAL" - And Using server "LOCAL" + Given Using server "LOCAL" And User "user0" from server "LOCAL" accepts last pending share And remote server is stopped When As an "user0" @@ -318,7 +323,7 @@ Feature: federated # server may have its own /textfile0.txt" file) And User "user1" copies file "/textfile0.txt" to "/remote-share.txt" And User "user1" from server "REMOTE" shares "/remote-share.txt" with user "user0" from server "LOCAL" - And Using server "LOCAL" + Given Using server "LOCAL" And User "user0" from server "LOCAL" accepts last pending share # Checking that the file exists caches the file entry, which causes an # exception to be thrown when getting the file info if the remote server is @@ -335,8 +340,6 @@ Feature: federated | user | user0 | | mountpoint | /remote-share.txt | - - Scenario: Delete federated share with another server Given Using server "LOCAL" And user "user0" exists @@ -349,13 +352,13 @@ Feature: federated And As an "user1" And sending "GET" to "/apps/files_sharing/api/v1/shares" And the list of returned shares has 1 shares - And Using server "LOCAL" + Given Using server "LOCAL" And User "user0" from server "LOCAL" accepts last pending share And as "user0" the file "/remote-share.txt" exists And As an "user0" And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" And the list of returned shares has 1 shares - And Using server "REMOTE" + Given Using server "REMOTE" When As an "user1" And Deleting last share Then the OCS status code should be "100" @@ -363,7 +366,7 @@ Feature: federated And As an "user1" And sending "GET" to "/apps/files_sharing/api/v1/shares" And the list of returned shares has 0 shares - And Using server "LOCAL" + Given Using server "LOCAL" And as "user0" the file "/remote-share.txt" does not exist And As an "user0" And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" @@ -381,7 +384,7 @@ Feature: federated And As an "user1" And sending "GET" to "/apps/files_sharing/api/v1/shares" And the list of returned shares has 1 shares - And Using server "LOCAL" + Given Using server "LOCAL" And User "user0" from server "LOCAL" accepts last pending share And as "user0" the file "/remote-share.txt" exists And As an "user0" @@ -394,7 +397,7 @@ Feature: federated And As an "user0" And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" And the list of returned shares has 0 shares - And Using server "REMOTE" + Given Using server "REMOTE" And As an "user1" And sending "GET" to "/apps/files_sharing/api/v1/shares" And the list of returned shares has 0 shares @@ -408,7 +411,7 @@ Feature: federated # server may have its own /textfile0.txt" file) And User "user1" copies file "/textfile0.txt" to "/remote-share.txt" And User "user1" from server "REMOTE" shares "/remote-share.txt" with user "user0" from server "LOCAL" - And Using server "LOCAL" + Given Using server "LOCAL" And User "user0" from server "LOCAL" accepts last pending share And as "user0" the file "/remote-share.txt" exists And As an "user0" @@ -435,7 +438,7 @@ Feature: federated And As an "user1" And sending "GET" to "/apps/files_sharing/api/v1/shares" And the list of returned shares has 1 shares - And Using server "LOCAL" + Given Using server "LOCAL" And User "user0" from server "LOCAL" accepts last pending share And as "user0" the file "/remote-share.txt" exists And As an "user0" @@ -447,7 +450,7 @@ Feature: federated And As an "user0" And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" And the list of returned shares has 0 shares - And Using server "REMOTE" + Given Using server "REMOTE" And As an "user1" And sending "GET" to "/apps/files_sharing/api/v1/shares" And the list of returned shares has 0 shares @@ -461,7 +464,7 @@ Feature: federated # server may have its own /textfile0.txt" file) And User "user1" copies file "/textfile0.txt" to "/remote-share.txt" And User "user1" from server "REMOTE" shares "/remote-share.txt" with user "user0" from server "LOCAL" - And Using server "LOCAL" + Given Using server "LOCAL" And User "user0" from server "LOCAL" accepts last pending share And as "user0" the file "/remote-share.txt" exists And As an "user0" @@ -474,3 +477,115 @@ Feature: federated And As an "user0" And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" And the list of returned shares has 0 shares + + Scenario: Share to a non-trusted server will NOT auto accept + Given Using server "LOCAL" + And user "user0" exists + Given Using server "REMOTE" + And user "userfed2" exists + And parameter "federated_trusted_share_auto_accept" of app "files_sharing" is set to "yes" + When As an "user0" + When User "user0" from server "LOCAL" shares "/textfile0.txt" with user "userfed2" from server "REMOTE" + Then the OCS status code should be "100" + And the HTTP status code should be "200" + And sending "GET" to "/apps/files_sharing/api/v1/shares?shared_with_me=false" + And the list of returned shares has 1 shares + Given Using server "REMOTE" + And using new dav path + And As an "userfed2" + And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" + And the list of returned shares has 0 shares + When sending "GET" to "/apps/files_sharing/api/v1/remote_shares/pending" + And the list of returned shares has 1 shares + And as "userfed2" the file "/textfile0 (2).txt" does not exist + + Scenario: Share to a non-trusted server group will NOT auto accept + Given Using server "REMOTE" + And parameter "incoming_server2server_group_share_enabled" of app "files_sharing" is set to "yes" + And parameter "federated_trusted_share_auto_accept" of app "files_sharing" is set to "yes" + And user "gs-userfed3" exists + And user "gs-userfed4" exists + And group "groupfed2" exists + And As an "admin" + And Add user "gs-userfed3" to the group "groupfed2" + And Add user "gs-userfed4" to the group "groupfed2" + Given Using server "LOCAL" + And parameter "outgoing_server2server_group_share_enabled" of app "files_sharing" is set to "yes" + And user "gs-user0" exists + When As an "gs-user0" + When User "gs-user0" from server "LOCAL" shares "/textfile0.txt" with group "groupfed2" from server "REMOTE" + Then the OCS status code should be "100" + And the HTTP status code should be "200" + And sending "GET" to "/apps/files_sharing/api/v1/shares?shared_with_me=false" + And the list of returned shares has 1 shares + Given Using server "REMOTE" + And using new dav path + And As an "gs-userfed3" + And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" + And the list of returned shares has 0 shares + When sending "GET" to "/apps/files_sharing/api/v1/remote_shares/pending" + And the list of returned shares has 1 shares + And as "gs-userfed3" the file "/textfile0 (2).txt" does not exist + And As an "gs-userfed4" + And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" + And the list of returned shares has 0 shares + When sending "GET" to "/apps/files_sharing/api/v1/remote_shares/pending" + And the list of returned shares has 1 shares + And as "gs-userfed4" the file "/textfile0 (2).txt" does not exist + + @TrustedFederation + Scenario: Share to a trusted server auto accept + Given Using server "LOCAL" + And user "user0" exists + Given Using server "REMOTE" + And user "userfed1" exists + And parameter "federated_trusted_share_auto_accept" of app "files_sharing" is set to "yes" + When As an "user0" + When User "user0" from server "LOCAL" shares "/textfile0.txt" with user "userfed1" from server "REMOTE" + Then the OCS status code should be "100" + And the HTTP status code should be "200" + And sending "GET" to "/apps/files_sharing/api/v1/shares?shared_with_me=false" + And the list of returned shares has 1 shares + Given Using server "REMOTE" + And using new dav path + And As an "userfed1" + And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" + And the list of returned shares has 1 shares + When sending "GET" to "/apps/files_sharing/api/v1/remote_shares/pending" + And the list of returned shares has 0 shares + And as "userfed1" the file "/textfile0 (2).txt" exists + + @TrustedFederation + Scenario: Share to a trusted server group auto accept + Given Using server "REMOTE" + And parameter "incoming_server2server_group_share_enabled" of app "files_sharing" is set to "yes" + And parameter "federated_trusted_share_auto_accept" of app "files_sharing" is set to "yes" + And user "gs-userfed1" exists + And user "gs-userfed2" exists + And group "groupfed1" exists + And As an "admin" + And Add user "gs-userfed1" to the group "groupfed1" + And Add user "gs-userfed2" to the group "groupfed1" + Given Using server "LOCAL" + And parameter "outgoing_server2server_group_share_enabled" of app "files_sharing" is set to "yes" + And user "gs-user0" exists + When As an "gs-user0" + When User "gs-user0" from server "LOCAL" shares "/textfile0.txt" with group "groupfed1" from server "REMOTE" + Then the OCS status code should be "100" + And the HTTP status code should be "200" + And sending "GET" to "/apps/files_sharing/api/v1/shares?shared_with_me=false" + And the list of returned shares has 1 shares + Given Using server "REMOTE" + And using new dav path + And As an "gs-userfed1" + And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" + And the list of returned shares has 1 shares + When sending "GET" to "/apps/files_sharing/api/v1/remote_shares/pending" + And the list of returned shares has 0 shares + And as "gs-userfed1" the file "/textfile0 (2).txt" exists + And As an "gs-userfed2" + And sending "GET" to "/apps/files_sharing/api/v1/remote_shares" + And the list of returned shares has 1 shares + When sending "GET" to "/apps/files_sharing/api/v1/remote_shares/pending" + And the list of returned shares has 0 shares + And as "gs-userfed2" the file "/textfile0 (2).txt" exists diff --git a/build/integration/file_conversions/file_conversions.feature b/build/integration/file_conversions/file_conversions.feature new file mode 100644 index 00000000000..92dc11a647a --- /dev/null +++ b/build/integration/file_conversions/file_conversions.feature @@ -0,0 +1,122 @@ +# SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors +# SPDX-License-Identifier: AGPL-3.0-only + +Feature: conversions + Background: + Given using api version "2" + Given using new dav path + Given user "user0" exists + + Scenario: Converting a file works + Given user "user0" uploads file "data/clouds.jpg" to "/image.jpg" + Then as "user0" the file "/image.jpg" exists + When user "user0" converts file "/image.jpg" to "image/png" + Then the HTTP status code should be "201" + Then the OCS status code should be "201" + Then as "user0" the file "/image.png" exists + + Scenario: Converting a file to a given path works + Given user "user0" uploads file "data/clouds.jpg" to "/image.jpg" + And User "user0" created a folder "/folder" + Then as "user0" the file "/image.jpg" exists + Then as "user0" the folder "/folder" exists + When user "user0" converts file "/image.jpg" to "image/png" and saves it to "/folder/image.png" + Then the HTTP status code should be "201" + Then the OCS status code should be "201" + Then as "user0" the file "/folder/image.png" exists + Then as "user0" the file "/image.png" does not exist + + Scenario: Converting a file path with overwrite + Given user "user0" uploads file "data/clouds.jpg" to "/image.jpg" + And user "user0" uploads file "data/green-square-256.png" to "/image.png" + Then as "user0" the file "/image.jpg" exists + Then as "user0" the file "/image.png" exists + When user "user0" converts file "/image.jpg" to "image/png" + Then the HTTP status code should be "201" + Then the OCS status code should be "201" + Then as "user0" the file "/image.jpg" exists + Then as "user0" the file "/image.png" exists + Then as "user0" the file "/image (2).png" exists + + Scenario: Converting a file path with overwrite to a given path + Given user "user0" uploads file "data/clouds.jpg" to "/image.jpg" + And User "user0" created a folder "/folder" + And user "user0" uploads file "data/green-square-256.png" to "/folder/image.png" + Then as "user0" the file "/image.jpg" exists + Then as "user0" the folder "/folder" exists + Then as "user0" the file "/folder/image.png" exists + When user "user0" converts file "/image.jpg" to "image/png" and saves it to "/folder/image.png" + Then the HTTP status code should be "201" + Then the OCS status code should be "201" + Then as "user0" the file "/folder/image.png" exists + Then as "user0" the file "/folder/image (2).png" exists + Then as "user0" the file "/image.png" does not exist + Then as "user0" the file "/image.jpg" exists + + Scenario: Converting a file which does not exist fails + When user "user0" converts file "/image.jpg" to "image/png" + Then the HTTP status code should be "404" + Then the OCS status code should be "404" + Then as "user0" the file "/image.jpg" does not exist + Then as "user0" the file "/image.png" does not exist + + Scenario: Converting a file to an invalid destination path fails + Given user "user0" uploads file "data/clouds.jpg" to "/image.jpg" + When user "user0" converts file "/image.jpg" to "image/png" and saves it to "/folder/image.png" + Then the HTTP status code should be "404" + Then the OCS status code should be "404" + Then as "user0" the file "/image.jpg" exists + Then as "user0" the file "/folder/image.png" does not exist + + Scenario: Converting a file to an invalid format fails + Given user "user0" uploads file "data/clouds.jpg" to "/image.jpg" + When user "user0" converts file "/image.jpg" to "image/invalid" + Then the HTTP status code should be "500" + Then the OCS status code should be "999" + Then as "user0" the file "/image.jpg" exists + Then as "user0" the file "/image.png" does not exist + +Scenario: Converting a file to a given path without extension fails + Given user "user0" uploads file "data/clouds.jpg" to "/image.jpg" + And User "user0" created a folder "/folder" + Then as "user0" the file "/image.jpg" exists + Then as "user0" the folder "/folder" exists + When user "user0" converts file "/image.jpg" to "image/png" and saves it to "/folder/image" + Then the HTTP status code should be "400" + Then the OCS status code should be "400" + Then as "user0" the file "/folder/image.png" does not exist + Then as "user0" the file "/image.png" does not exist + + @local_storage + Scenario: Converting a file bigger than 100 MiB fails + Given file "/image.jpg" of size 108003328 is created in local storage + Then as "user0" the folder "/local_storage" exists + Then as "user0" the file "/local_storage/image.jpg" exists + When user "user0" converts file "/local_storage/image.jpg" to "image/png" and saves it to "/image.png" + Then the HTTP status code should be "400" + Then the OCS status code should be "400" + Then as "user0" the file "/image.png" does not exist + + Scenario: Forbid conversion to a destination without create permission + Given user "user1" exists + # Share the folder with user1 + Given User "user0" created a folder "/folder" + Then As an "user0" + When creating a share with + | path | folder | + | shareWith | user1 | + | shareType | 0 | + | permissions | 1 | + Then the OCS status code should be "200" + And the HTTP status code should be "200" + # Create the folder, upload the image + Then As an "user1" + Given user "user1" accepts last share + Given as "user1" the folder "/folder" exists + Given user "user1" uploads file "data/clouds.jpg" to "/image.jpg" + Then as "user1" the file "/image.jpg" exists + # Try to convert the image to a folder where user1 has no create permission + When user "user1" converts file "/image.jpg" to "image/png" and saves it to "/folder/folder.png" + Then the OCS status code should be "403" + And the HTTP status code should be "403" + Then as "user1" the file "/folder/folder.png" does not exist diff --git a/build/integration/files_features/metadata.feature b/build/integration/files_features/metadata.feature new file mode 100644 index 00000000000..553a7b62306 --- /dev/null +++ b/build/integration/files_features/metadata.feature @@ -0,0 +1,16 @@ +# SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors +# SPDX-License-Identifier: AGPL-3.0-only +Feature: metadata + + Scenario: Setting metadata works + Given user "user0" exists + When User "user0" uploads file with content "AAA" to "/test.txt" + And User "user0" sets the "metadata-files-live-photo" prop with value "metadata-value" on "/test.txt" + Then User "user0" should see the prop "metadata-files-live-photo" equal to "metadata-value" for file "/test.txt" + + Scenario: Deleting metadata works + Given user "user0" exists + When User "user0" uploads file with content "AAA" to "/test.txt" + And User "user0" sets the "metadata-files-live-photo" prop with value "metadata-value" on "/test.txt" + And User "user0" deletes the "metadata-files-live-photo" prop on "/test.txt" + Then User "user0" should not see the prop "metadata-files-live-photo" for file "/test.txt" diff --git a/build/integration/files_features/transfer-ownership.feature b/build/integration/files_features/transfer-ownership.feature index 4e5407cadbb..6f7a7944166 100644 --- a/build/integration/files_features/transfer-ownership.feature +++ b/build/integration/files_features/transfer-ownership.feature @@ -184,10 +184,10 @@ Feature: transfer-ownership And As an "user2" Then Downloaded content when downloading file "/test/somefile.txt" with range "bytes=0-6" should be "This is" And using old dav path - And as "user0" the folder "/test" exists + And as "user0" the folder "/test" does not exist And using received transfer folder of "user1" as dav path - And as "user1" the folder "/test" does not exist - And As an "user0" + And as "user1" the folder "/test" exists + And As an "user1" And Getting info of last share And the OCS status code should be "100" And Share fields of last share match with @@ -210,13 +210,12 @@ Feature: transfer-ownership And user "user1" accepts last share When transferring ownership from "user0" to "user1" And the command was successful - And As an "user1" - Then Downloaded content when downloading file "/test/somefile.txt" with range "bytes=0-6" should be "This is" And using old dav path - And as "user0" the folder "/test" exists + Then as "user0" the folder "/test" does not exist + When As an "user1" And using received transfer folder of "user1" as dav path - And as "user1" the folder "/test" does not exist - And As an "user1" + Then as "user1" the folder "/test" exists + And Downloaded content when downloading file "/test/somefile.txt" with range "bytes=0-6" should be "This is" And Getting info of last share And the OCS status code should be "100" And Share fields of last share match with @@ -242,10 +241,10 @@ Feature: transfer-ownership And As an "user2" Then Downloaded content when downloading file "/test/somefile.txt" with range "bytes=0-6" should be "This is" And using old dav path - And as "user0" the folder "/test" exists + And as "user0" the folder "/test" does not exist And using received transfer folder of "user1" as dav path - And as "user1" the folder "/test" does not exist - And As an "user0" + And as "user1" the folder "/test" exists + And As an "user1" And Getting info of last share And the OCS status code should be "100" And Share fields of last share match with @@ -253,7 +252,7 @@ Feature: transfer-ownership | uid_file_owner | user3 | | share_with | group1 | - Scenario: transferring ownership does not transfer received shares + Scenario: transferring ownership transfers received shares Given user "user0" exists And user "user1" exists And user "user2" exists @@ -264,16 +263,16 @@ Feature: transfer-ownership And the command was successful And As an "user1" And using received transfer folder of "user1" as dav path - Then as "user1" the folder "/test" does not exist + Then as "user1" the folder "/test" exists And using old dav path - And as "user0" the folder "/test" exists + And as "user0" the folder "/test" does not exist And As an "user2" And Getting info of last share And the OCS status code should be "100" And Share fields of last share match with | uid_owner | user2 | | uid_file_owner | user2 | - | share_with | user0 | + | share_with | user1 | @local_storage Scenario: transferring ownership does not transfer external storage @@ -516,26 +515,6 @@ Feature: transfer-ownership Then the command failed with exit code 1 And the command error output contains the text "Moving a storage (user0/files/test) into another storage (user1) is not allowed" - Scenario: transferring ownership does not transfer received shares - Given user "user0" exists - And user "user1" exists - And user "user2" exists - And User "user2" created a folder "/test" - And User "user0" created a folder "/sub" - And folder "/test" of user "user2" is shared with user "user0" with permissions 31 - And user "user0" accepts last share - And User "user0" moved folder "/test" to "/sub/test" - When transferring ownership of path "sub" from "user0" to "user1" - And the command was successful - And As an "user1" - And using received transfer folder of "user1" as dav path - Then as "user1" the folder "/sub" exists - And as "user1" the folder "/sub/test" does not exist - And using old dav path - And as "user0" the folder "/sub" does not exist - And Getting info of last share - And the OCS status code should be "404" - Scenario: transferring ownership transfers received shares into subdir when requested Given user "user0" exists And user "user1" exists @@ -548,7 +527,7 @@ Feature: transfer-ownership And User "user0" moved folder "/transfer-share" to "/sub/transfer-share" And folder "/do-not-transfer" of user "user2" is shared with user "user0" with permissions 31 And user "user0" accepts last share - When transferring ownership of path "sub" from "user0" to "user1" with received shares + When transferring ownership of path "sub" from "user0" to "user1" And the command was successful And As an "user1" And using received transfer folder of "user1" as dav path diff --git a/build/integration/files_features/windows_compatibility.feature b/build/integration/files_features/windows_compatibility.feature new file mode 100644 index 00000000000..feaaca1ed3a --- /dev/null +++ b/build/integration/files_features/windows_compatibility.feature @@ -0,0 +1,68 @@ +# SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors +# SPDX-License-Identifier: AGPL-3.0-or-later + +Feature: Windows compatible filenames + Background: + Given using api version "1" + And using new dav path + And As an "admin" + + Scenario: prevent upload files with invalid name + Given As an "admin" + And user "user0" exists + And invoking occ with "files:windows-compatible-filenames --enable" + Given User "user0" created a folder "/com1" + Then as "user0" the file "/com1" does not exist + + Scenario: renaming a folder with invalid name + Given As an "admin" + When invoking occ with "files:windows-compatible-filenames --disable" + And user "user0" exists + Given User "user0" created a folder "/aux" + When invoking occ with "files:windows-compatible-filenames --enable" + And invoking occ with "files:sanitize-filenames user0" + Then as "user0" the file "/aux" does not exist + And as "user0" the file "/aux (renamed)" exists + + Scenario: renaming a file with invalid base name + Given As an "admin" + When invoking occ with "files:windows-compatible-filenames --disable" + And user "user0" exists + When User "user0" uploads file with content "hello" to "/com0.txt" + And invoking occ with "files:windows-compatible-filenames --enable" + And invoking occ with "files:sanitize-filenames user0" + Then as "user0" the file "/com0.txt" does not exist + And as "user0" the file "/com0 (renamed).txt" exists + + Scenario: renaming a file with invalid extension + Given As an "admin" + When invoking occ with "files:windows-compatible-filenames --disable" + And user "user0" exists + When User "user0" uploads file with content "hello" to "/foo.txt." + And as "user0" the file "/foo.txt." exists + And invoking occ with "files:windows-compatible-filenames --enable" + And invoking occ with "files:sanitize-filenames user0" + Then as "user0" the file "/foo.txt." does not exist + And as "user0" the file "/foo.txt" exists + + Scenario: renaming a file with invalid character + Given As an "admin" + When invoking occ with "files:windows-compatible-filenames --disable" + And user "user0" exists + When User "user0" uploads file with content "hello" to "/2*2=4.txt" + And as "user0" the file "/2*2=4.txt" exists + And invoking occ with "files:windows-compatible-filenames --enable" + And invoking occ with "files:sanitize-filenames user0" + Then as "user0" the file "/2*2=4.txt" does not exist + And as "user0" the file "/2_2=4.txt" exists + + Scenario: renaming a file with invalid character and replacement setup + Given As an "admin" + When invoking occ with "files:windows-compatible-filenames --disable" + And user "user0" exists + When User "user0" uploads file with content "hello" to "/2*3=6.txt" + And as "user0" the file "/2*3=6.txt" exists + And invoking occ with "files:windows-compatible-filenames --enable" + And invoking occ with "files:sanitize-filenames --char-replacement + user0" + Then as "user0" the file "/2*3=6.txt" does not exist + And as "user0" the file "/2+3=6.txt" exists diff --git a/build/integration/filesdrop_features/filesdrop.feature b/build/integration/filesdrop_features/filesdrop.feature index 2c9156dea02..7618a31a1d0 100644 --- a/build/integration/filesdrop_features/filesdrop.feature +++ b/build/integration/filesdrop_features/filesdrop.feature @@ -33,7 +33,7 @@ Feature: FilesDrop And Downloading file "/drop/a (2).txt" Then Downloaded content should be "def" - Scenario: Files drop ignores directory + Scenario: Files drop forbid directory without a nickname Given user "user0" exists And As an "user0" And user "user0" created a folder "/drop" @@ -44,10 +44,9 @@ Feature: FilesDrop And Updating last share with | permissions | 4 | When Dropping file "/folder/a.txt" with "abc" - And Downloading file "/drop/a.txt" - Then Downloaded content should be "abc" + Then the HTTP status code should be "400" - Scenario: Files drop forbis MKCOL + Scenario: Files drop forbid MKCOL without a nickname Given user "user0" exists And As an "user0" And user "user0" created a folder "/drop" @@ -58,7 +57,33 @@ Feature: FilesDrop And Updating last share with | permissions | 4 | When Creating folder "folder" in drop - Then the HTTP status code should be "405" + Then the HTTP status code should be "400" + + Scenario: Files drop allows MKCOL with a nickname + Given user "user0" exists + And As an "user0" + And user "user0" created a folder "/drop" + And as "user0" creating a share with + | path | drop | + | shareType | 3 | + | publicUpload | true | + And Updating last share with + | permissions | 4 | + When Creating folder "folder" in drop as "nickname" + Then the HTTP status code should be "201" + + Scenario: Files drop forbid subfolder creation without a nickname + Given user "user0" exists + And As an "user0" + And user "user0" created a folder "/drop" + And as "user0" creating a share with + | path | drop | + | shareType | 3 | + | publicUpload | true | + And Updating last share with + | permissions | 4 | + When dropping file "/folder/a.txt" with "abc" + Then the HTTP status code should be "400" Scenario: Files request drop Given user "user0" exists @@ -71,9 +96,50 @@ Feature: FilesDrop | attributes | [{"scope":"fileRequest","key":"enabled","value":true}] | | shareWith | | When Dropping file "/folder/a.txt" with "abc" as "Alice" - And Downloading file "/drop/Alice/a.txt" + And Downloading file "/drop/Alice/folder/a.txt" + Then Downloaded content should be "abc" + + Scenario: File drop uploading folder with name of file + Given user "user0" exists + And As an "user0" + And user "user0" created a folder "/drop" + And as "user0" creating a share with + | path | drop | + | shareType | 4 | + | permissions | 4 | + | attributes | [{"scope":"fileRequest","key":"enabled","value":true}] | + | shareWith | | + When Dropping file "/folder" with "its a file" as "Alice" + Then the HTTP status code should be "201" + When Dropping file "/folder/a.txt" with "abc" as "Alice" + Then the HTTP status code should be "201" + When Downloading file "/drop/Alice/folder" + Then the HTTP status code should be "200" + And Downloaded content should be "its a file" + When Downloading file "/drop/Alice/folder (2)/a.txt" Then Downloaded content should be "abc" + Scenario: File drop uploading file with name of folder + Given user "user0" exists + And As an "user0" + And user "user0" created a folder "/drop" + And as "user0" creating a share with + | path | drop | + | shareType | 4 | + | permissions | 4 | + | attributes | [{"scope":"fileRequest","key":"enabled","value":true}] | + | shareWith | | + When Dropping file "/folder/a.txt" with "abc" as "Alice" + Then the HTTP status code should be "201" + When Dropping file "/folder" with "its a file" as "Alice" + Then the HTTP status code should be "201" + When Downloading file "/drop/Alice/folder/a.txt" + Then the HTTP status code should be "200" + And Downloaded content should be "abc" + When Downloading file "/drop/Alice/folder (2)" + Then the HTTP status code should be "200" + And Downloaded content should be "its a file" + Scenario: Put file same file multiple times via files drop Given user "user0" exists And As an "user0" @@ -86,7 +152,86 @@ Feature: FilesDrop | shareWith | | When Dropping file "/folder/a.txt" with "abc" as "Mallory" And Dropping file "/folder/a.txt" with "def" as "Mallory" - And Downloading file "/drop/Mallory/a.txt" + # Ensure folder structure and that we only checked + # for files duplicates, but merged the existing folders + Then as "user0" the folder "/drop/Mallory" exists + Then as "user0" the folder "/drop/Mallory/folder" exists + Then as "user0" the folder "/drop/Mallory (2)" does not exist + Then as "user0" the folder "/drop/Mallory/folder (2)" does not exist + Then as "user0" the file "/drop/Mallory/folder/a.txt" exists + Then as "user0" the file "/drop/Mallory/folder/a (2).txt" exists + And Downloading file "/drop/Mallory/folder/a.txt" Then Downloaded content should be "abc" - And Downloading file "/drop/Mallory/a (2).txt" + And Downloading file "/drop/Mallory/folder/a (2).txt" Then Downloaded content should be "def" + + Scenario: Files drop prevents GET + Given user "user0" exists + And As an "user0" + And user "user0" created a folder "/drop" + And as "user0" creating a share with + | path | drop | + | shareType | 4 | + | permissions | 4 | + | shareWith | | + | attributes | [{"scope":"fileRequest","key":"enabled","value":true}] | + When Dropping file "/folder/a.txt" with "abc" as "Mallory" + When as "user0" the file "/drop/Mallory/folder/a.txt" exists + And Downloading public folder "Mallory" + Then the HTTP status code should be "405" + And Downloading public folder "Mallory/folder" + Then the HTTP status code should be "405" + And Downloading public file "Mallory/folder/a.txt" + Then the HTTP status code should be "405" + + Scenario: Files drop requires nickname if file request is enabled + Given user "user0" exists + And As an "user0" + And user "user0" created a folder "/drop" + And as "user0" creating a share with + | path | drop | + | shareType | 4 | + | permissions | 4 | + | attributes | [{"scope":"fileRequest","key":"enabled","value":true}] | + | shareWith | | + When Dropping file "/folder/a.txt" with "abc" + Then the HTTP status code should be "400" + + Scenario: Files request drop with invalid nickname with slashes + Given user "user0" exists + And As an "user0" + And user "user0" created a folder "/drop" + And as "user0" creating a share with + | path | drop | + | shareType | 4 | + | permissions | 4 | + | attributes | [{"scope":"fileRequest","key":"enabled","value":true}] | + | shareWith | | + When Dropping file "/folder/a.txt" with "abc" as "Alice/Bob/Mallory" + Then the HTTP status code should be "400" + + Scenario: Files request drop with invalid nickname with forbidden characters + Given user "user0" exists + And As an "user0" + And user "user0" created a folder "/drop" + And as "user0" creating a share with + | path | drop | + | shareType | 4 | + | permissions | 4 | + | attributes | [{"scope":"fileRequest","key":"enabled","value":true}] | + | shareWith | | + When Dropping file "/folder/a.txt" with "abc" as ".htaccess" + Then the HTTP status code should be "400" + + Scenario: Files request drop with invalid nickname with forbidden characters + Given user "user0" exists + And As an "user0" + And user "user0" created a folder "/drop" + And as "user0" creating a share with + | path | drop | + | shareType | 4 | + | permissions | 4 | + | attributes | [{"scope":"fileRequest","key":"enabled","value":true}] | + | shareWith | | + When Dropping file "/folder/a.txt" with "abc" as ".Mallory" + Then the HTTP status code should be "400" diff --git a/build/integration/openldap_features/openldap-uid-username.feature b/build/integration/openldap_features/openldap-uid-username.feature index 9d5405e88bf..bee4098972b 100644 --- a/build/integration/openldap_features/openldap-uid-username.feature +++ b/build/integration/openldap_features/openldap-uid-username.feature @@ -151,6 +151,7 @@ Feature: LDAP | ldapAttributesForUserSearch | employeeNumber | | useMemberOfToDetectMembership | 1 | And parameter "shareapi_only_share_with_group_members" of app "core" is set to "yes" + And invoking occ with "ldap:check-group cn=Orcharding,ou=OtherGroups,dc=nextcloud,dc=ci --update" And As an "alice" When getting sharees for # "5" is part of the employee number of some LDAP records @@ -162,4 +163,3 @@ Feature: LDAP And "users" sharees returned are | Elisa | 0 | elisa | And "exact groups" sharees returned is empty - diff --git a/build/integration/features/ratelimiting.feature b/build/integration/ratelimiting_features/ratelimiting.feature index a2fca2fc6be..43cfddec85d 100644 --- a/build/integration/features/ratelimiting.feature +++ b/build/integration/ratelimiting_features/ratelimiting.feature @@ -1,5 +1,6 @@ # SPDX-FileCopyrightText: 2017 Nextcloud GmbH and Nextcloud contributors # SPDX-License-Identifier: AGPL-3.0-or-later +@RateLimiting Feature: ratelimiting Background: diff --git a/build/integration/routing_features/apps-and-routes.feature b/build/integration/routing_features/apps-and-routes.feature new file mode 100644 index 00000000000..954ea73bfac --- /dev/null +++ b/build/integration/routing_features/apps-and-routes.feature @@ -0,0 +1,52 @@ +# SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors +# SPDX-License-Identifier: AGPL-3.0-or-later +Feature: appmanagement + Background: + Given using api version "2" + And user "user1" exists + And user "user2" exists + And group "group1" exists + And user "user1" belongs to group "group1" + + Scenario: Enable app and test route + Given As an "admin" + And sending "DELETE" to "/cloud/apps/weather_status" + And app "weather_status" is disabled + When sending "GET" to "/apps/weather_status/api/v1/location" + Then the OCS status code should be "998" + And the HTTP status code should be "404" + When sending "POST" to "/cloud/apps/weather_status" + Then the OCS status code should be "200" + And the HTTP status code should be "200" + And app "weather_status" is enabled + When sending "GET" to "/apps/weather_status/api/v1/location" + Then the OCS status code should be "200" + And the HTTP status code should be "200" + Given As an "user1" + When sending "GET" to "/apps/weather_status/api/v1/location" + Then the OCS status code should be "200" + And the HTTP status code should be "200" + Given As an "user2" + When sending "GET" to "/apps/weather_status/api/v1/location" + Then the OCS status code should be "200" + And the HTTP status code should be "200" + + Scenario: Enable app only for some groups + Given As an "admin" + And sending "DELETE" to "/cloud/apps/weather_status" + And app "weather_status" is disabled + When sending "GET" to "/apps/weather_status/api/v1/location" + Then the OCS status code should be "998" + And the HTTP status code should be "404" + Given invoking occ with "app:enable weather_status --groups group1" + Then the command was successful + Given As an "user2" + When sending "GET" to "/apps/weather_status/api/v1/location" + Then the HTTP status code should be "412" + Given As an "user1" + When sending "GET" to "/apps/weather_status/api/v1/location" + Then the OCS status code should be "200" + And the HTTP status code should be "200" + Given As an "admin" + And sending "DELETE" to "/cloud/apps/weather_status" + And app "weather_status" is disabled diff --git a/build/integration/run.sh b/build/integration/run.sh index 309f8ed0c75..30dd0646b10 100755 --- a/build/integration/run.sh +++ b/build/integration/run.sh @@ -18,10 +18,18 @@ HIDE_OC_LOGS=$2 INSTALLED=$($OCC status | grep installed: | cut -d " " -f 5) if [ "$INSTALLED" == "true" ]; then + # Disable appstore to avoid spamming from CI + $OCC config:system:set appstoreenabled --value=false --type=boolean # Disable bruteforce protection because the integration tests do trigger them $OCC config:system:set auth.bruteforce.protection.enabled --value false --type bool + # Disable rate limit protection because the integration tests do trigger them + $OCC config:system:set ratelimit.protection.enabled --value false --type bool # Allow local remote urls otherwise we can not share $OCC config:system:set allow_local_remote_servers --value true --type bool + # Allow self signed certificates + $OCC config:system:set sharing.federation.allowSelfSignedCertificates --value true --type bool + # Allow creating users with dummy passwords + $OCC app:disable password_policy else if [ "$SCENARIO_TO_RUN" != "setup_features/setup.feature" ]; then echo "Nextcloud instance needs to be installed" >&2 @@ -38,6 +46,7 @@ if [ -z "$EXECUTOR_NUMBER" ]; then fi PORT=$((8080 + $EXECUTOR_NUMBER)) echo $PORT +export PORT echo "" > "${NC_DATADIR}/nextcloud.log" echo "" > phpserver.log diff --git a/build/integration/sharing_features/sharing-activity.feature b/build/integration/sharing_features/sharing-activity.feature new file mode 100644 index 00000000000..016b376488b --- /dev/null +++ b/build/integration/sharing_features/sharing-activity.feature @@ -0,0 +1,46 @@ +# SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors +# SPDX-License-Identifier: AGPL-3.0-or-later +Feature: sharing + Background: + Given using api version "1" + Given using new dav path + Given invoking occ with "app:enable --force activity" + Given the command was successful + Given user "user0" exists + And Logging in using web as "user0" + And Sending a "POST" to "/apps/activity/settings" with requesttoken + | public_links_notification | 1 | + | public_links_upload_notification | 1 | + | notify_setting_batchtime | 0 | + | activity_digest | 0 | + + Scenario: Creating a new mail share and check activity + Given dummy mail server is listening + And As an "user0" + When creating a share with + | path | welcome.txt | + | shareType | 4 | + | shareWith | dumy@test.com | + Then the OCS status code should be "100" + And the HTTP status code should be "200" + And last share can be downloaded + Then last activity should be + | app | files_sharing | + | type | public_links | + | object_type | files | + | object_name | /welcome.txt | + + Scenario: Creating a new public share and check activity + Given user "user0" exists + And As an "user0" + When creating a share with + | path | welcome.txt | + | shareType | 3 | + Then the OCS status code should be "100" + And the HTTP status code should be "200" + And last link share can be downloaded + Then last activity should be + | app | files_sharing | + | type | public_links | + | object_type | files | + | object_name | /welcome.txt | diff --git a/build/integration/sharing_features/sharing-v1-part2.feature b/build/integration/sharing_features/sharing-v1-part2.feature index 8cc97fe71ee..a6e4c67165a 100644 --- a/build/integration/sharing_features/sharing-v1-part2.feature +++ b/build/integration/sharing_features/sharing-v1-part2.feature @@ -543,6 +543,29 @@ Feature: sharing And the HTTP status code should be "200" And last share_id is included in the answer + Scenario: Group shares are deleted when the group is deleted + Given As an "admin" + And user "user0" exists + And user "user1" exists + And group "group0" exists + And user "user0" belongs to group "group0" + And file "textfile0.txt" of user "user1" is shared with group "group0" + And As an "user0" + When sending "GET" to "/apps/files_sharing/api/v1/shares?shared_with_me=true" + Then the OCS status code should be "100" + And the HTTP status code should be "200" + And last share_id is included in the answer + When group "group0" does not exist + Then sending "GET" to "/apps/files_sharing/api/v1/shares?shared_with_me=true" + And the OCS status code should be "100" + And the HTTP status code should be "200" + And last share_id is not included in the answer + When group "group0" exists + Then sending "GET" to "/apps/files_sharing/api/v1/shares?shared_with_me=true" + And the OCS status code should be "100" + And the HTTP status code should be "200" + And last share_id is not included in the answer + Scenario: User is not allowed to reshare file As an "admin" Given user "user0" exists @@ -701,6 +724,79 @@ Feature: sharing Then the OCS status code should be "404" And the HTTP status code should be "200" + Scenario: download restrictions can not be dropped + As an "admin" + Given user "user0" exists + And user "user1" exists + And user "user2" exists + And User "user0" uploads file with content "foo" to "/tmp.txt" + And As an "user0" + And creating a share with + | path | /tmp.txt | + | shareType | 0 | + | shareWith | user1 | + | permissions | 17 | + | attributes | [{"scope":"permissions","key":"download","value":false}] | + And As an "user1" + And accepting last share + When Getting info of last share + Then Share fields of last share match with + | uid_owner | user0 | + | uid_file_owner | user0 | + | permissions | 17 | + | attributes | [{"scope":"permissions","key":"download","value":false}] | + When creating a share with + | path | /tmp.txt | + | shareType | 0 | + | shareWith | user2 | + | permissions | 1 | + Then the OCS status code should be "100" + And the HTTP status code should be "200" + When As an "user2" + And accepting last share + And Getting info of last share + Then Share fields of last share match with + | share_type | 0 | + | permissions | 1 | + | uid_owner | user1 | + | uid_file_owner | user0 | + | attributes | [{"scope":"permissions","key":"download","value":false}] | + + Scenario: download restrictions can not be dropped when re-sharing even on link shares + As an "admin" + Given user "user0" exists + And user "user1" exists + And User "user0" uploads file with content "foo" to "/tmp.txt" + And As an "user0" + And creating a share with + | path | /tmp.txt | + | shareType | 0 | + | shareWith | user1 | + | permissions | 17 | + | attributes | [{"scope":"permissions","key":"download","value":false}] | + And As an "user1" + And accepting last share + When Getting info of last share + Then Share fields of last share match with + | uid_owner | user0 | + | attributes | [{"scope":"permissions","key":"download","value":false}] | + When creating a share with + | path | /tmp.txt | + | shareType | 3 | + | permissions | 1 | + And Getting info of last share + And Updating last share with + | hideDownload | false | + Then the OCS status code should be "100" + And the HTTP status code should be "200" + When Getting info of last share + Then Share fields of last share match with + | share_type | 3 | + | uid_owner | user1 | + | uid_file_owner | user0 | + | hide_download | 1 | + | attributes | [{"scope":"permissions","key":"download","value":false}] | + Scenario: User is not allowed to reshare file with additional delete permissions As an "admin" Given user "user0" exists @@ -1169,7 +1265,9 @@ Feature: sharing |{http://open-collaboration-services.org/ns}share-permissions | Then the single response should contain a property "{http://open-collaboration-services.org/ns}share-permissions" with value "19" - Scenario: Cannot download a file when it's shared view-only + Scenario: Cannot download a file when it's shared view-only without shareapi_allow_view_without_download + Given As an "admin" + And parameter "shareapi_allow_view_without_download" of app "core" is set to "no" Given user "user0" exists And user "user1" exists And User "user0" moves file "/textfile0.txt" to "/document.odt" @@ -1178,8 +1276,15 @@ Feature: sharing When As an "user1" And Downloading file "/document.odt" Then the HTTP status code should be "403" + Then As an "admin" + And parameter "shareapi_allow_view_without_download" of app "core" is set to "yes" + Then As an "user1" + And Downloading file "/document.odt" + Then the HTTP status code should be "200" - Scenario: Cannot download a file when its parent is shared view-only + Scenario: Cannot download a file when its parent is shared view-only without shareapi_allow_view_without_download + Given As an "admin" + And parameter "shareapi_allow_view_without_download" of app "core" is set to "no" Given user "user0" exists And user "user1" exists And User "user0" created a folder "/sharedviewonly" @@ -1189,8 +1294,15 @@ Feature: sharing When As an "user1" And Downloading file "/sharedviewonly/document.odt" Then the HTTP status code should be "403" + Then As an "admin" + And parameter "shareapi_allow_view_without_download" of app "core" is set to "yes" + Then As an "user1" + And Downloading file "/sharedviewonly/document.odt" + Then the HTTP status code should be "200" - Scenario: Cannot copy a file when it's shared view-only + Scenario: Cannot copy a file when it's shared view-only even with shareapi_allow_view_without_download enabled + Given As an "admin" + And parameter "shareapi_allow_view_without_download" of app "core" is set to "no" Given user "user0" exists And user "user1" exists And User "user0" moves file "/textfile0.txt" to "/document.odt" @@ -1198,8 +1310,15 @@ Feature: sharing And user "user1" accepts last share When User "user1" copies file "/document.odt" to "/copyforbidden.odt" Then the HTTP status code should be "403" + Then As an "admin" + And parameter "shareapi_allow_view_without_download" of app "core" is set to "yes" + Then As an "user1" + And User "user1" copies file "/document.odt" to "/copyforbidden.odt" + Then the HTTP status code should be "403" Scenario: Cannot copy a file when its parent is shared view-only + Given As an "admin" + And parameter "shareapi_allow_view_without_download" of app "core" is set to "no" Given user "user0" exists And user "user1" exists And User "user0" created a folder "/sharedviewonly" @@ -1208,5 +1327,10 @@ Feature: sharing And user "user1" accepts last share When User "user1" copies file "/sharedviewonly/document.odt" to "/copyforbidden.odt" Then the HTTP status code should be "403" + Then As an "admin" + And parameter "shareapi_allow_view_without_download" of app "core" is set to "yes" + Then As an "user1" + And User "user1" copies file "/sharedviewonly/document.odt" to "/copyforbidden.odt" + Then the HTTP status code should be "403" # See sharing-v1-part3.feature diff --git a/build/integration/sharing_features/sharing-v1-part4.feature b/build/integration/sharing_features/sharing-v1-part4.feature index 1b32f99a0a2..d138f0a1769 100644 --- a/build/integration/sharing_features/sharing-v1-part4.feature +++ b/build/integration/sharing_features/sharing-v1-part4.feature @@ -124,3 +124,61 @@ Scenario: Receiving a share of a file without delete permission gives delete per | path | /welcome (2).txt | | permissions | 19 | | item_permissions | 27 | + +# This is a regression test as in the past creating a file drop required creating with permissions=5 +# and then afterwards update the share to permissions=4 +Scenario: Directly create link share with CREATE only permissions (file drop) + Given user "user0" exists + And As an "user0" + And user "user0" created a folder "/TMP" + When creating a share with + | path | TMP | + | shareType | 3 | + | permissions | 4 | + And Getting info of last share + Then Share fields of last share match with + | uid_file_owner | user0 | + | share_type | 3 | + | permissions | 4 | + +Scenario: Directly create email share with CREATE only permissions (file drop) + Given user "user0" exists + And As an "user0" + And user "user0" created a folder "/TMP" + When creating a share with + | path | TMP | + | shareType | 4 | + | shareWith | j.doe@example.com | + | permissions | 4 | + And Getting info of last share + Then Share fields of last share match with + | uid_file_owner | user0 | + | share_type | 4 | + | permissions | 4 | + +# This ensures the legacy behavior of sharing v1 is kept +Scenario: publicUpload overrides permissions + Given user "user0" exists + And As an "user0" + And parameter "outgoing_server2server_share_enabled" of app "files_sharing" is set to "no" + And user "user0" created a folder "/TMP" + When creating a share with + | path | TMP | + | shareType | 3 | + | permissions | 4 | + | publicUpload | true | + And Getting info of last share + Then Share fields of last share match with + | uid_file_owner | user0 | + | share_type | 3 | + | permissions | 15 | + When creating a share with + | path | TMP | + | shareType | 3 | + | permissions | 4 | + | publicUpload | false | + And Getting info of last share + Then Share fields of last share match with + | uid_file_owner | user0 | + | share_type | 3 | + | permissions | 1 | diff --git a/build/integration/sharing_features/sharing-v1.feature b/build/integration/sharing_features/sharing-v1.feature index 708667f123c..25f168db2e7 100644 --- a/build/integration/sharing_features/sharing-v1.feature +++ b/build/integration/sharing_features/sharing-v1.feature @@ -231,10 +231,11 @@ Feature: sharing | url | AN_URL | | mimetype | httpd/unix-directory | - Scenario: Creating a new share with expiration date removed, when default expiration is set + Scenario: Creating a new share with expiration date empty, when default expiration is set Given user "user0" exists And user "user1" exists - And parameter "shareapi_default_expire_date" of app "core" is set to "yes" + And parameter "shareapi_default_internal_expire_date" of app "core" is set to "yes" + And parameter "shareapi_internal_expire_after_n_days" of app "core" is set to "3" And As an "user0" When creating a share with | path | welcome.txt | @@ -249,6 +250,43 @@ Feature: sharing And Share fields of last share match with | expiration || + Scenario: Creating a new share with expiration date removed, when default expiration is set + Given user "user0" exists + And user "user1" exists + And parameter "shareapi_default_internal_expire_date" of app "core" is set to "yes" + And parameter "shareapi_internal_expire_after_n_days" of app "core" is set to "3" + And As an "user0" + When creating a share with + | path | welcome.txt | + | shareWith | user1 | + | shareType | 0 | + Then the OCS status code should be "100" + And the HTTP status code should be "200" + And Getting info of last share + Then the OCS status code should be "100" + And the HTTP status code should be "200" + And Share fields of last share match with + | expiration | +3 days | + + Scenario: Creating a new share with expiration date null, when default expiration is set + Given user "user0" exists + And user "user1" exists + And parameter "shareapi_default_internal_expire_date" of app "core" is set to "yes" + And parameter "shareapi_internal_expire_after_n_days" of app "core" is set to "3" + And As an "user0" + When creating a share with + | path | welcome.txt | + | shareWith | user1 | + | shareType | 0 | + | expireDate | null | + Then the OCS status code should be "100" + And the HTTP status code should be "200" + And Getting info of last share + Then the OCS status code should be "100" + And the HTTP status code should be "200" + And Share fields of last share match with + | expiration | +3 days | + Scenario: Creating a new public share, updating its password and getting its info Given user "user0" exists And As an "user0" diff --git a/build/integration/theming_features/theming.feature b/build/integration/theming_features/theming.feature new file mode 100644 index 00000000000..2ae5d4f75c3 --- /dev/null +++ b/build/integration/theming_features/theming.feature @@ -0,0 +1,131 @@ +# SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors +# SPDX-License-Identifier: AGPL-3.0-or-later +Feature: theming + + Background: + Given user "user0" exists + + Scenario: themed stylesheets are available for users + Given As an "user0" + When sending "GET" with exact url to "/index.php/apps/theming/theme/default.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/light.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/dark.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/light-highcontrast.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/dark-highcontrast.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/opendyslexic.css" + Then the HTTP status code should be "200" + + Scenario: themed stylesheets are available for guests + Given As an "anonymous" + When sending "GET" with exact url to "/index.php/apps/theming/theme/default.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/light.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/dark.css" + Then the HTTP status code should be "200" + # Themes that can not be explicitly set by a guest could have been + # globally set too through "enforce_theme". + When sending "GET" with exact url to "/index.php/apps/theming/theme/light-highcontrast.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/dark-highcontrast.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/opendyslexic.css" + Then the HTTP status code should be "200" + + Scenario: themed stylesheets are available for disabled users + Given As an "admin" + And assure user "user0" is disabled + And As an "user0" + When sending "GET" with exact url to "/index.php/apps/theming/theme/default.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/light.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/dark.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/light-highcontrast.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/dark-highcontrast.css" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/theme/opendyslexic.css" + Then the HTTP status code should be "200" + + Scenario: themed images are available for users + Given Logging in using web as "admin" + And logged in admin uploads theming image for "background" from file "data/clouds.jpg" + And logged in admin uploads theming image for "logo" from file "data/coloured-pattern-non-square.png" + And logged in admin uploads theming image for "logoheader" from file "data/coloured-pattern-non-square.png" + And As an "user0" + When sending "GET" with exact url to "/index.php/apps/theming/image/background" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/image/logo" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/image/logoheader" + Then the HTTP status code should be "200" + + Scenario: themed images are available for guests + Given Logging in using web as "admin" + And logged in admin uploads theming image for "background" from file "data/clouds.jpg" + And logged in admin uploads theming image for "logo" from file "data/coloured-pattern-non-square.png" + And logged in admin uploads theming image for "logoheader" from file "data/coloured-pattern-non-square.png" + And As an "anonymous" + When sending "GET" with exact url to "/index.php/apps/theming/image/background" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/image/logo" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/image/logoheader" + Then the HTTP status code should be "200" + + Scenario: themed images are available for disabled users + Given Logging in using web as "admin" + And logged in admin uploads theming image for "background" from file "data/clouds.jpg" + And logged in admin uploads theming image for "logo" from file "data/coloured-pattern-non-square.png" + And logged in admin uploads theming image for "logoheader" from file "data/coloured-pattern-non-square.png" + And As an "admin" + And assure user "user0" is disabled + And As an "user0" + When sending "GET" with exact url to "/index.php/apps/theming/image/background" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/image/logo" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/image/logoheader" + Then the HTTP status code should be "200" + + Scenario: themed icons are available for users + Given As an "user0" + When sending "GET" with exact url to "/index.php/apps/theming/favicon" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/icon" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/favicon/dashboard" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/icon/dashboard" + Then the HTTP status code should be "200" + + Scenario: themed icons are available for guests + Given As an "anonymous" + When sending "GET" with exact url to "/index.php/apps/theming/favicon" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/icon" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/favicon/dashboard" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/icon/dashboard" + Then the HTTP status code should be "200" + + Scenario: themed icons are available for disabled users + Given As an "admin" + And assure user "user0" is disabled + And As an "user0" + When sending "GET" with exact url to "/index.php/apps/theming/favicon" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/icon" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/favicon/dashboard" + Then the HTTP status code should be "200" + When sending "GET" with exact url to "/index.php/apps/theming/icon/dashboard" + Then the HTTP status code should be "200" diff --git a/build/license.php b/build/license.php index b21f5b263fc..bb6351181c6 100644 --- a/build/license.php +++ b/build/license.php @@ -1,4 +1,5 @@ <?php + /** * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors * SPDX-FileCopyrightText: 2016 ownCloud, Inc. @@ -220,7 +221,7 @@ With help from many libraries and frameworks including: $index++; continue; } - + if (strpos($line, '<?php declare(strict_types') !== false) { $isStrict = true; array_splice($lines, $index, 1); @@ -262,7 +263,7 @@ With help from many libraries and frameworks including: private function getCopyrightNotices($path, $file) { $licenseHeaderCopyrightAtLines = trim(shell_exec("grep -ni 'copyright' $path | cut -d ':' -f 1")); $lineByLine = explode(PHP_EOL, $file); - + $copyrightNotice = []; if (trim($licenseHeaderCopyrightAtLines !== '')) { $copyrightNotice = array_map(function ($line) use ($lineByLine) { @@ -355,7 +356,7 @@ With help from many libraries and frameworks including: } $authors = $this->filterAuthors($authors); - + if ($gitRoot) { $authors = array_map([$this, 'checkCoreMailMap'], $authors); $authors = array_unique($authors); diff --git a/build/openapi-checker.sh b/build/openapi-checker.sh index 5ad6e619ec3..9e4a4802b25 100755 --- a/build/openapi-checker.sh +++ b/build/openapi-checker.sh @@ -3,13 +3,26 @@ # SPDX-FileCopyrightText: 2023 Nextcloud GmbH and Nextcloud contributors # SPDX-License-Identifier: AGPL-3.0-or-later +specs=() for path in core apps/*; do if [ ! -f "$path/.noopenapi" ] && [[ "$(git check-ignore "$path")" != "$path" ]]; then composer exec generate-spec "$path" "$path/openapi.json" || exit 1 + if [[ "$(basename "$path")" != "core" ]]; then + if [ -f "$path/openapi-full.json" ]; then + specs+=("$path/openapi-full.json") + else + specs+=("$path/openapi.json") + fi; + fi; fi done -files="$(git diff --name-only)" +composer exec merge-specs -- \ + --core core/openapi-full.json \ + --merged openapi.json \ + "${specs[@]}" + +files="$(git ls-files --exclude-standard --modified --others)" changed=false for file in $files; do if [[ $file == *"openapi"*".json" ]]; then diff --git a/build/psalm-baseline-ocp.xml b/build/psalm-baseline-ocp.xml index 9f69654ff3d..8500cf735be 100644 --- a/build/psalm-baseline-ocp.xml +++ b/build/psalm-baseline-ocp.xml @@ -1,90 +1,8 @@ <?xml version="1.0" encoding="UTF-8"?> <files psalm-version="5.26.1@d747f6500b38ac4f7dfc5edbcae6e4b637d7add0"> - <file src="lib/private/legacy/OC_Template.php"> - <UndefinedClass> - <code><![CDATA[OC]]></code> - </UndefinedClass> - </file> - <file src="lib/public/AppFramework/ApiController.php"> - <NoInterfaceProperties> - <code><![CDATA[$this->request->server]]></code> - </NoInterfaceProperties> - </file> <file src="lib/public/AppFramework/App.php"> - <InternalMethod> - <code><![CDATA[new RouteConfig($this->container, $router, $routes)]]></code> - </InternalMethod> - <UndefinedClass> - <code><![CDATA[\OC]]></code> - </UndefinedClass> - </file> - <file src="lib/public/AppFramework/Http/RedirectToDefaultAppResponse.php"> - <UndefinedClass> - <code><![CDATA[\OC]]></code> - </UndefinedClass> - </file> - <file src="lib/public/AppFramework/Http/Response.php"> - <UndefinedClass> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - </UndefinedClass> - </file> - <file src="lib/public/Defaults.php"> - <UndefinedClass> - <code><![CDATA[\OC]]></code> - </UndefinedClass> - </file> - <file src="lib/public/Diagnostics/IQueryLogger.php"> - <LessSpecificImplementedReturnType> - <code><![CDATA[mixed]]></code> - </LessSpecificImplementedReturnType> - </file> - <file src="lib/public/EventDispatcher/GenericEvent.php"> - <MissingTemplateParam> - <code><![CDATA[ArrayAccess]]></code> - <code><![CDATA[IteratorAggregate]]></code> - </MissingTemplateParam> - </file> - <file src="lib/public/Files.php"> - <FalsableReturnStatement> - <code><![CDATA[\OC_App::getStorage($app)]]></code> - </FalsableReturnStatement> <UndefinedClass> <code><![CDATA[\OC]]></code> </UndefinedClass> </file> - <file src="lib/public/L10N/ILanguageIterator.php"> - <MissingTemplateParam> - <code><![CDATA[\Iterator]]></code> - </MissingTemplateParam> - </file> - <file src="lib/public/Template.php"> - <UndefinedFunction> - <code><![CDATA[\html_select_options($options, $selected, $params)]]></code> - <code><![CDATA[\human_file_size($bytes)]]></code> - <code><![CDATA[\image_path($app, $image)]]></code> - <code><![CDATA[\mimetype_icon($mimetype)]]></code> - <code><![CDATA[\preview_icon($path)]]></code> - <code><![CDATA[\publicPreview_icon($path, $token)]]></code> - <code><![CDATA[\relative_modified_date($timestamp, null, $dateOnly)]]></code> - </UndefinedFunction> - </file> - <file src="lib/public/Util.php"> - <UndefinedClass> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - <code><![CDATA[\OC]]></code> - </UndefinedClass> - </file> </files> diff --git a/build/psalm-baseline-security.xml b/build/psalm-baseline-security.xml index 32939a14aec..d9ab9c91076 100644 --- a/build/psalm-baseline-security.xml +++ b/build/psalm-baseline-security.xml @@ -1,133 +1,8 @@ <?xml version="1.0" encoding="UTF-8"?> <files psalm-version="5.26.1@d747f6500b38ac4f7dfc5edbcae6e4b637d7add0"> - <file src="apps/admin_audit/lib/Actions/Action.php"> - <TaintedHtml> - <code><![CDATA[$params]]></code> - </TaintedHtml> - </file> - <file src="apps/files_external/lib/Config/ConfigAdapter.php"> - <TaintedCallable> - <code><![CDATA[$objectClass]]></code> - </TaintedCallable> - </file> - <file src="apps/theming/lib/IconBuilder.php"> - <TaintedFile> - <code><![CDATA[$appIcon]]></code> - <code><![CDATA[$imageFile]]></code> - </TaintedFile> - </file> - <file src="lib/base.php"> - <TaintedHeader> - <code><![CDATA['Location: ' . $url]]></code> - <code><![CDATA['Location: ' . \OC::$WEBROOT . '/']]></code> - </TaintedHeader> - </file> - <file src="lib/private/AppFramework/Utility/SimpleContainer.php"> - <TaintedCallable> - <code><![CDATA[$name]]></code> - </TaintedCallable> - </file> - <file src="lib/private/Config.php"> - <TaintedHtml> - <code><![CDATA[$this->cache]]></code> - </TaintedHtml> - </file> - <file src="lib/private/EventSource.php"> - <TaintedHeader> - <code><![CDATA['Location: ' . \OC::$WEBROOT]]></code> - </TaintedHeader> - </file> - <file src="lib/private/Http/CookieHelper.php"> - <TaintedHeader> - <code><![CDATA[$header]]></code> - </TaintedHeader> - </file> - <file src="lib/private/Installer.php"> - <TaintedFile> - <code><![CDATA[$baseDir]]></code> - </TaintedFile> - </file> - <file src="lib/private/OCS/ApiHelper.php"> - <TaintedHtml> - <code><![CDATA[$body]]></code> - </TaintedHtml> - <TaintedTextWithQuotes> - <code><![CDATA[$body]]></code> - </TaintedTextWithQuotes> - </file> - <file src="lib/private/Route/Router.php"> - <TaintedCallable> - <code><![CDATA[$appNameSpace . '\\Controller\\' . basename($file->getPathname(), '.php')]]></code> - </TaintedCallable> - </file> - <file src="lib/private/ServerContainer.php"> - <TaintedCallable> - <code><![CDATA[$applicationClassName]]></code> - </TaintedCallable> - </file> - <file src="lib/private/Session/CryptoWrapper.php"> - <TaintedCookie> - <code><![CDATA[$this->passphrase]]></code> - </TaintedCookie> - </file> - <file src="lib/private/Setup.php"> - <TaintedFile> - <code><![CDATA[$dataDir]]></code> - </TaintedFile> - </file> - <file src="lib/private/Setup/Sqlite.php"> - <TaintedFile> - <code><![CDATA[$sqliteFile]]></code> - </TaintedFile> - </file> - <file src="lib/private/legacy/OC_Helper.php"> - <TaintedFile> - <code><![CDATA[$dest]]></code> - <code><![CDATA[$dest]]></code> - <code><![CDATA[$dir]]></code> - <code><![CDATA[$dir]]></code> - </TaintedFile> - </file> - <file src="lib/private/legacy/OC_JSON.php"> - <TaintedHeader> - <code><![CDATA['Location: ' . \OC::$WEBROOT]]></code> - </TaintedHeader> - <TaintedHtml> - <code><![CDATA[self::encode($data)]]></code> - <code><![CDATA[self::encode($data)]]></code> - </TaintedHtml> - <TaintedTextWithQuotes> - <code><![CDATA[self::encode($data)]]></code> - <code><![CDATA[self::encode($data)]]></code> - </TaintedTextWithQuotes> - </file> - <file src="lib/private/legacy/OC_Template.php"> - <TaintedHtml> - <code><![CDATA[$exception->getTraceAsString()]]></code> - </TaintedHtml> - <TaintedTextWithQuotes> - <code><![CDATA[$exception->getTraceAsString()]]></code> - </TaintedTextWithQuotes> - </file> <file src="lib/public/DB/QueryBuilder/IQueryBuilder.php"> <TaintedSql> <code><![CDATA[$column]]></code> </TaintedSql> </file> - <file src="lib/public/IDBConnection.php"> - <TaintedSql> - <code><![CDATA[$sql]]></code> - <code><![CDATA[$sql]]></code> - <code><![CDATA[$sql]]></code> - <code><![CDATA[$sql]]></code> - </TaintedSql> - </file> - <file src="ocs-provider/index.php"> - <TaintedHtml> - <code><![CDATA[$controller->buildProviderList()->render()]]></code> - </TaintedHtml> - <TaintedTextWithQuotes> - <code><![CDATA[$controller->buildProviderList()->render()]]></code> - </TaintedTextWithQuotes> - </file> </files> diff --git a/build/psalm-baseline.xml b/build/psalm-baseline.xml index 378429ceda3..07df0637d57 100644 --- a/build/psalm-baseline.xml +++ b/build/psalm-baseline.xml @@ -1,60 +1,157 @@ <?xml version="1.0" encoding="UTF-8"?> <files psalm-version="5.26.1@d747f6500b38ac4f7dfc5edbcae6e4b637d7add0"> - <file src="3rdparty/sabre/dav/lib/CalDAV/Calendar.php"> - <MoreSpecificImplementedParamType> - <code><![CDATA[$data]]></code> - </MoreSpecificImplementedParamType> - </file> - <file src="3rdparty/sabre/dav/lib/CalDAV/CalendarHome.php"> - <MoreSpecificImplementedParamType> - <code><![CDATA[$data]]></code> - </MoreSpecificImplementedParamType> - </file> - <file src="3rdparty/sabre/dav/lib/CalDAV/Principal/User.php"> - <MoreSpecificImplementedParamType> - <code><![CDATA[$data]]></code> - </MoreSpecificImplementedParamType> - </file> - <file src="3rdparty/sabre/dav/lib/CardDAV/AddressBook.php"> - <MoreSpecificImplementedParamType> - <code><![CDATA[$data]]></code> - </MoreSpecificImplementedParamType> - </file> - <file src="3rdparty/sabre/dav/lib/CardDAV/AddressBookHome.php"> - <InvalidPropertyAssignmentValue> - <code><![CDATA[$principalUri]]></code> - </InvalidPropertyAssignmentValue> - <MoreSpecificImplementedParamType> - <code><![CDATA[$data]]></code> - </MoreSpecificImplementedParamType> - </file> - <file src="3rdparty/sabre/dav/lib/CardDAV/Card.php"> - <MoreSpecificImplementedParamType> - <code><![CDATA[$cardData]]></code> - </MoreSpecificImplementedParamType> - </file> - <file src="3rdparty/sabre/dav/lib/DAV/SimpleCollection.php"> - <NoValue> - <code><![CDATA[$child]]></code> - <code><![CDATA[$child]]></code> - </NoValue> - </file> - <file src="3rdparty/sabre/dav/lib/DAVACL/AbstractPrincipalCollection.php"> - <LessSpecificImplementedReturnType> - <code><![CDATA[array]]></code> - </LessSpecificImplementedReturnType> + <file src="apps/admin_audit/lib/AppInfo/Application.php"> + <DeprecatedClass> + <code><![CDATA[Share::class]]></code> + <code><![CDATA[Share::class]]></code> + <code><![CDATA[Share::class]]></code> + <code><![CDATA[Share::class]]></code> + </DeprecatedClass> + <DeprecatedConstant> + <code><![CDATA[ManagerEvent::EVENT_CREATE]]></code> + </DeprecatedConstant> + <DeprecatedMethod> + <code><![CDATA[Util::connectHook('\OCA\Files_Trashbin\Trashbin', 'post_restore', $trashActions, 'restore')]]></code> + <code><![CDATA[Util::connectHook('\OCP\Trashbin', 'preDelete', $trashActions, 'delete')]]></code> + <code><![CDATA[Util::connectHook('\OCP\Versions', 'delete', $versionsActions, 'delete')]]></code> + <code><![CDATA[Util::connectHook(Share::class, 'post_set_expiration_date', $shareActions, 'updateExpirationDate')]]></code> + <code><![CDATA[Util::connectHook(Share::class, 'post_update_password', $shareActions, 'updatePassword')]]></code> + <code><![CDATA[Util::connectHook(Share::class, 'post_update_permissions', $shareActions, 'updatePermissions')]]></code> + <code><![CDATA[Util::connectHook(Share::class, 'share_link_access', $shareActions, 'shareAccessed')]]></code> + </DeprecatedMethod> + </file> + <file src="apps/admin_audit/lib/AuditLogger.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/admin_audit/lib/BackgroundJobs/Rotate.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/cloud_federation_api/lib/Controller/RequestHandlerController.php"> + <DeprecatedMethod> + <code><![CDATA[Util::emitHook( + '\OCA\Files_Sharing\API\Server2Server', + 'preLoginNameUsedAsUserName', + ['uid' => &$uid] + )]]></code> + </DeprecatedMethod> + </file> + <file src="apps/comments/lib/Activity/Listener.php"> + <DeprecatedConstant> + <code><![CDATA[CommentsEvent::EVENT_ADD]]></code> + </DeprecatedConstant> + </file> + <file src="apps/comments/lib/Listener/CommentsEventListener.php"> + <DeprecatedConstant> + <code><![CDATA[CommentsEvent::EVENT_ADD]]></code> + <code><![CDATA[CommentsEvent::EVENT_DELETE]]></code> + <code><![CDATA[CommentsEvent::EVENT_PRE_UPDATE]]></code> + <code><![CDATA[CommentsEvent::EVENT_UPDATE]]></code> + </DeprecatedConstant> + </file> + <file src="apps/comments/lib/MaxAutoCompleteResultsInitialState.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/comments/lib/Notification/Listener.php"> + <DeprecatedConstant> + <code><![CDATA[CommentsEvent::EVENT_DELETE]]></code> + <code><![CDATA[CommentsEvent::EVENT_PRE_UPDATE]]></code> + </DeprecatedConstant> + </file> + <file src="apps/comments/lib/Search/CommentsSearchProvider.php"> + <DeprecatedClass> + <code><![CDATA[Result]]></code> + </DeprecatedClass> + <DeprecatedProperty> + <code><![CDATA[$result->authorId]]></code> + <code><![CDATA[$result->authorId]]></code> + <code><![CDATA[$result->authorId]]></code> + <code><![CDATA[$result->name]]></code> + <code><![CDATA[$result->path]]></code> + </DeprecatedProperty> + </file> + <file src="apps/comments/lib/Search/LegacyProvider.php"> + <DeprecatedClass> + <code><![CDATA[Provider]]></code> + <code><![CDATA[new Result($query, + $comment, + $displayName, + $file->getPath() + )]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[Provider]]></code> + <code><![CDATA[getUserFolder]]></code> + </DeprecatedMethod> + </file> + <file src="apps/comments/lib/Search/Result.php"> + <DeprecatedClass> + <code><![CDATA[BaseResult]]></code> + <code><![CDATA[parent::__construct( + $comment->getId(), + $comment->getMessage() + /* @todo , [link to file] */ + )]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[parent::__construct( + $comment->getId(), + $comment->getMessage() + /* @todo , [link to file] */ + )]]></code> + </DeprecatedMethod> + <DeprecatedProperty> + <code><![CDATA[$this->authorId]]></code> + <code><![CDATA[$this->comment]]></code> + <code><![CDATA[$this->fileName]]></code> + <code><![CDATA[$this->path]]></code> + </DeprecatedProperty> + </file> + <file src="apps/dashboard/lib/Controller/DashboardApiController.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dashboard/lib/Service/DashboardService.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> </file> <file src="apps/dav/appinfo/v1/caldav.php"> + <DeprecatedMethod> + <code><![CDATA[exec]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getL10N]]></code> + <code><![CDATA[getL10NFactory]]></code> + </DeprecatedMethod> <UndefinedGlobalVariable> <code><![CDATA[$baseuri]]></code> </UndefinedGlobalVariable> </file> <file src="apps/dav/appinfo/v1/carddav.php"> + <DeprecatedMethod> + <code><![CDATA[exec]]></code> + <code><![CDATA[getL10N]]></code> + <code><![CDATA[getL10NFactory]]></code> + </DeprecatedMethod> <UndefinedGlobalVariable> <code><![CDATA[$baseuri]]></code> </UndefinedGlobalVariable> </file> <file src="apps/dav/appinfo/v1/publicwebdav.php"> + <DeprecatedClass> + <code><![CDATA[OC_Util::obEnd()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[OC_App::loadApps($RUNTIME_APPTYPES)]]></code> + <code><![CDATA[exec]]></code> + <code><![CDATA[getL10N]]></code> + </DeprecatedMethod> <InternalMethod> <code><![CDATA[Filesystem::logWarningWhenAddingStorageWrapper($previousLog)]]></code> <code><![CDATA[Filesystem::logWarningWhenAddingStorageWrapper(false)]]></code> @@ -64,26 +161,98 @@ </UndefinedGlobalVariable> </file> <file src="apps/dav/appinfo/v1/webdav.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::obEnd()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[dispatch]]></code> + <code><![CDATA[exec]]></code> + <code><![CDATA[getL10N]]></code> + </DeprecatedMethod> <UndefinedGlobalVariable> <code><![CDATA[$baseuri]]></code> </UndefinedGlobalVariable> </file> <file src="apps/dav/appinfo/v2/direct.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::obEnd()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[exec]]></code> + </DeprecatedMethod> <UndefinedGlobalVariable> <code><![CDATA[$baseuri]]></code> </UndefinedGlobalVariable> </file> + <file src="apps/dav/appinfo/v2/publicremote.php"> + <DeprecatedClass> + <code><![CDATA[OC_Util::obEnd()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[OC_App::loadApps($RUNTIME_APPTYPES)]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/appinfo/v2/remote.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::obEnd()]]></code> + </DeprecatedClass> <UndefinedGlobalVariable> <code><![CDATA[$baseuri]]></code> </UndefinedGlobalVariable> </file> <file src="apps/dav/lib/AppInfo/Application.php"> + <DeprecatedInterface> + <code><![CDATA[IAppContainer]]></code> + <code><![CDATA[IAppContainer]]></code> + <code><![CDATA[IAppContainer]]></code> + <code><![CDATA[IAppContainer]]></code> + <code><![CDATA[IAppContainer]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[getServer]]></code> + <code><![CDATA[getServer]]></code> + <code><![CDATA[getURLGenerator]]></code> + <code><![CDATA[getURLGenerator]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[register]]></code> + </DeprecatedMethod> <InvalidArgument> <code><![CDATA[registerEventListener]]></code> </InvalidArgument> </file> + <file src="apps/dav/lib/BackgroundJob/CleanupInvitationTokenJob.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/BackgroundJob/EventReminderJob.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/BackgroundJob/GenerateBirthdayCalendarBackgroundJob.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/BackgroundJob/PruneOutdatedSyncTokensJob.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/BackgroundJob/RefreshWebcalJob.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/CalDAV/BirthdayService.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> <UndefinedMethod> <code><![CDATA[setDateTime]]></code> <code><![CDATA[setDateTime]]></code> @@ -105,6 +274,10 @@ </ParamNameMismatch> </file> <file src="apps/dav/lib/CalDAV/CalDavBackend.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> <InvalidNullableReturnType> <code><![CDATA[array]]></code> </InvalidNullableReturnType> @@ -124,6 +297,9 @@ </NullableReturnStatement> </file> <file src="apps/dav/lib/CalDAV/CalendarHome.php"> + <DeprecatedMethod> + <code><![CDATA[getL10N]]></code> + </DeprecatedMethod> <InvalidNullableReturnType> <code><![CDATA[INode]]></code> </InvalidNullableReturnType> @@ -137,11 +313,31 @@ <code><![CDATA[calendarSearch]]></code> </UndefinedInterfaceMethod> </file> + <file src="apps/dav/lib/CalDAV/CalendarManager.php"> + <DeprecatedMethod> + <code><![CDATA[registerCalendar]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/CalDAV/CalendarRoot.php"> <ParamNameMismatch> <code><![CDATA[$principal]]></code> </ParamNameMismatch> </file> + <file src="apps/dav/lib/CalDAV/ICSExportPlugin/ICSExportPlugin.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/CalDAV/InvitationResponse/InvitationResponseServer.php"> + <DeprecatedMethod> + <code><![CDATA[getL10N]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/CalDAV/Outbox.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/CalDAV/Plugin.php"> <ImplementedReturnTypeMismatch> <code><![CDATA[string|null]]></code> @@ -157,6 +353,13 @@ <code><![CDATA[$paths]]></code> </MoreSpecificImplementedParamType> </file> + <file src="apps/dav/lib/CalDAV/Publishing/PublishPlugin.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/CalDAV/Reminder/NotificationProvider/AbstractProvider.php"> <LessSpecificReturnStatement> <code><![CDATA[$vevent->DTEND]]></code> @@ -180,6 +383,11 @@ <code><![CDATA[isFloating]]></code> </UndefinedMethod> </file> + <file src="apps/dav/lib/CalDAV/Reminder/NotificationProvider/PushProvider.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/CalDAV/Reminder/NotificationProviderManager.php"> <UndefinedConstant> <code><![CDATA[$provider::NOTIFICATION_TYPE]]></code> @@ -191,6 +399,9 @@ </TypeDoesNotContainType> </file> <file src="apps/dav/lib/CalDAV/Reminder/ReminderService.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> <LessSpecificReturnStatement> <code><![CDATA[$vevents]]></code> <code><![CDATA[VObject\Reader::read($calendarData, @@ -209,6 +420,18 @@ </UndefinedPropertyFetch> </file> <file src="apps/dav/lib/CalDAV/ResourceBooking/AbstractPrincipalBackend.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> <InvalidNullableReturnType> <code><![CDATA[array]]></code> </InvalidNullableReturnType> @@ -223,6 +446,11 @@ <code><![CDATA[null]]></code> </NullableReturnStatement> </file> + <file src="apps/dav/lib/CalDAV/RetentionService.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/CalDAV/Schedule/IMipPlugin.php"> <RedundantCast> <code><![CDATA[(string)$iTipMessage->recipientName]]></code> @@ -233,12 +461,18 @@ </RedundantCondition> </file> <file src="apps/dav/lib/CalDAV/Schedule/IMipService.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> <UndefinedMethod> <code><![CDATA[getNormalizedValue]]></code> <code><![CDATA[getNormalizedValue]]></code> </UndefinedMethod> </file> <file src="apps/dav/lib/CalDAV/Schedule/Plugin.php"> + <DeprecatedMethod> + <code><![CDATA[getPropertiesForPath]]></code> + </DeprecatedMethod> <InvalidArgument> <code><![CDATA[[$aclPlugin, 'propFind']]]></code> <code><![CDATA[[$aclPlugin, 'propFind']]]></code> @@ -258,6 +492,9 @@ </UndefinedMethod> </file> <file src="apps/dav/lib/CalDAV/Search/SearchPlugin.php"> + <DeprecatedMethod> + <code><![CDATA[getPropertiesForPath]]></code> + </DeprecatedMethod> <InvalidNullableReturnType> <code><![CDATA[bool]]></code> </InvalidNullableReturnType> @@ -319,6 +556,11 @@ <code><![CDATA[$addressBooks[$row['id']][$readOnlyPropertyName] === 0]]></code> </TypeDoesNotContainType> </file> + <file src="apps/dav/lib/CardDAV/Converter.php"> + <DeprecatedConstant> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + </DeprecatedConstant> + </file> <file src="apps/dav/lib/CardDAV/MultiGetExportPlugin.php"> <InvalidNullableReturnType> <code><![CDATA[bool]]></code> @@ -329,17 +571,66 @@ <code><![CDATA[string|null]]></code> </ImplementedReturnTypeMismatch> </file> + <file src="apps/dav/lib/CardDAV/SystemAddressbook.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/CardDAV/UserAddressBooks.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getL10N]]></code> + </DeprecatedMethod> <InvalidArgument> <code><![CDATA[$this->principalUri]]></code> <code><![CDATA[$this->principalUri]]></code> </InvalidArgument> </file> + <file src="apps/dav/lib/Command/CreateCalendar.php"> + <DeprecatedMethod> + <code><![CDATA[getL10NFactory]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Command/SendEventReminders.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Command/SyncBirthdayCalendar.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Command/SyncSystemAddressBook.php"> + <DeprecatedMethod> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/Comments/CommentsPlugin.php"> + <DeprecatedMethod> + <code><![CDATA[getPropertiesForPath]]></code> + </DeprecatedMethod> <UndefinedFunction> <code><![CDATA[\Sabre\HTTP\toDate($value)]]></code> </UndefinedFunction> </file> + <file src="apps/dav/lib/Comments/RootCollection.php"> + <DeprecatedConstant> + <code><![CDATA[CommentsEntityEvent::EVENT_ENTITY]]></code> + </DeprecatedConstant> + <DeprecatedMethod> + <code><![CDATA[dispatch]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/Connector/Sabre/AnonymousOptionsPlugin.php"> <InvalidNullableReturnType> <code><![CDATA[bool]]></code> @@ -354,6 +645,10 @@ </MoreSpecificReturnType> </file> <file src="apps/dav/lib/Connector/Sabre/BearerAuth.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($userId)]]></code> + <code><![CDATA[\OC_Util::setupFS()]]></code> + </DeprecatedClass> <UndefinedInterfaceMethod> <code><![CDATA[tryTokenLogin]]></code> </UndefinedInterfaceMethod> @@ -384,6 +679,12 @@ </ParamNameMismatch> </file> <file src="apps/dav/lib/Connector/Sabre/File.php"> + <DeprecatedClass> + <code><![CDATA[Files::streamCopy($data, $target, true)]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[Files::streamCopy($data, $target, true)]]></code> + </DeprecatedMethod> <LessSpecificReturnStatement> <code><![CDATA[$this->node]]></code> </LessSpecificReturnStatement> @@ -392,15 +693,9 @@ </MoreSpecificReturnType> </file> <file src="apps/dav/lib/Connector/Sabre/FilesReportPlugin.php"> - <InvalidArgument> - <code><![CDATA[0]]></code> - </InvalidArgument> <InvalidNullableReturnType> <code><![CDATA[bool]]></code> </InvalidNullableReturnType> - <TooManyArguments> - <code><![CDATA[new PreconditionFailed('Cannot filter by non-existing tag', 0, $e)]]></code> - </TooManyArguments> <UndefinedClass> <code><![CDATA[Circles]]></code> </UndefinedClass> @@ -408,6 +703,11 @@ <code><![CDATA[getPath]]></code> </UndefinedInterfaceMethod> </file> + <file src="apps/dav/lib/Connector/Sabre/MaintenancePlugin.php"> + <DeprecatedMethod> + <code><![CDATA[getL10N]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/Connector/Sabre/Node.php"> <InvalidNullableReturnType> <code><![CDATA[int]]></code> @@ -448,9 +748,10 @@ </UndefinedClass> </file> <file src="apps/dav/lib/Connector/Sabre/ServerFactory.php"> - <TooManyArguments> - <code><![CDATA[new QuotaPlugin($view, true)]]></code> - </TooManyArguments> + <DeprecatedMethod> + <code><![CDATA[getL10NFactory]]></code> + <code><![CDATA[getUserFolder]]></code> + </DeprecatedMethod> </file> <file src="apps/dav/lib/Connector/Sabre/ShareTypeList.php"> <InvalidArgument> @@ -470,12 +771,22 @@ <code><![CDATA[getId]]></code> </UndefinedInterfaceMethod> </file> + <file src="apps/dav/lib/Controller/BirthdayCalendarController.php"> + <DeprecatedMethod> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/Controller/InvitationResponseController.php"> <UndefinedPropertyAssignment> <code><![CDATA[$vEvent->DTSTAMP]]></code> </UndefinedPropertyAssignment> </file> <file src="apps/dav/lib/DAV/CustomPropertiesBackend.php"> + <DeprecatedMethod> + <code><![CDATA[closeCursor]]></code> + <code><![CDATA[closeCursor]]></code> + </DeprecatedMethod> <InvalidArgument> <code><![CDATA[$whereValues]]></code> </InvalidArgument> @@ -504,6 +815,11 @@ <code><![CDATA[null]]></code> </NullableReturnStatement> </file> + <file src="apps/dav/lib/DAV/Sharing/Plugin.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/DAV/SystemPrincipalBackend.php"> <InvalidNullableReturnType> <code><![CDATA[array]]></code> @@ -543,22 +859,98 @@ <code><![CDATA[bool]]></code> </InvalidReturnType> </file> - <file src="apps/dav/lib/HookManager.php"> - <InvalidPropertyAssignmentValue> - <code><![CDATA[$this->usersToDelete]]></code> - <code><![CDATA[$this->usersToDelete]]></code> - </InvalidPropertyAssignmentValue> + <file src="apps/dav/lib/Files/RootCollection.php"> + <DeprecatedMethod> + <code><![CDATA[getUserFolder]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Migration/BuildCalendarSearchIndex.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> </file> <file src="apps/dav/lib/Migration/BuildCalendarSearchIndexBackgroundJob.php"> <ParamNameMismatch> <code><![CDATA[$arguments]]></code> </ParamNameMismatch> </file> + <file src="apps/dav/lib/Migration/BuildSocialSearchIndex.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/Migration/BuildSocialSearchIndexBackgroundJob.php"> <ParamNameMismatch> <code><![CDATA[$arguments]]></code> </ParamNameMismatch> </file> + <file src="apps/dav/lib/Migration/ChunkCleanup.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Migration/RefreshWebcalJobRegistrar.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Migration/RegenerateBirthdayCalendars.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Migration/RegisterBuildReminderIndexBackgroundJob.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Migration/RemoveDeletedUsersCalendarSubscriptions.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Migration/Version1004Date20170825134824.php"> + <DeprecatedMethod> + <code><![CDATA[changeColumn]]></code> + <code><![CDATA[changeColumn]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Migration/Version1008Date20181105104826.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Migration/Version1008Date20181105110300.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Migration/Version1025Date20240308063933.php"> + <DeprecatedMethod> + <code><![CDATA[fetchColumn]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Migration/Version1027Date20230504122946.php"> + <DeprecatedMethod> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/RootCollection.php"> + <DeprecatedMethod> + <code><![CDATA[getL10N]]></code> + <code><![CDATA[getL10NFactory]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/Search/ContactsSearchProvider.php"> <InvalidOperand> <code><![CDATA[$query->getCursor()]]></code> @@ -601,6 +993,28 @@ <code><![CDATA[hasTime]]></code> </UndefinedMethod> </file> + <file src="apps/dav/lib/Server.php"> + <DeprecatedMethod> + <code><![CDATA[dispatch]]></code> + <code><![CDATA[dispatch]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getL10N]]></code> + <code><![CDATA[getL10N]]></code> + <code><![CDATA[getUserFolder]]></code> + <code><![CDATA[getUserFolder]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/Settings/CalDAVSettings.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/dav/lib/SetupChecks/NeedsSystemAddressBookSync.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/SystemTag/SystemTagsObjectMappingCollection.php"> <ParamNameMismatch> <code><![CDATA[$tagId]]></code> @@ -612,6 +1026,14 @@ <code><![CDATA[$objectName]]></code> </ParamNameMismatch> </file> + <file src="apps/dav/lib/SystemTag/SystemTagsRelationsCollection.php"> + <DeprecatedConstant> + <code><![CDATA[SystemTagsEntityEvent::EVENT_ENTITY]]></code> + </DeprecatedConstant> + <DeprecatedMethod> + <code><![CDATA[dispatch]]></code> + </DeprecatedMethod> + </file> <file src="apps/dav/lib/Traits/PrincipalProxyTrait.php"> <MoreSpecificImplementedParamType> <code><![CDATA[$members]]></code> @@ -657,30 +1079,135 @@ <code><![CDATA[array{name: string, displayName: string, description: ?string, vCards: VCard[]}]]></code> </MoreSpecificReturnType> </file> + <file src="apps/encryption/lib/Command/DisableMasterKey.php"> + <DeprecatedMethod> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/encryption/lib/Command/DropLegacyFileKey.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($uid)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> + <file src="apps/encryption/lib/Command/EnableMasterKey.php"> + <DeprecatedMethod> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/encryption/lib/Command/FixEncryptedVersion.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($uid)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> <file src="apps/encryption/lib/Command/FixKeyLocation.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($user->getUID())]]></code> + </DeprecatedClass> <MoreSpecificReturnType> <code><![CDATA[\Generator<File>]]></code> </MoreSpecificReturnType> </file> + <file src="apps/encryption/lib/Command/ScanLegacyFormat.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($uid)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> <file src="apps/encryption/lib/Crypto/Crypt.php"> + <DeprecatedMethod> + <code><![CDATA[opensslSeal]]></code> + </DeprecatedMethod> <TypeDoesNotContainType> <code><![CDATA[get_class($res) === 'OpenSSLAsymmetricKey']]></code> </TypeDoesNotContainType> </file> + <file src="apps/encryption/lib/Crypto/EncryptAll.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($uid)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> <file src="apps/encryption/lib/Crypto/Encryption.php"> <ImplementedParamTypeMismatch> <code><![CDATA[$position]]></code> </ImplementedParamTypeMismatch> </file> <file src="apps/encryption/lib/KeyManager.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> <InvalidThrow> <code><![CDATA[throw $exception;]]></code> </InvalidThrow> </file> - <file src="apps/encryption/lib/Session.php"> - <TooManyArguments> - <code><![CDATA[new PrivateKeyMissingException('please try to log-out and log-in again', 0)]]></code> - </TooManyArguments> + <file src="apps/encryption/lib/Migration/SetMasterKeyStatus.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/encryption/lib/Recovery.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/encryption/lib/Settings/Admin.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/encryption/lib/Settings/Personal.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/encryption/lib/Util.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/federatedfilesharing/lib/AddressHandler.php"> + <DeprecatedMethod> + <code><![CDATA[Util::emitHook( + '\OCA\Files_Sharing\API\Server2Server', + 'preLoginNameUsedAsUserName', + ['uid' => &$user1] + )]]></code> + <code><![CDATA[Util::emitHook( + '\OCA\Files_Sharing\API\Server2Server', + 'preLoginNameUsedAsUserName', + ['uid' => &$user2] + )]]></code> + </DeprecatedMethod> + </file> + <file src="apps/federatedfilesharing/lib/AppInfo/Application.php"> + <DeprecatedInterface> + <code><![CDATA[IAppContainer]]></code> + </DeprecatedInterface> </file> <file src="apps/federatedfilesharing/lib/Controller/RequestHandlerController.php"> <InvalidArgument> @@ -694,6 +1221,15 @@ </InvalidArgument> </file> <file src="apps/federatedfilesharing/lib/FederatedShareProvider.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> <InvalidArgument> <code><![CDATA[$shareId]]></code> <code><![CDATA[$shareId]]></code> @@ -702,7 +1238,19 @@ <code><![CDATA[(int)$data['id']]]></code> </InvalidArgument> </file> + <file src="apps/federatedfilesharing/lib/Migration/Version1011Date20201120125158.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[getName]]></code> + </DeprecatedMethod> + </file> <file src="apps/federatedfilesharing/lib/Notifications.php"> + <DeprecatedMethod> + <code><![CDATA[sendNotification]]></code> + <code><![CDATA[sendNotification]]></code> + <code><![CDATA[sendNotification]]></code> + <code><![CDATA[sendShare]]></code> + </DeprecatedMethod> <InvalidReturnType> <code><![CDATA[bool]]></code> <code><![CDATA[bool]]></code> @@ -710,6 +1258,21 @@ </InvalidReturnType> </file> <file src="apps/federatedfilesharing/lib/OCM/CloudFederationProviderFiles.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($shareWith)]]></code> + <code><![CDATA[\OC_Util::setupFS($user)]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[Util::emitHook( + '\OCA\Files_Sharing\API\Server2Server', + 'preLoginNameUsedAsUserName', + ['uid' => &$shareWith] + )]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[lastInsertId]]></code> + <code><![CDATA[sendNotification]]></code> + <code><![CDATA[sendNotification]]></code> + </DeprecatedMethod> <InvalidArgument> <code><![CDATA[$id]]></code> <code><![CDATA[$id]]></code> @@ -759,7 +1322,48 @@ <code><![CDATA[$this->fileIsEncrypted]]></code> </TypeDoesNotContainType> </file> + <file src="apps/files/lib/AppInfo/Application.php"> + <DeprecatedInterface> + <code><![CDATA[$server]]></code> + <code><![CDATA[$server]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[Util::connectHook('\OCP\Config', 'js', '\OCA\Files\App', 'extendJsConfig')]]></code> + <code><![CDATA[getUserFolder]]></code> + <code><![CDATA[getUserFolder]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files/lib/BackgroundJob/ScanFiles.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files/lib/Command/RepairTree.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files/lib/Command/Scan.php"> + <DeprecatedMethod> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + </DeprecatedMethod> + </file> <file src="apps/files/lib/Command/ScanAppData.php"> + <DeprecatedMethod> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + </DeprecatedMethod> <NullArgument> <code><![CDATA[null]]></code> <code><![CDATA[null]]></code> @@ -776,23 +1380,64 @@ </file> <file src="apps/files/lib/Helper.php"> <UndefinedInterfaceMethod> - <code><![CDATA[$file]]></code> <code><![CDATA[$i]]></code> <code><![CDATA[$i]]></code> <code><![CDATA[$i]]></code> <code><![CDATA[$i]]></code> </UndefinedInterfaceMethod> </file> + <file src="apps/files/lib/Migration/Version2003Date20241021095629.php"> + <DeprecatedMethod> + <code><![CDATA[deleteAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/files/lib/Service/OwnershipTransferService.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($destinationUser->getUID())]]></code> + <code><![CDATA[\OC_Util::setupFS($destinationUser->getUID())]]></code> + <code><![CDATA[\OC_Util::setupFS($sourceUser->getUID())]]></code> + </DeprecatedClass> <UndefinedInterfaceMethod> <code><![CDATA[isReadyForUser]]></code> </UndefinedInterfaceMethod> </file> + <file src="apps/files_external/ajax/applicable.php"> + <DeprecatedMethod> + <code><![CDATA[\OC_JSON::callCheck()]]></code> + <code><![CDATA[\OC_JSON::checkAdminUser()]]></code> + <code><![CDATA[\OC_JSON::checkAppEnabled('files_external')]]></code> + <code><![CDATA[\OC_JSON::success($results)]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_external/ajax/oauth2.php"> + <DeprecatedMethod> + <code><![CDATA[\OC_JSON::callCheck()]]></code> + <code><![CDATA[\OC_JSON::checkAppEnabled('files_external')]]></code> + <code><![CDATA[\OC_JSON::checkLoggedIn()]]></code> + <code><![CDATA[getL10N]]></code> + </DeprecatedMethod> + </file> <file src="apps/files_external/appinfo/routes.php"> <InvalidScope> <code><![CDATA[$this]]></code> </InvalidScope> </file> + <file src="apps/files_external/lib/Command/Notify.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::normalizeUnicode($parent)]]></code> + <code><![CDATA[\OC_Util::normalizeUnicode($path)]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_external/lib/Command/Scan.php"> + <DeprecatedMethod> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + </DeprecatedMethod> + </file> <file src="apps/files_external/lib/Controller/StoragesController.php"> <RedundantCast> <code><![CDATA[(int)$e->getCode()]]></code> @@ -837,6 +1482,18 @@ <code><![CDATA[login]]></code> </InvalidReturnType> </file> + <file src="apps/files_external/lib/Migration/Version1011Date20200630192246.php"> + <DeprecatedMethod> + <code><![CDATA[changeColumn]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_external/lib/Migration/Version1015Date20211104103506.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> <file src="apps/files_external/lib/MountConfig.php"> <InternalMethod> <code><![CDATA[decrypt]]></code> @@ -845,11 +1502,77 @@ <code><![CDATA[setIV]]></code> <code><![CDATA[setKey]]></code> </InternalMethod> - <TooManyArguments> - <code><![CDATA[test]]></code> - </TooManyArguments> + </file> + <file src="apps/files_external/lib/Service/BackendService.php"> + <DeprecatedClass> + <code><![CDATA[new GenericEvent()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[dispatch]]></code> + <code><![CDATA[registerAuthMechanism]]></code> + <code><![CDATA[registerAuthMechanisms]]></code> + <code><![CDATA[registerBackend]]></code> + <code><![CDATA[registerBackends]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_external/lib/Service/DBConfigService.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_external/lib/Service/StoragesService.php"> + <DeprecatedMethod> + <code><![CDATA[Util::emitHook( + Filesystem::CLASSNAME, + $signal, + [ + Filesystem::signal_param_path => $mountPoint, + Filesystem::signal_param_mount_type => $mountType, + Filesystem::signal_param_users => $applicable, + ] + )]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_reminders/lib/Model/RichReminder.php"> + <ConstructorSignatureMismatch> + <code><![CDATA[public function __construct(]]></code> + <code><![CDATA[public function __construct(]]></code> + </ConstructorSignatureMismatch> + </file> + <file src="apps/files_sharing/lib/AppInfo/Application.php"> + <DeprecatedMethod> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_sharing/lib/Capabilities.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_sharing/lib/Controller/DeletedShareAPIController.php"> + <DeprecatedClass> + <code><![CDATA[new QueryException()]]></code> + <code><![CDATA[new QueryException()]]></code> + <code><![CDATA[new QueryException()]]></code> + </DeprecatedClass> </file> <file src="apps/files_sharing/lib/Controller/ShareAPIController.php"> + <DeprecatedClass> + <code><![CDATA[new QueryException()]]></code> + <code><![CDATA[new QueryException()]]></code> + <code><![CDATA[new QueryException()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> <RedundantCast> <code><![CDATA[(int)$code]]></code> <code><![CDATA[(int)$code]]></code> @@ -865,7 +1588,40 @@ <code><![CDATA[\OCA\Talk\Share\Helper\ShareAPIController]]></code> </UndefinedDocblockClass> </file> + <file src="apps/files_sharing/lib/Controller/ShareController.php"> + <DeprecatedClass> + <code><![CDATA[Share::class]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[emitAccessShareHook]]></code> + <code><![CDATA[emitAccessShareHook]]></code> + <code><![CDATA[emitAccessShareHook]]></code> + <code><![CDATA[emitAccessShareHook]]></code> + <code><![CDATA[emitAccessShareHook]]></code> + <code><![CDATA[emitAccessShareHook]]></code> + <code><![CDATA[emitAccessShareHook]]></code> + <code><![CDATA[emitAccessShareHook]]></code> + </DeprecatedMethod> + </file> <file src="apps/files_sharing/lib/External/Manager.php"> + <DeprecatedClass> + <code><![CDATA[Files::buildNotExistingFileName($shareFolder, $share['name'])]]></code> + <code><![CDATA[Files::buildNotExistingFileName('/', $name)]]></code> + <code><![CDATA[Share::RESPONSE_FORMAT]]></code> + <code><![CDATA[\OC_Util::setupFS($user)]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[Files::buildNotExistingFileName($shareFolder, $share['name'])]]></code> + <code><![CDATA[Files::buildNotExistingFileName('/', $name)]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[insertIfNotExist]]></code> + <code><![CDATA[sendNotification]]></code> + <code><![CDATA[sendNotification]]></code> + </DeprecatedMethod> <LessSpecificReturnStatement> <code><![CDATA[$mount]]></code> </LessSpecificReturnStatement> @@ -874,15 +1630,71 @@ </MoreSpecificReturnType> </file> <file src="apps/files_sharing/lib/External/Scanner.php"> - <MoreSpecificImplementedParamType> - <code><![CDATA[$cacheData]]></code> - </MoreSpecificImplementedParamType> + <DeprecatedInterface> + <code><![CDATA[Scanner]]></code> + </DeprecatedInterface> + </file> + <file src="apps/files_sharing/lib/External/Storage.php"> + <DeprecatedInterface> + <code><![CDATA[Storage]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[Util::isSharingDisabledForUser()]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_sharing/lib/Helper.php"> + <DeprecatedMethod> + <code><![CDATA[Util::connectHook('OC_Filesystem', 'post_delete', '\OCA\Files_Sharing\Hooks', 'unshareChildren')]]></code> + <code><![CDATA[Util::connectHook('OC_Filesystem', 'post_rename', '\OCA\Files_Sharing\Updater', 'renameHook')]]></code> + <code><![CDATA[Util::connectHook('OC_User', 'post_deleteUser', '\OCA\Files_Sharing\Hooks', 'deleteUser')]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_sharing/lib/Middleware/SharingCheckMiddleware.php"> + <DeprecatedInterface> + <code><![CDATA[protected]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[hasAnnotation]]></code> + <code><![CDATA[hasAnnotation]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_sharing/lib/Migration/OwncloudGuestShareType.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_sharing/lib/Migration/SetAcceptedStatus.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_sharing/lib/Migration/SetPasswordColumn.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_sharing/lib/Migration/Version11300Date20201120141438.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[getName]]></code> + </DeprecatedMethod> </file> <file src="apps/files_sharing/lib/MountProvider.php"> <RedundantFunctionCall> <code><![CDATA[array_values]]></code> </RedundantFunctionCall> </file> + <file src="apps/files_sharing/lib/Scanner.php"> + <DeprecatedInterface> + <code><![CDATA[Scanner]]></code> + </DeprecatedInterface> + </file> <file src="apps/files_sharing/lib/ShareBackend/File.php"> <InvalidArgument> <code><![CDATA[$itemSource]]></code> @@ -893,6 +1705,10 @@ </MoreSpecificImplementedParamType> </file> <file src="apps/files_sharing/lib/ShareBackend/Folder.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> <UndefinedInterfaceMethod> <code><![CDATA[fetchRow]]></code> </UndefinedInterfaceMethod> @@ -903,6 +1719,15 @@ </InvalidReturnType> </file> <file src="apps/files_sharing/lib/SharedStorage.php"> + <DeprecatedInterface> + <code><![CDATA[SharedStorage]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[Util::emitHook('\OC\Files\Storage\Shared', 'file_get_contents', $info)]]></code> + <code><![CDATA[Util::emitHook('\OC\Files\Storage\Shared', 'file_put_contents', $info)]]></code> + <code><![CDATA[Util::emitHook('\OC\Files\Storage\Shared', 'fopen', $info)]]></code> + <code><![CDATA[Util::isSharingDisabledForUser()]]></code> + </DeprecatedMethod> <FalsableReturnStatement> <code><![CDATA[$this->sourceRootInfo]]></code> </FalsableReturnStatement> @@ -913,16 +1738,78 @@ <code><![CDATA[$this->sourceRootInfo]]></code> </NullableReturnStatement> </file> + <file src="apps/files_sharing/lib/SharesReminderJob.php"> + <DeprecatedConstant> + <code><![CDATA[IQueryBuilder::PARAM_DATE]]></code> + <code><![CDATA[IQueryBuilder::PARAM_DATE]]></code> + <code><![CDATA[IQueryBuilder::PARAM_DATE]]></code> + <code><![CDATA[IQueryBuilder::PARAM_DATE]]></code> + </DeprecatedConstant> + </file> <file src="apps/files_sharing/lib/Updater.php"> + <DeprecatedMethod> + <code><![CDATA[getUserFolder]]></code> + </DeprecatedMethod> <UndefinedMethod> <code><![CDATA[moveMount]]></code> </UndefinedMethod> </file> - <file src="apps/files_sharing/templates/public.php"> - <RedundantCondition> - <code><![CDATA[$_['hideFileList'] !== true]]></code> - <code><![CDATA[isset($_['hideFileList']) && $_['hideFileList'] !== true]]></code> - </RedundantCondition> + <file src="apps/files_trashbin/lib/BackgroundJob/ExpireTrash.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($user)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_trashbin/lib/Command/CleanUp.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($uid)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_trashbin/lib/Command/Expire.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($this->user)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_trashbin/lib/Command/ExpireTrash.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($user)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_trashbin/lib/Command/RestoreAllFiles.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($uid)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_trashbin/lib/Command/Size.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> </file> <file src="apps/files_trashbin/lib/Sabre/AbstractTrash.php"> <InvalidNullableReturnType> @@ -961,20 +1848,67 @@ <code><![CDATA[ITrash]]></code> </InvalidReturnType> </file> + <file src="apps/files_trashbin/lib/Storage.php"> + <DeprecatedMethod> + <code><![CDATA[dispatch]]></code> + </DeprecatedMethod> + </file> <file src="apps/files_trashbin/lib/Trash/LegacyTrashBackend.php"> <UndefinedInterfaceMethod> <code><![CDATA[$file]]></code> </UndefinedInterfaceMethod> </file> <file src="apps/files_trashbin/lib/Trashbin.php"> + <DeprecatedMethod> + <code><![CDATA[Util::emitHook('\OCA\Files_Trashbin\Trashbin', 'post_moveToTrash', ['filePath' => Filesystem::normalizePath($file_path), + 'trashPath' => Filesystem::normalizePath(static::getTrashFilename($filename, $timestamp))])]]></code> + <code><![CDATA[Util::emitHook('\OCA\Files_Trashbin\Trashbin', 'post_restore', ['filePath' => $targetPath, 'trashPath' => $sourcePath])]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getUserFolder]]></code> + <code><![CDATA[getUserFolder]]></code> + <code><![CDATA[getUserFolder]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + </DeprecatedMethod> <InvalidArgument> <code><![CDATA[$timestamp]]></code> </InvalidArgument> </file> - <file src="apps/files_versions/appinfo/routes.php"> - <InvalidScope> - <code><![CDATA[$this->create('files_versions_download', 'apps/files_versions/download.php')]]></code> - </InvalidScope> + <file src="apps/files_versions/lib/AppInfo/Application.php"> + <DeprecatedClass> + <code><![CDATA[LegacyRollbackListener::class]]></code> + </DeprecatedClass> + <DeprecatedInterface> + <code><![CDATA[$server]]></code> + </DeprecatedInterface> + </file> + <file src="apps/files_versions/lib/BackgroundJob/ExpireVersions.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($user)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_versions/lib/Command/CleanUp.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($user)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> + <file src="apps/files_versions/lib/Command/ExpireVersions.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($user)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> </file> <file src="apps/files_versions/lib/Sabre/RestoreFolder.php"> <InvalidNullableReturnType> @@ -984,52 +1918,288 @@ <code><![CDATA[null]]></code> </NullableReturnStatement> </file> + <file src="apps/files_versions/lib/Sabre/VersionFile.php"> + <DeprecatedMethod> + <code><![CDATA[getLabel]]></code> + <code><![CDATA[setVersionLabel]]></code> + </DeprecatedMethod> + </file> <file src="apps/files_versions/lib/Sabre/VersionHome.php"> <InvalidNullableReturnType> <code><![CDATA[getChild]]></code> </InvalidNullableReturnType> </file> <file src="apps/files_versions/lib/Storage.php"> - <RedundantCondition> - <code><![CDATA[$storage1->instanceOfStorage('\OC\Files\ObjectStore\ObjectStoreStorage')]]></code> - </RedundantCondition> + <DeprecatedClass> + <code><![CDATA[Files::streamCopy($source, $target, true)]]></code> + <code><![CDATA[\OC_Util::setupFS($uid)]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[Files::streamCopy($source, $target, true)]]></code> + <code><![CDATA[dispatch]]></code> + </DeprecatedMethod> </file> <file src="apps/lookup_server_connector/lib/BackgroundJobs/RetryJob.php"> - <InvalidArgument> - <code><![CDATA[$this->retries + 1]]></code> - </InvalidArgument> + <DeprecatedConstant> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + </DeprecatedConstant> </file> <file src="apps/oauth2/lib/Controller/OauthApiController.php"> <NoInterfaceProperties> <code><![CDATA[$this->request->server]]></code> </NoInterfaceProperties> </file> + <file src="apps/provisioning_api/lib/Controller/AUserDataOCSController.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($user->getUID())]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedConstant> + <code><![CDATA[IAccountManager::PROPERTY_DISPLAYNAME_LEGACY]]></code> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + </DeprecatedConstant> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + <code><![CDATA[implementsActions]]></code> + <code><![CDATA[implementsActions]]></code> + </DeprecatedMethod> + </file> <file src="apps/provisioning_api/lib/Controller/UsersController.php"> + <DeprecatedConstant> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + </DeprecatedConstant> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[implementsActions]]></code> + <code><![CDATA[implementsActions]]></code> + <code><![CDATA[implementsActions]]></code> + </DeprecatedMethod> <TypeDoesNotContainNull> <code><![CDATA[$groupid === null]]></code> <code><![CDATA[$groupid === null]]></code> </TypeDoesNotContainNull> </file> + <file src="apps/provisioning_api/lib/FederatedShareProviderFactory.php"> + <DeprecatedInterface> + <code><![CDATA[private]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[query]]></code> + </DeprecatedMethod> + </file> <file src="apps/provisioning_api/lib/Middleware/ProvisioningApiMiddleware.php"> + <DeprecatedInterface> + <code><![CDATA[IControllerMethodReflector]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[hasAnnotation]]></code> + <code><![CDATA[hasAnnotation]]></code> + </DeprecatedMethod> <InvalidReturnType> <code><![CDATA[Response]]></code> </InvalidReturnType> </file> <file src="apps/settings/lib/AppInfo/Application.php"> + <DeprecatedInterface> + <code><![CDATA[$serverContainer]]></code> + <code><![CDATA[$serverContainer]]></code> + <code><![CDATA[IAppContainer]]></code> + <code><![CDATA[IAppContainer]]></code> + <code><![CDATA[IAppContainer]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[Util::connectHook('OC_User', 'changeUser', $this, 'onChangeInfo')]]></code> + <code><![CDATA[Util::connectHook('OC_User', 'post_setPassword', $this, 'onChangePassword')]]></code> + <code><![CDATA[getConfig]]></code> + <code><![CDATA[getCrypto]]></code> + <code><![CDATA[getL10NFactory]]></code> + <code><![CDATA[getMailer]]></code> + <code><![CDATA[getSecureRandom]]></code> + <code><![CDATA[getURLGenerator]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + </DeprecatedMethod> <UndefinedInterfaceMethod> <code><![CDATA[getSettingsManager]]></code> </UndefinedInterfaceMethod> </file> + <file src="apps/settings/lib/BackgroundJobs/VerifyUserData.php"> + <DeprecatedConstant> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + </DeprecatedConstant> + </file> + <file src="apps/settings/lib/Controller/AppSettingsController.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getSupportedApps]]></code> + </DeprecatedMethod> + </file> + <file src="apps/settings/lib/Controller/MailSettingsController.php"> + <DeprecatedMethod> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/settings/lib/Controller/UsersController.php"> + <DeprecatedConstant> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + </DeprecatedConstant> + <DeprecatedMethod> + <code><![CDATA[dispatch]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/settings/lib/Controller/WebAuthnController.php"> + <DeprecatedMethod> + <code><![CDATA[PublicKeyCredentialCreationOptions::createFromArray($this->session->get(self::WEBAUTHN_REGISTRATION))]]></code> + </DeprecatedMethod> + </file> <file src="apps/settings/lib/Hooks.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> <InvalidArrayOffset> <code><![CDATA[[$user->getEMailAddress() => $user->getDisplayName()]]]></code> </InvalidArrayOffset> </file> + <file src="apps/settings/lib/Settings/Admin/ArtificialIntelligence.php"> + <DeprecatedInterface> + <code><![CDATA[$taskProcessingSettings]]></code> + <code><![CDATA[$textProcessingSettings]]></code> + <code><![CDATA[private]]></code> + <code><![CDATA[private]]></code> + <code><![CDATA[private]]></code> + <code><![CDATA[private]]></code> + <code><![CDATA[try { + $taskType = $this->container->get($taskTypeClass); + } catch (NotFoundExceptionInterface $e) { + continue; + } catch (ContainerExceptionInterface $e) { + continue; + }]]></code> + </DeprecatedInterface> + </file> <file src="apps/settings/lib/Settings/Admin/Security.php"> <UndefinedInterfaceMethod> <code><![CDATA[isReady]]></code> </UndefinedInterfaceMethod> </file> + <file src="apps/settings/lib/Settings/Admin/Server.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/settings/lib/Settings/Admin/Sharing.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/settings/lib/Settings/Personal/PersonalInfo.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($user->getUID())]]></code> + </DeprecatedClass> + <DeprecatedConstant> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + </DeprecatedConstant> + </file> + <file src="apps/settings/lib/Settings/Personal/Security/Authtokens.php"> + <DeprecatedClass> + <code><![CDATA[IToken::WIPE_TOKEN]]></code> + </DeprecatedClass> + <DeprecatedInterface> + <code><![CDATA[IToken]]></code> + </DeprecatedInterface> + </file> + <file src="apps/settings/lib/Settings/Personal/Security/WebAuthn.php"> + <DeprecatedInterface> + <code><![CDATA[private]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[provideInitialState]]></code> + </DeprecatedMethod> + </file> + <file src="apps/settings/lib/Settings/Personal/ServerDevNotice.php"> + <DeprecatedMethod> + <code><![CDATA[dispatch]]></code> + </DeprecatedMethod> + </file> + <file src="apps/settings/lib/SetupChecks/CheckUserCertificates.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/settings/lib/SetupChecks/CronErrors.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/settings/lib/SetupChecks/EmailTestSuccessful.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/settings/lib/SetupChecks/PushService.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/settings/lib/SetupChecks/SupportedDatabase.php"> + <DeprecatedMethod> + <code><![CDATA[getDatabasePlatform]]></code> + </DeprecatedMethod> + </file> + <file src="apps/sharebymail/lib/Settings/SettingsManager.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/sharebymail/lib/ShareByMailProvider.php"> <InvalidArgument> <code><![CDATA[$share->getId()]]></code> @@ -1037,12 +2207,200 @@ </InvalidArgument> </file> <file src="apps/systemtags/lib/Activity/Listener.php"> + <DeprecatedConstant> + <code><![CDATA[ManagerEvent::EVENT_CREATE]]></code> + <code><![CDATA[ManagerEvent::EVENT_CREATE]]></code> + <code><![CDATA[ManagerEvent::EVENT_DELETE]]></code> + <code><![CDATA[ManagerEvent::EVENT_UPDATE]]></code> + <code><![CDATA[ManagerEvent::EVENT_UPDATE]]></code> + <code><![CDATA[MapperEvent::EVENT_ASSIGN]]></code> + <code><![CDATA[MapperEvent::EVENT_ASSIGN]]></code> + <code><![CDATA[MapperEvent::EVENT_ASSIGN]]></code> + <code><![CDATA[MapperEvent::EVENT_UNASSIGN]]></code> + <code><![CDATA[MapperEvent::EVENT_UNASSIGN]]></code> + </DeprecatedConstant> <InvalidArgument> <code><![CDATA[$event->getObjectId()]]></code> <code><![CDATA[$event->getObjectId()]]></code> </InvalidArgument> </file> + <file src="apps/systemtags/lib/AppInfo/Application.php"> + <DeprecatedConstant> + <code><![CDATA[ManagerEvent::EVENT_CREATE]]></code> + <code><![CDATA[ManagerEvent::EVENT_DELETE]]></code> + <code><![CDATA[ManagerEvent::EVENT_UPDATE]]></code> + <code><![CDATA[MapperEvent::EVENT_ASSIGN]]></code> + <code><![CDATA[MapperEvent::EVENT_UNASSIGN]]></code> + </DeprecatedConstant> + <DeprecatedMethod> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + </DeprecatedMethod> + </file> + <file src="apps/testing/lib/AlternativeHomeUserBackend.php"> + <DeprecatedInterface> + <code><![CDATA[AlternativeHomeUserBackend]]></code> + </DeprecatedInterface> + </file> + <file src="apps/testing/lib/AppInfo/Application.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getConfig]]></code> + <code><![CDATA[getUserManager]]></code> + </DeprecatedMethod> + </file> + <file src="apps/testing/lib/Controller/ConfigController.php"> + <DeprecatedMethod> + <code><![CDATA[deleteAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/testing/lib/Controller/LockingController.php"> + <DeprecatedMethod> + <code><![CDATA[deleteAppValue]]></code> + <code><![CDATA[getAppKeys]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/testing/lib/Locking/FakeDBLockingProvider.php"> + <DeprecatedMethod> + <code><![CDATA[executeUpdate]]></code> + </DeprecatedMethod> + </file> + <file src="apps/testing/lib/Provider/FakeText2ImageProvider.php"> + <DeprecatedInterface> + <code><![CDATA[FakeText2ImageProvider]]></code> + </DeprecatedInterface> + </file> + <file src="apps/testing/lib/Provider/FakeTextProcessingProvider.php"> + <DeprecatedClass> + <code><![CDATA[FakeTextProcessingProvider]]></code> + <code><![CDATA[FreePromptTaskType::class]]></code> + </DeprecatedClass> + <DeprecatedInterface> + <code><![CDATA[FakeTextProcessingProvider]]></code> + <code><![CDATA[FakeTextProcessingProvider]]></code> + </DeprecatedInterface> + </file> + <file src="apps/testing/lib/Provider/FakeTextProcessingProviderSync.php"> + <DeprecatedClass> + <code><![CDATA[FakeTextProcessingProviderSync]]></code> + <code><![CDATA[FreePromptTaskType::class]]></code> + </DeprecatedClass> + <DeprecatedInterface> + <code><![CDATA[FakeTextProcessingProviderSync]]></code> + <code><![CDATA[FakeTextProcessingProviderSync]]></code> + <code><![CDATA[FakeTextProcessingProviderSync]]></code> + </DeprecatedInterface> + </file> + <file src="apps/testing/lib/Provider/FakeTranslationProvider.php"> + <DeprecatedClass> + <code><![CDATA[new LanguageTuple('de', 'German', 'en', 'English')]]></code> + <code><![CDATA[new LanguageTuple('en', 'English', 'de', 'German')]]></code> + </DeprecatedClass> + <DeprecatedInterface> + <code><![CDATA[FakeTranslationProvider]]></code> + </DeprecatedInterface> + </file> + <file src="apps/theming/lib/Capabilities.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/theming/lib/Command/UpdateConfig.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/theming/lib/Controller/ThemingController.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/theming/lib/ImageManager.php"> + <DeprecatedMethod> + <code><![CDATA[deleteAppValue]]></code> + <code><![CDATA[deleteAppValue]]></code> + <code><![CDATA[deleteAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/theming/lib/Settings/Admin.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/theming/lib/Settings/Personal.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/theming/lib/Themes/CommonThemeTrait.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/theming/lib/ThemingDefaults.php"> + <DeprecatedMethod> + <code><![CDATA[deleteAppValue]]></code> + <code><![CDATA[deleteAppValue]]></code> + <code><![CDATA[deleteAppValues]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/theming/lib/Util.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> <InvalidReturnStatement> <code><![CDATA[array_values($color->getRgb())]]></code> </InvalidReturnStatement> @@ -1050,12 +2408,109 @@ <code><![CDATA[array{0: int, 1: int, 2: int}]]></code> </InvalidReturnType> </file> + <file src="apps/twofactor_backupcodes/lib/Db/BackupCodeMapper.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="apps/twofactor_backupcodes/lib/Migration/Version1002Date20170607113030.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="apps/twofactor_backupcodes/lib/Migration/Version1002Date20170919123342.php"> + <DeprecatedMethod> + <code><![CDATA[getName]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_ldap/ajax/clearMappings.php"> + <DeprecatedMethod> + <code><![CDATA[\OC_JSON::callCheck()]]></code> + <code><![CDATA[\OC_JSON::checkAdminUser()]]></code> + <code><![CDATA[\OC_JSON::checkAppEnabled('user_ldap')]]></code> + <code><![CDATA[\OC_JSON::error(['message' => $e->getMessage()])]]></code> + <code><![CDATA[\OC_JSON::success()]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_ldap/ajax/deleteConfiguration.php"> + <DeprecatedMethod> + <code><![CDATA[\OC_JSON::callCheck()]]></code> + <code><![CDATA[\OC_JSON::checkAdminUser()]]></code> + <code><![CDATA[\OC_JSON::checkAppEnabled('user_ldap')]]></code> + <code><![CDATA[\OC_JSON::error(['message' => $l->t('Failed to delete the server configuration')])]]></code> + <code><![CDATA[\OC_JSON::success()]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_ldap/ajax/getConfiguration.php"> + <DeprecatedMethod> + <code><![CDATA[\OC_JSON::callCheck()]]></code> + <code><![CDATA[\OC_JSON::checkAdminUser()]]></code> + <code><![CDATA[\OC_JSON::checkAppEnabled('user_ldap')]]></code> + <code><![CDATA[\OC_JSON::success(['configuration' => $configuration])]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_ldap/ajax/getNewServerConfigPrefix.php"> + <DeprecatedMethod> + <code><![CDATA[\OC_JSON::callCheck()]]></code> + <code><![CDATA[\OC_JSON::checkAdminUser()]]></code> + <code><![CDATA[\OC_JSON::checkAppEnabled('user_ldap')]]></code> + <code><![CDATA[\OC_JSON::success($resultData)]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_ldap/ajax/setConfiguration.php"> + <DeprecatedMethod> + <code><![CDATA[\OC_JSON::callCheck()]]></code> + <code><![CDATA[\OC_JSON::checkAdminUser()]]></code> + <code><![CDATA[\OC_JSON::checkAppEnabled('user_ldap')]]></code> + <code><![CDATA[\OC_JSON::success()]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_ldap/ajax/testConfiguration.php"> + <DeprecatedMethod> + <code><![CDATA[\OC_JSON::callCheck()]]></code> + <code><![CDATA[\OC_JSON::checkAdminUser()]]></code> + <code><![CDATA[\OC_JSON::checkAppEnabled('user_ldap')]]></code> + <code><![CDATA[\OC_JSON::error(['message' + => $l->t('Valid configuration, but binding failed. Please check the server settings and credentials.')])]]></code> + <code><![CDATA[\OC_JSON::error(['message' + => $l->t('Invalid configuration: %s', $configurationError)])]]></code> + <code><![CDATA[\OC_JSON::error(['message' => $e->getMessage()])]]></code> + <code><![CDATA[\OC_JSON::error(['message' => $l->t('Invalid configuration: Anonymous binding is not allowed.')])]]></code> + <code><![CDATA[\OC_JSON::success(['message' + => $l->t('Valid configuration, connection established!')])]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_ldap/ajax/wizard.php"> + <DeprecatedMethod> + <code><![CDATA[\OC_JSON::callCheck()]]></code> + <code><![CDATA[\OC_JSON::checkAdminUser()]]></code> + <code><![CDATA[\OC_JSON::checkAppEnabled('user_ldap')]]></code> + <code><![CDATA[\OC_JSON::error()]]></code> + <code><![CDATA[\OC_JSON::error()]]></code> + <code><![CDATA[\OC_JSON::error(['message' => $e->getMessage(), 'code' => $e->getCode()])]]></code> + <code><![CDATA[\OC_JSON::error(['message' => $e->getMessage()])]]></code> + <code><![CDATA[\OC_JSON::error(['message' => $l->t('Action does not exist')])]]></code> + <code><![CDATA[\OC_JSON::error(['message' => $l->t('Could not set configuration %1$s to %2$s', [$key, $setParameters[0]])])]]></code> + <code><![CDATA[\OC_JSON::error(['message' => $l->t('Invalid data specified')])]]></code> + <code><![CDATA[\OC_JSON::error(['message' => $l->t('No action specified')])]]></code> + <code><![CDATA[\OC_JSON::error(['message' => $l->t('No configuration specified')])]]></code> + <code><![CDATA[\OC_JSON::error(['message' => $l->t('No data specified')])]]></code> + <code><![CDATA[\OC_JSON::success($result->getResultArray())]]></code> + <code><![CDATA[\OC_JSON::success($result->getResultArray())]]></code> + <code><![CDATA[\OC_JSON::success()]]></code> + </DeprecatedMethod> + </file> <file src="apps/user_ldap/appinfo/routes.php"> <InvalidScope> <code><![CDATA[$this]]></code> </InvalidScope> </file> <file src="apps/user_ldap/lib/Access.php"> + <DeprecatedMethod> + <code><![CDATA[emit]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> <InvalidReturnStatement> <code><![CDATA[$uuid]]></code> <code><![CDATA[$values]]></code> @@ -1067,6 +2522,37 @@ <code><![CDATA[(int)$e->getCode()]]></code> </RedundantCast> </file> + <file src="apps/user_ldap/lib/AppInfo/Application.php"> + <DeprecatedInterface> + <code><![CDATA[$server]]></code> + <code><![CDATA[$server]]></code> + <code><![CDATA[IAppContainer]]></code> + <code><![CDATA[IAppContainer]]></code> + <code><![CDATA[IAppContainer]]></code> + <code><![CDATA[IAppContainer]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[Util::connectHook( + '\OCA\Files_Sharing\API\Server2Server', + 'preLoginNameUsedAsUserName', + '\OCA\User_LDAP\Helper', + 'loginName2UserName' + )]]></code> + <code><![CDATA[dispatch]]></code> + <code><![CDATA[getConfig]]></code> + <code><![CDATA[getConfig]]></code> + <code><![CDATA[getRequest]]></code> + <code><![CDATA[getURLGenerator]]></code> + <code><![CDATA[registerService]]></code> + <code><![CDATA[registerService]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_ldap/lib/Configuration.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/user_ldap/lib/Connection.php"> <NoValue> <code><![CDATA[$subj]]></code> @@ -1087,12 +2573,57 @@ <code><![CDATA[$gid]]></code> </ParamNameMismatch> </file> + <file src="apps/user_ldap/lib/Jobs/CleanUp.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/user_ldap/lib/Jobs/Sync.php"> + <DeprecatedMethod> + <code><![CDATA[getAppKeys]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> <InvalidOperand> <code><![CDATA[$i]]></code> </InvalidOperand> </file> + <file src="apps/user_ldap/lib/Jobs/UpdateGroups.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_ldap/lib/LDAPProvider.php"> + <DeprecatedInterface> + <code><![CDATA[IServerContainer]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[getGroupManager]]></code> + <code><![CDATA[getUserManager]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_ldap/lib/LDAPProviderFactory.php"> + <DeprecatedInterface> + <code><![CDATA[private]]></code> + </DeprecatedInterface> + </file> <file src="apps/user_ldap/lib/Mapping/AbstractMapping.php"> + <DeprecatedClass> + <code><![CDATA[\Doctrine\DBAL\FetchMode::ASSOCIATIVE]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[getDatabasePlatform]]></code> + <code><![CDATA[insertIfNotExist]]></code> + </DeprecatedMethod> <RedundantCondition> <code><![CDATA[isset($qb)]]></code> </RedundantCondition> @@ -1100,26 +2631,45 @@ <code><![CDATA[isset($qb)]]></code> </TypeDoesNotContainNull> </file> + <file src="apps/user_ldap/lib/Migration/RemoveRefreshTime.php"> + <DeprecatedMethod> + <code><![CDATA[deleteAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_ldap/lib/Migration/UUIDFixInsert.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_ldap/lib/Migration/Version1120Date20210917155206.php"> + <DeprecatedMethod> + <code><![CDATA[emit]]></code> + <code><![CDATA[emit]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_ldap/lib/Migration/Version1130Date20211102154716.php"> + <DeprecatedMethod> + <code><![CDATA[getDatabasePlatform]]></code> + </DeprecatedMethod> + </file> <file src="apps/user_ldap/lib/User/Manager.php"> <InvalidDocblock> <code><![CDATA[public function setLdapAccess(Access $access) {]]></code> </InvalidDocblock> </file> <file src="apps/user_ldap/lib/User/User.php"> - <FalsableReturnStatement> - <code><![CDATA[$this->avatarImage]]></code> - </FalsableReturnStatement> - <InvalidPropertyAssignmentValue> - <code><![CDATA[$this->refreshedFeatures]]></code> - </InvalidPropertyAssignmentValue> - <InvalidReturnType> - <code><![CDATA[null]]></code> - </InvalidReturnType> - <RedundantCondition> - <code><![CDATA[$aQuota && (count($aQuota) > 0)]]></code> - </RedundantCondition> + <DeprecatedConstant> + <code><![CDATA[IAccountManager::PROPERTY_TWITTER]]></code> + </DeprecatedConstant> + <DeprecatedMethod> + <code><![CDATA[Util::connectHook('OC_User', 'post_login', $this, 'handlePasswordExpiry')]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> </file> <file src="apps/user_ldap/lib/User_LDAP.php"> + <DeprecatedInterface> + <code><![CDATA[User_LDAP]]></code> + </DeprecatedInterface> <ImplementedReturnTypeMismatch> <code><![CDATA[string|false]]></code> </ImplementedReturnTypeMismatch> @@ -1136,6 +2686,9 @@ </RedundantCondition> </file> <file src="apps/user_ldap/lib/User_Proxy.php"> + <DeprecatedInterface> + <code><![CDATA[User_Proxy]]></code> + </DeprecatedInterface> <ParamNameMismatch> <code><![CDATA[$uid]]></code> </ParamNameMismatch> @@ -1146,10 +2699,45 @@ </InvalidArrayOffset> </file> <file src="apps/user_status/lib/AppInfo/Application.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[query]]></code> + </DeprecatedMethod> <UndefinedInterfaceMethod> <code><![CDATA[registerProvider]]></code> </UndefinedInterfaceMethod> </file> + <file src="apps/user_status/lib/Listener/BeforeTemplateRenderedListener.php"> + <DeprecatedInterface> + <code><![CDATA[IInitialStateService]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[provideLazyInitialState]]></code> + <code><![CDATA[provideLazyInitialState]]></code> + </DeprecatedMethod> + </file> + <file src="apps/user_status/lib/Service/PredefinedStatusService.php"> + <DeprecatedConstant> + <code><![CDATA[self::CALL]]></code> + <code><![CDATA[self::CALL]]></code> + <code><![CDATA[self::CALL]]></code> + <code><![CDATA[self::CALL]]></code> + </DeprecatedConstant> + </file> + <file src="apps/user_status/lib/Service/StatusService.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/workflowengine/lib/BackgroundJobs/Rotate.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> <file src="apps/workflowengine/lib/Check/AbstractStringCheck.php"> <NullArgument> <code><![CDATA[null]]></code> @@ -1183,11 +2771,43 @@ </InvalidArgument> </file> <file src="apps/workflowengine/lib/Entity/File.php"> + <DeprecatedConstant> + <code><![CDATA[MapperEvent::EVENT_ASSIGN]]></code> + <code><![CDATA[MapperEvent::EVENT_ASSIGN]]></code> + <code><![CDATA[MapperEvent::EVENT_ASSIGN]]></code> + </DeprecatedConstant> + <DeprecatedMethod> + <code><![CDATA[getSubject]]></code> + <code><![CDATA[getSubject]]></code> + </DeprecatedMethod> <InvalidReturnType> <code><![CDATA[string]]></code> </InvalidReturnType> </file> <file src="apps/workflowengine/lib/Manager.php"> + <DeprecatedInterface> + <code><![CDATA[protected]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + <code><![CDATA[query]]></code> + </DeprecatedMethod> <InvalidArgument> <code><![CDATA[$missingCheck]]></code> </InvalidArgument> @@ -1201,7 +2821,49 @@ <code><![CDATA[bool]]></code> </InvalidReturnType> </file> + <file src="apps/workflowengine/lib/Migration/Version2200Date20210805101925.php"> + <DeprecatedMethod> + <code><![CDATA[changeColumn]]></code> + </DeprecatedMethod> + </file> + <file src="apps/workflowengine/lib/Service/Logger.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="apps/workflowengine/lib/Service/RuleMatcher.php"> + <DeprecatedInterface> + <code><![CDATA[protected]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[query]]></code> + </DeprecatedMethod> + </file> + <file src="apps/workflowengine/lib/Settings/ASettings.php"> + <DeprecatedMethod> + <code><![CDATA[dispatch]]></code> + </DeprecatedMethod> + </file> + <file src="core/BackgroundJobs/BackgroundCleanupUpdaterBackupsJob.php"> + <DeprecatedClass> + <code><![CDATA[Files::rmdirr($dir)]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[Files::rmdirr($dir)]]></code> + </DeprecatedMethod> + </file> <file src="core/BackgroundJobs/CheckForUserCertificates.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($userId)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + <code><![CDATA[deleteAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> <ParamNameMismatch> <code><![CDATA[$arguments]]></code> </ParamNameMismatch> @@ -1211,31 +2873,126 @@ <code><![CDATA[array]]></code> </LessSpecificImplementedReturnType> </file> + <file src="core/Command/Broadcast/Test.php"> + <DeprecatedMethod> + <code><![CDATA[dispatch]]></code> + </DeprecatedMethod> + </file> + <file src="core/Command/Check.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::checkServer($this->config)]]></code> + </DeprecatedClass> + </file> <file src="core/Command/Config/Import.php"> + <DeprecatedMethod> + <code><![CDATA[deleteAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> <InvalidScalarArgument> <code><![CDATA[0]]></code> <code><![CDATA[1]]></code> </InvalidScalarArgument> </file> <file src="core/Command/Config/ListConfigs.php"> + <DeprecatedMethod> + <code><![CDATA[\OC_App::getAllApps()]]></code> + <code><![CDATA[getFilteredValues]]></code> + <code><![CDATA[getValues]]></code> + </DeprecatedMethod> <FalsableReturnStatement> <code><![CDATA[$this->appConfig->getValues($app, false)]]></code> </FalsableReturnStatement> - <TooManyArguments> - <code><![CDATA[getFilteredValues]]></code> - </TooManyArguments> + </file> + <file src="core/Command/Db/AddMissingPrimaryKeys.php"> + <DeprecatedMethod> + <code><![CDATA[hasPrimaryKey]]></code> + </DeprecatedMethod> + </file> + <file src="core/Command/Db/ConvertFilecacheBigInt.php"> + <DeprecatedMethod> + <code><![CDATA[getName]]></code> + </DeprecatedMethod> </file> <file src="core/Command/Db/ConvertType.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[getName]]></code> + <code><![CDATA[getPrimaryKeyColumns]]></code> + </DeprecatedMethod> <InvalidScalarArgument> <code><![CDATA[0]]></code> <code><![CDATA[1]]></code> </InvalidScalarArgument> </file> + <file src="core/Command/Db/ExportSchema.php"> + <DeprecatedMethod> + <code><![CDATA[getDatabasePlatform]]></code> + <code><![CDATA[getDatabasePlatform]]></code> + </DeprecatedMethod> + </file> + <file src="core/Command/Db/Migrations/ExecuteCommand.php"> + <DeprecatedMethod> + <code><![CDATA[\OC_App::getAllApps()]]></code> + </DeprecatedMethod> + </file> + <file src="core/Command/Db/Migrations/GenerateCommand.php"> + <DeprecatedMethod> + <code><![CDATA[Util::getVersion()]]></code> + </DeprecatedMethod> + </file> + <file src="core/Command/Db/Migrations/MigrateCommand.php"> + <DeprecatedMethod> + <code><![CDATA[\OC_App::getAllApps()]]></code> + </DeprecatedMethod> + </file> + <file src="core/Command/Db/Migrations/StatusCommand.php"> + <DeprecatedMethod> + <code><![CDATA[\OC_App::getAllApps()]]></code> + </DeprecatedMethod> + </file> + <file src="core/Command/Encryption/ChangeKeyStorageRoot.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($uid)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> + <file src="core/Command/Encryption/DecryptAll.php"> + <DeprecatedMethod> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="core/Command/Encryption/Disable.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> + </file> <file src="core/Command/Encryption/Enable.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[getAppValue]]></code> + <code><![CDATA[setAppValue]]></code> + </DeprecatedMethod> <NullArgument> <code><![CDATA[null]]></code> </NullArgument> </file> + <file src="core/Command/Encryption/MigrateKeyStorage.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($uid)]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> <file src="core/Command/Log/File.php"> <InvalidReturnStatement> <code><![CDATA[[0]]]></code> @@ -1254,12 +3011,6 @@ <code><![CDATA[$this->timeFactory->getTime()]]></code> </InvalidScalarArgument> </file> - <file src="core/Command/Maintenance/Mimetype/UpdateDB.php"> - <UndefinedInterfaceMethod> - <code><![CDATA[getAllMappings]]></code> - <code><![CDATA[updateFilecache]]></code> - </UndefinedInterfaceMethod> - </file> <file src="core/Command/Preview/Repair.php"> <UndefinedInterfaceMethod> <code><![CDATA[section]]></code> @@ -1271,6 +3022,89 @@ <code><![CDATA[[]]]></code> </InvalidReturnStatement> </file> + <file src="core/Command/Security/BruteforceAttempts.php"> + <DeprecatedMethod> + <code><![CDATA[getAttempts]]></code> + <code><![CDATA[getDelay]]></code> + </DeprecatedMethod> + </file> + <file src="core/Command/Security/BruteforceResetAttempts.php"> + <DeprecatedMethod> + <code><![CDATA[resetDelayForIP]]></code> + </DeprecatedMethod> + </file> + <file src="core/Command/Upgrade.php"> + <DeprecatedMethod> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + </DeprecatedMethod> + </file> + <file src="core/Command/User/AuthTokens/Add.php"> + <DeprecatedClass> + <code><![CDATA[IToken::DO_NOT_REMEMBER]]></code> + <code><![CDATA[IToken::PERMANENT_TOKEN]]></code> + </DeprecatedClass> + </file> + <file src="core/Command/User/AuthTokens/ListCommand.php"> + <DeprecatedClass> + <code><![CDATA[IToken::PERMANENT_TOKEN]]></code> + <code><![CDATA[IToken::TEMPORARY_TOKEN]]></code> + <code><![CDATA[IToken::WIPE_TOKEN]]></code> + </DeprecatedClass> + <DeprecatedInterface> + <code><![CDATA[IToken]]></code> + </DeprecatedInterface> + </file> + <file src="core/Command/User/Info.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($user->getUID())]]></code> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[\OC_Util::tearDownFS()]]></code> + </DeprecatedMethod> + </file> + <file src="core/Command/User/Setting.php"> + <DeprecatedMethod> + <code><![CDATA[setEMailAddress]]></code> + </DeprecatedMethod> + </file> + <file src="core/Controller/AppPasswordController.php"> + <DeprecatedClass> + <code><![CDATA[IToken::DO_NOT_REMEMBER]]></code> + <code><![CDATA[IToken::PERMANENT_TOKEN]]></code> + </DeprecatedClass> + </file> + <file src="core/Controller/AutoCompleteController.php"> + <DeprecatedClass> + <code><![CDATA[new AutoCompleteEvent([ + 'search' => $search, + 'results' => $results, + 'itemType' => $itemType, + 'itemId' => $itemId, + 'sorter' => $sorter, + 'shareTypes' => $shareTypes, + 'limit' => $limit, + ])]]></code> + </DeprecatedClass> + <DeprecatedMethod> + <code><![CDATA[dispatch]]></code> + </DeprecatedMethod> + </file> <file src="core/Controller/ClientFlowLoginV2Controller.php"> <TypeDoesNotContainType> <code><![CDATA[!is_string($stateToken)]]></code> @@ -1281,25 +3115,173 @@ <code><![CDATA[searchCollections]]></code> </UndefinedInterfaceMethod> </file> + <file src="core/Controller/LoginController.php"> + <DeprecatedMethod> + <code><![CDATA[getDelay]]></code> + </DeprecatedMethod> + </file> <file src="core/Controller/LostController.php"> + <DeprecatedMethod> + <code><![CDATA[Util::emitHook( + '\OCA\Files_Sharing\API\Server2Server', + 'preLoginNameUsedAsUserName', + ['uid' => &$user] + )]]></code> + </DeprecatedMethod> <RedundantCast> <code><![CDATA[(int)$e->getCode()]]></code> </RedundantCast> </file> + <file src="core/Controller/OCJSController.php"> + <DeprecatedInterface> + <code><![CDATA[IInitialStateService]]></code> + </DeprecatedInterface> + </file> + <file src="core/Controller/RecommendedAppsController.php"> + <DeprecatedInterface> + <code><![CDATA[private]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[provideInitialState]]></code> + </DeprecatedMethod> + </file> + <file src="core/Controller/SetupController.php"> + <DeprecatedInterface> + <code><![CDATA[protected]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[provideInitialState]]></code> + <code><![CDATA[provideInitialState]]></code> + <code><![CDATA[provideInitialState]]></code> + </DeprecatedMethod> + </file> + <file src="core/Controller/TaskProcessingApiController.php"> + <DeprecatedClass> + <code><![CDATA[\OC_Util::setupFS($task->getUserId())]]></code> + </DeprecatedClass> + </file> + <file src="core/Controller/TextProcessingApiController.php"> + <DeprecatedClass> + <code><![CDATA[Task]]></code> + <code><![CDATA[new Task($type, $input, $appId, $this->userId, $identifier)]]></code> + </DeprecatedClass> + <DeprecatedInterface> + <code><![CDATA[$object]]></code> + <code><![CDATA[Task]]></code> + <code><![CDATA[private]]></code> + </DeprecatedInterface> + </file> + <file src="core/Controller/TextToImageApiController.php"> + <DeprecatedClass> + <code><![CDATA[Task]]></code> + <code><![CDATA[new Task($input, $appId, $numberOfImages, $this->userId, $identifier)]]></code> + </DeprecatedClass> + <DeprecatedInterface> + <code><![CDATA[private]]></code> + </DeprecatedInterface> + </file> + <file src="core/Controller/TranslationApiController.php"> + <DeprecatedInterface> + <code><![CDATA[private]]></code> + </DeprecatedInterface> + </file> <file src="core/Controller/UnifiedSearchController.php"> + <DeprecatedInterface> + <code><![CDATA[private]]></code> + </DeprecatedInterface> <UndefinedInterfaceMethod> <code><![CDATA[findMatchingRoute]]></code> </UndefinedInterfaceMethod> </file> + <file src="core/Controller/WebAuthnController.php"> + <DeprecatedMethod> + <code><![CDATA[PublicKeyCredentialRequestOptions::createFromString($this->session->get(self::WEBAUTHN_LOGIN))]]></code> + <code><![CDATA[Util::emitHook( + '\OCA\Files_Sharing\API\Server2Server', + 'preLoginNameUsedAsUserName', + ['uid' => &$uid] + )]]></code> + </DeprecatedMethod> + </file> <file src="core/Middleware/TwoFactorMiddleware.php"> + <DeprecatedInterface> + <code><![CDATA[private]]></code> + </DeprecatedInterface> + <DeprecatedMethod> + <code><![CDATA[hasAnnotation]]></code> + <code><![CDATA[hasAnnotation]]></code> + </DeprecatedMethod> <NoInterfaceProperties> <code><![CDATA[$this->request->server]]></code> </NoInterfaceProperties> </file> - <file src="lib/autoloader.php"> - <RedundantCondition> - <code><![CDATA[$this->memoryCache]]></code> - </RedundantCondition> + <file src="core/Migrations/Version13000Date20170718121200.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="core/Migrations/Version14000Date20180404140050.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="core/Migrations/Version16000Date20190427105638.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="core/Migrations/Version18000Date20190920085628.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="core/Migrations/Version20000Date20201109081918.php"> + <DeprecatedMethod> + <code><![CDATA[execute]]></code> + <code><![CDATA[execute]]></code> + </DeprecatedMethod> + </file> + <file src="core/Migrations/Version21000Date20201120141228.php"> + <DeprecatedMethod> + <code><![CDATA[changeColumn]]></code> + <code><![CDATA[changeColumn]]></code> + <code><![CDATA[changeColumn]]></code> + <code><![CDATA[changeColumn]]></code> + <code><![CDATA[changeColumn]]></code> + </DeprecatedMethod> + </file> + <file src="core/Service/LoginFlowV2Service.php"> + <DeprecatedClass> + <code><![CDATA[IToken::DO_NOT_REMEMBER]]></code> + <code><![CDATA[IToken::PERMANENT_TOKEN]]></code> + </DeprecatedClass> + </file> + <file src="core/ajax/update.php"> + <DeprecatedMethod> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + <code><![CDATA[listen]]></code> + </DeprecatedMethod> + </file> + <file src="cron.php"> + <DeprecatedMethod> + <code><![CDATA[OC_JSON::error(['data' => ['message' => 'Background jobs disabled!']])]]></code> + <code><![CDATA[OC_JSON::error(['data' => ['message' => 'Backgroundjobs are using system cron!']])]]></code> + <code><![CDATA[OC_JSON::success()]]></code> + </DeprecatedMethod> </file> <file src="lib/base.php"> <InvalidArgument> @@ -1324,11 +3306,6 @@ <code><![CDATA[$key]]></code> </MoreSpecificImplementedParamType> </file> - <file src="lib/private/App/AppStore/Fetcher/Fetcher.php"> - <TooManyArguments> - <code><![CDATA[fetch]]></code> - </TooManyArguments> - </file> <file src="lib/private/App/DependencyAnalyzer.php"> <InvalidNullableReturnType> <code><![CDATA[bool]]></code> @@ -1337,46 +3314,23 @@ <code><![CDATA[version_compare($first, $second, $operator)]]></code> </NullableReturnStatement> </file> - <file src="lib/private/App/InfoParser.php"> - <InvalidArrayOffset> - <code><![CDATA[$array[$element][]]]></code> - <code><![CDATA[$array[$element][]]]></code> - </InvalidArrayOffset> - <InvalidReturnStatement> - <code><![CDATA[(string)$xml]]></code> - </InvalidReturnStatement> - <InvalidReturnType> - <code><![CDATA[array]]></code> - </InvalidReturnType> - </file> <file src="lib/private/AppConfig.php"> <NullableReturnStatement> <code><![CDATA[$this->fastCache[$app][$key] ?? $default]]></code> </NullableReturnStatement> </file> - <file src="lib/private/AppFramework/Bootstrap/Coordinator.php"> - <InvalidPropertyAssignmentValue> - <code><![CDATA[$this->bootedApps]]></code> - </InvalidPropertyAssignmentValue> - </file> <file src="lib/private/AppFramework/Bootstrap/FunctionInjector.php"> <UndefinedMethod> <code><![CDATA[getName]]></code> </UndefinedMethod> </file> <file src="lib/private/AppFramework/DependencyInjection/DIContainer.php"> - <ImplementedReturnTypeMismatch> - <code><![CDATA[boolean|null]]></code> - </ImplementedReturnTypeMismatch> <InvalidReturnStatement> <code><![CDATA[$this->server]]></code> </InvalidReturnStatement> <InvalidReturnType> <code><![CDATA[\OCP\IServerContainer]]></code> </InvalidReturnType> - <UndefinedInterfaceMethod> - <code><![CDATA[getAppDataDir]]></code> - </UndefinedInterfaceMethod> </file> <file src="lib/private/AppFramework/Http/Dispatcher.php"> <NullArgument> @@ -1426,64 +3380,15 @@ <code><![CDATA[\OCA\Talk\Controller\PageController]]></code> </UndefinedClass> </file> - <file src="lib/private/AppFramework/Routing/RouteConfig.php"> - <InvalidArrayOffset> - <code><![CDATA[$action['url-postfix']]]></code> - </InvalidArrayOffset> - </file> <file src="lib/private/AppFramework/Services/AppConfig.php"> <MoreSpecificImplementedParamType> <code><![CDATA[$default]]></code> </MoreSpecificImplementedParamType> </file> <file src="lib/private/AppFramework/Utility/SimpleContainer.php"> - <LessSpecificReturnStatement> - <code><![CDATA[$class->newInstance()]]></code> - <code><![CDATA[$class->newInstanceArgs(array_map(function (ReflectionParameter $parameter) { - $parameterType = $parameter->getType(); - - $resolveName = $parameter->getName(); - - // try to find out if it is a class or a simple parameter - if ($parameterType !== null && ($parameterType instanceof ReflectionNamedType) && !$parameterType->isBuiltin()) { - $resolveName = $parameterType->getName(); - } - - try { - $builtIn = $parameter->hasType() && ($parameter->getType() instanceof ReflectionNamedType) - && $parameter->getType()->isBuiltin(); - return $this->query($resolveName, !$builtIn); - } catch (QueryException $e) { - // Service not found, use the default value when available - if ($parameter->isDefaultValueAvailable()) { - return $parameter->getDefaultValue(); - } - - if ($parameterType !== null && ($parameterType instanceof ReflectionNamedType) && !$parameterType->isBuiltin()) { - $resolveName = $parameter->getName(); - try { - return $this->query($resolveName); - } catch (QueryException $e2) { - // Pass null if typed and nullable - if ($parameter->allowsNull() && ($parameterType instanceof ReflectionNamedType)) { - return null; - } - - // don't lose the error we got while trying to query by type - throw new QueryException($e->getMessage(), (int)$e->getCode(), $e); - } - } - - throw $e; - } - }, $constructor->getParameters()))]]></code> - </LessSpecificReturnStatement> <MissingTemplateParam> <code><![CDATA[ArrayAccess]]></code> </MissingTemplateParam> - <MoreSpecificReturnType> - <code><![CDATA[\stdClass]]></code> - </MoreSpecificReturnType> <RedundantCast> <code><![CDATA[(int)$e->getCode()]]></code> </RedundantCast> @@ -1720,9 +3625,6 @@ <InvalidArgument> <code><![CDATA[microtime(true)]]></code> </InvalidArgument> - <InvalidReturnType> - <code><![CDATA[stopQuery]]></code> - </InvalidReturnType> </file> <file src="lib/private/DirectEditing/Manager.php"> <InvalidReturnType> @@ -1772,16 +3674,9 @@ </MoreSpecificReturnType> </file> <file src="lib/private/Files/Cache/Cache.php"> - <InvalidArgument> - <code><![CDATA[$parentData]]></code> - </InvalidArgument> <InvalidNullableReturnType> <code><![CDATA[array]]></code> </InvalidNullableReturnType> - <InvalidScalarArgument> - <code><![CDATA[$path]]></code> - <code><![CDATA[\OC_Util::normalizeUnicode($path)]]></code> - </InvalidScalarArgument> <NullableReturnStatement> <code><![CDATA[null]]></code> <code><![CDATA[null]]></code> @@ -1810,12 +3705,6 @@ <InvalidArgument> <code><![CDATA[self::SCAN_RECURSIVE_INCOMPLETE]]></code> </InvalidArgument> - <InvalidReturnStatement> - <code><![CDATA[$existingChildren]]></code> - </InvalidReturnStatement> - <InvalidReturnType> - <code><![CDATA[array[]]]></code> - </InvalidReturnType> </file> <file src="lib/private/Files/Cache/Storage.php"> <InvalidNullableReturnType> @@ -1873,23 +3762,12 @@ <code><![CDATA[Mount\MountPoint[]]]></code> <code><![CDATA[\OC\Files\Storage\Storage|null]]></code> </MoreSpecificReturnType> - <TooManyArguments> - <code><![CDATA[addStorageWrapper]]></code> - </TooManyArguments> </file> <file src="lib/private/Files/Mount/MountPoint.php"> <UndefinedInterfaceMethod> <code><![CDATA[wrap]]></code> </UndefinedInterfaceMethod> </file> - <file src="lib/private/Files/Mount/ObjectHomeMountProvider.php"> - <InvalidNullableReturnType> - <code><![CDATA[\OCP\Files\Mount\IMountPoint]]></code> - </InvalidNullableReturnType> - <NullableReturnStatement> - <code><![CDATA[null]]></code> - </NullableReturnStatement> - </file> <file src="lib/private/Files/Node/File.php"> <InvalidReturnStatement> <code><![CDATA[$this->view->hash($type, $this->path, $raw)]]></code> @@ -2017,12 +3895,6 @@ <code><![CDATA[ArrayCache]]></code> <code><![CDATA[ArrayCache]]></code> </InvalidClass> - <InvalidReturnStatement> - <code><![CDATA[$response->getBody()]]></code> - </InvalidReturnStatement> - <InvalidReturnType> - <code><![CDATA[fopen]]></code> - </InvalidReturnType> </file> <file src="lib/private/Files/Storage/Local.php"> <TypeDoesNotContainNull> @@ -2040,11 +3912,6 @@ </NoInterfaceProperties> </file> <file src="lib/private/Files/Storage/Wrapper/Encoding.php"> - <InvalidArgument> - <code><![CDATA[\Normalizer::FORM_C]]></code> - <code><![CDATA[\Normalizer::FORM_C]]></code> - <code><![CDATA[\Normalizer::FORM_D]]></code> - </InvalidArgument> <UndefinedInterfaceMethod> <code><![CDATA[$this->namesCache]]></code> <code><![CDATA[$this->namesCache]]></code> @@ -2066,9 +3933,6 @@ </UndefinedInterfaceMethod> </file> <file src="lib/private/Files/Storage/Wrapper/Encryption.php"> - <InvalidOperand> - <code><![CDATA[$this->copyFromStorage($sourceStorage, $sourceInternalPath . '/' . $file, $targetInternalPath . '/' . $file, false, $isRename)]]></code> - </InvalidOperand> <InvalidReturnStatement> <code><![CDATA[$result]]></code> </InvalidReturnStatement> @@ -2091,11 +3955,6 @@ <code><![CDATA[!$isDefaultTemplates]]></code> </RedundantCondition> </file> - <file src="lib/private/Files/Type/Detection.php"> - <ParamNameMismatch> - <code><![CDATA[$mimetype]]></code> - </ParamNameMismatch> - </file> <file src="lib/private/Files/View.php"> <InvalidScalarArgument> <code><![CDATA[$mtime]]></code> @@ -2112,12 +3971,6 @@ </TypeDoesNotContainNull> </file> <file src="lib/private/Group/Group.php"> - <InvalidArgument> - <code><![CDATA[bool]]></code> - </InvalidArgument> - <InvalidOperand> - <code><![CDATA[$hide]]></code> - </InvalidOperand> <LessSpecificReturnStatement> <code><![CDATA[$users]]></code> </LessSpecificReturnStatement> @@ -2152,15 +4005,10 @@ <code><![CDATA[isAdmin]]></code> </UndefinedInterfaceMethod> </file> - <file src="lib/private/Http/Client/Response.php"> - <InvalidNullableReturnType> - <code><![CDATA[string|resource]]></code> - </InvalidNullableReturnType> - <NullableReturnStatement> - <code><![CDATA[$this->stream ? - $this->response->getBody()->detach(): - $this->response->getBody()->getContents()]]></code> - </NullableReturnStatement> + <file src="lib/private/InitialStateService.php"> + <UndefinedInterfaceMethod> + <code><![CDATA[query]]></code> + </UndefinedInterfaceMethod> </file> <file src="lib/private/Installer.php"> <InvalidArgument> @@ -2205,36 +4053,12 @@ </InvalidOperand> </file> <file src="lib/private/Lockdown/Filesystem/NullCache.php"> - <InvalidNullableReturnType> - <code><![CDATA[get]]></code> - </InvalidNullableReturnType> <InvalidReturnStatement> <code><![CDATA[[]]]></code> </InvalidReturnStatement> <InvalidReturnType> <code><![CDATA[getIncomplete]]></code> </InvalidReturnType> - <NullableReturnStatement> - <code><![CDATA[$file !== '' ? null : - new CacheEntry([ - 'fileid' => -1, - 'parent' => -1, - 'name' => '', - 'path' => '', - 'size' => '0', - 'mtime' => time(), - 'storage_mtime' => time(), - 'etag' => '', - 'mimetype' => FileInfo::MIMETYPE_FOLDER, - 'mimepart' => 'httpd', - 'permissions' => Constants::PERMISSION_READ - ])]]></code> - </NullableReturnStatement> - </file> - <file src="lib/private/Lockdown/Filesystem/NullStorage.php"> - <TooManyArguments> - <code><![CDATA[new IteratorDirectory([])]]></code> - </TooManyArguments> </file> <file src="lib/private/Lockdown/LockdownManager.php"> <InvalidFunctionCall> @@ -2277,30 +4101,20 @@ <code><![CDATA[mixed]]></code> </LessSpecificImplementedReturnType> </file> + <file src="lib/private/Notification/Manager.php"> + <UndefinedClass> + <code><![CDATA[\OCA\Notifications\App]]></code> + </UndefinedClass> + </file> <file src="lib/private/Preview/BackgroundCleanupJob.php"> <InvalidReturnStatement> <code><![CDATA[[]]]></code> </InvalidReturnStatement> </file> <file src="lib/private/Preview/Generator.php"> - <InvalidArgument> - <code><![CDATA[$maxPreviewImage]]></code> - </InvalidArgument> <LessSpecificReturnType> <code><![CDATA[null|string]]></code> </LessSpecificReturnType> - <MismatchingDocblockParamType> - <code><![CDATA[ISimpleFile]]></code> - </MismatchingDocblockParamType> - <UndefinedInterfaceMethod> - <code><![CDATA[height]]></code> - <code><![CDATA[height]]></code> - <code><![CDATA[preciseResizeCopy]]></code> - <code><![CDATA[resizeCopy]]></code> - <code><![CDATA[valid]]></code> - <code><![CDATA[width]]></code> - <code><![CDATA[width]]></code> - </UndefinedInterfaceMethod> </file> <file src="lib/private/Preview/ProviderV1Adapter.php"> <InvalidReturnStatement> @@ -2310,6 +4124,14 @@ <code><![CDATA[?IImage]]></code> </InvalidReturnType> </file> + <file src="lib/private/Profile/Actions/FediverseAction.php"> + <NoValue> + <code><![CDATA[$instance]]></code> + </NoValue> + <RedundantCondition> + <code><![CDATA[$instance === '']]></code> + </RedundantCondition> + </file> <file src="lib/private/RedisFactory.php"> <InvalidArgument> <code><![CDATA[\RedisCluster::OPT_SLAVE_FAILOVER]]></code> @@ -2321,12 +4143,6 @@ </ImplementedReturnTypeMismatch> </file> <file src="lib/private/Remote/Instance.php"> - <InvalidReturnStatement> - <code><![CDATA[$request->getBody()]]></code> - </InvalidReturnStatement> - <InvalidReturnType> - <code><![CDATA[bool|string]]></code> - </InvalidReturnType> <InvalidScalarArgument> <code><![CDATA[$response]]></code> </InvalidScalarArgument> @@ -2362,9 +4178,6 @@ </ParamNameMismatch> </file> <file src="lib/private/Route/Router.php"> - <InvalidClass> - <code><![CDATA[\OC_APP]]></code> - </InvalidClass> <InvalidNullableReturnType> <code><![CDATA[string]]></code> </InvalidNullableReturnType> @@ -2372,11 +4185,6 @@ <code><![CDATA[$this->collectionName]]></code> </NullableReturnStatement> </file> - <file src="lib/private/Security/Bruteforce/Throttler.php"> - <NullArgument> - <code><![CDATA[null]]></code> - </NullArgument> - </file> <file src="lib/private/Security/CSP/ContentSecurityPolicyNonceManager.php"> <NoInterfaceProperties> <code><![CDATA[$this->request->server]]></code> @@ -2399,14 +4207,11 @@ </file> <file src="lib/private/Server.php"> <ImplementedReturnTypeMismatch> - <code><![CDATA[\OCP\Calendar\Resource\IManager]]></code> - <code><![CDATA[\OCP\Calendar\Room\IManager]]></code> <code><![CDATA[\OCP\Files\Folder|null]]></code> </ImplementedReturnTypeMismatch> <LessSpecificReturnStatement> <code><![CDATA[$this->get(IFile::class)]]></code> <code><![CDATA[$this->get(IGroupManager::class)]]></code> - <code><![CDATA[$this->get(INavigationManager::class)]]></code> <code><![CDATA[$this->get(IUserManager::class)]]></code> <code><![CDATA[$this->get(IUserSession::class)]]></code> <code><![CDATA[$this->get(\OCP\Encryption\IManager::class)]]></code> @@ -2415,13 +4220,9 @@ <code><![CDATA[\OC\Encryption\File]]></code> <code><![CDATA[\OC\Encryption\Manager]]></code> <code><![CDATA[\OC\Group\Manager]]></code> - <code><![CDATA[\OC\NavigationManager]]></code> <code><![CDATA[\OC\User\Manager]]></code> <code><![CDATA[\OC\User\Session]]></code> </MoreSpecificReturnType> - <UndefinedDocblockClass> - <code><![CDATA[\OC\OCSClient]]></code> - </UndefinedDocblockClass> </file> <file src="lib/private/ServerContainer.php"> <InvalidPropertyAssignmentValue> @@ -2466,61 +4267,23 @@ <code><![CDATA[$share->getId()]]></code> <code><![CDATA[(int)$data['id']]]></code> </InvalidArgument> - <TooManyArguments> - <code><![CDATA[set]]></code> - </TooManyArguments> - <UndefinedInterfaceMethod> - <code><![CDATA[getParent]]></code> - </UndefinedInterfaceMethod> </file> <file src="lib/private/Share20/Manager.php"> <InvalidArgument> <code><![CDATA[$id]]></code> </InvalidArgument> - <TooManyArguments> - <code><![CDATA[update]]></code> - </TooManyArguments> <UndefinedClass> <code><![CDATA[\OCA\Circles\Api\v1\Circles]]></code> </UndefinedClass> - <UndefinedInterfaceMethod> - <code><![CDATA[getChildren]]></code> - </UndefinedInterfaceMethod> </file> <file src="lib/private/Share20/ProviderFactory.php"> - <InvalidNullableReturnType> - <code><![CDATA[FederatedShareProvider]]></code> - <code><![CDATA[ShareByMailProvider]]></code> - </InvalidNullableReturnType> <InvalidReturnStatement> <code><![CDATA[$provider]]></code> <code><![CDATA[$provider]]></code> - <code><![CDATA[$this->shareByCircleProvider]]></code> </InvalidReturnStatement> <InvalidReturnType> <code><![CDATA[getProviderForType]]></code> </InvalidReturnType> - <NullableReturnStatement> - <code><![CDATA[null]]></code> - <code><![CDATA[null]]></code> - <code><![CDATA[null]]></code> - <code><![CDATA[null]]></code> - <code><![CDATA[null]]></code> - <code><![CDATA[null]]></code> - </NullableReturnStatement> - <ParamNameMismatch> - <code><![CDATA[$shareProviderClass]]></code> - </ParamNameMismatch> - <UndefinedClass> - <code><![CDATA[\OCA\Circles\ShareByCircleProvider]]></code> - </UndefinedClass> - <UndefinedDocblockClass> - <code><![CDATA[RoomShareProvider]]></code> - <code><![CDATA[\OCA\Circles\ShareByCircleProvider]]></code> - <code><![CDATA[\OCA\Talk\Share\RoomShareProvider]]></code> - <code><![CDATA[private $roomShareProvider = null;]]></code> - <code><![CDATA[private $shareByCircleProvider = null;]]></code> - </UndefinedDocblockClass> </file> <file src="lib/private/Share20/Share.php"> <LessSpecificReturnStatement> @@ -2563,12 +4326,6 @@ <code><![CDATA[$tag]]></code> </MoreSpecificImplementedParamType> </file> - <file src="lib/private/TempManager.php"> - <FalsableReturnStatement> - <code><![CDATA[false]]></code> - <code><![CDATA[false]]></code> - </FalsableReturnStatement> - </file> <file src="lib/private/Template/CSSResourceLocator.php"> <ParamNameMismatch> <code><![CDATA[$style]]></code> @@ -2590,15 +4347,6 @@ <code><![CDATA[$script]]></code> </ParamNameMismatch> </file> - <file src="lib/private/TemplateLayout.php"> - <InvalidParamDefault> - <code><![CDATA[string]]></code> - <code><![CDATA[string]]></code> - </InvalidParamDefault> - <InvalidScalarArgument> - <code><![CDATA[$appId]]></code> - </InvalidScalarArgument> - </file> <file src="lib/private/URLGenerator.php"> <InvalidReturnStatement> <code><![CDATA[$path]]></code> @@ -2655,38 +4403,15 @@ <code><![CDATA[$matches[0][$last_match]]]></code> <code><![CDATA[$matches[1][$last_match]]]></code> </InvalidArrayOffset> - <InvalidScalarArgument> - <code><![CDATA[$path]]></code> - </InvalidScalarArgument> <UndefinedInterfaceMethod> <code><![CDATA[getQuota]]></code> </UndefinedInterfaceMethod> </file> - <file src="lib/private/legacy/OC_Template.php"> - <InvalidReturnType> - <code><![CDATA[bool|string]]></code> - </InvalidReturnType> - </file> <file src="lib/private/legacy/OC_User.php"> <UndefinedClass> <code><![CDATA[\Test\Util\User\Dummy]]></code> </UndefinedClass> </file> - <file src="lib/private/legacy/OC_Util.php"> - <InvalidReturnType> - <code><![CDATA[void]]></code> - </InvalidReturnType> - </file> - <file src="lib/public/AppFramework/ApiController.php"> - <NoInterfaceProperties> - <code><![CDATA[$this->request->server]]></code> - </NoInterfaceProperties> - </file> - <file src="lib/public/AppFramework/App.php"> - <InternalMethod> - <code><![CDATA[new RouteConfig($this->container, $router, $routes)]]></code> - </InternalMethod> - </file> <file src="lib/public/AppFramework/Http/Response.php"> <LessSpecificReturnStatement> <code><![CDATA[array_merge($mergeWith, $this->headers)]]></code> @@ -2695,35 +4420,6 @@ <code><![CDATA[array{X-Request-Id: string, Cache-Control: string, Content-Security-Policy: string, Feature-Policy: string, X-Robots-Tag: string, Last-Modified?: string, ETag?: string, ...H}]]></code> </MoreSpecificReturnType> </file> - <file src="lib/public/Color.php"> - <LessSpecificReturnStatement> - <code><![CDATA[$step]]></code> - </LessSpecificReturnStatement> - <MoreSpecificReturnType> - <code><![CDATA[array{0: int, 1: int, 2: int}]]></code> - </MoreSpecificReturnType> - </file> - <file src="lib/public/Diagnostics/IQueryLogger.php"> - <LessSpecificImplementedReturnType> - <code><![CDATA[mixed]]></code> - </LessSpecificImplementedReturnType> - </file> - <file src="lib/public/EventDispatcher/GenericEvent.php"> - <MissingTemplateParam> - <code><![CDATA[ArrayAccess]]></code> - <code><![CDATA[IteratorAggregate]]></code> - </MissingTemplateParam> - </file> - <file src="lib/public/Files.php"> - <FalsableReturnStatement> - <code><![CDATA[\OC_App::getStorage($app)]]></code> - </FalsableReturnStatement> - </file> - <file src="lib/public/L10N/ILanguageIterator.php"> - <MissingTemplateParam> - <code><![CDATA[\Iterator]]></code> - </MissingTemplateParam> - </file> <file src="lib/public/Preview/BeforePreviewFetchedEvent.php"> <LessSpecificReturnStatement> <code><![CDATA[$this->mode]]></code> @@ -2732,4 +4428,21 @@ <code><![CDATA[null|IPreview::MODE_FILL|IPreview::MODE_COVER]]></code> </MoreSpecificReturnType> </file> + <file src="ocs-provider/index.php"> + <DeprecatedMethod> + <code><![CDATA[getAppManager]]></code> + <code><![CDATA[getRequest]]></code> + </DeprecatedMethod> + </file> + <file src="public.php"> + <DeprecatedMethod> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> + <file src="remote.php"> + <DeprecatedMethod> + <code><![CDATA[exec]]></code> + <code><![CDATA[getAppValue]]></code> + </DeprecatedMethod> + </file> </files> diff --git a/build/psalm-checker.sh b/build/psalm-checker.sh new file mode 100755 index 00000000000..a56fecebe52 --- /dev/null +++ b/build/psalm-checker.sh @@ -0,0 +1,31 @@ +#!/bin/sh + +# SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors +# SPDX-License-Identifier: AGPL-3.0-or-later + +if [ -d "dist" ]; then + missing='' + for app in apps/*; do + if git check-ignore "$app" -q ; then + echo "ℹ️ Ignoring non shipped app: $app" + continue + fi + + grep "directory name=\"$app\"" psalm.xml 2>&1 > /dev/null + if [ $? -ne 0 ]; then + missing="$missing - $app\n" + fi + done + + if [ "$missing" = "" ]; then + echo "✅ All apps will be linted by psalm" + else + echo "❌ Following apps are not setup for linting using psalm:" + echo -e "$missing" + exit 1 + fi +else + echo "⚠️ This script needs to be executed from the root of the repository" + exit 1 +fi + diff --git a/build/psalm/OcpSinceChecker.php b/build/psalm/OcpSinceChecker.php index 959e70e0c4c..38af92cf4ef 100644 --- a/build/psalm/OcpSinceChecker.php +++ b/build/psalm/OcpSinceChecker.php @@ -20,7 +20,19 @@ class OcpSinceChecker implements Psalm\Plugin\EventHandler\AfterClassLikeVisitIn $classLike = $event->getStmt(); $statementsSource = $event->getStatementsSource(); - self::checkClassComment($classLike, $statementsSource); + if (!str_contains($statementsSource->getFilePath(), '/lib/public/')) { + return; + } + + $isTesting = str_contains($statementsSource->getFilePath(), '/lib/public/Notification/') + || str_contains($statementsSource->getFilePath(), '/lib/public/Config/') + || str_contains($statementsSource->getFilePath(), 'CalendarEventStatus'); + + if ($isTesting) { + self::checkStatementAttributes($classLike, $statementsSource); + } else { + self::checkClassComment($classLike, $statementsSource); + } foreach ($classLike->stmts as $stmt) { if ($stmt instanceof ClassConst) { @@ -32,11 +44,64 @@ class OcpSinceChecker implements Psalm\Plugin\EventHandler\AfterClassLikeVisitIn } if ($stmt instanceof EnumCase) { - self::checkStatementComment($stmt, $statementsSource, 'enum'); + if ($isTesting) { + self::checkStatementAttributes($classLike, $statementsSource); + } else { + self::checkStatementComment($stmt, $statementsSource, 'enum'); + } } } } + private static function checkStatementAttributes(ClassLike $stmt, FileSource $statementsSource): void { + $hasAppFrameworkAttribute = false; + $mustBeConsumable = false; + $isConsumable = false; + foreach ($stmt->attrGroups as $attrGroup) { + foreach ($attrGroup->attrs as $attr) { + if (in_array($attr->name->getLast(), [ + 'Catchable', + 'Consumable', + 'Dispatchable', + 'Implementable', + 'Listenable', + 'Throwable', + ], true)) { + $hasAppFrameworkAttribute = true; + self::checkAttributeHasValidSinceVersion($attr, $statementsSource); + } + if (in_array($attr->name->getLast(), [ + 'Catchable', + 'Consumable', + 'Listenable', + ], true)) { + $isConsumable = true; + } + if ($attr->name->getLast() === 'ExceptionalImplementable') { + $mustBeConsumable = true; + } + } + } + + if ($mustBeConsumable && !$isConsumable) { + IssueBuffer::maybeAdd( + new InvalidDocblock( + 'Attribute OCP\\AppFramework\\Attribute\\ExceptionalImplementable is only valid on classes that also have OCP\\AppFramework\\Attribute\\Consumable', + new CodeLocation($statementsSource, $stmt) + ) + ); + } + + if (!$hasAppFrameworkAttribute) { + IssueBuffer::maybeAdd( + new InvalidDocblock( + 'At least one of the OCP\\AppFramework\\Attribute attributes is required', + new CodeLocation($statementsSource, $stmt) + ) + ); + } + } + private static function checkClassComment(ClassLike $stmt, FileSource $statementsSource): void { $docblock = $stmt->getDocComment(); @@ -124,4 +189,28 @@ class OcpSinceChecker implements Psalm\Plugin\EventHandler\AfterClassLikeVisitIn ); } } + + private static function checkAttributeHasValidSinceVersion(\PhpParser\Node\Attribute $stmt, FileSource $statementsSource): void { + foreach ($stmt->args as $arg) { + if ($arg->name?->name === 'since') { + if (!$arg->value instanceof \PhpParser\Node\Scalar\String_) { + IssueBuffer::maybeAdd( + new InvalidDocblock( + 'Attribute since argument is not a valid version string', + new CodeLocation($statementsSource, $stmt) + ) + ); + } else { + if (!preg_match('/^[1-9][0-9]*(\.[0-9]+){0,3}$/', $arg->value->value)) { + IssueBuffer::maybeAdd( + new InvalidDocblock( + 'Attribute since argument is not a valid version string', + new CodeLocation($statementsSource, $stmt) + ) + ); + } + } + } + } + } } diff --git a/build/rector.php b/build/rector.php index b6e46c1e53a..246741bb34f 100644 --- a/build/rector.php +++ b/build/rector.php @@ -7,10 +7,14 @@ declare(strict_types=1); * SPDX-License-Identifier: AGPL-3.0-only */ +use Nextcloud\Rector\Set\NextcloudSets; use PhpParser\Node; use Rector\CodingStyle\Contract\ClassNameImport\ClassNameImportSkipVoterInterface; use Rector\Config\RectorConfig; use Rector\Php80\Rector\Class_\ClassPropertyAssignToConstructorPromotionRector; +use Rector\PHPUnit\AnnotationsToAttributes\Rector\ClassMethod\DataProviderAnnotationToAttributeRector; +use Rector\PHPUnit\CodeQuality\Rector\MethodCall\UseSpecificWillMethodRector; +use Rector\PHPUnit\PHPUnit100\Rector\Class_\StaticDataProviderClassMethodRector; use Rector\StaticTypeMapper\ValueObject\Type\FullyQualifiedObjectType; use Rector\ValueObject\Application\File; @@ -51,12 +55,21 @@ class NextcloudNamespaceSkipVoter implements ClassNameImportSkipVoterInterface { $config = RectorConfig::configure() ->withPaths([ $nextcloudDir . '/apps', + $nextcloudDir . '/core', + $nextcloudDir . '/ocs', + $nextcloudDir . '/ocs-provider', + $nextcloudDir . '/console.php', + $nextcloudDir . '/cron.php', + $nextcloudDir . '/index.php', + $nextcloudDir . '/occ', + $nextcloudDir . '/public.php', + $nextcloudDir . '/remote.php', + $nextcloudDir . '/status.php', + $nextcloudDir . '/version.php', + $nextcloudDir . '/lib/private/Share20/ProviderFactory.php', + $nextcloudDir . '/tests', // $nextcloudDir . '/config', - // $nextcloudDir . '/core', // $nextcloudDir . '/lib', - // $nextcloudDir . '/ocs', - // $nextcloudDir . '/ocs-provider', - // $nextcloudDir . '/tests', // $nextcloudDir . '/themes', ]) ->withSkip([ @@ -69,9 +82,17 @@ $config = RectorConfig::configure() // ->withPhpSets() ->withImportNames(importShortClasses:false) ->withTypeCoverageLevel(0) + ->withRules([ + UseSpecificWillMethodRector::class, + StaticDataProviderClassMethodRector::class, + DataProviderAnnotationToAttributeRector::class, + ]) ->withConfiguredRule(ClassPropertyAssignToConstructorPromotionRector::class, [ 'inline_public' => true, 'rename_property' => true, + ]) + ->withSets([ + NextcloudSets::NEXTCLOUD_25, ]); $config->registerService(NextcloudNamespaceSkipVoter::class, tag:ClassNameImportSkipVoterInterface::class); diff --git a/build/stubs/excimer.php b/build/stubs/excimer.php new file mode 100644 index 00000000000..e29eb2fd219 --- /dev/null +++ b/build/stubs/excimer.php @@ -0,0 +1,282 @@ +<?php + +/** Real (wall-clock) time */ +define('EXCIMER_REAL', 0); + +/** CPU time (user and system) consumed by the thread during execution */ +define('EXCIMER_CPU', 1); + +/** + * A sampling profiler. + * + * Collects a stack trace every time a timer event fires. + */ +class ExcimerProfiler { + /** + * Set the period. + * + * This will take effect the next time start() is called. + * + * If this method is not called, the default period of 0.1 seconds + * will be used. + * + * @param float $period The period in seconds + */ + public function setPeriod($period) { + } + + /** + * Set the event type. May be either EXCIMER_REAL, for real (wall-clock) + * time, or EXCIMER_CPU, for CPU time. The default is EXCIMER_REAL. + * + * This will take effect the next time start() is called. + * + * @param int $eventType + */ + public function setEventType($eventType) { + } + + /** + * Set the maximum depth of stack trace collection. If this depth is + * exceeded, the traversal up the stack will be terminated, so the function + * will appear to have no caller. + * + * By default, there is no limit. If this is called with a depth of zero, + * the limit is disabled. + * + * This will take effect immediately. + * + * @param int $maxDepth + */ + public function setMaxDepth($maxDepth) { + } + + /** + * Set a callback which will be called once the specified number of samples + * has been collected. + * + * When the ExcimerProfiler object is destroyed, the callback will also + * be called, unless no samples have been collected. + * + * The callback will be called with a single argument: the ExcimerLog + * object containing the samples. Before the callback is called, a new + * ExcimerLog object will be created and registered with the + * ExcimerProfiler. So ExcimerProfiler::getLog() should not be used from + * the callback, since it will not return the samples. + * + * @param callable $callback + * @param int $maxSamples + */ + public function setFlushCallback($callback, $maxSamples) { + } + + /** + * Clear the flush callback. No callback will be called regardless of + * how many samples are collected. + */ + public function clearFlushCallback() { + } + + /** + * Start the profiler. If the profiler was already running, it will be + * stopped and restarted with new options. + */ + public function start() { + } + + /** + * Stop the profiler. + */ + public function stop() { + } + + /** + * Get the current ExcimerLog object. + * + * Note that if the profiler is running, the object thus returned may be + * modified by a timer event at any time, potentially invalidating your + * analysis. Instead, the profiler should be stopped first, or flush() + * should be used. + * + * @return ExcimerLog + */ + public function getLog() { + } + + /** + * Create and register a new ExcimerLog object, and return the old + * ExcimerLog object. + * + * This will return all accumulated events to this point, and reset the + * log with a new log of zero length. + * + * @return ExcimerLog + */ + public function flush() { + } +} + +/** + * A collected series of stack traces and some utility methods to aggregate them. + * + * ExcimerLog acts as a container for ExcimerLogEntry objects. The Iterator or + * ArrayAccess interfaces may be used to access them. For example: + * + * foreach ( $profiler->getLog() as $entry ) { + * var_dump( $entry->getTrace() ); + * } + */ +class ExcimerLog implements ArrayAccess, Iterator { + /** + * ExcimerLog is not constructible by user code. Objects of this type + * are available via: + * - ExcimerProfiler::getLog() + * - ExcimerProfiler::flush() + * - The callback to ExcimerProfiler::setFlushCallback() + */ + final private function __construct() { + } + + /** + * Aggregate the stack traces and convert them to a line-based format + * understood by Brendan Gregg's FlameGraph utility. Each stack trace is + * represented as a series of function names, separated by semicolons. + * After this identifier, there is a single space character, then a number + * giving the number of times the stack appeared. Then there is a line + * break. This is repeated for each unique stack trace. + * + * @return string + */ + public function formatCollapsed() { + } + + /** + * Produce an array with an element for every function which appears in + * the log. The key is a human-readable unique identifier for the function, + * method or closure. The value is an associative array with the following + * elements: + * + * - self: The number of events in which the function itself was running, + * no other userspace function was being called. This includes time + * spent in internal functions that this function called. + * - inclusive: The number of events in which this function appeared + * somewhere in the stack. + * + * And optionally the following elements, if they are relevant: + * + * - file: The filename in which the function appears + * - line: The exact line number at which the first relevant event + * occurred. + * - class: The class name in which the method is defined + * - function: The name of the function or method + * - closure_line: The line number at which the closure was defined + * + * The event counts in the "self" and "inclusive" fields are adjusted for + * overruns. They represent an estimate of the number of profiling periods + * in which those functions were present. + * + * @return array + */ + public function aggregateByFunction() { + } + + /** + * Get an array which can be JSON encoded for import into speedscope + * + * @return array + */ + public function getSpeedscopeData() { + } + + /** + * Get the total number of profiling periods represented by this log. + * + * @return int + */ + public function getEventCount() { + } + + /** + * Get the current ExcimerLogEntry object. Part of the Iterator interface. + * + * @return ExcimerLogEntry|null + */ + public function current() { + } + + /** + * Get the current integer key or null. Part of the Iterator interface. + * + * @return int|null + */ + public function key() { + } + + /** + * Advance to the next log entry. Part of the Iterator interface. + */ + public function next() { + } + + /** + * Rewind back to the first log entry. Part of the Iterator interface. + */ + public function rewind() { + } + + /** + * Check if the current position is valid. Part of the Iterator interface. + * + * @return bool + */ + public function valid() { + } + + /** + * Get the number of log entries contained in this log. This is always less + * than or equal to the number returned by getEventCount(), which includes + * overruns. + * + * @return int + */ + public function count() { + } + + /** + * Determine whether a log entry exists at the specified array offset. + * Part of the ArrayAccess interface. + * + * @param int $offset + * @return bool + */ + public function offsetExists($offset) { + } + + /** + * Get the ExcimerLogEntry object at the specified array offset. + * + * @param int $offset + * @return ExcimerLogEntry|null + */ + public function offsetGet($offset) { + } + + /** + * This function is included for compliance with the ArrayAccess interface. + * It raises a warning and does nothing. + * + * @param int $offset + * @param mixed $value + */ + public function offsetSet($offset, $value) { + } + + /** + * This function is included for compliance with the ArrayAccess interface. + * It raises a warning and does nothing. + * + * @param int $offset + */ + public function offsetUnset($offset) { + } +} diff --git a/build/stubs/intl.php b/build/stubs/intl.php index bd7be7a74da..5ca558d049f 100644 --- a/build/stubs/intl.php +++ b/build/stubs/intl.php @@ -1,21 +1,27 @@ <?php +/** + * SPDX-FileCopyrightText: 2023 JetBrains s.r.o. + * SPDX-License-Identifier: Apache-2.0 + */ + // Start of intl v.1.1.0 -class Collator { - const DEFAULT_VALUE = -1; - const PRIMARY = 0; - const SECONDARY = 1; - const TERTIARY = 2; - const DEFAULT_STRENGTH = 2; - const QUATERNARY = 3; - const IDENTICAL = 15; - const OFF = 16; - const ON = 17; - const SHIFTED = 20; - const NON_IGNORABLE = 21; - const LOWER_FIRST = 24; - const UPPER_FIRST = 25; +class Collator +{ + public const DEFAULT_VALUE = -1; + public const PRIMARY = 0; + public const SECONDARY = 1; + public const TERTIARY = 2; + public const DEFAULT_STRENGTH = 2; + public const QUATERNARY = 3; + public const IDENTICAL = 15; + public const OFF = 16; + public const ON = 17; + public const SHIFTED = 20; + public const NON_IGNORABLE = 21; + public const LOWER_FIRST = 24; + public const UPPER_FIRST = 25; /** * <p> @@ -37,9 +43,9 @@ class Collator { * F=ON cote < côte < coté < côté * </p> * </p> - * @link https://php.net/manual/en/intl.collator-constants.php + * @link https://php.net/manual/en/class.collator.php#intl.collator-constants */ - const FRENCH_COLLATION = 0; + public const FRENCH_COLLATION = 0; /** * <p> @@ -82,9 +88,9 @@ class Collator { * S=4, A=S di Silva < diSilva < Di Silva < U.S.A. < USA * </p> * </p> - * @link https://php.net/manual/en/intl.collator-constants.php + * @link https://php.net/manual/en/class.collator.php#intl.collator-constants */ - const ALTERNATE_HANDLING = 1; + public const ALTERNATE_HANDLING = 1; /** * <p> @@ -116,9 +122,9 @@ class Collator { * C=U "China" < "china" < "Denmark" < "denmark" * </p> * </p> - * @link https://php.net/manual/en/intl.collator-constants.php + * @link https://php.net/manual/en/class.collator.php#intl.collator-constants */ - const CASE_FIRST = 2; + public const CASE_FIRST = 2; /** * <p> @@ -142,9 +148,9 @@ class Collator { * S=1, E=O role = rôle < Role * </p> * </p> - * @link https://php.net/manual/en/intl.collator-constants.php + * @link https://php.net/manual/en/class.collator.php#intl.collator-constants */ - const CASE_LEVEL = 3; + public const CASE_LEVEL = 3; /** * <p> @@ -168,9 +174,9 @@ class Collator { * <b>Collator::ON</b> * <b>Collator::DEFAULT_VALUE</b> * </p> - * @link https://php.net/manual/en/intl.collator-constants.php + * @link https://php.net/manual/en/class.collator.php#intl.collator-constants */ - const NORMALIZATION_MODE = 4; + public const NORMALIZATION_MODE = 4; /** * <p> @@ -186,14 +192,14 @@ class Collator { * Possible values are: * <b>Collator::PRIMARY</b> * <b>Collator::SECONDARY</b> - * <b>Collator::TERTIARY</b>(<default) + * <b>Collator::TERTIARY</b>(default) * <b>Collator::QUATERNARY</b> * <b>Collator::IDENTICAL</b> * <b>Collator::DEFAULT_VALUE</b> * </p> - * @link https://php.net/manual/en/intl.collator-constants.php + * @link https://php.net/manual/en/class.collator.php#intl.collator-constants */ - const STRENGTH = 5; + public const STRENGTH = 5; /** * <p> @@ -210,9 +216,9 @@ class Collator { * <b>Collator::ON</b> * <b>Collator::DEFAULT_VALUE</b> * </p> - * @link https://php.net/manual/en/intl.collator-constants.php + * @link https://php.net/manual/en/class.collator.php#intl.collator-constants */ - const HIRAGANA_QUATERNARY_MODE = 6; + public const HIRAGANA_QUATERNARY_MODE = 6; /** * <p> @@ -226,13 +232,12 @@ class Collator { * <b>Collator::ON</b> * <b>Collator::DEFAULT_VALUE</b> * </p> - * @link https://php.net/manual/en/intl.collator-constants.php + * @link https://php.net/manual/en/class.collator.php#intl.collator-constants */ - const NUMERIC_COLLATION = 7; - const SORT_REGULAR = 0; - const SORT_STRING = 1; - const SORT_NUMERIC = 2; - + public const NUMERIC_COLLATION = 7; + public const SORT_REGULAR = 0; + public const SORT_STRING = 1; + public const SORT_NUMERIC = 2; /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -240,7 +245,7 @@ class Collator { * @link https://php.net/manual/en/collator.construct.php * @param string $locale */ - public function __construct($locale) { } + public function __construct(string $locale) {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -252,22 +257,22 @@ class Collator { * default locale collation rules will be used. If empty string ("") or * "root" are passed, UCA rules will be used. * </p> - * @return Collator Return new instance of <b>Collator</b> object, or <b>NULL</b> + * @return Collator|null Return new instance of <b>Collator</b> object, or <b>NULL</b> * on error. */ - public static function create($locale) { } + public static function create(string $locale): ?Collator {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Compare two Unicode strings * @link https://php.net/manual/en/collator.compare.php - * @param string $str1 <p> + * @param string $string1 <p> * The first string to compare. * </p> - * @param string $str2 <p> + * @param string $string2 <p> * The second string to compare. * </p> - * @return int Return comparison result:</p> + * @return int|false Return comparison result:</p> * <p> * <p> * 1 if <i>str1</i> is greater than @@ -286,81 +291,93 @@ class Collator { * <b>FALSE</b> * is returned. */ - public function compare($str1, $str2) { } + public function compare( + string $string1, + string $string2 + ): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Sort array using specified collator * @link https://php.net/manual/en/collator.sort.php - * @param array $arr <p> + * @param string[] &$array <p> * Array of strings to sort. * </p> - * @param int $sort_flag [optional] <p> + * @param int $flags [optional] <p> * Optional sorting type, one of the following: * </p> * <p> - * <p> * <b>Collator::SORT_REGULAR</b> * - compare items normally (don't change types) * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ - public function sort(array &$arr, $sort_flag = null) { } + public function sort( + array &$array, + int $flags = 0 + ): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Sort array using specified collator and sort keys * @link https://php.net/manual/en/collator.sortwithsortkeys.php - * @param array $arr <p>Array of strings to sort</p> + * @param string[] &$array <p>Array of strings to sort</p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ - public function sortWithSortKeys(array &$arr) { } + public function sortWithSortKeys( + array &$array, + ): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Sort array maintaining index association * @link https://php.net/manual/en/collator.asort.php - * @param array $arr <p>Array of strings to sort.</p> - * @param int $sort_flag [optional] <p> + * @param string[] &$array <p>Array of strings to sort.</p> + * @param int $flags [optional] <p> * Optional sorting type, one of the following: - * <p> * <b>Collator::SORT_REGULAR</b> * - compare items normally (don't change types) * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ - public function asort(array &$arr, $sort_flag = null) { } + public function asort( + array &$array, + int $flags = 0 + ): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get collation attribute value * @link https://php.net/manual/en/collator.getattribute.php - * @param int $attr <p> + * @param int $attribute <p> * Attribute to get value for. * </p> * @return int|false Attribute value, or boolean <b>FALSE</b> on error. */ - public function getAttribute($attr) { } + public function getAttribute(int $attribute): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Set collation attribute * @link https://php.net/manual/en/collator.setattribute.php - * @param int $attr <p>Attribute.</p> - * @param int $val <p> + * @param int $attribute <p>Attribute.</p> + * @param int $value <p> * Attribute value. * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ - public function setAttribute($attr, $val) { } + public function setAttribute( + int $attribute, + int $value + ): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get current collation strength * @link https://php.net/manual/en/collator.getstrength.php - * @return int|false current collation strength, or boolean <b>FALSE</b> on error. + * @return int current collation strength, or boolean <b>FALSE</b> on error. */ - public function getStrength() { } + public function getStrength(): int {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -369,513 +386,538 @@ class Collator { * @param int $strength <p>Strength to set.</p> * <p> * Possible values are: - * <p> * <b>Collator::PRIMARY</b> * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ - public function setStrength($strength) { } + public function setStrength(int $strength): bool {} + + /** + * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> + * Get collator's last error code + * @link https://php.net/manual/en/collator.geterrorcode.php + * @return int|false Error code returned by the last Collator API function call. + */ + public function getErrorCode(): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the locale name of the collator * @link https://php.net/manual/en/collator.getlocale.php - * @param int $type [optional] <p> + * @param int $type <p> * You can choose between valid and actual locale ( * <b>Locale::VALID_LOCALE</b> and * <b>Locale::ACTUAL_LOCALE</b>, - * respectively). The default is the actual locale. + * respectively). * </p> - * @return string Real locale name from which the collation data comes. If the collator was + * @return string|false Real locale name from which the collation data comes. If the collator was * instantiated from rules or an error occurred, returns * boolean <b>FALSE</b>. */ - public function getLocale($type = null) { } - - /** - * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> - * Get collator's last error code - * @link https://php.net/manual/en/collator.geterrorcode.php - * @return int Error code returned by the last Collator API function call. - */ - public function getErrorCode() { } + public function getLocale( + int $type + ): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get text for collator's last error code * @link https://php.net/manual/en/collator.geterrormessage.php - * @return string Description of an error occurred in the last Collator API function call. + * @return string|false Description of an error occurred in the last Collator API function call. */ - public function getErrorMessage() { } + public function getErrorMessage(): string|false {} /** - * (No version information available, might only be in SVN)<br/> + * (PHP 5 >= 5.3.2, PECL intl >= 1.0.3)<br/> * Get sorting key for a string * @link https://php.net/manual/en/collator.getsortkey.php - * @param string $str <p> + * @param string $string <p> * The string to produce the key from. * </p> - * @return string the collation key for the string. Collation keys can be compared directly instead of strings. + * @return string|false the collation key for the string. Collation keys can be compared directly instead of strings. */ - public function getSortKey($str) { } + public function getSortKey( + string $string, + ): string|false {} } -class NumberFormatter { +class NumberFormatter +{ + public const CURRENCY_ACCOUNTING = 12; /** * Decimal format defined by pattern - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PATTERN_DECIMAL = 0; + public const PATTERN_DECIMAL = 0; /** * Decimal format - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const DECIMAL = 1; + public const DECIMAL = 1; /** * Currency format - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const CURRENCY = 2; + public const CURRENCY = 2; /** * Percent format - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PERCENT = 3; + public const PERCENT = 3; /** * Scientific format - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const SCIENTIFIC = 4; + public const SCIENTIFIC = 4; /** * Spellout rule-based format - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const SPELLOUT = 5; + public const SPELLOUT = 5; /** * Ordinal rule-based format - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const ORDINAL = 6; + public const ORDINAL = 6; /** * Duration rule-based format - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const DURATION = 7; + public const DURATION = 7; /** * Rule-based format defined by pattern - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.locale.php#intl.locale-constants */ - const PATTERN_RULEBASED = 9; + public const PATTERN_RULEBASED = 9; /** * Alias for PATTERN_DECIMAL - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const IGNORE = 0; + public const IGNORE = 0; /** * Default format for the locale - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const DEFAULT_STYLE = 1; + public const DEFAULT_STYLE = 1; /** * Rounding mode to round towards positive infinity. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const ROUND_CEILING = 0; + public const ROUND_CEILING = 0; /** * Rounding mode to round towards negative infinity. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const ROUND_FLOOR = 1; + public const ROUND_FLOOR = 1; /** * Rounding mode to round towards zero. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const ROUND_DOWN = 2; + public const ROUND_DOWN = 2; /** * Rounding mode to round away from zero. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const ROUND_UP = 3; + public const ROUND_UP = 3; /** * Rounding mode to round towards the "nearest neighbor" unless both * neighbors are equidistant, in which case, round towards the even * neighbor. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const ROUND_HALFEVEN = 4; + public const ROUND_HALFEVEN = 4; /** * Rounding mode to round towards "nearest neighbor" unless both neighbors * are equidistant, in which case round down. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const ROUND_HALFDOWN = 5; + public const ROUND_HALFDOWN = 5; /** * Rounding mode to round towards "nearest neighbor" unless both neighbors * are equidistant, in which case round up. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const ROUND_HALFUP = 6; + public const ROUND_HALFUP = 6; /** * Pad characters inserted before the prefix. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PAD_BEFORE_PREFIX = 0; + public const PAD_BEFORE_PREFIX = 0; /** * Pad characters inserted after the prefix. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PAD_AFTER_PREFIX = 1; + public const PAD_AFTER_PREFIX = 1; /** * Pad characters inserted before the suffix. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PAD_BEFORE_SUFFIX = 2; + public const PAD_BEFORE_SUFFIX = 2; /** * Pad characters inserted after the suffix. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PAD_AFTER_SUFFIX = 3; + public const PAD_AFTER_SUFFIX = 3; /** * Parse integers only. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PARSE_INT_ONLY = 0; + public const PARSE_INT_ONLY = 0; /** * Use grouping separator. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const GROUPING_USED = 1; + public const GROUPING_USED = 1; /** * Always show decimal point. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const DECIMAL_ALWAYS_SHOWN = 2; + public const DECIMAL_ALWAYS_SHOWN = 2; /** * Maximum integer digits. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const MAX_INTEGER_DIGITS = 3; + public const MAX_INTEGER_DIGITS = 3; /** * Minimum integer digits. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const MIN_INTEGER_DIGITS = 4; + public const MIN_INTEGER_DIGITS = 4; /** * Integer digits. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const INTEGER_DIGITS = 5; + public const INTEGER_DIGITS = 5; /** * Maximum fraction digits. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const MAX_FRACTION_DIGITS = 6; + public const MAX_FRACTION_DIGITS = 6; /** * Minimum fraction digits. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const MIN_FRACTION_DIGITS = 7; + public const MIN_FRACTION_DIGITS = 7; /** * Fraction digits. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const FRACTION_DIGITS = 8; + public const FRACTION_DIGITS = 8; /** * Multiplier. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const MULTIPLIER = 9; + public const MULTIPLIER = 9; /** * Grouping size. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const GROUPING_SIZE = 10; + public const GROUPING_SIZE = 10; /** * Rounding Mode. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const ROUNDING_MODE = 11; + public const ROUNDING_MODE = 11; /** * Rounding increment. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const ROUNDING_INCREMENT = 12; + public const ROUNDING_INCREMENT = 12; /** * The width to which the output of format() is padded. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const FORMAT_WIDTH = 13; + public const FORMAT_WIDTH = 13; /** * The position at which padding will take place. See pad position * constants for possible argument values. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PADDING_POSITION = 14; + public const PADDING_POSITION = 14; /** * Secondary grouping size. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const SECONDARY_GROUPING_SIZE = 15; + public const SECONDARY_GROUPING_SIZE = 15; /** * Use significant digits. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const SIGNIFICANT_DIGITS_USED = 16; + public const SIGNIFICANT_DIGITS_USED = 16; /** * Minimum significant digits. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const MIN_SIGNIFICANT_DIGITS = 17; + public const MIN_SIGNIFICANT_DIGITS = 17; /** * Maximum significant digits. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const MAX_SIGNIFICANT_DIGITS = 18; + public const MAX_SIGNIFICANT_DIGITS = 18; /** * Lenient parse mode used by rule-based formats. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const LENIENT_PARSE = 19; + public const LENIENT_PARSE = 19; /** * Positive prefix. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const POSITIVE_PREFIX = 0; + public const POSITIVE_PREFIX = 0; /** * Positive suffix. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const POSITIVE_SUFFIX = 1; + public const POSITIVE_SUFFIX = 1; /** * Negative prefix. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const NEGATIVE_PREFIX = 2; + public const NEGATIVE_PREFIX = 2; /** * Negative suffix. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const NEGATIVE_SUFFIX = 3; + public const NEGATIVE_SUFFIX = 3; /** * The character used to pad to the format width. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PADDING_CHARACTER = 4; + public const PADDING_CHARACTER = 4; /** * The ISO currency code. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const CURRENCY_CODE = 5; + public const CURRENCY_CODE = 5; /** * The default rule set. This is only available with rule-based * formatters. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const DEFAULT_RULESET = 6; + public const DEFAULT_RULESET = 6; /** * The public rule sets. This is only available with rule-based * formatters. This is a read-only attribute. The public rulesets are * returned as a single string, with each ruleset name delimited by ';' * (semicolon). - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PUBLIC_RULESETS = 7; + public const PUBLIC_RULESETS = 7; /** * The decimal separator. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const DECIMAL_SEPARATOR_SYMBOL = 0; + public const DECIMAL_SEPARATOR_SYMBOL = 0; /** * The grouping separator. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const GROUPING_SEPARATOR_SYMBOL = 1; + public const GROUPING_SEPARATOR_SYMBOL = 1; /** * The pattern separator. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PATTERN_SEPARATOR_SYMBOL = 2; + public const PATTERN_SEPARATOR_SYMBOL = 2; /** * The percent sign. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PERCENT_SYMBOL = 3; + public const PERCENT_SYMBOL = 3; /** * Zero. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const ZERO_DIGIT_SYMBOL = 4; + public const ZERO_DIGIT_SYMBOL = 4; /** * Character representing a digit in the pattern. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const DIGIT_SYMBOL = 5; + public const DIGIT_SYMBOL = 5; /** * The minus sign. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const MINUS_SIGN_SYMBOL = 6; + public const MINUS_SIGN_SYMBOL = 6; /** * The plus sign. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PLUS_SIGN_SYMBOL = 7; + public const PLUS_SIGN_SYMBOL = 7; /** * The currency symbol. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const CURRENCY_SYMBOL = 8; + public const CURRENCY_SYMBOL = 8; /** * The international currency symbol. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const INTL_CURRENCY_SYMBOL = 9; + public const INTL_CURRENCY_SYMBOL = 9; /** * The monetary separator. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const MONETARY_SEPARATOR_SYMBOL = 10; + public const MONETARY_SEPARATOR_SYMBOL = 10; /** * The exponential symbol. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const EXPONENTIAL_SYMBOL = 11; + public const EXPONENTIAL_SYMBOL = 11; /** * Per mill symbol. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PERMILL_SYMBOL = 12; + public const PERMILL_SYMBOL = 12; /** * Escape padding character. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PAD_ESCAPE_SYMBOL = 13; + public const PAD_ESCAPE_SYMBOL = 13; /** * Infinity symbol. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const INFINITY_SYMBOL = 14; + public const INFINITY_SYMBOL = 14; /** * Not-a-number symbol. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const NAN_SYMBOL = 15; + public const NAN_SYMBOL = 15; /** * Significant digit symbol. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const SIGNIFICANT_DIGIT_SYMBOL = 16; + public const SIGNIFICANT_DIGIT_SYMBOL = 16; /** * The monetary grouping separator. - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const MONETARY_GROUPING_SEPARATOR_SYMBOL = 17; + public const MONETARY_GROUPING_SEPARATOR_SYMBOL = 17; /** * Derive the type from variable type - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const TYPE_DEFAULT = 0; + public const TYPE_DEFAULT = 0; /** * Format/parse as 32-bit integer - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const TYPE_INT32 = 1; + public const TYPE_INT32 = 1; /** * Format/parse as 64-bit integer - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const TYPE_INT64 = 2; + public const TYPE_INT64 = 2; /** * Format/parse as floating point value - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const TYPE_DOUBLE = 3; + public const TYPE_DOUBLE = 3; /** * Format/parse as currency value - * @link https://php.net/manual/en/intl.numberformatter-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants + * @deprecated 8.3 + */ + public const TYPE_CURRENCY = 4; + + /** + * @since 8.4 */ - const TYPE_CURRENCY = 4; + public const ROUND_TOWARD_ZERO = 2; + /** + * @since 8.4 + */ + public const ROUND_AWAY_FROM_ZERO = 3; /** - * @param $locale - * @param $style - * @param $pattern [optional] + * @since 8.4 + */ + public const ROUND_HALFODD = 8; + + /** + * @link https://www.php.net/manual/en/class.numberformatter.php + * @param string $locale + * @param int $style + * @param string $pattern [optional] */ - public function __construct($locale, $style, $pattern = null) { } + public function __construct( + string $locale, + int $style, + string|null $pattern = null + ) {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -901,13 +943,17 @@ class NumberFormatter { * </p> * @return NumberFormatter|false <b>NumberFormatter</b> object or <b>FALSE</b> on error. */ - public static function create($locale, $style, $pattern = null) { } + public static function create( + string $locale, + int $style, + string|null $pattern = null + ): ?NumberFormatter {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Format a number * @link https://php.net/manual/en/numberformatter.format.php - * @param int|float $value <p> + * @param int|float $num <p> * The value to format. Can be integer or float, * other values will be converted to a numeric value. * </p> @@ -917,62 +963,72 @@ class NumberFormatter { * </p> * @return string|false the string containing formatted value, or <b>FALSE</b> on error. */ - public function format($value, $type = null) { } + public function format( + int|float $num, + int $type = 0 + ): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Parse a number * @link https://php.net/manual/en/numberformatter.parse.php - * @param string $value + * @param string $string * @param int $type [optional] <p> * The * formatting type to use. By default, * <b>NumberFormatter::TYPE_DOUBLE</b> is used. * </p> - * @param int $position [optional] <p> + * @param int &$offset [optional] <p> * Offset in the string at which to begin parsing. On return, this value * will hold the offset at which parsing ended. * </p> * @return mixed The value of the parsed number or <b>FALSE</b> on error. */ - public function parse($value, $type = null, &$position = null) { } + public function parse( + string $string, + int $type = NumberFormatter::TYPE_DOUBLE, + &$offset = null + ): int|float|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Format a currency value * @link https://php.net/manual/en/numberformatter.formatcurrency.php - * @param float $value <p> + * @param float $amount <p> * The numeric currency value. * </p> * @param string $currency <p> * The 3-letter ISO 4217 currency code indicating the currency to use. * </p> - * @return string String representing the formatted currency value. + * @return string|false String representing the formatted currency value. */ - public function formatCurrency($value, $currency) { } + public function formatCurrency( + float $amount, + string $currency + ): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Parse a currency number * @link https://php.net/manual/en/numberformatter.parsecurrency.php - * @param string $value - * @param string $currency <p> + * @param string $string + * @param string &$currency <p> * Parameter to receive the currency name (3-letter ISO 4217 currency * code). * </p> - * @param int $position [optional] <p> + * @param int &$offset [optional] <p> * Offset in the string at which to begin parsing. On return, this value * will hold the offset at which parsing ended. * </p> * @return float|false The parsed numeric value or <b>FALSE</b> on error. */ - public function parseCurrency($value, &$currency, &$position = null) { } + public function parseCurrency(string $string, &$currency, &$offset = null): float|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Set an attribute * @link https://php.net/manual/en/numberformatter.setattribute.php - * @param int $attr <p> + * @param int $attribute <p> * Attribute specifier - one of the * numeric attribute constants. * </p> @@ -981,25 +1037,28 @@ class NumberFormatter { * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ - public function setAttribute($attr, $value) { } + public function setAttribute( + int $attribute, + int|float $value + ): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get an attribute * @link https://php.net/manual/en/numberformatter.getattribute.php - * @param int $attr <p> + * @param int $attribute <p> * Attribute specifier - one of the * numeric attribute constants. * </p> - * @return int|false Return attribute value on success, or <b>FALSE</b> on error. + * @return int|float|false Return attribute value on success, or <b>FALSE</b> on error. */ - public function getAttribute($attr) { } + public function getAttribute(int $attribute): int|float|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Set a text attribute * @link https://php.net/manual/en/numberformatter.settextattribute.php - * @param int $attr <p> + * @param int $attribute <p> * Attribute specifier - one of the * text attribute * constants. @@ -1009,25 +1068,28 @@ class NumberFormatter { * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ - public function setTextAttribute($attr, $value) { } + public function setTextAttribute( + int $attribute, + string $value + ): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get a text attribute * @link https://php.net/manual/en/numberformatter.gettextattribute.php - * @param int $attr <p> + * @param int $attribute <p> * Attribute specifier - one of the * text attribute constants. * </p> * @return string|false Return attribute value on success, or <b>FALSE</b> on error. */ - public function getTextAttribute($attr) { } + public function getTextAttribute(int $attribute): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Set a symbol value * @link https://php.net/manual/en/numberformatter.setsymbol.php - * @param int $attr <p> + * @param int $symbol <p> * Symbol specifier, one of the * format symbol constants. * </p> @@ -1036,19 +1098,22 @@ class NumberFormatter { * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ - public function setSymbol($attr, $value) { } + public function setSymbol( + int $symbol, + string $value + ): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get a symbol value * @link https://php.net/manual/en/numberformatter.getsymbol.php - * @param int $attr <p> + * @param int $symbol <p> * Symbol specifier, one of the * format symbol constants. * </p> * @return string|false The symbol string or <b>FALSE</b> on error. */ - public function getSymbol($attr) { } + public function getSymbol(int $symbol): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1061,7 +1126,7 @@ class NumberFormatter { * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ - public function setPattern($pattern) { } + public function setPattern(string $pattern): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1069,7 +1134,7 @@ class NumberFormatter { * @link https://php.net/manual/en/numberformatter.getpattern.php * @return string|false Pattern string that is used by the formatter, or <b>FALSE</b> if an error happens. */ - public function getPattern() { } + public function getPattern(): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1081,9 +1146,11 @@ class NumberFormatter { * <b>Locale::ACTUAL_LOCALE</b>, * respectively). The default is the actual locale. * </p> - * @return string The locale name used to create the formatter. + * @return string|false The locale name used to create the formatter. */ - public function getLocale($type = null) { } + public function getLocale( + int $type = 0 + ): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1091,7 +1158,7 @@ class NumberFormatter { * @link https://php.net/manual/en/numberformatter.geterrorcode.php * @return int error code from last formatter call. */ - public function getErrorCode() { } + public function getErrorCode(): int {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1099,142 +1166,155 @@ class NumberFormatter { * @link https://php.net/manual/en/numberformatter.geterrormessage.php * @return string error message from last formatter call. */ - public function getErrorMessage() { } + public function getErrorMessage(): string {} } -class Normalizer { +class Normalizer +{ + public const NFKC_CF = 48; + public const FORM_KC_CF = 48; /** * Default normalization options - * @link https://www.php.net/manual/en/class.normalizer.php - */ - const OPTION_DEFAULT = ""; - - /** - * No decomposition/composition - * @link https://www.php.net/manual/en/class.normalizer.php - * @removed 8.0 + * @link https://secure.php.net/manual/en/class.normalizer.php */ - const NONE = "1"; + public const OPTION_DEFAULT = ""; /** * Normalization Form D (NFD) - Canonical Decomposition - * @link https://www.php.net/manual/en/class.normalizer.php + * @link https://secure.php.net/manual/en/class.normalizer.php */ - const FORM_D = "2"; - const NFD = 2; + public const FORM_D = 4; + public const NFD = 4; /** * Normalization Form KD (NFKD) - Compatibility Decomposition - * @link https://www.php.net/manual/en/class.normalizer.php + * @link https://secure.php.net/manual/en/class.normalizer.php */ - const FORM_KD = "3"; - const NFKD = 3; + public const FORM_KD = 8; + public const NFKD = 8; /** * Normalization Form C (NFC) - Canonical Decomposition followed by * Canonical Composition - * @link https://www.php.net/manual/en/class.normalizer.php + * @link https://secure.php.net/manual/en/class.normalizer.php */ - const FORM_C = "4"; - const NFC = 4; + public const FORM_C = 16; + public const NFC = 16; /** * Normalization Form KC (NFKC) - Compatibility Decomposition, followed by * Canonical Composition - * @link https://www.php.net/manual/en/class.normalizer.php + * @link https://secure.php.net/manual/en/class.normalizer.php */ - const FORM_KC = "5"; - const NFKC = 5; - + public const FORM_KC = 32; + public const NFKC = 32; /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Normalizes the input provided and returns the normalized string * @link https://php.net/manual/en/normalizer.normalize.php - * @param string $input <p>The input string to normalize</p> - * @param string $form [optional] <p>One of the normalization forms.</p> - * @return string The normalized string or <b>NULL</b> if an error occurred. + * @param string $string <p>The input string to normalize</p> + * @param int $form <p>One of the normalization forms.</p> + * @return string|false The normalized string or <b>FALSE</b> if an error occurred. */ - public static function normalize($input, $form = Normalizer::FORM_C) { } + public static function normalize( + string $string, + int $form = Normalizer::FORM_C, + ): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Checks if the provided string is already in the specified normalization form. * @link https://php.net/manual/en/normalizer.isnormalized.php - * @param string $input <p>The input string to normalize</p> - * @param string $form [optional] <p> + * @param string $string <p>The input string to normalize</p> + * @param int $form <p> * One of the normalization forms. * </p> * @return bool <b>TRUE</b> if normalized, <b>FALSE</b> otherwise or if there an error */ - public static function isNormalized($input, $form = Normalizer::FORM_C) { } -} + public static function isNormalized( + string $string, + int $form = Normalizer::FORM_C, + ): bool {} -class Locale { + /** + * @param string $string <p>The input string to normalize</p> + * @param int $form + * @return string|null <p>Returns a string containing the Decomposition_Mapping property, if present in the UCD. + * Returns null if there is no Decomposition_Mapping property for the character.</p> + * @link https://www.php.net/manual/en/normalizer.getrawdecomposition.php + * @since 7.3 + */ + public static function getRawDecomposition( + string $string, + int $form = 16 + ): ?string {} +} +class Locale +{ /** * This is locale the data actually comes from. - * @link https://php.net/manual/en/intl.locale-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const ACTUAL_LOCALE = 0; + public const ACTUAL_LOCALE = 0; /** * This is the most specific locale supported by ICU. - * @link https://php.net/manual/en/intl.locale-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const VALID_LOCALE = 1; + public const VALID_LOCALE = 1; /** * Used as locale parameter with the methods of the various locale affected classes, * such as NumberFormatter. This constant would make the methods to use default * locale. - * @link https://php.net/manual/en/intl.locale-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const DEFAULT_LOCALE = null; + public const DEFAULT_LOCALE = null; /** * Language subtag - * @link https://php.net/manual/en/intl.locale-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const LANG_TAG = "language"; + public const LANG_TAG = "language"; /** * Extended language subtag - * @link https://php.net/manual/en/intl.locale-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const EXTLANG_TAG = "extlang"; + public const EXTLANG_TAG = "extlang"; /** * Script subtag - * @link https://php.net/manual/en/intl.locale-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const SCRIPT_TAG = "script"; + public const SCRIPT_TAG = "script"; /** * Region subtag - * @link https://php.net/manual/en/intl.locale-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const REGION_TAG = "region"; + public const REGION_TAG = "region"; /** * Variant subtag - * @link https://php.net/manual/en/intl.locale-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const VARIANT_TAG = "variant"; + public const VARIANT_TAG = "variant"; /** * Grandfathered Language subtag - * @link https://php.net/manual/en/intl.locale-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const GRANDFATHERED_LANG_TAG = "grandfathered"; + public const GRANDFATHERED_LANG_TAG = "grandfathered"; /** * Private subtag - * @link https://php.net/manual/en/intl.locale-constants.php + * @link https://php.net/manual/en/class.numberformatter.php#intl.numberformatter-constants */ - const PRIVATE_TAG = "private"; - + public const PRIVATE_TAG = "private"; /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1242,7 +1322,7 @@ class Locale { * @link https://php.net/manual/en/locale.getdefault.php * @return string The current runtime locale */ - public static function getDefault() { } + public static function getDefault(): string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1253,7 +1333,7 @@ class Locale { * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ - public static function setDefault($locale) { } + public static function setDefault(string $locale): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1262,9 +1342,9 @@ class Locale { * @param string $locale <p> * The locale to extract the primary language code from * </p> - * @return string The language code associated with the language or <b>NULL</b> in case of error. + * @return string|null The language code associated with the language or <b>NULL</b> in case of error. */ - public static function getPrimaryLanguage($locale) { } + public static function getPrimaryLanguage(string $locale): ?string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1273,9 +1353,9 @@ class Locale { * @param string $locale <p> * The locale to extract the script code from * </p> - * @return string The script subtag for the locale or <b>NULL</b> if not present + * @return string|null The script subtag for the locale or <b>NULL</b> if not present */ - public static function getScript($locale) { } + public static function getScript(string $locale): ?string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1284,9 +1364,9 @@ class Locale { * @param string $locale <p> * The locale to extract the region code from * </p> - * @return string The region subtag for the locale or <b>NULL</b> if not present + * @return string|null The region subtag for the locale or <b>NULL</b> if not present */ - public static function getRegion($locale) { } + public static function getRegion(string $locale): ?string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1295,9 +1375,9 @@ class Locale { * @param string $locale <p> * The locale to extract the keywords from * </p> - * @return array Associative array containing the keyword-value pairs for this locale + * @return array|false|null Associative array containing the keyword-value pairs for this locale */ - public static function getKeywords($locale) { } + public static function getKeywords(string $locale): array|false|null {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1306,13 +1386,16 @@ class Locale { * @param string $locale <p> * The locale to return a display script for * </p> - * @param string $in_locale [optional] <p> + * @param string $displayLocale <p> * Optional format locale to use to display the script name * </p> - * @return string Display name of the script for the $locale in the format appropriate for + * @return string|false Display name of the script for the $locale in the format appropriate for * $in_locale. */ - public static function getDisplayScript($locale, $in_locale = null) { } + public static function getDisplayScript( + string $locale, + string|null $displayLocale = null + ): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1321,13 +1404,16 @@ class Locale { * @param string $locale <p> * The locale to return a display region for. * </p> - * @param string $in_locale [optional] <p> + * @param string $displayLocale <p> * Optional format locale to use to display the region name * </p> - * @return string display name of the region for the $locale in the format appropriate for + * @return string|false display name of the region for the $locale in the format appropriate for * $in_locale. */ - public static function getDisplayRegion($locale, $in_locale = null) { } + public static function getDisplayRegion( + string $locale, + string|null $displayLocale = null + ): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1336,10 +1422,13 @@ class Locale { * @param string $locale <p> * The locale to return a display name for. * </p> - * @param string $in_locale [optional] <p>optional format locale</p> - * @return string Display name of the locale in the format appropriate for $in_locale. + * @param string $displayLocale <p>optional format locale</p> + * @return string|false Display name of the locale in the format appropriate for $in_locale. */ - public static function getDisplayName($locale, $in_locale = null) { } + public static function getDisplayName( + string $locale, + string|null $displayLocale = null + ): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1348,13 +1437,16 @@ class Locale { * @param string $locale <p> * The locale to return a display language for * </p> - * @param string $in_locale [optional] <p> + * @param string $displayLocale <p> * Optional format locale to use to display the language name * </p> - * @return string display name of the language for the $locale in the format appropriate for + * @return string|false display name of the language for the $locale in the format appropriate for * $in_locale. */ - public static function getDisplayLanguage($locale, $in_locale = null) { } + public static function getDisplayLanguage( + string $locale, + string|null $displayLocale = null + ): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1363,13 +1455,16 @@ class Locale { * @param string $locale <p> * The locale to return a display variant for * </p> - * @param string $in_locale [optional] <p> + * @param string $displayLocale <p> * Optional format locale to use to display the variant name * </p> - * @return string Display name of the variant for the $locale in the format appropriate for + * @return string|false Display name of the variant for the $locale in the format appropriate for * $in_locale. */ - public static function getDisplayVariant($locale, $in_locale = null) { } + public static function getDisplayVariant( + string $locale, + string|null $displayLocale = null + ): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1393,9 +1488,9 @@ class Locale { * (e.g. 'variant0', 'variant1', etc.). * </p> * </p> - * @return string The corresponding locale identifier. + * @return string|false The corresponding locale identifier. */ - public static function composeLocale(array $subtags) { } + public static function composeLocale(array $subtags): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1406,14 +1501,14 @@ class Locale { * 'private' subtags can take maximum 15 values whereas 'extlang' can take * maximum 3 values. * </p> - * @return array an array containing a list of key-value pairs, where the keys + * @return array|null an array containing a list of key-value pairs, where the keys * identify the particular locale ID subtags, and the values are the * associated subtag values. The array will be ordered as the locale id * subtags e.g. in the locale id if variants are '-varX-varY-varZ' then the * returned array will have variant0=>varX , variant1=>varY , * variant2=>varZ */ - public static function parseLocale($locale) { } + public static function parseLocale(string $locale): ?array {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1422,57 +1517,66 @@ class Locale { * @param string $locale <p> * The locale to extract the variants from * </p> - * @return array The array containing the list of all variants subtag for the locale + * @return array|null The array containing the list of all variants subtag for the locale * or <b>NULL</b> if not present */ - public static function getAllVariants($locale) { } + public static function getAllVariants(string $locale): ?array {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Checks if a language tag filter matches with locale * @link https://php.net/manual/en/locale.filtermatches.php - * @param string $langtag <p> + * @param string $languageTag <p> * The language tag to check * </p> * @param string $locale <p> * The language range to check against * </p> - * @param bool $canonicalize [optional] <p> + * @param bool $canonicalize <p> * If true, the arguments will be converted to canonical form before * matching. * </p> - * @return bool <b>TRUE</b> if $locale matches $langtag <b>FALSE</b> otherwise. + * @return bool|null <b>TRUE</b> if $locale matches $langtag <b>FALSE</b> otherwise. */ - public static function filterMatches($langtag, $locale, $canonicalize = false) { } + public static function filterMatches( + string $languageTag, + string $locale, + bool $canonicalize = false + ): ?bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Searches the language tag list for the best match to the language * @link https://php.net/manual/en/locale.lookup.php - * @param array $langtag <p> + * @param array $languageTag <p> * An array containing a list of language tags to compare to * <i>locale</i>. Maximum 100 items allowed. * </p> * @param string $locale <p> * The locale to use as the language range when matching. * </p> - * @param bool $canonicalize [optional] <p> + * @param bool $canonicalize <p> * If true, the arguments will be converted to canonical form before * matching. * </p> - * @param string $default [optional] <p> + * @param string $defaultLocale <p> * The locale to use if no match is found. * </p> - * @return string The closest matching language tag or default value. + * @return string|null The closest matching language tag or default value. */ - public static function lookup(array $langtag, $locale, $canonicalize = false, $default = null) { } + public static function lookup( + array $languageTag, + string $locale, + bool $canonicalize = false, + string|null $defaultLocale = null + ): ?string {} /** * @link https://php.net/manual/en/locale.canonicalize.php * @param string $locale - * @return string + * @return string|null */ - public static function canonicalize($locale) { } + public static function canonicalize(string $locale): ?string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1481,13 +1585,13 @@ class Locale { * @param string $header <p> * The string containing the "Accept-Language" header according to format in RFC 2616. * </p> - * @return string The corresponding locale identifier. + * @return string|false The corresponding locale identifier. */ - public static function acceptFromHttp($header) { } + public static function acceptFromHttp(string $header): string|false {} } -class MessageFormatter { - +class MessageFormatter +{ /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Constructs a new Message Formatter @@ -1501,8 +1605,12 @@ class MessageFormatter { * umsg_autoQuoteApostrophe * before being interpreted. * </p> + * @throws IntlException on failure. */ - public function __construct($locale, $pattern) { } + public function __construct( + string $locale, + string $pattern + ) {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1517,20 +1625,23 @@ class MessageFormatter { * umsg_autoQuoteApostrophe * before being interpreted. * </p> - * @return MessageFormatter The formatter object + * @return MessageFormatter|null The formatter object */ - public static function create($locale, $pattern) { } + public static function create( + string $locale, + string $pattern + ): ?MessageFormatter {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Format the message * @link https://php.net/manual/en/messageformatter.format.php - * @param array $args <p> + * @param array $values <p> * Arguments to insert into the format string * </p> * @return string|false The formatted string, or <b>FALSE</b> if an error occurred */ - public function format(array $args) { } + public function format(array $values): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1545,23 +1656,27 @@ class MessageFormatter { * umsg_autoQuoteApostrophe * before being interpreted. * </p> - * @param array $args <p> + * @param array $values <p> * The array of values to insert into the format string * </p> * @return string|false The formatted pattern string or <b>FALSE</b> if an error occurred */ - public static function formatMessage($locale, $pattern, array $args) { } + public static function formatMessage( + string $locale, + string $pattern, + array $values + ): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Parse input string according to pattern * @link https://php.net/manual/en/messageformatter.parse.php - * @param string $value <p> + * @param string $string <p> * The string to parse * </p> * @return array|false An array containing the items extracted, or <b>FALSE</b> on error */ - public function parse($value) { } + public function parse(string $string): array|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1573,12 +1688,16 @@ class MessageFormatter { * @param string $pattern <p> * The pattern with which to parse the <i>value</i>. * </p> - * @param string $source <p> + * @param string $message <p> * The string to parse, conforming to the <i>pattern</i>. * </p> * @return array|false An array containing items extracted, or <b>FALSE</b> on error */ - public static function parseMessage($locale, $pattern, $source) { } + public static function parseMessage( + string $locale, + string $pattern, + string $message + ): array|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1592,15 +1711,15 @@ class MessageFormatter { * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ - public function setPattern($pattern) { } + public function setPattern(string $pattern): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the pattern used by the formatter * @link https://php.net/manual/en/messageformatter.getpattern.php - * @return string The pattern string for this message formatter + * @return string|false The pattern string for this message formatter */ - public function getPattern() { } + public function getPattern(): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1608,7 +1727,7 @@ class MessageFormatter { * @link https://php.net/manual/en/messageformatter.getlocale.php * @return string The locale name */ - public function getLocale() { } + public function getLocale(): string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1616,7 +1735,7 @@ class MessageFormatter { * @link https://php.net/manual/en/messageformatter.geterrorcode.php * @return int The error code, one of UErrorCode values. Initial value is U_ZERO_ERROR. */ - public function getErrorCode() { } + public function getErrorCode(): int {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1624,68 +1743,74 @@ class MessageFormatter { * @link https://php.net/manual/en/messageformatter.geterrormessage.php * @return string Description of the last error. */ - public function getErrorMessage() { } + public function getErrorMessage(): string {} } -class IntlDateFormatter { - +class IntlDateFormatter +{ /** * Completely specified style (Tuesday, April 12, 1952 AD or 3:30:42pm PST) * @link https://php.net/manual/en/class.intldateformatter.php#intl.intldateformatter-constants */ - const FULL = 0; + public const FULL = 0; /** * Long style (January 12, 1952 or 3:30:32pm) * @link https://php.net/manual/en/class.intldateformatter.php#intl.intldateformatter-constants */ - const LONG = 1; + public const LONG = 1; /** * Medium style (Jan 12, 1952) * @link https://php.net/manual/en/class.intldateformatter.php#intl.intldateformatter-constants */ - const MEDIUM = 2; + public const MEDIUM = 2; /** * Most abbreviated style, only essential data (12/13/52 or 3:30pm) * @link https://php.net/manual/en/class.intldateformatter.php#intl.intldateformatter-constants */ - const SHORT = 3; + public const SHORT = 3; /** * Do not include this element * @link https://php.net/manual/en/class.intldateformatter.php#intl.intldateformatter-constants */ - const NONE = -1; + public const NONE = -1; /** * Gregorian Calendar * @link https://php.net/manual/en/class.intldateformatter.php#intl.intldateformatter-constants */ - const GREGORIAN = 1; + public const GREGORIAN = 1; /** * Non-Gregorian Calendar * @link https://php.net/manual/en/class.intldateformatter.php#intl.intldateformatter-constants */ - const TRADITIONAL = 0; - - const RELATIVE_FULL = 0; - const RELATIVE_LONG = 1; - const RELATIVE_MEDIUM = 2; - const RELATIVE_SHORT = 3; - + public const TRADITIONAL = 0; + public const RELATIVE_FULL = 128; + public const RELATIVE_LONG = 129; + public const RELATIVE_MEDIUM = 130; + public const RELATIVE_SHORT = 131; + public const PATTERN = -2; /** * @param string|null $locale - * @param int $datetype - * @param int $timetype + * @param int $dateType + * @param int $timeType * @param mixed|null $timezone [optional] * @param mixed|null $calendar [optional] * @param string $pattern [optional] */ - public function __construct($locale, $datetype, $timetype, $timezone = null, $calendar = null, $pattern = '') { } + public function __construct( + string|null $locale, + int $dateType = 0, + int $timeType = 0, + $timezone = null, + $calendar = null, + string|null $pattern = null + ) {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1694,14 +1819,14 @@ class IntlDateFormatter { * @param string $locale <p> * Locale to use when formatting or parsing; default is specified in the ini setting intl.default_locale. * </p> - * @param int $datetype <p> + * @param int $dateType <p> * Date type to use (<b>none</b>, * <b>short</b>, <b>medium</b>, * <b>long</b>, <b>full</b>). * This is one of the * IntlDateFormatter constants. * </p> - * @param int $timetype <p> + * @param int $timeType <p> * Time type to use (<b>none</b>, * <b>short</b>, <b>medium</b>, * <b>long</b>, <b>full</b>). @@ -1720,123 +1845,116 @@ class IntlDateFormatter { * Optional pattern to use when formatting or parsing. * Possible patterns are documented at http://userguide.icu-project.org/formatparse/datetime. * </p> - * @return IntlDateFormatter + * @return IntlDateFormatter|null */ - public static function create($locale, $datetype, $timetype, $timezone = null, $calendar = null, $pattern = '') { } + public static function create( + string|null $locale, + int $dateType = 0, + int $timeType = 0, + $timezone = null, + IntlCalendar|int|null $calendar = null, + string|null $pattern = null + ): ?IntlDateFormatter {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the datetype used for the IntlDateFormatter * @link https://php.net/manual/en/intldateformatter.getdatetype.php - * @return int The current date type value of the formatter. + * @return int|false The current date type value of the formatter. */ - public function getDateType() { } + public function getDateType(): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the timetype used for the IntlDateFormatter * @link https://php.net/manual/en/intldateformatter.gettimetype.php - * @return int The current date type value of the formatter. + * @return int|false The current date type value of the formatter. */ - public function getTimeType() { } + public function getTimeType(): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the calendar used for the IntlDateFormatter * @link https://php.net/manual/en/intldateformatter.getcalendar.php - * @return int The calendar being used by the formatter. + * @return int|false The calendar being used by the formatter. */ - public function getCalendar() { } + public function getCalendar(): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * sets the calendar used to the appropriate calendar, which must be * @link https://php.net/manual/en/intldateformatter.setcalendar.php - * @param int $which <p> + * @param int $calendar <p> * The calendar to use. * Default is <b>IntlDateFormatter::GREGORIAN</b>. * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ - public function setCalendar($which) { } + public function setCalendar(IntlCalendar|int|null $calendar): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the timezone-id used for the IntlDateFormatter * @link https://php.net/manual/en/intldateformatter.gettimezoneid.php - * @return string ID string for the time zone used by this formatter. + * @return string|false ID string for the time zone used by this formatter. */ - public function getTimeZoneId() { } + public function getTimeZoneId(): string|false {} /** * (PHP 5 >= 5.5.0, PECL intl >= 3.0.0)<br/> * Get copy of formatter's calendar object - * @link https://www.php.net/manual/en/intldateformatter.getcalendarobject.php - * @return IntlCalendar A copy of the internal calendar object used by this formatter. + * @link https://secure.php.net/manual/en/intldateformatter.getcalendarobject.php + * @return IntlCalendar|false|null A copy of the internal calendar object used by this formatter. */ - public function getCalendarObject() { } + public function getCalendarObject(): IntlCalendar|false|null {} /** * (PHP 5 >= 5.5.0, PECL intl >= 3.0.0)<br/> * Get formatter's timezone - * @link https://www.php.net/manual/en/intldateformatter.gettimezone.php + * @link https://secure.php.net/manual/en/intldateformatter.gettimezone.php * @return IntlTimeZone|false The associated IntlTimeZone object or FALSE on failure. */ - public function getTimeZone() { } - - /** - * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> - * Sets the time zone to use - * @link https://php.net/manual/en/intldateformatter.settimezoneid.php - * @param string $zone <p> - * The time zone ID string of the time zone to use. - * If <b>NULL</b> or the empty string, the default time zone for the runtime is used. - * </p> - * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. - * @deprecated 5.5 https://www.php.net/manual/en/migration55.deprecated.php - * @removed 7.0 - */ - public function setTimeZoneId($zone) { } + public function getTimeZone(): IntlTimeZone|false {} /** * (PHP 5 >= 5.5.0, PECL intl >= 3.0.0)<br/> * Sets formatter's timezone * @link https://php.net/manual/en/intldateformatter.settimezone.php - * @param mixed $zone <p> + * @param mixed $timezone <p> * The timezone to use for this formatter. This can be specified in the * following forms: * <ul> * <li> * <p> * <b>NULL</b>, in which case the default timezone will be used, as specified in - * the ini setting {@link "https://www.php.net/manual/en/datetime.configuration.php#ini.date.timezone" date.timezone} or - * through the function {@link "https://www.php.net/manual/en/function.date-default-timezone-set.php" date_default_timezone_set()} and as - * returned by {@link "https://www.php.net/manual/en/function.date-default-timezone-get.php" date_default_timezone_get()}. + * the ini setting {@link "https://secure.php.net/manual/en/datetime.configuration.php#ini.date.timezone" date.timezone} or + * through the function {@link "https://secure.php.net/manual/en/function.date-default-timezone-set.php" date_default_timezone_set()} and as + * returned by {@link "https://secure.php.net/manual/en/function.date-default-timezone-get.php" date_default_timezone_get()}. * </p> * </li> * <li> * <p> - * An {@link "https://www.php.net/manual/en/class.intltimezone.php" IntlTimeZone}, which will be used directly. + * An {@link "https://secure.php.net/manual/en/class.intltimezone.php" IntlTimeZone}, which will be used directly. * </p> * </li> * <li> * <p> - * A {@link "https://www.php.net/manual/en/class.datetimezone.php" DateTimeZone}. Its identifier will be extracted + * A {@link "https://secure.php.net/manual/en/class.datetimezone.php" DateTimeZone}. Its identifier will be extracted * and an ICU timezone object will be created; the timezone will be backed * by ICU's database, not PHP's. * </p> * </li> - *<li> + * <li> * <p> - * A {@link "https://www.php.net/manual/en/language.types.string.php" string}, which should be a valid ICU timezone identifier. + * A {@link "https://secure.php.net/manual/en/language.types.string.php" string}, which should be a valid ICU timezone identifier. * See <b>IntlTimeZone::createTimeZoneIDEnumeration()</b>. Raw offsets such as <em>"GMT+08:30"</em> are also accepted. * </p> * </li> * </ul> * </p> - * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. + * @return bool|null <b>TRUE</b> on success (since 8.3 - previously null) or <b>FALSE</b> on failure. */ - public function setTimeZone($zone) { } + public function setTimeZone($timezone): ?bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1849,24 +1967,26 @@ class IntlDateFormatter { * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. * Bad formatstrings are usually the cause of the failure. */ - public function setPattern($pattern) { } + public function setPattern(string $pattern): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the pattern used for the IntlDateFormatter * @link https://php.net/manual/en/intldateformatter.getpattern.php - * @return string The pattern string being used to format/parse. + * @return string|false The pattern string being used to format/parse. */ - public function getPattern() { } + public function getPattern(): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the locale used by formatter * @link https://php.net/manual/en/intldateformatter.getlocale.php - * @param int $which [optional] + * @param int $type [optional] * @return string|false the locale of this formatter or 'false' if error */ - public function getLocale($which = null) { } + public function getLocale( + int $type = 0 + ): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1875,9 +1995,9 @@ class IntlDateFormatter { * @param bool $lenient <p> * Sets whether the parser is lenient or not, default is <b>TRUE</b> (lenient). * </p> - * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. + * @return void */ - public function setLenient($lenient) { } + public function setLenient(bool $lenient): void {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1885,13 +2005,13 @@ class IntlDateFormatter { * @link https://php.net/manual/en/intldateformatter.islenient.php * @return bool <b>TRUE</b> if parser is lenient, <b>FALSE</b> if parser is strict. By default the parser is lenient. */ - public function isLenient() { } + public function isLenient(): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Format the date/time value as a string * @link https://php.net/manual/en/intldateformatter.format.php - * @param mixed $value <p> + * @param mixed $datetime <p> * Value to format. This may be a <b>DateTime</b> object, * an integer representing a Unix timestamp value (seconds * since epoch, UTC) or an array in the format output by @@ -1899,17 +2019,19 @@ class IntlDateFormatter { * </p> * @return string|false The formatted string or, if an error occurred, <b>FALSE</b>. */ - public function format($value) { } + public function format( + $datetime, + ): string|false {} /** * (PHP 5 >= 5.5.0, PECL intl >= 3.0.0)<br/> * Formats an object - * @link https://www.php.net/manual/en/intldateformatter.formatobject.php - * @param object $object <p> - * An object of type {@link "https://www.php.net/manual/en/class.intlcalendar.php" IntlCalendar} or {@link "https://www.php.net/manual/en/class.datetime.php" DateTime}. The timezone information in the object will be used. + * @link https://secure.php.net/manual/en/intldateformatter.formatobject.php + * @param object $datetime <p> + * An object of type {@link "https://secure.php.net/manual/en/class.intlcalendar.php" IntlCalendar} or {@link "https://secure.php.net/manual/en/class.datetime.php" DateTime}. The timezone information in the object will be used. * </p> * @param mixed $format [optional] <p> - * How to format the date/time. This can either be an {@link "https://www.php.net/manual/en/language.types.array.php" array} with + * How to format the date/time. This can either be an {@link "https://secure.php.net/manual/en/language.types.array.php" array} with * two elements (first the date style, then the time style, these being one * of the constants <b>IntlDateFormatter::NONE</b>, * <b>IntlDateFormatter::SHORT</b>, @@ -1917,50 +2039,50 @@ class IntlDateFormatter { * <b>IntlDateFormatter::LONG</b>, * <b>IntlDateFormatter::FULL</b>), a long with * the value of one of these constants (in which case it will be used both - * for the time and the date) or a {@link "https://www.php.net/manual/en/language.types.string.php" string} with the format + * for the time and the date) or a {@link "https://secure.php.net/manual/en/language.types.string.php" string} with the format * described in {@link "http://www.icu-project.org/apiref/icu4c/classSimpleDateFormat.html#details" the ICU documentation}. - * If <br>NULL</br>, the default style will be used. + * If <b>NULL</b>, the default style will be used. * </p> - * @param string $locale [optional] <p> - * The locale to use, or <b>NULL</b> to use the {@link "https://www.php.net/manual/en/intl.configuration.php#ini.intl.default-locale"default one}.</p> + * @param string|null $locale [optional] <p> + * The locale to use, or <b>NULL</b> to use the {@link "https://secure.php.net/manual/en/intl.configuration.php#ini.intl.default-locale" default one}.</p> * @return string|false A string with result or <b>FALSE</b> on failure. */ - public static function formatObject($object, $format = null, $locale = null) { } + public static function formatObject($datetime, $format = null, string|null $locale = null): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Parse string to a timestamp value * @link https://php.net/manual/en/intldateformatter.parse.php - * @param string $value <p> + * @param string $string <p> * string to convert to a time * </p> - * @param int $position [optional] <p> + * @param int &$offset [optional] <p> * Position at which to start the parsing in $value (zero-based). * If no error occurs before $value is consumed, $parse_pos will contain -1 * otherwise it will contain the position at which parsing ended (and the error occurred). * This variable will contain the end position if the parse fails. * If $parse_pos > strlen($value), the parse fails immediately. * </p> - * @return int timestamp parsed value + * @return int|float|false timestamp parsed value */ - public function parse($value, &$position = null) { } + public function parse(string $string, &$offset = null): int|float|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Parse string to a field-based time value * @link https://php.net/manual/en/intldateformatter.localtime.php - * @param string $value <p> + * @param string $string <p> * string to convert to a time * </p> - * @param int $position [optional] <p> + * @param int &$offset [optional] <p> * Position at which to start the parsing in $value (zero-based). * If no error occurs before $value is consumed, $parse_pos will contain -1 * otherwise it will contain the position at which parsing ended . * If $parse_pos > strlen($value), the parse fails immediately. * </p> - * @return array Localtime compatible array of integers : contains 24 hour clock value in tm_hour field + * @return array|false Localtime compatible array of integers : contains 24 hour clock value in tm_hour field */ - public function localtime($value, &$position = null) { } + public function localtime(string $string, &$offset = null): array|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1968,7 +2090,7 @@ class IntlDateFormatter { * @link https://php.net/manual/en/intldateformatter.geterrorcode.php * @return int The error code, one of UErrorCode values. Initial value is U_ZERO_ERROR. */ - public function getErrorCode() { } + public function getErrorCode(): int {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -1976,17 +2098,27 @@ class IntlDateFormatter { * @link https://php.net/manual/en/intldateformatter.geterrormessage.php * @return string Description of the last error. */ - public function getErrorMessage() { } -} + public function getErrorMessage(): string {} -class ResourceBundle implements IteratorAggregate { + /** + * @since 8.4 + */ + public function parseToCalendar(string $string, &$offset = null): int|float|false {} +} +class ResourceBundle implements IteratorAggregate, Countable +{ /** - * @param $locale - * @param $bundlename - * @param $fallback [optional] + * @link https://www.php.net/manual/en/resourcebundle.create.php + * @param string $locale <p>Locale for which the resources should be loaded (locale name, e.g. en_CA).</p> + * @param string $bundle <p>The directory where the data is stored or the name of the .dat file.</p> + * @param bool $fallback [optional] <p>Whether locale should match exactly or fallback to parent locale is allowed.</p> */ - public function __construct($locale, $bundlename, $fallback) { } + public function __construct( + string|null $locale, + string|null $bundle, + bool $fallback = true + ) {} /** * (PHP >= 5.3.2, PECL intl >= 2.0.0)<br/> @@ -1995,15 +2127,19 @@ class ResourceBundle implements IteratorAggregate { * @param string $locale <p> * Locale for which the resources should be loaded (locale name, e.g. en_CA). * </p> - * @param string $bundlename <p> + * @param string $bundle <p> * The directory where the data is stored or the name of the .dat file. * </p> * @param bool $fallback [optional] <p> * Whether locale should match exactly or fallback to parent locale is allowed. * </p> - * @return ResourceBundle|false <b>ResourceBundle</b> object or <b>FALSE</b> on error. + * @return ResourceBundle|null <b>ResourceBundle</b> object or <b>null</b> on error. */ - public static function create($locale, $bundlename, $fallback = null) { } + public static function create( + string|null $locale, + string|null $bundle, + bool $fallback = true + ): ?ResourceBundle {} /** * (PHP >= 5.3.2, PECL intl >= 2.0.0)<br/> @@ -2012,31 +2148,32 @@ class ResourceBundle implements IteratorAggregate { * @param string|int $index <p> * Data index, must be string or integer. * </p> + * @param bool $fallback * @return mixed the data located at the index or <b>NULL</b> on error. Strings, integers and binary data strings * are returned as corresponding PHP types, integer array is returned as PHP array. Complex types are * returned as <b>ResourceBundle</b> object. */ - public function get($index) { } + public function get($index, bool $fallback = true): mixed {} /** * (PHP >= 5.3.2, PECL intl >= 2.0.0)<br/> * Get number of elements in the bundle * @link https://php.net/manual/en/resourcebundle.count.php - * @return int number of elements in the bundle. + * @return int<0,max> number of elements in the bundle. */ - public function count() { } + public function count(): int {} /** * (PHP >= 5.3.2, PECL intl >= 2.0.0)<br/> * Get supported locales * @link https://php.net/manual/en/resourcebundle.locales.php - * @param string $bundlename <p> + * @param string $bundle <p> * Path of ResourceBundle for which to get available locales, or * empty string for default locales list. * </p> - * @return array the list of locales supported by the bundle. + * @return array|false the list of locales supported by the bundle. */ - public static function getLocales($bundlename) { } + public static function getLocales(string $bundle): array|false {} /** * (PHP >= 5.3.2, PECL intl >= 2.0.0)<br/> @@ -2044,7 +2181,7 @@ class ResourceBundle implements IteratorAggregate { * @link https://php.net/manual/en/resourcebundle.geterrorcode.php * @return int error code from last bundle object call. */ - public function getErrorCode() { } + public function getErrorCode(): int {} /** * (PHP >= 5.3.2, PECL intl >= 2.0.0)<br/> @@ -2052,30 +2189,34 @@ class ResourceBundle implements IteratorAggregate { * @link https://php.net/manual/en/resourcebundle.geterrormessage.php * @return string error message from last bundle object's call. */ - public function getErrorMessage() { } + public function getErrorMessage(): string {} /** + * @return Iterator * @since 8.0 */ - public function getIterator(){} + public function getIterator(): Iterator {} } /** * @since 5.4 */ -class Transliterator { - const FORWARD = 0; - const REVERSE = 1; - - public $id; +class Transliterator +{ + public const FORWARD = 0; + public const REVERSE = 1; + /** + * Starting 8.2 $id is readonly to unlock subclassing it + */ + public string $id; /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Private constructor to deny instantiation * @link https://php.net/manual/en/transliterator.construct.php */ - final private function __construct() { } + final private function __construct() {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> @@ -2086,14 +2227,17 @@ class Transliterator { * </p> * @param int $direction [optional] <p> * The direction, defaults to - * >Transliterator::FORWARD. + * Transliterator::FORWARD. * May also be set to * Transliterator::REVERSE. * </p> - * @return Transliterator a <b>Transliterator</b> object on success, + * @return Transliterator|null a <b>Transliterator</b> object on success, * or <b>NULL</b> on failure. */ - public static function create($id, $direction = null) { } + public static function create( + string $id, + int $direction = 0 + ): ?Transliterator {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> @@ -2102,40 +2246,43 @@ class Transliterator { * @param string $rules <p> * The rules. * </p> - * @param string $direction [optional] <p> + * @param int $direction [optional] <p> * The direction, defaults to - * >Transliterator::FORWARD. + * {@see Transliterator::FORWARD}. * May also be set to - * Transliterator::REVERSE. + * {@see Transliterator::REVERSE}. * </p> - * @return Transliterator a <b>Transliterator</b> object on success, + * @return Transliterator|null a <b>Transliterator</b> object on success, * or <b>NULL</b> on failure. */ - public static function createFromRules($rules, $direction = null) { } + public static function createFromRules( + string $rules, + int $direction = 0 + ): ?Transliterator {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Create an inverse transliterator * @link https://php.net/manual/en/transliterator.createinverse.php - * @return Transliterator a <b>Transliterator</b> object on success, + * @return Transliterator|null a <b>Transliterator</b> object on success, * or <b>NULL</b> on failure */ - public function createInverse() { } + public function createInverse(): ?Transliterator {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Get transliterator IDs * @link https://php.net/manual/en/transliterator.listids.php - * @return array An array of registered transliterator IDs on success, + * @return array|false An array of registered transliterator IDs on success, * or <b>FALSE</b> on failure. */ - public static function listIDs() { } + public static function listIDs(): array|false {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Transliterate a string * @link https://php.net/manual/en/transliterator.transliterate.php - * @param string $subject <p> + * @param string $string <p> * The string to be transformed. * </p> * @param int $start [optional] <p> @@ -2150,240 +2297,308 @@ class Transliterator { * </p> * @return string|false The transfomed string on success, or <b>FALSE</b> on failure. */ - public function transliterate($subject, $start = null, $end = null) { } + public function transliterate( + string $string, + int $start = 0, + int $end = -1 + ): string|false {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Get last error code * @link https://php.net/manual/en/transliterator.geterrorcode.php - * @return int The error code on success, + * @return int|false The error code on success, * or <b>FALSE</b> if none exists, or on failure. */ - public function getErrorCode() { } + public function getErrorCode(): int|false {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Get last error message * @link https://php.net/manual/en/transliterator.geterrormessage.php - * @return string The error code on success, + * @return string|false The error code on success, * or <b>FALSE</b> if none exists, or on failure. */ - public function getErrorMessage() { } + public function getErrorMessage(): string|false {} } /** * @link https://php.net/manual/en/class.spoofchecker.php */ -class Spoofchecker { - const SINGLE_SCRIPT_CONFUSABLE = 1; - const MIXED_SCRIPT_CONFUSABLE = 2; - const WHOLE_SCRIPT_CONFUSABLE = 4; - const ANY_CASE = 8; - const SINGLE_SCRIPT = 16; - const INVISIBLE = 32; - const CHAR_LIMIT = 64; +class Spoofchecker +{ + public const SINGLE_SCRIPT_CONFUSABLE = 1; + public const MIXED_SCRIPT_CONFUSABLE = 2; + public const WHOLE_SCRIPT_CONFUSABLE = 4; + public const ANY_CASE = 8; + public const SINGLE_SCRIPT = 16; + public const INVISIBLE = 32; + public const CHAR_LIMIT = 64; + public const ASCII = 268435456; + public const HIGHLY_RESTRICTIVE = 805306368; + public const MODERATELY_RESTRICTIVE = 1073741824; + public const MINIMALLY_RESTRICTIVE = 1342177280; + public const UNRESTRICTIVE = 1610612736; + public const SINGLE_SCRIPT_RESTRICTIVE = 536870912; + public const MIXED_NUMBERS = 1; + public const HIDDEN_OVERLAY = 2; + + /** + * @since 8.4 + */ + public const IGNORE_SPACE = 1; + /** + * @since 8.4 + */ + public const CASE_INSENSITIVE = 2; + + /** + * @since 8.4 + */ + public const ADD_CASE_MAPPINGS = 4; + + /** + * @since 8.4 + */ + public const SIMPLE_CASE_INSENSITIVE = 6; /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Constructor * @link https://php.net/manual/en/spoofchecker.construct.php */ - public function __construct() { } + public function __construct() {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Checks if a given text contains any suspicious characters * @link https://php.net/manual/en/spoofchecker.issuspicious.php - * @param string $text <p> + * @param string $string <p> * </p> - * @param string $error [optional] <p> + * @param string &$errorCode [optional] <p> * </p> * @return bool */ - public function isSuspicious($text, &$error = null) { } + public function isSuspicious(string $string, &$errorCode = null): bool {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Checks if a given text contains any confusable characters * @link https://php.net/manual/en/spoofchecker.areconfusable.php - * @param string $s1 <p> + * @param string $string1 <p> * </p> - * @param string $s2 <p> + * @param string $string2 <p> * </p> - * @param string $error [optional] <p> + * @param int &$errorCode [optional] <p> * </p> * @return bool */ - public function areConfusable($s1, $s2, &$error = null) { } + public function areConfusable( + string $string1, + string $string2, + &$errorCode = null + ): bool {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Locales to use when running checks * @link https://php.net/manual/en/spoofchecker.setallowedlocales.php - * @param string $locale_list <p> + * @param string $locales <p> * </p> * @return void */ - public function setAllowedLocales($locale_list) { } + public function setAllowedLocales(string $locales): void {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Set the checks to run * @link https://php.net/manual/en/spoofchecker.setchecks.php - * @param string $checks <p> + * @param int $checks <p> * </p> * @return void */ - public function setChecks($checks) { } + public function setChecks(int $checks): void {} + + /** + * @param int $level + */ + public function setRestrictionLevel(int $level): void {} + + /** + * @since 8.4 + */ + public function setAllowedChars(string $pattern, int $patternOptions = 0): void {} } /** * @since 5.5 */ -class IntlGregorianCalendar extends IntlCalendar { +class IntlGregorianCalendar extends IntlCalendar +{ + /** + * @link https://www.php.net/manual/en/intlgregoriancalendar.construct + * @param int $timezoneOrYear [optional] + * @param int $localeOrMonth [optional] + * @param int $day [optional] + * @param int $hour [optional] + * @param int $minute [optional] + * @param int $second [optional] + */ + public function __construct($timezoneOrYear, $localeOrMonth, $day, $hour, $minute, $second) {} + /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * @param mixed $timeZone * @param string $locale * @return IntlGregorianCalendar */ - public static function createInstance($timeZone = null, $locale = null) { } + public static function createInstance($timeZone = null, $locale = null) {} /** - * @param double $change - * + * @param float $timestamp */ - public function setGregorianChange($change) { } + public function setGregorianChange(float $timestamp): bool {} /** - * @return double $change + * @return float */ - public function getGregorianChange() { } + public function getGregorianChange(): float {} /** * @param int $year * @return bool */ - public function isLeapYear($year) { } + public function isLeapYear(int $year): bool {} + + /** + * @since 8.3 + */ + public static function createFromDate(int $year, int $month, int $dayOfMonth): static {} + + /** + * @since 8.3 + */ + public static function createFromDateTime(int $year, int $month, int $dayOfMonth, int $hour, int $minute, ?int $second = null): static {} } /** * @since 5.5 */ -class IntlCalendar { +class IntlCalendar +{ /* Constants */ - const FIELD_ERA = 0; - const FIELD_YEAR = 1; - const FIELD_MONTH = 2; - const FIELD_WEEK_OF_YEAR = 3; - const FIELD_WEEK_OF_MONTH = 4; - const FIELD_DATE = 5; - const FIELD_DAY_OF_YEAR = 6; - const FIELD_DAY_OF_WEEK = 7; - const FIELD_DAY_OF_WEEK_IN_MONTH = 8; - const FIELD_AM_PM = 9; - const FIELD_HOUR = 10; - const FIELD_HOUR_OF_DAY = 11; - const FIELD_MINUTE = 12; - const FIELD_SECOND = 13; - const FIELD_MILLISECOND = 14; - const FIELD_ZONE_OFFSET = 15; - const FIELD_DST_OFFSET = 16; - const FIELD_YEAR_WOY = 17; - const FIELD_DOW_LOCAL = 18; - const FIELD_EXTENDED_YEAR = 19; - const FIELD_JULIAN_DAY = 20; - const FIELD_MILLISECONDS_IN_DAY = 21; - const FIELD_IS_LEAP_MONTH = 22; - const FIELD_FIELD_COUNT = 23; - const FIELD_DAY_OF_MONTH = 5; - const DOW_SUNDAY = 1; - const DOW_MONDAY = 2; - const DOW_TUESDAY = 3; - const DOW_WEDNESDAY = 4; - const DOW_THURSDAY = 5; - const DOW_FRIDAY = 6; - const DOW_SATURDAY = 7; - const DOW_TYPE_WEEKDAY = 0; - const DOW_TYPE_WEEKEND = 1; - const DOW_TYPE_WEEKEND_OFFSET = 2; - const DOW_TYPE_WEEKEND_CEASE = 3; - const WALLTIME_FIRST = 1; - const WALLTIME_LAST = 0; - const WALLTIME_NEXT_VALID = 2; + public const FIELD_ERA = 0; + public const FIELD_YEAR = 1; + public const FIELD_MONTH = 2; + public const FIELD_WEEK_OF_YEAR = 3; + public const FIELD_WEEK_OF_MONTH = 4; + public const FIELD_DATE = 5; + public const FIELD_DAY_OF_YEAR = 6; + public const FIELD_DAY_OF_WEEK = 7; + public const FIELD_DAY_OF_WEEK_IN_MONTH = 8; + public const FIELD_AM_PM = 9; + public const FIELD_HOUR = 10; + public const FIELD_HOUR_OF_DAY = 11; + public const FIELD_MINUTE = 12; + public const FIELD_SECOND = 13; + public const FIELD_MILLISECOND = 14; + public const FIELD_ZONE_OFFSET = 15; + public const FIELD_DST_OFFSET = 16; + public const FIELD_YEAR_WOY = 17; + public const FIELD_DOW_LOCAL = 18; + public const FIELD_EXTENDED_YEAR = 19; + public const FIELD_JULIAN_DAY = 20; + public const FIELD_MILLISECONDS_IN_DAY = 21; + public const FIELD_IS_LEAP_MONTH = 22; + public const FIELD_FIELD_COUNT = 23; + public const FIELD_DAY_OF_MONTH = 5; + public const DOW_SUNDAY = 1; + public const DOW_MONDAY = 2; + public const DOW_TUESDAY = 3; + public const DOW_WEDNESDAY = 4; + public const DOW_THURSDAY = 5; + public const DOW_FRIDAY = 6; + public const DOW_SATURDAY = 7; + public const DOW_TYPE_WEEKDAY = 0; + public const DOW_TYPE_WEEKEND = 1; + public const DOW_TYPE_WEEKEND_OFFSET = 2; + public const DOW_TYPE_WEEKEND_CEASE = 3; + public const WALLTIME_FIRST = 1; + public const WALLTIME_LAST = 0; + public const WALLTIME_NEXT_VALID = 2; /* Methods */ /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Add a (signed) amount of time to a field - * @link https://www.php.net/manual/en/intlcalendar.add.php + * @link https://secure.php.net/manual/en/intlcalendar.add.php * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. * These are integer values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> - * @param int $amount <p>The signed amount to add to the current field. If the amount is positive, the instant will be moved forward; if it is negative, the instant wil be moved into the past. The unit is implicit to the field type. + * @param int $value <p>The signed amount to add to the current field. If the amount is positive, the instant will be moved forward; if it is negative, the instant wil be moved into the past. The unit is implicit to the field type. * For instance, hours for <b>IntlCalendar::FIELD_HOUR_OF_DAY</b>.</p> * @return bool Returns TRUE on success or FALSE on failure. */ - public function add($field, $amount) { } + public function add( + int $field, + int $value + ): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether this object's time is after that of the passed object - * https://www.php.net/manual/en/intlcalendar.after.php - * @param IntlCalendar $calendar <p>The calendar whose time will be checked against this object's time.</p> + * https://secure.php.net/manual/en/intlcalendar.after.php + * @param IntlCalendar $other <p>The calendar whose time will be checked against this object's time.</p> * @return bool * Returns <b>TRUE</b> if this object's current time is after that of the * <em>calendar</em> argument's time. Returns <b>FALSE</b> otherwise. - * Also returns <b>FALSE</b> on failure. You can use {@link https://www.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or - * {@link https://www.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to detect error conditions. + * Also returns <b>FALSE</b> on failure. You can use {@link https://secure.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or + * {@link https://secure.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to detect error conditions. */ - public function after(IntlCalendar $calendar) { } + public function after(IntlCalendar $other): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether this object's time is before that of the passed object - * @link https://www.php.net/manual/en/intlcalendar.before.php - * @param IntlCalendar $calendar <p> The calendar whose time will be checked against this object's time.</p> + * @link https://secure.php.net/manual/en/intlcalendar.before.php + * @param IntlCalendar $other <p> The calendar whose time will be checked against this object's time.</p> * @return bool * Returns <b>TRUE</B> if this object's current time is before that of the * <em>calendar</em> argument's time. Returns <b>FALSE</b> otherwise. - * Also returns <b>FALSE</b> on failure. You can use {@link https://www.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or - * {@link https://www.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to detect error conditions. - * </p> + * Also returns <b>FALSE</b> on failure. You can use {@link https://secure.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or + * {@link https://secure.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to detect error conditions. */ - public function before(IntlCalendar $calendar) { } + public function before(IntlCalendar $other): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Clear a field or all fields - * @link https://www.php.net/manual/en/intlcalendar.clear.php + * @link https://secure.php.net/manual/en/intlcalendar.clear.php * @param int $field [optional] <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> * @return bool Returns <b>TRUE</b> on success or <b>FALSE</b> on failure. Failure can only occur is invalid arguments are provided. */ - public function clear($field = null) { } + public function clear(int|null $field = null): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Private constructor for disallowing instantiation - * @link https://www.php.net/manual/en/intlcalendar.construct.php - * + * @link https://secure.php.net/manual/en/intlcalendar.construct.php */ - private function __construct() { } - + private function __construct() {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Create a new IntlCalendar - * @link https://www.php.net/manual/en/intlcalendar.createinstance.php - * @param mixed $timeZone [optional] <p> <p> + * @link https://secure.php.net/manual/en/intlcalendar.createinstance.php + * @param mixed $timezone [optional] <p> <p> * The timezone to use. * </p> * @@ -2391,61 +2606,61 @@ class IntlCalendar { * <li> * <p> * <b>NULL</b>, in which case the default timezone will be used, as specified in - * the ini setting {@link https://www.php.net/manual/en/datetime.configuration.php#ini.date.timezone date.timezone} or - * through the function {@link https://www.php.net/manual/en/function.date-default-timezone-set.php date_default_timezone_set()} and as - * returned by {@link https://www.php.net/manual/en/function.date-default-timezone-get.php date_default_timezone_get()}. + * the ini setting {@link https://secure.php.net/manual/en/datetime.configuration.php#ini.date.timezone date.timezone} or + * through the function {@link https://secure.php.net/manual/en/function.date-default-timezone-set.php date_default_timezone_set()} and as + * returned by {@link https://secure.php.net/manual/en/function.date-default-timezone-get.php date_default_timezone_get()}. * </p> * </li> * <li> * <p> - * An {@link https://www.php.net/manual/en/class.intltimezone.php IntlTimeZone}, which will be used directly. + * An {@link https://secure.php.net/manual/en/class.intltimezone.php IntlTimeZone}, which will be used directly. * </p> * </li> * <li> * <p> - * A {@link https://www.php.net/manual/en/class.datetimezone.php DateTimeZone}. Its identifier will be extracted + * A {@link https://secure.php.net/manual/en/class.datetimezone.php DateTimeZone}. Its identifier will be extracted * and an ICU timezone object will be created; the timezone will be backed * by ICU's database, not PHP's. * </p> * </li> * <li> * <p> - * A {@link https://www.php.net/manual/en/language.types.string.php string}, which should be a valid ICU timezone identifier. + * A {@link https://secure.php.net/manual/en/language.types.string.php string}, which should be a valid ICU timezone identifier. * See <b>IntlTimeZone::createTimeZoneIDEnumeration()</b>. Raw * offsets such as <em>"GMT+08:30"</em> are also accepted. * </p> * </li> * </ul> * </p> - * @param string $locale [optional] <p> - * A locale to use or <b>NULL</b> to use {@link https://www.php.net/manual/en/intl.configuration.php#ini.intl.default-locale the default locale}. + * @param string|null $locale [optional] <p> + * A locale to use or <b>NULL</b> to use {@link https://secure.php.net/manual/en/intl.configuration.php#ini.intl.default-locale the default locale}. * </p> - * @return IntlCalendar - * The created {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} instance or <b>NULL</b> on + * @return IntlCalendar|null + * The created {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} instance or <b>NULL</b> on * failure. */ - public static function createInstance($timeZone = null, $locale = null) { } + public static function createInstance($timezone = null, string|null $locale = null): ?IntlCalendar {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Compare time of two IntlCalendar objects for equality - * @link https://www.php.net/manual/en/intlcalendar.equals.php - * @param IntlCalendar $calendar + * @link https://secure.php.net/manual/en/intlcalendar.equals.php + * @param IntlCalendar $other * @return bool <p> * Returns <b>TRUE</b> if the current time of both this and the passed in - * {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} object are the same, or <b>FALSE</b> + * {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} object are the same, or <b>FALSE</b> * otherwise. The value <b>FALSE</b> can also be returned on failure. This can only * happen if bad arguments are passed in. In any case, the two cases can be - * distinguished by calling {@link https://www.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()}. + * distinguished by calling {@link https://secure.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()}. * </p> */ - public function equals($calendar) { } + public function equals(IntlCalendar $other): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Calculate difference between given time and this object's time - * @link https://www.php.net/manual/en/intlcalendar.fielddifference.php - * @param float $when <p> + * @link https://secure.php.net/manual/en/intlcalendar.fielddifference.php + * @param float $timestamp <p> * The time against which to compare the quantity represented by the * <em>field</em>. For the result to be positive, the time * given for this parameter must be ahead of the time of the object the @@ -2456,82 +2671,87 @@ class IntlCalendar { * </p> * * <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> - * @return int Returns a (signed) difference of time in the unit associated with the + * @return int|false Returns a (signed) difference of time in the unit associated with the * specified field or <b>FALSE</b> on failure. - * */ - public function fieldDifference($when, $field) { } + public function fieldDifference( + float $timestamp, + int $field + ): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a2)<br/> * Create an IntlCalendar from a DateTime object or string - * @link https://www.php.net/manual/en/intlcalendar.fromdatetime.php - * @param mixed $dateTime <p> - * A {@link https://www.php.net/manual/en/class.datetime.php DateTime} object or a {@link https://www.php.net/manual/en/language.types.string.php string} that - * can be passed to {@link https://www.php.net/manual/en/datetime.construct.php DateTime::__construct()}. + * @link https://secure.php.net/manual/en/intlcalendar.fromdatetime.php + * @param mixed $datetime <p> + * A {@link https://secure.php.net/manual/en/class.datetime.php DateTime} object or a {@link https://secure.php.net/manual/en/language.types.string.php string} that + * can be passed to {@link https://secure.php.net/manual/en/datetime.construct.php DateTime::__construct()}. * </p> - * @return IntlCalendar - * The created {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} object or <b>NULL</b> in case of - * failure. If a {@link https://www.php.net/manual/en/language.types.string.php string} is passed, any exception that occurs - * inside the {@link https://www.php.net/manual/en/class.datetime.php DateTime} constructor is propagated. + * @param $locale [optional] + * @return IntlCalendar|null + * The created {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} object or <b>NULL</b> in case of + * failure. If a {@link https://secure.php.net/manual/en/language.types.string.php string} is passed, any exception that occurs + * inside the {@link https://secure.php.net/manual/en/class.datetime.php DateTime} constructor is propagated. */ - public static function fromDateTime($dateTime) { } + public static function fromDateTime( + DateTime|string $datetime, + string|null $locale + ): ?IntlCalendar {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the value for a field - * @link https://www.php.net/manual/en/intlcalendar.get.php + * @link https://secure.php.net/manual/en/intlcalendar.get.php * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> - * @return int An integer with the value of the time field. + * @return int|false An integer with the value of the time field. */ - public function get($field) { } + public function get(int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * The maximum value for a field, considering the object's current time - * @link https://www.php.net/manual/en/intlcalendar.getactualmaximum.php + * @link https://secure.php.net/manual/en/intlcalendar.getactualmaximum.php * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> - * @return int - * An {@link https://www.php.net/manual/en/language.types.integer.php int} representing the maximum value in the units associated + * @return int|false + * An {@link https://secure.php.net/manual/en/language.types.integer.php int} representing the maximum value in the units associated * with the given <em>field</em> or <b>FALSE</b> on failure. */ - public function getActualMaximum($field) { } + public function getActualMaximum(int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * The minimum value for a field, considering the object's current time - * @link https://www.php.net/manual/en/intlcalendar.getactualminimum.php + * @link https://secure.php.net/manual/en/intlcalendar.getactualminimum.php * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. * These are integer values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> - * @return int - * An {@link https://www.php.net/manual/en/language.types.integer.php int} representing the minimum value in the field's + * @return int|false + * An {@link https://secure.php.net/manual/en/language.types.integer.php int} representing the minimum value in the field's * unit or <b>FALSE</b> on failure. */ - public function getActualMinimum($field) { } + public function getActualMinimum(int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get array of locales for which there is data - * @link https://www.php.net/manual/en/intlcalendar.getavailablelocales.php - * @return array An array of strings, one for which locale. + * @link https://secure.php.net/manual/en/intlcalendar.getavailablelocales.php + * @return string[] An array of strings, one for which locale. */ - - public static function getAvailableLocales() { } + public static function getAvailableLocales(): array {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> @@ -2541,98 +2761,98 @@ class IntlCalendar { * <b>IntlCalendar::DOW_MONDAY</b>, ..., * <b>IntlCalendar::DOW_SATURDAY</b>. * </p> - * @return int + * @return int|false * Returns one of the constants * <b>IntlCalendar::DOW_TYPE_WEEKDAY</b>, * <b>IntlCalendar::DOW_TYPE_WEEKEND</b>, * <b>IntlCalendar::DOW_TYPE_WEEKEND_OFFSET</b> or * <b>IntlCalendar::DOW_TYPE_WEEKEND_CEASE</b> or <b>FALSE</b> on failure. - * */ - public function getDayOfWeekType($dayOfWeek) { } + public function getDayOfWeekType(int $dayOfWeek): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get last error code on the object - * @link https://www.php.net/manual/en/intlcalendar.geterrorcode.php - * @return int An ICU error code indicating either success, failure or a warning. - * + * @link https://secure.php.net/manual/en/intlcalendar.geterrorcode.php + * @return int|false An ICU error code indicating either success, failure or a warning. */ - public function getErrorCode() { } + public function getErrorCode(): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get last error message on the object - * @link https://www.php.net/manual/en/intlcalendar.geterrormessage.php - * @return string The error message associated with last error that occurred in a function call on this object, or a string indicating the non-existance of an error. + * @link https://secure.php.net/manual/en/intlcalendar.geterrormessage.php + * @return string|false The error message associated with last error that occurred in a function call on this object, or a string indicating the non-existance of an error. */ - public function getErrorMessage() { } + public function getErrorMessage(): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the first day of the week for the calendar's locale - * @link https://www.php.net/manual/en/intlcalendar.getfirstdayofweek.php - * @return int + * @link https://secure.php.net/manual/en/intlcalendar.getfirstdayofweek.php + * @return int|false * One of the constants <b>IntlCalendar::DOW_SUNDAY</b>, * <b>IntlCalendar::DOW_MONDAY</b>, ..., * <b>IntlCalendar::DOW_SATURDAY</b> or <b>FALSE</b> on failure. - * */ - public function getFirstDayOfWeek() { } + public function getFirstDayOfWeek(): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the largest local minimum value for a field - * @link https://www.php.net/manual/en/intlcalendar.getgreatestminimum.php - * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * @link https://secure.php.net/manual/en/intlcalendar.getgreatestminimum.php + * @param int $field + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. - * @return int - * An {@link https://www.php.net/manual/en/language.types.integer.php int} representing a field value, in the field's + * @return int|false + * An {@link https://secure.php.net/manual/en/language.types.integer.php int} representing a field value, in the field's * unit, or <b>FALSE</b> on failure. */ - public function getGreatestMinimum($field) { } + public function getGreatestMinimum(int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get set of locale keyword values - * @param string $key <p> + * @param string $keyword <p> * The locale keyword for which relevant values are to be queried. Only * <em>'calendar'</em> is supported. * </p> * @param string $locale <p> * The locale onto which the keyword/value pair are to be appended. * </p> - * @param bool $commonlyUsed + * @param bool $onlyCommon * <p> * Whether to show only the values commonly used for the specified locale. * </p> * @return Iterator|false An iterator that yields strings with the locale keyword values or <b>FALSE</b> on failure. */ - public static function getKeywordValuesForLocale($key, $locale, $commonlyUsed) { } + public static function getKeywordValuesForLocale( + string $keyword, + string $locale, + bool $onlyCommon + ): IntlIterator|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the smallest local maximum for a field - * @link https://www.php.net/manual/en/intlcalendar.getleastmaximum.php + * @link https://secure.php.net/manual/en/intlcalendar.getleastmaximum.php * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> - * @return int - * An {@link https://www.php.net/manual/en/language.types.integer.ph int} representing a field value in the field's + * @return int|false + * An {@link https://secure.php.net/manual/en/language.types.integer.ph int} representing a field value in the field's * unit or <b>FALSE</b> on failure. - * </p> */ - public function getLeastMaximum($field) { } + public function getLeastMaximum(int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the locale associated with the object - * @link https://www.php.net/manual/en/intlcalendar.getlocale.php - * @param int $localeType <p> + * @link https://secure.php.net/manual/en/intlcalendar.getlocale.php + * @param int $type <p> * Whether to fetch the actual locale (the locale from which the calendar * data originates, with <b>Locale::ACTUAL_LOCALE</b>) or the * valid locale, i.e., the most specific locale supported by ICU relatively @@ -2640,213 +2860,208 @@ class IntlCalendar { * From the most general to the most specific, the locales are ordered in * this fashion – actual locale, valid locale, requested locale. * </p> - * @return string - * A locale string or <b>FALSE</b> on failure. - * + * @return string|false */ - public function getLocale($localeType) { } + public function getLocale(int $type): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the global maximum value for a field - * @link https://www.php.net/manual/en/intlcalendar.getmaximum.php + * @link https://secure.php.net/manual/en/intlcalendar.getmaximum.php * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> - * @return string - * A locale string or <b>FALSE</b> on failure. + * @return int|false */ - public function getMaximum($field) { } + public function getMaximum(int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get minimal number of days the first week in a year or month can have - * @link https://www.php.net/manual/en/intlcalendar.getminimaldaysinfirstweek.php - * @return int - * An {@link https://www.php.net/manual/en/language.types.integer.php int} representing a number of days or <b>FALSE</b> on failure. + * @link https://secure.php.net/manual/en/intlcalendar.getminimaldaysinfirstweek.php + * @return int|false + * An {@link https://secure.php.net/manual/en/language.types.integer.php int} representing a number of days or <b>FALSE</b> on failure. */ - public function getMinimalDaysInFirstWeek() { } + public function getMinimalDaysInFirstWeek(): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the global minimum value for a field - * @link https://www.php.net/manual/en/intlcalendar.getminimum.php + * @link https://secure.php.net/manual/en/intlcalendar.getminimum.php * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> - * @return int + * @return int|false * An int representing a value for the given field in the field's unit or FALSE on failure. */ - public function getMinimum($field) { } + public function getMinimum(int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get number representing the current time * @return float A float representing a number of milliseconds since the epoch, not counting leap seconds. */ - public static function getNow() { } + public static function getNow(): float {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get behavior for handling repeating wall time - * @link https://www.php.net/manual/en/intlcalendar.getrepeatedwalltimeoption.php + * @link https://secure.php.net/manual/en/intlcalendar.getrepeatedwalltimeoption.php * @return int * One of the constants <b>IntlCalendar::WALLTIME_FIRST</b> or * <b>IntlCalendar::WALLTIME_LAST</b>. - * */ - public function getRepeatedWallTimeOption() { } + public function getRepeatedWallTimeOption(): int {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get behavior for handling skipped wall time - * @link https://www.php.net/manual/en/intlcalendar.getskippedwalltimeoption.php + * @link https://secure.php.net/manual/en/intlcalendar.getskippedwalltimeoption.php * @return int * One of the constants <b>IntlCalendar::WALLTIME_FIRST</b>, * <b>IntlCalendar::WALLTIME_LAST</b> or * <b>IntlCalendar::WALLTIME_NEXT_VALID</b>. */ - public function getSkippedWallTimeOption() { } + public function getSkippedWallTimeOption(): int {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get time currently represented by the object - * @return float - * A {@link https://www.php.net/manual/en/language.types.float.php float} representing the number of milliseconds elapsed since the + * @return float|false + * A {@link https://secure.php.net/manual/en/language.types.float.php float} representing the number of milliseconds elapsed since the * reference time (1 Jan 1970 00:00:00 UTC). */ - public function getTime() { } + public function getTime(): float|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the object's timezone - * @link https://www.php.net/manual/en/intlcalendar.gettimezone.php - * @return IntlTimeZone - * An {@link https://www.php.net/manual/en/class.intltimezone.php IntlTimeZone} object corresponding to the one used + * @link https://secure.php.net/manual/en/intlcalendar.gettimezone.php + * @return IntlTimeZone|false + * An {@link https://secure.php.net/manual/en/class.intltimezone.php IntlTimeZone} object corresponding to the one used * internally in this object. */ - public function getTimeZone() { } + public function getTimeZone(): IntlTimeZone|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the calendar type - * @link https://www.php.net/manual/en/intlcalendar.gettype.php + * @link https://secure.php.net/manual/en/intlcalendar.gettype.php * @return string - * A {@link https://www.php.net/manual/en/language.types.string.php string} representing the calendar type, such as + * A {@link https://secure.php.net/manual/en/language.types.string.php string} representing the calendar type, such as * <em>'gregorian'</em>, <em>'islamic'</em>, etc. */ - public function getType() { } + public function getType(): string {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get time of the day at which weekend begins or ends - * @link https://www.php.net/manual/en/intlcalendar.getweekendtransition.php + * @link https://secure.php.net/manual/en/intlcalendar.getweekendtransition.php * @param string $dayOfWeek <p> * One of the constants <b>IntlCalendar::DOW_SUNDAY</b>, * <b>IntlCalendar::DOW_MONDAY</b>, ..., * <b>IntlCalendar::DOW_SATURDAY</b>. * </p> - * @return int - * The number of milliseconds into the day at which the weekend begins or + * @return int|false + * The number of milliseconds into the day at which the the weekend begins or * ends or <b>FALSE</b> on failure. */ - public function getWeekendTransition($dayOfWeek) { } + public function getWeekendTransition(int $dayOfWeek): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether the object's time is in Daylight Savings Time - * @link https://www.php.net/manual/en/intlcalendar.indaylighttime.php + * @link https://secure.php.net/manual/en/intlcalendar.indaylighttime.php * @return bool * Returns <b>TRUE</b> if the date is in Daylight Savings Time, <b>FALSE</b> otherwise. * The value <b>FALSE</b> may also be returned on failure, for instance after - * specifying invalid field values on non-lenient mode; use {@link https://www.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or query - * {@link https://www.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to disambiguate. + * specifying invalid field values on non-lenient mode; use {@link https://secure.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or query + * {@link https://secure.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to disambiguate. */ - public function inDaylightTime() { } + public function inDaylightTime(): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether another calendar is equal but for a different time - * @link https://www.php.net/manual/en/intlcalendar.isequivalentto.php - * @param IntlCalendar $calendar The other calendar against which the comparison is to be made. + * @link https://secure.php.net/manual/en/intlcalendar.isequivalentto.php + * @param IntlCalendar $other The other calendar against which the comparison is to be made. * @return bool * Assuming there are no argument errors, returns <b>TRUE</b> iif the calendars are equivalent except possibly for their set time. */ - public function isEquivalentTo(IntlCalendar $calendar) { } + public function isEquivalentTo(IntlCalendar $other): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether date/time interpretation is in lenient mode - * @link https://www.php.net/manual/en/intlcalendar.islenient.php + * @link https://secure.php.net/manual/en/intlcalendar.islenient.php * @return bool - * A {@link https://www.php.net/manual/en/language.types.boolean.php bool} representing whether the calendar is set to lenient mode. + * A {@link https://secure.php.net/manual/en/language.types.boolean.php bool} representing whether the calendar is set to lenient mode. */ - public function isLenient() { } + public function isLenient(): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether a certain date/time is in the weekend - * @link https://www.php.net/manual/en/intlcalendar.isweekend.php - * @param float|null $date [optional] <p> + * @link https://secure.php.net/manual/en/intlcalendar.isweekend.php + * @param float|null $timestamp [optional] <p> * An optional timestamp representing the number of milliseconds since the * epoch, excluding leap seconds. If <b>NULL</b>, this object's current time is * used instead. * </p> * @return bool - * <p> A {@link https://www.php.net/manual/en/language.types.boolean.php bool} indicating whether the given or this object's time occurs + * <p> A {@link https://secure.php.net/manual/en/language.types.boolean.php bool} indicating whether the given or this object's time occurs * in a weekend. * </p> * <p> * The value <b>FALSE</b> may also be returned on failure, for instance after giving - * a date out of bounds on non-lenient mode; use {@link https://www.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or query - * {@link https://www.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to disambiguate.</p> + * a date out of bounds on non-lenient mode; use {@link https://secure.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or query + * {@link https://secure.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to disambiguate.</p> */ - public function isWeekend($date = null) { } + public function isWeekend(float|null $timestamp = null): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Add value to field without carrying into more significant fields - * @link https://www.php.net/manual/en/intlcalendar.roll.php + * @link https://secure.php.net/manual/en/intlcalendar.roll.php * @param int $field - * <p>One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time - * {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * <p>One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time + * {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> - * @param mixed $amountOrUpOrDown <p> + * @param mixed $value <p> * The (signed) amount to add to the field, <b>TRUE</b> for rolling up (adding * <em>1</em>), or <b>FALSE</b> for rolling down (subtracting * <em>1</em>). * </p> * @return bool Returns <b>TRUE</b> on success or <b>FALSE</b> on failure. */ - public function roll($field, $amountOrUpOrDown) { } - + public function roll(int $field, $value): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether a field is set - * @link https://www.php.net/manual/en/intlcalendar.isset.php + * @link https://secure.php.net/manual/en/intlcalendar.isset.php * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time - * {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time + * {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. * These are integer values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> * @return bool Assuming there are no argument errors, returns <b>TRUE</b> iif the field is set. */ - public function PS_UNRESERVE_PREFIX_isSet($field) { } + public function PS_UNRESERVE_PREFIX_isSet(int $field): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set a time field or several common fields at once - * @link https://www.php.net/manual/en/intlcalendar.set.php + * @link https://secure.php.net/manual/en/intlcalendar.set.php * @param int $year <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> @@ -2869,26 +3084,26 @@ class IntlCalendar { * </p> * @param int $second [optional] <p> * The new value for <b>IntlCalendar::FIELD_SECOND</b>. - *</p> + * </p> * @return bool Returns <b>TRUE</b> on success and <b>FALSE</b> on failure. */ - public function set($year, $month, $dayOfMonth = null, $hour = null, $minute = null, $second = null) { } + public function set($year, $month, $dayOfMonth = null, $hour = null, $minute = null, $second = null) {} /** - * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> + * (PHP 5 >= 5.5.0 PECL intl >= 3.0.0a1)<br/> * Set a time field or several common fields at once - * @link https://www.php.net/manual/en/intlcalendar.set.php + * @link https://secure.php.net/manual/en/intlcalendar.set.php * @param int $field One of the IntlCalendar date/time field constants. These are integer values between 0 and IntlCalendar::FIELD_COUNT. * @param int $value The new value of the given field. * @return bool Returns <b>TRUE</b> on success and <b>FALSE</b> on failure. * @since 5.5 */ - public function set($field, $value) { } + public function set($field, $value) {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set the day on which the week is deemed to start - * @link https://www.php.net/manual/en/intlcalendar.setfirstdayofweek.php + * @link https://secure.php.net/manual/en/intlcalendar.setfirstdayofweek.php * @param int $dayOfWeek <p> * One of the constants <b>IntlCalendar::DOW_SUNDAY</b>, * <b>IntlCalendar::DOW_MONDAY</b>, ..., @@ -2896,38 +3111,37 @@ class IntlCalendar { * </p> * @return bool Returns TRUE on success. Failure can only happen due to invalid parameters. */ - public function setFirstDayOfWeek($dayOfWeek) { } + public function setFirstDayOfWeek(int $dayOfWeek): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set whether date/time interpretation is to be lenient - * @link https://www.php.net/manual/en/intlcalendar.setlenient.php - * @param string $isLenient <p> + * @link https://secure.php.net/manual/en/intlcalendar.setlenient.php + * @param bool $lenient <p> * Use <b>TRUE</b> to activate the lenient mode; <b>FALSE</b> otherwise. * </p> * @return bool Returns <b>TRUE</b> on success. Failure can only happen due to invalid parameters. */ - public function setLenient($isLenient) { } + public function setLenient(bool $lenient): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set behavior for handling repeating wall times at negative timezone offset transitions - * @link https://www.php.net/manual/en/intlcalendar.setrepeatedwalltimeoption.php - * @param int $wallTimeOption <p> + * @link https://secure.php.net/manual/en/intlcalendar.setrepeatedwalltimeoption.php + * @param int $option <p> * One of the constants <b>IntlCalendar::WALLTIME_FIRST</b> or * <b>IntlCalendar::WALLTIME_LAST</b>. * </p> * @return bool * Returns <b>TRUE</b> on success. Failure can only happen due to invalid parameters. - * */ - public function setRepeatedWallTimeOption($wallTimeOption) { } + public function setRepeatedWallTimeOption(int $option): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set behavior for handling skipped wall times at positive timezone offset transitions - * @link https://www.php.net/manual/en/intlcalendar.setskippedwalltimeoption.php - * @param int $wallTimeOption <p> + * @link https://secure.php.net/manual/en/intlcalendar.setskippedwalltimeoption.php + * @param int $option <p> * One of the constants <b>IntlCalendar::WALLTIME_FIRST</b>, * <b>IntlCalendar::WALLTIME_LAST</b> or * <b>IntlCalendar::WALLTIME_NEXT_VALID</b>. @@ -2937,26 +3151,26 @@ class IntlCalendar { * Returns <b>TRUE</b> on success. Failure can only happen due to invalid parameters. * </p> */ - public function setSkippedWallTimeOption($wallTimeOption) { } + public function setSkippedWallTimeOption(int $option): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set the calendar time in milliseconds since the epoch - * @link https://www.php.net/manual/en/intlcalendar.settime.php - * @param float $date <p> + * @link https://secure.php.net/manual/en/intlcalendar.settime.php + * @param float $timestamp <p> * An instant represented by the number of number of milliseconds between * such instant and the epoch, ignoring leap seconds. * </p> * @return bool * Returns <b>TRUE</b> on success and <b>FALSE</b> on failure. */ - public function setTime($date) { } + public function setTime(float $timestamp): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set the timezone used by this calendar - * @link https://www.php.net/manual/en/intlcalendar.settimezone.php - * @param mixed $timeZone <p> + * @link https://secure.php.net/manual/en/intlcalendar.settimezone.php + * @param mixed $timezone <p> * The new timezone to be used by this calendar. It can be specified in the * following ways: * @@ -2964,26 +3178,26 @@ class IntlCalendar { * <li> * <p> * <b>NULL</b>, in which case the default timezone will be used, as specified in - * the ini setting {@link https://www.php.net/manual/en/datetime.configuration.php#ini.date.timezone date.timezone} or - * through the function {@link https://www.php.net/manual/en/function.date-default-timezone-set.php date_default_timezone_set()} and as - * returned by {@link https://www.php.net/manual/en/function.date-default-timezone-get.php date_default_timezone_get()}. + * the ini setting {@link https://secure.php.net/manual/en/datetime.configuration.php#ini.date.timezone date.timezone} or + * through the function {@link https://secure.php.net/manual/en/function.date-default-timezone-set.php date_default_timezone_set()} and as + * returned by {@link https://secure.php.net/manual/en/function.date-default-timezone-get.php date_default_timezone_get()}. * </p> * </li> * <li> * <p> - * An {@link https://www.php.net/manual/en/class.intltimezone.php IntlTimeZone}, which will be used directly. + * An {@link https://secure.php.net/manual/en/class.intltimezone.php IntlTimeZone}, which will be used directly. * </p> * </li> * <li> * <p> - * A {@link https://www.php.net/manual/en/class.datetimezone.php DateTimeZone}. Its identifier will be extracted + * A {@link https://secure.php.net/manual/en/class.datetimezone.php DateTimeZone}. Its identifier will be extracted * and an ICU timezone object will be created; the timezone will be backed * by ICU's database, not PHP's. * </p> * </li> * <li> * <p> - * A {@link https://www.php.net/manual/en/language.types.string.php string}, which should be a valid ICU timezone identifier. + * A {@link https://secure.php.net/manual/en/language.types.string.php string}, which should be a valid ICU timezone identifier. * See b>IntlTimeZone::createTimeZoneIDEnumeration()</b>. Raw * offsets such as <em>"GMT+08:30"</em> are also accepted. * </p> @@ -2991,183 +3205,221 @@ class IntlCalendar { * </ul> * @return bool Returns <b>TRUE</b> on success and <b>FALSE</b> on failure. */ - public function setTimeZone($timeZone) { } + public function setTimeZone($timezone): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a2)<br/> * Convert an IntlCalendar into a DateTime object - * @link https://www.php.net/manual/en/intlcalendar.todatetime.php + * @link https://secure.php.net/manual/en/intlcalendar.todatetime.php * @return DateTime|false - * A {@link https://www.php.net/manual/en/class.datetime.php DateTime} object with the same timezone as this + * A {@link https://secure.php.net/manual/en/class.datetime.php DateTime} object with the same timezone as this * object (though using PHP's database instead of ICU's) and the same time, * except for the smaller precision (second precision instead of millisecond). * Returns <b>FALSE</b> on failure. */ - public function toDateTime() { } + public function toDateTime(): DateTime|false {} + + /** + * @link https://www.php.net/manual/en/intlcalendar.setminimaldaysinfirstweek.php + * @param int $days + * @return bool + */ + public function setMinimalDaysInFirstWeek(int $days): bool {} + + /** + * @since 8.3 + */ + public function setDate(int $year, int $month, int $dayOfMonth): void {} + + /** + * @since 8.3 + */ + public function setDateTime(int $year, int $month, int $dayOfMonth, int $hour, int $minute, ?int $second = null): void {} } /** * @since 5.5 */ -class IntlIterator implements Iterator { - - public function current() { } +class IntlIterator implements Iterator +{ + public function current(): mixed {} - public function key() { } + public function key(): mixed {} - public function next() { } + public function next(): void {} - public function rewind() { } + public function rewind(): void {} - public function valid() { } + public function valid(): bool {} } /** * @since 5.5 */ -class IntlException extends Exception { - -} +class IntlException extends Exception {} /** * @since 5.5 */ -class IntlTimeZone { +class IntlTimeZone +{ /* Constants */ - const DISPLAY_SHORT = 1; - const DISPLAY_LONG = 2; + public const DISPLAY_SHORT = 1; + public const DISPLAY_LONG = 2; + public const DISPLAY_SHORT_GENERIC = 3; + public const DISPLAY_LONG_GENERIC = 4; + public const DISPLAY_SHORT_GMT = 5; + public const DISPLAY_LONG_GMT = 6; + public const DISPLAY_SHORT_COMMONLY_USED = 7; + public const DISPLAY_GENERIC_LOCATION = 8; + public const TYPE_ANY = 0; + public const TYPE_CANONICAL = 1; + public const TYPE_CANONICAL_LOCATION = 2; /* Methods */ + private function __construct() {} + /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the number of IDs in the equivalency group that includes the given ID - * @link https://www.php.net/manual/en/intltimezone.countequivalentids.php - * @param string $zoneId + * @link https://secure.php.net/manual/en/intltimezone.countequivalentids.php + * @param string $timezoneId * @return int|false number of IDs or <b>FALSE</b> on failure */ - public static function countEquivalentIDs($zoneId) { } + public static function countEquivalentIDs(string $timezoneId): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Create a new copy of the default timezone for this host - * @link https://www.php.net/manual/en/intltimezone.createdefault.php + * @link https://secure.php.net/manual/en/intltimezone.createdefault.php * @return IntlTimeZone */ - public static function createDefault() { } + public static function createDefault(): IntlTimeZone {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get an enumeration over time zone IDs associated with the given country or offset - * @link https://www.php.net/manual/en/intltimezone.createenumeration.php + * @link https://secure.php.net/manual/en/intltimezone.createenumeration.php * @param mixed $countryOrRawOffset [optional] * @return IntlIterator|false an iterator or <b>FALSE</b> on failure */ - public static function createEnumeration($countryOrRawOffset) { } + public static function createEnumeration($countryOrRawOffset): IntlIterator|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Create a timezone object for the given ID - * @link https://www.php.net/manual/en/intltimezone.createtimezone.php - * @param string $zoneId + * @link https://secure.php.net/manual/en/intltimezone.createtimezone.php + * @param string $timezoneId * @return IntlTimeZone|null a timezone object or <b>NULL</b> on failure */ - public static function createTimeZone($zoneId) { } + public static function createTimeZone(string $timezoneId): ?IntlTimeZone {} /** * (PHP 5 >=5.5.0)<br/> * Get an enumeration over system time zone IDs with the given filter conditions - * @link https://www.php.net/manual/en/intltimezone.createtimezoneidenumeration.php - * @param int $zoneType + * @link https://secure.php.net/manual/en/intltimezone.createtimezoneidenumeration.php + * @param int $type * @param string|null $region [optional] * @param int $rawOffset [optional] * @return IntlIterator|false an iterator or <b>FALSE</b> on failure */ - public static function createTimeZoneIDEnumeration($zoneType, $region = null, $rawOffset = 0) { } + public static function createTimeZoneIDEnumeration( + int $type, + string|null $region = null, + int|null $rawOffset = null + ): IntlIterator|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Create a timezone object from DateTimeZone - * @link https://www.php.net/manual/en/intltimezone.fromdatetimezone.php - * @param DateTimeZone $zoneId + * @link https://secure.php.net/manual/en/intltimezone.fromdatetimezone.php + * @param DateTimeZone $timezone * @return IntlTimeZone|null a timezone object or <b>NULL</b> on failure */ - public static function fromDateTimeZone($zoneId) { } + public static function fromDateTimeZone(DateTimeZone $timezone): ?IntlTimeZone {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the canonical system timezone ID or the normalized custom time zone ID for the given time zone ID - * @link https://www.php.net/manual/en/intltimezone.getcanonicalid.php - * @param string $zoneId - * @param bool $isSystemID [optional] + * @link https://secure.php.net/manual/en/intltimezone.getcanonicalid.php + * @param string $timezoneId + * @param bool &$isSystemId [optional] * @return string|false the timezone ID or <b>FALSE</b> on failure */ - public static function getCanonicalID($zoneId, &$isSystemID) { } + public static function getCanonicalID(string $timezoneId, &$isSystemId): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get a name of this time zone suitable for presentation to the user - * @param bool $isDaylight [optional] + * @param bool $dst [optional] * @param int $style [optional] * @param string $locale [optional] * @return string|false the timezone name or <b>FALSE</b> on failure */ - public function getDisplayName($isDaylight, $style, $locale) { } + public function getDisplayName( + bool $dst = false, + int $style = 2, + string|null $locale + ): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the amount of time to be added to local standard time to get local wall clock time - * @link https://www.php.net/manual/en/intltimezone.getequivalentid.php + * @link https://secure.php.net/manual/en/intltimezone.getequivalentid.php * @return int */ - public function getDSTSavings() { } + public function getDSTSavings(): int {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get an ID in the equivalency group that includes the given ID - * @link https://www.php.net/manual/en/intltimezone.getequivalentid.php - * @param string $zoneId - * @param int $index + * @link https://secure.php.net/manual/en/intltimezone.getequivalentid.php + * @param string $timezoneId + * @param int $offset * @return string|false the time zone ID or <b>FALSE</b> on failure */ - public static function getEquivalentID($zoneId, $index) { } + public static function getEquivalentID( + string $timezoneId, + int $offset + ): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get last error code on the object - * @link https://www.php.net/manual/en/intltimezone.geterrorcode.php - * @return int + * @link https://secure.php.net/manual/en/intltimezone.geterrorcode.php + * @return int|false */ - public function getErrorCode() { } + public function getErrorCode(): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get last error message on the object - * @link https://www.php.net/manual/en/intltimezone.geterrormessage.php - * @return string + * @link https://secure.php.net/manual/en/intltimezone.geterrormessage.php + * @return string|false */ - public function getErrorMessage() { } + public function getErrorMessage(): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Create GMT (UTC) timezone - * @link https://www.php.net/manual/en/intltimezone.getgmt.php + * @link https://secure.php.net/manual/en/intltimezone.getgmt.php * @return IntlTimeZone */ - public static function getGMT() { } + public static function getGMT(): IntlTimeZone {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get timezone ID - * @return string + * @return string|false */ - public function getID() { } + public function getID(): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the time zone raw and GMT offset for the given moment in time - * @link https://www.php.net/manual/en/intltimezone.getoffset.php - * @param float $date + * @link https://secure.php.net/manual/en/intltimezone.getoffset.php + * @param float $timestamp * moment in time for which to return offsets, in units of milliseconds from * January 1, 1970 0:00 GMT, either GMT time or local wall time, depending on * `local'. @@ -3183,76 +3435,95 @@ class IntlTimeZone { * typically one hour. * @return bool boolean indication of success */ - public function getOffset($date, $local, &$rawOffset, &$dstOffset) { } + public function getOffset( + float $timestamp, + bool $local, + &$rawOffset, + &$dstOffset + ): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the raw GMT offset (before taking daylight savings time into account - * @link https://www.php.net/manual/en/intltimezone.getrawoffset.php + * @link https://secure.php.net/manual/en/intltimezone.getrawoffset.php * @return int */ - public function getRawOffset() { } + public function getRawOffset(): int {} /** * (PHP 5 >=5.5.0)<br/> * Get the region code associated with the given system time zone ID - * @link https://www.php.net/manual/en/intltimezone.getregion.php - * @param string $zoneId + * @link https://secure.php.net/manual/en/intltimezone.getregion.php + * @param string $timezoneId * @return string|false region or <b>FALSE</b> on failure */ - public static function getRegion($zoneId) { } + public static function getRegion(string $timezoneId): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the timezone data version currently used by ICU - * @link https://www.php.net/manual/en/intltimezone.gettzdataversion.php - * @return string + * @link https://secure.php.net/manual/en/intltimezone.gettzdataversion.php + * @return string|false */ - public static function getTZDataVersion() { } + public static function getTZDataVersion(): string|false {} /** * (PHP 5 >=5.5.0)<br/> * Get the "unknown" time zone - * @link https://www.php.net/manual/en/intltimezone.getunknown.php + * @link https://secure.php.net/manual/en/intltimezone.getunknown.php * @return IntlTimeZone */ - public static function getUnknown() { } + public static function getUnknown(): IntlTimeZone {} /** * (PHP 7 >=7.1.0)<br/> * Translates a system timezone (e.g. "America/Los_Angeles") into a Windows * timezone (e.g. "Pacific Standard Time"). - * @link https://www.php.net/manual/en/intltimezone.getwindowsid.php - * @param string $timezone + * @link https://secure.php.net/manual/en/intltimezone.getwindowsid.php + * @param string $timezoneId + * @return string|false the Windows timezone or <b>FALSE</b> on failure + * @since 7.1 + */ + public static function getWindowsID(string $timezoneId): string|false {} + + /** + * @link https://www.php.net/manual/en/intltimezone.getidforwindowsid.php + * @param string $timezoneId + * @param string|null $region * @return string|false the Windows timezone or <b>FALSE</b> on failure * @since 7.1 */ - public static function getWindowsID($timezone) { } + public static function getIDForWindowsID(string $timezoneId, ?string $region = null): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Check if this zone has the same rules and offset as another zone - * @link https://www.php.net/manual/en/intltimezone.hassamerules.php - * @param IntlTimeZone $otherTimeZone + * @link https://secure.php.net/manual/en/intltimezone.hassamerules.php + * @param IntlTimeZone $other * @return bool */ - public function hasSameRules(IntlTimeZone $otherTimeZone) { } + public function hasSameRules(IntlTimeZone $other): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Convert to DateTimeZone object - * @link https://www.php.net/manual/ru/intltimezone.todatetimezone.php + * @link https://secure.php.net/manual/en/intltimezone.todatetimezone.php * @return DateTimeZone|false the DateTimeZone object or <b>FALSE</b> on failure */ - public function toDateTimeZone() { } + public function toDateTimeZone(): DateTimeZone|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Check if this time zone uses daylight savings time - * @link https://www.php.net/manual/ru/intltimezone.usedaylighttime.php + * @link https://secure.php.net/manual/en/intltimezone.usedaylighttime.php * @return bool */ - public function useDaylightTime() { } + public function useDaylightTime(): bool {} + + /** + * @since 8.4 + */ + public static function getIanaID(string $timezoneId): string|false {} } /** @@ -3265,76 +3536,76 @@ class IntlTimeZone { * default locale collation rules will be used. If empty string ("") or * "root" are passed, UCA rules will be used. * </p> - * @return Collator Return new instance of <b>Collator</b> object, or <b>NULL</b> + * @return Collator|null Return new instance of <b>Collator</b> object, or <b>NULL</b> * on error. */ -function collator_create($locale) { } +function collator_create(string $locale): ?Collator {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Compare two Unicode strings * @link https://php.net/manual/en/collator.compare.php * @param Collator $object - * @param string $str1 <p> + * @param string $string1 <p> * The first string to compare. * </p> - * @param string $str2 <p> + * @param string $string2 <p> * The second string to compare. * </p> - * @return int Return comparison result:</p> + * @return int|false Return comparison result:</p> * <p> * <p> - * 1 if <i>str1</i> is greater than - * <i>str2</i> ; + * 1 if <i>string1</i> is greater than + * <i>string2</i> ; * </p> * <p> - * 0 if <i>str1</i> is equal to - * <i>str2</i>; + * 0 if <i>string1</i> is equal to + * <i>string2</i>; * </p> * <p> - * -1 if <i>str1</i> is less than - * <i>str2</i> . + * -1 if <i>string1</i> is less than + * <i>string2</i> . * </p> * On error * boolean * <b>FALSE</b> * is returned. */ -function collator_compare(Collator $object, $str1, $str2) { } +function collator_compare(Collator $object, string $string1, string $string2): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get collation attribute value * @link https://php.net/manual/en/collator.getattribute.php * @param Collator $object - * @param int $attr <p> + * @param int $attribute <p> * Attribute to get value for. * </p> * @return int|false Attribute value, or boolean <b>FALSE</b> on error. */ -function collator_get_attribute(Collator $object, $attr) { } +function collator_get_attribute(Collator $object, int $attribute): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Set collation attribute * @link https://php.net/manual/en/collator.setattribute.php * @param Collator $object - * @param int $attr <p>Attribute.</p> - * @param int $val <p> + * @param int $attribute <p>Attribute.</p> + * @param int $value <p> * Attribute value. * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ -function collator_set_attribute(Collator $object, $attr, $val) { } +function collator_set_attribute(Collator $object, int $attribute, int $value): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get current collation strength * @link https://php.net/manual/en/collator.getstrength.php * @param Collator $object - * @return int|false current collation strength, or boolean <b>FALSE</b> on error. + * @return int current collation strength */ -function collator_get_strength(Collator $object) { } +function collator_get_strength(Collator $object): int {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3344,105 +3615,108 @@ function collator_get_strength(Collator $object) { } * @param int $strength <p>Strength to set.</p> * <p> * Possible values are: - * <p> * <b>Collator::PRIMARY</b> * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ -function collator_set_strength(Collator $object, $strength) { } +function collator_set_strength(Collator $object, int $strength): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Sort array using specified collator * @link https://php.net/manual/en/collator.sort.php * @param Collator $object - * @param array $arr <p> + * @param string[] &$array <p> * Array of strings to sort. * </p> - * @param int $sort_flag [optional] <p> + * @param int $flags <p> * Optional sorting type, one of the following: * </p> * <p> - * <p> * <b>Collator::SORT_REGULAR</b> * - compare items normally (don't change types) * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ -function collator_sort(Collator $object, array &$arr, $sort_flag = null) { } +function collator_sort(Collator $object, array &$array, int $flags = 0): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Sort array using specified collator and sort keys * @link https://php.net/manual/en/collator.sortwithsortkeys.php * @param Collator $object - * @param array $arr <p>Array of strings to sort</p> + * @param string[] &$array <p>Array of strings to sort</p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ -function collator_sort_with_sort_keys(Collator $object, array &$arr) { } +function collator_sort_with_sort_keys( + Collator $object, + array &$array, +): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Sort array maintaining index association * @link https://php.net/manual/en/collator.asort.php * @param Collator $object - * @param array $arr <p>Array of strings to sort.</p> - * @param int $sort_flag [optional] <p> + * @param string[] &$array <p>Array of strings to sort.</p> + * @param int $flags <p> * Optional sorting type, one of the following: - * <p> * <b>Collator::SORT_REGULAR</b> * - compare items normally (don't change types) * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ -function collator_asort(Collator $object, array &$arr, $sort_flag = null) { } +function collator_asort(Collator $object, array &$array, int $flags = 0): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the locale name of the collator * @link https://php.net/manual/en/collator.getlocale.php * @param Collator $object - * @param int $type [optional] <p> + * @param int $type <p> * You can choose between valid and actual locale ( * <b>Locale::VALID_LOCALE</b> and * <b>Locale::ACTUAL_LOCALE</b>, * respectively). The default is the actual locale. * </p> - * @return string Real locale name from which the collation data comes. If the collator was + * @return string|false Real locale name from which the collation data comes. If the collator was * instantiated from rules or an error occurred, returns * boolean <b>FALSE</b>. */ -function collator_get_locale(Collator $object, $type = null) { } +function collator_get_locale(Collator $object, int $type): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get collator's last error code * @link https://php.net/manual/en/collator.geterrorcode.php * @param Collator $object - * @return int Error code returned by the last Collator API function call. + * @return int|false Error code returned by the last Collator API function call. */ -function collator_get_error_code(Collator $object) { } +function collator_get_error_code(Collator $object): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get text for collator's last error code * @link https://php.net/manual/en/collator.geterrormessage.php * @param Collator $object - * @return string Description of an error occurred in the last Collator API function call. + * @return string|false Description of an error occurred in the last Collator API function call. */ -function collator_get_error_message(Collator $object) { } +function collator_get_error_message(Collator $object): string|false {} /** - * (No version information available, might only be in SVN)<br/> + * (PHP 5 >= 5.3.2, PHP 7, PECL intl >= 1.0.3)<br/> * Get sorting key for a string * @link https://php.net/manual/en/collator.getsortkey.php * @param Collator $object - * @param string $str <p> + * @param string $string <p> * The string to produce the key from. * </p> - * @return string the collation key for the string. Collation keys can be compared directly instead of strings. + * @return string|false the collation key for the string. Collation keys can be compared directly instead of strings. */ -function collator_get_sort_key(Collator $object, $str) { } +function collator_get_sort_key( + Collator $object, + string $string, +): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3463,117 +3737,117 @@ function collator_get_sort_key(Collator $object, $str) { } * ICU RuleBasedNumberFormat * documentation, respectively. * </p> - * @param string $pattern [optional] <p> + * @param string|null $pattern [optional] <p> * Pattern string if the chosen style requires a pattern. * </p> - * @return NumberFormatter|false <b>NumberFormatter</b> object or <b>FALSE</b> on error. + * @return NumberFormatter|null <b>NumberFormatter</b> object or <b>NULL</b> on error. */ -function numfmt_create($locale, $style, $pattern = null) { } +function numfmt_create(string $locale, int $style, ?string $pattern = null): ?NumberFormatter {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Format a number * @link https://php.net/manual/en/numberformatter.format.php - * @param NumberFormatter $fmt - * @param int|float $value <p> + * @param NumberFormatter $formatter + * @param int|float $num <p> * The value to format. Can be integer or float, * other values will be converted to a numeric value. * </p> - * @param int $type [optional] <p> + * @param int $type <p> * The * formatting type to use. * </p> * @return string|false the string containing formatted value, or <b>FALSE</b> on error. */ -function numfmt_format(NumberFormatter $fmt, $value, $type = null) { } +function numfmt_format(NumberFormatter $formatter, int|float $num, int $type = 0): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Parse a number * @link https://php.net/manual/en/numberformatter.parse.php - * @param NumberFormatter $fmt - * @param string $value + * @param NumberFormatter $formatter + * @param string $string * @param int $type [optional] <p> * The * formatting type to use. By default, * <b>NumberFormatter::TYPE_DOUBLE</b> is used. * </p> - * @param int $position [optional] <p> + * @param int &$offset [optional] <p> * Offset in the string at which to begin parsing. On return, this value * will hold the offset at which parsing ended. * </p> - * @return mixed The value of the parsed number or <b>FALSE</b> on error. + * @return int|float|false The value of the parsed number or <b>FALSE</b> on error. */ -function numfmt_parse(NumberFormatter $fmt, $value, $type = null, &$position = null) { } +function numfmt_parse(NumberFormatter $formatter, string $string, int $type = NumberFormatter::TYPE_DOUBLE, &$offset = null): int|float|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Format a currency value * @link https://php.net/manual/en/numberformatter.formatcurrency.php - * @param NumberFormatter $fmt - * @param float $value <p> + * @param NumberFormatter $formatter + * @param float $amount <p> * The numeric currency value. * </p> * @param string $currency <p> * The 3-letter ISO 4217 currency code indicating the currency to use. * </p> - * @return string String representing the formatted currency value. + * @return string|false String representing the formatted currency value. */ -function numfmt_format_currency(NumberFormatter $fmt, $value, $currency) { } +function numfmt_format_currency(NumberFormatter $formatter, float $amount, string $currency): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Parse a currency number * @link https://php.net/manual/en/numberformatter.parsecurrency.php - * @param NumberFormatter $fmt - * @param string $value - * @param string $currency <p> + * @param NumberFormatter $formatter + * @param string $string + * @param string &$currency <p> * Parameter to receive the currency name (3-letter ISO 4217 currency * code). * </p> - * @param int $position [optional] <p> + * @param int &$offset [optional] <p> * Offset in the string at which to begin parsing. On return, this value * will hold the offset at which parsing ended. * </p> * @return float|false The parsed numeric value or <b>FALSE</b> on error. */ -function numfmt_parse_currency(NumberFormatter $fmt, $value, &$currency, &$position = null) { } +function numfmt_parse_currency(NumberFormatter $formatter, string $string, &$currency, &$offset = null): float|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Set an attribute * @link https://php.net/manual/en/numberformatter.setattribute.php - * @param NumberFormatter $fmt - * @param int $attr <p> + * @param NumberFormatter $formatter + * @param int $attribute <p> * Attribute specifier - one of the * numeric attribute constants. * </p> - * @param int $value <p> + * @param int|float $value <p> * The attribute value. * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ -function numfmt_set_attribute(NumberFormatter $fmt, $attr, $value) { } +function numfmt_set_attribute(NumberFormatter $formatter, int $attribute, int|float $value): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get an attribute * @link https://php.net/manual/en/numberformatter.getattribute.php - * @param NumberFormatter $fmt - * @param int $attr <p> + * @param NumberFormatter $formatter + * @param int $attribute <p> * Attribute specifier - one of the * numeric attribute constants. * </p> - * @return int|false Return attribute value on success, or <b>FALSE</b> on error. + * @return int|float|false Return attribute value on success, or <b>FALSE</b> on error. */ -function numfmt_get_attribute(NumberFormatter $fmt, $attr) { } +function numfmt_get_attribute(NumberFormatter $formatter, int $attribute): int|float|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Set a text attribute * @link https://php.net/manual/en/numberformatter.settextattribute.php - * @param NumberFormatter $fmt - * @param int $attr <p> + * @param NumberFormatter $formatter + * @param int $attribute <p> * Attribute specifier - one of the * text attribute * constants. @@ -3583,27 +3857,27 @@ function numfmt_get_attribute(NumberFormatter $fmt, $attr) { } * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ -function numfmt_set_text_attribute(NumberFormatter $fmt, $attr, $value) { } +function numfmt_set_text_attribute(NumberFormatter $formatter, int $attribute, string $value): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get a text attribute * @link https://php.net/manual/en/numberformatter.gettextattribute.php - * @param NumberFormatter $fmt - * @param int $attr <p> + * @param NumberFormatter $formatter + * @param int $attribute <p> * Attribute specifier - one of the * text attribute constants. * </p> * @return string|false Return attribute value on success, or <b>FALSE</b> on error. */ -function numfmt_get_text_attribute(NumberFormatter $fmt, $attr) { } +function numfmt_get_text_attribute(NumberFormatter $formatter, int $attribute): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Set a symbol value * @link https://php.net/manual/en/numberformatter.setsymbol.php - * @param NumberFormatter $fmt - * @param int $attr <p> + * @param NumberFormatter $formatter + * @param int $symbol <p> * Symbol specifier, one of the * format symbol constants. * </p> @@ -3612,26 +3886,26 @@ function numfmt_get_text_attribute(NumberFormatter $fmt, $attr) { } * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ -function numfmt_set_symbol(NumberFormatter $fmt, $attr, $value) { } +function numfmt_set_symbol(NumberFormatter $formatter, int $symbol, string $value): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get a symbol value * @link https://php.net/manual/en/numberformatter.getsymbol.php - * @param NumberFormatter $fmt - * @param int $attr <p> + * @param NumberFormatter $formatter + * @param int $symbol <p> * Symbol specifier, one of the * format symbol constants. * </p> * @return string|false The symbol string or <b>FALSE</b> on error. */ -function numfmt_get_symbol(NumberFormatter $fmt, $attr) { } +function numfmt_get_symbol(NumberFormatter $formatter, int $symbol): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Set formatter pattern * @link https://php.net/manual/en/numberformatter.setpattern.php - * @param NumberFormatter $fmt + * @param NumberFormatter $formatter * @param string $pattern <p> * Pattern in syntax described in * ICU DecimalFormat @@ -3639,94 +3913,91 @@ function numfmt_get_symbol(NumberFormatter $fmt, $attr) { } * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ -function numfmt_set_pattern(NumberFormatter $fmt, $pattern) { } +function numfmt_set_pattern(NumberFormatter $formatter, string $pattern): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get formatter pattern * @link https://php.net/manual/en/numberformatter.getpattern.php - * @param NumberFormatter $fmt - * @param $nf + * @param NumberFormatter $formatter * @return string|false Pattern string that is used by the formatter, or <b>FALSE</b> if an error happens. */ -function numfmt_get_pattern(NumberFormatter $fmt, $nf) { } +function numfmt_get_pattern(NumberFormatter $formatter): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get formatter locale * @link https://php.net/manual/en/numberformatter.getlocale.php - * @param NumberFormatter $fmt - * @param int $type [optional] <p> + * @param NumberFormatter $formatter + * @param int $type <p> * You can choose between valid and actual locale ( * <b>Locale::VALID_LOCALE</b>, * <b>Locale::ACTUAL_LOCALE</b>, * respectively). The default is the actual locale. * </p> - * @return string The locale name used to create the formatter. + * @return string|false The locale name used to create the formatter. */ -function numfmt_get_locale(NumberFormatter $fmt, $type = null) { } +function numfmt_get_locale(NumberFormatter $formatter, int $type = 0): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get formatter's last error code. * @link https://php.net/manual/en/numberformatter.geterrorcode.php - * @param NumberFormatter $fmt - * @param $nf + * @param NumberFormatter $formatter * @return int error code from last formatter call. */ -function numfmt_get_error_code(NumberFormatter $fmt, $nf) { } +function numfmt_get_error_code(NumberFormatter $formatter): int {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get formatter's last error message. * @link https://php.net/manual/en/numberformatter.geterrormessage.php - * @param NumberFormatter $fmt - * @param $nf + * @param NumberFormatter $formatter * @return string error message from last formatter call. */ -function numfmt_get_error_message(NumberFormatter $fmt, $nf) { } +function numfmt_get_error_message(NumberFormatter $formatter): string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Normalizes the input provided and returns the normalized string * @link https://php.net/manual/en/normalizer.normalize.php - * @param string $input <p>The input string to normalize</p> - * @param string $form [optional] <p>One of the normalization forms.</p> - * @return string The normalized string or <b>NULL</b> if an error occurred. + * @param string $string <p>The input string to normalize</p> + * @param int $form [optional] <p>One of the normalization forms.</p> + * @return string|false The normalized string or <b>FALSE</b> if an error occurred. */ -function normalizer_normalize($input, $form = Normalizer::FORM_C) { } +function normalizer_normalize(string $string, int $form = Normalizer::FORM_C): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Checks if the provided string is already in the specified normalization -form. + * form. * @link https://php.net/manual/en/normalizer.isnormalized.php - * @param string $input <p>The input string to normalize</p> - * @param string $form [optional] <p> + * @param string $string <p>The input string to normalize</p> + * @param int $form [optional] <p> * One of the normalization forms. * </p> * @return bool <b>TRUE</b> if normalized, <b>FALSE</b> otherwise or if there an error */ -function normalizer_is_normalized($input, $form = Normalizer::FORM_C) { } +function normalizer_is_normalized(string $string, int $form = Normalizer::FORM_C): bool {} /** - * Get the default Locale + * Gets the default locale value from the intl global 'default_locale' * @link https://php.net/manual/en/function.locale-get-default.php * @return string a string with the current Locale. */ -function locale_get_default() { } +function locale_get_default(): string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> - * Set the default Locale + * Set the default runtime Locale * @link https://php.net/manual/en/function.locale-set-default.php - * @param string $name <p> + * @param string $locale <p> * The new Locale name. A comprehensive list of the supported locales is * available at . * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ -function locale_set_default($name) { } +function locale_set_default(string $locale): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3735,9 +4006,9 @@ function locale_set_default($name) { } * @param string $locale <p> * The locale to extract the primary language code from * </p> - * @return string The language code associated with the language or <b>NULL</b> in case of error. + * @return string|null The language code associated with the language or <b>NULL</b> in case of error. */ -function locale_get_primary_language($locale) { } +function locale_get_primary_language(string $locale): ?string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3746,9 +4017,9 @@ function locale_get_primary_language($locale) { } * @param string $locale <p> * The locale to extract the script code from * </p> - * @return string The script subtag for the locale or <b>NULL</b> if not present + * @return string|null The script subtag for the locale or <b>NULL</b> if not present */ -function locale_get_script($locale) { } +function locale_get_script(string $locale): ?string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3757,9 +4028,9 @@ function locale_get_script($locale) { } * @param string $locale <p> * The locale to extract the region code from * </p> - * @return string The region subtag for the locale or <b>NULL</b> if not present + * @return string|null The region subtag for the locale or <b>NULL</b> if not present */ -function locale_get_region($locale) { } +function locale_get_region(string $locale): ?string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3768,9 +4039,9 @@ function locale_get_region($locale) { } * @param string $locale <p> * The locale to extract the keywords from * </p> - * @return array Associative array containing the keyword-value pairs for this locale + * @return array|false|null Associative array containing the keyword-value pairs for this locale */ -function locale_get_keywords($locale) { } +function locale_get_keywords(string $locale): array|false|null {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3779,13 +4050,16 @@ function locale_get_keywords($locale) { } * @param string $locale <p> * The locale to return a display script for * </p> - * @param string $in_locale [optional] <p> + * @param string|null $displayLocale <p> * Optional format locale to use to display the script name * </p> - * @return string Display name of the script for the $locale in the format appropriate for + * @return string|false Display name of the script for the $locale in the format appropriate for * $in_locale. */ -function locale_get_display_script($locale, $in_locale = null) { } +function locale_get_display_script( + string $locale, + ?string $displayLocale = null +): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3794,13 +4068,16 @@ function locale_get_display_script($locale, $in_locale = null) { } * @param string $locale <p> * The locale to return a display region for. * </p> - * @param string $in_locale [optional] <p> + * @param string|null $displayLocale <p> * Optional format locale to use to display the region name * </p> - * @return string display name of the region for the $locale in the format appropriate for + * @return string|false display name of the region for the $locale in the format appropriate for * $in_locale. */ -function locale_get_display_region($locale, $in_locale = null) { } +function locale_get_display_region( + string $locale, + ?string $displayLocale = null +): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3809,10 +4086,13 @@ function locale_get_display_region($locale, $in_locale = null) { } * @param string $locale <p> * The locale to return a display name for. * </p> - * @param string $in_locale [optional] <p>optional format locale</p> - * @return string Display name of the locale in the format appropriate for $in_locale. + * @param string|null $displayLocale <p>optional format locale</p> + * @return string|false Display name of the locale in the format appropriate for $in_locale. */ -function locale_get_display_name($locale, $in_locale = null) { } +function locale_get_display_name( + string $locale, + ?string $displayLocale = null +): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3821,13 +4101,16 @@ function locale_get_display_name($locale, $in_locale = null) { } * @param string $locale <p> * The locale to return a display language for * </p> - * @param string $in_locale [optional] <p> + * @param string|null $displayLocale <p> * Optional format locale to use to display the language name * </p> - * @return string display name of the language for the $locale in the format appropriate for + * @return string|false display name of the language for the $locale in the format appropriate for * $in_locale. */ -function locale_get_display_language($locale, $in_locale = null) { } +function locale_get_display_language( + string $locale, + ?string $displayLocale = null +): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3836,19 +4119,22 @@ function locale_get_display_language($locale, $in_locale = null) { } * @param string $locale <p> * The locale to return a display variant for * </p> - * @param string $in_locale [optional] <p> + * @param string|null $displayLocale <p> * Optional format locale to use to display the variant name * </p> - * @return string Display name of the variant for the $locale in the format appropriate for + * @return string|false Display name of the variant for the $locale in the format appropriate for * $in_locale. */ -function locale_get_display_variant($locale, $in_locale = null) { } +function locale_get_display_variant( + string $locale, + ?string $displayLocale = null +): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Returns a correctly ordered and delimited locale ID * @link https://php.net/manual/en/locale.composelocale.php - * @param array $subtags <p> + * @param string[] $subtags <p> * an array containing a list of key-value pairs, where the keys identify * the particular locale ID subtags, and the values are the associated * subtag values. @@ -3866,9 +4152,9 @@ function locale_get_display_variant($locale, $in_locale = null) { } * (e.g. 'variant0', 'variant1', etc.). * </p> * </p> - * @return string The corresponding locale identifier. + * @return string|false The corresponding locale identifier. */ -function locale_compose(array $subtags) { } +function locale_compose(array $subtags): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3879,14 +4165,14 @@ function locale_compose(array $subtags) { } * 'private' subtags can take maximum 15 values whereas 'extlang' can take * maximum 3 values. * </p> - * @return array an array containing a list of key-value pairs, where the keys + * @return string[]|null an array containing a list of key-value pairs, where the keys * identify the particular locale ID subtags, and the values are the * associated subtag values. The array will be ordered as the locale id * subtags e.g. in the locale id if variants are '-varX-varY-varZ' then the * returned array will have variant0=>varX , variant1=>varY , * variant2=>varZ */ -function locale_parse($locale) { } +function locale_parse(string $locale): ?array {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3895,55 +4181,67 @@ function locale_parse($locale) { } * @param string $locale <p> * The locale to extract the variants from * </p> - * @return array The array containing the list of all variants subtag for the locale + * @return array|null The array containing the list of all variants subtag for the locale * or <b>NULL</b> if not present */ -function locale_get_all_variants($locale) { } +function locale_get_all_variants(string $locale): ?array {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Checks if a language tag filter matches with locale * @link https://php.net/manual/en/locale.filtermatches.php - * @param string $langtag <p> + * @param string $languageTag <p> * The language tag to check * </p> * @param string $locale <p> * The language range to check against * </p> - * @param bool $canonicalize [optional] <p> + * @param bool $canonicalize <p> * If true, the arguments will be converted to canonical form before * matching. * </p> - * @return bool <b>TRUE</b> if $locale matches $langtag <b>FALSE</b> otherwise. + * @return bool|null <b>TRUE</b> if $locale matches $langtag <b>FALSE</b> otherwise. */ -function locale_filter_matches($langtag, $locale, $canonicalize = false) { } +function locale_filter_matches( + string $languageTag, + string $locale, + bool $canonicalize = false +): ?bool {} /** - * @param $arg1 + * Canonicalize the locale string + * @param string $locale + * + * @return null|string */ -function locale_canonicalize($arg1) { } +function locale_canonicalize(string $locale): ?string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Searches the language tag list for the best match to the language * @link https://php.net/manual/en/locale.lookup.php - * @param array $langtag <p> + * @param string[] $languageTag <p> * An array containing a list of language tags to compare to * <i>locale</i>. Maximum 100 items allowed. * </p> * @param string $locale <p> * The locale to use as the language range when matching. * </p> - * @param bool $canonicalize [optional] <p> + * @param bool $canonicalize <p> * If true, the arguments will be converted to canonical form before * matching. * </p> - * @param string $default [optional] <p> + * @param string|null $defaultLocale <p> * The locale to use if no match is found. * </p> - * @return string The closest matching language tag or default value. + * @return string|null The closest matching language tag or default value. */ -function locale_lookup(array $langtag, $locale, $canonicalize = false, $default = null) { } +function locale_lookup( + array $languageTag, + string $locale, + bool $canonicalize = false, + ?string $defaultLocale = null, +): ?string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3952,27 +4250,29 @@ function locale_lookup(array $langtag, $locale, $canonicalize = false, $default * @param string $header <p> * The string containing the "Accept-Language" header according to format in RFC 2616. * </p> - * @return string The corresponding locale identifier. + * @return string|false The corresponding locale identifier. */ -function locale_accept_from_http($header) { } +function locale_accept_from_http(string $header): string|false {} /** - * @param $locale - * @param $pattern + * Constructs a new message formatter + * @param string $locale + * @param string $pattern + * @return MessageFormatter|null */ -function msgfmt_create($locale, $pattern) { } +function msgfmt_create(string $locale, string $pattern): ?MessageFormatter {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Format the message * @link https://php.net/manual/en/messageformatter.format.php - * @param MessageFormatter $fmt - * @param array $args <p> + * @param MessageFormatter $formatter + * @param array $values <p> * Arguments to insert into the format string * </p> * @return string|false The formatted string, or <b>FALSE</b> if an error occurred */ -function msgfmt_format(MessageFormatter $fmt, array $args) { } +function msgfmt_format(MessageFormatter $formatter, array $values): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -3987,48 +4287,47 @@ function msgfmt_format(MessageFormatter $fmt, array $args) { } * umsg_autoQuoteApostrophe * before being interpreted. * </p> - * @param array $args <p> + * @param array $values <p> * The array of values to insert into the format string * </p> * @return string|false The formatted pattern string or <b>FALSE</b> if an error occurred */ -function msgfmt_format_message(string $locale, string $pattern, array $args) { } +function msgfmt_format_message(string $locale, string $pattern, array $values): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Parse input string according to pattern * @link https://php.net/manual/en/messageformatter.parse.php - * @param MessageFormatter $fmt - * @param string $value <p> + * @param MessageFormatter $formatter + * @param string $string <p> * The string to parse * </p> * @return array|false An array containing the items extracted, or <b>FALSE</b> on error */ -function msgfmt_parse(MessageFormatter $fmt, $value) { } +function msgfmt_parse(MessageFormatter $formatter, string $string): array|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Quick parse input string * @link https://php.net/manual/en/messageformatter.parsemessage.php - * @param MessageFormatter $fmt * @param string $locale <p> * The locale to use for parsing locale-dependent parts * </p> * @param string $pattern <p> * The pattern with which to parse the <i>value</i>. * </p> - * @param string $source <p> + * @param string $message <p> * The string to parse, conforming to the <i>pattern</i>. * </p> * @return array|false An array containing items extracted, or <b>FALSE</b> on error */ -function msgfmt_parse_message(MessageFormatter $fmt, $locale, $pattern, $source) { } +function msgfmt_parse_message(string $locale, string $pattern, string $message): array|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Set the pattern used by the formatter * @link https://php.net/manual/en/messageformatter.setpattern.php - * @param MessageFormatter $fmt + * @param MessageFormatter $formatter * @param string $pattern <p> * The pattern string to use in this message formatter. * The pattern uses an 'apostrophe-friendly' syntax; it is run through @@ -4037,47 +4336,43 @@ function msgfmt_parse_message(MessageFormatter $fmt, $locale, $pattern, $source) * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ -function msgfmt_set_pattern(MessageFormatter $fmt, $pattern) { } +function msgfmt_set_pattern(MessageFormatter $formatter, string $pattern): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the pattern used by the formatter * @link https://php.net/manual/en/messageformatter.getpattern.php - * @param MessageFormatter $fmt - * @param $mf - * @return string The pattern string for this message formatter + * @param MessageFormatter $formatter + * @return string|false The pattern string for this message formatter */ -function msgfmt_get_pattern(MessageFormatter $fmt, $mf) { } +function msgfmt_get_pattern(MessageFormatter $formatter): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the locale for which the formatter was created. * @link https://php.net/manual/en/messageformatter.getlocale.php - * @param MessageFormatter $fmt - * @param $mf + * @param MessageFormatter $formatter * @return string The locale name */ -function msgfmt_get_locale(MessageFormatter $fmt, $mf) { } +function msgfmt_get_locale(MessageFormatter $formatter): string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the error code from last operation * @link https://php.net/manual/en/messageformatter.geterrorcode.php - * @param MessageFormatter $fmt - * @param $nf + * @param MessageFormatter $formatter * @return int The error code, one of UErrorCode values. Initial value is U_ZERO_ERROR. */ -function msgfmt_get_error_code(MessageFormatter $fmt, $nf) { } +function msgfmt_get_error_code(MessageFormatter $formatter): int {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the error text from the last operation * @link https://php.net/manual/en/messageformatter.geterrormessage.php - * @param MessageFormatter $fmt - * @param $coll + * @param MessageFormatter $formatter * @return string Description of the last error. */ -function msgfmt_get_error_message(MessageFormatter $fmt, $coll) { } +function msgfmt_get_error_message(MessageFormatter $formatter): string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -4086,14 +4381,14 @@ function msgfmt_get_error_message(MessageFormatter $fmt, $coll) { } * @param string|null $locale <p> * Locale to use when formatting or parsing. * </p> - * @param int $datetype <p> + * @param int $dateType <p> * Date type to use (<b>none</b>, * <b>short</b>, <b>medium</b>, * <b>long</b>, <b>full</b>). * This is one of the * IntlDateFormatter constants. * </p> - * @param int $timetype <p> + * @param int $timeType <p> * Time type to use (<b>none</b>, * <b>short</b>, <b>medium</b>, * <b>long</b>, <b>full</b>). @@ -4103,164 +4398,160 @@ function msgfmt_get_error_message(MessageFormatter $fmt, $coll) { } * @param string|null $timezone [optional] <p> * Time zone ID, default is system default. * </p> - * @param int|null $calendar [optional] <p> + * @param IntlCalendar|int|null $calendar [optional] <p> * Calendar to use for formatting or parsing; default is Gregorian. * This is one of the * IntlDateFormatter calendar constants. * </p> - * @param string $pattern [optional] <p> + * @param string|null $pattern [optional] <p> * Optional pattern to use when formatting or parsing. * Possible patterns are documented at http://userguide.icu-project.org/formatparse/datetime. * </p> - * @return IntlDateFormatter + * @return IntlDateFormatter|null */ -function datefmt_create($locale, $datetype, $timetype, $timezone = null, $calendar = null, $pattern = '') { } +function datefmt_create( + ?string $locale, + int $dateType = 0, + int $timeType = 0, + $timezone = null, + IntlCalendar|int|null $calendar = null, + string|null $pattern = null +): ?IntlDateFormatter {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the datetype used for the IntlDateFormatter * @link https://php.net/manual/en/intldateformatter.getdatetype.php - * @param $mf - * @return int The current date type value of the formatter. + * @param IntlDateFormatter $formatter + * @return int|false The current date type value of the formatter. */ -function datefmt_get_datetype(MessageFormatter $mf) { } +function datefmt_get_datetype(IntlDateFormatter $formatter): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the timetype used for the IntlDateFormatter * @link https://php.net/manual/en/intldateformatter.gettimetype.php - * @param $mf - * @return int The current date type value of the formatter. + * @param IntlDateFormatter $formatter + * @return int|false The current date type value of the formatter. */ -function datefmt_get_timetype(MessageFormatter $mf) { } +function datefmt_get_timetype(IntlDateFormatter $formatter): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> - * Get the calendar used for the IntlDateFormatter + * Get the calendar type used for the IntlDateFormatter * @link https://php.net/manual/en/intldateformatter.getcalendar.php - * @param $mf - * @return int The calendar being used by the formatter. + * @param IntlDateFormatter $formatter + * @return int|false The calendar being used by the formatter. */ -function datefmt_get_calendar(MessageFormatter $mf) { } +function datefmt_get_calendar(IntlDateFormatter $formatter): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * sets the calendar used to the appropriate calendar, which must be * @link https://php.net/manual/en/intldateformatter.setcalendar.php - * @param MessageFormatter $mf - * @param int $which <p> + * @param IntlDateFormatter $formatter $mf + * @param IntlCalendar|int|null $calendar <p> * The calendar to use. * Default is <b>IntlDateFormatter::GREGORIAN</b>. * </p> * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. */ -function datefmt_set_calendar(MessageFormatter $mf, $which) { } +function datefmt_set_calendar(IntlDateFormatter $formatter, IntlCalendar|int|null $calendar): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the locale used by formatter * @link https://php.net/manual/en/intldateformatter.getlocale.php - * @param MessageFormatter $mf - * @param int $which [optional] + * @param IntlDateFormatter $formatter + * @param int $type [optional] * @return string|false the locale of this formatter or 'false' if error */ -function datefmt_get_locale(MessageFormatter $mf, $which = null) { } +function datefmt_get_locale( + IntlDateFormatter $formatter, + int $type = ULOC_ACTUAL_LOCALE +): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the timezone-id used for the IntlDateFormatter * @link https://php.net/manual/en/intldateformatter.gettimezoneid.php - * @param $mf - * @return string ID string for the time zone used by this formatter. + * @param IntlDateFormatter $formatter + * @return string|false ID string for the time zone used by this formatter. */ -function datefmt_get_timezone_id(MessageFormatter $mf) { } +function datefmt_get_timezone_id(IntlDateFormatter $formatter): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 3.0.0)<br/> * Get copy of formatter's calendar object - * @link https://www.php.net/manual/en/intldateformatter.getcalendarobject.php - * @return IntlCalendar A copy of the internal calendar object used by this formatter. + * @link https://secure.php.net/manual/en/intldateformatter.getcalendarobject.php + * @param IntlDateFormatter $formatter + * @return IntlCalendar|false|null A copy of the internal calendar object used by this formatter. */ -function datefmt_get_calendar_object() { } +function datefmt_get_calendar_object(IntlDateFormatter $formatter): IntlCalendar|false|null {} /** * (PHP 5 >= 5.5.0, PECL intl >= 3.0.0)<br/> * Get formatter's timezone - * @link https://www.php.net/manual/en/intldateformatter.gettimezone.php + * @link https://secure.php.net/manual/en/intldateformatter.gettimezone.php + * @param IntlDateFormatter $formatter * @return IntlTimeZone|false The associated IntlTimeZone object or FALSE on failure. */ -function datefmt_get_timezone() { } - -/** - * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> - * Sets the time zone to use - * @link https://php.net/manual/en/intldateformatter.settimezoneid.php - * @param MessageFormatter $mf - * @param string $zone <p> - * The time zone ID string of the time zone to use. - * If <b>NULL</b> or the empty string, the default time zone for the runtime is used. - * </p> - * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. - * @deprecated 5.5 https://www.php.net/manual/en/migration55.deprecated.php - * @removed 7.0 - */ -function datefmt_set_timezone_id(MessageFormatter $mf, $zone) { } - +function datefmt_get_timezone(IntlDateFormatter $formatter): IntlTimeZone|false {} /** * (PHP 5 >= 5.5.0, PECL intl >= 3.0.0)<br/> * Sets formatter's timezone * @link https://php.net/manual/en/intldateformatter.settimezone.php - * @param MessageFormatter $mf - * @param mixed $zone <p> + * @param IntlDateFormatter $formatter + * @param IntlTimeZone|DateTimeZone|string|null $timezone <p> * The timezone to use for this formatter. This can be specified in the * following forms: * <ul> * <li> * <p> * <b>NULL</b>, in which case the default timezone will be used, as specified in - * the ini setting {@link "https://www.php.net/manual/en/datetime.configuration.php#ini.date.timezone" date.timezone} or - * through the function {@link "https://www.php.net/manual/en/function.date-default-timezone-set.php" date_default_timezone_set()} and as - * returned by {@link "https://www.php.net/manual/en/function.date-default-timezone-get.php" date_default_timezone_get()}. + * the ini setting {@link "https://secure.php.net/manual/en/datetime.configuration.php#ini.date.timezone" date.timezone} or + * through the function {@link "https://secure.php.net/manual/en/function.date-default-timezone-set.php" date_default_timezone_set()} and as + * returned by {@link "https://secure.php.net/manual/en/function.date-default-timezone-get.php" date_default_timezone_get()}. * </p> * </li> * <li> * <p> - * An {@link "https://www.php.net/manual/en/class.intltimezone.php" IntlTimeZone}, which will be used directly. + * An {@link "https://secure.php.net/manual/en/class.intltimezone.php" IntlTimeZone}, which will be used directly. * </p> * </li> * <li> * <p> - * A {@link "https://www.php.net/manual/en/class.datetimezone.php" DateTimeZone}. Its identifier will be extracted + * A {@link "https://secure.php.net/manual/en/class.datetimezone.php" DateTimeZone}. Its identifier will be extracted * and an ICU timezone object will be created; the timezone will be backed * by ICU's database, not PHP's. * </p> * </li> * <li> * <p> - * A {@link "https://www.php.net/manual/en/language.types.string.php" string}, which should be a valid ICU timezone identifier. + * A {@link "https://secure.php.net/manual/en/language.types.string.php" string}, which should be a valid ICU timezone identifier. * See <b>IntlTimeZone::createTimeZoneIDEnumeration()</b>. Raw offsets such as <em>"GMT+08:30"</em> are also accepted. * </p> * </li> * </ul> * </p> - * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. + * @return bool|null <b>TRUE</b> on success or <b>FALSE</b> on failure. */ -function datefmt_set_timezone(MessageFormatter $mf, $zone) { } +function datefmt_set_timezone(IntlDateFormatter $formatter, $timezone): bool|null {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the pattern used for the IntlDateFormatter * @link https://php.net/manual/en/intldateformatter.getpattern.php - * @param $mf - * @return string The pattern string being used to format/parse. + * @param IntlDateFormatter $formatter + * @return string|false The pattern string being used to format/parse. */ -function datefmt_get_pattern(MessageFormatter $mf) { } +function datefmt_get_pattern(IntlDateFormatter $formatter): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Set the pattern used for the IntlDateFormatter * @link https://php.net/manual/en/intldateformatter.setpattern.php - * @param MessageFormatter $mf + * @param IntlDateFormatter $formatter * @param string $pattern <p> * New pattern string to use. * Possible patterns are documented at http://userguide.icu-project.org/formatparse/datetime. @@ -4268,35 +4559,38 @@ function datefmt_get_pattern(MessageFormatter $mf) { } * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. * Bad formatstrings are usually the cause of the failure. */ -function datefmt_set_pattern(MessageFormatter $mf, $pattern) { } +function datefmt_set_pattern(IntlDateFormatter $formatter, string $pattern): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the lenient used for the IntlDateFormatter * @link https://php.net/manual/en/intldateformatter.islenient.php - * @param $mf + * @param IntlDateFormatter $formatter * @return bool <b>TRUE</b> if parser is lenient, <b>FALSE</b> if parser is strict. By default the parser is lenient. */ -function datefmt_is_lenient(MessageFormatter $mf) { } +function datefmt_is_lenient(IntlDateFormatter $formatter): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Set the leniency of the parser * @link https://php.net/manual/en/intldateformatter.setlenient.php - * @param MessageFormatter $mf + * @param IntlDateFormatter $formatter * @param bool $lenient <p> * Sets whether the parser is lenient or not, default is <b>TRUE</b> (lenient). * </p> - * @return bool <b>TRUE</b> on success or <b>FALSE</b> on failure. + * @return void */ -function datefmt_set_lenient(MessageFormatter $mf, $lenient) { } +function datefmt_set_lenient( + IntlDateFormatter $formatter, + bool $lenient +): void {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Format the date/time value as a string * @link https://php.net/manual/en/intldateformatter.format.php - * @param MessageFormatter $mf - * @param mixed $value <p> + * @param IntlDateFormatter $formatter + * @param object|array|string|int|float $datetime <p> * Value to format. This may be a <b>DateTime</b> object, * an integer representing a Unix timestamp value (seconds * since epoch, UTC) or an array in the format output by @@ -4304,17 +4598,20 @@ function datefmt_set_lenient(MessageFormatter $mf, $lenient) { } * </p> * @return string|false The formatted string or, if an error occurred, <b>FALSE</b>. */ -function datefmt_format(MessageFormatter $mf, $value) { } +function datefmt_format( + IntlDateFormatter $formatter, + $datetime +): string|false {} /** * (PHP 5 >= 5.5.0, PECL intl >= 3.0.0)<br/> * Formats an object - * @link https://www.php.net/manual/en/intldateformatter.formatobject.php - * @param object $object <p> + * @link https://secure.php.net/manual/en/intldateformatter.formatobject.php + * @param IntlCalendar|DateTimeInterface $datetime <p> * An object of type IntlCalendar or DateTime. The timezone information in the object will be used. * </p> - * @param mixed $format [optional] <p> - * How to format the date/time. This can either be an {https://www.php.net/manual/en/language.types.array.php array} with + * @param array|int|string|null $format [optional] <p> + * How to format the date/time. This can either be an {https://secure.php.net/manual/en/language.types.array.php array} with * two elements (first the date style, then the time style, these being one * of the constants <b>IntlDateFormatter::NONE</b>, * <b>IntlDateFormatter::SHORT</b>, @@ -4322,7 +4619,7 @@ function datefmt_format(MessageFormatter $mf, $value) { } * <b>IntlDateFormatter::LONG</b>, * <b>IntlDateFormatter::FULL</b>), a long with * the value of one of these constants (in which case it will be used both - * for the time and the date) or a {@link https://www.php.net/manual/en/language.types.string.php} with the format + * for the time and the date) or a {@link https://secure.php.net/manual/en/language.types.string.php} with the format * described in {@link http://www.icu-project.org/apiref/icu4c/classSimpleDateFormat.html#details the ICU documentation} * documentation. If <b>NULL</b>, the default style will be used. * </p> @@ -4330,74 +4627,73 @@ function datefmt_format(MessageFormatter $mf, $value) { } * The locale to use, or NULL to use the default one.</p> * @return string|false The formatted string or, if an error occurred, <b>FALSE</b>. */ -function datefmt_format_object($object, $format = null, $locale = null) { } +function datefmt_format_object($datetime, $format = null, ?string $locale = null): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Parse string to a timestamp value * @link https://php.net/manual/en/intldateformatter.parse.php - * @param MessageFormatter $mf - * @param string $value <p> + * @param IntlDateFormatter $formatter + * @param string $string <p> * string to convert to a time * </p> - * @param int $position [optional] <p> + * @param int &$offset [optional] <p> * Position at which to start the parsing in $value (zero-based). * If no error occurs before $value is consumed, $parse_pos will contain -1 * otherwise it will contain the position at which parsing ended (and the error occurred). * This variable will contain the end position if the parse fails. * If $parse_pos > strlen($value), the parse fails immediately. * </p> - * @return int timestamp parsed value + * @return int|float|false timestamp parsed value */ -function datefmt_parse(MessageFormatter $mf, $value, &$position = null) { } +function datefmt_parse(IntlDateFormatter $formatter, string $string, &$offset = null): int|float|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Parse string to a field-based time value * @link https://php.net/manual/en/intldateformatter.localtime.php - * @param MessageFormatter $mf - * @param string $value <p> + * @param IntlDateFormatter $formatter + * @param string $string <p> * string to convert to a time * </p> - * @param int $position [optional] <p> + * @param int &$offset [optional] <p> * Position at which to start the parsing in $value (zero-based). * If no error occurs before $value is consumed, $parse_pos will contain -1 * otherwise it will contain the position at which parsing ended . * If $parse_pos > strlen($value), the parse fails immediately. * </p> - * @return array Localtime compatible array of integers : contains 24 hour clock value in tm_hour field + * @return array|false Localtime compatible array of integers : contains 24 hour clock value in tm_hour field */ -function datefmt_localtime(MessageFormatter $mf, $value, &$position = null) { } +function datefmt_localtime(IntlDateFormatter $formatter, string $string, &$offset = null): array|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the error code from last operation * @link https://php.net/manual/en/intldateformatter.geterrorcode.php - * @param MessageFormatter $mf + * @param IntlDateFormatter $formatter * @return int The error code, one of UErrorCode values. Initial value is U_ZERO_ERROR. */ -function datefmt_get_error_code(MessageFormatter $mf) { } +function datefmt_get_error_code(IntlDateFormatter $formatter): int {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get the error text from the last operation. * @link https://php.net/manual/en/intldateformatter.geterrormessage.php - * @param MessageFormatter $mf - * @param $coll + * @param IntlDateFormatter $formatter * @return string Description of the last error. */ -function datefmt_get_error_message(MessageFormatter $mf, $coll) { } +function datefmt_get_error_message(IntlDateFormatter $formatter): string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get string length in grapheme units * @link https://php.net/manual/en/function.grapheme-strlen.php - * @param string $input <p> + * @param string $string <p> * The string being measured for length. It must be a valid UTF-8 string. * </p> * @return int|false|null The length of the string on success, and 0 if the string is empty. */ -function grapheme_strlen($input) { } +function grapheme_strlen(string $string): int|false|null {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -4417,7 +4713,7 @@ function grapheme_strlen($input) { } * </p> * @return int|false the position as an integer. If needle is not found, strpos() will return boolean FALSE. */ -function grapheme_strpos($haystack, $needle, $offset = 0) { } +function grapheme_strpos(string $haystack, string $needle, int $offset = 0): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -4437,7 +4733,7 @@ function grapheme_strpos($haystack, $needle, $offset = 0) { } * </p> * @return int|false the position as an integer. If needle is not found, grapheme_stripos() will return boolean FALSE. */ -function grapheme_stripos($haystack, $needle, $offset = 0) { } +function grapheme_stripos(string $haystack, string $needle, int $offset = 0): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -4457,7 +4753,7 @@ function grapheme_stripos($haystack, $needle, $offset = 0) { } * </p> * @return int|false the position as an integer. If needle is not found, grapheme_strrpos() will return boolean FALSE. */ -function grapheme_strrpos($haystack, $needle, $offset = 0) { } +function grapheme_strrpos(string $haystack, string $needle, int $offset = 0): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -4477,7 +4773,7 @@ function grapheme_strrpos($haystack, $needle, $offset = 0) { } * </p> * @return int|false the position as an integer. If needle is not found, grapheme_strripos() will return boolean FALSE. */ -function grapheme_strripos($haystack, $needle, $offset = 0) { } +function grapheme_strripos(string $haystack, string $needle, int $offset = 0): int|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -4486,14 +4782,14 @@ function grapheme_strripos($haystack, $needle, $offset = 0) { } * @param string $string <p> * The input string. Must be valid UTF-8. * </p> - * @param int $start <p> + * @param int $offset <p> * Start position in default grapheme units. * If $start is non-negative, the returned string will start at the * $start'th position in $string, counting from zero. If $start is negative, * the returned string will start at the $start'th grapheme unit from the * end of string. * </p> - * @param int $length [optional] <p> + * @param int|null $length [optional] <p> * Length in grapheme units. * If $length is given and is positive, the string returned will contain * at most $length grapheme units beginning from $start (depending on the @@ -4503,10 +4799,10 @@ function grapheme_strripos($haystack, $needle, $offset = 0) { } * denotes a position beyond this truncation, <b>FALSE</b> will be returned. * </p> * @return string|false <p>the extracted part of $string,<br /> - or <strong>FALSE</strong> if $length is negative and $start denotes a position beyond truncation $length,<br /> - or also <strong>FALSE</strong> if $start denotes a position beyond $string length</p> + * or <strong>FALSE</strong> if $length is negative and $start denotes a position beyond truncation $length,<br /> + * or also <strong>FALSE</strong> if $start denotes a position beyond $string length</p> */ -function grapheme_substr($string, $start, $length = null) { } +function grapheme_substr(string $string, int $offset, ?int $length = null): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -4518,13 +4814,13 @@ function grapheme_substr($string, $start, $length = null) { } * @param string $needle <p> * The string to look for. Must be valid UTF-8. * </p> - * @param bool $before_needle [optional] <p> + * @param bool $beforeNeedle [optional] <p> * If <b>TRUE</b>, grapheme_strstr() returns the part of the * haystack before the first occurrence of the needle (excluding the needle). * </p> * @return string|false the portion of string, or FALSE if needle is not found. */ -function grapheme_strstr($haystack, $needle, $before_needle = false) { } +function grapheme_strstr(string $haystack, string $needle, bool $beforeNeedle = false): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -4536,13 +4832,13 @@ function grapheme_strstr($haystack, $needle, $before_needle = false) { } * @param string $needle <p> * The string to look for. Must be valid UTF-8. * </p> - * @param bool $before_needle [optional] <p> + * @param bool $beforeNeedle [optional] <p> * If <b>TRUE</b>, grapheme_strstr() returns the part of the * haystack before the first occurrence of the needle (excluding needle). * </p> * @return string|false the portion of $haystack, or FALSE if $needle is not found. */ -function grapheme_stristr($haystack, $needle, $before_needle = false) { } +function grapheme_stristr(string $haystack, string $needle, bool $beforeNeedle = false): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -4554,7 +4850,7 @@ function grapheme_stristr($haystack, $needle, $before_needle = false) { } * @param int $size <p> * Maximum number items - based on the $extract_type - to return. * </p> - * @param int $extract_type [optional] <p> + * @param int $type <p> * Defines the type of units referred to by the $size parameter: * </p> * <p> @@ -4565,20 +4861,20 @@ function grapheme_stristr($haystack, $needle, $before_needle = false) { } * GRAPHEME_EXTR_MAXCHARS - $size is the maximum number of UTF-8 * characters returned. * </p> - * @param int $start [optional] <p> + * @param int $offset [optional] <p> * Starting position in $haystack in bytes - if given, it must be zero or a * positive value that is less than or equal to the length of $haystack in * bytes. If $start does not point to the first byte of a UTF-8 * character, the start position is moved to the next character boundary. * </p> - * @param int $next [optional] <p> + * @param int &$next [optional] <p> * Reference to a value that will be set to the next starting position. * When the call returns, this may point to the first byte position past the end of the string. * </p> * @return string|false A string starting at offset $start and ending on a default grapheme cluster * boundary that conforms to the $size and $extract_type specified. */ -function grapheme_extract($haystack, $size, $extract_type = null, $start = 0, &$next = null) { } +function grapheme_extract(string $haystack, int $size, int $type = 0, int $offset = 0, &$next = null): string|false {} /** * (PHP 5 >= 5.3.0, PHP 7, PECL intl >= 1.0.2, PHP 7, PECL idn >= 0.1)<br/> @@ -4590,13 +4886,13 @@ function grapheme_extract($haystack, $size, $extract_type = null, $start = 0, &$ * passed it will be converted into an ACE encoded "xn--" string. * It will not be the one you expected though! * </p> - * @param int $options [optional] <p> + * @param int $flags [optional] <p> * Conversion options - combination of IDNA_* constants (except IDNA_ERROR_* constants). * </p> * @param int $variant [optional] <p> * Either INTL_IDNA_VARIANT_2003 for IDNA 2003 or INTL_IDNA_VARIANT_UTS46 for UTS #46. * </p> - * @param array $idna_info [optional] <p> + * @param array &$idna_info [optional] <p> * This parameter can be used only if INTL_IDNA_VARIANT_UTS46 was used for variant. * In that case, it will be filled with an array with the keys 'result', * the possibly illegal result of the transformation, 'isTransitionalDifferent', @@ -4606,7 +4902,7 @@ function grapheme_extract($haystack, $size, $extract_type = null, $start = 0, &$ * </p> * @return string|false The ACE encoded version of the domain name or <b>FALSE</b> on failure. */ -function idn_to_ascii($domain, $options = 0, $variant = INTL_IDNA_VARIANT_2003, array &$idna_info = null) { } +function idn_to_ascii(string $domain, int $flags = 0, int $variant = INTL_IDNA_VARIANT_UTS46, &$idna_info): string|false {} /** * (PHP 5 >= 5.3.0, PHP 7, PECL intl >= 1.0.2, PHP 7, PECL idn >= 0.1)<br/> @@ -4616,7 +4912,7 @@ function idn_to_ascii($domain, $options = 0, $variant = INTL_IDNA_VARIANT_2003, * Domain to convert in IDNA ASCII-compatible format. * The ASCII encoded domain name. Looks like "xn--..." if the it originally contained non-ASCII characters. * </p> - * @param int $options [optional] <p> + * @param int $flags [optional] <p> * Conversion options - combination of IDNA_* constants (except IDNA_ERROR_* constants). * </p> * @param int $variant [optional] <p> @@ -4634,13 +4930,18 @@ function idn_to_ascii($domain, $options = 0, $variant = INTL_IDNA_VARIANT_2003, * RFC 3490 4.2 states though "ToUnicode never fails. If any step fails, then the original input * sequence is returned immediately in that step." */ -function idn_to_utf8($domain, $options = 0, $variant = INTL_IDNA_VARIANT_2003, array &$idna_info = null) { } +function idn_to_utf8( + string $domain, + int $flags = 0, + int $variant = INTL_IDNA_VARIANT_UTS46, + &$idna_info = null, +): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Create a new IntlCalendar - * @link https://www.php.net/manual/en/intlcalendar.createinstance.php - * @param mixed $timeZone [optional] <p> <p> + * @link https://secure.php.net/manual/en/intlcalendar.createinstance.php + * @param IntlTimeZone|DateTimeZone|string|null $timezone [optional] <p> <p> * The timezone to use. * </p> * @@ -4648,113 +4949,115 @@ function idn_to_utf8($domain, $options = 0, $variant = INTL_IDNA_VARIANT_2003, a * <li> * <p> * <b>NULL</b>, in which case the default timezone will be used, as specified in - * the ini setting {@link https://www.php.net/manual/en/datetime.configuration.php#ini.date.timezone date.timezone} or - * through the function {@link https://www.php.net/manual/en/function.date-default-timezone-set.php date_default_timezone_set()} and as - * returned by {@link https://www.php.net/manual/en/function.date-default-timezone-get.php date_default_timezone_get()}. + * the ini setting {@link https://secure.php.net/manual/en/datetime.configuration.php#ini.date.timezone date.timezone} or + * through the function {@link https://secure.php.net/manual/en/function.date-default-timezone-set.php date_default_timezone_set()} and as + * returned by {@link https://secure.php.net/manual/en/function.date-default-timezone-get.php date_default_timezone_get()}. * </p> * </li> * <li> * <p> - * An {@link https://www.php.net/manual/en/class.intltimezone.php IntlTimeZone}, which will be used directly. + * An {@link https://secure.php.net/manual/en/class.intltimezone.php IntlTimeZone}, which will be used directly. * </p> * </li> * <li> * <p> - * A {@link https://www.php.net/manual/en/class.datetimezone.php DateTimeZone}. Its identifier will be extracted + * A {@link https://secure.php.net/manual/en/class.datetimezone.php DateTimeZone}. Its identifier will be extracted * and an ICU timezone object will be created; the timezone will be backed * by ICU's database, not PHP's. * </p> * </li> * <li> * <p> - * A {@link https://www.php.net/manual/en/language.types.string.php string}, which should be a valid ICU timezone identifier. + * A {@link https://secure.php.net/manual/en/language.types.string.php string}, which should be a valid ICU timezone identifier. * See <b>IntlTimeZone::createTimeZoneIDEnumeration()</b>. Raw * offsets such as <em>"GMT+08:30"</em> are also accepted. * </p> * </li> * </ul> * </p> - * @param string $locale [optional] <p> - * A locale to use or <b>NULL</b> to use {@link https://www.php.net/manual/en/intl.configuration.php#ini.intl.default-locale the default locale}. + * @param string|null $locale [optional] <p> + * A locale to use or <b>NULL</b> to use {@link https://secure.php.net/manual/en/intl.configuration.php#ini.intl.default-locale the default locale}. * </p> - * @return IntlCalendar - * The created {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} instance or <b>NULL</b> on + * @return IntlCalendar|null + * The created {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} instance or <b>NULL</b> on * failure. * @since 5.5 */ -function intlcal_create_instance($timeZone = null, $locale = null) { } +function intlcal_create_instance($timezone = null, ?string $locale = null): ?IntlCalendar {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get set of locale keyword values - * @param string $key <p> + * @param string $keyword <p> * The locale keyword for which relevant values are to be queried. Only * <em>'calendar'</em> is supported. * </p> * @param string $locale <p> * The locale onto which the keyword/value pair are to be appended. * </p> - * @param bool $commonlyUsed + * @param bool $onlyCommon * <p> * Whether to show only the values commonly used for the specified locale. * </p> - * @return Iterator|false An iterator that yields strings with the locale keyword values or <b>FALSE</b> on failure. + * @return IntlIterator|false An iterator that yields strings with the locale keyword values or <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_get_keyword_values_for_locale($key, $locale, $commonlyUsed) { } +function intlcal_get_keyword_values_for_locale(string $keyword, string $locale, bool $onlyCommon): IntlIterator|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get number representing the current time - * @link https://www.php.net/manual/en/intlcalendar.getnow.php + * @link https://secure.php.net/manual/en/intlcalendar.getnow.php * @return float A float representing a number of milliseconds since the epoch, not counting leap seconds. * @since 5.5 */ -function intlcal_get_now() { } +function intlcal_get_now(): float {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get array of locales for which there is data - * @link https://www.php.net/manual/en/intlcalendar.getavailablelocales.php - * @return array An array of strings, one for which locale. + * @link https://secure.php.net/manual/en/intlcalendar.getavailablelocales.php + * @return string[] An array of strings, one for which locale. * @since 5.5 */ - -function intlcal_get_available_locales() { } +function intlcal_get_available_locales(): array {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the value for a field - * @link https://www.php.net/manual/en/intlcalendar.get.php + * @link https://secure.php.net/manual/en/intlcalendar.get.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> * @return int An integer with the value of the time field. * @since 5.5 */ -function intl_get($calendar, $field) { } +function intl_get($calendar, $field) {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get time currently represented by the object * @param IntlCalendar $calendar <p>The calendar whose time will be checked against this object's time.</p> * @return float - * A {@link https://www.php.net/manual/en/language.types.float.php float} representing the number of milliseconds elapsed since the + * A {@link https://secure.php.net/manual/en/language.types.float.php float} representing the number of milliseconds elapsed since the * reference time (1 Jan 1970 00:00:00 UTC). * @since 5.5 */ -function intlcal_get_time($calendar) { } +function intlcal_get_time(IntlCalendar $calendar): float|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set the calendar time in milliseconds since the epoch - * @link https://www.php.net/manual/en/intlcalendar.settime.php - * @param float $date <p> + * @link https://secure.php.net/manual/en/intlcalendar.settime.php + * @param IntlCalendar $calendar <p> + * The IntlCalendar resource. + * </p> + * @param float $timestamp <p> * An instant represented by the number of number of milliseconds between * such instant and the epoch, ignoring leap seconds. * </p> @@ -4762,35 +5065,35 @@ function intlcal_get_time($calendar) { } * Returns <b>TRUE</b> on success and <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_set_time($date) { } +function intlcal_set_time(IntlCalendar $calendar, float $timestamp): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Add a (signed) amount of time to a field - * @link https://www.php.net/manual/en/intlcalendar.add.php + * @link https://secure.php.net/manual/en/intlcalendar.add.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. * These are integer values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> - * @param int $amount <p>The signed amount to add to the current field. If the amount is positive, the instant will be moved forward; if it is negative, the instant wil be moved into the past. The unit is implicit to the field type. + * @param int $value <p>The signed amount to add to the current field. If the amount is positive, the instant will be moved forward; if it is negative, the instant wil be moved into the past. The unit is implicit to the field type. * For instance, hours for IntlCalendar::FIELD_HOUR_OF_DAY.</p> * @return bool Returns <b>TRUE</b> on success or <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_add($calendar, $field, $amount) { } +function intlcal_add(IntlCalendar $calendar, int $field, int $value): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set the timezone used by this calendar - * @link https://www.php.net/manual/en/intlcalendar.settimezone.php + * @link https://secure.php.net/manual/en/intlcalendar.settimezone.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @param mixed $timeZone <p> + * @param IntlTimeZone|DateTimeZone|string|null $timezone <p> * The new timezone to be used by this calendar. It can be specified in the * following ways: * @@ -4798,26 +5101,26 @@ function intlcal_add($calendar, $field, $amount) { } * <li> * <p> * <b>NULL</b>, in which case the default timezone will be used, as specified in - * the ini setting {@link https://www.php.net/manual/en/datetime.configuration.php#ini.date.timezone date.timezone} or - * through the function {@link https://www.php.net/manual/en/function.date-default-timezone-set.php date_default_timezone_set()} and as - * returned by {@link https://www.php.net/manual/en/function.date-default-timezone-get.php date_default_timezone_get()}. + * the ini setting {@link https://secure.php.net/manual/en/datetime.configuration.php#ini.date.timezone date.timezone} or + * through the function {@link https://secure.php.net/manual/en/function.date-default-timezone-set.php date_default_timezone_set()} and as + * returned by {@link https://secure.php.net/manual/en/function.date-default-timezone-get.php date_default_timezone_get()}. * </p> * </li> * <li> * <p> - * An {@link https://www.php.net/manual/en/class.intltimezone.php IntlTimeZone}, which will be used directly. + * An {@link https://secure.php.net/manual/en/class.intltimezone.php IntlTimeZone}, which will be used directly. * </p> * </li> * <li> * <p> - * A {@link https://www.php.net/manual/en/class.datetimezone.php DateTimeZone}. Its identifier will be extracted + * A {@link https://secure.php.net/manual/en/class.datetimezone.php DateTimeZone}. Its identifier will be extracted * and an ICU timezone object will be created; the timezone will be backed * by ICU's database, not PHP's. * </p> * </li> * <li> * <p> - * A {@link https://www.php.net/manual/en/language.types.string.php string}, which should be a valid ICU timezone identifier. + * A {@link https://secure.php.net/manual/en/language.types.string.php string}, which should be a valid ICU timezone identifier. * See <b>IntlTimeZone::createTimeZoneIDEnumeration()</b>. Raw * offsets such as <em>"GMT+08:30"</em> are also accepted. * </p> @@ -4826,53 +5129,53 @@ function intlcal_add($calendar, $field, $amount) { } * @return bool Returns <b>TRUE</b> on success and <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_set_time_zone($calendar, $timeZone) { } +function intlcal_set_time_zone(IntlCalendar $calendar, $timezone): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether this object's time is after that of the passed object - * https://www.php.net/manual/en/intlcalendar.after.php - * @param IntlCalendar $calendarObject <p> + * https://secure.php.net/manual/en/intlcalendar.after.php + * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @param IntlCalendar $calendar <p>The calendar whose time will be checked against this object's time.</p> + * @param IntlCalendar $other <p>The calendar whose time will be checked against this object's time.</p> * @return bool * Returns <b>TRUE</b> if this object's current time is after that of the * <em>calendar</em> argument's time. Returns <b>FALSE</b> otherwise. - * Also returns <b>FALSE</b> on failure. You can use {@link https://www.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or - * {@link https://www.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to detect error conditions. + * Also returns <b>FALSE</b> on failure. You can use {@link https://secure.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or + * {@link https://secure.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to detect error conditions. * @since 5.5 */ -function intlcal_after(IntlCalendar $calendarObject, IntlCalendar $calendar) { } +function intlcal_after(IntlCalendar $calendar, IntlCalendar $other): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether this object's time is before that of the passed object - * @link https://www.php.net/manual/en/intlcalendar.before.php - * @param IntlCalendar $calendarObject <p> + * @link https://secure.php.net/manual/en/intlcalendar.before.php + * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @param IntlCalendar $calendar <p> The calendar whose time will be checked against this object's time.</p> + * @param IntlCalendar $other <p> The calendar whose time will be checked against this object's time.</p> * @return bool + * <p> * Returns <b>TRUE</B> if this object's current time is before that of the * <em>calendar</em> argument's time. Returns <b>FALSE</b> otherwise. - * Also returns <b>FALSE</b> on failure. You can use {@link https://www.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or - * {@link https://www.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to detect error conditions. + * Also returns <b>FALSE</b> on failure. You can use {@link https://secure.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or + * {@link https://secure.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to detect error conditions. * </p> * @since 5.5 */ -function intlcal_before(IntlCalendar $calendarObject, IntlCalendar $calendar) { } - +function intlcal_before(IntlCalendar $calendar, IntlCalendar $other): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set a time field or several common fields at once - * @link https://www.php.net/manual/en/intlcalendar.set.php + * @link https://secure.php.net/manual/en/intlcalendar.set.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @param int $year <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> @@ -4895,26 +5198,26 @@ function intlcal_before(IntlCalendar $calendarObject, IntlCalendar $calendar) { * </p> * @param int $second [optional] <p> * The new value for <b>IntlCalendar::FIELD_SECOND</b>. - *</p> + * </p> * @return bool Returns <b>TRUE</b> on success and <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_set($calendar, $year, $month, $dayOfMonth = null, $hour = null, $minute = null, $second = null) { } +function intlcal_set(IntlCalendar $calendar, int $year, int $month, int $dayOfMonth, int $hour, int $minute, int $second): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Add value to field without carrying into more significant fields - * @link https://www.php.net/manual/en/intlcalendar.roll.php + * @link https://secure.php.net/manual/en/intlcalendar.roll.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @param int $field <p>One of the - * {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time - * {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. + * {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time + * {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. * These are integer values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> - * @param mixed $amountOrUpOrDown <p> + * @param int|bool $value <p> * The (signed) amount to add to the field, <b>TRUE</b> for rolling up (adding * <em>1</em>), or <b>FALSE</b> for rolling down (subtracting * <em>1</em>). @@ -4922,33 +5225,37 @@ function intlcal_set($calendar, $year, $month, $dayOfMonth = null, $hour = null, * @return bool Returns <b>TRUE</b> on success or <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_roll($calendar, $field, $amountOrUpOrDown) { } +function intlcal_roll( + IntlCalendar $calendar, + int $field, + $value +): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Clear a field or all fields - * @link https://www.php.net/manual/en/intlcalendar.clear.php + * @link https://secure.php.net/manual/en/intlcalendar.clear.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @param int $field [optional] <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * @param int|null $field [optional] <p> + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> * @return bool Returns <b>TRUE</b> on success or <b>FALSE</b> on failure. Failure can only occur is invalid arguments are provided. * @since 5.5 */ -function intlcal_clear($calendar, $field = null) { } +function intlcal_clear(IntlCalendar $calendar, ?int $field = null): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Calculate difference between given time and this object's time - * @link https://www.php.net/manual/en/intlcalendar.fielddifference.php + * @link https://secure.php.net/manual/en/intlcalendar.fielddifference.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @param float $when <p> + * @param float $timestamp <p> * The time against which to compare the quantity represented by the * <em>field</em>. For the result to be positive, the time * given for this parameter must be ahead of the time of the object the @@ -4959,7 +5266,7 @@ function intlcal_clear($calendar, $field = null) { } * </p> * * <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> @@ -4967,50 +5274,49 @@ function intlcal_clear($calendar, $field = null) { } * specified field or <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_field_difference($calendar, $when, $field) { } - +function intlcal_field_difference(IntlCalendar $calendar, float $timestamp, int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * The maximum value for a field, considering the object's current time - * @link https://www.php.net/manual/en/intlcalendar.getactualmaximum.php + * @link https://secure.php.net/manual/en/intlcalendar.getactualmaximum.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> * @return int - * An {@link https://www.php.net/manual/en/language.types.integer.php int} representing the maximum value in the units associated + * An {@link https://secure.php.net/manual/en/language.types.integer.php int} representing the maximum value in the units associated * with the given <em>field</em> or <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_get_actual_maximum($calendar, $field) { } +function intlcal_get_actual_maximum(IntlCalendar $calendar, int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * The minimum value for a field, considering the object's current time - * @link https://www.php.net/manual/en/intlcalendar.getactualminimum.php + * @link https://secure.php.net/manual/en/intlcalendar.getactualminimum.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. * These are integer values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> * @return int - * An {@link https://www.php.net/manual/en/language.types.integer.php int} representing the minimum value in the field's + * An {@link https://secure.php.net/manual/en/language.types.integer.php int} representing the minimum value in the field's * unit or <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_get_actual_minimum($calendar, $field) { } +function intlcal_get_actual_minimum(IntlCalendar $calendar, int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> - * @link https://www.php.net/manual/en/intlcalendar.getdayofweektype.php + * @link https://secure.php.net/manual/en/intlcalendar.getdayofweektype.php * Tell whether a day is a weekday, weekend or a day that has a transition between the two * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. @@ -5028,12 +5334,12 @@ function intlcal_get_actual_minimum($calendar, $field) { } * <b>IntlCalendar::DOW_TYPE_WEEKEND_CEASE</b> or <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_get_day_of_week_type($calendar, $dayOfWeek) { } +function intlcal_get_day_of_week_type(IntlCalendar $calendar, int $dayOfWeek): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the first day of the week for the calendar's locale - * @link https://www.php.net/manual/en/intlcalendar.getfirstdayofweek.php + * @link https://secure.php.net/manual/en/intlcalendar.getfirstdayofweek.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> @@ -5043,88 +5349,86 @@ function intlcal_get_day_of_week_type($calendar, $dayOfWeek) { } * <b>IntlCalendar::DOW_SATURDAY</b> or <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_get_first_day_of_week($calendar) { } +function intlcal_get_first_day_of_week(IntlCalendar $calendar): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the largest local minimum value for a field - * @link https://www.php.net/manual/en/intlcalendar.getgreatestminimum.php + * @link https://secure.php.net/manual/en/intlcalendar.getgreatestminimum.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and - * <b>IntlCalendar::FIELD_COUNT</b>. + * <b>IntlCalendar::FIELD_COUNT</b>.</p> * @return int - * An {@link https://www.php.net/manual/en/language.types.integer.php int} representing a field value, in the field's + * An {@link https://secure.php.net/manual/en/language.types.integer.php int} representing a field value, in the field's * unit, or <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_greates_minimum($calendar, $field) { } +function intlcal_greates_minimum($calendar, $field) {} /** - * (PHP >= 5.3.2, PECL intl >= 2.0.0)<br/> - * Get data from the bundle - * @link https://php.net/manual/en/resourcebundle.get.php + * (PHP >= 5.5.0, PECL intl >= 3.0.0a1)<br/> + * Gets the value for a specific field. + * @link https://www.php.net/manual/en/intlcalendar.get.php * @param IntlCalendar $calendar <p> - * The calendar object, on the procedural style interface. + * The IntlCalendar resource. * </p> - * @param string|int $index <p> - * Data index, must be string or integer. + * @param int $field <p> + * One of the IntlCalendar date/time field constants. These are integer values between 0 and IntlCalendar::FIELD_COUNT. * </p> - * @return mixed the data located at the index or <b>NULL</b> on error. Strings, integers and binary data strings - * are returned as corresponding PHP types, integer array is returned as PHP array. Complex types are - * returned as <b>ResourceBundle</b> object. + * @return int An integer with the value of the time field. */ -function intlcal_get($calendar, $index) { } +function intlcal_get(IntlCalendar $calendar, int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the smallest local maximum for a field - * @link https://www.php.net/manual/en/intlcalendar.getleastmaximum.php + * @link https://secure.php.net/manual/en/intlcalendar.getleastmaximum.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> * @return int - * An {@link https://www.php.net/manual/en/language.types.integer.ph int} representing a field value in the field's + * <p>An {@link https://secure.php.net/manual/en/language.types.integer.ph int} representing a field value in the field's * unit or <b>FALSE</b> on failure. * </p> * @since 5.5 */ -function intlcal_get_least_maximum($calendar, $field) { } +function intlcal_get_least_maximum(IntlCalendar $calendar, int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the largest local minimum value for a field - * @link https://www.php.net/manual/en/intlcalendar.getgreatestminimum.php + * @link https://secure.php.net/manual/en/intlcalendar.getgreatestminimum.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and - * <b>IntlCalendar::FIELD_COUNT</b>. + * <b>IntlCalendar::FIELD_COUNT</b>.</p> * @return int - * An {@link https://www.php.net/manual/en/language.types.integer.php int} representing a field value, in the field's + * An {@link https://secure.php.net/manual/en/language.types.integer.php int} representing a field value, in the field's * unit, or <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_get_greatest_minimum($calendar, $field) { } +function intlcal_get_greatest_minimum(IntlCalendar $calendar, int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the locale associated with the object - * @link https://www.php.net/manual/en/intlcalendar.getlocale.php + * @link https://secure.php.net/manual/en/intlcalendar.getlocale.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @param int $localeType <p> + * @param int $type <p> * Whether to fetch the actual locale (the locale from which the calendar * data originates, with <b>Locale::ACTUAL_LOCALE</b>) or the * valid locale, i.e., the most specific locale supported by ICU relatively @@ -5136,49 +5440,47 @@ function intlcal_get_greatest_minimum($calendar, $field) { } * A locale string or <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_get_locale($calendar, $localeType) { } +function intlcal_get_locale(IntlCalendar $calendar, int $type): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the global maximum value for a field - * @link https://www.php.net/manual/en/intlcalendar.getmaximum.php + * @link https://secure.php.net/manual/en/intlcalendar.getmaximum.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> - * @return string - * A locale string or <b>FALSE</b> on failure. + * @return int|false * @since 5.5 */ -function intcal_get_maximum($calendar, $field) { } - +function intcal_get_maximum($calendar, $field) {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> - * @link https://www.php.net/manual/en/intlcalendar.getminimaldaysinfirstweek.php + * @link https://secure.php.net/manual/en/intlcalendar.getminimaldaysinfirstweek.php * Get minimal number of days the first week in a year or month can have * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @return int - * An {@link https://www.php.net/manual/en/language.types.integer.php int} representing a number of days or <b>FALSE</b> on failure. + * An {@link https://secure.php.net/manual/en/language.types.integer.php int} representing a number of days or <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_get_minimal_days_in_first_week($calendar) { } +function intlcal_get_minimal_days_in_first_week(IntlCalendar $calendar): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the global minimum value for a field - * @link https://www.php.net/manual/en/intlcalendar.getminimum.php + * @link https://secure.php.net/manual/en/intlcalendar.getminimum.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> @@ -5186,162 +5488,160 @@ function intlcal_get_minimal_days_in_first_week($calendar) { } * An int representing a value for the given field in the field's unit or FALSE on failure. * @since 5.5 */ -function intlcal_get_minimum($calendar, $field) { } +function intlcal_get_minimum(IntlCalendar $calendar, int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the object's timezone - * @link https://www.php.net/manual/en/intlcalendar.gettimezone.php + * @link https://secure.php.net/manual/en/intlcalendar.gettimezone.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @return IntlTimeZone - * An {@link https://www.php.net/manual/en/class.intltimezone.php IntlTimeZone} object corresponding to the one used + * @return IntlTimeZone|false + * An {@link https://secure.php.net/manual/en/class.intltimezone.php IntlTimeZone} object corresponding to the one used * internally in this object. * @since 5.5 */ -function intlcal_get_time_zone($calendar) { } +function intlcal_get_time_zone(IntlCalendar $calendar): IntlTimeZone|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the calendar type - * @link https://www.php.net/manual/en/intlcalendar.gettype.php + * @link https://secure.php.net/manual/en/intlcalendar.gettype.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @return string - * A {@link https://www.php.net/manual/en/language.types.string.php string} representing the calendar type, such as + * A {@link https://secure.php.net/manual/en/language.types.string.php string} representing the calendar type, such as * <em>'gregorian'</em>, <em>'islamic'</em>, etc. * @since 5.5 */ -function intlcal_get_type($calendar) { } +function intlcal_get_type(IntlCalendar $calendar): string {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get time of the day at which weekend begins or ends - * @link https://www.php.net/manual/en/intlcalendar.getweekendtransition.php + * @link https://secure.php.net/manual/en/intlcalendar.getweekendtransition.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @param string $dayOfWeek <p> + * @param int $dayOfWeek <p> * One of the constants <b>IntlCalendar::DOW_SUNDAY</b>, * <b>IntlCalendar::DOW_MONDAY</b>, ..., * <b>IntlCalendar::DOW_SATURDAY</b>. * </p> * @return int - * The number of milliseconds into the day at which the weekend begins or + * The number of milliseconds into the day at which the the weekend begins or * ends or <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_get_weekend_transition($calendar, $dayOfWeek) { } +function intlcal_get_weekend_transition(IntlCalendar $calendar, int $dayOfWeek): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether the object's time is in Daylight Savings Time - * @link https://www.php.net/manual/en/intlcalendar.indaylighttime.php + * @link https://secure.php.net/manual/en/intlcalendar.indaylighttime.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @return bool * Returns <b>TRUE</b> if the date is in Daylight Savings Time, <b>FALSE</b> otherwise. * The value <b>FALSE</b> may also be returned on failure, for instance after - * specifying invalid field values on non-lenient mode; use {@link https://www.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or query - * {@link https://www.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to disambiguate. + * specifying invalid field values on non-lenient mode; use {@link https://secure.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or query + * {@link https://secure.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to disambiguate. * @since 5.5 */ -function intlcal_in_daylight_time($calendar) { } +function intlcal_in_daylight_time(IntlCalendar $calendar): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether date/time interpretation is in lenient mode - * @link https://www.php.net/manual/en/intlcalendar.islenient.php + * @link https://secure.php.net/manual/en/intlcalendar.islenient.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @return bool - * A {@link https://www.php.net/manual/en/language.types.boolean.php bool} representing whether the calendar is set to lenient mode. + * A {@link https://secure.php.net/manual/en/language.types.boolean.php bool} representing whether the calendar is set to lenient mode. * @since 5.5 */ -function intlcal_is_lenient($calendar) { } +function intlcal_is_lenient(IntlCalendar $calendar): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether a field is set - * @link https://www.php.net/manual/en/intlcalendar.isset.php + * @link https://secure.php.net/manual/en/intlcalendar.isset.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> * @return bool Assuming there are no argument errors, returns <b>TRUE</b> iif the field is set. * @since 5.5 */ -function intlcal_is_set($calendar, $field) { } +function intlcal_is_set(IntlCalendar $calendar, int $field): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the global maximum value for a field - * @link https://www.php.net/manual/en/intlcalendar.getmaximum.php + * @link https://secure.php.net/manual/en/intlcalendar.getmaximum.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @param int $field <p> - * One of the {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://www.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer + * One of the {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} date/time {@link https://secure.php.net/manual/en/class.intlcalendar.php#intlcalendar.constants field constants}. These are integer * values between <em>0</em> and * <b>IntlCalendar::FIELD_COUNT</b>. * </p> - * @return string - * A locale string or <b>FALSE</b> on failure. + * @return int|false * @since 5.5 */ -function intlcal_get_maximum($calendar, $field) { } +function intlcal_get_maximum(IntlCalendar $calendar, int $field): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether another calendar is equal but for a different time - * @link https://www.php.net/manual/en/intlcalendar.isequivalentto.php - * @param IntlCalendar $calendarObject <p> + * @link https://secure.php.net/manual/en/intlcalendar.isequivalentto.php + * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @param IntlCalendar $calendar The other calendar against which the comparison is to be made. + * @param IntlCalendar $other The other calendar against which the comparison is to be made. * @return bool * Assuming there are no argument errors, returns <b>TRUE</b> iif the calendars are equivalent except possibly for their set time. * @since 5.5 */ -function intlcal_is_equivalent_to(IntlCalendar $calendarObject, IntlCalendar $calendar) { } +function intlcal_is_equivalent_to(IntlCalendar $calendar, IntlCalendar $other): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Whether a certain date/time is in the weekend - * @link https://www.php.net/manual/en/intlcalendar.isweekend.php + * @link https://secure.php.net/manual/en/intlcalendar.isweekend.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @param float|null $date [optional] <p> + * @param float|null $timestamp [optional] <p> * An optional timestamp representing the number of milliseconds since the * epoch, excluding leap seconds. If <b>NULL</b>, this object's current time is * used instead. * </p> * @return bool - * <p> A {@link https://www.php.net/manual/en/language.types.boolean.php bool} indicating whether the given or this object's time occurs + * <p> A {@link https://secure.php.net/manual/en/language.types.boolean.php bool} indicating whether the given or this object's time occurs * in a weekend. * </p> * <p> * The value <b>FALSE</b> may also be returned on failure, for instance after giving - * a date out of bounds on non-lenient mode; use {@link https://www.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or query - * {@link https://www.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to disambiguate.</p> + * a date out of bounds on non-lenient mode; use {@link https://secure.php.net/manual/en/intl.configuration.php#ini.intl.use-exceptions exceptions} or query + * {@link https://secure.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()} to disambiguate.</p> * @since 5.5 */ -function intlcal_is_weekend($calendar, $date = null) { } - +function intlcal_is_weekend(IntlCalendar $calendar, ?float $timestamp = null): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set the day on which the week is deemed to start - * @link https://www.php.net/manual/en/intlcalendar.setfirstdayofweek.php + * @link https://secure.php.net/manual/en/intlcalendar.setfirstdayofweek.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> @@ -5353,28 +5653,27 @@ function intlcal_is_weekend($calendar, $date = null) { } * @return bool Returns TRUE on success. Failure can only happen due to invalid parameters. * @since 5.5 */ -function intlcal_set_first_day_of_week($calendar, $dayOfWeek) { } +function intlcal_set_first_day_of_week(IntlCalendar $calendar, int $dayOfWeek): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set whether date/time interpretation is to be lenient - * @link https://www.php.net/manual/en/intlcalendar.setlenient.php + * @link https://secure.php.net/manual/en/intlcalendar.setlenient.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @param string $isLenient <p> + * @param bool $lenient <p> * Use <b>TRUE</b> to activate the lenient mode; <b>FALSE</b> otherwise. * </p> * @return bool Returns <b>TRUE</b> on success. Failure can only happen due to invalid parameters. * @since 5.5 */ -function intlcal_set_lenient($calendar, $isLenient) { } - +function intlcal_set_lenient(IntlCalendar $calendar, bool $lenient): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get behavior for handling repeating wall time - * @link https://www.php.net/manual/en/intlcalendar.getrepeatedwalltimeoption.php + * @link https://secure.php.net/manual/en/intlcalendar.getrepeatedwalltimeoption.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> @@ -5383,31 +5682,31 @@ function intlcal_set_lenient($calendar, $isLenient) { } * <b>IntlCalendar::WALLTIME_LAST</b>. * @since 5.5 */ -function intlcal_get_repeated_wall_time_option($calendar) { } +function intlcal_get_repeated_wall_time_option(IntlCalendar $calendar): int {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Compare time of two IntlCalendar objects for equality - * @link https://www.php.net/manual/en/intlcalendar.equals.php - * @param IntlCalendar $calendarObject <p> + * @link https://secure.php.net/manual/en/intlcalendar.equals.php + * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @param IntlCalendar $calendar + * @param IntlCalendar $other * @return bool <p> * Returns <b>TRUE</b> if the current time of both this and the passed in - * {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} object are the same, or <b>FALSE</b> + * {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} object are the same, or <b>FALSE</b> * otherwise. The value <b>FALSE</b> can also be returned on failure. This can only * happen if bad arguments are passed in. In any case, the two cases can be - * distinguished by calling {@link https://www.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()}. + * distinguished by calling {@link https://secure.php.net/manual/en/function.intl-get-error-code.php intl_get_error_code()}. * </p> * @since 5.5 */ -function intlcal_equals($calendarObject, $calendar) { } +function intlcal_equals(IntlCalendar $calendar, IntlCalendar $other): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get behavior for handling skipped wall time - * @link https://www.php.net/manual/en/intlcalendar.getskippedwalltimeoption.php + * @link https://secure.php.net/manual/en/intlcalendar.getskippedwalltimeoption.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> @@ -5417,16 +5716,16 @@ function intlcal_equals($calendarObject, $calendar) { } * <b>IntlCalendar::WALLTIME_NEXT_VALID</b>. * @since 5.5 */ -function intlcal_get_skipped_wall_time_option($calendar) { } +function intlcal_get_skipped_wall_time_option(IntlCalendar $calendar): int {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set behavior for handling repeating wall times at negative timezone offset transitions - * @link https://www.php.net/manual/en/intlcalendar.setrepeatedwalltimeoption.php + * @link https://secure.php.net/manual/en/intlcalendar.setrepeatedwalltimeoption.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @param int $wallTimeOption <p> + * @param int $option <p> * One of the constants <b>IntlCalendar::WALLTIME_FIRST</b> or * <b>IntlCalendar::WALLTIME_LAST</b>. * </p> @@ -5434,16 +5733,16 @@ function intlcal_get_skipped_wall_time_option($calendar) { } * Returns <b>TRUE</b> on success. Failure can only happen due to invalid parameters. * @since 5.5 */ -function intlcal_set_repeated_wall_time_option($calendar, $wallTimeOption) { } +function intlcal_set_repeated_wall_time_option(IntlCalendar $calendar, int $option): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Set behavior for handling skipped wall times at positive timezone offset transitions - * @link https://www.php.net/manual/en/intlcalendar.setskippedwalltimeoption.php + * @link https://secure.php.net/manual/en/intlcalendar.setskippedwalltimeoption.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @param int $wallTimeOption <p> + * @param int $option <p> * One of the constants <b>IntlCalendar::WALLTIME_FIRST</b>, * <b>IntlCalendar::WALLTIME_LAST</b> or * <b>IntlCalendar::WALLTIME_NEXT_VALID</b>. @@ -5454,367 +5753,373 @@ function intlcal_set_repeated_wall_time_option($calendar, $wallTimeOption) { } * </p> * @since 5.5 */ -function intlcal_set_skipped_wall_time_option($calendar, $wallTimeOption) { } +function intlcal_set_skipped_wall_time_option(IntlCalendar $calendar, int $option): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a2)<br/> * Create an IntlCalendar from a DateTime object or string - * @link https://www.php.net/manual/en/intlcalendar.fromdatetime.php - * @param mixed $dateTime <p> - * A {@link https://www.php.net/manual/en/class.datetime.php DateTime} object or a {@link https://www.php.net/manual/en/language.types.string.php string} that - * can be passed to {@link https://www.php.net/manual/en/datetime.construct.php DateTime::__construct()}. - * </p> - * @return IntlCalendar - * The created {@link https://www.php.net/manual/en/class.intlcalendar.php IntlCalendar} object or <b>NULL</b> in case of - * failure. If a {@link https://www.php.net/manual/en/language.types.string.php string} is passed, any exception that occurs - * inside the {@link https://www.php.net/manual/en/class.datetime.php DateTime} constructor is propagated. + * @link https://secure.php.net/manual/en/intlcalendar.fromdatetime.php + * @param DateTime|string $datetime <p> + * A {@link https://secure.php.net/manual/en/class.datetime.php DateTime} object or a {@link https://secure.php.net/manual/en/language.types.string.php string} that + * can be passed to {@link https://secure.php.net/manual/en/datetime.construct.php DateTime::__construct()}. + * </p> + * @param null|string $locale + * @return IntlCalendar|null + * The created {@link https://secure.php.net/manual/en/class.intlcalendar.php IntlCalendar} object or <b>NULL</b> in case of + * failure. If a {@link https://secure.php.net/manual/en/language.types.string.php string} is passed, any exception that occurs + * inside the {@link https://secure.php.net/manual/en/class.datetime.php DateTime} constructor is propagated. * @since 5.5 */ -function intlcal_from_date_time($dateTime) { } - +function intlcal_from_date_time( + DateTime|string $datetime, + ?string $locale = null +): ?IntlCalendar {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a2)<br/> * Convert an IntlCalendar into a DateTime object - * @link https://www.php.net/manual/en/intlcalendar.todatetime.php + * @link https://secure.php.net/manual/en/intlcalendar.todatetime.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> * @return DateTime|false - * A {@link https://www.php.net/manual/en/class.datetime.php DateTime} object with the same timezone as this + * A {@link https://secure.php.net/manual/en/class.datetime.php DateTime} object with the same timezone as this * object (though using PHP's database instead of ICU's) and the same time, * except for the smaller precision (second precision instead of millisecond). * Returns <b>FALSE</b> on failure. * @since 5.5 */ -function intlcal_to_date_time($calendar) { } - +function intlcal_to_date_time(IntlCalendar $calendar): DateTime|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get last error code on the object - * @link https://www.php.net/manual/en/intlcalendar.geterrorcode.php + * @link https://secure.php.net/manual/en/intlcalendar.geterrorcode.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @return int An ICU error code indicating either success, failure or a warning. + * @return int|false An ICU error code indicating either success, failure or a warning. * @since 5.5 */ -function intlcal_get_error_code($calendar) { } +function intlcal_get_error_code(IntlCalendar $calendar): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get last error message on the object - * @link https://www.php.net/manual/en/intlcalendar.geterrormessage.php + * @link https://secure.php.net/manual/en/intlcalendar.geterrormessage.php * @param IntlCalendar $calendar <p> * The calendar object, on the procedural style interface. * </p> - * @return string The error message associated with last error that occurred in a function call on this object, or a string indicating the non-existance of an error. + * @return string|false The error message associated with last error that occurred in a function call on this object, or a string indicating the non-existance of an error. * @since 5.5 */ -function intlcal_get_error_message($calendar) { } - +function intlcal_get_error_message(IntlCalendar $calendar): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the number of IDs in the equivalency group that includes the given ID - * @link https://www.php.net/manual/en/intltimezone.countequivalentids.php - * @param string $zoneId - * @return int + * @link https://secure.php.net/manual/en/intltimezone.countequivalentids.php + * @param string $timezoneId + * @return int|false * @since 5.5 */ -function intltz_count_equivalent_ids($zoneId) { } +function intltz_count_equivalent_ids(string $timezoneId): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Create a new copy of the default timezone for this host - * @link https://www.php.net/manual/en/intltimezone.createdefault.php + * @link https://secure.php.net/manual/en/intltimezone.createdefault.php * @return IntlTimeZone * @since 5.5 */ -function intlz_create_default() { } +function intlz_create_default() {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> - * @link https://www.php.net/manual/en/intltimezone.createenumeration.php - * @param mixed $countryOrRawOffset [optional] - * @return IntlIterator + * @link https://secure.php.net/manual/en/intltimezone.createenumeration.php + * @param IntlTimeZone|string|int|float|null $countryOrRawOffset [optional] + * @return IntlIterator|false * @since 5.5 */ -function intltz_create_enumeration($countryOrRawOffset) { } +function intltz_create_enumeration($countryOrRawOffset): IntlIterator|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> - * @link https://www.php.net/manual/en/intltimezone.createtimezone.php - * @param string $zoneId - * @return IntlTimeZone + * @link https://secure.php.net/manual/en/intltimezone.createtimezone.php + * @param string $timezoneId + * @return IntlTimeZone|null * @since 5.5 */ -function intltz_create_time_zone($zoneId) { } +function intltz_create_time_zone(string $timezoneId): ?IntlTimeZone {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> - * @link https://www.php.net/manual/en/intltimezone.fromdatetimezone.php - * @param DateTimeZone $zoneId - * @return IntlTimeZone + * @link https://secure.php.net/manual/en/intltimezone.fromdatetimezone.php + * @param DateTimeZone $timezone + * @return IntlTimeZone|null * @since 5.5 */ -function intltz_from_date_time_zone($zoneId) { } +function intltz_from_date_time_zone(DateTimeZone $timezone): ?IntlTimeZone {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the canonical system timezone ID or the normalized custom time zone ID for the given time zone ID - * @link https://www.php.net/manual/en/intltimezone.getcanonicalid.php - * @param string $zoneId - * @param bool $isSystemID [optional] - * @return string + * @link https://secure.php.net/manual/en/intltimezone.getcanonicalid.php + * @param string $timezoneId + * @param bool &$isSystemId [optional] + * @return string|false * @since 5.5 */ -function intltz_get_canonical_id($zoneId, &$isSystemID) { } +function intltz_get_canonical_id(string $timezoneId, &$isSystemId): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get a name of this time zone suitable for presentation to the user - * @param IntlTimeZone $obj - <p> + * @param IntlTimeZone $timezone - <p> * The time zone object, on the procedural style interface. * </p> - * @param bool $isDaylight [optional] + * @param bool $dst [optional] * @param int $style [optional] - * @param string $locale [optional] - * @return string + * @param string|null $locale [optional] + * @return string|false * @since 5.5 */ -function intltz_get_display_name($obj, $isDaylight, $style, $locale) { } +function intltz_get_display_name(IntlTimeZone $timezone, bool $dst = false, int $style = 2, ?string $locale): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the amount of time to be added to local standard time to get local wall clock time - * @param IntlTimeZone $obj - <p> + * @param IntlTimeZone $timezone - <p> * The time zone object, on the procedural style interface. * </p> - * @link https://www.php.net/manual/en/intltimezone.getequivalentid.php * @return int + * @link https://secure.php.net/manual/en/intltimezone.getequivalentid.php * @since 5.5 */ -function intltz_get_dst_savings($obj) { } +function intltz_get_dst_savings(IntlTimeZone $timezone): int {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get an ID in the equivalency group that includes the given ID - * @link https://www.php.net/manual/en/intltimezone.getequivalentid.php - * @param string $zoneId - * @param int $index - * @return string + * @link https://secure.php.net/manual/en/intltimezone.getequivalentid.php + * @param string $timezoneId + * @param int $offset + * @return string|false * @since 5.5 */ -function intltz_get_equivalent_id($zoneId, $index) { } +function intltz_get_equivalent_id(string $timezoneId, int $offset): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get last error code on the object - * @link https://www.php.net/manual/en/intltimezone.geterrorcode.php - * @param IntlTimeZone $obj - <p> + * @link https://secure.php.net/manual/en/intltimezone.geterrorcode.php + * @param IntlTimeZone $timezone - <p> * The time zone object, on the procedural style interface. * </p> - * @return int + * @return int|false * @since 5.5 */ -function intltz_get_error_code($obj) { } +function intltz_get_error_code(IntlTimeZone $timezone): int|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get last error message on the object - * @link https://www.php.net/manual/en/intltimezone.geterrormessage.php - * @param IntlTimeZone $obj - <p> + * @link https://secure.php.net/manual/en/intltimezone.geterrormessage.php + * @param IntlTimeZone $timezone - <p> * The time zone object, on the procedural style interface. * </p> - * @return string + * @return string|false * @since 5.5 */ -function intltz_get_error_message($obj) { } +function intltz_get_error_message(IntlTimeZone $timezone): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Create GMT (UTC) timezone - * @link https://www.php.net/manual/en/intltimezone.getgmt.php + * @link https://secure.php.net/manual/en/intltimezone.getgmt.php * @return IntlTimeZone * @since 5.5 */ -function intltz_getGMT() { } +function intltz_getGMT(): IntlTimeZone {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get timezone ID - * @link https://www.php.net/manual/en/intltimezone.getid.php - * @param IntlTimeZone $obj - * @return string + * @link https://secure.php.net/manual/en/intltimezone.getid.php + * @param IntlTimeZone $timezone + * @return string|false * @since 5.5 */ -function intltz_get_id($obj) { } +function intltz_get_id(IntlTimeZone $timezone): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the time zone raw and GMT offset for the given moment in time - * @link https://www.php.net/manual/en/intltimezone.getoffset.php - * @param IntlTimeZone $obj - * @param float $date + * @link https://secure.php.net/manual/en/intltimezone.getoffset.php + * @param IntlTimeZone $timezone + * @param float $timestamp * @param bool $local - * @param int $rawOffset - * @param int $dstOffset - * @return int + * @param int &$rawOffset + * @param int &$dstOffset + * @return bool * @since 5.5 */ -function intltz_get_offset($obj, $date, $local, &$rawOffset, &$dstOffset) { } +function intltz_get_offset(IntlTimeZone $timezone, float $timestamp, bool $local, &$rawOffset, &$dstOffset): bool {} /** * Get the raw GMT offset (before taking daylight savings time into account - * @link https://www.php.net/manual/en/intltimezone.getrawoffset.php - * @param IntlTimeZone $obj + * @link https://secure.php.net/manual/en/intltimezone.getrawoffset.php + * @param IntlTimeZone $timezone * @return int */ -function intltz_get_raw_offset($obj) { } +function intltz_get_raw_offset(IntlTimeZone $timezone): int {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Get the timezone data version currently used by ICU - * @link https://www.php.net/manual/en/intltimezone.gettzdataversion.php - * @param IntlTimeZone $obj - * @return string + * @link https://secure.php.net/manual/en/intltimezone.gettzdataversion.php + * @return string|false * @since 5.5 */ -function intltz_get_tz_data_version($obj) { } +function intltz_get_tz_data_version(): string|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Check if this zone has the same rules and offset as another zone - * @link https://www.php.net/manual/en/intltimezone.hassamerules.php - * @param IntlTimeZone $obj - * @param IntlTimeZone $otherTimeZone + * @link https://secure.php.net/manual/en/intltimezone.hassamerules.php + * @param IntlTimeZone $timezone + * @param IntlTimeZone $other * @return bool * @since 5.5 */ -function intltz_has_same_rules($obj, $otherTimeZone) { } +function intltz_has_same_rules( + IntlTimeZone $timezone, + IntlTimeZone $other +): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Convert to DateTimeZone object - * @link https://www.php.net/manual/ru/intltimezone.todatetimezone.php - * @param $obj - * @return DateTimeZone + * @link https://secure.php.net/manual/en/intltimezone.todatetimezone.php + * @param IntlTimeZone $timezone + * @return DateTimeZone|false * @since 5.5 */ -function intltz_to_date_time_zone($obj) { } +function intltz_to_date_time_zone(IntlTimeZone $timezone): DateTimeZone|false {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> * Check if this time zone uses daylight savings time - * @link https://www.php.net/manual/ru/intltimezone.usedaylighttime.php - * @param $obj + * @link https://secure.php.net/manual/en/intltimezone.usedaylighttime.php + * @param IntlTimeZone $timezone * @return bool * @since 5.5 */ -function intltz_use_daylight_time($obj) { } - +function intltz_use_daylight_time(IntlTimeZone $timezone): bool {} /** * (PHP 5 >=5.5.0 PECL intl >= 3.0.0a1)<br/> - * @param mixed $timeZone - * @param string $locale - * @return IntlGregorianCalendar + * @param DateTimeZone|IntlTimeZone|string|int|null $timezoneOrYear [optional] + * @param string|null $localeOrMonth [optional] + * @param int $day [optional] + * @param int $hour [optional] + * @param int $minute [optional] + * @param int $second [optional] + * @return IntlGregorianCalendar|null * @since 5.5 */ -function intlgregcal_create_instance($timeZone = null, $locale = null) { } +function intlgregcal_create_instance($timezoneOrYear, $localeOrMonth, $day, $hour, $minute, $second): ?IntlGregorianCalendar {} /** - * @param IntlGregorianCalendar $obj - * @param double $change - * + * @param IntlGregorianCalendar $calendar + * @param float $timestamp + * @return bool */ -function intlgregcal_set_gregorian_change($obj, $change) { } +function intlgregcal_set_gregorian_change(IntlGregorianCalendar $calendar, float $timestamp): bool {} /** - * @param IntlGregorianCalendar $obj - * @return double $change + * @param IntlGregorianCalendar $calendar + * @return float */ -function intlgregcal_get_gregorian_change($obj) { } +function intlgregcal_get_gregorian_change(IntlGregorianCalendar $calendar): float {} /** + * @param IntlGregorianCalendar $calendar * @param int $year * @return bool */ -function intlgregcal_is_leap_year($year) { } - +function intlgregcal_is_leap_year(IntlGregorianCalendar $calendar, int $year): bool {} /** * (PHP >= 5.3.2, PECL intl >= 2.0.0)<br/> * Create a resource bundle * @link https://php.net/manual/en/resourcebundle.create.php - * @param string $locale <p> + * @param string|null $locale <p> * Locale for which the resources should be loaded (locale name, e.g. en_CA). * </p> - * @param string $bundlename <p> + * @param string|null $bundle <p> * The directory where the data is stored or the name of the .dat file. * </p> * @param bool $fallback [optional] <p> * Whether locale should match exactly or fallback to parent locale is allowed. * </p> - * @return ResourceBundle|false <b>ResourceBundle</b> object or <b>FALSE</b> on error. + * @return ResourceBundle|null <b>ResourceBundle</b> object or <b>NULL</b> on error. */ -function resourcebundle_create($locale, $bundlename, $fallback = null) { } +function resourcebundle_create(?string $locale, ?string $bundle, bool $fallback = true): ?ResourceBundle {} /** * (PHP >= 5.3.2, PECL intl >= 2.0.0)<br/> * Get data from the bundle * @link https://php.net/manual/en/resourcebundle.get.php - * @param ResourceBundle $r + * @param ResourceBundle $bundle * @param string|int $index <p> * Data index, must be string or integer. * </p> + * @param bool $fallback * @return mixed the data located at the index or <b>NULL</b> on error. Strings, integers and binary data strings * are returned as corresponding PHP types, integer array is returned as PHP array. Complex types are * returned as <b>ResourceBundle</b> object. */ -function resourcebundle_get(ResourceBundle $r, $index) { } +function resourcebundle_get(ResourceBundle $bundle, string|int $index, bool $fallback = true) {} /** * (PHP >= 5.3.2, PECL intl >= 2.0.0)<br/> * Get number of elements in the bundle * @link https://php.net/manual/en/resourcebundle.count.php - * @param ResourceBundle $r - * @param $bundle + * @param ResourceBundle $bundle * @return int number of elements in the bundle. */ -function resourcebundle_count(ResourceBundle $r, $bundle) { } +function resourcebundle_count(ResourceBundle $bundle): int {} /** * (PHP >= 5.3.2, PECL intl >= 2.0.0)<br/> * Get supported locales * @link https://php.net/manual/en/resourcebundle.locales.php - * @param string $bundlename <p> + * @param string $bundle <p> * Path of ResourceBundle for which to get available locales, or * empty string for default locales list. * </p> - * @return array the list of locales supported by the bundle. + * @return array|false the list of locales supported by the bundle. */ -function resourcebundle_locales($bundlename) { } +function resourcebundle_locales(string $bundle): array|false {} /** * (PHP >= 5.3.2, PECL intl >= 2.0.0)<br/> * Get bundle's last error code. * @link https://php.net/manual/en/resourcebundle.geterrorcode.php - * @param $bundle + * @param ResourceBundle $bundle * @return int error code from last bundle object call. */ -function resourcebundle_get_error_code(ResourceBundle $bundle) { } +function resourcebundle_get_error_code(ResourceBundle $bundle): int {} /** * (PHP >= 5.3.2, PECL intl >= 2.0.0)<br/> * Get bundle's last error message. * @link https://php.net/manual/en/resourcebundle.geterrormessage.php - * @param $bundle + * @param ResourceBundle $bundle * @return string error message from last bundle object's call. */ -function resourcebundle_get_error_message(ResourceBundle $bundle) { } +function resourcebundle_get_error_message(ResourceBundle $bundle): string {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> @@ -5823,9 +6128,9 @@ function resourcebundle_get_error_message(ResourceBundle $bundle) { } * @param string $id <p> * The id. * </p> - * @param int $direction [optional] <p> + * @param int $direction <p> * The direction, defaults to - * >Transliterator::FORWARD. + * Transliterator::FORWARD. * May also be set to * Transliterator::REVERSE. * </p> @@ -5833,7 +6138,7 @@ function resourcebundle_get_error_message(ResourceBundle $bundle) { } * or <b>NULL</b> on failure. * @since 5.4 */ -function transliterator_create($id, $direction = null) { } +function transliterator_create(string $id, int $direction = 0): ?Transliterator {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> @@ -5842,53 +6147,53 @@ function transliterator_create($id, $direction = null) { } * @param string $rules <p> * The rules. * </p> - * @param string $direction [optional] <p> + * @param int $direction <p> * The direction, defaults to - * >Transliterator::FORWARD. + * Transliterator::FORWARD. * May also be set to * Transliterator::REVERSE. * </p> - * @return Transliterator a <b>Transliterator</b> object on success, + * @return Transliterator|null a <b>Transliterator</b> object on success, * or <b>NULL</b> on failure. * @since 5.4 */ -function transliterator_create_from_rules($rules, $direction = null) { } +function transliterator_create_from_rules(string $rules, int $direction = 0): ?Transliterator {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Get transliterator IDs * @link https://php.net/manual/en/transliterator.listids.php - * @return array An array of registered transliterator IDs on success, + * @return string[]|false An array of registered transliterator IDs on success, * or <b>FALSE</b> on failure. * @since 5.4 */ -function transliterator_list_ids() { } +function transliterator_list_ids(): array|false {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Create an inverse transliterator * @link https://php.net/manual/en/transliterator.createinverse.php - * @param Transliterator $orig_trans - * @return Transliterator a <b>Transliterator</b> object on success, + * @param Transliterator $transliterator + * @return Transliterator|null a <b>Transliterator</b> object on success, * or <b>NULL</b> on failure * @since 5.4 */ -function transliterator_create_inverse(Transliterator $orig_trans) { } +function transliterator_create_inverse(Transliterator $transliterator): ?Transliterator {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Transliterate a string * @link https://php.net/manual/en/transliterator.transliterate.php * @param Transliterator|string $transliterator - * @param string $subject <p> + * @param string $string <p> * The string to be transformed. * </p> - * @param int $start [optional] <p> + * @param int $start <p> * The start index (in UTF-16 code units) from which the string will start * to be transformed, inclusive. Indexing starts at 0. The text before will * be left as is. * </p> - * @param int $end [optional] <p> + * @param int $end <p> * The end index (in UTF-16 code units) until which the string will be * transformed, exclusive. Indexing starts at 0. The text after will be * left as is. @@ -5896,29 +6201,29 @@ function transliterator_create_inverse(Transliterator $orig_trans) { } * @return string|false The transfomed string on success, or <b>FALSE</b> on failure. * @since 5.4 */ -function transliterator_transliterate($transliterator, $subject, $start = null, $end = null) { } +function transliterator_transliterate(Transliterator|string $transliterator, string $string, int $start = 0, int $end = -1): string|false {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Get last error code * @link https://php.net/manual/en/transliterator.geterrorcode.php - * @param Transliterator $trans - * @return int The error code on success, + * @param Transliterator $transliterator + * @return int|false The error code on success, * or <b>FALSE</b> if none exists, or on failure. * @since 5.4 */ -function transliterator_get_error_code(Transliterator $trans) { } +function transliterator_get_error_code(Transliterator $transliterator): int|false {} /** * (PHP >= 5.4.0, PECL intl >= 2.0.0)<br/> * Get last error message * @link https://php.net/manual/en/transliterator.geterrormessage.php - * @param Transliterator $trans - * @return string The error code on success, + * @param Transliterator $transliterator + * @return string|false The error code on success, * or <b>FALSE</b> if none exists, or on failure. * @since 5.4 */ -function transliterator_get_error_message(Transliterator $trans) { } +function transliterator_get_error_message(Transliterator $transliterator): string|false {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -5926,7 +6231,7 @@ function transliterator_get_error_message(Transliterator $trans) { } * @link https://php.net/manual/en/function.intl-get-error-code.php * @return int Error code returned by the last API function call. */ -function intl_get_error_code() { } +function intl_get_error_code(): int {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> @@ -5934,13 +6239,13 @@ function intl_get_error_code() { } * @link https://php.net/manual/en/function.intl-get-error-message.php * @return string Description of an error occurred in the last API function call. */ -function intl_get_error_message() { } +function intl_get_error_message(): string {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Check whether the given error code indicates failure * @link https://php.net/manual/en/function.intl-is-failure.php - * @param int $error_code <p> + * @param int $errorCode <p> * is a value that returned by functions: * <b>intl_get_error_code</b>, * <b>collator_get_error_code</b> . @@ -5948,56 +6253,66 @@ function intl_get_error_message() { } * @return bool <b>TRUE</b> if it the code indicates some failure, and <b>FALSE</b> * in case of success or a warning. */ -function intl_is_failure($error_code) { } +function intl_is_failure(int $errorCode): bool {} /** * (PHP 5 >= 5.3.0, PECL intl >= 1.0.0)<br/> * Get symbolic name for a given error code * @link https://php.net/manual/en/function.intl-error-name.php - * @param int $error_code <p> + * @param int $errorCode <p> * ICU error code. * </p> * @return string The returned string will be the same as the name of the error code * constant. */ -function intl_error_name($error_code) { } +function intl_error_name(int $errorCode): string {} /** * Gets the Decomposition_Mapping property for the given UTF-8 encoded code point * * @link https://www.php.net/manual/en/normalizer.getrawdecomposition.php * - * @param string $input + * @param string $string + * @param int $form * @return string|null * * @since 7.3 */ -function normalizer_get_raw_decomposition($input) { } +function normalizer_get_raw_decomposition(string $string, int $form = Normalizer::FORM_C): ?string {} /** + * @return IntlTimeZone * @since 5.5 */ -function intltz_create_default() { } +function intltz_create_default(): IntlTimeZone {} /** + * @return IntlTimeZone * @since 5.5 */ -function intltz_get_gmt() { } +function intltz_get_gmt(): IntlTimeZone {} /** + * @return IntlTimeZone * @since 5.5 */ -function intltz_get_unknown() { } +function intltz_get_unknown(): IntlTimeZone {} /** + * @param int $type + * @param null|string $region + * @param null|int $rawOffset + * @return IntlIterator|false * @since 5.5 */ -function intltz_create_time_zone_id_enumeration($zoneType, $region = null, $rawOffset = null) { } +function intltz_create_time_zone_id_enumeration(int $type, ?string $region = null, ?int $rawOffset = null): IntlIterator|false {} /** + * @param string $timezoneId + * @return string|false * @since 5.5 */ -function intltz_get_region($zoneId) { } +function intltz_get_region(string $timezoneId): string|false {} /** * Set minimal number of days the first week in a year or month can have @@ -6005,200 +6320,214 @@ function intltz_get_region($zoneId) { } * @link https://www.php.net/manual/en/intlcalendar.setminimaldaysinfirstweek.php * * @param IntlCalendar $calendar - * @param int $numberOfDays + * @param int $days * @return bool * * @since 5.5.1 */ -function intlcal_set_minimal_days_in_first_week(IntlCalendar $calendar, $numberOfDays) { } +function intlcal_set_minimal_days_in_first_week(IntlCalendar $calendar, int $days): bool {} + +function intltz_get_windows_id(string $timezoneId): string|false {} + +function intltz_get_id_for_windows_id(string $timezoneId, ?string $region = null): string|false {} + +/** + * @since 8.4 + */ +function grapheme_str_split(string $string, int $length = 1): array|false {} + +/** + * @since 8.4 + */ +function intltz_get_iana_id(string $timezoneId): string|false {} /** * Limit on locale length, set to 80 in PHP code. Locale names longer * than this limit will not be accepted. * @link https://php.net/manual/en/intl.constants.php */ -define ('INTL_MAX_LOCALE_LEN', 80); -define ('INTL_ICU_VERSION', "4.8.1.1"); -define ('INTL_ICU_DATA_VERSION', "4.8.1"); -define ('ULOC_ACTUAL_LOCALE', 0); -define ('ULOC_VALID_LOCALE', 1); -define ('GRAPHEME_EXTR_COUNT', 0); -define ('GRAPHEME_EXTR_MAXBYTES', 1); -define ('GRAPHEME_EXTR_MAXCHARS', 2); -define ('U_USING_FALLBACK_WARNING', -128); -define ('U_ERROR_WARNING_START', -128); -define ('U_USING_DEFAULT_WARNING', -127); -define ('U_SAFECLONE_ALLOCATED_WARNING', -126); -define ('U_STATE_OLD_WARNING', -125); -define ('U_STRING_NOT_TERMINATED_WARNING', -124); -define ('U_SORT_KEY_TOO_SHORT_WARNING', -123); -define ('U_AMBIGUOUS_ALIAS_WARNING', -122); -define ('U_DIFFERENT_UCA_VERSION', -121); -define ('U_ERROR_WARNING_LIMIT', -119); -define ('U_ZERO_ERROR', 0); -define ('U_ILLEGAL_ARGUMENT_ERROR', 1); -define ('U_MISSING_RESOURCE_ERROR', 2); -define ('U_INVALID_FORMAT_ERROR', 3); -define ('U_FILE_ACCESS_ERROR', 4); -define ('U_INTERNAL_PROGRAM_ERROR', 5); -define ('U_MESSAGE_PARSE_ERROR', 6); -define ('U_MEMORY_ALLOCATION_ERROR', 7); -define ('U_INDEX_OUTOFBOUNDS_ERROR', 8); -define ('U_PARSE_ERROR', 9); -define ('U_INVALID_CHAR_FOUND', 10); -define ('U_TRUNCATED_CHAR_FOUND', 11); -define ('U_ILLEGAL_CHAR_FOUND', 12); -define ('U_INVALID_TABLE_FORMAT', 13); -define ('U_INVALID_TABLE_FILE', 14); -define ('U_BUFFER_OVERFLOW_ERROR', 15); -define ('U_UNSUPPORTED_ERROR', 16); -define ('U_RESOURCE_TYPE_MISMATCH', 17); -define ('U_ILLEGAL_ESCAPE_SEQUENCE', 18); -define ('U_UNSUPPORTED_ESCAPE_SEQUENCE', 19); -define ('U_NO_SPACE_AVAILABLE', 20); -define ('U_CE_NOT_FOUND_ERROR', 21); -define ('U_PRIMARY_TOO_LONG_ERROR', 22); -define ('U_STATE_TOO_OLD_ERROR', 23); -define ('U_TOO_MANY_ALIASES_ERROR', 24); -define ('U_ENUM_OUT_OF_SYNC_ERROR', 25); -define ('U_INVARIANT_CONVERSION_ERROR', 26); -define ('U_INVALID_STATE_ERROR', 27); -define ('U_COLLATOR_VERSION_MISMATCH', 28); -define ('U_USELESS_COLLATOR_ERROR', 29); -define ('U_NO_WRITE_PERMISSION', 30); -define ('U_STANDARD_ERROR_LIMIT', 31); -define ('U_BAD_VARIABLE_DEFINITION', 65536); -define ('U_PARSE_ERROR_START', 65536); -define ('U_MALFORMED_RULE', 65537); -define ('U_MALFORMED_SET', 65538); -define ('U_MALFORMED_SYMBOL_REFERENCE', 65539); -define ('U_MALFORMED_UNICODE_ESCAPE', 65540); -define ('U_MALFORMED_VARIABLE_DEFINITION', 65541); -define ('U_MALFORMED_VARIABLE_REFERENCE', 65542); -define ('U_MISMATCHED_SEGMENT_DELIMITERS', 65543); -define ('U_MISPLACED_ANCHOR_START', 65544); -define ('U_MISPLACED_CURSOR_OFFSET', 65545); -define ('U_MISPLACED_QUANTIFIER', 65546); -define ('U_MISSING_OPERATOR', 65547); -define ('U_MISSING_SEGMENT_CLOSE', 65548); -define ('U_MULTIPLE_ANTE_CONTEXTS', 65549); -define ('U_MULTIPLE_CURSORS', 65550); -define ('U_MULTIPLE_POST_CONTEXTS', 65551); -define ('U_TRAILING_BACKSLASH', 65552); -define ('U_UNDEFINED_SEGMENT_REFERENCE', 65553); -define ('U_UNDEFINED_VARIABLE', 65554); -define ('U_UNQUOTED_SPECIAL', 65555); -define ('U_UNTERMINATED_QUOTE', 65556); -define ('U_RULE_MASK_ERROR', 65557); -define ('U_MISPLACED_COMPOUND_FILTER', 65558); -define ('U_MULTIPLE_COMPOUND_FILTERS', 65559); -define ('U_INVALID_RBT_SYNTAX', 65560); -define ('U_INVALID_PROPERTY_PATTERN', 65561); -define ('U_MALFORMED_PRAGMA', 65562); -define ('U_UNCLOSED_SEGMENT', 65563); -define ('U_ILLEGAL_CHAR_IN_SEGMENT', 65564); -define ('U_VARIABLE_RANGE_EXHAUSTED', 65565); -define ('U_VARIABLE_RANGE_OVERLAP', 65566); -define ('U_ILLEGAL_CHARACTER', 65567); -define ('U_INTERNAL_TRANSLITERATOR_ERROR', 65568); -define ('U_INVALID_ID', 65569); -define ('U_INVALID_FUNCTION', 65570); -define ('U_PARSE_ERROR_LIMIT', 65571); -define ('U_UNEXPECTED_TOKEN', 65792); -define ('U_FMT_PARSE_ERROR_START', 65792); -define ('U_MULTIPLE_DECIMAL_SEPARATORS', 65793); -define ('U_MULTIPLE_DECIMAL_SEPERATORS', 65793); -define ('U_MULTIPLE_EXPONENTIAL_SYMBOLS', 65794); -define ('U_MALFORMED_EXPONENTIAL_PATTERN', 65795); -define ('U_MULTIPLE_PERCENT_SYMBOLS', 65796); -define ('U_MULTIPLE_PERMILL_SYMBOLS', 65797); -define ('U_MULTIPLE_PAD_SPECIFIERS', 65798); -define ('U_PATTERN_SYNTAX_ERROR', 65799); -define ('U_ILLEGAL_PAD_POSITION', 65800); -define ('U_UNMATCHED_BRACES', 65801); -define ('U_UNSUPPORTED_PROPERTY', 65802); -define ('U_UNSUPPORTED_ATTRIBUTE', 65803); -define ('U_FMT_PARSE_ERROR_LIMIT', 65810); -define ('U_BRK_INTERNAL_ERROR', 66048); -define ('U_BRK_ERROR_START', 66048); -define ('U_BRK_HEX_DIGITS_EXPECTED', 66049); -define ('U_BRK_SEMICOLON_EXPECTED', 66050); -define ('U_BRK_RULE_SYNTAX', 66051); -define ('U_BRK_UNCLOSED_SET', 66052); -define ('U_BRK_ASSIGN_ERROR', 66053); -define ('U_BRK_VARIABLE_REDFINITION', 66054); -define ('U_BRK_MISMATCHED_PAREN', 66055); -define ('U_BRK_NEW_LINE_IN_QUOTED_STRING', 66056); -define ('U_BRK_UNDEFINED_VARIABLE', 66057); -define ('U_BRK_INIT_ERROR', 66058); -define ('U_BRK_RULE_EMPTY_SET', 66059); -define ('U_BRK_UNRECOGNIZED_OPTION', 66060); -define ('U_BRK_MALFORMED_RULE_TAG', 66061); -define ('U_BRK_ERROR_LIMIT', 66062); -define ('U_REGEX_INTERNAL_ERROR', 66304); -define ('U_REGEX_ERROR_START', 66304); -define ('U_REGEX_RULE_SYNTAX', 66305); -define ('U_REGEX_INVALID_STATE', 66306); -define ('U_REGEX_BAD_ESCAPE_SEQUENCE', 66307); -define ('U_REGEX_PROPERTY_SYNTAX', 66308); -define ('U_REGEX_UNIMPLEMENTED', 66309); -define ('U_REGEX_MISMATCHED_PAREN', 66310); -define ('U_REGEX_NUMBER_TOO_BIG', 66311); -define ('U_REGEX_BAD_INTERVAL', 66312); -define ('U_REGEX_MAX_LT_MIN', 66313); -define ('U_REGEX_INVALID_BACK_REF', 66314); -define ('U_REGEX_INVALID_FLAG', 66315); -define ('U_REGEX_LOOK_BEHIND_LIMIT', 66316); -define ('U_REGEX_SET_CONTAINS_STRING', 66317); -define ('U_REGEX_ERROR_LIMIT', 66324); -define ('U_IDNA_PROHIBITED_ERROR', 66560); -define ('U_IDNA_ERROR_START', 66560); -define ('U_IDNA_UNASSIGNED_ERROR', 66561); -define ('U_IDNA_CHECK_BIDI_ERROR', 66562); -define ('U_IDNA_STD3_ASCII_RULES_ERROR', 66563); -define ('U_IDNA_ACE_PREFIX_ERROR', 66564); -define ('U_IDNA_VERIFICATION_ERROR', 66565); -define ('U_IDNA_LABEL_TOO_LONG_ERROR', 66566); -define ('U_IDNA_ZERO_LENGTH_LABEL_ERROR', 66567); -define ('U_IDNA_DOMAIN_NAME_TOO_LONG_ERROR', 66568); -define ('U_IDNA_ERROR_LIMIT', 66569); -define ('U_STRINGPREP_PROHIBITED_ERROR', 66560); -define ('U_STRINGPREP_UNASSIGNED_ERROR', 66561); -define ('U_STRINGPREP_CHECK_BIDI_ERROR', 66562); -define ('U_ERROR_LIMIT', 66818); +define('INTL_MAX_LOCALE_LEN', 156); +define('INTL_ICU_VERSION', "74.1"); +define('INTL_ICU_DATA_VERSION', "74.1"); +define('ULOC_ACTUAL_LOCALE', 0); +define('ULOC_VALID_LOCALE', 1); +define('GRAPHEME_EXTR_COUNT', 0); +define('GRAPHEME_EXTR_MAXBYTES', 1); +define('GRAPHEME_EXTR_MAXCHARS', 2); +define('U_USING_FALLBACK_WARNING', -128); +define('U_ERROR_WARNING_START', -128); +define('U_USING_DEFAULT_WARNING', -127); +define('U_SAFECLONE_ALLOCATED_WARNING', -126); +define('U_STATE_OLD_WARNING', -125); +define('U_STRING_NOT_TERMINATED_WARNING', -124); +define('U_SORT_KEY_TOO_SHORT_WARNING', -123); +define('U_AMBIGUOUS_ALIAS_WARNING', -122); +define('U_DIFFERENT_UCA_VERSION', -121); +define('U_ERROR_WARNING_LIMIT', -119); +define('U_ZERO_ERROR', 0); +define('U_ILLEGAL_ARGUMENT_ERROR', 1); +define('U_MISSING_RESOURCE_ERROR', 2); +define('U_INVALID_FORMAT_ERROR', 3); +define('U_FILE_ACCESS_ERROR', 4); +define('U_INTERNAL_PROGRAM_ERROR', 5); +define('U_MESSAGE_PARSE_ERROR', 6); +define('U_MEMORY_ALLOCATION_ERROR', 7); +define('U_INDEX_OUTOFBOUNDS_ERROR', 8); +define('U_PARSE_ERROR', 9); +define('U_INVALID_CHAR_FOUND', 10); +define('U_TRUNCATED_CHAR_FOUND', 11); +define('U_ILLEGAL_CHAR_FOUND', 12); +define('U_INVALID_TABLE_FORMAT', 13); +define('U_INVALID_TABLE_FILE', 14); +define('U_BUFFER_OVERFLOW_ERROR', 15); +define('U_UNSUPPORTED_ERROR', 16); +define('U_RESOURCE_TYPE_MISMATCH', 17); +define('U_ILLEGAL_ESCAPE_SEQUENCE', 18); +define('U_UNSUPPORTED_ESCAPE_SEQUENCE', 19); +define('U_NO_SPACE_AVAILABLE', 20); +define('U_CE_NOT_FOUND_ERROR', 21); +define('U_PRIMARY_TOO_LONG_ERROR', 22); +define('U_STATE_TOO_OLD_ERROR', 23); +define('U_TOO_MANY_ALIASES_ERROR', 24); +define('U_ENUM_OUT_OF_SYNC_ERROR', 25); +define('U_INVARIANT_CONVERSION_ERROR', 26); +define('U_INVALID_STATE_ERROR', 27); +define('U_COLLATOR_VERSION_MISMATCH', 28); +define('U_USELESS_COLLATOR_ERROR', 29); +define('U_NO_WRITE_PERMISSION', 30); +define('U_STANDARD_ERROR_LIMIT', 32); +define('U_BAD_VARIABLE_DEFINITION', 65536); +define('U_PARSE_ERROR_START', 65536); +define('U_MALFORMED_RULE', 65537); +define('U_MALFORMED_SET', 65538); +define('U_MALFORMED_SYMBOL_REFERENCE', 65539); +define('U_MALFORMED_UNICODE_ESCAPE', 65540); +define('U_MALFORMED_VARIABLE_DEFINITION', 65541); +define('U_MALFORMED_VARIABLE_REFERENCE', 65542); +define('U_MISMATCHED_SEGMENT_DELIMITERS', 65543); +define('U_MISPLACED_ANCHOR_START', 65544); +define('U_MISPLACED_CURSOR_OFFSET', 65545); +define('U_MISPLACED_QUANTIFIER', 65546); +define('U_MISSING_OPERATOR', 65547); +define('U_MISSING_SEGMENT_CLOSE', 65548); +define('U_MULTIPLE_ANTE_CONTEXTS', 65549); +define('U_MULTIPLE_CURSORS', 65550); +define('U_MULTIPLE_POST_CONTEXTS', 65551); +define('U_TRAILING_BACKSLASH', 65552); +define('U_UNDEFINED_SEGMENT_REFERENCE', 65553); +define('U_UNDEFINED_VARIABLE', 65554); +define('U_UNQUOTED_SPECIAL', 65555); +define('U_UNTERMINATED_QUOTE', 65556); +define('U_RULE_MASK_ERROR', 65557); +define('U_MISPLACED_COMPOUND_FILTER', 65558); +define('U_MULTIPLE_COMPOUND_FILTERS', 65559); +define('U_INVALID_RBT_SYNTAX', 65560); +define('U_INVALID_PROPERTY_PATTERN', 65561); +define('U_MALFORMED_PRAGMA', 65562); +define('U_UNCLOSED_SEGMENT', 65563); +define('U_ILLEGAL_CHAR_IN_SEGMENT', 65564); +define('U_VARIABLE_RANGE_EXHAUSTED', 65565); +define('U_VARIABLE_RANGE_OVERLAP', 65566); +define('U_ILLEGAL_CHARACTER', 65567); +define('U_INTERNAL_TRANSLITERATOR_ERROR', 65568); +define('U_INVALID_ID', 65569); +define('U_INVALID_FUNCTION', 65570); +define('U_PARSE_ERROR_LIMIT', 65571); +define('U_UNEXPECTED_TOKEN', 65792); +define('U_FMT_PARSE_ERROR_START', 65792); +define('U_MULTIPLE_DECIMAL_SEPARATORS', 65793); +define('U_MULTIPLE_DECIMAL_SEPERATORS', 65793); +define('U_MULTIPLE_EXPONENTIAL_SYMBOLS', 65794); +define('U_MALFORMED_EXPONENTIAL_PATTERN', 65795); +define('U_MULTIPLE_PERCENT_SYMBOLS', 65796); +define('U_MULTIPLE_PERMILL_SYMBOLS', 65797); +define('U_MULTIPLE_PAD_SPECIFIERS', 65798); +define('U_PATTERN_SYNTAX_ERROR', 65799); +define('U_ILLEGAL_PAD_POSITION', 65800); +define('U_UNMATCHED_BRACES', 65801); +define('U_UNSUPPORTED_PROPERTY', 65802); +define('U_UNSUPPORTED_ATTRIBUTE', 65803); +define('U_FMT_PARSE_ERROR_LIMIT', 65812); +define('U_BRK_INTERNAL_ERROR', 66048); +define('U_BRK_ERROR_START', 66048); +define('U_BRK_HEX_DIGITS_EXPECTED', 66049); +define('U_BRK_SEMICOLON_EXPECTED', 66050); +define('U_BRK_RULE_SYNTAX', 66051); +define('U_BRK_UNCLOSED_SET', 66052); +define('U_BRK_ASSIGN_ERROR', 66053); +define('U_BRK_VARIABLE_REDFINITION', 66054); +define('U_BRK_MISMATCHED_PAREN', 66055); +define('U_BRK_NEW_LINE_IN_QUOTED_STRING', 66056); +define('U_BRK_UNDEFINED_VARIABLE', 66057); +define('U_BRK_INIT_ERROR', 66058); +define('U_BRK_RULE_EMPTY_SET', 66059); +define('U_BRK_UNRECOGNIZED_OPTION', 66060); +define('U_BRK_MALFORMED_RULE_TAG', 66061); +define('U_BRK_ERROR_LIMIT', 66062); +define('U_REGEX_INTERNAL_ERROR', 66304); +define('U_REGEX_ERROR_START', 66304); +define('U_REGEX_RULE_SYNTAX', 66305); +define('U_REGEX_INVALID_STATE', 66306); +define('U_REGEX_BAD_ESCAPE_SEQUENCE', 66307); +define('U_REGEX_PROPERTY_SYNTAX', 66308); +define('U_REGEX_UNIMPLEMENTED', 66309); +define('U_REGEX_MISMATCHED_PAREN', 66310); +define('U_REGEX_NUMBER_TOO_BIG', 66311); +define('U_REGEX_BAD_INTERVAL', 66312); +define('U_REGEX_MAX_LT_MIN', 66313); +define('U_REGEX_INVALID_BACK_REF', 66314); +define('U_REGEX_INVALID_FLAG', 66315); +define('U_REGEX_LOOK_BEHIND_LIMIT', 66316); +define('U_REGEX_SET_CONTAINS_STRING', 66317); +define('U_REGEX_ERROR_LIMIT', 66326); +define('U_IDNA_PROHIBITED_ERROR', 66560); +define('U_IDNA_ERROR_START', 66560); +define('U_IDNA_UNASSIGNED_ERROR', 66561); +define('U_IDNA_CHECK_BIDI_ERROR', 66562); +define('U_IDNA_STD3_ASCII_RULES_ERROR', 66563); +define('U_IDNA_ACE_PREFIX_ERROR', 66564); +define('U_IDNA_VERIFICATION_ERROR', 66565); +define('U_IDNA_LABEL_TOO_LONG_ERROR', 66566); +define('U_IDNA_ZERO_LENGTH_LABEL_ERROR', 66567); +define('U_IDNA_DOMAIN_NAME_TOO_LONG_ERROR', 66568); +define('U_IDNA_ERROR_LIMIT', 66569); +define('U_STRINGPREP_PROHIBITED_ERROR', 66560); +define('U_STRINGPREP_UNASSIGNED_ERROR', 66561); +define('U_STRINGPREP_CHECK_BIDI_ERROR', 66562); +define('U_ERROR_LIMIT', 66818); /** * Prohibit processing of unassigned codepoints in the input for IDN * functions and do not check if the input conforms to domain name ASCII rules. * @link https://php.net/manual/en/intl.constants.php */ -define ('IDNA_DEFAULT', 0); +define('IDNA_DEFAULT', 0); /** * Allow processing of unassigned codepoints in the input for IDN functions. * @link https://php.net/manual/en/intl.constants.php */ -define ('IDNA_ALLOW_UNASSIGNED', 1); +define('IDNA_ALLOW_UNASSIGNED', 1); /** * Check if the input for IDN functions conforms to domain name ASCII rules. * @link https://php.net/manual/en/intl.constants.php */ -define ('IDNA_USE_STD3_RULES', 2); +define('IDNA_USE_STD3_RULES', 2); /** * Check whether the input conforms to the BiDi rules. * Ignored by the IDNA2003 implementation, which always performs this check. * @link https://php.net/manual/en/intl.constants.php */ -define ('IDNA_CHECK_BIDI', 4); +define('IDNA_CHECK_BIDI', 4); /** * Check whether the input conforms to the CONTEXTJ rules. * Ignored by the IDNA2003 implementation, as this check is new in IDNA2008. * @link https://php.net/manual/en/intl.constants.php */ -define ('IDNA_CHECK_CONTEXTJ', 8); +define('IDNA_CHECK_CONTEXTJ', 8); /** * Option for nontransitional processing in @@ -6206,7 +6535,7 @@ define ('IDNA_CHECK_CONTEXTJ', 8); * by default. This option is ignored by the IDNA2003 implementation. * @link https://php.net/manual/en/intl.constants.php */ -define ('IDNA_NONTRANSITIONAL_TO_ASCII', 16); +define('IDNA_NONTRANSITIONAL_TO_ASCII', 16); /** * Option for nontransitional processing in @@ -6214,23 +6543,22 @@ define ('IDNA_NONTRANSITIONAL_TO_ASCII', 16); * by default. This option is ignored by the IDNA2003 implementation. * @link https://php.net/manual/en/intl.constants.php */ -define ('IDNA_NONTRANSITIONAL_TO_UNICODE', 32); +define('IDNA_NONTRANSITIONAL_TO_UNICODE', 32); /** * Use IDNA 2003 algorithm in {@see idn_to_utf8} and * {@see idn_to_ascii}. This is the default. * @link https://php.net/manual/en/intl.constants.php * @deprecated 7.2 Use {@see INTL_IDNA_VARIANT_UTS46} instead. - * @removed 8.0 */ -define ('INTL_IDNA_VARIANT_2003', 0); +define('INTL_IDNA_VARIANT_2003', 0); /** * Use UTS #46 algorithm in <b>idn_to_utf8</b> and * <b>idn_to_ascii</b>. * @link https://php.net/manual/en/intl.constants.php */ -define ('INTL_IDNA_VARIANT_UTS46', 1); +define('INTL_IDNA_VARIANT_UTS46', 1); /** * Errors reported in a bitset returned by the UTS #46 algorithm in @@ -6238,67 +6566,67 @@ define ('INTL_IDNA_VARIANT_UTS46', 1); * <b>idn_to_ascii</b>. * @link https://php.net/manual/en/intl.constants.php */ -define ('IDNA_ERROR_EMPTY_LABEL', 1); +define('IDNA_ERROR_EMPTY_LABEL', 1); /** - * @link https://www.php.net/manual/en/migration54.global-constants.php + * @link https://secure.php.net/manual/en/migration54.global-constants.php * @since 5.4 */ -define ('IDNA_ERROR_LABEL_TOO_LONG', 2); +define('IDNA_ERROR_LABEL_TOO_LONG', 2); /** - * @link https://www.php.net/manual/en/migration54.global-constants.php + * @link https://secure.php.net/manual/en/migration54.global-constants.php * @since 5.4 */ -define ('IDNA_ERROR_DOMAIN_NAME_TOO_LONG', 4); +define('IDNA_ERROR_DOMAIN_NAME_TOO_LONG', 4); /** - * @link https://www.php.net/manual/en/migration54.global-constants.php + * @link https://secure.php.net/manual/en/migration54.global-constants.php * @since 5.4 */ -define ('IDNA_ERROR_LEADING_HYPHEN', 8); +define('IDNA_ERROR_LEADING_HYPHEN', 8); /** - * @link https://www.php.net/manual/en/migration54.global-constants.php + * @link https://secure.php.net/manual/en/migration54.global-constants.php * @since 5.4 */ -define ('IDNA_ERROR_TRAILING_HYPHEN', 16); +define('IDNA_ERROR_TRAILING_HYPHEN', 16); /** - * @link https://www.php.net/manual/en/migration54.global-constants.php + * @link https://secure.php.net/manual/en/migration54.global-constants.php * @since 5.4 */ -define ('IDNA_ERROR_HYPHEN_3_4', 32); +define('IDNA_ERROR_HYPHEN_3_4', 32); /** - * @link https://www.php.net/manual/en/migration54.global-constants.php + * @link https://secure.php.net/manual/en/migration54.global-constants.php * @since 5.4 */ -define ('IDNA_ERROR_LEADING_COMBINING_MARK', 64); +define('IDNA_ERROR_LEADING_COMBINING_MARK', 64); /** - * @link https://www.php.net/manual/en/migration54.global-constants.php + * @link https://secure.php.net/manual/en/migration54.global-constants.php * @since 5.4 */ -define ('IDNA_ERROR_DISALLOWED', 128); +define('IDNA_ERROR_DISALLOWED', 128); /** - * @link https://www.php.net/manual/en/migration54.global-constants.php + * @link https://secure.php.net/manual/en/migration54.global-constants.php * @since 5.4 */ -define ('IDNA_ERROR_PUNYCODE', 256); +define('IDNA_ERROR_PUNYCODE', 256); /** - * @link https://www.php.net/manual/en/migration54.global-constants.php + * @link https://secure.php.net/manual/en/migration54.global-constants.php * @since 5.4 */ -define ('IDNA_ERROR_LABEL_HAS_DOT', 512); +define('IDNA_ERROR_LABEL_HAS_DOT', 512); /** - * @link https://www.php.net/manual/en/migration54.global-constants.php + * @link https://secure.php.net/manual/en/migration54.global-constants.php * @since 5.4 */ -define ('IDNA_ERROR_INVALID_ACE_LABEL', 1024); +define('IDNA_ERROR_INVALID_ACE_LABEL', 1024); /** - * @link https://www.php.net/manual/en/migration54.global-constants.php + * @link https://secure.php.net/manual/en/migration54.global-constants.php * @since 5.4 */ -define ('IDNA_ERROR_BIDI', 2048); +define('IDNA_ERROR_BIDI', 2048); /** - * @link https://www.php.net/manual/en/migration54.global-constants.php + * @link https://secure.php.net/manual/en/migration54.global-constants.php * @since 5.4 */ -define ('IDNA_ERROR_CONTEXTJ', 4096); +define('IDNA_ERROR_CONTEXTJ', 4096); /** * @since 5.5 @@ -6306,368 +6634,396 @@ define ('IDNA_ERROR_CONTEXTJ', 4096); class IntlBreakIterator implements IteratorAggregate { /* Constants */ - const DONE = -1; - const WORD_NONE = 0; - const WORD_NONE_LIMIT = 100; - const WORD_NUMBER = 100; - const WORD_NUMBER_LIMIT = 200; - const WORD_LETTER = 200; - const WORD_LETTER_LIMIT = 300; - const WORD_KANA = 300; - const WORD_KANA_LIMIT = 400; - const WORD_IDEO = 400; - const WORD_IDEO_LIMIT = 500; - const LINE_SOFT = 0; - const LINE_SOFT_LIMIT = 100; - const LINE_HARD = 100; - const LINE_HARD_LIMIT = 200; - const SENTENCE_TERM = 0; - const SENTENCE_TERM_LIMIT = 100; - const SENTENCE_SEP = 100; - const SENTENCE_SEP_LIMIT = 200; + public const DONE = -1; + public const WORD_NONE = 0; + public const WORD_NONE_LIMIT = 100; + public const WORD_NUMBER = 100; + public const WORD_NUMBER_LIMIT = 200; + public const WORD_LETTER = 200; + public const WORD_LETTER_LIMIT = 300; + public const WORD_KANA = 300; + public const WORD_KANA_LIMIT = 400; + public const WORD_IDEO = 400; + public const WORD_IDEO_LIMIT = 500; + public const LINE_SOFT = 0; + public const LINE_SOFT_LIMIT = 100; + public const LINE_HARD = 100; + public const LINE_HARD_LIMIT = 200; + public const SENTENCE_TERM = 0; + public const SENTENCE_TERM_LIMIT = 100; + public const SENTENCE_SEP = 100; + public const SENTENCE_SEP_LIMIT = 200; /* Methods */ /** * (PHP 5 >=5.5.0)<br/> * Private constructor for disallowing instantiation */ - private function __construct() { } + private function __construct() {} /** * (PHP 5 >=5.5.0)<br/> * Create break iterator for boundaries of combining character sequences - * @link https://www.php.net/manual/en/intlbreakiterator.createcharacterinstance.php + * @link https://secure.php.net/manual/en/intlbreakiterator.createcharacterinstance.php * @param string $locale - * @return IntlBreakIterator + * @return IntlBreakIterator|null */ - public static function createCharacterInstance($locale = null) { } + public static function createCharacterInstance(string|null $locale = null): ?IntlBreakIterator {} /** * (PHP 5 >=5.5.0)<br/> * Create break iterator for boundaries of code points - * @link https://www.php.net/manual/en/intlbreakiterator.createcodepointinstance.php - * @return IntlBreakIterator + * @link https://secure.php.net/manual/en/intlbreakiterator.createcodepointinstance.php + * @return IntlCodePointBreakIterator */ - public static function createCodePointInstance() { } + public static function createCodePointInstance(): IntlCodePointBreakIterator {} /** * (PHP 5 >=5.5.0)<br/> * Create break iterator for logically possible line breaks - * @link https://www.php.net/manual/en/intlbreakiterator.createlineinstance.php - * @param string $locale - * @return IntlBreakIterator + * @link https://secure.php.net/manual/en/intlbreakiterator.createlineinstance.php + * @param string $locale [optional] + * @return IntlBreakIterator|null */ - public static function createLineInstance($locale) { } + public static function createLineInstance(string|null $locale): ?IntlBreakIterator {} /** * (PHP 5 >=5.5.0)<br/> * Create break iterator for sentence breaks - * @link https://www.php.net/manual/en/intlbreakiterator.createsentenceinstance.php - * @param string $locale - * @return IntlBreakIterator + * @link https://secure.php.net/manual/en/intlbreakiterator.createsentenceinstance.php + * @param string $locale [optional] + * @return IntlBreakIterator|null */ - public static function createSentenceInstance($locale) { } + public static function createSentenceInstance(string|null $locale): ?IntlBreakIterator {} /** * (PHP 5 >=5.5.0)<br/> * Create break iterator for title-casing breaks - * @link https://www.php.net/manual/en/intlbreakiterator.createtitleinstance.php - * @param string $locale - * @return IntlBreakIterator + * @link https://secure.php.net/manual/en/intlbreakiterator.createtitleinstance.php + * @param string $locale [optional] + * @return IntlBreakIterator|null */ - public static function createTitleInstance($locale) { } + public static function createTitleInstance(string|null $locale): ?IntlBreakIterator {} /** * (PHP 5 >=5.5.0)<br/> * Create break iterator for word breaks - * @link https://www.php.net/manual/en/intlbreakiterator.createwordinstance.php - * @param string $locale - * @return IntlBreakIterator + * @link https://secure.php.net/manual/en/intlbreakiterator.createwordinstance.php + * @param string $locale [optional] + * @return IntlBreakIterator|null */ - public static function createWordInstance($locale) { } + public static function createWordInstance(string|null $locale): ?IntlBreakIterator {} /** * (PHP 5 >=5.5.0)<br/> * Get index of current position - * @link https://www.php.net/manual/en/intlbreakiterator.current.php + * @link https://secure.php.net/manual/en/intlbreakiterator.current.php * @return int */ - public function current() { } + public function current(): int {} /** * (PHP 5 >=5.5.0)<br/> * Set position to the first character in the text - * @link https://www.php.net/manual/en/intlbreakiterator.first.php + * @link https://secure.php.net/manual/en/intlbreakiterator.first.php */ - public function first() { } + public function first(): int {} /** * (PHP 5 >=5.5.0)<br/> * Advance the iterator to the first boundary following specified offset - * @link https://www.php.net/manual/en/intlbreakiterator.following.php + * @link https://secure.php.net/manual/en/intlbreakiterator.following.php * @param int $offset */ - public function following($offset) { } + public function following(int $offset): int {} /** * (PHP 5 >=5.5.0)<br/> * Get last error code on the object - * @link https://www.php.net/manual/en/intlbreakiterator.geterrorcode.php + * @link https://secure.php.net/manual/en/intlbreakiterator.geterrorcode.php * @return int */ - public function getErrorCode() { } + public function getErrorCode(): int {} /** * (PHP 5 >=5.5.0)<br/> * Get last error message on the object - * @link https://www.php.net/manual/en/intlbreakiterator.geterrormessage.php + * @link https://secure.php.net/manual/en/intlbreakiterator.geterrormessage.php * @return string */ - public function getErrorMessage() { } - + public function getErrorMessage(): string {} /** * (PHP 5 >=5.5.0)<br/> * Get the locale associated with the object - * @link https://www.php.net/manual/en/intlbreakiterator.getlocale.php - * @param string $locale_type + * @link https://secure.php.net/manual/en/intlbreakiterator.getlocale.php + * @param string $type */ - public function getLocale($locale_type) { } + public function getLocale(int $type): string|false {} /** * (PHP 5 >=5.5.0)<br/> * Create iterator for navigating fragments between boundaries - * @link https://www.php.net/manual/en/intlbreakiterator.getpartsiterator.php - * @param string $key_type [optional] + * @link https://secure.php.net/manual/en/intlbreakiterator.getpartsiterator.php + * @param int $type [optional] + * <p> + * Optional key type. Possible values are: + * </p><ul> + * <li> + * {@see IntlPartsIterator::KEY_SEQUENTIAL} + * - The default. Sequentially increasing integers used as key. + * </li> + * <li> + * {@see IntlPartsIterator::KEY_LEFT} + * - Byte offset left of current part used as key. + * </li> + * <li> + * {@see IntlPartsIterator::KEY_RIGHT} + * - Byte offset right of current part used as key. + * </li> + * </ul> */ - public function getPartsIterator($key_type = IntlPartsIterator::KEY_SEQUENTIAL) { } + public function getPartsIterator( + int $type = IntlPartsIterator::KEY_SEQUENTIAL + ): IntlPartsIterator {} /** * (PHP 5 >=5.5.0)<br/> * Get the text being scanned - * @link https://www.php.net/manual/en/intlbreakiterator.gettext.php + * @link https://secure.php.net/manual/en/intlbreakiterator.gettext.php */ - public function getText() { } + public function getText(): ?string {} /** * (PHP 5 >=5.5.0)<br/> * Tell whether an offset is a boundary's offset - * @link https://www.php.net/manual/en/intlbreakiterator.isboundary.php - * @param string $offset + * @link https://secure.php.net/manual/en/intlbreakiterator.isboundary.php + * @param int $offset */ - public function isBoundary($offset) { } + public function isBoundary(int $offset): bool {} /** * (PHP 5 >=5.5.0)<br/> * Set the iterator position to index beyond the last character - * @link https://www.php.net/manual/en/intlbreakiterator.last.php + * @link https://secure.php.net/manual/en/intlbreakiterator.last.php * @return int */ - public function last() { } + public function last(): int {} /** * (PHP 5 >=5.5.0)<br/> - * @link https://www.php.net/manual/en/intlbreakiterator.next.php - * @param string $offset [optional] + * @link https://secure.php.net/manual/en/intlbreakiterator.next.php + * @param int $offset [optional] * @return int */ - public function next($offset = null) { } + public function next(int|null $offset = null): int {} /** * (PHP 5 >=5.5.0)<br/> - * @link https://www.php.net/manual/en/intlbreakiterator.preceding.php + * @link https://secure.php.net/manual/en/intlbreakiterator.preceding.php * @param int $offset */ - public function preceding($offset) { } + public function preceding(int $offset): int {} /** * (PHP 5 >=5.5.0)<br/> * Set the iterator position to the boundary immediately before the current - * @link https://www.php.net/manual/en/intlbreakiterator.previous.php + * @link https://secure.php.net/manual/en/intlbreakiterator.previous.php * @return int */ - public function previous() { } + public function previous(): int {} /** * (PHP 5 >=5.5.0)<br/> * Set the text being scanned - * @link https://www.php.net/manual/en/intlbreakiterator.settext.php + * @link https://secure.php.net/manual/en/intlbreakiterator.settext.php * @param string $text */ - public function setText($text) { } + public function setText(string $text): bool {} - public function getIterator(){} + /** + * @since 8.0 + * @return Iterator + */ + public function getIterator(): Iterator {} } -class IntlRuleBasedBreakIterator extends IntlBreakIterator implements Traversable { - +class IntlRuleBasedBreakIterator extends IntlBreakIterator implements Traversable +{ /* Methods */ /** * (PHP 5 >=5.5.0)<br/> - * @link https://www.php.net/manual/en/intlbreakiterator.construct.php + * @link https://secure.php.net/manual/en/intlbreakiterator.construct.php * @param string $rules - * @param string $areCompiled [optional] + * @param string $compiled [optional] */ - public function __construct($rules, $areCompiled) { } + public function __construct( + string $rules, + bool $compiled = false + ) {} /** * (PHP 5 >=5.5.0)<br/> * Create break iterator for boundaries of combining character sequences - * @link https://www.php.net/manual/en/intlbreakiterator.createcharacterinstance.php + * @link https://secure.php.net/manual/en/intlbreakiterator.createcharacterinstance.php * @param string $locale * @return IntlRuleBasedBreakIterator */ - public static function createCharacterInstance($locale) { } + public static function createCharacterInstance($locale) {} - /* + /** * (PHP 5 >=5.5.0)<br/> * Create break iterator for boundaries of code points - * @link https://www.php.net/manual/en/intlbreakiterator.createcodepointinstance.php + * @link https://secure.php.net/manual/en/intlbreakiterator.createcodepointinstance.php * @return IntlRuleBasedBreakIterator */ - public static function createCodePointInstance() { } + public static function createCodePointInstance() {} /** * (PHP 5 >=5.5.0)<br/> * Create break iterator for logically possible line breaks - * @link https://www.php.net/manual/en/intlbreakiterator.createlineinstance.php - * @param string $locale + * @link https://secure.php.net/manual/en/intlbreakiterator.createlineinstance.php + * @param string $locale [optional] * @return IntlRuleBasedBreakIterator */ - public static function createLineInstance($locale) { } + public static function createLineInstance($locale) {} /** * (PHP 5 >=5.5.0)<br/> * Create break iterator for sentence breaks - * @link https://www.php.net/manual/en/intlbreakiterator.createsentenceinstance.php - * @param string $locale + * @link https://secure.php.net/manual/en/intlbreakiterator.createsentenceinstance.php + * @param string $locale [optional] * @return IntlRuleBasedBreakIterator */ - public static function createSentenceInstance($locale) { } + public static function createSentenceInstance($locale) {} /** * (PHP 5 >=5.5.0)<br/> * Create break iterator for title-casing breaks - * @link https://www.php.net/manual/en/intlbreakiterator.createtitleinstance.php - * @param string $locale + * @link https://secure.php.net/manual/en/intlbreakiterator.createtitleinstance.php + * @param string $locale [optional] * @return IntlRuleBasedBreakIterator */ - public static function createTitleInstance($locale) { } + public static function createTitleInstance($locale) {} /** * (PHP 5 >=5.5.0)<br/> * Create break iterator for word breaks - * @link https://www.php.net/manual/en/intlbreakiterator.createwordinstance.php - * @param string $locale + * @link https://secure.php.net/manual/en/intlbreakiterator.createwordinstance.php + * @param string $locale [optional] * @return IntlRuleBasedBreakIterator */ - public static function createWordInstance($locale) { } + public static function createWordInstance($locale) {} /** * (PHP 5 >=5.5.0)<br/> - * @link https://www.php.net/manual/en/intlrulebasedbreakiterator.getbinaryrules.php + * @link https://secure.php.net/manual/en/intlrulebasedbreakiterator.getbinaryrules.php * Get the binary form of compiled rules - * @return string + * @return string|false */ - public function getBinaryRules() { } + public function getBinaryRules(): string|false {} /** * (PHP 5 >=5.5.0)<br/> - * @link https://www.php.net/manual/en/intlrulebasedbreakiterator.getrules.php + * @link https://secure.php.net/manual/en/intlrulebasedbreakiterator.getrules.php * Get the rule set used to create this object - * @return string + * @return string|false */ - public function getRules() { } + public function getRules(): string|false {} /** * (PHP 5 >=5.5.0)<br/> - * @link https://www.php.net/manual/en/intlrulebasedbreakiterator.getrulesstatus.php + * @link https://secure.php.net/manual/en/intlrulebasedbreakiterator.getrulesstatus.php * Get the largest status value from the break rules that determined the current break position * @return int */ - public function getRuleStatus() { } + public function getRuleStatus(): int {} /** * (PHP 5 >=5.5.0)<br/> - * @link https://www.php.net/manual/en/intlrulebasedbreakiterator.getrulestatusvec.php + * @link https://secure.php.net/manual/en/intlrulebasedbreakiterator.getrulestatusvec.php * Get the status values from the break rules that determined the current break position - * @return array + * @return array|false */ - public function getRuleStatusVec() { } + public function getRuleStatusVec(): array|false {} } /** * @link https://www.php.net/manual/en/class.intlpartsiterator.php * @since 5.5 */ -class IntlPartsIterator extends IntlIterator implements Iterator { - - const KEY_SEQUENTIAL = 0 ; - const KEY_LEFT = 1 ; - const KEY_RIGHT = 2 ; +class IntlPartsIterator extends IntlIterator implements Iterator +{ + public const KEY_SEQUENTIAL = 0; + public const KEY_LEFT = 1; + public const KEY_RIGHT = 2; /** * @return IntlBreakIterator */ - public function getBreakIterator() { } -} - -class IntlCodePointBreakIterator extends IntlBreakIterator implements Traversable { + public function getBreakIterator(): IntlBreakIterator {} + /** + * @since 8.1 + */ + public function getRuleStatus(): int {} +} +class IntlCodePointBreakIterator extends IntlBreakIterator implements Traversable +{ /** * (PHP 5 >=5.5.0)<br/> * Get last code point passed over after advancing or receding the iterator - * @link https://www.php.net/manual/en/intlcodepointbreakiterator.getlastcodepoint.php + * @link https://secure.php.net/manual/en/intlcodepointbreakiterator.getlastcodepoint.php * @return int */ - public function getLastCodePoint() { } + public function getLastCodePoint(): int {} } -class UConverter { - +class UConverter +{ /* Constants */ - const REASON_UNASSIGNED = 0; - const REASON_ILLEGAL = 1; - const REASON_IRREGULAR = 2; - const REASON_RESET = 3; - const REASON_CLOSE = 4; - const REASON_CLONE = 5; - const UNSUPPORTED_CONVERTER = -1; - const SBCS = 0; - const DBCS = 1; - const MBCS = 2; - const LATIN_1 = 3; - const UTF8 = 4; - const UTF16_BigEndian = 5; - const UTF16_LittleEndian = 6; - const UTF32_BigEndian = 7; - const UTF32_LittleEndian = 8; - const EBCDIC_STATEFUL = 9; - const ISO_2022 = 10; - const LMBCS_1 = 11; - const LMBCS_2 = 12; - const LMBCS_3 = 13; - const LMBCS_4 = 14; - const LMBCS_5 = 15; - const LMBCS_6 = 16; - const LMBCS_8 = 17; - const LMBCS_11 = 18; - const LMBCS_16 = 19; - const LMBCS_17 = 20; - const LMBCS_18 = 21; - const LMBCS_19 = 22; - const LMBCS_LAST = 22; - const HZ = 23; - const SCSU = 24; - const ISCII = 25; - const US_ASCII = 26; - const UTF7 = 27; - const BOCU1 = 28; - const UTF16 = 29; - const UTF32 = 30; - const CESU8 = 31; - const IMAP_MAILBOX = 32; + public const REASON_UNASSIGNED = 0; + public const REASON_ILLEGAL = 1; + public const REASON_IRREGULAR = 2; + public const REASON_RESET = 3; + public const REASON_CLOSE = 4; + public const REASON_CLONE = 5; + public const UNSUPPORTED_CONVERTER = -1; + public const SBCS = 0; + public const DBCS = 1; + public const MBCS = 2; + public const LATIN_1 = 3; + public const UTF8 = 4; + public const UTF16_BigEndian = 5; + public const UTF16_LittleEndian = 6; + public const UTF32_BigEndian = 7; + public const UTF32_LittleEndian = 8; + public const EBCDIC_STATEFUL = 9; + public const ISO_2022 = 10; + public const LMBCS_1 = 11; + public const LMBCS_2 = 12; + public const LMBCS_3 = 13; + public const LMBCS_4 = 14; + public const LMBCS_5 = 15; + public const LMBCS_6 = 16; + public const LMBCS_8 = 17; + public const LMBCS_11 = 18; + public const LMBCS_16 = 19; + public const LMBCS_17 = 20; + public const LMBCS_18 = 21; + public const LMBCS_19 = 22; + public const LMBCS_LAST = 22; + public const HZ = 23; + public const SCSU = 24; + public const ISCII = 25; + public const US_ASCII = 26; + public const UTF7 = 27; + public const BOCU1 = 28; + public const UTF16 = 29; + public const UTF32 = 30; + public const CESU8 = 31; + public const IMAP_MAILBOX = 32; /* Methods */ /** @@ -6677,17 +7033,23 @@ class UConverter { * @param string $destination_encoding * @param string $source_encoding */ - public function __construct($destination_encoding = null, $source_encoding = null) { } + public function __construct( + string|null $destination_encoding = null, + string|null $source_encoding = null + ) {} /** * (PHP 5 >=5.5.0)<br/> * Convert string from one charset to anothe * @link https://php.net/manual/en/uconverter.convert.php * @param string $str - * @param bool $reverse - * @return string + * @param bool $reverse [optional] + * @return string|false */ - public function convert($str, $reverse) { } + public function convert( + string $str, + bool $reverse = false + ): string|false {} /** * (PHP 5 >=5.5.0)<br/> @@ -6696,19 +7058,26 @@ class UConverter { * @param int $reason * @param string $source * @param string $codePoint - * @param int $error - * @return mixed + * @param int &$error + * @return array|string|int|null */ - public function fromUCallback($reason, $source, $codePoint, &$error) { } + public function fromUCallback( + int $reason, + array $source, + int $codePoint, + &$error + ): array|string|int|null {} /** * (PHP 5 >=5.5.0)<br/> * Get the aliases of the given name * @link https://php.net/manual/en/uconverter.getaliases.php * @param string $name - * @return array + * @return array|false|null */ - public static function getAliases($name = null) { } + public static function getAliases( + string $name + ): array|false|null {} /** * (PHP 5 >=5.5.0)<br/> @@ -6716,23 +7085,23 @@ class UConverter { * @link https://php.net/manual/en/uconverter.getavailable.php * @return array */ - public static function getAvailable() { } + public static function getAvailable(): array {} /** * (PHP 5 >=5.5.0)<br/> * Get the destination encoding * @link https://php.net/manual/en/uconverter.getdestinationencoding.php - * @return string + * @return string|false|null */ - public function getDestinationEncoding() { } + public function getDestinationEncoding(): string|false|null {} /** * (PHP 5 >=5.5.0)<br/> * Get the destination converter type * @link https://php.net/manual/en/uconverter.getdestinationtype.php - * @return int + * @return int|false|null */ - public function getDestinationType() { } + public function getDestinationType(): int|false|null {} /** * (PHP 5 >=5.5.0)<br/> @@ -6740,47 +7109,47 @@ class UConverter { * @link https://php.net/manual/en/uconverter.geterrorcode.php * @return int */ - public function getErrorCode() { } + public function getErrorCode(): int {} /** * (PHP 5 >=5.5.0)<br/> * Get last error message on the object * @link https://php.net/manual/en/uconverter.geterrormessage.php - * @return string + * @return string|null */ - public function getErrorMessage() { } + public function getErrorMessage(): ?string {} /** * (PHP 5 >=5.5.0)<br/> * Get the source encoding * @link https://php.net/manual/en/uconverter.getsourceencoding.php - * @return string + * @return string|false|null */ - public function getSourceEncoding() { } + public function getSourceEncoding(): string|false|null {} /** * (PHP 5 >=5.5.0)<br/> * Get the source convertor type * @link https://php.net/manual/en/uconverter.getsourcetype.php - * @return int + * @return int|false|null */ - public function getSourceType() { } + public function getSourceType(): int|false|null {} /** * (PHP 5 >=5.5.0)<br/> * Get standards associated to converter names * @link https://php.net/manual/en/uconverter.getstandards.php - * @return array + * @return array|null */ - public static function getStandards() { } + public static function getStandards(): ?array {} /** * (PHP 5 >=5.5.0)<br/> * Get substitution chars * @link https://php.net/manual/en/uconverter.getsubstchars.php - * @return string + * @return string|false|null */ - public function getSubstChars() { } + public function getSubstChars(): string|false|null {} /** * (PHP 5 >=5.5.0)<br/> @@ -6789,34 +7158,36 @@ class UConverter { * @param int $reason * @return string */ - public static function reasonText($reason) { } + public static function reasonText( + int $reason + ): string {} /** * (PHP 5 >=5.5.0)<br/> * Set the destination encoding * @link https://php.net/manual/en/uconverter.setdestinationencoding.php * @param string $encoding - * @return void + * @return bool */ - public function setDestinationEncoding($encoding) { } + public function setDestinationEncoding(string $encoding): bool {} /** * (PHP 5 >=5.5.0)<br/> * Set the source encoding * @link https://php.net/manual/en/uconverter.setsourceencoding.php * @param string $encoding - * @return void + * @return bool */ - public function setSourceEncoding($encoding) { } + public function setSourceEncoding(string $encoding): bool {} /** * (PHP 5 >=5.5.0)<br/> * Set the substitution chars * @link https://php.net/manual/en/uconverter.setsubstchars.php * @param string $chars - * @return void + * @return bool */ - public function setSubstChars($chars) { } + public function setSubstChars(string $chars): bool {} /** * (PHP 5 >=5.5.0)<br/> @@ -6825,10 +7196,15 @@ class UConverter { * @param int $reason * @param string $source * @param string $codeUnits - * @param int $error - * @return mixed + * @param int &$error + * @return array|string|int|null */ - public function toUCallback($reason, $source, $codeUnits, &$error) { } + public function toUCallback( + int $reason, + string $source, + string $codeUnits, + &$error + ): array|string|int|null {} /** * (PHP 5 >=5.5.0)<br/> @@ -6837,10 +7213,14 @@ class UConverter { * @param string $str * @param string $toEncoding * @param string $fromEncoding - * @param array $options - * @return string - */ - public static function transcode($str, $toEncoding, $fromEncoding, array $options = []) { } + * @param array|null $options + * @return string|false + */ + public static function transcode( + string $str, + string $toEncoding, + string $fromEncoding, + array|null $options = null + ): string|false {} } // End of intl v.1.1.0 -?> diff --git a/build/translation-checker.php b/build/translation-checker.php index 6b820bea190..98859fc7d47 100644 --- a/build/translation-checker.php +++ b/build/translation-checker.php @@ -1,4 +1,6 @@ <?php + +declare(strict_types=1); /** * SPDX-FileCopyrightText: 2017 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later @@ -16,6 +18,12 @@ $untranslatedApps = [ 'testing', ]; +$txConfigAppMap = [ + 'dashboard' => 'dashboard-shipped-with-server', + 'encryption' => 'files_encryption', + 'settings' => 'settings-1', +]; + // Next line only looks messed up, but it works. Don't touch it! $rtlCharacters = [ '\x{061C}', // ARABIC LETTER MARK @@ -52,10 +60,9 @@ foreach ($apps as $app) { continue; } - if (!file_exists($app->getPathname() . '/l10n')) { - if (!str_contains($txConfig, '[o:nextcloud:p:nextcloud:r:' . $app->getBasename() . ']')) { - $errors[] = $app->getBasename() . "\n" . ' App is not translation synced via transifex and also not marked as untranslated' . "\n"; - } + $resourceName = $txConfigAppMap[$app->getBasename()] ?? $app->getBasename(); + if (!file_exists($app->getPathname() . '/l10n') || !str_contains($txConfig, '[o:nextcloud:p:nextcloud:r:' . $resourceName . ']')) { + $errors[] = $app->getBasename() . "\n" . ' App is not correctly configured for translation sync via transifex and also not marked as untranslated' . "\n"; continue; } diff --git a/build/triple-dot-checker.php b/build/triple-dot-checker.php index d5e67f835f3..171abfaf433 100644 --- a/build/triple-dot-checker.php +++ b/build/triple-dot-checker.php @@ -1,4 +1,6 @@ <?php + +declare(strict_types=1); /** * SPDX-FileCopyrightText: 2017 Nextcloud GmbH and Nextcloud contributors * SPDX-License-Identifier: AGPL-3.0-or-later |
