Files
InvoiceShelf/app/Support/Hashids/HashidsManager.php
Darko Gjorgjijoski 6d1816bd1b refactor: reorganize app/Services and app/Support by domain
The app/Services/ directory had grown into 22 flat files at the root plus 7 uneven subdirectories — finding anything required scrolling through an alphabetical mix of small CRUD services, infrastructure drivers, and install-time utilities. This commit groups services by domain, folds Backup into a new Storage namespace, and moves framework-infrastructure and install-time helpers out of Services and into Support where they belong.

New Services layout: Documents/ (Invoice, Estimate, RecurringInvoice, Payment, Expense, Transaction, DocumentItem, SerialNumber, Currency — matches the 'Documents' navigation group); Company/ (Company, Member, Invitation); Mail/ (MailConfiguration, CompanyMailConfig); Storage/ (FileDisk, plus Backup folded in). ExchangeRateProviderService moves next to its drivers in ExchangeRate/; FontService moves into Pdf/ where it belongs. CustomerService, ItemService, CustomFieldService stay at the Services root as standalone single-file domains.

Moves to Support/: Hashids/ (library wrapper — not business logic); Setup/ (one-shot install-time utilities — stateless helpers); Pdf/ (ImageUtils, PdfTemplateUtils, plus the existing PdfHtmlSanitizer consolidated into the same subdir). These are all framework infrastructure and stateless utilities — the 'service' label never really fit them.

Namespace declarations in 29 moved files updated to match new paths. 62 consumer files (controllers, other services, tests, database factories, seeders, routes, bootstrap/providers.php) have their use statements rewritten via a literal-string replacement script — no regex meant no risk of half-matching. Three Documents services needed an explicit 'use App\Services\Mail\CompanyMailConfigService' added because the same-namespace short reference they relied on no longer resolves after the split.

Verified: composer dump-autoload, 350 tests pass (850 assertions), vendor/bin/pint clean, npm run build succeeds.
2026-04-11 10:00:00 +02:00

73 lines
1.8 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\Hashids;
use Hashids\Hashids;
use Illuminate\Contracts\Config\Repository;
use InvalidArgumentException;
/**
* Resolves named Hashids clients from config/hashids.php (one "connection" per model class).
*
* @method string encode(mixed ...$numbers)
* @method array decode(string $hash)
* @method string encodeHex(string $str)
* @method string decodeHex(string $hash)
*/
class HashidsManager
{
/**
* @var array<string, Hashids>
*/
protected array $connections = [];
public function __construct(
protected Repository $config,
protected HashidsFactory $factory
) {}
public function connection(?string $name = null): Hashids
{
$name = $name ?? $this->getDefaultConnection();
if (! isset($this->connections[$name])) {
$this->connections[$name] = $this->factory->make(
$this->getConnectionConfig($name)
);
}
return $this->connections[$name];
}
public function getDefaultConnection(): string
{
return (string) $this->config->get('hashids.default');
}
public function getFactory(): HashidsFactory
{
return $this->factory;
}
/**
* @return array<string, mixed>
*/
protected function getConnectionConfig(string $name): array
{
$connections = $this->config->get('hashids.connections', []);
if (! is_array($connections) || ! isset($connections[$name])) {
throw new InvalidArgumentException("Hashids connection [{$name}] not configured.");
}
return $connections[$name];
}
public function __call(string $method, array $parameters): mixed
{
return $this->connection()->$method(...$parameters);
}
}