Drift/Web: Difference between revisions
Add note about apache conf |
temmie town |
||
| Line 3: | Line 3: | ||
Denne siden inneholder diverse informasjon om webserveren for PVVs brukere. | Denne siden inneholder diverse informasjon om webserveren for PVVs brukere. | ||
Brukernettsidene hostes for tiden på [[Maskiner/ | Brukernettsidene hostes for tiden på [[Maskiner/temmie]]. | ||
= Apache-konfigurasjon = | = Apache-konfigurasjon = | ||
Relevant apache-konfigurasjon finner du i <code>/ | Relevant apache-konfigurasjon finner du i [https://git.pvv.ntnu.no/Drift/pvv-nixos-config pvv-nixos-config] under <code>hosts/temmie/services/userweb/httpd.nix</code>. Det finnes ingen editerbar <code>/etc/apache2</code>-katalog lenger, endringer gjøres i git-repoet og rulles ut med NixOS. | ||
userdir-oppsettet ligger i samme fil, og serverer filer fra <code>/home/pvv/<bokstav>/<bruker>/web-docs</code>. | |||
= PHP-konfigurasjon = | = PHP-konfigurasjon = | ||
== | == Visning av feilmeldinger == | ||
I utgangspunktet er ikke php-feilmeldinger vist. For at feilmeldinger skal vises, lag filen .htaccess med følgende innhold: | |||
<pre><nowiki> | |||
php_flag display_errors on | |||
php_value error_reporting E_ALL | |||
</nowiki></pre> | |||
Filen lages i katalogen til scriptet som skal kjøres. | |||
* [[http://php.net/error_reporting|Liste over hva slags verdier error_reporting kan ha]] | |||
</ | |||
== Opplastingsgrense == | |||
Maks størrelse på filopplasting i PHP er satt til 40 MB (<code>post_max_size</code> og <code>upload_max_filesize</code>). | |||
= Tilgjengelig programvare = | |||
CGI- og PHP-script kjører i et sandboksmiljø med et fast sett med programmer og biblioteker. Den fullstendige definisjonen finner du i <code>hosts/temmie/services/userweb/packages.nix</code> i [https://git.pvv.ntnu.no/Drift/pvv-nixos-config pvv-nixos-config]; savner du noe kan du be drift om å legge det til der. | |||
== Programmeringsspråk == | |||
* PHP (både som mod_php og <code>php</code> på kommandolinjen) | |||
* Perl | |||
* Python 3 | |||
* Ruby | |||
* Common Lisp (SBCL) | |||
* Bash | |||
== PHP-utvidelser == | |||
bz2, curl, decimal, gd, imagick, mysqli, mysqlnd, pgsql, posix, protobuf, sqlite3, pdo (pdo_mysql, pdo_pgsql, pdo_sqlite), uuid, xml, xsl, zlib og zstd | |||
== Perl-moduler == | |||
CGI, DBI med DBD::mysql, DBD::Pg og DBD::SQLite, Git, ImageMagick, JSON, Template Toolkit, samt perl-bindingene til ikiwiki, ExifTool, irssi og Nix | |||
== Python-moduler == | |||
cgi, matplotlib, requests | |||
== Verktøy for hjemmesider == | |||
* ikiwiki | |||
* ImageMagick (bl.a. <code>convert</code> og <code>identify</code>) | |||
* ExifTool og jhead (EXIF-data fra bilder) | |||
* gnuplot | |||
* source-highlight (utheving av kildekode) | |||
== Versjonskontroll == | |||
git, cvs, rcs | |||
== Nettverk og filoverføring == | |||
curl, wget, xdg-utils | |||
== E-post == | |||
sendmail (for script som skal sende e-post) | |||
= | == Kryptografi == | ||
GnuPG | |||
= | == Komprimering og arkiv == | ||
tar, gzip, bzip2, xz, zstd, lz4, zip, unzip | |||
== Andre verktøy == | |||
coreutils, findutils, grep, gawk, sed, diffutils, make, file, less, vim, man, util-linux, which, getfacl/setfacl (acl) | |||
Om du trenger noe custom pakker kan sikkert nix benyttes til å lage custom environments gjennom flake.nix filer. | |||
=== Sikkerhet og versjoner === | |||
* Plasser gjerne custom seperate pakker utenfor <code>web-docs</code>. Skal de ligge under web-docs, bør katalogen hete <code>.venv</code> eller lignende — kataloger med navnene <code>.venv</code> og <code>__pycache__</code> er allerede blokkert fra nedlasting i apache-oppsettet, men et venv som bare heter <code>venv</code> er ikke det. | |||
* Python-versjonen på temmie følger nixpkgs og kan endre seg ved oppgraderinger. Du kan sjekke den med et minimalt CGI-script som skriver ut <code>sys.version</code>. | |||
* Sørg for å holde cgi scripts og dependencies oppdatert. | |||
= Maintenance/Web = | |||
This page contains various information about the web-server for PVVs users. | |||
The user web pages are currently hosted on [[Maskiner/temmie]]. | |||
= Apache-configuration = | |||
The relevant apache configuration can be found in [https://git.pvv.ntnu.no/Drift/pvv-nixos-config pvv-nixos-config] under <code>hosts/temmie/services/userweb/httpd.nix</code>. There is no longer an editable <code>/etc/apache2</code> directory, changes are made in the git repository and rolled out with NixOS. | |||
The userdir setup lives in the same file, and serves files from <code>/home/pvv/<letter>/<user>/web-docs</code>. | |||
= PHP-configuration = | |||
== Displaying of error messages == | == Displaying of error messages == | ||
| Line 125: | Line 118: | ||
</nowiki></pre> | </nowiki></pre> | ||
The file must be made in the | The file must be made in the directory of the script that is to be run. | ||
* [[http://php.net/error_reporting|List of what kind of values error_reporting can have]] | |||
== Upload limit == | |||
The maximum size for PHP file uploads is 40 MB (<code>post_max_size</code> and <code>upload_max_filesize</code>). | |||
= Available software = | |||
CGI and PHP scripts run in a sandbox with a fixed set of programs and libraries. The full definition can be found in <code>hosts/temmie/services/userweb/packages.nix</code> in [https://git.pvv.ntnu.no/Drift/pvv-nixos-config pvv-nixos-config]; if you miss something, ask drift to add it there. | |||
== Programming languages == | |||
* PHP (both as mod_php and <code>php</code> on the command line) | |||
* Perl | |||
* Python 3 | |||
* Ruby | |||
* Common Lisp (SBCL) | |||
* Bash | |||
== PHP extensions == | |||
bz2, curl, decimal, gd, imagick, mysqli, mysqlnd, pgsql, posix, protobuf, sqlite3, pdo (pdo_mysql, pdo_pgsql, pdo_sqlite), uuid, xml, xsl, zlib and zstd | |||
== Perl modules == | |||
CGI, DBI with DBD::mysql, DBD::Pg and DBD::SQLite, Git, ImageMagick, JSON, Template Toolkit, as well as the perl bindings for ikiwiki, ExifTool, irssi and Nix | |||
== Python modules == | |||
cgi, matplotlib, requests | |||
== Homepage tools == | |||
* ikiwiki | |||
* ImageMagick (e.g. <code>convert</code> and <code>identify</code>) | |||
* ExifTool and jhead (EXIF data from images) | |||
* gnuplot | |||
* source-highlight (source code highlighting) | |||
== Version control == | |||
git, cvs, rcs | |||
== Networking and file transfer == | |||
curl, wget, xdg-utils | |||
== E-mail == | |||
sendmail (for scripts that send e-mail) | |||
== Cryptography == | |||
GnuPG | |||
== Compression and archives == | |||
tar, gzip, bzip2, xz, zstd, lz4, zip, unzip | |||
== Other tools == | |||
coreutils, findutils, grep, gawk, sed, diffutils, make, file, less, vim, man, util-linux, which, getfacl/setfacl (acl) | |||
If you need anything custom, you migth use nix flakes to create a custom environment a cgi script can utilise. | |||
=== Security and versions === | |||
* | * Preferably place the packages outside <code>web-docs</code>. If they must live under web-docs, name the directory <code>.venv</code> or similar — directories named <code>.venv</code> and <code>__pycache__</code> are already blocked from download in the apache setup, but a venv named just <code>venv</code> is not. | ||
* The Python version on temmie follows nixpkgs and may change on upgrades. You can check it with a minimal CGI script printing <code>sys.version</code>. | |||
* Make sure to keep software uppdated. | |||
__NOTOC__ | __NOTOC__ | ||
Latest revision as of 01:06, 15 November 2026
Denne siden inneholder diverse informasjon om webserveren for PVVs brukere.
Brukernettsidene hostes for tiden på Maskiner/temmie.
Apache-konfigurasjon
Relevant apache-konfigurasjon finner du i pvv-nixos-config under hosts/temmie/services/userweb/httpd.nix. Det finnes ingen editerbar /etc/apache2-katalog lenger, endringer gjøres i git-repoet og rulles ut med NixOS.
userdir-oppsettet ligger i samme fil, og serverer filer fra /home/pvv/<bokstav>/<bruker>/web-docs.
PHP-konfigurasjon
Visning av feilmeldinger
I utgangspunktet er ikke php-feilmeldinger vist. For at feilmeldinger skal vises, lag filen .htaccess med følgende innhold:
php_flag display_errors on php_value error_reporting E_ALL
Filen lages i katalogen til scriptet som skal kjøres.
Opplastingsgrense
Maks størrelse på filopplasting i PHP er satt til 40 MB (post_max_size og upload_max_filesize).
Tilgjengelig programvare
CGI- og PHP-script kjører i et sandboksmiljø med et fast sett med programmer og biblioteker. Den fullstendige definisjonen finner du i hosts/temmie/services/userweb/packages.nix i pvv-nixos-config; savner du noe kan du be drift om å legge det til der.
Programmeringsspråk
- PHP (både som mod_php og
phppå kommandolinjen) - Perl
- Python 3
- Ruby
- Common Lisp (SBCL)
- Bash
PHP-utvidelser
bz2, curl, decimal, gd, imagick, mysqli, mysqlnd, pgsql, posix, protobuf, sqlite3, pdo (pdo_mysql, pdo_pgsql, pdo_sqlite), uuid, xml, xsl, zlib og zstd
Perl-moduler
CGI, DBI med DBD::mysql, DBD::Pg og DBD::SQLite, Git, ImageMagick, JSON, Template Toolkit, samt perl-bindingene til ikiwiki, ExifTool, irssi og Nix
Python-moduler
cgi, matplotlib, requests
Verktøy for hjemmesider
- ikiwiki
- ImageMagick (bl.a.
convertogidentify) - ExifTool og jhead (EXIF-data fra bilder)
- gnuplot
- source-highlight (utheving av kildekode)
Versjonskontroll
git, cvs, rcs
Nettverk og filoverføring
curl, wget, xdg-utils
E-post
sendmail (for script som skal sende e-post)
Kryptografi
GnuPG
Komprimering og arkiv
tar, gzip, bzip2, xz, zstd, lz4, zip, unzip
Andre verktøy
coreutils, findutils, grep, gawk, sed, diffutils, make, file, less, vim, man, util-linux, which, getfacl/setfacl (acl)
Om du trenger noe custom pakker kan sikkert nix benyttes til å lage custom environments gjennom flake.nix filer.
Sikkerhet og versjoner
- Plasser gjerne custom seperate pakker utenfor
web-docs. Skal de ligge under web-docs, bør katalogen hete.venveller lignende — kataloger med navnene.venvog__pycache__er allerede blokkert fra nedlasting i apache-oppsettet, men et venv som bare hetervenver ikke det. - Python-versjonen på temmie følger nixpkgs og kan endre seg ved oppgraderinger. Du kan sjekke den med et minimalt CGI-script som skriver ut
sys.version. - Sørg for å holde cgi scripts og dependencies oppdatert.
Maintenance/Web
This page contains various information about the web-server for PVVs users.
The user web pages are currently hosted on Maskiner/temmie.
Apache-configuration
The relevant apache configuration can be found in pvv-nixos-config under hosts/temmie/services/userweb/httpd.nix. There is no longer an editable /etc/apache2 directory, changes are made in the git repository and rolled out with NixOS.
The userdir setup lives in the same file, and serves files from /home/pvv/<letter>/<user>/web-docs.
PHP-configuration
Displaying of error messages
By default php error messages are not shown. For error messages to be shown, make the file .htaccess with the following content:
php_flag display_errors on php_value error_reporting E_ALL
The file must be made in the directory of the script that is to be run.
Upload limit
The maximum size for PHP file uploads is 40 MB (post_max_size and upload_max_filesize).
Available software
CGI and PHP scripts run in a sandbox with a fixed set of programs and libraries. The full definition can be found in hosts/temmie/services/userweb/packages.nix in pvv-nixos-config; if you miss something, ask drift to add it there.
Programming languages
- PHP (both as mod_php and
phpon the command line) - Perl
- Python 3
- Ruby
- Common Lisp (SBCL)
- Bash
PHP extensions
bz2, curl, decimal, gd, imagick, mysqli, mysqlnd, pgsql, posix, protobuf, sqlite3, pdo (pdo_mysql, pdo_pgsql, pdo_sqlite), uuid, xml, xsl, zlib and zstd
Perl modules
CGI, DBI with DBD::mysql, DBD::Pg and DBD::SQLite, Git, ImageMagick, JSON, Template Toolkit, as well as the perl bindings for ikiwiki, ExifTool, irssi and Nix
Python modules
cgi, matplotlib, requests
Homepage tools
- ikiwiki
- ImageMagick (e.g.
convertandidentify) - ExifTool and jhead (EXIF data from images)
- gnuplot
- source-highlight (source code highlighting)
Version control
git, cvs, rcs
Networking and file transfer
curl, wget, xdg-utils
sendmail (for scripts that send e-mail)
Cryptography
GnuPG
Compression and archives
tar, gzip, bzip2, xz, zstd, lz4, zip, unzip
Other tools
coreutils, findutils, grep, gawk, sed, diffutils, make, file, less, vim, man, util-linux, which, getfacl/setfacl (acl)
If you need anything custom, you migth use nix flakes to create a custom environment a cgi script can utilise.
Security and versions
- Preferably place the packages outside
web-docs. If they must live under web-docs, name the directory.venvor similar — directories named.venvand__pycache__are already blocked from download in the apache setup, but a venv named justvenvis not. - The Python version on temmie follows nixpkgs and may change on upgrades. You can check it with a minimal CGI script printing
sys.version. - Make sure to keep software uppdated.