[idle sign]

CFile extension offers commonly used functions for file manipulation.
http://www.yiiframew...extension/cfile

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

[idle sign]

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.yiiframew...extension/cfile

[Spyros]

That's great.
I think a download() method would be usefull

[idle sign]

Spyros, on 26 October 2009 - 05:34 AM, said:

That's great.
I think a download() method would be usefull

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

[idle sign]

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.yiiframew...xtension/cfile/

[Mike]

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?

[idle sign]

Mike, on 27 October 2009 - 04:13 AM, said:

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?

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

[Mike]

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

[idle sign]

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.yiiframew...xtension/cfile/

[datashaman]

Mike, on 27 October 2009 - 04:13 AM, said:

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?

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).

This post has been edited by datashaman: 03 November 2009 - 06:55 AM

[ekerazha]

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

[idle sign]

ekerazha, on 03 November 2009 - 08:21 AM, said:

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

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

[ekerazha]

idle sign, on 03 November 2009 - 10:07 AM, said:

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

http://www.yiiframew...s-naming-why-e/

Read the qiang message

[Y!!]

Also described in the definitive guide: http://www.yiiframew...asics.namespace

Quote

Tip: Because PHP prior to 5.3.0 does not support namespace intrinsically, you cannot create instances of two classes who have the same name but with different definitions. For this reason, all Yii framework classes are prefixed with a letter 'C' (meaning 'class') so that they can be differentiated from user-defined classes. It is recommended that the prefix 'C' be reserved for Yii framework use only, and user-defined classes be prefixed with other letters.

[idle sign]

ekerazha, on 03 November 2009 - 10:32 AM, said:

http://www.yiiframew...s-naming-why-e/

Read the qiang message

Y!!, on 03 November 2009 - 10:33 AM, said:

Also described in the definitive guide: http://www.yiiframew...asics.namespace

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.

[Mike]

idle sign, on 03 November 2009 - 11:24 AM, said:

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

Hmm. Do we have Yii conventions?

[idle sign]

Mike, on 03 November 2009 - 11:38 AM, said:

Hmm. Do we have Yii conventions?

I think so
http://www.yiiframew...sics.convention

[Mike]

Oh, right. I forgot

[scythah]

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.

[idle sign]

scythah, on 17 November 2009 - 01:58 PM, said:

In the dirContents function, the $recursive parameter doesn't actually do anything.

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.