Skip to content

Commit 2d5cab4

Browse files
committed
Add note for Physical File Provider.
1 parent 569b2a3 commit 2d5cab4

File tree

1 file changed

+3
-0
lines changed

1 file changed

+3
-0
lines changed

aspnetcore/fundamentals/file-providers.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,9 @@ The following table lists implementations of `IFileProvider`.
5959

6060
The <xref:Microsoft.Extensions.FileProviders.PhysicalFileProvider> provides access to the physical file system. `PhysicalFileProvider` uses the <xref:System.IO.File?displayProperty=fullName> type (for the physical provider) and scopes all paths to a directory and its children. This scoping prevents access to the file system outside of the specified directory and its children. The most common scenario for creating and using a `PhysicalFileProvider` is to request an `IFileProvider` in a constructor through [dependency injection](xref:fundamentals/dependency-injection).
6161

62+
> [!WARNING]
63+
> `PhysicalFileProvider` scopes access to its root directory and child paths, but this doesn't guarantee a security sandbox. Symbolic links under the root can still expose files outside the root directory.
64+
6265
When instantiating this provider directly, an absolute directory path is required and serves as the base path for all requests made using the provider. Glob patterns aren't supported in the directory path.
6366

6467
The following code shows how to use `PhysicalFileProvider` to obtain directory contents and file information:

0 commit comments

Comments
 (0)