congraph/filesystem

There is no license information available for the latest version (v2.0.3) of this package.

v2.0.3 2026-04-11 09:08 UTC

Requires

• php: ^8.3 || ^8.4 || ^8.5
• congraph/contracts: ^2.0 || dev-main || dev-master
• congraph/core: ^2.0 || dev-main || dev-master
• illuminate/database: ^13.0
• intervention/image: ^3.11
• intervention/image-laravel: ^1.5

Requires (Dev)

• orchestra/testbench: 11.x-dev
• phpunit/phpunit: ^12.0

Unknown License

• Nikola Plavsic

README

congraph/filesystem stores file metadata and provides file-serving and image-version behavior for Congraph content.

Responsibilities

• file CRUD commands and validators
• file metadata persistence
• file serving
• image version handlers
• generated admin image variants

Installation

composer require congraph/filesystem

Laravel package provider:

• FilesystemServiceProvider.php

Image handling

This package now uses maintained Intervention Image v3:

• intervention/image
• intervention/image-laravel

Current image handlers use coverDown() instead of the old fit() semantics to avoid upscaling smaller originals.

Typical usage

Use this package to:

• create file records for uploaded content
• fetch metadata for assets
• serve originals and derived versions
• attach files to EAV entities

Development

Install dependencies

cd /Users/nikolap/git/np/congraph/packages/filesystem
composer update -W

Run tests

composer test
composer test:pgsql

The package includes:

• command tests
• validator tests
• image handler tests
• integration tests for serving and file behavior

Contribution notes

• verify behavior on both SQLite and PostgreSQL-backed suites
• test image behavior explicitly when changing handler logic
• keep file-serving routes and signed URLs compatible with laravel-api