jbboehr/yumemi-apocrypha

Curated PHPStan unit annotations for third-party PHP packages.

dev-master 2026-08-10 09:28 UTC

Requires

• php: ^8.2
• composer-runtime-api: ^2.0
• jbboehr/yumemi: dev-master
• phpstan/phpstan: ^2.2.5

Requires (Dev)

• ext-curl: *
• ext-dom: *
• ext-zip: *
• composer/metadata-minifier: ^1.0.1
• composer/semver: ^3.4
• friendsofphp/php-cs-fixer: ^3
• infection/infection: ^0.32.6
• jbboehr/akashi: dev-master
• jbboehr/doctrine-of-the-second-sun: dev-master
• jbboehr/phpbench-perfidious: dev-master
• nikic/php-parser: ^5.8
• phpbench/phpbench: ^1.7
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0.13
• phpstan/phpstan-strict-rules: ^2.0
• phpunit/phpunit: ^11.5

Suggests

• larastan/larastan: Adds Laravel-specific analysis while Apocrypha preserves selected Illuminate unit boundaries.
• phpstan/extension-installer: Automatically registers Yumemi and Yumemi Apocrypha with PHPStan.

AGPL-3.0-only WITH romic-exception

• John Boehr

Published on Packagist.org on 2026-08-10 15:42 UTC

README

Yumemi Apocrypha

Curated PHPStan unit annotations for third-party PHP packages, built on Yumemi.

The package is under active development and has no tagged release. It currently covers selected unit-bearing APIs in:

Composer package	Supported versions
nesbot/carbon	2.62.1+ in 2.x; 3.x
james-heinrich/getid3	1.9.22+ in 1.x; 2.0.0-beta6+ in 2.x
guzzlehttp/guzzle	7, 8
illuminate/cache	11, 12, 13
illuminate/cookie	11, 12, 13
illuminate/filesystem	11, 12, 13
illuminate/http	11, 12, 13
illuminate/process	11, 12, 13
illuminate/queue	11, 12, 13
illuminate/support	11, 12, 13
laravel/framework	11, 12, 13
mjaschen/phpgeo	4, 5, 6
symfony/http-foundation	6.4+ in 6.x; 7.x; 8.x
symfony/stopwatch	6, 7, 8

laravel/framework supplies the listed Illuminate packages through Composer replacements. Configuration continues to use the precise illuminate/* integration names; applications do not need to install those components separately.

composer require --dev jbboehr/yumemi:dev-master jbboehr/yumemi-apocrypha:dev-master \
    phpstan/extension-installer

Select an integration in phpstan.neon:

parameters:
    yumemiApocrypha:
        integrations:
            - illuminate/cache

<?php

use Illuminate\Contracts\Cache\Store;

use function jbboehr\Yumemi\unit;

function cacheReportForOneMinute(Store $cache): void
{
    //! Store::put() expects unit_int<'second'>, 1&unit_int<'minute'> given
    $cache->put('report', 'ready', unit(1, 'minute'));
}

//! marks the expected PHPStan diagnostic used by documentation testing; it is not Yumemi syntax.

Documentation

See the documentation index for installation, integration coverage, and maintenance policy.

License

Yumemi Apocrypha is licensed under AGPL-3.0-only WITH romic-exception. See LICENSE.md and the Romic Exception. Contributions follow the terms in CONTRIBUTING.md. The bundled integration declarations describe third-party APIs; see the third-party notices.