7.1 KiB
7.1 KiB
The config is in config/lfm.php
.
Routing:
Key | Type | Description |
---|---|---|
use_package_routes | boolean | Use routes from package or not. If false, you will need to define routes to all controllers of this package. |
middlewares | array | Middlewares to be applied to default routes. For laravel 5.1 and before, remove 'web' from the array. |
url_prefix | string | The url prefix to this package. Change it if necessary. |
Multi-User Mode:
Key | Type | Description |
---|---|---|
allow_multi_user | boolean | If true, private folders will be created for each signed-in user. |
allow_share_folder | boolean | If true, share folder will be created. |
user_field | string | Private folders will be named by this. Can receive column name of users table or class name. |
If you want to name private folders other than columns of users table, follow these steps:
- Run
php artisan vendor:publish --tag=lfm_handler
. - Fill
App\Handler\ConfigHander::class
intouser_field
. - Edit
userField()
in theApp\Handler\ConfigHander
Working Directory:
Key | Type | Description |
---|---|---|
base_directory | string | Which folder to store files in project, fill in 'public', 'resources', 'storage' and so on. Does not support path relative path like ../public_html or public/upload/user/ . |
images_folder_name | string | Does not support path relative path like ../public_html or public/upload/user/ . |
files_folder_name | string | Does not support path relative path like ../public_html or public/upload/user/ . |
shared_folder_name | string | Does not support path relative path like ../public_html or public/upload/user/ . |
thumb_folder_name | string | Does not support path relative path like ../public_html or public/upload/user/ . |
Startup Views:
Key | Type | Description |
---|---|---|
images_startup_view | string | The default display type for images. Supported: "grid", "list". |
files_startup_view | string | The default display type for files. Supported: "grid", "list". |
Upload / Validation:
Key | Type | Description |
---|---|---|
rename_file | string | If true, the uploaded file will be renamed to uniqid() + file extension. |
alphanumeric_filename | string | If true, non-alphanumeric file name will be replaced with _ . |
alphanumeric_directory | boolean | If true, non-alphanumeric folder name will be rejected. |
should_validate_size | boolean | If true, the size of uploading file will be verified. |
max_image_size | int | Specify max size of uploading image. |
max_file_size | int | Specify max size of uploading file. |
should_validate_mime | boolean | If true, the mime type of uploading file will be verified. |
valid_image_mimetypes | array | Array of mime types. Available since v1.3.0 . |
should_create_thumbnails | boolean | If true, thumbnails will be created for faster loading. |
raster_mimetypes | array | Array of mime types. Thumbnails will be created only for these mimetypes. |
create_folder_mode | int | Permission setting for folders created by this package. |
create_file_mode | int | Permission setting for files uploaded to this package. |
should_change_file_mode | boolean | If true, it will attempt to chmod the file after upload |
valid_file_mimetypes | array | Array of mime types. Available since v1.3.0 . |
Thumbnail dimensions:
Key | Type | Description |
---|---|---|
thumb_img_width | string | Width of thumbnail made when image is uploaded. |
thumb_img_height | string | Height of thumbnail made when image is uploaded. |
File Extension Information
Key | Type | Description |
---|---|---|
file_type_array | array | Map file extension with display names. |
file_icon_array | array | Map file extension with icons(font-awsome). |
php.ini override
Key | Type | Description |
---|---|---|
php_ini_overrides | array or boolean | These values override your php.ini settings before uploading files. Set these to false to ingnore and apply your php.ini settings |
Caveats
The php_ini_overrides are applied on every request the filemanager does and are reset once the script has finished executing. This has one drawback: any ini settings that you might want to change that apply to the request itself will not work.
For example, overriding these settings will not work:
- upload_max_filesize
- post_max_size
Why this is expected behaviour: upload_max_filesize and post_max_size will get set but uploaded files are already passed to your PHP script before the settings are changed.