Filehosting

Used technologies

1. Twitter Bootstrap
2. Slim micro framework
3. Redis key-value NoSQL database
4. Pimple dependency injection container
5. Twig template engine
6. Sphinx search engine
7. jQuery javascript library
8. GetId3 media file parser
9. Codeception testing PHP framework
10. Selenium automates browsers

Requirements

1. PHP >= 7.1 and extensions: mbstring PDO pdo_mysql pdo_pgsql pgsql redis gd
2. PostgreSQL
3. Sphinx
4. Redis
5. Composer

Installation

1. Use the git clone https://github.com/Qevg/filehosting.git command to clone the repository
2. Use the cd filehosting command to go to the project directory
3. Use the composer install command to install dependencies

Docker

1. Use the make configure-docker-production command to configure production enviroment
2. Start the containers docker-compose -f docker-compose.production.yml up
3. Restore database dump docker exec -i $(docker-compose -f docker-compose.production.yml ps -q postgres) psql -U filehosting -d filehosting_production < filehosting.sql

Or by hand

1. Install php extensions: mbstring PDO pdo_mysql pdo_pgsql pgsql redis gd
2. Change configuration in the config/config_production.json and config/sphinx.conf
3. Сonfigure the web server as specified here
4. Set public directory as a document root on your web server
5. Configure params file_uploads, upload_max_filesize, post_max_size, max_file_uploads, client_max_body_size, sendfile, etc.
6. Import database filehosting.sql on your database
7. Initialize search indexes with the indexer --config config/sphinx.conf --all command
8. Start sphinx service with the searchd --config config/sphinx.conf command

Additional Features

XSendfile

If your server has XSendFile module installed and configured, then you can enable it in the config/config_production.json file, setting the XSendFile option to on. If you're using Nginx don't forget to set storage folder as internal in your config file.

Example:

location /storage {
    internal;
    root /path/to/project;
}

Tests

1. Use the composer install command to install dependencies
2. Use the make configure-docker-testing command to configure testing enviroment
3. Use the docker-compose -f docker-compose.testing.yml run --rm codecept run command to start containers and run tests

License

This application is licensed under the MIT license. For more information refer to License file.