source: php/trunk/doxygen/doc_page_appedix_arc2patch.php

<?PHP

/* RDFInt.php - RDF Interfaces for PHP
 * Copyright 2011 netlabs.org
 * Author: Christian Langanke, Adrian Gschwend
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/**
 * @page page_appendix_arc2_patch Appendix: Patch for ARC2 for usage under Windows operating systems
 *
 * For usage under Windows operating systems, the method
 * ARC2_Class::calcBase($path) needs a patch in order to cope with
 * Windows style pathnames including backslashes.
 *
 * The reason for this is that the PHP function \c realpath returns
 * path names including backslashes. Such path names are however invalid
 * for other PHP functions. As the time of this writing, this behaviour 
 * has been reproduced up to PHP V5.3.5..
 *
 * The patched method from v2.0.0-0-g270696b looks as follows:
\code
  function calcBase($path) {
    $r = $path;
    $r = preg_replace('/\#.*$/', '', $r);/* remove hash */
    $r = preg_replace('/^\/\//', 'http://', $r);/* net path (//), assume http */
    if (preg_match('/^[a-z0-9]+\:/', $r)) {/* scheme, abs path */
      while (preg_match('/^(.+\/)(\.\.\/.*)$/U', $r, $m)) {
        $r = $this->calcURI($m[1], $m[2]);
      }
      return $r;
    }
    // return realpath, but take care for windows systems
    $realpath = realpath($r);
    if (substr( realpath($r), 1, 2) == ':\\')
      $realpath = str_replace( '\\', '/', $realpath);
    return 'file://' . $realpath;/* real path */
  }
\endcode
 */


?>