Upgrading
The full notes, every version, are in UPGRADE.md. This page is the short version of the one that matters.
3.1 to 3.2
One thing changes without an edit: the agent tools refuse a document over 50 MB, whether or not you published the config. Set agents.max_bytes to null to keep 3.1's behaviour. Authorising per document is opt-in, through your gate.
3.0 to 3.1
Nothing to change. 3.1 adds the AI agent tools, which are optional and inert until you install laravel/mcp or laravel/ai and open a disk to agents. Only ^1.0 of either installs beside the package.
2.x to 3.0
Every import changes. Nothing else has to.
grep -rl 'LSNepomuceno\\LaravelA1PdfSign' app/ | xargs sed -i \
-e 's#LaravelA1PdfSign\\\(Data\|Enums\|Exceptions\|Validation\|Signing\|Certificates\|Seal\|Support\)\\#Signet\\\1\\#g'The facade, its methods, their arguments, every config key, the artisan commands, the fake and the encryption envelope are what they were. Stored certificates open without being re-encrypted.
What the regex does not catch
| 2.x | 3.0 |
|---|---|
Data\IcpBrasilReport | IcpBrasil\Data\Report |
Data\IcpBrasilIdentity | IcpBrasil\Data\Identity |
Enums\IcpBrasilCertificateType | IcpBrasil\Enums\CertificateType |
Enums\IcpBrasilFinding | IcpBrasil\Enums\Finding |
Exceptions\A1PdfSignException | Exceptions\SignetException |
EncryptedCertificate::$hashKey | ->hash |
->pdfFromDisk('s3', $path) | ->from(A1PdfSign::fromDisk('s3', $path)) |
Two things fail at install rather than at runtime
- PHP 8.4.1, up from 8.4.
intervention/image ^4, up from^3.11. An application pinned to^3cannot install 3.0.
Where to report something
A defect in signing, validation, certificates or the seal belongs to signet-pdf. A defect in the wiring, the config, a command, a disk source or the fake belongs here.