PHP magic constants describe the place where your code is written. __DIR__ gives the directory of the current file, __FILE__ gives its full filename, and __LINE__ gives the current source line. Their values depend on their location, which makes them different from ordinary constants that you declare yourself.
These constants solve practical problems: loading a file reliably after the working directory changes, adding useful context to a diagnostic message, and identifying the class or method responsible for an action. You will learn the main names, see why included files have their own locations, and build a small path helper. Review include and require if loading another PHP file is still unfamiliar.
The location constants
__FILE__ is the full path and filename of the file containing the expression. __DIR__ is that file's directory, equivalent to taking dirname(__FILE__). The directory normally has no trailing separator, except when the path itself is a filesystem root. __LINE__ is the source line where the constant appears. These values describe source location, not where an HTTP visitor is located or which URL they requested.
Suppose a file in app/helpers is included by public/index.php. Inside the helper, __DIR__ still refers to app/helpers. It does not suddenly become the directory of the entry script. This behavior is exactly what you need when the helper loads a neighboring resource. By comparison, getcwd() describes the process working directory and can change with chdir().
Paths depend on the operating system and checkout location. An example showing C:\\project will not print that same path on Linux. For portable learning examples, print basename(__FILE__) or explicitly describe the expected shape of a path. Never write an absolute path from a tutorial into production configuration and expect it to exist on another server.
Function, method, class and namespace names
__FUNCTION__ describes the function containing the expression. In a class method it gives the method name without the class prefix. __METHOD__ includes the class and method, making it helpful when several classes have a method called save. __CLASS__ identifies the class containing the code, including its namespace. Outside the corresponding context, these names can be empty strings.
__NAMESPACE__ contains the current namespace name. Code in the global namespace receives an empty string. __TRAIT__ describes a trait containing the expression and includes its namespace. A trait's __CLASS__ can instead reflect the class using that trait, so the names answer different questions. Choose the one that describes the context you want to record.
These expressions are resolved from code location. They are not interchangeable with runtime inspection such as get_class($object), which can reveal the actual object class. In inherited methods, __CLASS__ continues to refer to the class where the method was declared. This distinction matters when diagnosing inheritance and late static binding.
Build paths from the file that owns them
Use __DIR__ . '/config.php' when the target file lives next to the current file. Use dirname(__DIR__) to move to the parent directory deliberately. PHP accepts forward slashes for many filesystem operations on Windows as well as Unix-like systems. DIRECTORY_SEPARATOR is available when constructing platform-specific paths, but it does not validate a path or prevent traversal.
Anchor only trusted application paths this way. If you append a filename supplied by a visitor, __DIR__ does not make that name safe. An input containing ../ can still refer outside the intended folder. Prefer an allowlist that maps a short input name to an approved file. Keep filesystem path building separate from URL building; a server directory path is not a public web address.
For dependencies managed by Composer, loading vendor/autoload.php from the project root is a common use. The exact number of parent directories depends on the file's location. Sketch the actual folder tree before writing the expression. Changing where a helper lives can change its path calculations even when the entry script stays in the same directory.
PHP Magic Constants Examples
Each example shows the code, the output it produces and what each part does.
Inspect a file's location
Save this complete example as location.php. The first two results are stable across operating systems. The final boolean verifies the relationship between the two location constants without exposing an absolute machine path.
The line number is three because the opening PHP tag occupies the first line. If you insert a comment above the expression, that number changes. This is why a diagnostic line number should describe the code as it exists now rather than being copied into a permanent explanation.
<?php
echo basename(__FILE__) . PHP_EOL;
echo __LINE__ . PHP_EOL;
var_export(__DIR__ === dirname(__FILE__));
echo PHP_EOL;location.php
3
trueIdentify the method doing the work
The three values provide increasingly specific context. A class name alone identifies the component; a function name alone identifies the local operation; the method name joins both. They are useful for logs, but an application should still include the relevant request identifier and operation result when those explain the problem better.
<?php
class Receipt {
public function label(): string {
return __CLASS__ . '|' . __FUNCTION__ . '|' . __METHOD__;
}
}
echo (new Receipt())->label() . PHP_EOL;Receipt|label|Receipt::labelCommon PHP Magic Constants Mistakes
Confusing magic constants with magic methods
__DIR__ is a constant-like expression. __construct() and __get() are methods called by PHP during object operations. They share the double-underscore naming convention but have different syntax and purposes. Adding parentheses to __FILE__ does not turn it into a function.
Do not show full filesystem paths in public error pages. They can reveal deployment layout and usernames without helping a visitor. Use detailed paths in controlled logs and a suitable public error message in responses. The official magic constants reference also documents newer additions such as PHP 8.4's __PROPERTY__ for property hooks. The core examples here do not require property hooks.
PHP Magic Constants in Real Projects
Practical task: a predictable report path
Imagine paths.php lives at your project root. Write a helper that returns the path to a trusted report filename in the reports subdirectory. For this exercise the filename is fixed in application code. The task is to anchor the path to the helper's file, not to the process working directory, and then inspect its last two components.
<?php
function monthlyReportPath(): string {
return __DIR__ . '/reports/monthly.csv';
}
$path = monthlyReportPath();
echo basename(dirname($path)) . PHP_EOL;
echo basename($path) . PHP_EOL;reports
monthly.csvThe helper constructs a path without reading or creating the file. Before opening it, the caller still needs to handle a missing directory, permissions and file errors. Try moving the PHP file into a src directory and decide whether the report folder should move with it or remain at the project root. That decision determines whether to add dirname(__DIR__).
PHP Magic Constants FAQ
Does __DIR__ follow the entry script?
No. It belongs to the file where it is written, including an included file. That is why it is a reliable anchor for neighboring resources.
Is __FILE__ a URL?
No. It is a filesystem path. Use routing or request information when you need a URL, and avoid assuming a direct path-to-URL mapping.
Can I assign a different value to __LINE__?
No. PHP supplies it from source position. Store it in a variable if you need to pass the value to a logger.
Which name should a logger use?
__METHOD__ is often useful inside classes. A log message should also explain the event; a method name without the attempted action and result can be too vague.
PHP Magic Constants Exercises
Answer each one and check it instantly. If you get stuck, open the hint before the answer.
Which expression most directly identifies a class and method together?
PHP Magic Constants Quiz
2 questions to check what you learned.
Which expression identifies the directory of the file containing it?
- $_SERVER['HTTP_HOST']
- __LINE__
- __DIR__
A helper is included by index.php. What does __FILE__ inside the helper describe?
- The helper's own full filename
- Always index.php
- The browser's current URL