Sub-namespaces in PHP

Introduction

Sub-namespaces help organize code into smaller groups inside bigger groups. This keeps code neat and avoids name clashes.

When you have many classes or functions and want to group them by feature or module.

When different parts of your project use the same class or function names.

When you want to make your code easier to find and maintain.

When working in a team and need clear code structure.

When building large applications with many components.

Syntax

PHP

<?php
namespace MainNamespace\SubNamespace;

class MyClass {
    // class code here
}

Use backslashes (\) to separate namespaces.

Sub-namespaces are like folders inside folders for your code.

Examples

This defines a class inside the App\Controllers sub-namespace.

PHP

<?php
namespace App\Controllers;

class HomeController {
    // code
}

This shows a function inside a deeper sub-namespace App\Models\User.

PHP

<?php
namespace App\Models\User;

function getUser() {
    // code
}

Here, Feature is inside a three-level sub-namespace.

PHP

<?php
namespace Company\Project\Module;

class Feature {
    // code
}

Sample Program

This program defines a Book class inside the Library\Books sub-namespace. It creates an object and prints the book title.

PHP

<?php
namespace Library\Books;

class Book {
    public function getTitle() {
        return "Learning PHP";
    }
}

// Using the class
$book = new Book();
echo $book->getTitle();

Important Notes

Remember to use the full namespace path when using classes from sub-namespaces outside their namespace.

You can use the use keyword to import sub-namespaces for easier access.

Summary

Sub-namespaces organize code into smaller groups inside bigger groups.

They help avoid name conflicts and keep code clean.

Use backslashes (\) to separate namespace levels.

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