Vendored Composer dependencies for the LibreSign Nextcloud app. PHP-Scoper
isolates these libraries under OCA\Libresign\Vendor\ to avoid namespace
conflicts with Nextcloud and other apps.
Dependabot proposes updates for main and maintained stable branches. The
usual workflow is:
- Review the dependency version and lockfile changes in the 3rdparty pull request.
- A maintainer comments
/composer-updateon that PR to regenerate the vendored, scoped libraries and autoload files. Wait for the 3rdparty CI. - Comment
/libresign-pron the same PR to create a matching pull request in LibreSign, targeting the corresponding branch and pointing to the proposed 3rdparty commit. - Review and test the integration in LibreSign. After approval, merge the 3rdparty PR first.
- Comment
/update-3rdpartyon the linked LibreSign PR to update its submodule pointer to the exact commit integrated into 3rdparty. Wait for the new LibreSign CI checks before merging that PR.
These commands are restricted to maintainers and pull-request branches hosted in the respective repositories. They create or update PRs; they do not merge anything automatically. For forks or unavailable automation, use the manual procedure below.
In a clean, disposable 3rdparty working tree:
- Update the version constraint in
composer.json, if needed, and runcomposer update vendor/package. - Remove the generated
composer/*/andvendor/*/directories, then runcomposer install --no-dev. The Composer scripts execute PHP-Scoper. - Run
git clean -X -d -fandcomposer dump-autoload -o. Note:git clean -Xpermanently removes ignored files; inspect the working tree first. - Commit the changed manifest, lockfile and generated dependencies with DCO sign-off, then open a 3rdparty PR.
- In
LibreSign/libresign, create a separate branch and PR updating only the3rdpartysubmodule to the candidate commit. After the 3rdparty PR is merged, add another signed-off commit pointing to the integrated SHA. Rerun LibreSign CI before merging.
Do not amend or force-push merely to update the submodule pointer.
- Dependency requirements are defined in
composer.json; downloaded sources live invendor/, and scoped output is generated incomposer/. scoper.inc.phpcontains namespace rules and special handling for Twig, mPDF, phpseclib and PDFParser.- Composer's
post-install-cmdandpost-update-cmdregenerate the scoped libraries. Do not hand-edit generated dependencies.
For troubleshooting, PHP-Scoper can also be invoked explicitly after installing its tooling:
composer bin all install --ansi
php -d error_reporting=E_ALL\&~E_DEPRECATED\&~E_USER_DEPRECATED \
vendor-bin/php-scoper/vendor/humbug/php-scoper/bin/php-scoper add-prefix --force
composer dump-autoload -o