Weave Code
Range Laravel Package
php-standard-library/range
Range types for integer sequences with iteration support, part of the PHP Standard Library. Provides typed, iterable integer ranges for clean sequence generation in PHP applications. Install via Composer and use alongside other php-standard-library packages.
Range types for integer sequences with iteration support
Frequently asked questions about Range
- What is php-standard-library/range used for in Laravel applications?
- It provides typed, iterable integer range objects for clean sequence generation in Laravel applications. Common uses include batch processing, range-based API filters, numeric validation, pagination slicing, and test data generation. It can replace manual array building and error-prone regex parsing when you need a reusable range value. Use it alongside other php-standard-library packages if your project already follows that ecosystem.
- How do I install php-standard-library/range with Composer?
- Run composer require php-standard-library/range in your Laravel project. The package follows PSR-4 autoloading and installs like any normal Composer dependency. You need PHP 8.0 or newer for the full feature set, including lazy iteration and typed range methods. Laravel 8.x and later are compatible.
- Which Laravel and PHP versions are compatible with php-standard-library/range?
- The package is compatible with Laravel 8.x and later when your application runs PHP 8.0 or newer. It uses PHP 8 typed properties and return types, which improve IDE support and reduce runtime errors. For legacy PHP 7.x projects, version 5.x maintains backward compatibility, but full functionality requires PHP 8.0+. It adheres to PSR-4 and PSR-12 standards, so it does not conflict with Laravel's ecosystem.
- How can I use Range::lazy() for memory-efficient Laravel queue jobs?
- Range::lazy() lets you iterate over very large integer ranges without loading the entire sequence into memory. In a Laravel queue job, you can use it to feed IDs or batch numbers into chunked processing, such as Range::from(1, 1000000)->lazy(). This is useful for background jobs that process millions of records where a normal array would exhaust memory. Pair it with Laravel's chunking or batching patterns to keep workers stable.
- Can php-standard-library/range handle stepped ranges like even IDs?
- Yes, Range::step() supports non-sequential integer ranges, which is useful for even IDs, odd IDs, or sampled sequences. You can combine stepping with skip() and take() for composable slices, such as a page of every second record. This reduces manual filtering logic in API filters and query generation. Convert the range to an array when passing it to whereIn().
- How does php-standard-library/range help with API filtering and validation?
- Typed Range objects replace fragile regex or string parsing for numeric range parameters such as IDs or ages. You can validate bounds and step values before building queries, reducing runtime errors in API endpoints. If your application extends parsing support, Range::fromString() can map query strings into range objects; otherwise you can construct ranges from validated integers. This keeps range handling explicit and testable.
- Can php-standard-library/range be used with Laravel Collections and whereIn queries?
- Yes, range objects can produce arrays for Laravel query builder calls such as whereIn('id', Range::from($start, $end)->toArray()). They also fit naturally with Collection-style operations, so you can map or iterate over integer sequences without manually building arrays. This is handy for dynamic query filters, pagination slices, and batch lookups. Keep an eye on performance and convert lazy ranges only when needed.
- Does php-standard-library/range support decimal or floating-point ranges?
- No, the package is designed for integer sequences and does not support floating-point or decimal ranges such as 1.5 to 3.2. For decimal stepping, use native loops, generators, or a different package that explicitly supports floats. The integer-only design keeps range semantics predictable and type-safe for IDs, counts, and pagination.
- How can php-standard-library/range simplify Laravel test data generation?
- You can generate test data in one line, for example Range::from(1, 100)->each(fn ($id) => User::factory()->create()). This avoids manual array construction and makes test setup more readable. Stepped and sliced ranges also help create predictable subsets for edge-case tests. Use it with Laravel factories and database transactions to keep test suites fast and less flaky.
- How does php-standard-library/range compare to native PHP range() and is it maintained?
- Native range() returns an array, while php-standard-library/range provides typed range objects with lazy iteration, step(), skip(), and take(). For trivial loops, native PHP loops may be faster and simpler, so benchmark performance-critical paths. The package is part of the PHP Standard Library, maintains backward compatibility in version 6.1.x with additive changes, and follows PSR standards. For PHP 7.x projects, version 5.x remains available, but PHP 8.0+ is required for full functionality.
Weaver
How can I help you explore Laravel packages today?