[EXTENSION] CFile

Yii 1.1 Extensions
1

CFile extension offers commonly used functions for file manipulation.

http://www.yiiframework.com/extension/cfile

This topic is for your feedback. You’re welcome.

2

Version 0.2 available

  • new: getContents() and setContents() methods

  • new: create() method

  • new: ‘readable’ & ‘writeable’ properties

  • fix: posix family functions existance check (in getOwner() & getGroup())

http://www.yiiframework.com/extension/cfile

3

That’s great.

I think a download() method would be usefull

4

Certainly, Spyros, that’s one of the upcoming release @todos.

5

Version 0.3 available

  • new: setBasename() method (lazy file rename)

  • new: setFilename() method (lazy file rename)

  • new: setExtension() method (lazy file rename)

  • new: download() method

  • chg: copy() & rename() methods improved (destination file name without path is enough for them to perform actions in the current file directory)

  • fix: ‘extension’ key existance check (in pathInfo())

http://www.yiiframework.com/extension/cfile/

6

Minor note: Shouldn’t it more correctly be called “send()” instead of “download()”? E.g. what if you want to supply a method to really download a file from somewhere else to the server?

7

Probably something like "fetch()" would make sense in that case, I believe. What do you think?

8

Yeah, well: remember you’re on the server side. “download” would be the action on the client side. The server will “send”. But that’s really just nitpicking :)

9

Version 0.4 is available, introducing directory handling functionality

  • new: ‘isFile’ & ‘isDir’ properties

  • new: rename(), move(), copy(), delete(), getSize() and getContents() methods now are able to deal with directories

  • new: purge() method to empty filesystem object

  • new: createDir() method to create directory

  • new: ‘isEmpty’ property

  • chg: ‘$formatPrecision’ param of getSize() method now changed to ‘$format’ and accepts format pattern for ‘CNumberFormatter’

  • chg: download() method is now alias for primary send() method

  • chg: now ‘readable’ & ‘writeable’ properties are loaded on set() even when in non-greedy mode

  • fix: unnecessary file availability checks when ‘greedy’ option is specified for set() removed

http://www.yiiframework.com/extension/cfile/

10

Sendfile is a name for this, and it describes exactly what the application is doing. (EDIT: But would probably be confused with X-SENDFILE which is different).

11

The "C" prefix is discouraged for extensions as should be used only for core classes. A common practice was to use the "E" prefix

12

Where do you get it from, I should ask, have I missed something?

13

http://www.yiiframework.com/forum/index.php?/topic/869-class-naming-why-e/

Read the qiang message

14

Also described in the definitive guide: http://www.yiiframework.com/doc/guide/basics.namespace

15

I see, yes, thank you.

I suppose if this is a discourage as such it should rather be stated in Yii Conventions, not as a Tip or forum message.

But I’ll bear it in mind.

16

Hmm. Do we have Yii conventions?

17

I think so :D

http://www.yiiframework.com/doc/guide/basics.convention

18

Oh, right. I forgot :)

19

In the dirContents function, the $recursive parameter doesn’t actually do anything. Regardless of whether it’s set to true or false, the function always returns a recursive result.

Also, can I please request a feature? I would like a way to be able to use:


Yii::app()->file->set('/files/')->contents

To only display the files/folders in the current folder (ie. non-recursive).

Thanks.

20

Thank you for the report.

Recursive parameter issue would be fixed in 0.5, and so with that “Yii::app()->file->set(’/files/’)->contents” would work as expected.