forked from xavierlacot/cleverFilesystemPlugin
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
153 lines (85 loc) · 4.54 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
# cleverFilesystemPlugin
## Introduction
This plugin permits to have an abstract access to the filesystem, whatever its type. The plugin currently supports the traditionnal "disk" filesystem and FTP servers, and provides an easy way to add support for additional file storage systems (FTP, etc.).
This plugin is particularly useful for applications that manage files (a media library, a file upload, etc.), as it provides an easy way to abstract the access to the filesystem. Relocating the files to a new file storage system during the life of the application is made a lot easier, as it only consists in using or writing a new filesystem adapter.
## Features
* filesystem access abstraction
* supports Symfony 1.2
* ORM agnostic
* available adapters : disk, ftp
* unit tests
## How to installed
* go to your project's root
* Install the plugin:
./symfony plugin:install http://plugins.symfony-project.com/cleverFilesystemPlugin
* clear cache:
./symfony cc
## Usage
### Attaching a filesystem
Attaching a filesystem is a similar operation to mounting a filesystem on your operating system.
<?php
// create a "disk" filesystem, locally cached in the /tmp directory
$fs = new cleverFilesystem('Disk', array('root' => '', 'cache_dir' => '/tmp'));
You may also attach a filesystem only by using a configuration defined in the app.yml file:
all:
cleverFilesystemPlugin:
filesystems:
ftpserver:
type: ftp
root: test_de_serveur_ftp
host: localhost
username: michel
password: test
cache_dir: /tmp
localdisk:
type: disk
root: /path/to/my/project/media
cache_dir: /tmp
This can be achieved with a very simple call:
<?php
$fs = cleverFilesystem::getInstance('localdisk');
### Create a file or a directory
<?php
$fs->mkdir('subdir');
$fs->write('subdir/toto.txt', 'Hello, here is toto');
You may also directly create a file. If the containing directory does not exist, it will be created automatically:
<?php
$fs->write('path/to/a/non/existant/dir/toto.txt', 'Hello, here is toto');
In the case of long file contents, you may want to pass a stream as the second parameter:
<?php
$long_file = fopen('/path/to/a/long/file', 'r');
$fs->write('subdir/destination.txt', $long_file);
### Copy a file within the filesystem
The plugin offers the possibility to copy a file within the filesystem. For some filesystem types which depend on limited protocols, like FTP, this will mean downloading the file/directory for uploading it in its new location:
<?php
$fs->copy('subdir/toto.txt', 'an_other_dir/toto.txt');
$fs->copy('subdir', 'path/to/a/non/existing/new/dir');
### Delete a file or a directory
<?php
$fs->unlink('this/is/a/sub/dir/new-file.txt');
$fs->unlink('directory');
## Filesystem verification task
The plugin bundles a task which allows to check the validity of the definition of a filesystem in the app.yml file. For instance:
$ ./symfony filesystem:check frontend localdisk
The task will either explain "The filesystem seems to be valid." or "The filesystem "localdisk" does not seem to be reachable.".
## Run tests
The tests check the validity of the provided adapters, for each of the proposed methods. In order to successfully run the tests, please edit the first few lines of the file plugins/cleverFilesystemPlugin/test/unit/cleverFilesystemTest.php, in order to use your own parameters. Then, run the following command from your project's root directory:
$ php plugins/cleverFilesystemPlugin/test/unit/cleverFilesystemTest.php
## Whishlist
* SVN filesystem adapter
* Database filesystem adapter
* Amazon S3 filesystem adapter
* file creation / deletion hooks and events
* more tests!
* performance improvements
## License and credits
This plugin has been developed by [Xavier Lacot](http://lacot.org/) / [Clever Age](http://www.clever-age.com/) and is licensed under the MIT license.
## Changelog
### version 0.3 - 2010-09-24
* optimized caching when using the disk filesystem type
* added a check before overwriting a file
* in the case of a local disk filesystem, the cache method now returns the original filename, as caching is useless
### version 0.2 - 2009-08-13
Lots of fixes, which helped improve a lot the overall stability.
### version 0.1 - 2009-09-14
Initial public release. Features filesystem access abstraction, and supports Disk and FTP filesystems.