Download the PHP package originphp/storage without Composer

Storage

The Storage library provides an easy way to access different types of storages from local disk, ZIP archives, FTP and SFTP. Its a unified approach for working with different storages.

Installation

To install this package

Configuration

You need to configure the default storage engine, you can use multiple engines, but there must be a default one.

In your bootstrap/configuration files add

Using Storage

Writing To Storage

You can also write to folders directly. Folders in the tree that do not exist will be created automatically.

Reading From Storage

Deleting From Storage

To delete files or folders

Folders are deleted recursively automatically, when using delete.

Listing Storage Contents

Version 2.0 no longer lists names of files relative to the path you pass to the list method. The full path name is always returned.

To list the files on the storage

Storage contents are listed recursively and it will provide you with an array of FileObjects. Each file has is an object which can be accessed as an array or an object

When the FileObject is converted to a string it will become a path e.g. /main/subfolder/foo.txt

If you just want the files of particular folder, then it will list all files recursively under that folder.

Working with Multiple Storages

Whether you are using multiple storage engines, or you multiple configurations for a single storage engine, the Storage utility is flexible.

You can get the configured Storage volume

Or you can pass an options array telling the Storage object which configuration to use

Storage Engines

Local

The local storage simply works with data from the drive.

FTP

Then you need to configure this

options for configuring FTP include:

• host: the hostname or ip address
• port: the port number. default 21
• username: the ftp username
• password: the ftp password
• timeout: default 10 seconds
• passive: deafult false
• root: the root folder of the storage within your ftp account
• ssl: default: false

SFTP

To use the SFTP engine, you need to install phpseclib

Then configure as follows:

If you use want to use a private key to login, you can either provide the filename with the full path or the contents of the private key itself.

If your private key requires a password then you can provide that as well. See the How to setup SSH keys tutorial for more information.

options for configuring SFTP include:

• host: the hostname or ip address
• port: the port number. default 22
• username: the ssh account username
• password: the ssh account password
• timeout: default 10 seconds
• root: the root folder of the storage. e.g. /home/user/sub_folder
• privateKey: either the private key for the account or the filename where the private key can be loaded from

S3

The S3 Engine works with Amazon S3 and any other object storage server which uses the S3 protocol, for example minio.

To use the S3 Engine, you need to install the Amazon AWS SDK

Then you can configure the S3 engine like this

Options for configuring the S3 engine are:

• credentials: this is required and is an array with both key and secret
• region: The label for location of the server
• version: version setting
• endpoint: If you are not using Amazon S3. e.g. http://127.0.0.1:9000
• bucket: The name of the bucket, this is required and the bucket should exist.

Minio Server (S3)

To fire up your own minio server locally you can run the docker command

You can access this also using your web browser at http://127.0.0.1:9000.

Zip

To use the ZIP storage engine, provide the filename with a full path.