如何使用PHP包括在网站的所有页面中插入HTML存根

Question

I am developing a simple website. It will have close to 20 pages. It has a 3 level hierarchy.

Home
MenuStub
   Category1
      Page1
      Page2
   Category2
      Page1
      Page2
   ....
      ....
      ....

The main navigation will have 4 - 5 items representing each 'category' This will be constant for all the pages. I am not even planning to highlight the current category or anything.

Previously I decided to put the menu HTML stub alone in a separate file and use PHP include to include it in all pages.

But, relative paths might be frustrating. Assume that the menu stub file is located at the root directory.

So, in the root-level pages, the php include will read like

include "menustub.html";

in the second level pages, it should say

include "../menustub.html";

and in third level pages, it should say

include "../../menustub.html";

First, is this the best way to include a single file across all pages in a website?

Second, if the website grows big, and many more levels are added, maintaining this will be a problem. If I suddenly decide to move an entire set of pages one (or several) levels up or down, I should manually go and change the relative paths in each file.

Am I missing something here? Is there a universal way to point to a particular file, that every page will understand, regardless of where it is located?

What is the best way to have a stub and include it in all the pages without having these maintenance nightmares?

Answer 1

It would be much more dynamic to have the index file do all the including, and use GET parameters to tell it which page is to be include.

For example, consider a directory structure like this:

/
  index.php
  /ui
    header.html
    menu.html
    footer.html
    Cat1/
      Page1.html
      Page2.html
    Cat2/
      Page3.html
      Page4.html

If you were to always call the index file, including the name of the category and page you wanted to see, like: index.php?category=Cat1&page=Page1, you could do something like this:

<?php
// Include a header and a menu, defined in their own HTML files.
include('ui/header.html');
include('ui/menu.html');

// Set up a list of valid categories and their sub pages.
$pages = array(
    'Cat1' => array(
        'Page1',
        'Page2'
    ),
    'Cat2' => array(
        'Page3',
        'Page4'
    )
);

// Find the category and page to use.
if(isset($_GET['category'], $pages[$_GET['category']])) {
    $category = $_GET['category'];
} else {
    $category = 'Cat1';
}
if(isset($_GET['page'], $pages[$category][$_GET['page']])) {
    $page = $_GET['page'];
} else {
    $page = 'Page1';
}

// Include the selected content page.
include("ui/{$category}/{$page}.html");

// Include a footer
include('ui/footer.html');
?>

This way you can expand the content as far and deep as you want without having to repeat your includes in every single new file.