ChristophMorrison am 27. Juli 2018 um 07:40 Uhr

2018-07-27T07:40:27Z

← Nächstältere Version		Version vom 27. Juli 2018, 09:40 Uhr
Zeile 37:		Zeile 37:

	== Links ==		== Links ==

			== Fallstricke ==
			[[HttpUtils]], das für das Handling der HTTP-Requests zuständig ist, liefert nur eine Handvoll Dateitypen zuverlässig mit dem richtigen Content-Type-Header aus. Das sind aktuell folgende:
			{\|
			!Extension
			!MIME-Type
			\|-
			\| bmp \|\| image/bmp
			\|-
			\| css \|\| text/css
			\|-
			\| gif \|\| image/gif
			\|-
			\| html \|\| text/html
			\|-
			\| ico \|\| image/x-icon
			\|-
			\| jpg \|\| image/jpeg
			\|-
			\| js \|\| text/javascript
			\|-
			\| mp4 \|\| video/mp4
			\|-
			\| pdf \|\| application/pdf
			\|-
			\| png \|\| image/png
			\|-
			\| svg \|\| image/svg+xml
			\|-
			\| txt \|\| text/plain
			\|-
			\| mp3 \|\| audio/mpeg
			\|}

			Andere Dateitypen werden mit einem Content-Type-Header ausgeliefert, der sich aus der Dateierweiterung (z.B. <code>.doc</code>) und dem Präfix <code>text/</code> ergibt, hier als <code>text/doc</code>.


	[[Kategorie:NeedsEditing]]		[[Kategorie:NeedsEditing]]

Drhirn: War eine gewünschte Seite. Hab sie angelegt.

2018-06-13T14:04:32Z

War eine gewünschte Seite. Hab sie angelegt.

Neue Seite

{{Infobox Modul
|ModPurpose=Stellt einen minimalen Webserver zur Verfügung
|ModType=d
|ModForumArea=Frontends
|ModTechName=02_HTTPSRV.pm
|ModOwner=[[Benutzer:Neubert|Neubert]] ({{Link2FU|10|Forum}}) }}

[[HTTPSRV]] ist eine Erweiterung von [[FHEMWEB]] und stellt einen minimalen Webserver zur Verfügung, der Dateien aus einem zu definierenden Verzeichnis ausliefern kann. Wahlweise akzeptiert er auch QueryStrings um seine eigenen Readings zu setzen.

== Voraussetzungen ==
Da es sich - wie erwähnt - bei HTTPSRV um eine Erweiterung von FHEMWEB handelt, muss auf jeden Fall vor der Verwendung ein FHEMWEB-Device definiert werden.

== Anwendung ==
=== Define ===
Ein Aufruf in der Kommandozeile von FHEM von
define <name> HTTPSRV <infix> <directory> <friendlyname>
legt ein neues HTTPSRV-Device an. Wobei
*'''''name''''' ein beliebiger Name für das Device ist, wie es später in FHEM angezeigt wird.
*'''''infix''''' eine beliebige Pfad-Erweiterung der FHEMWEB-Basis-URL ist.
*'''''directory''''' der absolute Pfad zu dem auszuliefernden Verzeichnis ist.
*'''''friendlyname''''' der Name, der in der Seitenleiste von FHEM angezeigt wird, ist.

====Beispiele====
define myJSFrontend HTTPSRV jsf /usr/share/jsfrontend My little frontend
Stellt die URL ''<nowiki>http://hostname:8083/fhem/jsf</nowiki>'' zur Verfügung, unter der die Dateien aus dem Verzeichnis ''/usr/share/jsfrontend'' ausgeliefert werden. Der neue Link in der FHEM-Seitenleiste mit dem Titel ''My little frontend'' führt genau zu dieser URL.

define kindleweb HTTPSRV kindle /opt/fhem/kindle Kindle Web
attr kindleweb readings KindleBatt
Erzeugt die URL ''<nowiki>http://hostname:8083/fhem/fhem/kindle</nowiki>'' unter der Dateien aus dem Verzeichnis ''/opt/fhem/kindle'' angezeigt werden. Zusätzlich wird bei diesem HTTPSRV-Device noch erlaubt, mithilfe eines QueryStrings (z.B.: ''?KindleBatt=43'') ein Reading ''KindleBatt'' anzulegen.

=== Attribute ===
*'''directoryindex''': Wird die URL ohne Angabe eines Dateinamen aufgerufen (z.B. ''<nowiki>http://hostname:8083/fhem/jsf</nowiki>''), wird die in diesem Attribut festgelegte Datei geladen. Der Standard-Wert ist ''index.html''.
*'''readings''': Eine Komma-getrennte Liste aus Reading-Namen. Wenn der Aufruf der URL mit einem Querystring endet (z.B.: ''<nowiki>http://hostname:8083/fhem/jsf?KindleBatt=43</nowiki>'') und das Reading (''KindleBatt'') in dieser Liste vorkommt, wird - sofern noch nicht vorhanden - ein neues Device-Reading angelegt und mit dem Wert aus dem Querystring befüllt.

== Anwendungsbeispiele ==

== Links ==

[[Kategorie:NeedsEditing]]

HTTPSRV - Versionsgeschichte

ChristophMorrison am 27. Juli 2018 um 07:40 Uhr

Drhirn: War eine gewünschte Seite. Hab sie angelegt.