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
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: yohgaki at dd dot iij4u dot or dot jp
New email:
PHP Version: OS:

 

 [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

Pull Requests

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-2025 The PHP Group
All rights reserved.
Last updated: Tue May 06 16:01:28 2025 UTC