Example code fails on 5.0.7

[atti-dall-atto]

Forgive the naivete of the question, but...

running the builder example code on the front page with the front page release (5.0.7) on PHP 8.4.16, I see

php .\test-qr.php PHP Fatal error: Uncaught Error: Unknown named parameter $writer in [PATH REDACTED]test-qr.php:14 Stack trace: #0 {main} thrown in [PATH REDACTED]test-qr.php on line 14

I eventually see from the release notes for 6.0.0 that this is likely that the front page example does not work on PHP 8.4, yet the composer.json file for your 5.0.7 release has

"php": "^8.1",

which indicates that it DOES work with any version of PHP 8 newer than 8.1

Composer's semantic 'caret' versioning is inappropriate for PHP itself - which frequently breaks compatibility between non-major versions.
Just sayin'
https://getcomposer.org/doc/articles/versions.md#caret-version-range-

[endroid]

Hi @atti-dall-atto, doesn't look like a PHP version issue, looks more like a library version incompatibility. Could you share the code fragment, stack trace and the version of the library in your lock file? It's not possible based on the information in this ticket to see where this is going wrong.

And what is the context? Did it work before / is there a reason you try to use a 2 year old version?

[atti-dall-atto]

Hi! And first off the bat - thanks for such an amazing package.

The code fragment is the example on the project front page

require_once( __DIR__ . '/vendor/autoload.php'); 

use Endroid\QrCode\Builder\Builder;
use Endroid\QrCode\Encoding\Encoding;
use Endroid\QrCode\ErrorCorrectionLevel;
use Endroid\QrCode\Label\LabelAlignment;
use Endroid\QrCode\Label\Font\OpenSans;
use Endroid\QrCode\RoundBlockSizeMode;
use Endroid\QrCode\Writer\PngWriter;

$builder = new Builder(
    writer: new PngWriter(),
    writerOptions: [],
    validateResult: false,
    data: 'Custom QR code contents',
    encoding: new Encoding('UTF-8'),
    errorCorrectionLevel: ErrorCorrectionLevel::High,
    size: 300,
    margin: 10,
    roundBlockSizeMode: RoundBlockSizeMode::Margin,
    logoPath: __DIR__.'/assets/my.png',
    logoResizeToWidth: 50,
    logoPunchoutBackground: true,
    labelText: 'This is the label',
    labelFont: new OpenSans(20),
    labelAlignment: LabelAlignment::Center
);

$result = $builder->build();

The stack trace I supplied in my original post

The composer.lock file contains this

    "_readme": [
        "This file locks the dependencies of your project to a known state",
        "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
        "This file is @generated automatically"
    ],
    "content-hash": "2a8944f59bf5e5f9115de878abbc15db",
    "packages": [
        {
            "name": "bacon/bacon-qr-code",
            "version": "v3.0.4",
            "source": {
                "type": "git",
                "url": "https://github.com/Bacon/BaconQrCode.git",
                "reference": "3feed0e212b8412cc5d2612706744789b0615824"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/Bacon/BaconQrCode/zipball/3feed0e212b8412cc5d2612706744789b0615824",
                "reference": "3feed0e212b8412cc5d2612706744789b0615824",
                "shasum": ""
            },
            "require": {
                "dasprid/enum": "^1.0.3",
                "ext-iconv": "*",
                "php": "^8.1"
            },
            "require-dev": {
                "phly/keep-a-changelog": "^2.12",
                "phpunit/phpunit": "^10.5.11 || ^11.0.4",
                "spatie/phpunit-snapshot-assertions": "^5.1.5",
                "spatie/pixelmatch-php": "^1.2.0",
                "squizlabs/php_codesniffer": "^3.9"
            },
            "suggest": {
                "ext-imagick": "to generate QR code images"
            },
            "type": "library",
            "autoload": {
                "psr-4": {
                    "BaconQrCode\\": "src/"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "BSD-2-Clause"
            ],
            "authors": [
                {
                    "name": "Ben Scholzen 'DASPRiD'",
                    "email": "mail@dasprids.de",
                    "homepage": "https://dasprids.de/",
                    "role": "Developer"
                }
            ],
            "description": "BaconQrCode is a QR code generator for PHP.",
            "homepage": "https://github.com/Bacon/BaconQrCode",
            "support": {
                "issues": "https://github.com/Bacon/BaconQrCode/issues",
                "source": "https://github.com/Bacon/BaconQrCode/tree/v3.0.4"
            },
            "time": "2026-03-16T01:01:30+00:00"
        },
        {
            "name": "dasprid/enum",
            "version": "1.0.7",
            "source": {
                "type": "git",
                "url": "https://github.com/DASPRiD/Enum.git",
                "reference": "b5874fa9ed0043116c72162ec7f4fb50e02e7cce"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/DASPRiD/Enum/zipball/b5874fa9ed0043116c72162ec7f4fb50e02e7cce",
                "reference": "b5874fa9ed0043116c72162ec7f4fb50e02e7cce",
                "shasum": ""
            },
            "require": {
                "php": ">=7.1 <9.0"
            },
            "require-dev": {
                "phpunit/phpunit": "^7 || ^8 || ^9 || ^10 || ^11",
                "squizlabs/php_codesniffer": "*"
            },
            "type": "library",
            "autoload": {
                "psr-4": {
                    "DASPRiD\\Enum\\": "src/"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "BSD-2-Clause"
            ],
            "authors": [
                {
                    "name": "Ben Scholzen 'DASPRiD'",
                    "email": "mail@dasprids.de",
                    "homepage": "https://dasprids.de/",
                    "role": "Developer"
                }
            ],
            "description": "PHP 7.1 enum implementation",
            "keywords": [
                "enum",
                "map"
            ],
            "support": {
                "issues": "https://github.com/DASPRiD/Enum/issues",
                "source": "https://github.com/DASPRiD/Enum/tree/1.0.7"
            },
            "time": "2025-09-16T12:23:56+00:00"
        },
        {
            "name": "endroid/qr-code",
            "version": "5.1.0",
            "source": {
                "type": "git",
                "url": "https://github.com/endroid/qr-code.git",
                "reference": "393fec6c4cbdc1bd65570ac9d245704428010122"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/endroid/qr-code/zipball/393fec6c4cbdc1bd65570ac9d245704428010122",
                "reference": "393fec6c4cbdc1bd65570ac9d245704428010122",
                "shasum": ""
            },
            "require": {
                "bacon/bacon-qr-code": "^3.0",
                "php": "^8.1"
            },
            "require-dev": {
                "endroid/quality": "dev-main",
                "ext-gd": "*",
                "khanamiryan/qrcode-detector-decoder": "^2.0.2",
                "setasign/fpdf": "^1.8.2"
            },
            "suggest": {
                "ext-gd": "Enables you to write PNG images",
                "khanamiryan/qrcode-detector-decoder": "Enables you to use the image validator",
                "roave/security-advisories": "Makes sure package versions with known security issues are not installed",
                "setasign/fpdf": "Enables you to use the PDF writer"
            },
            "type": "library",
            "extra": {
                "branch-alias": {
                    "dev-main": "5.x-dev"
                }
            },
            "autoload": {
                "psr-4": {
                    "Endroid\\QrCode\\": "src/"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Jeroen van den Enden",
                    "email": "info@endroid.nl"
                }
            ],
            "description": "Endroid QR Code",
            "homepage": "https://github.com/endroid/qr-code",
            "keywords": [
                "code",
                "endroid",
                "php",
                "qr",
                "qrcode"
            ],
            "support": {
                "issues": "https://github.com/endroid/qr-code/issues",
                "source": "https://github.com/endroid/qr-code/tree/5.1.0"
            },
            "funding": [
                {
                    "url": "https://github.com/endroid",
                    "type": "github"
                }
            ],
            "time": "2024-09-08T08:52:55+00:00"
        }
    ],
    "packages-dev": [],
    "aliases": [],
    "minimum-stability": "stable",
    "stability-flags": {},
    "prefer-stable": false,
    "prefer-lowest": false,
    "platform": {
        "php": "^8.1",
        "ext-gd": "*",
        "ext-fileinfo": "*"
    },
    "platform-dev": {},
    "plugin-api-version": "2.9.0"
}

The context is me coming to your github project page, wanting to start with the first example you provide there, examining the version of the 'latest release' that github advertises on the sidebar (5.0.7) and then creating the following composer.json

{
    "name": "me/my-first-little-qr-code",
    "require": {
        "php": "^8.1",
		"ext-gd": "*",
		"ext-fileinfo": "*",
        "endroid/qr-code": "^5.0.7"
    }
}

The reason I didn't use a newer version? Because the front page shows the latest release to be 5.0.7, I guess. I just assumed that the 5 branch was more stable then the 6 branch for that reason - I don't come here often.

[endroid]

Ah I understand, that can indeed be quite misleading: GitHub separates releases from tags and only shows releases. So if there are new tags that have no connected release, it doesn't show them, while factually newer tags are most relevant. I now removed the releases as they have no significant value here.

My advise would be to use the latest 6.x so you're not starting with a 2 year old version and let me know again if you still experience any problems.

[atti-dall-atto]

@endroid
Many thanks - I just used the non-Builder code to build off - that worked fine. I needed to use a console font for the label - the usual O0 1I thing - so it seemed easier to subclass Font using a separate call to Label class.