spatie/pdf-to-image
Convert a pdf to an image
3.4.0
17M downloads/mo
#1076 most downloaded on Packagist
spatie/pdf-to-image
What this package is like to depend on
Last release 16 days ago
07 Aug 2026
Release timing varies
gaps range from 6 weeks to 2.0 years
Nearly every release is documented
notes for 35 of 36 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
36 releases · first in 2015
3 releases in the last 12 months
see the full history below
Release timeline
35 releases · Jul 2015 to Aug 2026Releases
latest 36-
3.4.007 Aug 2026Release notes
Open source →What's Changed
- Add support for password-protected PDFs by @freekmurze in #268
Full Changelog: 3.3.0...3.4.0
Release notes
Open source →What's Changed
- Add support for password-protected PDFs by @freekmurze in https://github.com/spatie/pdf-to-image/pull/268
Full Changelog: https://github.com/spatie/pdf-to-image/compare/3.3.0...3.4.0
-
3.3.026 Jun 2026Release notes
Open source →What's Changed
- Bump dependabot/fetch-metadata from 2 to 3 by @dependabot[bot] in #260
- Bump actions/checkout from 6 to 7 by @dependabot[bot] in #266
- fix: use white background by default when flattening PDF layers by @lazerg in #267
New Contributors
Full Changelog: 3.2.0...3.3.0
Release notes
Open source →What's Changed
- Bump dependabot/fetch-metadata from 2 to 3 by @dependabot[bot] in https://github.com/spatie/pdf-to-image/pull/260
- Bump actions/checkout from 6 to 7 by @dependabot[bot] in https://github.com/spatie/pdf-to-image/pull/266
- fix: use white background by default when flattening PDF layers by @lazerg in https://github.com/spatie/pdf-to-image/pull/267
New Contributors
- @lazerg made their first contribution in https://github.com/spatie/pdf-to-image/pull/267
Full Changelog: https://github.com/spatie/pdf-to-image/compare/3.2.0...3.3.0
-
3.2.009 Feb 2026Release notes
Open source →What's Changed
- Update README.md by @danielrona in #240
- Bump stefanzweifel/git-auto-commit-action from 4 to 6 by @dependabot[bot] in #251
- Update issue template by @AlexVanderbist in #253
- Bump actions/checkout from 4 to 5 by @dependabot[bot] in #252
- Bump stefanzweifel/git-auto-commit-action from 6 to 7 by @dependabot[bot] in #254
- feat: add tests for php 8.4 and 8.5 by @Chris53897 in #256
- Bump actions/checkout from 5 to 6 by @dependabot[bot] in #257
- Wide PDFs, Antialiasing, Minor Improvements by @patinthehat in #249
New Contributors
- @danielrona made their first contribution in #240
- @AlexVanderbist made their first contribution in #253
- @Chris53897 made their first contribution in #256
Full Changelog: 3.1.0...3.2.0
Release notes
Open source →What's Changed
- Update README.md by @danielrona in https://github.com/spatie/pdf-to-image/pull/240
- Bump stefanzweifel/git-auto-commit-action from 4 to 6 by @dependabot[bot] in https://github.com/spatie/pdf-to-image/pull/251
- Update issue template by @AlexVanderbist in https://github.com/spatie/pdf-to-image/pull/253
- Bump actions/checkout from 4 to 5 by @dependabot[bot] in https://github.com/spatie/pdf-to-image/pull/252
- Bump stefanzweifel/git-auto-commit-action from 6 to 7 by @dependabot[bot] in https://github.com/spatie/pdf-to-image/pull/254
- feat: add tests for php 8.4 and 8.5 by @Chris53897 in https://github.com/spatie/pdf-to-image/pull/256
- Bump actions/checkout from 5 to 6 by @dependabot[bot] in https://github.com/spatie/pdf-to-image/pull/257
- Wide PDFs, Antialiasing, Minor Improvements by @patinthehat in https://github.com/spatie/pdf-to-image/pull/249
New Contributors
- @danielrona made their first contribution in https://github.com/spatie/pdf-to-image/pull/240
- @AlexVanderbist made their first contribution in https://github.com/spatie/pdf-to-image/pull/253
- @Chris53897 made their first contribution in https://github.com/spatie/pdf-to-image/pull/256
Full Changelog: https://github.com/spatie/pdf-to-image/compare/3.1.0...3.2.0
-
3.1.014 Sep 2024Release notes
Open source →What's Changed
- Add background color setting for the output image by @waithawoo in #239
New Contributors
- @waithawoo made their first contribution in #239
Full Changelog: 3.0.0...3.1.0
Release notes
Open source →What's Changed
- Add background color setting for the output image by @waithawoo in https://github.com/spatie/pdf-to-image/pull/239
New Contributors
- @waithawoo made their first contribution in https://github.com/spatie/pdf-to-image/pull/239
Full Changelog: https://github.com/spatie/pdf-to-image/compare/3.0.0...3.1.0
-
3.0.010 Jun 2024Release notes
Open source →This release updates the package to a new major version,
v3.0.0.Major changes:
- Dropped support for PHP versions < 8.2.
- Many breaking API changes (see below).
- Added support for saving multiple pages to images using
selectPages(). - Native Backed Enum implementations to enforce allowed values in several places.
- Dropped support for reading remote PDF files for security reasons.
- Added property, argument and return types.
- Removed Imagick instance creation in constructor, replaced calls to
readImage()withpingImage()(test suite runs ~33% faster).
Breaking API Changes
There are breaking API changes from v2 to v3. These changes streamline the developer experience, enhance understanding of the functionality of the methods, and reduce cognitive overload by simplifying method names. See the updated
README.mdfor a full list of the new API methods and method names.Additional Changes
php-cs-fixerconfiguration and workflow was dropped in favor of Laravel Pint.- Readme updated to include all available methods, fix a few grammatical errors, etc.
- Fixed several minor, previously unknown bugs.
- Test coverage increased from ~65% to ~93%.
- Pest upgraded to v2, migrated PHPUnit configuration to v10.
- Unit tests were reorganized/restructured to be more manageable, and Pest configuration files were added.
What's Changed
- Bump dependabot/fetch-metadata from 1.6.0 to 2.1.0 by @dependabot in #228
- Major version: v3 by @patinthehat in #230
Full Changelog: 2.3.0...3.0.0
Release notes
Open source →This release updates the package to a new major version,
v3.0.0.Major changes:
- Dropped support for PHP versions < 8.2.
- Many breaking API changes (see below).
- Added support for saving multiple pages to images using
selectPages(). - Native Backed Enum implementations to enforce allowed values in several places.
- Dropped support for reading remote PDF files for security reasons.
- Added property, argument and return types.
- Removed Imagick instance creation in constructor, replaced calls to
readImage()withpingImage()(test suite runs ~33% faster).
Breaking API Changes
There are breaking API changes from v2 to v3. These changes streamline the developer experience, enhance understanding of the functionality of the methods, and reduce cognitive overload by simplifying method names. See the updated
README.mdfor a full list of the new API methods and method names.Additional Changes
php-cs-fixerconfiguration and workflow was dropped in favor of Laravel Pint.- Readme updated to include all available methods, fix a few grammatical errors, etc.
- Fixed several minor, previously unknown bugs.
- Test coverage increased from ~65% to ~93%.
- Pest upgraded to v2, migrated PHPUnit configuration to v10.
- Unit tests were reorganized/restructured to be more manageable, and Pest configuration files were added.
What's Changed
- Bump dependabot/fetch-metadata from 1.6.0 to 2.1.0 by @dependabot in https://github.com/spatie/pdf-to-image/pull/228
- Major version: v3 by @patinthehat in https://github.com/spatie/pdf-to-image/pull/230
Full Changelog: https://github.com/spatie/pdf-to-image/compare/2.3.0...3.0.0
-
2.3.007 Mar 2024Release notes
Open source →What's Changed
- Silently ignore pingImage failure and load number of pages lazily by @bobvandevijver in #187
- Add Dependabot Automation by @patinthehat in #203
- Fix failing tests by @patinthehat in #205
- Add PHP 8.2 Support by @patinthehat in #202
- Fix php-cs-fixer workflow by @patinthehat in #206
- Minor dependabot auto-merge workflow improvements by @patinthehat in #220
- Adding webp to the validOutputFormats by @ntaylor-86 in #221
- Add PHP 8.3 to the test run workflow by @patinthehat in #223
New Contributors
- @bobvandevijver made their first contribution in #187
- @patinthehat made their first contribution in #203
- @dependabot made their first contribution in #204
Full Changelog: 2.2.0...2.3.0
Release notes
Open source →What's Changed
- Silently ignore pingImage failure and load number of pages lazily by @bobvandevijver in https://github.com/spatie/pdf-to-image/pull/187
- Add Dependabot Automation by @patinthehat in https://github.com/spatie/pdf-to-image/pull/203
- Fix failing tests by @patinthehat in https://github.com/spatie/pdf-to-image/pull/205
- Add PHP 8.2 Support by @patinthehat in https://github.com/spatie/pdf-to-image/pull/202
- Fix php-cs-fixer workflow by @patinthehat in https://github.com/spatie/pdf-to-image/pull/206
- Minor dependabot auto-merge workflow improvements by @patinthehat in https://github.com/spatie/pdf-to-image/pull/220
- Adding webp to the validOutputFormats by @ntaylor-86 in https://github.com/spatie/pdf-to-image/pull/221
- Add PHP 8.3 to the test run workflow by @patinthehat in https://github.com/spatie/pdf-to-image/pull/223
New Contributors
- @bobvandevijver made their first contribution in https://github.com/spatie/pdf-to-image/pull/187
- @patinthehat made their first contribution in https://github.com/spatie/pdf-to-image/pull/203
- @dependabot made their first contribution in https://github.com/spatie/pdf-to-image/pull/204
Full Changelog: https://github.com/spatie/pdf-to-image/compare/2.2.0...2.3.0
-
2.2.008 Mar 2022Release notes
Open source →What's Changed
- Converting PHPUnit to Pest tests by @ntaylor-86 in #189
- Adding a thumbnail method by @ntaylor-86 in #188
New Contributors
- @ntaylor-86 made their first contribution in #189
Full Changelog: 2.1.0...2.2.0
-
2.1.012 Nov 2020 -
2.0.129 Apr 2020 -
2.0.008 Jan 2020 -
1.8.231 Jul 2019 -
1.8.102 Jul 2018 -
1.8.003 Apr 2018 -
1.7.014 Mar 2018 -
1.6.114 Mar 2018 -
1.6.020 Dec 2017 -
1.5.026 Oct 2017 -
1.4.611 Oct 2017 -
1.4.518 Jul 2017 -
1.4.411 Jul 2017Release notes
Open source →- fix where
getNumberOfPageswould report the wrong number when looping through the pdf
- fix where
-
1.4.307 Jul 2017 -
1.4.201 Jul 2017 -
1.4.128 Jun 2017 -
1.4.015 Jun 2017 -
1.3.325 Apr 2017Release notes
Open source →- remove use of
Imagick::LAYERMETHOD_FLATTENas it messes up the rendering of specific pages
- remove use of
-
1.3.2no date -
1.3.116 Apr 2017 -
1.3.023 Mar 2017 -
1.2.214 Dec 2016 -
1.2.108 Sep 2016 -
1.2.029 Apr 2016 -
1.1.013 Apr 2016 -
1.0.322 Jan 2016 -
1.0.103 Jul 2015 -
1.0.002 Jul 2015 -
0.0.102 Jul 2015Nothing published for this version