Mercurial > dirlist-php
annotate README.md @ 62:4cb6f04f95c1 default tip
Fix handling url with %2F path
| author | nanaya <me@nanaya.net> |
|---|---|
| date | Sat, 08 Feb 2025 01:52:13 +0900 |
| parents | 25e3119e91b2 |
| children |
| rev | line source |
|---|---|
|
13
b6b65a5b9c1a
Change readme title and add note for apache.
edogawaconan <me@myconan.net>
parents:
12
diff
changeset
|
1 dirlist |
|
b6b65a5b9c1a
Change readme title and add note for apache.
edogawaconan <me@myconan.net>
parents:
12
diff
changeset
|
2 ======= |
| 1 | 3 |
| 4 Using capability of nginx. | |
| 5 | |
| 29 | 6 Usage |
| 7 ----- | |
| 8 | |
| 9 ### nginx | |
| 1 | 10 |
| 11 location @lister { | |
|
10
47a281c1d54e
Update documentation to match current code.
edogawaconan <me@myconan.net>
parents:
1
diff
changeset
|
12 include fastcgi_params; |
| 1 | 13 fastcgi_pass unix:/tmp/php-fcgi.sock; |
|
24
f9588ccb7a42
Add note for optional parameter.
edogawaconan <me@myconan.net>
parents:
23
diff
changeset
|
14 |
|
f9588ccb7a42
Add note for optional parameter.
edogawaconan <me@myconan.net>
parents:
23
diff
changeset
|
15 // BEGIN -- only when using alias |
|
10
47a281c1d54e
Update documentation to match current code.
edogawaconan <me@myconan.net>
parents:
1
diff
changeset
|
16 uninitialized_variable_warn off; |
|
23
949398173ecb
Much simpler setup with $request_filename.
edogawaconan <me@myconan.net>
parents:
13
diff
changeset
|
17 fastcgi_param DL_DIR $dl_dir; |
|
24
f9588ccb7a42
Add note for optional parameter.
edogawaconan <me@myconan.net>
parents:
23
diff
changeset
|
18 // END ---- only when using alias |
|
f9588ccb7a42
Add note for optional parameter.
edogawaconan <me@myconan.net>
parents:
23
diff
changeset
|
19 |
|
10
47a281c1d54e
Update documentation to match current code.
edogawaconan <me@myconan.net>
parents:
1
diff
changeset
|
20 fastcgi_param SCRIPT_FILENAME /path/to/index.php; |
| 1 | 21 } |
| 22 | |
|
23
949398173ecb
Much simpler setup with $request_filename.
edogawaconan <me@myconan.net>
parents:
13
diff
changeset
|
23 (adjust the path to `index.php` and `php-fcgi`). |
| 1 | 24 |
|
23
949398173ecb
Much simpler setup with $request_filename.
edogawaconan <me@myconan.net>
parents:
13
diff
changeset
|
25 And whenever a directory needs to be autoindexed, add |
| 1 | 26 |
|
10
47a281c1d54e
Update documentation to match current code.
edogawaconan <me@myconan.net>
parents:
1
diff
changeset
|
27 location / { |
|
47a281c1d54e
Update documentation to match current code.
edogawaconan <me@myconan.net>
parents:
1
diff
changeset
|
28 try_files $uri @lister; |
|
47a281c1d54e
Update documentation to match current code.
edogawaconan <me@myconan.net>
parents:
1
diff
changeset
|
29 } |
|
47a281c1d54e
Update documentation to match current code.
edogawaconan <me@myconan.net>
parents:
1
diff
changeset
|
30 |
|
23
949398173ecb
Much simpler setup with $request_filename.
edogawaconan <me@myconan.net>
parents:
13
diff
changeset
|
31 . |
|
949398173ecb
Much simpler setup with $request_filename.
edogawaconan <me@myconan.net>
parents:
13
diff
changeset
|
32 |
|
949398173ecb
Much simpler setup with $request_filename.
edogawaconan <me@myconan.net>
parents:
13
diff
changeset
|
33 Note that if the directory is aliased, `$dl_dir` (fastcgi `DL_DIR`) needs to be set. |
|
10
47a281c1d54e
Update documentation to match current code.
edogawaconan <me@myconan.net>
parents:
1
diff
changeset
|
34 |
| 1 | 35 location /anime/win/ { |
|
23
949398173ecb
Much simpler setup with $request_filename.
edogawaconan <me@myconan.net>
parents:
13
diff
changeset
|
36 set $dl_dir $request_filename; |
|
949398173ecb
Much simpler setup with $request_filename.
edogawaconan <me@myconan.net>
parents:
13
diff
changeset
|
37 alias /srv/ftp/; |
| 38 | 38 try_files $uri @lister; // try_files "" @lister if the alias is in a regular expression location. |
| 1 | 39 } |
| 40 | |
| 29 | 41 ### apache |
| 42 | |
| 43 Assuming `mod_rewrite` is enabled, add this `.htaccess`: | |
| 44 | |
| 45 RewriteEngine On | |
| 46 RewriteCond %{REQUEST_FILENAME} -d | |
| 47 RewriteRule ^ /path/to/index.php [L] | |
| 48 | |
| 49 Note that `/path/to/index.php` should be visible from your location. Or something. I don't really know Apache. | |
| 50 | |
| 51 Also note that this `.htaccess` does not disable server processing of `php` or any other non-static files. | |
|
23
949398173ecb
Much simpler setup with $request_filename.
edogawaconan <me@myconan.net>
parents:
13
diff
changeset
|
52 |
|
28
ce92f4d41714
Add support for displaying hidden files.
edogawaconan <me@myconan.net>
parents:
24
diff
changeset
|
53 Configurations |
|
ce92f4d41714
Add support for displaying hidden files.
edogawaconan <me@myconan.net>
parents:
24
diff
changeset
|
54 -------------- |
|
ce92f4d41714
Add support for displaying hidden files.
edogawaconan <me@myconan.net>
parents:
24
diff
changeset
|
55 |
|
ce92f4d41714
Add support for displaying hidden files.
edogawaconan <me@myconan.net>
parents:
24
diff
changeset
|
56 Here are some variables which changes how it behaves: |
|
ce92f4d41714
Add support for displaying hidden files.
edogawaconan <me@myconan.net>
parents:
24
diff
changeset
|
57 |
|
ce92f4d41714
Add support for displaying hidden files.
edogawaconan <me@myconan.net>
parents:
24
diff
changeset
|
58 - `DL_DIR`: sets directory to be listed. |
|
ce92f4d41714
Add support for displaying hidden files.
edogawaconan <me@myconan.net>
parents:
24
diff
changeset
|
59 - `DL_SHOWALL`: show or hide files which name start with `.`. Set to `1` to show. |
|
ce92f4d41714
Add support for displaying hidden files.
edogawaconan <me@myconan.net>
parents:
24
diff
changeset
|
60 |
|
23
949398173ecb
Much simpler setup with $request_filename.
edogawaconan <me@myconan.net>
parents:
13
diff
changeset
|
61 Upgrading |
|
949398173ecb
Much simpler setup with $request_filename.
edogawaconan <me@myconan.net>
parents:
13
diff
changeset
|
62 --------- |
|
949398173ecb
Much simpler setup with $request_filename.
edogawaconan <me@myconan.net>
parents:
13
diff
changeset
|
63 |
|
949398173ecb
Much simpler setup with $request_filename.
edogawaconan <me@myconan.net>
parents:
13
diff
changeset
|
64 When upgrading from 1.0.0, update nginx config accordingly. |
| 12 | 65 |
| 31 | 66 Bugs |
| 67 ---- | |
| 68 | |
| 69 Windows edition of PHP can't handle unicode filename and thus doesn't really work in Windows if you have non-ASCII files. | |
| 70 | |
| 12 | 71 License |
| 72 ------- | |
| 73 | |
| 74 Copyright 2014 edogawaconan <me@myconan.net> | |
| 75 | |
| 76 Permission to use, copy, modify, and/or distribute this software for any | |
| 77 purpose with or without fee is hereby granted, provided that the above | |
| 78 copyright notice and this permission notice appear in all copies. | |
| 79 | |
| 80 THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES | |
| 81 WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF | |
| 82 MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR | |
| 83 ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES | |
| 84 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN | |
| 85 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF | |
| 86 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |