Differences

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

--- rfc:streamline-phar-api [2008/03/28 14:56] – save temporarily lstrojny
+++ rfc:streamline-phar-api [2008/03/28 15:09] – Adding metdata lstrojny
@@ Line 1: / Line 1: @@
 ====== Request for comments: Streamline Phar API ======
+  * **Version:** 0.1
+  * **Date:** 2008-03-28
+  * **Author:** Lars Strojny
+  * **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 20: / Line 28: @@
 === Adding isWritable() method ===
 == Proposal ==
-Add an isWritable() method to determine whether an archive can be written or not.
+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>
@@ Line 29: / Line 37: @@
 </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>
 ==== SplFileInfo ====