Jump to content

Drift/Web

From Programvareverkstedet
Revision as of 01:06, 15 November 2026 by Adriangl (talk | contribs) (temmie town)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

English

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 php 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. convert og identify)
  • 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 .venv eller lignende — kataloger med navnene .venv og __pycache__ er allerede blokkert fra nedlasting i apache-oppsettet, men et venv som bare heter venv 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 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 php 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. convert and identify)
  • 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 web-docs. If they must live under web-docs, name the directory .venv or similar — directories named .venv and __pycache__ are already blocked from download in the apache setup, but a venv named just venv is 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.