Skip to content

Commit d2728ce

Browse files
authored
add section about symbolic links (#80)
1 parent 064d9be commit d2728ce

File tree

1 file changed

+11
-0
lines changed
  • resources/views/docs/1/digging-deeper

1 file changed

+11
-0
lines changed

resources/views/docs/1/digging-deeper/files.md

+11
Original file line numberDiff line numberDiff line change
@@ -82,3 +82,14 @@ NativePHP uses the `local` disk by default. If you would like to use a different
8282

8383
Remember, you can set the filesystem disk your application uses by default in your `config/filesystems.php` file or by
8484
adding a `FILESYSTEM_DISK` variable to your `.env` file.
85+
86+
### Symlinks
87+
88+
In traditional web servers, symlinking directories is a common practice - for example, it's a convenient way to expose parts of your filesystem through the public directory.
89+
90+
However, in a NativePHP app, this approach is less applicable. The entire application is already accessible to the end user, and symlinks can cause unexpected issues during the packaging process due to differences in how Unix-like and Windows systems handle symbolic links.
91+
92+
We recommend avoiding symlinks within your NativePHP app. Instead, consider either:
93+
94+
- Placing files directly in their intended locations
95+
- Using Laravel's Storage facade to mount directories outside your application

0 commit comments

Comments
 (0)