О проекте "Хранилище файлов с общим доступом"

О проекте "Хранилище файлов с общим доступом". Программный комплес, который позволяет загружать файлы на сервер, просматривать и выгружать их.

---

Информация для пользователя

• Проект предназначен для взаимного обмена графическими файлами. Разрешена загрузка файлов со следующими расширениями: png, jpg, jpeg, gif, svg, webp.
• Для работы в проекте не требуется авторизация.
• Все файлы объединяются в тематические группы. Каждая группа имеет краткое описание (до 64 символов). В каждой группе может быть от 1-го до 5-ти файлов. Нет ограничений на количество создаваемых групп.
• Для хранения на сервере для каждого файла создается новое уникальное имя на английском языке (нижний регистр), цыфры, знаки подчеркивания. Оригинальное имя файла сохраняется в БД.
• Все файлы хранятся на сервере в директории /web/fs/1/ в общем доступе.
• У пользователей есть возможность просматривать информацию о загруженных файлах (название файла, дата и время загрузки). В списке файлов есть превью изображений.
• В списках файлов и групп файлов реализованы возможности сортировки и фильтрации по различным критериям, что дает возможность быстрого поиска нужного файла для его просмотра и скачивания.
• Работают несколько API для получения информации о загруженных файлах в формате json.

---

Информация для разработчика

Установка БД

1.
Скачайте скрипт для установки БД

2.
С помощью любого универсального клиента (например, phpMyAdmin или pgAdmin4) подключитесь к БД и создайте нового пользователя с паролем и новую БД, например:

• fsuser - Пользователь БД
• fsPass$$$20240512 - Пароль Пользователя
• fsdb - БД

Это данные для примера. Позже их надо будет внести в специальный файл подключения БД.

3.
Выполняем SQL-запрос к базе данных fsdb (скрипт, который мы скачали на шаге 1).

Схема взаимосвязей между таблицами БД

Установка прикладного ПО (Программного Обеспечения)

1.
Скачайте дистрибутив с ПО

2.
Разверните скаченный архив в эту папку (например):
d:\web\www\fs_site.localhost\

3.
Внесите изменения в файл:
d:\xampp\apache\conf\extra\httpd-vhosts.conf

######################### fs_site ######################### <Directory "D:/web/www/fs_site.localhost"> Options Indexes FollowSymLinks MultiViews AllowOverride all Order Deny,Allow Allow from all Require all granted </Directory> <VirtualHost *:80> ServerAdmin webmaster@fs_site.localhost DocumentRoot "D:/web/www/fs_site.localhost" ServerName fs_site.localhost ServerAlias www.fs_site.localhost ErrorLog "D:/web/log/fs_site.localhost/error.log" CustomLog "D:/web/log/fs_site.localhost/access.log" common </VirtualHost> ######################### xxxxxxx #########################

Здесь и далее имеется в виду, что мы работаем на сервере с OS Windows, при этом apache и прочий необходимый системный софт установлен в папку d:\xampp\.

4.
Создайте папку с правами на запись и чтение для хранения логов:
d:\web\log\fs_site.localhost\

В эту папку у нас будут записываться логи: error.log и access.log

---

Настройка

1.
Подключение БД

Внесите необходимые изменения в специальный файл подключения БД:
d:\web\www\fs_site.localhost\config\db.php

Это данные должны совпадать с параметрами подключения БД (см выше).

---

Спасибо за внимание!

---