Sub-namespaces in PHP - Mini Project: Build & Apply

Using Sub-namespaces in PHP

📖 Scenario: You are organizing a PHP project for a small library system. To keep the code clean and easy to manage, you want to use sub-namespaces to separate different parts of the system.

🎯 Goal: Create a PHP script that defines a main namespace and a sub-namespace. Then, create a class inside the sub-namespace and use it in the main script.

📋 What You'll Learn

Create a main namespace called Library

Create a sub-namespace inside Library called Books

Define a class called Book inside the Library\Books namespace

Create an instance of the Book class and print a message using a method from that class

💡 Why This Matters

🌍 Real World

Organizing code in large PHP projects by grouping related classes into sub-namespaces helps keep the code clean and easy to maintain.

💼 Career

Understanding namespaces and sub-namespaces is important for working on professional PHP projects, frameworks, and libraries.

1

Create the main namespace and sub-namespace with a class

Write PHP code to create a namespace called Library\Books. Inside it, define a class called Book with a public method getTitle() that returns the string 'PHP Basics'.

PHP

<?php

// Define namespace Library\Books and class Book with method getTitle()
// Your code here

Hint

Use the namespace keyword followed by Library\Books. Then define the class Book with the method getTitle() returning the exact string.

2

Create a variable to hold the full class name

Add a variable called bookClass and set it to the string 'Library\\Books\\Book' (note the double backslashes).

PHP

<?php

namespace Library\Books;

class Book {
    public function getTitle() {
        return 'PHP Basics';
    }
}

// Create a variable bookClass with the full class name
// Your code here

Hint

Remember to escape backslashes in PHP strings by using double backslashes.

3

Create an instance of the Book class using the variable

Use the variable $bookClass to create a new instance called $book of the Book class.

PHP

<?php

namespace Library\Books;

class Book {
    public function getTitle() {
        return 'PHP Basics';
    }
}

$bookClass = 'Library\\Books\\Book';

// Create an instance $book of the class stored in $bookClass
// Your code here

Hint

Use the variable class name syntax: new $bookClass().

4

Print the book title using the getTitle() method

Write a print statement to display the result of calling getTitle() on the $book object.

PHP

<?php

namespace Library\Books;

class Book {
    public function getTitle() {
        return 'PHP Basics';
    }
}

$bookClass = 'Library\\Books\\Book';

$book = new $bookClass();

// Print the title of the book using getTitle()
// Your code here

Hint

Use print($book->getTitle()); to show the book title.

Practice

1. What is the main purpose of using sub-namespaces in PHP?

easy

A. To make code run faster

B. To organize code into smaller groups inside bigger groups

C. To change variable types automatically

D. To create new data types

Solution

1. Step 1: Understand what sub-namespaces do

   Sub-namespaces help organize code by grouping related classes or functions inside bigger groups.

2. Step 2: Compare options with this purpose

   Only To organize code into smaller groups inside bigger groups describes organizing code into smaller groups inside bigger groups, which matches the purpose of sub-namespaces.

3. Final Answer:

   To organize code into smaller groups inside bigger groups -> Option B

4. Quick Check:

   Sub-namespaces organize code = To organize code into smaller groups inside bigger groups [OK]

Hint: Sub-namespaces group code inside bigger groups [OK]

Common Mistakes:

• Thinking sub-namespaces speed up code
• Confusing sub-namespaces with data types
• Believing sub-namespaces change variable types

2. Which of the following is the correct way to declare a sub-namespace inside App\Controllers?

easy

A. namespace App.Controllers.Admin;

B. namespace App/Controllers/Admin;

C. namespace App\Controllers\Admin;

D. namespace App-Controllers-Admin;

Solution

1. Step 1: Recall PHP namespace separator

   PHP uses backslashes (\\) to separate namespace levels, not slashes or dots.

2. Step 2: Check each option for correct syntax

   namespace App\Controllers\Admin; uses backslashes correctly. Options A, B, and D use slashes, dots, or dashes, which are invalid.

3. Final Answer:

   namespace App\\Controllers\\Admin; -> Option C

4. Quick Check:

   Backslash separates namespaces = namespace App\Controllers\Admin; [OK]

Hint: Use backslashes (\\) to separate namespace levels [OK]

Common Mistakes:

• Using forward slashes instead of backslashes
• Using dots or dashes in namespace names
• Missing the semicolon at the end

3. What will be the output of this PHP code?

namespace App\Models\User;

class Profile {
    public function getName() {
        return "Alice";
    }
}

$profile = new \App\Models\User\Profile();
echo $profile->getName();

medium

A. Alice

B. Error: Class not found

C. Empty output

D. Fatal error: Syntax error

Solution

1. Step 1: Understand the namespace and class usage

   The class Profile is declared inside the namespace App\\Models\\User. The object is created using the fully qualified name with leading backslash.

2. Step 2: Check the method call and output

   The getName() method returns "Alice", so echoing it prints "Alice".

3. Final Answer:

   Alice -> Option A

4. Quick Check:

   Fully qualified class call returns "Alice" [OK]

Hint: Use leading backslash for full namespace access [OK]

Common Mistakes:

• Forgetting leading backslash causes class not found
• Assuming no output without echo
• Confusing namespace separator with other characters

4. Identify the error in this PHP code using sub-namespaces:

namespace App\Services\Payment

class Processor {
    public function pay() {
        return "Paid";
    }
}

medium

A. Missing semicolon after namespace declaration

B. Class name should be lowercase

C. Method pay() must be static

D. Namespace separator should be a dot

Solution

1. Step 1: Check namespace declaration syntax

   In PHP, namespace declarations must end with a semicolon (;). This code misses it.

2. Step 2: Verify other parts

   Class names can be uppercase, methods do not need to be static, and namespace separators are backslashes, not dots.

3. Final Answer:

   Missing semicolon after namespace declaration -> Option A

4. Quick Check:

   Namespace line must end with ; [OK]

Hint: Always end namespace line with semicolon [OK]

Common Mistakes:

• Omitting semicolon after namespace
• Thinking class names must be lowercase
• Confusing namespace separator with dots

5. Given these two classes in sub-namespaces:

namespace App\Utils\String;
class Formatter {
    public static function format() {
        return "Formatted String";
    }
}

namespace App\Utils\Number;
class Formatter {
    public static function format() {
        return 12345;
    }
}

// In global namespace
use App\Utils\String\Formatter as StringFormatter;
use App\Utils\Number\Formatter as NumberFormatter;

echo StringFormatter::format() . " and " . NumberFormatter::format();

What is the output?

hard

A. 12345 and 12345

B. Error: Cannot use same class name twice

C. Formatted String and Formatted String

D. Formatted String and 12345

Solution

1. Step 1: Understand sub-namespaces and aliasing

   Two classes named Formatter exist in different sub-namespaces. Aliases StringFormatter and NumberFormatter are used to avoid name conflicts.

2. Step 2: Check method calls and outputs

   StringFormatter::format() returns "Formatted String" and NumberFormatter::format() returns 12345. Concatenating them with " and " produces the combined string.

3. Final Answer:

   Formatted String and 12345 -> Option D

4. Quick Check:

   Aliases allow same class names in sub-namespaces [OK]

Hint: Use aliases to handle same class names in sub-namespaces [OK]

Common Mistakes:

• Assuming class name conflict causes error
• Forgetting to use aliases for same class names
• Expecting both outputs to be the same