Jump to content

Drift/Web: Difference between revisions

From Programvareverkstedet
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/Tom]]
Brukernettsidene hostes for tiden på [[Maskiner/temmie]].


= Apache-konfigurasjon =
= Apache-konfigurasjon =


Relevant apache-konfigurasjon finner du i <code>/etc/apache2</code>. Legg spesielt merke til <code>/etc/apache2/mods-enabled/userdir.conf</conf>
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/&lt;bokstav&gt;/&lt;bruker&gt;/web-docs</code>.


= PHP-konfigurasjon =
= PHP-konfigurasjon =


== Lasting av URLer med fopen() o.l. ==
== Visning av feilmeldinger ==
 
I utgangspunktet er ikke php-feilmeldinger vist. For at feilmeldinger skal vises, lag filen .htaccess med følgende innhold:


Fordi lasting av filer fra en URL via fopen(), include() og tilsvarende funksjoner i PHP er en stor sikkerhetsrisiko er dette slått av på PVV fra og med 7. april 2006. Det vil si at du ikke lenger kan gjøre fing som <pre><nowiki>
<pre><nowiki>
$fp = fopen("http://www.foo.com/data.txt", "r")
php_flag display_errors on
php_value error_reporting E_ALL
</nowiki></pre>


eller
Filen lages i katalogen til scriptet som skal kjøres.


include("http://www.foo.net/include.html").
* [[http://php.net/error_reporting|Liste over hva slags verdier error_reporting kan ha]]
</nowiki></pre>
 
== 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


Dersom du er avhengig av å laste websider eller filer fra andre webservere må du heretter bruke funksjoner som fsockopen() e.l. for å hente filer fra andre maskiner, f.eks.:
== PHP-utvidelser ==
<pre><nowiki>
<?php


function get_url($host, $path, $port = 80) {
bz2, curl, decimal, gd, imagick, mysqli, mysqlnd, pgsql, posix, protobuf, sqlite3, pdo (pdo_mysql, pdo_pgsql, pdo_sqlite), uuid, xml, xsl, zlib og zstd


  $fp = @fsockopen($host, $port, $errno, $errstr, 5.0);
== Perl-moduler ==
  if (!is_resource($fp)) {
    return $errstr;
  }


  // Send request
CGI, DBI med DBD::mysql, DBD::Pg og DBD::SQLite, Git, ImageMagick, JSON, Template Toolkit, samt perl-bindingene til ikiwiki, ExifTool, irssi og Nix
  fputs($fp, "GET $path HTTP/1.0\nHost: $host:$port\n\n");


  // Skip HTTP-header
== Python-moduler ==
  while (!feof($fp)) {
    $line = fgets($fp, 1024);
    if (trim($line) == '') break;
  }


  // Read body
cgi, matplotlib, requests
  $body = '';
  while (!feof($fp)) { $body .= fgets($fp, 1024); }


  fclose($fp);
== Verktøy for hjemmesider ==


  return $body;
* ikiwiki
}
* ImageMagick (bl.a. <code>convert</code> og <code>identify</code>)
* ExifTool og jhead (EXIF-data fra bilder)
* gnuplot
* source-highlight (utheving av kildekode)


print get_url("www.pvv.ntnu.no", "/");
== Versjonskontroll ==
?>
</nowiki></pre>


== Visning av feilmeldinger ==
git, cvs, rcs


I utgangspunktet er ikke php-feilmeldinger vist. Til at feilmeldinger skal vises, lag filen .htaccess med følgende innhold:
== Nettverk og filoverføring ==


<pre><nowiki>
curl, wget, xdg-utils
php_flag display_errors on
php_value error_reporting E_ALL
</nowiki></pre>


Filen lages i katalogen til scriptet som skal kjøres.
== E-post ==


* [http://php.net/error_reporting Liste over hva slags verdier error_reporting kan ha]
sendmail (for script som skal sende e-post)


= Maintenance/Web =
== Kryptografi ==


This pabe contains various information on the web-server for PVVs users.
GnuPG


= PHP-configuration =
== Komprimering og arkiv ==


== Loading of URLs with fopen() and such ==
tar, gzip, bzip2, xz, zstd, lz4, zip, unzip


Because the loading of files from an URL by fopen(), include(), and similar functions in PHP is a huge security risc it is disabled at PVV from the 7. of April 2006. It means that you no longer can do things such as  <pre><nowiki>
== Andre verktøy ==
$fp = fopen("http://www.foo.com/data.txt", "r")


or
coreutils, findutils, grep, gawk, sed, diffutils, make, file, less, vim, man, util-linux, which, getfacl/setfacl (acl)


include("http://www.foo.net/include.html").
Om du trenger noe custom pakker kan sikkert nix benyttes til å lage custom environments gjennom flake.nix filer.
</nowiki></pre>


If you are dependent on loading webpages or files from other web-servers you hereafter have to use functions such as fsockopen() or similar to fetch files from other machines, to get files from other machines, for an instance:
=== Sikkerhet og versjoner ===
<pre><nowiki>
<?php


function get_url($host, $path, $port = 80) {
* 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.


  $fp = @fsockopen($host, $port, $errno, $errstr, 5.0);
= Maintenance/Web =
  if (!is_resource($fp)) {
    return $errstr;
  }


  // Send request
This page contains various information about the web-server for PVVs users.
  fputs($fp, "GET $path HTTP/1.0\nHost: $host:$port\n\n");


  // Skip HTTP-header
The user web pages are currently hosted on [[Maskiner/temmie]].
  while (!feof($fp)) {
    $line = fgets($fp, 1024);
    if (trim($line) == '') break;
  }


  // Read body
= Apache-configuration =
  $body = '';
  while (!feof($fp)) { $body .= fgets($fp, 1024); }


  fclose($fp);
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.


  return $body;
The userdir setup lives in the same file, and serves files from <code>/home/pvv/&lt;letter&gt;/&lt;user&gt;/web-docs</code>.
}


print get_url("www.pvv.ntnu.no", "/");
= PHP-configuration =
?>
</nowiki></pre>


== Displaying of error messages ==
== Displaying of error messages ==
Line 125: Line 118:
</nowiki></pre>
</nowiki></pre>


The file must be made in the catalog of the script that is to be run.
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 ===


* [http://php.net/error_reporting List of what kind of values error_reporting can have]
* 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

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.