Download the PHP package xi/filelib without Composer
On this page you can find all versions of the php package xi/filelib. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package filelib
Short Description File library for PHP
License BSD-3-Clause
Homepage http://github.com/xi-project/xi-filelib
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package filelib
Xi Filelib
Filelib is a file library component for PHP, providing a virtual filesystem for your web application's files. It can be used to manage both your application's internal and user-uploaded files in many ways. What it (at least for now) is NOT is a place to store your assets like css, js and similar.
Let's face it: practically all web apps have to store documents, media and such and the needs are same. Filelib takes care of all the hard and/or repetetive tasks and abstracts away and reveals all the related changeable components as loosely coupled subsystems:
- Storing of metadata (virtual folders / files) in a data storage (database, usually).
- Safe physical storage of files in a filesystem (local, S3, Gridfs, etc).
- Authorization (who can do what in the virtual filesystem) and publication (to make them fast-readable and with pretty urls) of world readable files.
- Rendering the files to HTTP response (sometimes you can't world-publish everything but it's still gotta be decent).
- Mime types and extensions and all this horrible stuff
- Versioning (meaning creation of different representations of a master file, thumbnails, html5 videos etc)
- Asynchronous processing (you can't keep the end user waiting for that video to be encoded, you know)
- And there's probably more!
Filelib is fully extensible via plugins and hooks. In fact, many of the "core" functionality is provided via plugins (authorization, automatic publishing, file versions) so the core is kept elegant and maintainable.
Filelib is based on my own observations, opinions and experience formed while developing many file- and mediabanks for the last 10 years. It has evolved and keeps evolving with real projects and use cases, so thanks for all past and present early adopters!
Project Status
(2018-08) I've kinda moved on years ago. Not coding much with PHP anymore. Doing React and stuff with JS nowadays. It's a shame, because Filebanksta was soooo close to be "finished". It remains useable, though. I just upgraded all packages to modern versions. I'll try to do it again a couple times a year, at least. Cheers!
Hard requirements
- A client software that needs file management
- PHP 7.1
Soft requirements (for harder use)
- A serious data storage (MySQL/MariaDB, PostgreSQL, MongoDB supported out of the box)
- Imagemagick for image processing
- Zencoder for all your video needs
- Intl for transliterating / slugifying
- A queue (RabbitMQ, IronMQ, SQS) for asynchronous operations
Quickstart
Using JSON storage (for simple testing only)
Documentation
TODO!
Examples and use cases
https://github.com/xi-project/xi-filelib-examples contains a lot of examples from very simple to very complex use cases. Clone the repo, configure a web server and dive straight into the code!
About integrating to your own software
Experience has time and again proved that integration should be light. If one is using Doctrine ORM, it could seem appropriate to integrate via Filelib's entities. DON'T DO IT. It will bite you back.
All the stuff inside the backend platforms (and other deeper abstractions provided by Filelib) are the library's private parts and subject to change any time. So if you utilize these internals, be prepared to enter upgrade hell at some point. For example the entities in the ORM backend platform; they may go away for good some day.
Just utilize Filelib's identifiables' (folders / files) ids / UUIDs within your own data and domain and use functionality provided by Filelib for everything else.
FolderRepository and FileRepository should usually be as deep as you have to go but it may not yet be the case. For some "tougher" operations I've personally had to use Backend and ProfileManager, at least. These are things and use cases that are yet to be considered before 1.0 is reached.
Framework integration
For framework integration, see:
- https://github.com/xi-project/xi-bundle-filelib (Symfony bundle, needs a maintainer, I'm a very bad one!)
- https://github.com/xi-project/xi-filelib-symfony-sandbox (Symfony sandbox, needs a maintainer too!)
Actual applications using Filelib
For actual applications I know are using Filelib, see:
- http://autot.oikotie.fi: Classified ads for cars. Ancient version if not upgraded without my knowledge / help.
- https://oy.eautokoulu.fi: Learning environment. Advanced large-scale usage of both images and videos. Current version.
- http://sykettatyohon.fi: Document / image managent provided by probably a somewhat older version.
Know more? Please tell!
All versions of filelib with dependencies
symfony/event-dispatcher Version ~3.4|~4.0
ramsey/uuid Version ~3.8
cocur/slugify Version ~3.1
pekkis/queue Version ~4.0
pekkis/temporary-file-manager Version ~2.0
pekkis/directory-calculator Version ~2.0
pekkis/mime-types Version ~2.0
xi/collections Version 0.3.*
zencoder/zencoder-php Version ~2.1
aws/aws-sdk-php Version ~3.2