b4moss / shardian

v0.6.0 2026-09-25 03:28 UTC

Requires

• php: ^8.1
• ext-mbstring: *

Requires (Dev)

• phpunit/phpunit: ^10.5

MIT

• Bicycle for Mind LLC

Published on Packagist.org on 2026-09-25 04:03 UTC

README

Create sharded path strings from filenames.

Source of truth: b4moss/shardian (packages/php)
Packagist mirror: b4moss/shardian-php (CD-updated; do not edit by hand)

use function B4moss\Shardian\shardian;
use function B4moss\Shardian\shardianSplit;

$path = shardian('abc1234.jpg');
// => '/a/b/c/1/abc1234.jpg'

$path = shardian('abc1234.jpg', ['stripHeadSlash' => true]);
// => 'a/b/c/1/abc1234.jpg'

$split = shardianSplit('abc1234.jpg');
// $split->pathOnly => '/a/b/c/1/'

composer require b4moss/shardian

Full contract and tests live in the monorepo: docs/specs/path-api.md, docs/tests/shardian-php.md.

License

MIT