C#•2w ago

UseStaticFiles for HTML

I have generated a Static WebApp from my Markdown Files.

c#
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(Path.Combine(builder.Environment.ContentRootPath, "Documentation")),
    RequestPath = "/docs",
});

c#
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(Path.Combine(builder.Environment.ContentRootPath, "Documentation")),
    RequestPath = "/docs",
});

I want this to serve the File "Documentation/Userguide.html" if the route is "/docs/Userguide" If i serve it via NGNIX i would configure something like this

 location / {
        try_files $uri $uri.html $uri/ =404;
 }

 location / {
        try_files $uri $uri.html $uri/ =404;
 }

14 Replies

DeaDo•2w ago

Now im looking for something equivalent in asp.net core the first thing I came up with is a simple middleware:

c#
app.Use(async (context, next) =>
{
    await next();
    if (context.Request.Path.Value.StartsWith("/docs"))
    {
        context.Request.Path = context.Request.Path + ".html";
        await next();
    }
});

c#
app.Use(async (context, next) =>
{
    await next();
    if (context.Request.Path.Value.StartsWith("/docs"))
    {
        context.Request.Path = context.Request.Path + ".html";
        await next();
    }
});

But i don't like it

Angius•2w ago

https://learn.microsoft.com/en-us/aspnet/core/fundamentals/static-files?view=aspnetcore-8.0

app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
           Path.Combine(builder.Environment.ContentRootPath, "docs")),
    RequestPath = "/docs"
});

app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
           Path.Combine(builder.Environment.ContentRootPath, "docs")),
    RequestPath = "/docs"
});

canton7•2w ago

How does that process the .html suffix?

Angius•2w ago

It just serves all the files wholesale, as they are You request /docs/index.html it serves index.html from docs directory You request /docs/skunga.xyz you get skunga.xyz Just like wwwroot

canton7•2w ago

The question is specifically about how to serve the file Foo.html from the route /docs/Foo OP already has the code you posted in their question. They're asking something else

Angius•2w ago

Ah, damn, you're right In that case I'd either stick to this custom middleware, or I'd write a controller that does that

canton7•2w ago

It doesn't look like there's anything in PhysicalFileProvider to support this

Angius•2w ago

[Controller]
[Route("[controller]")]
public class DocsController
{
    [HttpGet("{file}")]
    public FileResult GetFile(string file)
    {
        var path = Path.Join("docs", $"{file.ToLower()}.html")
        using file = File.Open(path);
        return File(file, "text/html")
    }
}

[Controller]
[Route("[controller]")]
public class DocsController
{
    [HttpGet("{file}")]
    public FileResult GetFile(string file)
    {
        var path = Path.Join("docs", $"{file.ToLower()}.html")
        using file = File.Open(path);
        return File(file, "text/html")
    }
}

Something like this should work

canton7•2w ago

Be very VERY careful there. PhysicalFileProvider has a lot of stuff to prevent you from traversing outside of the webroot. Your code has none of that I suspect I could read any file on the filesystem with that

Angius•2w ago

Huh, would File.Open() accept a path like docs/../../../../../../../../secretpasswords.html?

canton7•2w ago

Sure

Angius•2w ago

How do you overcome wanting a .pubkey file with the .html extension being hardcoded into the path?

canton7•2w ago

https://source.dot.net/#Microsoft.Extensions.FileProviders.Physical/PhysicalFileProvider.cs,c7243b62fd6ea79f, look for PathUtils.PathNavigatesAboveRoot and IsUnderneathRoot

DeaDo•2w ago

Thanks for your help @ZZZZZZZZZZZZZZZZZZZZZZZZZ & @canton7. That try_files feature would be useful in UseStaticFiles because it seems that many SSGs rely on that behavior. Ill stick with the Middleware for now. It works & there are no conflicts (at least for my static files)

Gaming

Programming

UseStaticFiles for HTML