php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #9641 get_required_files()/get_included_files() does not work as docuemented
Submitted: 2001-03-08 18:26 UTC Modified: 2001-06-27 01:45 UTC
From: yohgaki at dd dot iij4u dot or dot jp Assigned:
Status: Closed Package: Documentation problem
PHP Version: 4.0.4pl1 OS: RedHat7
Private report: No CVE-ID: None
 [2001-03-08 18:26 UTC] yohgaki at dd dot iij4u dot or dot jp
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 files\n";
print_r (get_required_files());

echo "Included_once files\n";
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
=======================================

Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2001-03-15 09:22 UTC] stas@php.net
Now, get_required_files and get_included_files are the same.
Documentation should be changed. 
 [2001-03-17 02:18 UTC] jmcastagnetto@php.net
documentation updated to reflect new behavior
 [2001-04-14 05:21 UTC] yohgaki at dd dot iij4u dot or dot jp
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-06-27 01:45 UTC] danbeck@php.net
revamped the get_included_files/get_required_files functions to document their new behavior
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Fri Apr 26 08:01:30 2024 UTC