Differences

This shows you the differences between two versions of the page.

--- rfc:streamline-phar-api [2008/03/28 14:53] – save temporarily lstrojny
+++ rfc:streamline-phar-api [2008/03/28 15:17] – Adding directory iterator adjustments lstrojny
@@ Line 1: / Line 1: @@
 ====== Request for comments: Streamline Phar API ======
+  * **Version:** 0.1
+  * **Date:** 2008-03-28
+  * **Author:** Lars Strojny, based on ideas from Elizabeth M. Smith, Marcus Boerger, Benjamin Schulz
+  * **Status:** Under development
 ===== Abstract =====
 This proposal aims to streamline the Phar API to make it more usable and intuitive.
 ===== Concrete change proposals =====
 ==== Phar ====
 === Modifying Phar archive content ===
@@ Line 11: / Line 19: @@
   * offsetUnset()
 == Proposal ==
-In the current API, every path is represented by a single array index. This is counter intuitive, as a multi-dimensional structure (the archive) is represented as a single dimensional array accessible object. The idea is to change that object to be
+In the current API, every path is represented by a single array index. This is counter intuitive, as a multi-dimensional structure (the archive) is represented as a single dimensional array accessible object. The idea is to change that object to represent every path element (e.g. "bar" in "foo/bar/baz") as a single index. This would be accomplished by letting the DirectoryIterator implement ArrayAccess.
 == Code ==
 <code php>
@@ Line 18: / Line 26: @@
 </code>
+=== Adding isWritable() method ===
+== Proposal ==
+Add an isWritable() method to determine whether an archive can be written or not. Not being able to write an archive either means it is disabled in the php.ini (see Phar::canWrite()) or that PHP can't write to the requested location of the phar archive.
+== Code ==
+<code php>
+$phar = new Phar('test.phar');
+if ($phar->isWritable()) {
+    $phar['path']['to']['file'] = "test";
+}
+</code>
+=== Adding createDirectory() ===
+== Proposal ==
+Add the method Phar->createDirectory() to explicitly create a new directory. createDirectory() will return another Phar object and takes a dirname (string) as an argument.
+== Code ==
+<code php>
+$phar = new Phar('test.phar');
+$dir = $phar->createDirectory('foo');
+$dir['file'] = 'content'; // Set the file 'foo/file' to 'content'
+</code>
+=== Adding static create()-factory method ==
+== Proposal ==
+Add a static create method to allow the convenient creation of a Phar-archive from the file system. The create()-method will take two arguments. The first argument is a string with the path to the archive. The second argument is a string with the path to the directory containing the files to be added to the archive. create() will return a Phar-object.
+== Code ==
+<code php>
+$phar = Phar::create('test.phar', 'path/to/source/dir'); // Adds every file and subdirectory to test.phar
+</code>
 ==== SplFileInfo ====
@@ Line 67: / Line 103: @@
 $file->isCompressed(Phar::GZ); // Is the file gzip compressed?
 $file->isCompressed(Phar::BZ2); // Is the file bzip compressed?
+</code>
+==== DirectoryIterator ====
+=== Implement DirectoryIterator ===
+Let DirectoryIterator implement the ArrayAccess interface. By accessing an array index of a directory iterator, the related SplFileInfo object is returned.
+=== Code ===
+<code php>
+$iterator = new DirectoryIterator(__DIR__);
+$file = $iterator['file'];
 </code>

Differences

Page Tools