[PHP-DOC] Bug #9641 Updated: get_required_files()/get_included_files() does not work as docuemented From: danbeck <email protected>
Date: 06/27/01

ID: 9641
Updated by: danbeck
Reported By: yohgaki <email protected>
Old-Status: Open
Status: Closed
Bug Type: Documentation problem
Operating system:
PHP Version: 4.0.4pl1
Assigned To:
Comments:

revamped the get_included_files/get_required_files functions to document their new behavior

Previous Comments:
---------------------------------------------------------------------------

[2001-04-14 05:21:55] yohgaki <email protected>
Document is updated to reflect current PHP behavior. (Some what) Problems are still there, so I reopen this.

Since include()/require()/include_once()/required_once() behavior has been changed recently, descriptions are still incorrect for at least 4.0.4pl1.

I think those functions(lang. constructs) behave almost the same in recent PHP.
(Except require()/require_once() dies when it fails)

include()/require()/include_once()/require_once() now shares the same hash, so result of get_included_files()/get_required_files() are the same. These function also lists files included by include()/require() due to recent changes in these.

This makes function descriptions still incorrect.

Function descriptions for include()/require()/include_once()/require_once()/get_included_files()/get_required_files() are needed to be changed to reflect recent changes.

It would be helpful for users, if there are descriptions about changes in include()/require()/include_once()/required_once(). (At least which versions supposed to work as described)

Hope this helps.

---------------------------------------------------------------------------

[2001-03-17 02:18:33] jmcastagnetto <email protected>
documentation updated to reflect new behavior

---------------------------------------------------------------------------

[2001-03-15 09:22:56] stas <email protected>
Now, get_required_files and get_included_files are the same.
Documentation should be changed.

---------------------------------------------------------------------------

[2001-03-08 18:26:48] yohgaki <email protected>
get_required_files()/get_included_files() does not work as docuemented
http://www.php.net/manual/en/function.get-required-files.php

Tested under Apache 1.3.17 w/ mod-ssl, mod-gzip, and other modules comes with apache. RedHat 7.0.1/j. PHP 4.0.4pl1 running as apache module.

I found strange require_once() behaviour (to be reported as bug) and I also found this problem.

If this is not a script engine problem, then it should be documentation problem. Hope this info helps developer/documentation team.

Following code is identical to the example in manual.
<?php

require_once ('local.php');
require_once ('../inc/global.php');

for ($i=1; $i<5; $i++) {
  include_once 'util'.$i.'php';
}

echo '<pre>';
echo "Required_once filesn";
print_r (get_required_files());

echo "Included_once filesn";
print_r (get_included_files());

echo date('H:i:s',time());
echo '</pre>';

?>

I get

===========================================
Required_once files
Array
(
    [0] => /home/httpd/httpd/html/untitled/local.php
    [1] => /home/httpd/httpd/html/inc/global.php
    [2] => /home/httpd/httpd/html/untitled/util1php
    [3] => /home/httpd/httpd/html/untitled/util2php
    [4] => /home/httpd/httpd/html/untitled/util3php
    [5] => /home/httpd/httpd/html/untitled/util4php
)
Included_once files
Array
(
    [0] => /home/httpd/httpd/html/untitled/local.php
    [1] => /home/httpd/httpd/html/inc/global.php
    [2] => /home/httpd/httpd/html/untitled/util1php
    [3] => /home/httpd/httpd/html/untitled/util2php
    [4] => /home/httpd/httpd/html/untitled/util3php
    [5] => /home/httpd/httpd/html/untitled/util4php
)
08:17:35
=======================================

---------------------------------------------------------------------------

ATTENTION! Do NOT reply to this email!
To reply, use the web interface found at http://bugs.php.net/?id=9641&edit=2