zendframework · Freeaqingme · Mar 6, 2013 · Mar 5, 2013 · Mar 5, 2013 · Mar 5, 2013
diff --git a/.gitignore b/.gitignore
@@ -1,10 +1,11 @@
-nbproject
-.idea
 .buildpath
+.DS_Store
+.idea
 .project
 .settings/
-tmp/
-.DS_Store
-composer.lock
 .*.sw*
 .*.un~
+build/
+composer.lock
+nbproject
+tmp/
diff --git a/README.md b/README.md
@@ -13,6 +13,26 @@ DD MMM YYYY
 
 ### UPDATES IN 2.1.4
 
+Better polyfill support in `Zend\Session` and `Zend\Stdlib`. Polyfills
+(version-specific class replacements) have caused some issues in the 2.1 series.
+In particular, users who were not using Composer were unaware/uncertain about
+what extra files needed to be included to load polyfills, and those users who
+were generating classmaps were running into issues since the same class was
+being generated twice.
+
+New polyfill support was created which does the following:
+
+- New, uniquely named classes were created for each polyfill base.
+- A stub class file was created for each class needing polyfill support. A
+  conditional is present in each that uses `class_alias` to alias the appropriate
+  polyfill base as an import. The stub class then extends the base.
+- The `compatibility/autoload.php` files in each component affected was altered
+  to trigger an `E_USER_DEPRECATED` error asking the user to remove the require
+  statement for the file.
+
+The functionality works with both Composer and ZF2's autoloading support, using
+either PSR-0 or classmaps. All typehinting is preserved.
+
 Please see [CHANGELOG.md](CHANGELOG.md).
 
 ### SYSTEM REQUIREMENTS

diff --git a/composer.json b/composer.json
@@ -27,11 +27,7 @@
         "psr-0": {
             "Zend\\": "library/",
             "ZendTest\\": "tests/"
-        },
-        "files": [
-            "library/Zend/Stdlib/compatibility/autoload.php",
-            "library/Zend/Session/compatibility/autoload.php"
-        ]
+        }
     },
     "bin": [
         "bin/classmap_generator.php"

diff --git a/library/Zend/Session/Container.php b/library/Zend/Session/Container.php
@@ -9,6 +9,12 @@
 
 namespace Zend\Session;
 
+if (version_compare(PHP_VERSION, '5.3.4', 'lt')) {
+    class_alias('Zend\Session\AbstractContainer', 'Zend\Session\AbstractBaseContainer');
+} else {
+    class_alias('Zend\Session\Container\PhpReferenceCompatibility', 'Zend\Session\AbstractBaseContainer');
+}
+
 /**
  * Session storage container
  *
@@ -17,24 +23,6 @@
  * Additionally, expiries may be absolute TTLs or measured in "hops", which
  * are based on how many times the key or container were accessed.
  */
-class Container extends AbstractContainer
+class Container extends AbstractBaseContainer
 {
-    /**
-     * Retrieve a specific key in the container
-     *
-     * @param  string $key
-     * @return mixed
-     */
-    public function &offsetGet($key)
-    {
-        $ret = null;
-        if (!$this->offsetExists($key)) {
-            return $ret;
-        }
-        $storage = $this->getStorage();
-        $name    = $this->getName();
-        $ret =& $storage[$name][$key];
-
-        return $ret;
-    }
 }
diff --git a/library/Zend/Session/Container/PhpReferenceCompatibility.php b/library/Zend/Session/Container/PhpReferenceCompatibility.php
@@ -0,0 +1,37 @@
+<?php
+/**
+ * Zend Framework (http://framework.zend.com/)
+ *
+ * @link      http://github.com/zendframework/zf2 for the canonical source repository
+ * @copyright Copyright (c) 2005-2013 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license   http://framework.zend.com/license/new-bsd New BSD License
+ */
+
+namespace Zend\Session\Container;
+
+use Zend\Session\AbstractContainer;
+
+/**
+ * Session storage container for PHP 5.3.4 and above.
+ */
+abstract class PhpReferenceCompatibility extends AbstractContainer
+{
+    /**
+     * Retrieve a specific key in the container
+     *
+     * @param  string $key
+     * @return mixed
+     */
+    public function &offsetGet($key)
+    {
+        $ret = null;
+        if (!$this->offsetExists($key)) {
+            return $ret;
+        }
+        $storage = $this->getStorage();
+        $name    = $this->getName();
+        $ret =& $storage[$name][$key];
+
+        return $ret;
+    }
+}
diff --git a/library/Zend/Session/Storage/SessionArrayStorage.php b/library/Zend/Session/Storage/SessionArrayStorage.php
@@ -9,30 +9,15 @@
 
 namespace Zend\Session\Storage;
 
+if (version_compare(PHP_VERSION, '5.3.4', 'lt')) {
+    class_alias('Zend\Session\Storage\AbstractSessionArrayStorage', 'Zend\Session\Storage\AbstractBaseSessionArrayStorage');
+} else {
+    class_alias('Zend\Session\Storage\SessionArrayStorage\PhpReferenceCompatibility', 'Zend\Session\Storage\AbstractBaseSessionArrayStorage');
+}
+
 /**
  * Session storage in $_SESSION
  */
-class SessionArrayStorage extends AbstractSessionArrayStorage
+class SessionArrayStorage extends AbstractBaseSessionArrayStorage
 {
-    /**
-     * Get Offset
-     *
-     * @param  mixed $key
-     * @return mixed
-     */
-    public function &__get($key)
-    {
-        return $_SESSION[$key];
-    }
-
-    /**
-     * Offset Get
-     *
-     * @param  mixed $key
-     * @return mixed
-     */
-    public function &offsetGet($key)
-    {
-        return $_SESSION[$key];
-    }
 }
diff --git a/library/Zend/Session/Storage/SessionArrayStorage/PhpReferenceCompatibility.php b/library/Zend/Session/Storage/SessionArrayStorage/PhpReferenceCompatibility.php
@@ -0,0 +1,40 @@
+<?php
+/**
+ * Zend Framework (http://framework.zend.com/)
+ *
+ * @link      http://github.com/zendframework/zf2 for the canonical source repository
+ * @copyright Copyright (c) 2005-2013 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license   http://framework.zend.com/license/new-bsd New BSD License
+ */
+
+namespace Zend\Session\Storage\SessionArrayStorage;
+
+use Zend\Session\Storage\AbstractSessionArrayStorage;
+
+/**
+ * PHP 5.3.4 and greater variant of SessionArrayStorage
+ */
+abstract class PhpReferenceCompatibility extends AbstractSessionArrayStorage
+{
+    /**
+     * Get Offset
+     *
+     * @param  mixed $key
+     * @return mixed
+     */
+    public function &__get($key)
+    {
+        return $_SESSION[$key];
+    }
+
+    /**
+     * Offset Get
+     *
+     * @param  mixed $key
+     * @return mixed
+     */
+    public function &offsetGet($key)
+    {
+        return $_SESSION[$key];
+    }
+}
diff --git a/library/Zend/Session/compatibility/Container.php b/library/Zend/Session/compatibility/Container.php
diff --git a/library/Zend/Session/compatibility/Storage/SessionArrayStorage.php b/library/Zend/Session/compatibility/Storage/SessionArrayStorage.php
diff --git a/library/Zend/Session/compatibility/autoload.php b/library/Zend/Session/compatibility/autoload.php
@@ -1,11 +1,14 @@
 <?php
-if (version_compare(PHP_VERSION, '5.3.4', 'lt')) {
-    if (!class_exists('Zend\Stdlib\ArrayObject', false)
-        && file_exists(__DIR__ . '/../../Stdlib/compatibility/autoload.php')
-    ) {
-        require __DIR__ . '/../../Stdlib/compatibility/autoload.php';
-    }
+/**
+ * Zend Framework (http://framework.zend.com/)
+ *
+ * @link      http://github.com/zendframework/zf2 for the canonical source repository
+ * @copyright Copyright (c) 2005-2013 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license   http://framework.zend.com/license/new-bsd New BSD License
+ * @deprecated
+ */
 
-    require_once __DIR__ . '/Container.php';
-    require_once __DIR__ . '/Storage/SessionArrayStorage.php';
-}
+/**
+ * Legacy purposes only, to prevent code that references it from breaking.
+ */
+trigger_error('Polyfill autoload support (file library/Zend/Session/compatibility/autoload.php) is no longer necessary; please remove your require statement referencing this file', E_USER_DEPRECATED);
diff --git a/library/Zend/Session/composer.json b/library/Zend/Session/composer.json
@@ -9,10 +9,7 @@
     "autoload": {
         "psr-0": {
             "Zend\\Session\\": ""
-        },
-        "files": [
-            "Zend/Session/compatibility/autoload.php"
-        ]
+        }
     },
     "target-dir": "Zend/Session",
     "require": {