Wikizone - Benutzerbeiträge [de]

ProcessWire - Front Page Editing

2021-10-05T08:43:12Z

134.3.85.26: /* Kopierschnipsel */

== Front End Page Editor ==
https://processwire.com/docs/front-end/front-end-editing/

Auch genannt: Frontend-Editing oder Frontpage Edit oder Frontend-Editor

* Mehrere Optionen (im Backend auswählen)
* Option A -> Automatisch
** Kann verwendet werden wenn ein Feld nur einmal auf einer Seite verwendet wird.
* Option B -> API Method Call
** Geeignet für text fields, number fields, dates...
** Nicht geeignet für Files/Images, PageTables, Repeaters or andere Felder über die man iteriert
** Statt get einfach edit nehmen
<?php echo $page->edit('body'); ?>
* Option C -> HTML Edit Tags
** Anhand ''<edit [feldname]>...</edit>'' findet PW die Felder
** Für Repeater geeignet
** Unterstüzt Inline Editor, wenn das Feld es unterstützt

* Option D -> HTML Edit Attributes
** Gleiche Funktionalität wie Tags
** edit Attribut für div, span, ... statt eigenständiges Tag
** always uses the dialog editor and does not use the inline editor.
<div edit="events">...</div>

== Konfiguration ==
* PageFrontEdit Modul installieren (Core)
* Für Option A Checkboxen anhaken
* Für Option B-C Templates berarbeiten.
== Options in Detail ==
=== Option A ===
Einfach im Backend anhaken

=== Option B ===
Statt
$page->get('field_name');
$page->edit('field_name');
Beispiel
<?php echo $page->edit('body'); ?>
=== Option C ===

Beispiel Image Feld 'photo'
<syntaxhighlight lang="php">
<edit photo>
<img src="<?=$page->image->url?>" />
</edit>
</syntaxhighlight>

Beispiel Repeater, PageTable oder Table Field
<syntaxhighlight lang="php">
<edit events>
<?php foreach($page->events as $event): ?>
<div class="event">
<h3><?=$event->title?></h3>
<p class="date"><?=$event->date?></p>
<p><?=$event->summary?></p>
</div>
<?php endforeach; ?>
</edit>
</syntaxhighlight>

Beschreibung von Ryan:

By the way, you can also use some more verbose but alternate syntax for the <edit> tags if you prefer. If your editor does syntax highlighting with your HTML, it may be more consistent (the "quotes" are optional of course):

<edit field="events"> ... </edit>
If your editable region contains multiple fields you want to be edited together, you can specify more than one:

<edit field="intro,image,events"> ... </edit>
If your field happens to be on some other page other than the one being rendered, you can also specify what page you want to be edited:

<edit field="events" page="1001"> ... </edit>
The 1001 can be any page ID or path. The above can also be shortened to this if you prefer:

<edit field="1001.events"> ... </edit>
Or this:

<edit 1001.events> ... </edit>
If you are using <edit> tags with a field that supports inline editing (like a text or CKEditor field), the inline editor will be used. Otherwise it will open a dialog to the editor.

=== Option D ===
<syntaxhighlight lang="html5">
<div edit="events">

</div>
</syntaxhighlight>
Or to specify a field from some other page (1001):

<syntaxhighlight lang="html5">
<div edit="1001.events"> ... </div>
</syntaxhighlight>
Or to specify multiple fields:

<syntaxhighlight lang="html5">
<div edit="intro,image,events"> ... </div>
</syntaxhighlight>
The "edit" attributes are stripped from the markup that gets output, so the only place you will see them is where you place them in your template file(s).

Worth noting about '''option D''' is that it '''always uses the dialog editor''' and does not use the inline editor.

== Probleme lösen ==
=== Front Page Editing in Repeatern ===
Der Editor zeigt keinen Inhalt. Bei Superadmins funktioniert es aber.
https://processwire.com/talk/topic/15357-solved-frontend-edit-on-repeater-fields/
https://github.com/processwire/processwire-issues/issues/183
Lösung: Mit Option C funktioniert es, wenn man noch das page-Attribut mit reinnimmt. Im page Attribut gibt man den Repeater an.
<syntaxhighlight lang="php">
foreach($page->repeater_field as $item) {
echo "<h3><edit field='title' page='$item'>$item->title</edit></h3>";
echo "<edit field='body' page='$item'>$item->body</edit>";
}
</syntaxhighlight>

Manchmal auch praktisch wenn man mit fields arbeitet:
<syntaxhighlight lang="php">
// Body
if($page->body){
$bodyMarkup = "<edit field=\"body\" page=\"$page\">$page->body</edit>";
}
</syntaxhighlight>
=== Editor funktioniert nicht immer===
Die Edit Tags werden aus dem Code entfernt aber man kann nicht doppelklicken.

Prüfen ob du mit einer anderen Domain (z.B. ohne www.) angelmeldet bist. Der Editor funktioniert bei mir nur wenn man in der exakt selben Domain ist.

== Kopierschnipsel ==
<edit field="body">'.$page->body.'</edit>
<edit field="body" page="'.$page.'">'.$page->body.'</edit>

ProcessWire - Front Page Editing

2021-10-05T08:09:16Z

134.3.85.26: /* Editor funktioniert nicht (delayed content) */

== Front End Page Editor ==
https://processwire.com/docs/front-end/front-end-editing/

Auch genannt: Frontend-Editing oder Frontpage Edit oder Frontend-Editor

* Mehrere Optionen (im Backend auswählen)
* Option A -> Automatisch
** Kann verwendet werden wenn ein Feld nur einmal auf einer Seite verwendet wird.
* Option B -> API Method Call
** Geeignet für text fields, number fields, dates...
** Nicht geeignet für Files/Images, PageTables, Repeaters or andere Felder über die man iteriert
** Statt get einfach edit nehmen
<?php echo $page->edit('body'); ?>
* Option C -> HTML Edit Tags
** Anhand ''<edit [feldname]>...</edit>'' findet PW die Felder
** Für Repeater geeignet
** Unterstüzt Inline Editor, wenn das Feld es unterstützt

* Option D -> HTML Edit Attributes
** Gleiche Funktionalität wie Tags
** edit Attribut für div, span, ... statt eigenständiges Tag
** always uses the dialog editor and does not use the inline editor.
<div edit="events">...</div>

== Konfiguration ==
* PageFrontEdit Modul installieren (Core)
* Für Option A Checkboxen anhaken
* Für Option B-C Templates berarbeiten.
== Options in Detail ==
=== Option A ===
Einfach im Backend anhaken

=== Option B ===
Statt
$page->get('field_name');
$page->edit('field_name');
Beispiel
<?php echo $page->edit('body'); ?>
=== Option C ===

Beispiel Image Feld 'photo'
<syntaxhighlight lang="php">
<edit photo>
<img src="<?=$page->image->url?>" />
</edit>
</syntaxhighlight>

Beispiel Repeater, PageTable oder Table Field
<syntaxhighlight lang="php">
<edit events>
<?php foreach($page->events as $event): ?>
<div class="event">
<h3><?=$event->title?></h3>
<p class="date"><?=$event->date?></p>
<p><?=$event->summary?></p>
</div>
<?php endforeach; ?>
</edit>
</syntaxhighlight>

Beschreibung von Ryan:

By the way, you can also use some more verbose but alternate syntax for the <edit> tags if you prefer. If your editor does syntax highlighting with your HTML, it may be more consistent (the "quotes" are optional of course):

<edit field="events"> ... </edit>
If your editable region contains multiple fields you want to be edited together, you can specify more than one:

<edit field="intro,image,events"> ... </edit>
If your field happens to be on some other page other than the one being rendered, you can also specify what page you want to be edited:

<edit field="events" page="1001"> ... </edit>
The 1001 can be any page ID or path. The above can also be shortened to this if you prefer:

<edit field="1001.events"> ... </edit>
Or this:

<edit 1001.events> ... </edit>
If you are using <edit> tags with a field that supports inline editing (like a text or CKEditor field), the inline editor will be used. Otherwise it will open a dialog to the editor.

=== Option D ===
<syntaxhighlight lang="html5">
<div edit="events">

</div>
</syntaxhighlight>
Or to specify a field from some other page (1001):

<syntaxhighlight lang="html5">
<div edit="1001.events"> ... </div>
</syntaxhighlight>
Or to specify multiple fields:

<syntaxhighlight lang="html5">
<div edit="intro,image,events"> ... </div>
</syntaxhighlight>
The "edit" attributes are stripped from the markup that gets output, so the only place you will see them is where you place them in your template file(s).

Worth noting about '''option D''' is that it '''always uses the dialog editor''' and does not use the inline editor.

== Probleme lösen ==
=== Front Page Editing in Repeatern ===
Der Editor zeigt keinen Inhalt. Bei Superadmins funktioniert es aber.
https://processwire.com/talk/topic/15357-solved-frontend-edit-on-repeater-fields/
https://github.com/processwire/processwire-issues/issues/183
Lösung: Mit Option C funktioniert es, wenn man noch das page-Attribut mit reinnimmt. Im page Attribut gibt man den Repeater an.
<syntaxhighlight lang="php">
foreach($page->repeater_field as $item) {
echo "<h3><edit field='title' page='$item'>$item->title</edit></h3>";
echo "<edit field='body' page='$item'>$item->body</edit>";
}
</syntaxhighlight>

Manchmal auch praktisch wenn man mit fields arbeitet:
<syntaxhighlight lang="php">
// Body
if($page->body){
$bodyMarkup = "<edit field=\"body\" page=\"$page\">$page->body</edit>";
}
</syntaxhighlight>
=== Editor funktioniert nicht immer===
Die Edit Tags werden aus dem Code entfernt aber man kann nicht doppelklicken.

Prüfen ob du mit einer anderen Domain (z.B. ohne www.) angelmeldet bist. Der Editor funktioniert bei mir nur wenn man in der exakt selben Domain ist.

== Kopierschnipsel ==
<edit field="body" page="'.$page.'">'.$page->body.'</edit>
<edit field="body" page="'.$page.'">'.$page->body.'</edit>

ProcessWire - Front Page Editing

2021-10-05T07:53:18Z

134.3.85.26: /* Editor funktioniert nicht */

== Front End Page Editor ==
https://processwire.com/docs/front-end/front-end-editing/

Auch genannt: Frontend-Editing oder Frontpage Edit oder Frontend-Editor

* Mehrere Optionen (im Backend auswählen)
* Option A -> Automatisch
** Kann verwendet werden wenn ein Feld nur einmal auf einer Seite verwendet wird.
* Option B -> API Method Call
** Geeignet für text fields, number fields, dates...
** Nicht geeignet für Files/Images, PageTables, Repeaters or andere Felder über die man iteriert
** Statt get einfach edit nehmen
<?php echo $page->edit('body'); ?>
* Option C -> HTML Edit Tags
** Anhand ''<edit [feldname]>...</edit>'' findet PW die Felder
** Für Repeater geeignet
** Unterstüzt Inline Editor, wenn das Feld es unterstützt

* Option D -> HTML Edit Attributes
** Gleiche Funktionalität wie Tags
** edit Attribut für div, span, ... statt eigenständiges Tag
** always uses the dialog editor and does not use the inline editor.
<div edit="events">...</div>

== Konfiguration ==
* PageFrontEdit Modul installieren (Core)
* Für Option A Checkboxen anhaken
* Für Option B-C Templates berarbeiten.
== Options in Detail ==
=== Option A ===
Einfach im Backend anhaken

=== Option B ===
Statt
$page->get('field_name');
$page->edit('field_name');
Beispiel
<?php echo $page->edit('body'); ?>
=== Option C ===

Beispiel Image Feld 'photo'
<syntaxhighlight lang="php">
<edit photo>
<img src="<?=$page->image->url?>" />
</edit>
</syntaxhighlight>

Beispiel Repeater, PageTable oder Table Field
<syntaxhighlight lang="php">
<edit events>
<?php foreach($page->events as $event): ?>
<div class="event">
<h3><?=$event->title?></h3>
<p class="date"><?=$event->date?></p>
<p><?=$event->summary?></p>
</div>
<?php endforeach; ?>
</edit>
</syntaxhighlight>

Beschreibung von Ryan:

By the way, you can also use some more verbose but alternate syntax for the <edit> tags if you prefer. If your editor does syntax highlighting with your HTML, it may be more consistent (the "quotes" are optional of course):

<edit field="events"> ... </edit>
If your editable region contains multiple fields you want to be edited together, you can specify more than one:

<edit field="intro,image,events"> ... </edit>
If your field happens to be on some other page other than the one being rendered, you can also specify what page you want to be edited:

<edit field="events" page="1001"> ... </edit>
The 1001 can be any page ID or path. The above can also be shortened to this if you prefer:

<edit field="1001.events"> ... </edit>
Or this:

<edit 1001.events> ... </edit>
If you are using <edit> tags with a field that supports inline editing (like a text or CKEditor field), the inline editor will be used. Otherwise it will open a dialog to the editor.

=== Option D ===
<syntaxhighlight lang="html5">
<div edit="events">

</div>
</syntaxhighlight>
Or to specify a field from some other page (1001):

<syntaxhighlight lang="html5">
<div edit="1001.events"> ... </div>
</syntaxhighlight>
Or to specify multiple fields:

<syntaxhighlight lang="html5">
<div edit="intro,image,events"> ... </div>
</syntaxhighlight>
The "edit" attributes are stripped from the markup that gets output, so the only place you will see them is where you place them in your template file(s).

Worth noting about '''option D''' is that it '''always uses the dialog editor''' and does not use the inline editor.

== Probleme lösen ==
=== Front Page Editing in Repeatern ===
Der Editor zeigt keinen Inhalt. Bei Superadmins funktioniert es aber.
https://processwire.com/talk/topic/15357-solved-frontend-edit-on-repeater-fields/
https://github.com/processwire/processwire-issues/issues/183
Lösung: Mit Option C funktioniert es, wenn man noch das page-Attribut mit reinnimmt. Im page Attribut gibt man den Repeater an.
<syntaxhighlight lang="php">
foreach($page->repeater_field as $item) {
echo "<h3><edit field='title' page='$item'>$item->title</edit></h3>";
echo "<edit field='body' page='$item'>$item->body</edit>";
}
</syntaxhighlight>

Manchmal auch praktisch wenn man mit fields arbeitet:
<syntaxhighlight lang="php">
// Body
if($page->body){
$bodyMarkup = "<edit field=\"body\" page=\"$page\">$page->body</edit>";
}
</syntaxhighlight>
=== Editor funktioniert nicht (delayed content)===
Die Edit Tags werden aus dem Code entfernt aber man kann nicht doppelklicken.

Ich hatte Probleme sobald der Inhalt über
ob_start()
gepuffert und danach der Puffer in $content geschrieben wurde.
Wenn man den Inhalt direkt in $content schreibt funktioniert es.

== Kopierschnipsel ==
<edit field="body" page="'.$page.'">'.$page->body.'</edit>
<edit field="body" page="'.$page.'">'.$page->body.'</edit>

ProcessWire - Front Page Editing

2021-10-05T07:18:21Z

134.3.85.26: /* Probleme lösen */

== Front End Page Editor ==
https://processwire.com/docs/front-end/front-end-editing/

Auch genannt: Frontend-Editing oder Frontpage Edit oder Frontend-Editor

* Mehrere Optionen (im Backend auswählen)
* Option A -> Automatisch
** Kann verwendet werden wenn ein Feld nur einmal auf einer Seite verwendet wird.
* Option B -> API Method Call
** Geeignet für text fields, number fields, dates...
** Nicht geeignet für Files/Images, PageTables, Repeaters or andere Felder über die man iteriert
** Statt get einfach edit nehmen
<?php echo $page->edit('body'); ?>
* Option C -> HTML Edit Tags
** Anhand ''<edit [feldname]>...</edit>'' findet PW die Felder
** Für Repeater geeignet
** Unterstüzt Inline Editor, wenn das Feld es unterstützt

* Option D -> HTML Edit Attributes
** Gleiche Funktionalität wie Tags
** edit Attribut für div, span, ... statt eigenständiges Tag
** always uses the dialog editor and does not use the inline editor.
<div edit="events">...</div>

== Konfiguration ==
* PageFrontEdit Modul installieren (Core)
* Für Option A Checkboxen anhaken
* Für Option B-C Templates berarbeiten.
== Options in Detail ==
=== Option A ===
Einfach im Backend anhaken

=== Option B ===
Statt
$page->get('field_name');
$page->edit('field_name');
Beispiel
<?php echo $page->edit('body'); ?>
=== Option C ===

Beispiel Image Feld 'photo'
<syntaxhighlight lang="php">
<edit photo>
<img src="<?=$page->image->url?>" />
</edit>
</syntaxhighlight>

Beispiel Repeater, PageTable oder Table Field
<syntaxhighlight lang="php">
<edit events>
<?php foreach($page->events as $event): ?>
<div class="event">
<h3><?=$event->title?></h3>
<p class="date"><?=$event->date?></p>
<p><?=$event->summary?></p>
</div>
<?php endforeach; ?>
</edit>
</syntaxhighlight>

Beschreibung von Ryan:

By the way, you can also use some more verbose but alternate syntax for the <edit> tags if you prefer. If your editor does syntax highlighting with your HTML, it may be more consistent (the "quotes" are optional of course):

<edit field="events"> ... </edit>
If your editable region contains multiple fields you want to be edited together, you can specify more than one:

<edit field="intro,image,events"> ... </edit>
If your field happens to be on some other page other than the one being rendered, you can also specify what page you want to be edited:

<edit field="events" page="1001"> ... </edit>
The 1001 can be any page ID or path. The above can also be shortened to this if you prefer:

<edit field="1001.events"> ... </edit>
Or this:

<edit 1001.events> ... </edit>
If you are using <edit> tags with a field that supports inline editing (like a text or CKEditor field), the inline editor will be used. Otherwise it will open a dialog to the editor.

=== Option D ===
<syntaxhighlight lang="html5">
<div edit="events">

</div>
</syntaxhighlight>
Or to specify a field from some other page (1001):

<syntaxhighlight lang="html5">
<div edit="1001.events"> ... </div>
</syntaxhighlight>
Or to specify multiple fields:

<syntaxhighlight lang="html5">
<div edit="intro,image,events"> ... </div>
</syntaxhighlight>
The "edit" attributes are stripped from the markup that gets output, so the only place you will see them is where you place them in your template file(s).

Worth noting about '''option D''' is that it '''always uses the dialog editor''' and does not use the inline editor.

== Probleme lösen ==
=== Front Page Editing in Repeatern ===
Der Editor zeigt keinen Inhalt. Bei Superadmins funktioniert es aber.
https://processwire.com/talk/topic/15357-solved-frontend-edit-on-repeater-fields/
https://github.com/processwire/processwire-issues/issues/183
Lösung: Mit Option C funktioniert es, wenn man noch das page-Attribut mit reinnimmt. Im page Attribut gibt man den Repeater an.
<syntaxhighlight lang="php">
foreach($page->repeater_field as $item) {
echo "<h3><edit field='title' page='$item'>$item->title</edit></h3>";
echo "<edit field='body' page='$item'>$item->body</edit>";
}
</syntaxhighlight>

Manchmal auch praktisch wenn man mit fields arbeitet:
<syntaxhighlight lang="php">
// Body
if($page->body){
$bodyMarkup = "<edit field=\"body\" page=\"$page\">$page->body</edit>";
}
</syntaxhighlight>
=== Editor funktioniert nicht ===
== Kopierschnipsel ==
<edit field="body" page="'.$page.'">'.$page->body.'</edit>
<edit field="body" page="'.$page.'">'.$page->body.'</edit>

ProcessWire - Front Page Editing

2021-10-05T07:17:13Z

134.3.85.26: /* Front Page Editing in Repeatern */

== Front End Page Editor ==
https://processwire.com/docs/front-end/front-end-editing/

Auch genannt: Frontend-Editing oder Frontpage Edit oder Frontend-Editor

* Mehrere Optionen (im Backend auswählen)
* Option A -> Automatisch
** Kann verwendet werden wenn ein Feld nur einmal auf einer Seite verwendet wird.
* Option B -> API Method Call
** Geeignet für text fields, number fields, dates...
** Nicht geeignet für Files/Images, PageTables, Repeaters or andere Felder über die man iteriert
** Statt get einfach edit nehmen
<?php echo $page->edit('body'); ?>
* Option C -> HTML Edit Tags
** Anhand ''<edit [feldname]>...</edit>'' findet PW die Felder
** Für Repeater geeignet
** Unterstüzt Inline Editor, wenn das Feld es unterstützt

* Option D -> HTML Edit Attributes
** Gleiche Funktionalität wie Tags
** edit Attribut für div, span, ... statt eigenständiges Tag
** always uses the dialog editor and does not use the inline editor.
<div edit="events">...</div>

== Konfiguration ==
* PageFrontEdit Modul installieren (Core)
* Für Option A Checkboxen anhaken
* Für Option B-C Templates berarbeiten.
== Options in Detail ==
=== Option A ===
Einfach im Backend anhaken

=== Option B ===
Statt
$page->get('field_name');
$page->edit('field_name');
Beispiel
<?php echo $page->edit('body'); ?>
=== Option C ===

Beispiel Image Feld 'photo'
<syntaxhighlight lang="php">
<edit photo>
<img src="<?=$page->image->url?>" />
</edit>
</syntaxhighlight>

Beispiel Repeater, PageTable oder Table Field
<syntaxhighlight lang="php">
<edit events>
<?php foreach($page->events as $event): ?>
<div class="event">
<h3><?=$event->title?></h3>
<p class="date"><?=$event->date?></p>
<p><?=$event->summary?></p>
</div>
<?php endforeach; ?>
</edit>
</syntaxhighlight>

Beschreibung von Ryan:

By the way, you can also use some more verbose but alternate syntax for the <edit> tags if you prefer. If your editor does syntax highlighting with your HTML, it may be more consistent (the "quotes" are optional of course):

<edit field="events"> ... </edit>
If your editable region contains multiple fields you want to be edited together, you can specify more than one:

<edit field="intro,image,events"> ... </edit>
If your field happens to be on some other page other than the one being rendered, you can also specify what page you want to be edited:

<edit field="events" page="1001"> ... </edit>
The 1001 can be any page ID or path. The above can also be shortened to this if you prefer:

<edit field="1001.events"> ... </edit>
Or this:

<edit 1001.events> ... </edit>
If you are using <edit> tags with a field that supports inline editing (like a text or CKEditor field), the inline editor will be used. Otherwise it will open a dialog to the editor.

=== Option D ===
<syntaxhighlight lang="html5">
<div edit="events">

</div>
</syntaxhighlight>
Or to specify a field from some other page (1001):

<syntaxhighlight lang="html5">
<div edit="1001.events"> ... </div>
</syntaxhighlight>
Or to specify multiple fields:

<syntaxhighlight lang="html5">
<div edit="intro,image,events"> ... </div>
</syntaxhighlight>
The "edit" attributes are stripped from the markup that gets output, so the only place you will see them is where you place them in your template file(s).

Worth noting about '''option D''' is that it '''always uses the dialog editor''' and does not use the inline editor.

== Probleme lösen ==
=== Front Page Editing in Repeatern ===
Der Editor zeigt keinen Inhalt. Bei Superadmins funktioniert es aber.
https://processwire.com/talk/topic/15357-solved-frontend-edit-on-repeater-fields/
https://github.com/processwire/processwire-issues/issues/183
Lösung: Mit Option C funktioniert es, wenn man noch das page-Attribut mit reinnimmt. Im page Attribut gibt man den Repeater an.
<syntaxhighlight lang="php">
foreach($page->repeater_field as $item) {
echo "<h3><edit field='title' page='$item'>$item->title</edit></h3>";
echo "<edit field='body' page='$item'>$item->body</edit>";
}
</syntaxhighlight>

Manchmal auch praktisch wenn man mit fields arbeitet:
<syntaxhighlight lang="php">
// Body
if($page->body){
$bodyMarkup = "<edit field=\"body\" page=\"$page\">$page->body</edit>";
}
</syntaxhighlight>

== Kopierschnipsel
<edit field="body" page="'.$page.'">'.$page->body.'</edit>
<edit field="body" page="'.$page.'">'.$page->body.'</edit>

ProcessWire - Module schreiben

2021-09-22T16:44:18Z

134.3.85.26: /* Links */

== Links ==
'''Wichtigste Resourcen'''
https://processwire.com/docs/modules/development/ - Guter Ausgangspunkt
https://processwire.com/api/ref/module/ - Module API
https://processwire.com/docs/modules/types/ - Welche Modultypen gibt es ?
https://processwire.com/talk/topic/778-module-dependencies/ - Module die andere Module benötigen
https://processwire.com/talk/forum/19-moduleplugin-development/ - Forum zum Thema Module entwickeln
http://somatonic.github.io/Captain-Hook/ - Hook Cheatsheet
https://processwire.com/blog/posts/new-module-configuration-options/ - Neuere Konfigurationsmöglichkeiten
https://processwire.com/docs/start/api-access/ Zugriff auf ProcessWire API Variablen (wire Objekt)

''' Tutorials und Beispiele zum Einstieg '''
https://processwire.com/docs/modules/ - Introduction, Development, Hooks, Types, Pro Modules, Third Party
https://github.com/ryancramerdesign/ProcessHello - Modul Skelett Beispiel für eigene Backend (Process) Module
https://github.com/ryancramerdesign/FieldtypeMapMarker - Beispiel für ein Fieldtype und Inputfield Modul
https://processwire.com/blog/posts/building-custom-admin-pages-with-process-modules/ - super Tutorial zu Admin Modulen
https://webdesign.tutsplus.com/tutorials/a-beginners-introduction-to-writing-modules-in-processwire--cms-26862

'''Wikiseiten'''
[[ProcessWire - Module Snippets]]
[[ProcessWire - Fieldtype erstellen (Module)]]
[[Process Module (ProcessWire)]]

'''Weitere Links'''
http://modules.pw/ (Module Creator)

== Wo - Was ? ==
=== Welche Typen von Modulen gibt es ? ===
https://processwire.com/docs/modules/types/
* '''Fieldtype''': Repräsentiert einen Datentyp. Meistens keine Public API, Handelt Daten / Datenbank - [[ProcessWire - Fieldtype erstellen (Module)]]
* '''Inputfield''': Sammelt User Eingaben über ein Formular im Admin Bereich. Im Gegensatz zum Fieldtype geht es hier um das UI im Backend. Das Handling der Daten liegt beim Fieldtype.
* [[Process Module (ProcessWire)|'''Process''' for creating admin processes/applications.]]
* '''Textformatter''' for formatting text.
* '''AdminTheme''' for creating themes in the admin.
* '''WireMail''' for modules that send email and extend the WireMail class.
* '''Tfa''' for implementing a specific kind of two-factor authentication.
* '''ImageSizerEngine''' for modules that extend ImageSizerEngine for resizing images.
* '''FileCompiler''' for modules that extend FileCompilerModule for compilation of files.
* '''FileValidator''' for modules that extend FileValidatorModule for validation of files.

=== Wie werden Felder in der Datenbank angelegt ? ===
Felder die in der Datenbank speichern sind vom Typ "Fieldtype", meistens in Kombination mit einem Inputfield das dann die Frontendausgabe übernimmt.
Module können auch für ihre eigene Konfiguration Daten in der Datenbank speichern. Das geht z.B. über eine ModulnameConfig Datei (s.u.).

=== Namenskonventionen ===
Ein Modulname sollte mit dem Typ den das Modul hat beginnen. Also etwa ProcessMeinAdminModul oder FieldtypeTable. ProcessWire listet das Modul dann in der Entsprechenden Kategorie auf. Wenn man etwas anderes nimmt z.B. LoginRegister dann kommt das Modul unter der neuen Rubrik "Login"

=== Konfigurierbare Module ===
Das geht seit 2.5.5 mittlerweile sehr einfach mit den neuen configuration-options.
https://processwire.com/blog/posts/new-module-configuration-options/
[[ProcessWire - Konfigurierbare Module]]

== Spezielle Funktionen in Modulen ==

=== Modulinformation ===
Das Modul stellt Infos zur Verfügung und nutzt dafür eine von 3 Methoden:
getModuleInfo() static method in your module class that returns an array.
YourModuleClass.info.php file that populates an $info array.
YourModuleClass.info.json file that contains an info object.

Hier werden title, version, summary und weitere Daten hinterlegt. Hier kann man auch angeben ob ein Modul ein Autoload Modul ist.

https://processwire.com/api/ref/module/

=== init ===
public function init(){}
Initialisiert das Modul. ProcessWire ruft diese Funktion auf, wenn das Modul geladen ist. Bei Autoload Modulen wird es aufgerufen wenn die ProcessWire API bereit ist. Daher ist es ein guter Ort um Hooks einzubinden.

=== ready ===
<syntaxhighlight lang="php">
public function ready() {
if($this->page->template == 'admin') {
$this->message($this->hi());
}
}
</syntaxhighlight>
Wird in autoload Modulen aufgerufen wenn die API bereit ist. Nützlich für Hooks:

=== execute ===
<syntaxhighlight lang="php">
/**
* This function is executed when a page with your Process assigned is accessed.
*
* This can be seen as your main or index function. You'll probably want to replace
* everything in this function.
*
*/
public function ___execute() {
// greetingType and greeting are automatically populated to this module
// and they were defined in ProcessHello.config.php
if($this->greetingType == 'message') {
$this->message($this->greeting);
} else if($this->greetingType == 'warning') {
$this->warning($this->greeting);
} else {
$this->error($this->greeting);
}
// generate some navigation
$out = "
<h2>$this->greeting</h2>
<dl class='nav'>
<dt><a href='./something/'>Do Something</a></dt>
<dd>Runs the executeSomething() function.</dd>
</dl>
";
return $out;
}
</syntaxhighlight>

=== executeSomething ===
Ruft man eine Unterseite des Moduls auf kann man eine eigene execute Funktion nutzen
___executeSlug wobei Slug für den Url Slug steht. Heißt der slug /field/ dann wird executeField() aufgerufen, falls diese Funktion existiert.
<syntaxhighlight lang="php">
/**
* Called when the URL is this module's page URL + "/something/"
*
*/
public function ___executeSomething() {
// set a new headline, replacing the one used by our page
// this is optional as PW will auto-generate a headline
$this->headline('This is something!');
// add a breadcrumb that returns to our main page
// this is optional as PW will auto-generate breadcrumbs
$this->breadcrumb('../', 'Hello');
$out = "
<h2>Not much to to see here</h2>
<p><a href='../'>Go Back</a></p>
";
return $out;
}
</syntaxhighlight>
* executeMySecondPage translates to my-second-page in the URL
* executeMysecondpage translates to mysecondpage in the URL

=== install & uninstall ===
<syntaxhighlight lang="php">

/**
* Called only when your module is installed
*
* If you don't need anything here, you can simply remove this method.
*
*/
public function ___install() {
parent::___install(); // always remember to call parent method
}
/**
* Called only when your module is uninstalled
*
* This should return the site to the same state it was in before the module was installed.
*
* If you don't need anything here, you can simply remove this method.
*
*/
public function ___uninstall() {
parent::___uninstall(); // always remember to call parent method
}
</syntaxhighlight>

== Vererbung und Eigenschaften in Modulen ==
Modules are not different from PHP classes.

To change the properties of MyModule class from within MyOtherModule class, you can either:

#Make MyOtherModule class extend MyModule. It will thus inherit MyModule's public and protected properties and methods
#Make the properties firstName and lastName configurable by passing them as parameters/arguments in MyModule's constructor method.

== Autoload Module und Hooks ==
Autoload werden automatisch geladen müssen also nicht in einem Template o.ä. gestartet werden. Daher bieten sie sich an um die Funktionalität von ProcessWire zu erweitern. Als Werkzeug dafür dienen Hooks. Mit Hooks kann man an vielen Stellen den Rendering Process der Seiten beeinflussen. Außerdem kann man für eigene Module ebenfalls Hooks bereitstellen.

=== Hooks ===
https://processwire.com/docs/modules/hooks/
Hooks sind ein mächtiges Werkzeug. Sie geben einem die Möglichkeit an vielen Stellen "einzuhaken" und Funktionalität einzubauen.
<syntaxhighlight lang="php">
public function ready() {
$this->addHookAfter('Page::render', function($event) {
$event->return .= '<p>Hallo</p>';
});
}
</syntaxhighlight>
Schreibt am Ende Jeder Seite ein "Hallo". Das $event Objekt ist ein [https://processwire.com/api/ref/hook-event/ HookEvent]. Im Beispiel fügen wir einfach etwas Markup hinzu. Über $event->arguments() kann man aber auf ale Argumente zugreifen.

Das gleiche aber nicht mit anonymer Funktion:
<syntaxhighlight lang="php">
public function ready() {
// add hook after Page::render() and make it call the "test" method of $this module
$this->addHookAfter('Page::render', $this, 'test');
}

public function test($event) {
// modify the return value of Page::render() to include the following:
$event->return .= '<p>Hallo</p>';
}
</syntaxhighlight>

=== Hooks zum erweitern von existierenden Klassen nutzen ===
Mit Hooks kann man in vorhandene Klassen einhaken. Z.B. läßt sich das Page Objekt erweitern.
<syntaxhighlight lang="php">
public function ready() {
$this->addHook('Page::summarize', $this, 'summarize');
}
public function summarize($event) {
$page = $event->object; // the $event->object represents the object hooked (Page)
$maxlen = $event->arguments(0); // first argument is the optional max length
if(!$maxlen) $maxlen = 200; // if no $maxlen was present, we'll use a default of 200
$summary = $this->sanitizer->truncate($page->body, $maxlen); // use sanitizer truncate method to create a summary
$event->return = $summary; // populate $summary to $event->return, the return value
}
</syntaxhighlight>
So kann man ganz einfach eine Zusammenfassung aller Kindseiten in einem Template rendern:
<syntaxhighlight lang="php">
foreach($page->children as $item) {
$summary = $item->summarize(150);
echo "<li><a href='$item->url'>$item->title</a><br>$summary";
}
</syntaxhighlight>

=== Autoload Module nur im Admin Bereich laden ===

'autoload' => 'template=admin'
statt
'autoload' => true

=== Hook Beispiele ===
Hook am Ende des Renderings
$this->addHookAfter('Page::render', function($event) {...});
Füge eine Funktion "summarize" zum Page Objekt hinzu.
$this->addHook('Page::summarize', $this, 'summarize');
Hook auf eine einzelne Instanz (hier pages Objekt)
$this->pages->addHookAfter('saved', function($event){...});
$this->addHook('Page::method', ...) // Spricht ALLE Instanzen an - Regelfall
$page->addHook('method', ...) // Spricht nur die EINE Instanz der Seite an.
</pre>

== Module Dependencies - voneinander abhängige Module ==

https://processwire.com/talk/topic/778-module-dependencies/
Wenn ein Modul nicht ohne ein anderes funktioniert spricht man von Module Dependency. In solchen Fällen kann man in der Modul Info angeben In vielen Fällen besteht ein Modul unter der Haube aus mehreren Einzelmodulen.

Um ProcessWire mitzuteilen dass ein Modul benötigt wird gibt man es in der Moduldefinition an:
'requires' => "LazyCron" // added this line
oder auch mehrere als Array
'requires' => array("LazyCron", "AdminBar") // added this line

ProcessWire kann auch dafür sorgen, dass ein Modul andere "Kindmodule" gleich mitinstalliert bzw. deinstalliert wenn es nicht mehr benötigt wird. Dazu gibt man dem Modul noch die 'install' dependency mit:

<syntaxhighlight lang="php">
<?php
public static function getModuleInfo() {
return array(
'title' => 'Log Master',
'version' => 101,
'author' => 'Lumberjack Bob',
'summary' => 'Log all actions on your site',
'requires' => 'LazyCron',
'installs' => 'ProcessLogMaster' // added this line
);
);
</syntaxhighlight>

ProcessWire sieht dann eine Kindabhängigkeit zu diesem Modul und handelt auch das Deinstallieren, wenn das Elternmodul deinstalliert wird.

== CSS und JavaScript in Modulen ==
Bei Process Modulen möchte man für das Styling etc. im Backend oft CSS und JS Dateien hinzufügen.

Einfach Eine Datei MeinModul.css und / oder MeinModul.js hinzufügen. JQuery ist im Admin bereits geladen daher kann eine MeinModul.js Starter Datei so aussehen:

<pre>

/**
* This JS file is only loaded when the ProcessHello module is run
*
* You should delete it if you have no javascript to add.
*
*/

$(document).ready(function() {
// do something
});
</pre>

== Flexibler Umgang mit Templates - TemplateFile ==
TemplateFile sind eine Möglichkeit Templates zu Managen. Nützlich in Modulen oder in größeren Teams wo man sehr granuliert die Zugriffe über den Code steuern möchte.
https://processwire.com/talk/topic/291-simple-tutorial-on-how-to-use-templatefile-class/
https://processwire.com/api/ref/template-file/
<syntaxhighlight lang="php">
<?php

$out = new TemplateFile("./includes/my_markup.html");
$out->set('headline', $page->get("headline|title"));
$out->set('body', $page->body);
$out->set('sidebar', $page->sidebar);
$out->set('navigation', $pages->find("parent=/"));
echo $out->render();
</syntaxhighlight>

In my_markup.html kann man headline, body... einfach als Variablen setzen. Beim Rendern werden diese dann ersetzt.

== Beispiele ==
=== Felder und Templates erstellen ===
In einem Modul kann man Felder und Templates automatisch erstellen.
https://processwire.com/talk/topic/20533-solved-fields-templates-and-fieldgroups-how-do-they-interact/

For everyone not deeply into obscure PW vodoo magic, creating a template with fields is always:

Create a template
Create a fieldgroup with the same name as the template
Create your fields, save them and add them to the fieldgroup
Save the fieldgroup
Set the fieldgroup in the template
Save the template

* Are Fieldgroups required for adding fields to templates? What are these for?
** Yes, they are. As written above, they are just a necessary glue.
*What if I'd like to add fields after the template was saved and how can I add them to the same fieldgroup?
** Just add them to the fieldgroup
<pre>
$fg = $template->fieldgroup;
$fg->add($field);
$fg->save();
</pre>

=== Frontend Rendering Module ===
A bit old but working

<syntaxhighlight lang="php">
<?php

/**
* FrontEndRender
*
* Author: Ben Byford
*
* ProcessWire 2.x
* Copyright (C) 2010 by Ryan Cramer
* Licensed under GNU/GPL v2, see LICENSE.TXT
*
* http://www.processwire.com
* http://www.ryancramer.com
*
*/

class FrontEndRender extends WireData implements Module {

public static function getModuleInfo() {
return array(
'title' => 'FrontEndRender',
'version' => 0.1,
'summary' => "Outputs html and static variables to frontend",
'author' => 'Ben Byford',
'singular' => true,
'href' => 'https://github.com/benbyford/PW-starter-modules'
);
}

// protected variable only accessable within module
protected $name = 'Ben';

/*
* render function to be called in PW template like this:
* $FrontEndRender = $modules->getModule('FrontEndRender');
* echo '<h1>' . $FrontEndRender->render() . '</h1>';
*
*/
public function render(){
return "Hello " . $this->name;
}
}
?>
</syntaxhighlight>

=== ProcessWire Hello World Modul ===
Beispiel Modul mit Hooks (liegt immer in der Standardinstallation)
<syntaxhighlight lang="php">
<?php namespace ProcessWire;

/**
* ProcessWire 'Hello world' demonstration module
*
* Demonstrates the Module interface and how to add hooks.
*
* See README file for further links regarding module development.
*
* This file is licensed under the MIT license
* https://processwire.com/about/license/mit/
*
* ProcessWire 3.x, Copyright 2016 by Ryan Cramer
* https://processwire.com
*
*/

class Helloworld extends WireData implements Module {

/**
* getModuleInfo is a module required by all modules to tell ProcessWire about them
*
* @return array
*
*/
public static function getModuleInfo() {

return array(

// The module's title, typically a little more descriptive than the class name
'title' => 'Hello World',

// version number
'version' => 3,

// summary is brief description of what this module is
'summary' => 'An example module used for demonstration purposes.',

// Optional URL to more information about the module
'href' => 'https://processwire.com',

// singular=true: indicates that only one instance of the module is allowed.
// This is usually what you want for modules that attach hooks.
'singular' => true,

// autoload=true: indicates the module should be started with ProcessWire.
// This is necessary for any modules that attach runtime hooks, otherwise those
// hooks won't get attached unless some other code calls the module on it's own.
// Note that autoload modules are almost always also 'singular' (seen above).
'autoload' => true,

// Optional font-awesome icon name, minus the 'fa-' part
'icon' => 'smile-o',
);
}

/**
* Initialize the module
*
* ProcessWire calls this when the module is loaded. For 'autoload' modules, this will be called
* when ProcessWire's API is ready. As a result, this is a good place to attach hooks.
*
*/
public function init() {

// add a hook after the $pages->save, to issue a notice every time a page is saved
$this->pages->addHookAfter('save', $this, 'example1');

// add a hook after each page is rendered and modify the output
$this->addHookAfter('Page::render', $this, 'example2');

// add a 'hello' method to every page that returns "Hello World"
// use "echo $page->hello();" in your template file to display output
$this->addHook('Page::hello', $this, 'example3');

// add a 'hello_world' property to every page that returns "Hello [user]"
// use "echo $page->hello_world;" in your template file to display output
$this->addHookProperty('Page::hello_world', $this, 'example4');
}

/**
* Example1 hooks into the pages->save method and displays a notice every time a page is saved
*
* @param HookEvent $event
*
*/
public function example1($event) {
/** @var Page $page */
$page = $event->arguments[0];
$this->message("Hello World! You saved {$page->path}.");
}

/**
* Example2 hooks into every page after it's rendered and adds "Hello World" text at the bottom
*
* @param HookEvent $event
*
*/
public function example2($event) {

/** @var Page $page */
$page = $event->object;

// don't add this to the admin pages
if($page->template == 'admin') return;

// add a "Hello World" paragraph right before the closing body tag
$event->return = str_replace("</body>", "<p>Hello World!</p></body>", $event->return);
}

/**
* Example3 adds a 'hello' method (not property) to every page that simply returns "Hello World"
*
* @param HookEvent $event
*
*/
public function example3($event) {
$event->return = "Hello World";
}

/**
* Example 4 adds a 'hello_world' property (not method) to every page that returns "Hello [user]"
*
* @param HookEvent $event
*
*/
public function example4($event) {
$event->return = "Hello " . $this->user->name;
}

}

</syntaxhighlight>

=== ProcessWire Admin Bereich mit eigener Funktionalität erweitern (Modul)===
https://webdesign.tutsplus.com/tutorials/extending-the-processwire-admin-using-custom-modules--cms-26863
<syntaxhighlight lang="php">

<?php
/**
* ProcessSimpleAdminPage
*
* @author Ben Byford
* http://www.benbyford.com
*
* @see http://www.processwire.com
*/

class ProcessSimpleAdminPage extends Process {

public static function getModuleInfo() {
return array(
'title' => 'Process Simple Admin Page',
'summary' => 'Simple Process module that adds new admin page with',
'version' => 001,

// Modules that extend Process may specify a 'page' attribute in the
// getModuleInfo(), this page will automatically be given the module
// process when added to teh pagetree.

// I have exampled but commented out the 'page' settings below
// so that I can show how one might add a page to install() and
// uninstall() in this and other modules (that might not extend
// Process)

// 'page' => array(
// 'name' => 'site-config',
// 'parent' => 'admin',
// 'title' => 'Site Config'
// )
);
}

public function execute() {
return '
<h2>Edit the text here in the module</h2>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam mattis eros vitae metus sodales eget suscipit purus rhoncus. Proin ultrices gravida dolor, non porttitor enim interdum vitae. Integer feugiat lacinia tincidunt. Nulla laoreet tristique tristique. Sed elementum justo a nisl elementum sit amet accumsan nisi tempor. Nulla quis eros et massa dignissim imperdiet a vitae purus.</p>

<p>Donec scelerisque pulvinar sem eu lobortis. Maecenas turpis ipsum, tempus dictum pharetra eu, consectetur vitae arcu. Fusce orci mauris, semper at tempus quis, volutpat molestie tellus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Sed quam tortor, tincidunt sed semper lacinia, scelerisque dapibus quam. Morbi at nisi luctus lacus auctor ultrices eu eu leo.</p>

<p>Praesent faucibus purus id felis tincidunt dignissim. Sed sit amet ligula mi, eget semper dui. Proin consectetur gravida massa, nec luctus purus hendrerit in. Etiam volutpat, elit non venenatis suscipit, libero neque consectetur diam, id rutrum magna odio ac ligula. Maecenas sollicitudin congue neque fermentum vestibulum. Morbi nec leo nisi. Donec at nisl odio, et porta ligula.</p>

<p>Sed quis arcu nisi, ac tempor augue. Praesent non elit libero, a ullamcorper lorem. Curabitur porta odio eu nunc ultricies interdum id nec risus. Donec nibh nibh, porta eget vehicula ac, aliquet eget ante. Phasellus eget lorem eu eros eleifend ultrices. Cras sit amet neque sit amet nibh fringilla cursus ut id mauris. Praesent quis nunc justo, sed suscipit lectus. Phasellus eget ultrices risus. Curabitur eu semper est. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Ut suscipit, nisl ut imperdiet eleifend, turpis arcu placerat tortor, nec laoreet lacus neque ac tellus. Aenean ac lacus justo, quis ultricies nisi.</p>
';
}
public function install(){

// create new page to add to CMS
$page = new Page();

// add page attributes
$page->template = "admin";
$page->name = "cms-faq";
$page->title = "CMS FAQ";
$page->save();

// set this module as the page process, this allows us to display the above
$page->process = 'ProcessSimpleAdminPage';

// get admin page and set as page parent
$admin = $this->pages->get("id=2");
$page->parent = $admin;

// save page
$page->save();
}

public function uninstall(){

// delete created page
$page = $this->pages->get("name=cms-faq");
if(count($page)) $this->pages->delete($page, true);
}
}
</syntaxhighlight>

=== ProcessWire Textformatter Modul ===
https://webdesign.tutsplus.com/tutorials/extending-the-processwire-admin-using-custom-modules--cms-26863
<syntaxhighlight lang="php">
<?php

/**
* TextformatterFindReplace
*
* Author: Ben Byford
*
* ProcessWire 2.x
* Copyright (C) 2010 by Ryan Cramer
* Licensed under GNU/GPL v2, see LICENSE.TXT
*
* http://www.processwire.com
* http://www.ryancramer.com
*
*/

class TextformatterFindReplace extends Textformatter implements Module {

public static function getModuleInfo() {
return array(
'title' => 'TextformatterFindReplace',
'version' => 0.1,
'summary' => "Finds and replaces any instance of config input to config output",
'author' => 'Ben Byford',
'singular' => true,
'href' => 'https://github.com/benbyford/PW-starter-modules'
);
}

/**
* Find and Replace the input string
*
* @param string $str The block of text to parse
*
* The incoming string is replaced with the formatted version of itself.
**/

public function format(&$str) {
$find = $this->findStr;
$str = preg_replace_callback($find, array($this,"replace"), $str);

}

// adding three underscores to a function allows other modules to hook it
public function ___replace($match) {
return $this->replaceStr;
}
}
?>
</syntaxhighlight>

=== Admin Funktionalität: Countdown zum Seitenveröffentlichen ===
https://webdesign.tutsplus.com/tutorials/extending-the-processwire-admin-using-custom-modules--cms-26863

The module PageDeferredPublish, on clicking one of the '''Publish Later buttons''', sets LazyCron to check that page’s countdown every minute and publishes the page when its countdown reaches 0. This means I can publish a page approximately 24 hours in advance (obviously the checking interval and delay time can be changed to your requirements).

I did this by:

'''Creating two fields''' within my install() function: a checkbox field to set to true when a button is checked to indicate the page should countdown, and a countdown field to store the count in seconds for that specific page.

'''Adding hooks''' to both ''ProcessPageEdit::buildForm'' and ''ProcessPageListActions::getExtraActions'' enabling me to add the two buttons.

Checking to see if one of the buttons was clicked with my '''ready() function''' then setting the corresponding page’s checkbox to true.

Using a '''LazyCron hook function''' to check all pages that are unpublished for true checkboxes and then comparing the seconds field to see if the page needs publishing. If not then deduct the elapsed time in seconds.

The result is a '''module that has settings''' (the time interval to check and publish at a later time), '''hooks into the admin''' using buttons and fields, and enables us to '''use other modules installe'''d in PW (i.e. LazyCron).

<syntaxhighlight lang="php">
<?php
/**
* DeferredPublish (0.0.1)
* DeferredPublish publishes a page after a defined amount of time has elapsed using lazycron.
*
* @author Ben Byford
* http://www.benbyford.com
*
* ProcessWire 2.x
* Copyright (C) 2011 by Ryan Cramer
* Licensed under GNU/GPL v2, see LICENSE.TXT
*
* http://www.processwire.com
* http://www.ryancramer.com
*
*/

class PageDeferredPublish extends WireData implements Module {

public static function getModuleInfo() {
return array(
'title' => "PageDeferredPublish",
'version' => "0.0.1",
'summary' => "PageDeferredPublish",
'author' => "Ben Byford",
'href' => "https://github.com/benbyford/PW-intermediate-modules",
'icon' => "clock-o",
'autoload' => true,
'singular' => true,
'requires' => "LazyCron",
);
}

private $postPubLater = null;
private $pageID = null;
private $pagePubLater = null;
private $currentPage = null;

private $submitName = 'pdp_pub_later_submit';
private $listPageName = 'pdp_pub_later_list';
private $fieldName = 'pdp_pub_later';
private $checkboxName = 'pdp_pub_later_check';

private $defaultInterval = 'everyMinute';
private $defaultTime = 86400;

public function install(){
// add new fields needed for module
$this->installFields();
}
public function uninstall(){
// uninstall fields
$this->uninstallFields();
}

// initialize the hook in your AutoLoad module
public function init() {

// get defaults from module setting in CMS
$this->defaultTime = $this->pub_after;
$this->defaultInterval = $this->cron_check;

// get admin URL
$this->adminUrl = $this->wire('config')->urls->admin;

// add hooks to CRON, PageList, PageEdit
$this->addHookAfter("LazyCron::{$this->defaultInterval}", $this, 'publishDefferedPages');
$this->addHook("ProcessPageListActions::getExtraActions", $this, 'hookPageListActions');
$this->addHookAfter("ProcessPageEdit::buildForm", $this, "editForm");
}

public function ready() {

// if list button clicked then grab id
$this->pagePubLater = $this->input->get($this->listPageName);
$this->pageID = $this->input->id;

// get page
$this->currentPage = $this->pages->get($this->pageID);

// if pagelist pub later submit button clicked
if($this->pagePubLater){
$this->message("Page {$this->currentPage->name} deffered for publish.");
}

// if page edit submit button clicked
$this->postPubLater = $this->input->post($this->submitName);
if($this->postPubLater){
$this->message("Page {$this->currentPage->name} deffered for publish.");
}

// if either deffered publish sumbit found then publish page later
if($this->pagePubLater || $this->postPubLater){
$this->publishLater();
}
}

/*
* Hook: ProcessPageEdit::buildForm
*
* add Publish Later button to edit page if not yet published
*/
public function ___editForm(HookEvent $form) {

// get the InputFieldForm object from the event (return value of buildForm())
$form = $form->return;

$page = $this->pages->get($this->input->get->id);
$check = $page->get($this->checkboxName);

// check if publish button available and therfore unpublished
$target = $form->get('submit_publish');

if($target && $check == false){

// get InputfieldText module
$submit2 = $this->modules->get('InputfieldSubmit');
$submit2->attr('name', $this->submitName);
$submit2->attr('id', 'publish_later');
$submit2->attr('class', 'ui-button ui-widget ui-corner-all head_button_clone ui-state-default ui-priority-secondary');
$submit2->attr('value', 'Publish Later'); // Button: save unpublished

// get form element save and place before
$target = $form->get('submit_save');
$form->insertBefore($submit2, $target);

$form->return = $form;
}
}

public function ___hookPageListActions(HookEvent $event) {

// get current page
$page = $event->arguments[0];

// check to see if page is published
$pagePub = $page->is(Page::statusUnpublished);

// check to see if page template has deffered field
$pageHasDefferField = $page->get($this->fieldName);

$actions = array();

// don't get homepage or pages that are already published or are being deffered for publish
if($page->id > 1 && $pagePub == "published" && !is_null($pageHasDefferField) && $page->get($this->checkboxName) == false) {

$actions['publish_later'] = array(
'cn' => 'PublishLater',
'name' => 'pub later',
'url' => "{$this->adminUrl}?{$this->listPageName}=1&id={$page->id}",
);
}
if(count($actions)) $event->return = $actions + $event->return;
}

/*
* Publish Page on cron job
*
* Gets deffered page and publishes
*/
public function ___publish($page) {
$page->removeStatus(Page::statusUnpublished);
$page->removeStatus(Page::statusHidden);
$page->Save();
}

/*
* Main publish later function
*
* Gets deffered page and sets fields to be checked be lazy cron
*/
private function ___publishLater() {

// get page
$page = $this->pages->get($this->pageID);

// set output formatting to false
$page->of(false);

// set field time to settings default time and checkbox to true
$page->set($this->checkboxName, true);
$page->set($this->fieldName, $this->defaultTime);

// save page
$page->save();
$page->of(true);
}

/*
* Lazy Cron hook function
*
* Triggers every [set time interval] and checks pages
* Publishes page if time runout
*
* Adds publish page log
*/
public function ___publishDefferedPages(HookEvent $e){

// seconds since last lazycron
$seconds = $e->arguments[0];

// find all pages with deffered field
$defferedPages = $this->pages->find("{$this->checkboxName}=1,include=unpublished");

// for each page decrease time for deffered field
foreach ($defferedPages as $page) {

// get current page time
$timeTillPublish = $page->get($this->fieldName);

// set time to time minus time past
$timeLeft = $timeTillPublish - $seconds;

// if time passed 0 or less then publish page
$page->of(false);
if($timeLeft <= 0){
// remove flags and save
$this->publish($page);

$page->set($this->fieldName, 0);
$page->set($this->checkboxName, 0);

// log a page has been published
$log = wire('log');
$log->message('CRON:'. $seconds .' Pages: '. $page->name .' published');
}else{
$page->set($this->fieldName, $timeLeft);
}
// save page time
$page->Save();
$page->of(true);
}
}

/*
* Install new module specific fields
*/
private function installFields(){

// install pub later checkbox field
// find installed fields
$f = $this->fields->get($this->fieldName);
if($f){

// if field already found then don't try and make it
$this->message($this->fieldName . ' field found');

}else{

// create new field object to store crontime
$f = new Field();
// get a field type
$f->type = $this->modules->get("FieldtypeInteger");
$f->name = $this->fieldName;
$f->label = 'Publish Time Left';
$f->defaultValue = $this->defaultTime;
$f->icon = 'clock-o';
$f->columnWidth = 50;
$f->collapsed = 1;
$f->flags = 4;

$f->save(); // save the field

// create new field object to store whether to publish or not
$f = new Field();
// get a field type
$f->type = $this->modules->get("FieldtypeCheckbox");
$f->name = $this->checkboxName;
$f->label = 'Publish Page later';
$f->defaultValue = false;
$f->columnWidth = 50;
$f->icon = 'clock-o';
$f->collapsed = 1;
$f->flags = 4;

$f->save(); // save the field
}
}

/*
* Uninstall module specific fields
*/
private function uninstallFields(){

// find installed fields
$fInt = $this->fields->get($this->fieldName);
$fCheck = $this->fields->get($this->checkboxName);

if($fInt && $fCheck){
$fieldIntUsed = $fInt->numFieldgroups();
$fieldCheckUsed = $fCheck->numFieldgroups();

if($fieldIntUsed){
// field in use by template
$this->message('Unable to uninstall field '.$fInt->name);
}else{
// delete installed fields
$this->fields->delete($fInt);
$this->fields->save;
}

if($fieldCheckUsed){
// field in use by template
$this->message('Unable to uninstall field '.$fCheck->name);
}else{
// delete installed fields
$this->fields->delete($fCheck);
$this->fields->save;
}
}
}
}
</syntaxhighlight>

=== Inputfield / Fieldtype ===
[[ProcessWire - Fieldtype erstellen (Module)]]

=== Konfigurationsdatei statt getModuleInfo ===
Bei größeren Konfigruation (z.B. Admin Page Navigation) sinnvoll.
<syntaxhighlight lang="php">
<?php
/**
* ProcessHello.info.php
*
* Return information about this module.
*
* If preferred, you can use a getModuleInfo() method in your module file,
* or you can use a ModuleName.info.json file (if you prefer JSON definition).
*
*/
$info = array(
// Your module's title
'title' => 'Hello: Process Module Example',
// A 1 sentence description of what your module does
'summary' => 'A starting point module skeleton from which to build your own Process module.',
// Module version number: use 1 for 0.0.1 or 100 for 1.0.0, and so on
'version' => 1,
// Name of person who created this module (change to your name)
'author' => 'Ryan Cramer',
// Icon to accompany this module (optional), uses font-awesome icon names, minus the "fa-" part
'icon' => 'thumbs-up',
// URL to more info: change to your full modules.processwire.com URL (if available), or something else if you prefer
'href' => 'http://modules.processwire.com/',
// name of permission required of users to execute this Process (optional)
'permission' => 'helloworld',
// permissions that you want automatically installed/uninstalled with this module (name => description)
'permissions' => array(
'helloworld' => 'Run the HelloWorld module'
),

// page that you want created to execute this module
'page' => array(
'name' => 'helloworld',
'parent' => 'setup',
'title' => 'Hello World'
),
// optional extra navigation that appears in admin
// if you change this, you'll need to a Modules > Refresh to see changes
'nav' => array(
array(
'url' => '',
'label' => 'Hello',
'icon' => 'smile-o',
),
array(
'url' => 'something/',
'label' => 'Something',
'icon' => 'beer',
),
)
// for more options that you may specify here, see the file: /wire/core/Process.php
// and the file: /wire/core/Module.php
);
</syntaxhighlight>

== Interessantes - Read On ==
https://processwire.com/talk/topic/24067-solved-settings-fields-that-dont-save-to-database/
https://processwire.com/talk/topic/24075-solved-create-field-and-add-to-template/

XML erzeugen

2021-09-22T15:22:34Z

134.3.85.26: /* Mit XMLWriter */

== Siehe auch ==
[[SimpleXML]]

== Mit dem DOM (Document Object Model) ==
http://de3.php.net/manual/en/book.dom.php
=== Beispiel ===
https://stackoverflow.com/questions/143122/using-simplexml-to-create-an-xml-object-from-scratch
<syntaxhighlight lang="php">
$domDoc = new DOMDocument;
$rootElt = $domDoc->createElement('root');
$rootNode = $domDoc->appendChild($rootElt);

$subElt = $domDoc->createElement('foo');
$attr = $domDoc->createAttribute('ah');
$attrVal = $domDoc->createTextNode('OK');
$attr->appendChild($attrVal);
$subElt->appendChild($attr);
$subNode = $rootNode->appendChild($subElt);

$textNode = $domDoc->createTextNode('Wow, it works!');
$subNode->appendChild($textNode);

echo htmlentities($domDoc->saveXML());
</syntaxhighlight>
Mit dem DOM sind recht flexible Manipulationen möglich:
$elem->append($doc->p('This is a paragraph'));
$elem->append('Some text');

== Mit XMLWriter ==
https://www.php.net/manual/en/intro.xmlwriter.php
https://www.php.net/manual/de/example.xmlwriter-simple.php

Soll einfacher sein als mit dem DOM Object
<syntaxhighlight lang="php">
$w=new XMLWriter();
$w->openMemory();
$w->startDocument('1.0','UTF-8');
$w->startElement("root");
$w->writeAttribute("ah", "OK");
$w->text('Wow, it works!');
$w->endElement();
echo htmlentities($w->outputMemory(true));
</syntaxhighlight>

XML erzeugen

2021-09-22T15:20:48Z

134.3.85.26: /* Mit XMLWriter */

== Siehe auch ==
[[SimpleXML]]

== Mit dem DOM (Document Object Model) ==
http://de3.php.net/manual/en/book.dom.php
=== Beispiel ===
https://stackoverflow.com/questions/143122/using-simplexml-to-create-an-xml-object-from-scratch
<syntaxhighlight lang="php">
$domDoc = new DOMDocument;
$rootElt = $domDoc->createElement('root');
$rootNode = $domDoc->appendChild($rootElt);

$subElt = $domDoc->createElement('foo');
$attr = $domDoc->createAttribute('ah');
$attrVal = $domDoc->createTextNode('OK');
$attr->appendChild($attrVal);
$subElt->appendChild($attr);
$subNode = $rootNode->appendChild($subElt);

$textNode = $domDoc->createTextNode('Wow, it works!');
$subNode->appendChild($textNode);

echo htmlentities($domDoc->saveXML());
</syntaxhighlight>
Mit dem DOM sind recht flexible Manipulationen möglich:
$elem->append($doc->p('This is a paragraph'));
$elem->append('Some text');

== Mit XMLWriter ==
https://www.php.net/manual/en/intro.xmlwriter.php
Soll einfacher sein als mit dem DOM Object
<syntaxhighlight lang="php">
$w=new XMLWriter();
$w->openMemory();
$w->startDocument('1.0','UTF-8');
$w->startElement("root");
$w->writeAttribute("ah", "OK");
$w->text('Wow, it works!');
$w->endElement();
echo htmlentities($w->outputMemory(true));
</syntaxhighlight>

XML erzeugen

2021-09-22T15:20:00Z

134.3.85.26: /* DOM Object Model */

== Siehe auch ==
[[SimpleXML]]

== Mit dem DOM (Document Object Model) ==
http://de3.php.net/manual/en/book.dom.php
=== Beispiel ===
https://stackoverflow.com/questions/143122/using-simplexml-to-create-an-xml-object-from-scratch
<syntaxhighlight lang="php">
$domDoc = new DOMDocument;
$rootElt = $domDoc->createElement('root');
$rootNode = $domDoc->appendChild($rootElt);

$subElt = $domDoc->createElement('foo');
$attr = $domDoc->createAttribute('ah');
$attrVal = $domDoc->createTextNode('OK');
$attr->appendChild($attrVal);
$subElt->appendChild($attr);
$subNode = $rootNode->appendChild($subElt);

$textNode = $domDoc->createTextNode('Wow, it works!');
$subNode->appendChild($textNode);

echo htmlentities($domDoc->saveXML());
</syntaxhighlight>
Mit dem DOM sind recht flexible Manipulationen möglich:
$elem->append($doc->p('This is a paragraph'));
$elem->append('Some text');

== Mit XMLWriter ==
http://de3.php.net/manual/en/intro.xmlwriter.php
Soll einfacher sein als mit dem DOM Object
<syntaxhighlight lang="php">
$w=new XMLWriter();
$w->openMemory();
$w->startDocument('1.0','UTF-8');
$w->startElement("root");
$w->writeAttribute("ah", "OK");
$w->text('Wow, it works!');
$w->endElement();
echo htmlentities($w->outputMemory(true));
</syntaxhighlight>

XML erzeugen

2021-09-22T15:15:45Z

134.3.85.26:

== Siehe auch ==
[[SimpleXML]]

== DOM Object Model ==
=== Beispiel ===
https://stackoverflow.com/questions/143122/using-simplexml-to-create-an-xml-object-from-scratch
<syntaxhighlight lang="php">
$domDoc = new DOMDocument;
$rootElt = $domDoc->createElement('root');
$rootNode = $domDoc->appendChild($rootElt);

$subElt = $domDoc->createElement('foo');
$attr = $domDoc->createAttribute('ah');
$attrVal = $domDoc->createTextNode('OK');
$attr->appendChild($attrVal);
$subElt->appendChild($attr);
$subNode = $rootNode->appendChild($subElt);

$textNode = $domDoc->createTextNode('Wow, it works!');
$subNode->appendChild($textNode);

echo htmlentities($domDoc->saveXML());
</syntaxhighlight>
Mit dem DOM Objekt Model sind recht einfache Manipulationen möglich:
$elem->append($doc->p('This is a paragraph'));
$elem->append('Some text');

SimpleXML

2021-09-22T15:11:50Z

134.3.85.26: /* Beispiele */

Simple XML ist eine PHP Schnittstelle zum Parsen von XML Dateien.

== Links ==
SimpleXML ist gut zum Parsen, aber zum Schreiben von XML gibt es bessere Möglichkeiten
[[XML erzeugen]]
== Einführung ==
== Generelles vorgehen ==
* Einlesen der Daten (z.B. XML-Datei, oder String) in ein '''SimpleXML Objekt'''
* '''xpath Query''' auf das Objekt anwenden ('''$result= $sxe->xpath("Pfadangabe")'''. Man erhält ein '''Array mit SimpleXML Objekten'''
* Zugriff auf Werte und Attribute der simpleXML Objekte. Oft werden Sie dazu mit foreach in weitere Arrays eingelesen.

== SimpleXML 101 - Empfehlungen zur Arbeit mit simpleXML==
Quelle: http://stackoverflow.com/questions/1893024/basic-simplexml-working-example Zugriff 7/2013

Example:
<pre>
<?xml version="1.0" encoding="ISO-8859-1"?>
<programme>
<title>Billy Bushwaka</title>
<episodeNumber>2</episodeNumber>
<description>Billy Bushwaka entertains</description>
<url>play.swf</url>
</programme>
</pre>

First of all, always '''name your PHP variables after the node they represent'''.

// the root node is ie <programme/>
$programme = simplexml_load_file("local.xml");
'''Access to children''' (nodes) as if they were object properties.

echo $programme->title;
If there are '''multiple children''' using the same name, you can '''specify their 0-based position'''

// first <title/> child
echo $programme->title[0];

// create or change the value of the second <title/> child
$programme->title[1] = 'Second title';

'''Access to attributes''' as if they were array keys

// <mynode attr="attribute value" />
echo $mynode['attr'];
Manchmal muß man Casten (andere Möglichkeiten s.u.)
$myVal = (string)$mynode['attr'];

'''XPath''' always returns an array.

=== More Hints ===
Quick XML
<pre>
$string = <<<XML
<a>
<foo name="one" game="lonely">1</foo>
</a>
XML;
</pre>

Alternative xpath:

$result = $xml->xpath("//programme/title");

=== Quellcode der xml Datei ausgeben ===
echo $simplexml->asXML();

== Snippets ==
=== XML-Datei von URL holen und in SimpleXML Objekt speichern===
==== XML Daten von URL holen mit file_get_contents ====
Hier wird erst nach dem Laden konvertiert.
<pre>
$url = "http://username:password@url.com";
$xml = file_get_contents($url);
$data = new SimpleXMLElement($xml);
</pre>
==== XML Daten mit simplexml_load_file ====
<pre>
//einfache Variante
function fetch_xml_data($url){
$simplexml=simplexml_load_file(rawurlencode("https://".$this->user.":".$this->pw.'@'.$url));
$simplexml=simplexml_load_file("test.xml");
return $simplexml;
}
</pre>
Manchmal erwartet der Server weitere Header. Dann muß man die Datei auf eine andere Weise mit Context laden (siehe Beispiel Mobile.de und Snippets)

==== Zusätzliche Header mit Stream Context senden ====
<pre>

// Variante - Einlesen mit Context um diverse Header mit zu schicken
function fetch_xml_data_ctx($url){
// Erzeugen eines Streams
$headers = "Accept-language: de\r\n";
$headers .= "Accept: application/xml\r\n";
$headers .= "Authorization: Basic ".base64_encode("$this->user:$this->pw")."\r\n";
$opts = array(
'http'=>array(
'method'=>"GET",
'header'=> $headers

)
);
$context = stream_context_create($opts);
// Öffnen der Datei mit den oben definierten HTTP-Headern
$file = file_get_contents('https://'.$url, false, $context);
$simplexml=simplexml_load_string($file);
//print_r($file);

return $simplexml;

}

</pre>
=== Zugriff auf Werte ===
Achtung: Wenn man die Werte über echo ausgibt wandelt sie PHP automatisch um damit sie angezeigt werden. Speichert man Sie hat man nur ein SimpleXMLObjekt um den Wert zu bekommen muß man es Casten.

==== Suche über xPath ====
xPath kann man als Suchpfad über die XML Hierarchie sehen.
<pre>
<?php
$string = <<<XML
<a>
<b>
<c>text</c>
<c>stuff</c>
</b>
<d>
<c>code</c>
</d>
</a>
XML;

$xml = new SimpleXMLElement($string);

/* Search for <a><b><c> */
$result = $xml->xpath('/a/b/c');

while(list( , $node) = each($result)) {
echo '/a/b/c: ',$node,"\n";
}

/* Relative paths also work... */
$result = $xml->xpath('b/c');

while(list( , $node) = each($result)) {
echo 'b/c: ',$node,"\n";
}
?>

</pre>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
<pre>
/a/b/c: text
/a/b/c: stuff
b/c: text
b/c: stuff
</pre>

=== Zugriff auf Attribute ===
====Beispiel 1====

Man lädt mittels foreach alle Attribute des SimpleXML Objektes in ein Array und greift dann darüber zu.
<pre>
foreach( $sxe->attributes() as $attr_name => $attr_value ){
$arr['attributes'][(string)$attr_name] = (string)$attr_value;
}
</pre>

Hinweis: Damit der Wert des Attributes als String ausgegeben wird muß man Casten (string) ansonsten wird ein Objekt zurück gegeben.

==== Beispiel 2 ====

Schneller Zugriff auf ein Attribut (Quelle php.net)

<pre>
<?php
$att = 'attribueName';

// Zugriff :
$attribute = $element->attributes()->$att;

// Casting als String liefert den Wert (ansonsten das Objekt)
$attribute = (string)$element->attributes()->$att;

// Auch verändern des Wertes ist möglich :
$element->attributes()->$att = 'New value of the attribute';
?>
</pre>

==== Beispiel 3 ====
Schneller Zugriff mit Hilfsfunktion (Quelle: php.net)

SimpleXMLElement Object
<pre>
(
[@attributes] => Array
(
[id] => 55555
)

[text] => "hello world"
)
</pre>
Funktion:
<pre>
<?php
function xml_attribute($object, $attribute)
{
if(isset($object[$attribute]))
return (string) $object[$attribute];
}
?>
</pre>
Nutzung:
<pre>
<?php
print xml_attribute($xml, 'id'); //prints "55555"
?>
</pre>

==== Beispiel 4 ====
'''Ein Ergebnis aus xPath ist ein Array von $sxe Objekten''' und kann z.B. so aussehen (aus mobile.de mit var_dump ausgegeben):
<pre>
array(1) {
[0]=>
object(SimpleXMLElement)#3 (1) {
["@attributes"]=>
array(4) {
["total"]=>
string(2) "85"
["page-size"]=>
string(2) "50"
["current-page"]=>
string(1) "1"
["max-pages"]=>
string(1) "2"
}
}
}
</pre>
Darauf ist auch ein direkter Zugriff möglich:
<pre>
private function parseResultInfo($sxe){
$arrInfo = array();
$xpath='//search:result'; // this works only if you have used the register_namespaces function in the snippets, otherwise you have to register xmlns:search="http://services.mobile.de/schema/search"
$result = $sxe->xpath($xpath);
//var_dump($result);
$arrInfo['total'] = (int)$result[0]['total'][0];
$arrInfo['page-size'] = (int)$result[0]['page-size'][0];
$arrInfo['current-page'] = (int)$result[0]['current-page'][0];
$arrInfo['max-pages'] = (int)$result[0]['max-pages'][0];
//print_r($arrInfo);
return $arrInfo;
}
</pre>

=== Kindknoten abfragen ===
<pre>
$children = $sxe->children($ns,TRUE);
</pre>
$ns ist der Namespace, der zweite Parameter sagt ob rekursiv gesucht wird.

== SimpleXML und Namespaces ==

=== Einfache Beispiele: ===

<syntaxhighlight lang="xml">
<root xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<event:event>
<event:sessionKey></event:sessionKey>
<event:sessionName>Learn QB in Minutes</event:sessionName>
<event:sessionType>9</event:sessionType>
<event:hostWebExID></event:hostWebExID>
<event:startDate>02/12/2009</event:startDate>
<event:endDate>02/12/2009</event:endDate>
<event:timeZoneID>11</event:timeZoneID>
<event:duration>30</event:duration>
<event:description></event:description>
<event:status>NOT_INPROGRESS</event:status>
<event:panelists></event:panelists>
<event:listStatus>PUBLIC</event:listStatus>
</event:event>
...
</root>
</syntaxhighlight>
==== Zugriff ohne Registrierung des Namespace ====
Dies setzt voraus, daß man sicher ist daß das xml immer den gleichen prefix verwendet.
<syntaxhighlight lang="php">
$xml = new SimpleXMLElement($r);

foreach($xml->xpath('//event:event') as $event) {
var_export($event->xpath('event:sessionKey'));
}
</syntaxhighlight>
==== Mit Registrierung der Namespaces ====

You have to register the namespace for each simpleXMLElement object you use.
<syntaxhighlight lang="php">
$xml = new SimpleXMLElement($r);
$xml->registerXPathNamespace('e', 'http://www.webex.com/schemas/2002/06/service/event');

foreach($xml->xpath('//e:event') as $event) {
$event->registerXPathNamespace('e', 'http://www.webex.com/schemas/2002/06/service/event');
var_export($event->xpath('//e:sessionKey'));
}
</syntaxhighlight>
The namespace should also be declared somewhere in the xml file.
<syntaxhighlight lang="xml">
<event:event xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
...
</syntaxhighlight>
==== Umgehen von Namespaces über dom_import ====
<syntaxhighlight lang="php">
$xml = new SimpleXMLElement($r);
$xml = dom_import_simplexml($xml);
$nodelist= $xml->getElementsByTagName('event');
for($i = 0; $i < $nodelist->length; $i++) {
$sessions = $nodelist->item($i)->getElementsByTagName('sessionKey');
echo $sessions->item(0)->nodeValue;
}
</syntaxhighlight>
=== Funktion um Namespaces zu registrieren ===
Über eine kleine Funktion kann man sich arbeit sparen.
<pre>
function register_namespaces($sxe){
$arrNs = $sxe->getNamespaces(true);
foreach($arrNs as $prefix => $ns){
$sxe->registerXPathNamespace($prefix, $ns);
echo($prefix.' = '.$ns);
}
}
</pre>
Alle im XML Dokument angegebenen Namespaces werden geparsed und Registriert. So kann man sie in Kurzform ansprechen. (Siehe Beispiel Mobile.de)

=== Allgemein ===
<pre>
$xml = <<<EOD
<book xmlns:chap="http://example.org/chapter-title">
<title>My Book</title>
<chapter id="1">
<chap:title>Chapter 1</chap:title>
<para>Donec velit. ...</para>
</chapter>
<chapter id="2">
<chap:title>Chapter 2</chap:title>
<para>Lorem ipsum ...</para>
</chapter>
</book>
EOD;

$sxe = new SimpleXMLElement($xml);

// Zugriff mit Namespace Prefix
$sxe->registerXPathNamespace('c', 'http://example.org/chapter-title');
$result = $sxe->xpath('//c:title');

foreach ($result as $title) {
echo $title . "\n";
}
</pre>

Direkter Zugriff im nächsen Beispiel
=== Beispiel Ebay Timestamp ===
<pre>
$response = <<< XMLBLOCK
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<GeteBayOfficialTimeResponse xmlns="urn:ebay:apis:eBLBaseComponents">
<Timestamp>2005-10-28T01:01:04.668Z</Timestamp>
<Ack>Success</Ack>
<Version>429</Version>
<Build>e429_intl_Bundled_1949355_R1</Build>
</GeteBayOfficialTimeResponse>
</soapenv:Body>
</soapenv:Envelope>
XMLBLOCK;
$xml = simplexml_load_string($response);
</pre>

Zugriff auf Timestamp:
<pre>
echo "Time: " .
$xml->children('http://schemas.xmlsoap.org/soap/envelope/')->children('urn:ebay:apis:eBLBaseComponents')->GeteBayOfficialTimeResponse->Timestamp . "\n";
</pre>

oder

<pre>
$xml->children('soapenv', true)->children()->GeteBayOfficialTimeResponse->Timestamp
</pre>

== Beispiele ==
===Beispiel Mobile de===
<pre>

<?php

class Mobile{
var $arrNs = array();

public function init(){
$this->action = "";
$this->user = "username";
$this->pw = "passwort";
$this->customerId = "461731";
$this->clientId = "517329";
$this->baseUrl = "services.mobile.de/1.0.0/ad/search";
$arrResult = array(); // Contains last Result-List
}

public function main(){
$this->init();
$params = "?customerId=".$this->customerId."&page.size=100";
$url = $this->baseUrl.$params;

$this->sxe = $this->fetch_xml_data_ctx($url);
$this->register_namespaces();
$this->parseXML($this->sxe);
//$this->sxe_print_info();
$this->send_json($this->arrResult);
}

//Parse XML and create Array
private function parseXML($sxe){
$arrAds = array();
unset($this->arrResult);
// ADS
$xpath='//ad:ad';
$result = $sxe->xpath($xpath);
$count = 0;
if(count($result) > 0){
foreach ($result as $ad) {
// AUTO Parsing
$this->arrResult[ad][$count] = $this->sxe_to_array($ad,'ad');

// MANUAL Parsing
// Images
unset($arrImages);
$arrRepresentation = $ad->xpath('ad:images/ad:image/ad:representation');
foreach($arrRepresentation as $representation){
foreach($representation->attributes() as $key=>$val){
$arrImages[$key][]=(string)$val;
}
}
$this->arrResult[ad][$count]['images']= $arrImages;
$count += 1;
}
}
}

// Stores Attributes and Childs into Array
private function sxe_to_array(SimpleXMLElement $sxe,$ns){
$arr = array();
// ATTRIBUTES
$count=0;
foreach( $sxe->attributes() as $attr_name => $attr_value ){
$arr['attributes'][(string)$attr_name] = (string)$attr_value;
}

// CHILDREN
$children = $sxe->children($ns,TRUE);
$count = 0;
foreach($children as $child_name=>$child_node){
$arrChild = $this->sxe_to_array($child_node,$ns);
// RESSOURCE CHILD (ns resource)
$resources = $this->getResources($child_node);
//print_r($resources);
if(!empty($resources)) $arrChild['resources'] = $resources;
$arr['children'][$count][$child_name]['value']=(string)$child_node;
$arr['children'][$count][$child_name] = $arrChild;
}
return $arr;

}

private function getResources($node){
//add 'resource' namespace children (mobilede uses this as language descriptors)
$count = 0;
$ns="resource";
$arr = array();
$children = $node->children($ns,TRUE);
foreach($children as $resource_name=>$resource_node){
//print_r($resource_node);
$arrResource = $this->sxe_to_array($resource_node,$ns);
$arr[$count][$resource_name]['value']=(string)$resource_node;
//echo((string)$resource_node);
//$arr[$count][$resource_name] = $arrResource;
$count +=1;
}
return $arr;
}

private function sxe_print_info(){
$sxe = $this->sxe;
$namespaces = $sxe->getNamespaces(true);
echo("<br>##########<br><strong>namespaces:</strong> <br>");
foreach($namespaces as $key=>$val){
//echo("$key : $val<br>");
}
echo("<br>Name: ".$sxe->getName()."<br>");
//Print Ads Info
$xpath='//ad:ad';
$result = $this->sxe->xpath($xpath);
//echo("Number of ads: ".count($result)."<br><br>");
$count = 0;
//ADs
foreach ($result as $ad) {
$count += 1;
echo("<strong>Ad $count </strong><br>");
$ad_children = $ad->children('ad',TRUE);
//AD 1st Gen Children
if(count($ad_children) > 0){
foreach ($ad_children as $ad_child_name=>$ad_child_node){
echo("<strong>Childname: $ad_child_name</strong><br>");
// ATTRIBUTES
foreach($ad_child_node->attributes() as $key=>$val){
echo("<strong>Attributes:</strong> ");
echo("$key=$val<br>");
echo("<strong>Children: </strong><br>");
// Ad 2nd Gen Children
foreach($ad_child_node->children() as $ad_child_name=>$child_node){
echo("Name: $child_name<br>");
}
}
}
}
//$adurl = $ad->{'detail-page'}->value->attributes()->url;
//echo('<a href="'.$adurl.'" target="_blank">Link</a><br>');
}
}

function register_namespaces(){
$this->arrNs = $this->sxe->getNamespaces(true);
foreach($this->arrNs as $prefix => $ns){
$this->sxe->registerXPathNamespace($prefix, $ns);
}
}

function fetch_xml_data_ctx($url){
// Erzeugen eines Streams
$headers = "Accept-language: de\r\n";
$headers .= "Accept: application/xml\r\n";
$headers .= "Authorization: Basic ".base64_encode("$this->user:$this->pw")."\r\n";
$opts = array(
'http'=>array(
'method'=>"GET",
'header'=> $headers

)
);
$context = stream_context_create($opts);
// Öffnen der Datei mit den oben definierten HTTP-Headern
$file = file_get_contents('https://'.$url, false, $context);
$simplexml=simplexml_load_string($file);
//print_r($file);

return $simplexml;

}

function send_json($arrJSON){
// Wir geben der Anfrage ein JSON Objekt-Literal zurück
$ajax_return_data = json_encode($arrJSON);
header('Cache-Control: no-cache, must-revalidate');
header('Pragma: no-cache');
header('Content-Length: '.strlen($ajax_return_data));
header('Content-Type: application/json; charset=UTF-8');
echo $ajax_return_data;
exit;
}

}
$mobile = new Mobile();
$mobile->main();
?>
</pre>

===XML from Scratch===
Zum Erzeugen von XML gibt es bessere Möglichkeiten aber es funktioniert auch mit SimpleXML:
<syntaxhighlight lang="php">
<?php
$newsXML = new SimpleXMLElement("<news></news>");
$newsXML->addAttribute('newsPagePrefix', 'value goes here');
$newsIntro = $newsXML->addChild('content');
$newsIntro->addAttribute('type', 'latest');
Header('Content-type: text/xml');
echo $newsXML->asXML();
?>
</syntaxhighlight>

XML erzeugen

2021-09-22T15:10:32Z

134.3.85.26: Die Seite wurde neu angelegt: „== Siehe auch == SimpleXML“

== Siehe auch ==
[[SimpleXML]]

SimpleXML

2021-09-22T15:09:10Z

134.3.85.26:

Terminal und Konsole auf dem Mac

2021-09-22T10:34:52Z

134.3.85.26: /* Datei ausführbar machen und ausführen */

Tips für die Arbeit mit dem Terminal

== Einleitung ==
Das Terminal ist ein Fenster mit dem man verschiedene Shells starten kann. Diese wiederum könnnen verschiedenste Befehle und Skripte ausführen.

Das Erscheinungsbild des Terminals kann man einfach Verbessern. Dazu kann man z.B. im Home-Directory die Dateien '''.bash_profile''' or '''.bashrc''' anpassen. Aber auch die '''.profile''' Datei Funktioniert. Je nachdem ob man die User Dateien oder die Globalen nimmt wird die Änderung global oder auf User-Ebene umgesetzt. Wenn die Dateien nicht vorhanden sind einfach hinzufügen.

== Quickstart ==
=== Skripte schreiben ===
https://support.apple.com/de-de/guide/terminal/apd53500956-7c5b-496b-a362-2845f2aab4bc/2.11/mac/11.0
=== Datei ausführbar machen und ausführen ===
cd YourScriptDirectory
Gib den Befehl chmod ein. Zum Beispiel:
chmod 755 YourScriptName.sh
# oder auch
chmod +x <fileName>

Nachdem du aus der Shell-Skript-Datei eine ausführbare Datei gemacht hast, kannst du diese durch Eingeben des Pfadnamens ausführen. Zum Beispiel:
% ~/Documents/deinPfad/<fileName>

oder
% cd ~/DeinPfad/Dev/
% ./<fileName>

Terminal und Konsole auf dem Mac

=== Befehle für die Shell / Shell-Skripte ===
Diese liegen i.d.R. in
/bin
/sbin
/usr/bin
/usr/sbin
wobei sbin superuser Befehle enthält. /bin und /sbin werden früh im Bootprozess geladen und enthalen dementsprechende Befehle. Die Ordner in /usr (unix system resources) Hier findest du über 1000 Kommandos. Generell gilt alles was der Finder kann, kannst du auch mit einem Skript erreichen. Der Finder ist im Prinzip auch ein Interpreter.

Weitere Befehle können z.b. in
/usr/local/bin
liegen. Der ist für Befehle vorgesehen, die nicht mit dem OS ausgeliefert werden.

== Links ==
=== zsh shell statt bash ab Catalina ===
https://support.apple.com/de-de/HT208050
== Prompt anpassen ==
Wie oben beschrieben z.B. in die .bash_profile datei
''Farbiges'' '''Prompt''' und Anzeige als: ''“username@hostname:cwd $”''
export PS1="\[\033[36m\]\u\[\033[m\]@\[\033[32m\]\h:\[\033[33;1m\]\w\[\033[m\]\$ "

== Farben auf Mac Terminal ==
export CLICOLOR=1
export LSCOLORS=GxFxCxDxBxegedabagaced

CLICOLOR=1 bedeutet Farbe anschalten
LSCOLORS= Farben für die anzeige im Listkommando
== Mac UNIX ==
Basiert auf UNIX

Apfel > Über diesen Mac > Software (da steht z.B. die kernel Version)

== Umgebungsvariablen, PATH Variable etc.==
siehe auch: http://wiki.zone30.info/wikizone/index.php/Linux_-_Umgebungsvariable

alle kriegt man mit
set | less
eine einzelne z.B. mit:
echo $PATH

==== PATH Variable anpassen ====
'''Hinzufügen''' eines Pfades für eine '''einzelne''' Terminal '''Session''':
PATH=MeinZusatzPfad:$PATH
export PATH
'''Exportieren''' ist wichtig wenn die neue Variable auch in '''Unterterminals''' zur Verfügung stehen soll (z.B. bei Bash Skripten)

=== Dauerhaft PATH Variable in der Bash setzen ===
Auf diese Weise stehen die PATH Variable '''bei jeder Sitzung''' zur Verfügung. Mac speichert die Bash Datei im Userverzeichnis.

Wir öffnen die bash_profile Datei im Standard Editor (wenn Sie nicht vorhanden ist wird Sie erzeugt).
touch ~/.bash_profile; open ~/.bash_profile
Jetzt können wir die Variable setzen. Hier ein Beispiel mit der Android ADT
export PATH=/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/platform-tools:/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/tools:$PATH

Durch das :$PATH am Ende wird der neue Wert zu den Standardwerten hinzugefügt oder hier besser vorangestellt)

Jetzt noch die Datei abspeichern und ausführen:

source ~/.bash_profile
== Umfangreiches .bash_profile Beispiel ==
Quelle: http://natelandau.com/my-mac-osx-bash_profile/ (2015-10)
<syntaxhighlight lang="bash">
# ---------------------------------------------------------------------------
#
# Description: This file holds all my BASH configurations and aliases
#
# Sections:
# 1. Environment Configuration
# 2. Make Terminal Better (remapping defaults and adding functionality)
# 3. File and Folder Management
# 4. Searching
# 5. Process Management
# 6. Networking
# 7. System Operations & Information
# 8. Web Development
# 9. Reminders & Notes
#
# ---------------------------------------------------------------------------

# -------------------------------
# 1. ENVIRONMENT CONFIGURATION
# -------------------------------

# Change Prompt
# ------------------------------------------------------------
export PS1="________________________________________________________________________________\n| \w @ \h (\u) \n| => "
export PS2="| => "

# Set Paths
# ------------------------------------------------------------
export PATH="$PATH:/usr/local/bin/"
export PATH="/usr/local/git/bin:/sw/bin/:/usr/local/bin:/usr/local/:/usr/local/sbin:/usr/local/mysql/bin:$PATH"

# Set Default Editor (change 'Nano' to the editor of your choice)
# ------------------------------------------------------------
export EDITOR=/usr/bin/nano

# Set default blocksize for ls, df, du
# from this: http://hints.macworld.com/comment.php?mode=view&cid=24491
# ------------------------------------------------------------
export BLOCKSIZE=1k

# Add color to terminal
# (this is all commented out as I use Mac Terminal Profiles)
# from http://osxdaily.com/2012/02/21/add-color-to-the-terminal-in-mac-os-x/
# ------------------------------------------------------------
# export CLICOLOR=1
# export LSCOLORS=ExFxBxDxCxegedabagacad

# -----------------------------
# 2. MAKE TERMINAL BETTER
# -----------------------------

alias cp='cp -iv' # Preferred 'cp' implementation
alias mv='mv -iv' # Preferred 'mv' implementation
alias mkdir='mkdir -pv' # Preferred 'mkdir' implementation
alias ll='ls -FGlAhp' # Preferred 'ls' implementation
alias less='less -FSRXc' # Preferred 'less' implementation
cd() { builtin cd "$@"; ll; } # Always list directory contents upon 'cd'
alias cd..='cd ../' # Go back 1 directory level (for fast typers)
alias ..='cd ../' # Go back 1 directory level
alias ...='cd ../../' # Go back 2 directory levels
alias .3='cd ../../../' # Go back 3 directory levels
alias .4='cd ../../../../' # Go back 4 directory levels
alias .5='cd ../../../../../' # Go back 5 directory levels
alias .6='cd ../../../../../../' # Go back 6 directory levels
alias edit='subl' # edit: Opens any file in sublime editor
alias f='open -a Finder ./' # f: Opens current directory in MacOS Finder
alias ~="cd ~" # ~: Go Home
alias c='clear' # c: Clear terminal display
alias which='type -all' # which: Find executables
alias path='echo -e ${PATH//:/\\n}' # path: Echo all executable Paths
alias show_options='shopt' # Show_options: display bash options settings
alias fix_stty='stty sane' # fix_stty: Restore terminal settings when screwed up
alias cic='set completion-ignore-case On' # cic: Make tab-completion case-insensitive
mcd () { mkdir -p "$1" && cd "$1"; } # mcd: Makes new Dir and jumps inside
trash () { command mv "$@" ~/.Trash ; } # trash: Moves a file to the MacOS trash
ql () { qlmanage -p "$*" >& /dev/null; } # ql: Opens any file in MacOS Quicklook Preview
alias DT='tee ~/Desktop/terminalOut.txt' # DT: Pipe content to file on MacOS Desktop

# lr: Full Recursive Directory Listing
# ------------------------------------------
alias lr='ls -R | grep ":$" | sed -e '\''s/:$//'\'' -e '\''s/[^-][^\/]*\//--/g'\'' -e '\''s/^/ /'\'' -e '\''s/-/|/'\'' | less'

# mans: Search manpage given in agument '1' for term given in argument '2' (case insensitive)
# displays paginated result with colored search terms and two lines surrounding each hit. Example: mans mplayer codec
# --------------------------------------------------------------------
mans () {
man $1 | grep -iC2 --color=always $2 | less
}

# showa: to remind yourself of an alias (given some part of it)
# ------------------------------------------------------------
showa () { /usr/bin/grep --color=always -i -a1 $@ ~/Library/init/bash/aliases.bash | grep -v '^\s*$' | less -FSRXc ; }

# -------------------------------
# 3. FILE AND FOLDER MANAGEMENT
# -------------------------------

zipf () { zip -r "$1".zip "$1" ; } # zipf: To create a ZIP archive of a folder
alias numFiles='echo $(ls -1 | wc -l)' # numFiles: Count of non-hidden files in current dir
alias make1mb='mkfile 1m ./1MB.dat' # make1mb: Creates a file of 1mb size (all zeros)
alias make5mb='mkfile 5m ./5MB.dat' # make5mb: Creates a file of 5mb size (all zeros)
alias make10mb='mkfile 10m ./10MB.dat' # make10mb: Creates a file of 10mb size (all zeros)

# cdf: 'Cd's to frontmost window of MacOS Finder
# ------------------------------------------------------
cdf () {
currFolderPath=$( /usr/bin/osascript <<EOT
tell application "Finder"
try
set currFolder to (folder of the front window as alias)
on error
set currFolder to (path to desktop folder as alias)
end try
POSIX path of currFolder
end tell
EOT
)
echo "cd to \"$currFolderPath\""
cd "$currFolderPath"
}

# extract: Extract most know archives with one command
# ---------------------------------------------------------
extract () {
if [ -f $1 ] ; then
case $1 in
*.tar.bz2) tar xjf $1 ;;
*.tar.gz) tar xzf $1 ;;
*.bz2) bunzip2 $1 ;;
*.rar) unrar e $1 ;;
*.gz) gunzip $1 ;;
*.tar) tar xf $1 ;;
*.tbz2) tar xjf $1 ;;
*.tgz) tar xzf $1 ;;
*.zip) unzip $1 ;;
*.Z) uncompress $1 ;;
*.7z) 7z x $1 ;;
*) echo "'$1' cannot be extracted via extract()" ;;
esac
else
echo "'$1' is not a valid file"
fi
}

# ---------------------------
# 4. SEARCHING
# ---------------------------

alias qfind="find . -name " # qfind: Quickly search for file
ff () { /usr/bin/find . -name "$@" ; } # ff: Find file under the current directory
ffs () { /usr/bin/find . -name "$@"'*' ; } # ffs: Find file whose name starts with a given string
ffe () { /usr/bin/find . -name '*'"$@" ; } # ffe: Find file whose name ends with a given string

# spotlight: Search for a file using MacOS Spotlight's metadata
# -----------------------------------------------------------
spotlight () { mdfind "kMDItemDisplayName == '$@'wc"; }

# ---------------------------
# 5. PROCESS MANAGEMENT
# ---------------------------

# findPid: find out the pid of a specified process
# -----------------------------------------------------
# Note that the command name can be specified via a regex
# E.g. findPid '/d$/' finds pids of all processes with names ending in 'd'
# Without the 'sudo' it will only find processes of the current user
# -----------------------------------------------------
findPid () { lsof -t -c "$@" ; }

# memHogsTop, memHogsPs: Find memory hogs
# -----------------------------------------------------
alias memHogsTop='top -l 1 -o rsize | head -20'
alias memHogsPs='ps wwaxm -o pid,stat,vsize,rss,time,command | head -10'

# cpuHogs: Find CPU hogs
# -----------------------------------------------------
alias cpu_hogs='ps wwaxr -o pid,stat,%cpu,time,command | head -10'

# topForever: Continual 'top' listing (every 10 seconds)
# -----------------------------------------------------
alias topForever='top -l 9999999 -s 10 -o cpu'

# ttop: Recommended 'top' invocation to minimize resources
# ------------------------------------------------------------
# Taken from this macosxhints article
# http://www.macosxhints.com/article.php?story=20060816123853639
# ------------------------------------------------------------
alias ttop="top -R -F -s 10 -o rsize"

# my_ps: List processes owned by my user:
# ------------------------------------------------------------
my_ps() { ps $@ -u $USER -o pid,%cpu,%mem,start,time,bsdtime,command ; }

# ---------------------------
# 6. NETWORKING
# ---------------------------

alias myip='curl ip.appspot.com' # myip: Public facing IP Address
alias netCons='lsof -i' # netCons: Show all open TCP/IP sockets
alias flushDNS='dscacheutil -flushcache' # flushDNS: Flush out the DNS Cache
alias lsock='sudo /usr/sbin/lsof -i -P' # lsock: Display open sockets
alias lsockU='sudo /usr/sbin/lsof -nP | grep UDP' # lsockU: Display only open UDP sockets
alias lsockT='sudo /usr/sbin/lsof -nP | grep TCP' # lsockT: Display only open TCP sockets
alias ipInfo0='ipconfig getpacket en0' # ipInfo0: Get info on connections for en0
alias ipInfo1='ipconfig getpacket en1' # ipInfo1: Get info on connections for en1
alias openPorts='sudo lsof -i | grep LISTEN' # openPorts: All listening connections
alias showBlocked='sudo ipfw list' # showBlocked: All ipfw rules inc/ blocked IPs

# ii: display useful host related informaton
# -------------------------------------------------------------------
ii() {
echo -e "\nYou are logged on ${RED}$HOST"
echo -e "\nAdditionnal information:$NC " ; uname -a
echo -e "\n${RED}Users logged on:$NC " ; w -h
echo -e "\n${RED}Current date :$NC " ; date
echo -e "\n${RED}Machine stats :$NC " ; uptime
echo -e "\n${RED}Current network location :$NC " ; scselect
echo -e "\n${RED}Public facing IP Address :$NC " ;myip
#echo -e "\n${RED}DNS Configuration:$NC " ; scutil --dns
echo
}

# ---------------------------------------
# 7. SYSTEMS OPERATIONS & INFORMATION
# ---------------------------------------

alias mountReadWrite='/sbin/mount -uw /' # mountReadWrite: For use when booted into single-user

# cleanupDS: Recursively delete .DS_Store files
# -------------------------------------------------------------------
alias cleanupDS="find . -type f -name '*.DS_Store' -ls -delete"

# finderShowHidden: Show hidden files in Finder
# finderHideHidden: Hide hidden files in Finder
# -------------------------------------------------------------------
alias finderShowHidden='defaults write com.apple.finder ShowAllFiles TRUE'
alias finderHideHidden='defaults write com.apple.finder ShowAllFiles FALSE'

# cleanupLS: Clean up LaunchServices to remove duplicates in the "Open With" menu
# -----------------------------------------------------------------------------------
alias cleanupLS="/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user && killall Finder"

# screensaverDesktop: Run a screensaver on the Desktop
# -----------------------------------------------------------------------------------
alias screensaverDesktop='/System/Library/Frameworks/ScreenSaver.framework/Resources/ScreenSaverEngine.app/Contents/MacOS/ScreenSaverEngine -background'

# ---------------------------------------
# 8. WEB DEVELOPMENT
# ---------------------------------------

alias apacheEdit='sudo edit /etc/httpd/httpd.conf' # apacheEdit: Edit httpd.conf
alias apacheRestart='sudo apachectl graceful' # apacheRestart: Restart Apache
alias editHosts='sudo edit /etc/hosts' # editHosts: Edit /etc/hosts file
alias herr='tail /var/log/httpd/error_log' # herr: Tails HTTP error logs
alias apacheLogs="less +F /var/log/apache2/error_log" # Apachelogs: Shows apache error logs
httpHeaders () { /usr/bin/curl -I -L $@ ; } # httpHeaders: Grabs headers from web page

# httpDebug: Download a web page and show info on what took time
# -------------------------------------------------------------------
httpDebug () { /usr/bin/curl $@ -o /dev/null -w "dns: %{time_namelookup} connect: %{time_connect} pretransfer: %{time_pretransfer} starttransfer: %{time_starttransfer} total: %{time_total}\n" ; }

# ---------------------------------------
# 9. REMINDERS & NOTES
# ---------------------------------------

# remove_disk: spin down unneeded disk
# ---------------------------------------
# diskutil eject /dev/disk1s3

# to change the password on an encrypted disk image:
# ---------------------------------------
# hdiutil chpass /path/to/the/diskimage

# to mount a read-only disk image as read-write:
# ---------------------------------------
# hdiutil attach example.dmg -shadow /tmp/example.shadow -noverify

# mounting a removable drive (of type msdos or hfs)
# ---------------------------------------
# mkdir /Volumes/Foo
# ls /dev/disk* to find out the device to use in the mount command)
# mount -t msdos /dev/disk1s1 /Volumes/Foo
# mount -t hfs /dev/disk1s1 /Volumes/Foo

# to create a file of a given size: /usr/sbin/mkfile or /usr/bin/hdiutil
# ---------------------------------------
# e.g.: mkfile 10m 10MB.dat
# e.g.: hdiutil create -size 10m 10MB.dmg
# the above create files that are almost all zeros - if random bytes are desired
# then use: ~/Dev/Perl/randBytes 1048576 > 10MB.dat
</syntaxhighlight>

== Tipps und Tricks ==
=== Mit Terminal auf externe Festplatte zugreifen ===
/Volumes
=== Dateien kopieren, bewegen, umbenennen ===
https://www.macworld.com/article/222558/macos-command-line-copying-moving-files-terminal.html

cp source.txt target.txt
cp -R sourceFolder/ /Volumes/backupDrive/myBackupFolder

Mac Terminal Tipps

2021-09-22T10:32:31Z

134.3.85.26:

siehe auch
[[Linux]]
[[Terminal und Konsole auf dem Mac]]
== Finder zeigt alle Dateien und Ordner an ==
defaults write com.apple.Finder AppleShowAllFiles YES
danach Finder neu starten, damit die Änderungen sichtbar werden:
killall Finder

== Sendmail aktivieren ==
Macintosh HD -> etc -> hostconfig
MAILSERVER=-YES-
=== Für php mail() Befehl ===
php.ini
sendmail_path = /usr/sbin/sendmail -t -i

== Netzlaufwerke finden ==
Netzlaufwerke sind (wenn sie gemounted sind unter
cd /Volumes

erreichbar

Du kannst Dir die gemounteten Disks im Terminal mit
diskutil list
ansehen, dort steht dann der "Diskname" z. B.
/dev/disk0
sowie die Partitionsnamen.

In der mittleren Spalte ist dann auch der Mountname angegeben.
Eingeblendet werden die Disks über das Verzeichnis
/Volumes
Hier gilt: das "V" wird groß geschrieben!

Dort existieren Unterverzeichnisse mit den Namen der Disks. Z.B.:
/Volumes/martin/
/Volumes/files/

Anmerkung Steff: diskutil list scheint nicht ohne weiteres mit Netzlaufwerken zu funktionieren

Terminal und Konsole auf dem Mac

2021-09-20T16:51:58Z

134.3.85.26: /* Quickstart */

Tips für die Arbeit mit dem Terminal

== Einleitung ==
Das Terminal ist ein Fenster mit dem man verschiedene Shells starten kann. Diese wiederum könnnen verschiedenste Befehle und Skripte ausführen.

Das Erscheinungsbild des Terminals kann man einfach Verbessern. Dazu kann man z.B. im Home-Directory die Dateien '''.bash_profile''' or '''.bashrc''' anpassen. Aber auch die '''.profile''' Datei Funktioniert. Je nachdem ob man die User Dateien oder die Globalen nimmt wird die Änderung global oder auf User-Ebene umgesetzt. Wenn die Dateien nicht vorhanden sind einfach hinzufügen.

== Quickstart ==
=== Skripte schreiben ===
https://support.apple.com/de-de/guide/terminal/apd53500956-7c5b-496b-a362-2845f2aab4bc/2.11/mac/11.0
=== Datei ausführbar machen und ausführen ===
cd YourScriptDirectory
Gib den Befehl chmod ein. Zum Beispiel:
% chmod 755 YourScriptName.sh

Nachdem du aus der Shell-Skript-Datei eine ausführbare Datei gemacht hast, kannst du diese durch Eingeben des Pfadnamens ausführen. Zum Beispiel:
% ~/Documents/Dev/YourScriptName.sh

oder
% cd ~/Documents/Dev/
% ./YourScriptName.sh

=== Befehle für die Shell / Shell-Skripte ===
Diese liegen i.d.R. in
/bin
/sbin
/usr/bin
/usr/sbin
wobei sbin superuser Befehle enthält. /bin und /sbin werden früh im Bootprozess geladen und enthalen dementsprechende Befehle. Die Ordner in /usr (unix system resources) Hier findest du über 1000 Kommandos. Generell gilt alles was der Finder kann, kannst du auch mit einem Skript erreichen. Der Finder ist im Prinzip auch ein Interpreter.

Weitere Befehle können z.b. in
/usr/local/bin
liegen. Der ist für Befehle vorgesehen, die nicht mit dem OS ausgeliefert werden.

== Links ==
=== zsh shell statt bash ab Catalina ===
https://support.apple.com/de-de/HT208050
== Prompt anpassen ==
Wie oben beschrieben z.B. in die .bash_profile datei
''Farbiges'' '''Prompt''' und Anzeige als: ''“username@hostname:cwd $”''
export PS1="\[\033[36m\]\u\[\033[m\]@\[\033[32m\]\h:\[\033[33;1m\]\w\[\033[m\]\$ "

== Farben auf Mac Terminal ==
export CLICOLOR=1
export LSCOLORS=GxFxCxDxBxegedabagaced

CLICOLOR=1 bedeutet Farbe anschalten
LSCOLORS= Farben für die anzeige im Listkommando
== Mac UNIX ==
Basiert auf UNIX

Apfel > Über diesen Mac > Software (da steht z.B. die kernel Version)

== Umgebungsvariablen, PATH Variable etc.==
siehe auch: http://wiki.zone30.info/wikizone/index.php/Linux_-_Umgebungsvariable

alle kriegt man mit
set | less
eine einzelne z.B. mit:
echo $PATH

==== PATH Variable anpassen ====
'''Hinzufügen''' eines Pfades für eine '''einzelne''' Terminal '''Session''':
PATH=MeinZusatzPfad:$PATH
export PATH
'''Exportieren''' ist wichtig wenn die neue Variable auch in '''Unterterminals''' zur Verfügung stehen soll (z.B. bei Bash Skripten)

=== Dauerhaft PATH Variable in der Bash setzen ===
Auf diese Weise stehen die PATH Variable '''bei jeder Sitzung''' zur Verfügung. Mac speichert die Bash Datei im Userverzeichnis.

Wir öffnen die bash_profile Datei im Standard Editor (wenn Sie nicht vorhanden ist wird Sie erzeugt).
touch ~/.bash_profile; open ~/.bash_profile
Jetzt können wir die Variable setzen. Hier ein Beispiel mit der Android ADT
export PATH=/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/platform-tools:/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/tools:$PATH

Durch das :$PATH am Ende wird der neue Wert zu den Standardwerten hinzugefügt oder hier besser vorangestellt)

Jetzt noch die Datei abspeichern und ausführen:

source ~/.bash_profile
== Umfangreiches .bash_profile Beispiel ==
Quelle: http://natelandau.com/my-mac-osx-bash_profile/ (2015-10)
<syntaxhighlight lang="bash">
# ---------------------------------------------------------------------------
#
# Description: This file holds all my BASH configurations and aliases
#
# Sections:
# 1. Environment Configuration
# 2. Make Terminal Better (remapping defaults and adding functionality)
# 3. File and Folder Management
# 4. Searching
# 5. Process Management
# 6. Networking
# 7. System Operations & Information
# 8. Web Development
# 9. Reminders & Notes
#
# ---------------------------------------------------------------------------

# -------------------------------
# 1. ENVIRONMENT CONFIGURATION
# -------------------------------

# Change Prompt
# ------------------------------------------------------------
export PS1="________________________________________________________________________________\n| \w @ \h (\u) \n| => "
export PS2="| => "

# Set Paths
# ------------------------------------------------------------
export PATH="$PATH:/usr/local/bin/"
export PATH="/usr/local/git/bin:/sw/bin/:/usr/local/bin:/usr/local/:/usr/local/sbin:/usr/local/mysql/bin:$PATH"

# Set Default Editor (change 'Nano' to the editor of your choice)
# ------------------------------------------------------------
export EDITOR=/usr/bin/nano

# Set default blocksize for ls, df, du
# from this: http://hints.macworld.com/comment.php?mode=view&cid=24491
# ------------------------------------------------------------
export BLOCKSIZE=1k

# Add color to terminal
# (this is all commented out as I use Mac Terminal Profiles)
# from http://osxdaily.com/2012/02/21/add-color-to-the-terminal-in-mac-os-x/
# ------------------------------------------------------------
# export CLICOLOR=1
# export LSCOLORS=ExFxBxDxCxegedabagacad

# -----------------------------
# 2. MAKE TERMINAL BETTER
# -----------------------------

alias cp='cp -iv' # Preferred 'cp' implementation
alias mv='mv -iv' # Preferred 'mv' implementation
alias mkdir='mkdir -pv' # Preferred 'mkdir' implementation
alias ll='ls -FGlAhp' # Preferred 'ls' implementation
alias less='less -FSRXc' # Preferred 'less' implementation
cd() { builtin cd "$@"; ll; } # Always list directory contents upon 'cd'
alias cd..='cd ../' # Go back 1 directory level (for fast typers)
alias ..='cd ../' # Go back 1 directory level
alias ...='cd ../../' # Go back 2 directory levels
alias .3='cd ../../../' # Go back 3 directory levels
alias .4='cd ../../../../' # Go back 4 directory levels
alias .5='cd ../../../../../' # Go back 5 directory levels
alias .6='cd ../../../../../../' # Go back 6 directory levels
alias edit='subl' # edit: Opens any file in sublime editor
alias f='open -a Finder ./' # f: Opens current directory in MacOS Finder
alias ~="cd ~" # ~: Go Home
alias c='clear' # c: Clear terminal display
alias which='type -all' # which: Find executables
alias path='echo -e ${PATH//:/\\n}' # path: Echo all executable Paths
alias show_options='shopt' # Show_options: display bash options settings
alias fix_stty='stty sane' # fix_stty: Restore terminal settings when screwed up
alias cic='set completion-ignore-case On' # cic: Make tab-completion case-insensitive
mcd () { mkdir -p "$1" && cd "$1"; } # mcd: Makes new Dir and jumps inside
trash () { command mv "$@" ~/.Trash ; } # trash: Moves a file to the MacOS trash
ql () { qlmanage -p "$*" >& /dev/null; } # ql: Opens any file in MacOS Quicklook Preview
alias DT='tee ~/Desktop/terminalOut.txt' # DT: Pipe content to file on MacOS Desktop

# lr: Full Recursive Directory Listing
# ------------------------------------------
alias lr='ls -R | grep ":$" | sed -e '\''s/:$//'\'' -e '\''s/[^-][^\/]*\//--/g'\'' -e '\''s/^/ /'\'' -e '\''s/-/|/'\'' | less'

# mans: Search manpage given in agument '1' for term given in argument '2' (case insensitive)
# displays paginated result with colored search terms and two lines surrounding each hit. Example: mans mplayer codec
# --------------------------------------------------------------------
mans () {
man $1 | grep -iC2 --color=always $2 | less
}

# showa: to remind yourself of an alias (given some part of it)
# ------------------------------------------------------------
showa () { /usr/bin/grep --color=always -i -a1 $@ ~/Library/init/bash/aliases.bash | grep -v '^\s*$' | less -FSRXc ; }

# -------------------------------
# 3. FILE AND FOLDER MANAGEMENT
# -------------------------------

zipf () { zip -r "$1".zip "$1" ; } # zipf: To create a ZIP archive of a folder
alias numFiles='echo $(ls -1 | wc -l)' # numFiles: Count of non-hidden files in current dir
alias make1mb='mkfile 1m ./1MB.dat' # make1mb: Creates a file of 1mb size (all zeros)
alias make5mb='mkfile 5m ./5MB.dat' # make5mb: Creates a file of 5mb size (all zeros)
alias make10mb='mkfile 10m ./10MB.dat' # make10mb: Creates a file of 10mb size (all zeros)

# cdf: 'Cd's to frontmost window of MacOS Finder
# ------------------------------------------------------
cdf () {
currFolderPath=$( /usr/bin/osascript <<EOT
tell application "Finder"
try
set currFolder to (folder of the front window as alias)
on error
set currFolder to (path to desktop folder as alias)
end try
POSIX path of currFolder
end tell
EOT
)
echo "cd to \"$currFolderPath\""
cd "$currFolderPath"
}

# extract: Extract most know archives with one command
# ---------------------------------------------------------
extract () {
if [ -f $1 ] ; then
case $1 in
*.tar.bz2) tar xjf $1 ;;
*.tar.gz) tar xzf $1 ;;
*.bz2) bunzip2 $1 ;;
*.rar) unrar e $1 ;;
*.gz) gunzip $1 ;;
*.tar) tar xf $1 ;;
*.tbz2) tar xjf $1 ;;
*.tgz) tar xzf $1 ;;
*.zip) unzip $1 ;;
*.Z) uncompress $1 ;;
*.7z) 7z x $1 ;;
*) echo "'$1' cannot be extracted via extract()" ;;
esac
else
echo "'$1' is not a valid file"
fi
}

# ---------------------------
# 4. SEARCHING
# ---------------------------

alias qfind="find . -name " # qfind: Quickly search for file
ff () { /usr/bin/find . -name "$@" ; } # ff: Find file under the current directory
ffs () { /usr/bin/find . -name "$@"'*' ; } # ffs: Find file whose name starts with a given string
ffe () { /usr/bin/find . -name '*'"$@" ; } # ffe: Find file whose name ends with a given string

# spotlight: Search for a file using MacOS Spotlight's metadata
# -----------------------------------------------------------
spotlight () { mdfind "kMDItemDisplayName == '$@'wc"; }

# ---------------------------
# 5. PROCESS MANAGEMENT
# ---------------------------

# findPid: find out the pid of a specified process
# -----------------------------------------------------
# Note that the command name can be specified via a regex
# E.g. findPid '/d$/' finds pids of all processes with names ending in 'd'
# Without the 'sudo' it will only find processes of the current user
# -----------------------------------------------------
findPid () { lsof -t -c "$@" ; }

# memHogsTop, memHogsPs: Find memory hogs
# -----------------------------------------------------
alias memHogsTop='top -l 1 -o rsize | head -20'
alias memHogsPs='ps wwaxm -o pid,stat,vsize,rss,time,command | head -10'

# cpuHogs: Find CPU hogs
# -----------------------------------------------------
alias cpu_hogs='ps wwaxr -o pid,stat,%cpu,time,command | head -10'

# topForever: Continual 'top' listing (every 10 seconds)
# -----------------------------------------------------
alias topForever='top -l 9999999 -s 10 -o cpu'

# ttop: Recommended 'top' invocation to minimize resources
# ------------------------------------------------------------
# Taken from this macosxhints article
# http://www.macosxhints.com/article.php?story=20060816123853639
# ------------------------------------------------------------
alias ttop="top -R -F -s 10 -o rsize"

# my_ps: List processes owned by my user:
# ------------------------------------------------------------
my_ps() { ps $@ -u $USER -o pid,%cpu,%mem,start,time,bsdtime,command ; }

# ---------------------------
# 6. NETWORKING
# ---------------------------

alias myip='curl ip.appspot.com' # myip: Public facing IP Address
alias netCons='lsof -i' # netCons: Show all open TCP/IP sockets
alias flushDNS='dscacheutil -flushcache' # flushDNS: Flush out the DNS Cache
alias lsock='sudo /usr/sbin/lsof -i -P' # lsock: Display open sockets
alias lsockU='sudo /usr/sbin/lsof -nP | grep UDP' # lsockU: Display only open UDP sockets
alias lsockT='sudo /usr/sbin/lsof -nP | grep TCP' # lsockT: Display only open TCP sockets
alias ipInfo0='ipconfig getpacket en0' # ipInfo0: Get info on connections for en0
alias ipInfo1='ipconfig getpacket en1' # ipInfo1: Get info on connections for en1
alias openPorts='sudo lsof -i | grep LISTEN' # openPorts: All listening connections
alias showBlocked='sudo ipfw list' # showBlocked: All ipfw rules inc/ blocked IPs

# ii: display useful host related informaton
# -------------------------------------------------------------------
ii() {
echo -e "\nYou are logged on ${RED}$HOST"
echo -e "\nAdditionnal information:$NC " ; uname -a
echo -e "\n${RED}Users logged on:$NC " ; w -h
echo -e "\n${RED}Current date :$NC " ; date
echo -e "\n${RED}Machine stats :$NC " ; uptime
echo -e "\n${RED}Current network location :$NC " ; scselect
echo -e "\n${RED}Public facing IP Address :$NC " ;myip
#echo -e "\n${RED}DNS Configuration:$NC " ; scutil --dns
echo
}

# ---------------------------------------
# 7. SYSTEMS OPERATIONS & INFORMATION
# ---------------------------------------

alias mountReadWrite='/sbin/mount -uw /' # mountReadWrite: For use when booted into single-user

# cleanupDS: Recursively delete .DS_Store files
# -------------------------------------------------------------------
alias cleanupDS="find . -type f -name '*.DS_Store' -ls -delete"

# finderShowHidden: Show hidden files in Finder
# finderHideHidden: Hide hidden files in Finder
# -------------------------------------------------------------------
alias finderShowHidden='defaults write com.apple.finder ShowAllFiles TRUE'
alias finderHideHidden='defaults write com.apple.finder ShowAllFiles FALSE'

# cleanupLS: Clean up LaunchServices to remove duplicates in the "Open With" menu
# -----------------------------------------------------------------------------------
alias cleanupLS="/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user && killall Finder"

# screensaverDesktop: Run a screensaver on the Desktop
# -----------------------------------------------------------------------------------
alias screensaverDesktop='/System/Library/Frameworks/ScreenSaver.framework/Resources/ScreenSaverEngine.app/Contents/MacOS/ScreenSaverEngine -background'

# ---------------------------------------
# 8. WEB DEVELOPMENT
# ---------------------------------------

alias apacheEdit='sudo edit /etc/httpd/httpd.conf' # apacheEdit: Edit httpd.conf
alias apacheRestart='sudo apachectl graceful' # apacheRestart: Restart Apache
alias editHosts='sudo edit /etc/hosts' # editHosts: Edit /etc/hosts file
alias herr='tail /var/log/httpd/error_log' # herr: Tails HTTP error logs
alias apacheLogs="less +F /var/log/apache2/error_log" # Apachelogs: Shows apache error logs
httpHeaders () { /usr/bin/curl -I -L $@ ; } # httpHeaders: Grabs headers from web page

# httpDebug: Download a web page and show info on what took time
# -------------------------------------------------------------------
httpDebug () { /usr/bin/curl $@ -o /dev/null -w "dns: %{time_namelookup} connect: %{time_connect} pretransfer: %{time_pretransfer} starttransfer: %{time_starttransfer} total: %{time_total}\n" ; }

# ---------------------------------------
# 9. REMINDERS & NOTES
# ---------------------------------------

# remove_disk: spin down unneeded disk
# ---------------------------------------
# diskutil eject /dev/disk1s3

# to change the password on an encrypted disk image:
# ---------------------------------------
# hdiutil chpass /path/to/the/diskimage

# to mount a read-only disk image as read-write:
# ---------------------------------------
# hdiutil attach example.dmg -shadow /tmp/example.shadow -noverify

# mounting a removable drive (of type msdos or hfs)
# ---------------------------------------
# mkdir /Volumes/Foo
# ls /dev/disk* to find out the device to use in the mount command)
# mount -t msdos /dev/disk1s1 /Volumes/Foo
# mount -t hfs /dev/disk1s1 /Volumes/Foo

# to create a file of a given size: /usr/sbin/mkfile or /usr/bin/hdiutil
# ---------------------------------------
# e.g.: mkfile 10m 10MB.dat
# e.g.: hdiutil create -size 10m 10MB.dmg
# the above create files that are almost all zeros - if random bytes are desired
# then use: ~/Dev/Perl/randBytes 1048576 > 10MB.dat
</syntaxhighlight>

== Tipps und Tricks ==
=== Mit Terminal auf externe Festplatte zugreifen ===
/Volumes
=== Dateien kopieren, bewegen, umbenennen ===
https://www.macworld.com/article/222558/macos-command-line-copying-moving-files-terminal.html

cp source.txt target.txt
cp -R sourceFolder/ /Volumes/backupDrive/myBackupFolder

Terminal und Konsole auf dem Mac

2021-09-20T16:49:02Z

134.3.85.26:

Tips für die Arbeit mit dem Terminal

== Einleitung ==
Das Terminal ist ein Fenster mit dem man verschiedene Shells starten kann. Diese wiederum könnnen verschiedenste Befehle und Skripte ausführen.

Das Erscheinungsbild des Terminals kann man einfach Verbessern. Dazu kann man z.B. im Home-Directory die Dateien '''.bash_profile''' or '''.bashrc''' anpassen. Aber auch die '''.profile''' Datei Funktioniert. Je nachdem ob man die User Dateien oder die Globalen nimmt wird die Änderung global oder auf User-Ebene umgesetzt. Wenn die Dateien nicht vorhanden sind einfach hinzufügen.

== Quickstart ==
=== Skripte schreiben ===
https://support.apple.com/de-de/guide/terminal/apd53500956-7c5b-496b-a362-2845f2aab4bc/2.11/mac/11.0
=== Datei ausführbar machen und ausführen ===
cd YourScriptDirectory
Gib den Befehl chmod ein. Zum Beispiel:
% chmod 755 YourScriptName.sh

Nachdem du aus der Shell-Skript-Datei eine ausführbare Datei gemacht hast, kannst du diese durch Eingeben des Pfadnamens ausführen. Zum Beispiel:
% ~/Documents/Dev/YourScriptName.sh

oder
% cd ~/Documents/Dev/
% ./YourScriptName.sh

=== Befehle für die Shell / Shell-Skripte ===
Diese lieten i.d.R. in
/bin
/sbin
/usr/bin
/usr/sbin
wobei sbin superuser Befehle enthält. /bin und /sbin werden früh im Bootprozess geladen und enthalen dementsprechende Befehle. Die Ordner in /usr (unix system resources) Hier findest du tausende von Kommandos.

== Links ==
=== zsh shell statt bash ab Catalina ===
https://support.apple.com/de-de/HT208050
== Prompt anpassen ==
Wie oben beschrieben z.B. in die .bash_profile datei
''Farbiges'' '''Prompt''' und Anzeige als: ''“username@hostname:cwd $”''
export PS1="\[\033[36m\]\u\[\033[m\]@\[\033[32m\]\h:\[\033[33;1m\]\w\[\033[m\]\$ "

== Farben auf Mac Terminal ==
export CLICOLOR=1
export LSCOLORS=GxFxCxDxBxegedabagaced

CLICOLOR=1 bedeutet Farbe anschalten
LSCOLORS= Farben für die anzeige im Listkommando
== Mac UNIX ==
Basiert auf UNIX

Apfel > Über diesen Mac > Software (da steht z.B. die kernel Version)

== Umgebungsvariablen, PATH Variable etc.==
siehe auch: http://wiki.zone30.info/wikizone/index.php/Linux_-_Umgebungsvariable

alle kriegt man mit
set | less
eine einzelne z.B. mit:
echo $PATH

==== PATH Variable anpassen ====
'''Hinzufügen''' eines Pfades für eine '''einzelne''' Terminal '''Session''':
PATH=MeinZusatzPfad:$PATH
export PATH
'''Exportieren''' ist wichtig wenn die neue Variable auch in '''Unterterminals''' zur Verfügung stehen soll (z.B. bei Bash Skripten)

=== Dauerhaft PATH Variable in der Bash setzen ===
Auf diese Weise stehen die PATH Variable '''bei jeder Sitzung''' zur Verfügung. Mac speichert die Bash Datei im Userverzeichnis.

Wir öffnen die bash_profile Datei im Standard Editor (wenn Sie nicht vorhanden ist wird Sie erzeugt).
touch ~/.bash_profile; open ~/.bash_profile
Jetzt können wir die Variable setzen. Hier ein Beispiel mit der Android ADT
export PATH=/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/platform-tools:/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/tools:$PATH

Durch das :$PATH am Ende wird der neue Wert zu den Standardwerten hinzugefügt oder hier besser vorangestellt)

Jetzt noch die Datei abspeichern und ausführen:

source ~/.bash_profile
== Umfangreiches .bash_profile Beispiel ==
Quelle: http://natelandau.com/my-mac-osx-bash_profile/ (2015-10)
<syntaxhighlight lang="bash">
# ---------------------------------------------------------------------------
#
# Description: This file holds all my BASH configurations and aliases
#
# Sections:
# 1. Environment Configuration
# 2. Make Terminal Better (remapping defaults and adding functionality)
# 3. File and Folder Management
# 4. Searching
# 5. Process Management
# 6. Networking
# 7. System Operations & Information
# 8. Web Development
# 9. Reminders & Notes
#
# ---------------------------------------------------------------------------

# -------------------------------
# 1. ENVIRONMENT CONFIGURATION
# -------------------------------

# Change Prompt
# ------------------------------------------------------------
export PS1="________________________________________________________________________________\n| \w @ \h (\u) \n| => "
export PS2="| => "

# Set Paths
# ------------------------------------------------------------
export PATH="$PATH:/usr/local/bin/"
export PATH="/usr/local/git/bin:/sw/bin/:/usr/local/bin:/usr/local/:/usr/local/sbin:/usr/local/mysql/bin:$PATH"

# Set Default Editor (change 'Nano' to the editor of your choice)
# ------------------------------------------------------------
export EDITOR=/usr/bin/nano

# Set default blocksize for ls, df, du
# from this: http://hints.macworld.com/comment.php?mode=view&cid=24491
# ------------------------------------------------------------
export BLOCKSIZE=1k

# Add color to terminal
# (this is all commented out as I use Mac Terminal Profiles)
# from http://osxdaily.com/2012/02/21/add-color-to-the-terminal-in-mac-os-x/
# ------------------------------------------------------------
# export CLICOLOR=1
# export LSCOLORS=ExFxBxDxCxegedabagacad

# -----------------------------
# 2. MAKE TERMINAL BETTER
# -----------------------------

alias cp='cp -iv' # Preferred 'cp' implementation
alias mv='mv -iv' # Preferred 'mv' implementation
alias mkdir='mkdir -pv' # Preferred 'mkdir' implementation
alias ll='ls -FGlAhp' # Preferred 'ls' implementation
alias less='less -FSRXc' # Preferred 'less' implementation
cd() { builtin cd "$@"; ll; } # Always list directory contents upon 'cd'
alias cd..='cd ../' # Go back 1 directory level (for fast typers)
alias ..='cd ../' # Go back 1 directory level
alias ...='cd ../../' # Go back 2 directory levels
alias .3='cd ../../../' # Go back 3 directory levels
alias .4='cd ../../../../' # Go back 4 directory levels
alias .5='cd ../../../../../' # Go back 5 directory levels
alias .6='cd ../../../../../../' # Go back 6 directory levels
alias edit='subl' # edit: Opens any file in sublime editor
alias f='open -a Finder ./' # f: Opens current directory in MacOS Finder
alias ~="cd ~" # ~: Go Home
alias c='clear' # c: Clear terminal display
alias which='type -all' # which: Find executables
alias path='echo -e ${PATH//:/\\n}' # path: Echo all executable Paths
alias show_options='shopt' # Show_options: display bash options settings
alias fix_stty='stty sane' # fix_stty: Restore terminal settings when screwed up
alias cic='set completion-ignore-case On' # cic: Make tab-completion case-insensitive
mcd () { mkdir -p "$1" && cd "$1"; } # mcd: Makes new Dir and jumps inside
trash () { command mv "$@" ~/.Trash ; } # trash: Moves a file to the MacOS trash
ql () { qlmanage -p "$*" >& /dev/null; } # ql: Opens any file in MacOS Quicklook Preview
alias DT='tee ~/Desktop/terminalOut.txt' # DT: Pipe content to file on MacOS Desktop

# lr: Full Recursive Directory Listing
# ------------------------------------------
alias lr='ls -R | grep ":$" | sed -e '\''s/:$//'\'' -e '\''s/[^-][^\/]*\//--/g'\'' -e '\''s/^/ /'\'' -e '\''s/-/|/'\'' | less'

# mans: Search manpage given in agument '1' for term given in argument '2' (case insensitive)
# displays paginated result with colored search terms and two lines surrounding each hit. Example: mans mplayer codec
# --------------------------------------------------------------------
mans () {
man $1 | grep -iC2 --color=always $2 | less
}

# showa: to remind yourself of an alias (given some part of it)
# ------------------------------------------------------------
showa () { /usr/bin/grep --color=always -i -a1 $@ ~/Library/init/bash/aliases.bash | grep -v '^\s*$' | less -FSRXc ; }

# -------------------------------
# 3. FILE AND FOLDER MANAGEMENT
# -------------------------------

zipf () { zip -r "$1".zip "$1" ; } # zipf: To create a ZIP archive of a folder
alias numFiles='echo $(ls -1 | wc -l)' # numFiles: Count of non-hidden files in current dir
alias make1mb='mkfile 1m ./1MB.dat' # make1mb: Creates a file of 1mb size (all zeros)
alias make5mb='mkfile 5m ./5MB.dat' # make5mb: Creates a file of 5mb size (all zeros)
alias make10mb='mkfile 10m ./10MB.dat' # make10mb: Creates a file of 10mb size (all zeros)

# cdf: 'Cd's to frontmost window of MacOS Finder
# ------------------------------------------------------
cdf () {
currFolderPath=$( /usr/bin/osascript <<EOT
tell application "Finder"
try
set currFolder to (folder of the front window as alias)
on error
set currFolder to (path to desktop folder as alias)
end try
POSIX path of currFolder
end tell
EOT
)
echo "cd to \"$currFolderPath\""
cd "$currFolderPath"
}

# extract: Extract most know archives with one command
# ---------------------------------------------------------
extract () {
if [ -f $1 ] ; then
case $1 in
*.tar.bz2) tar xjf $1 ;;
*.tar.gz) tar xzf $1 ;;
*.bz2) bunzip2 $1 ;;
*.rar) unrar e $1 ;;
*.gz) gunzip $1 ;;
*.tar) tar xf $1 ;;
*.tbz2) tar xjf $1 ;;
*.tgz) tar xzf $1 ;;
*.zip) unzip $1 ;;
*.Z) uncompress $1 ;;
*.7z) 7z x $1 ;;
*) echo "'$1' cannot be extracted via extract()" ;;
esac
else
echo "'$1' is not a valid file"
fi
}

# ---------------------------
# 4. SEARCHING
# ---------------------------

alias qfind="find . -name " # qfind: Quickly search for file
ff () { /usr/bin/find . -name "$@" ; } # ff: Find file under the current directory
ffs () { /usr/bin/find . -name "$@"'*' ; } # ffs: Find file whose name starts with a given string
ffe () { /usr/bin/find . -name '*'"$@" ; } # ffe: Find file whose name ends with a given string

# spotlight: Search for a file using MacOS Spotlight's metadata
# -----------------------------------------------------------
spotlight () { mdfind "kMDItemDisplayName == '$@'wc"; }

# ---------------------------
# 5. PROCESS MANAGEMENT
# ---------------------------

# findPid: find out the pid of a specified process
# -----------------------------------------------------
# Note that the command name can be specified via a regex
# E.g. findPid '/d$/' finds pids of all processes with names ending in 'd'
# Without the 'sudo' it will only find processes of the current user
# -----------------------------------------------------
findPid () { lsof -t -c "$@" ; }

# memHogsTop, memHogsPs: Find memory hogs
# -----------------------------------------------------
alias memHogsTop='top -l 1 -o rsize | head -20'
alias memHogsPs='ps wwaxm -o pid,stat,vsize,rss,time,command | head -10'

# cpuHogs: Find CPU hogs
# -----------------------------------------------------
alias cpu_hogs='ps wwaxr -o pid,stat,%cpu,time,command | head -10'

# topForever: Continual 'top' listing (every 10 seconds)
# -----------------------------------------------------
alias topForever='top -l 9999999 -s 10 -o cpu'

# ttop: Recommended 'top' invocation to minimize resources
# ------------------------------------------------------------
# Taken from this macosxhints article
# http://www.macosxhints.com/article.php?story=20060816123853639
# ------------------------------------------------------------
alias ttop="top -R -F -s 10 -o rsize"

# my_ps: List processes owned by my user:
# ------------------------------------------------------------
my_ps() { ps $@ -u $USER -o pid,%cpu,%mem,start,time,bsdtime,command ; }

# ---------------------------
# 6. NETWORKING
# ---------------------------

alias myip='curl ip.appspot.com' # myip: Public facing IP Address
alias netCons='lsof -i' # netCons: Show all open TCP/IP sockets
alias flushDNS='dscacheutil -flushcache' # flushDNS: Flush out the DNS Cache
alias lsock='sudo /usr/sbin/lsof -i -P' # lsock: Display open sockets
alias lsockU='sudo /usr/sbin/lsof -nP | grep UDP' # lsockU: Display only open UDP sockets
alias lsockT='sudo /usr/sbin/lsof -nP | grep TCP' # lsockT: Display only open TCP sockets
alias ipInfo0='ipconfig getpacket en0' # ipInfo0: Get info on connections for en0
alias ipInfo1='ipconfig getpacket en1' # ipInfo1: Get info on connections for en1
alias openPorts='sudo lsof -i | grep LISTEN' # openPorts: All listening connections
alias showBlocked='sudo ipfw list' # showBlocked: All ipfw rules inc/ blocked IPs

# ii: display useful host related informaton
# -------------------------------------------------------------------
ii() {
echo -e "\nYou are logged on ${RED}$HOST"
echo -e "\nAdditionnal information:$NC " ; uname -a
echo -e "\n${RED}Users logged on:$NC " ; w -h
echo -e "\n${RED}Current date :$NC " ; date
echo -e "\n${RED}Machine stats :$NC " ; uptime
echo -e "\n${RED}Current network location :$NC " ; scselect
echo -e "\n${RED}Public facing IP Address :$NC " ;myip
#echo -e "\n${RED}DNS Configuration:$NC " ; scutil --dns
echo
}

# ---------------------------------------
# 7. SYSTEMS OPERATIONS & INFORMATION
# ---------------------------------------

alias mountReadWrite='/sbin/mount -uw /' # mountReadWrite: For use when booted into single-user

# cleanupDS: Recursively delete .DS_Store files
# -------------------------------------------------------------------
alias cleanupDS="find . -type f -name '*.DS_Store' -ls -delete"

# finderShowHidden: Show hidden files in Finder
# finderHideHidden: Hide hidden files in Finder
# -------------------------------------------------------------------
alias finderShowHidden='defaults write com.apple.finder ShowAllFiles TRUE'
alias finderHideHidden='defaults write com.apple.finder ShowAllFiles FALSE'

# cleanupLS: Clean up LaunchServices to remove duplicates in the "Open With" menu
# -----------------------------------------------------------------------------------
alias cleanupLS="/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user && killall Finder"

# screensaverDesktop: Run a screensaver on the Desktop
# -----------------------------------------------------------------------------------
alias screensaverDesktop='/System/Library/Frameworks/ScreenSaver.framework/Resources/ScreenSaverEngine.app/Contents/MacOS/ScreenSaverEngine -background'

# ---------------------------------------
# 8. WEB DEVELOPMENT
# ---------------------------------------

alias apacheEdit='sudo edit /etc/httpd/httpd.conf' # apacheEdit: Edit httpd.conf
alias apacheRestart='sudo apachectl graceful' # apacheRestart: Restart Apache
alias editHosts='sudo edit /etc/hosts' # editHosts: Edit /etc/hosts file
alias herr='tail /var/log/httpd/error_log' # herr: Tails HTTP error logs
alias apacheLogs="less +F /var/log/apache2/error_log" # Apachelogs: Shows apache error logs
httpHeaders () { /usr/bin/curl -I -L $@ ; } # httpHeaders: Grabs headers from web page

# httpDebug: Download a web page and show info on what took time
# -------------------------------------------------------------------
httpDebug () { /usr/bin/curl $@ -o /dev/null -w "dns: %{time_namelookup} connect: %{time_connect} pretransfer: %{time_pretransfer} starttransfer: %{time_starttransfer} total: %{time_total}\n" ; }

# ---------------------------------------
# 9. REMINDERS & NOTES
# ---------------------------------------

# remove_disk: spin down unneeded disk
# ---------------------------------------
# diskutil eject /dev/disk1s3

# to change the password on an encrypted disk image:
# ---------------------------------------
# hdiutil chpass /path/to/the/diskimage

# to mount a read-only disk image as read-write:
# ---------------------------------------
# hdiutil attach example.dmg -shadow /tmp/example.shadow -noverify

# mounting a removable drive (of type msdos or hfs)
# ---------------------------------------
# mkdir /Volumes/Foo
# ls /dev/disk* to find out the device to use in the mount command)
# mount -t msdos /dev/disk1s1 /Volumes/Foo
# mount -t hfs /dev/disk1s1 /Volumes/Foo

# to create a file of a given size: /usr/sbin/mkfile or /usr/bin/hdiutil
# ---------------------------------------
# e.g.: mkfile 10m 10MB.dat
# e.g.: hdiutil create -size 10m 10MB.dmg
# the above create files that are almost all zeros - if random bytes are desired
# then use: ~/Dev/Perl/randBytes 1048576 > 10MB.dat
</syntaxhighlight>

== Tipps und Tricks ==
=== Mit Terminal auf externe Festplatte zugreifen ===
/Volumes
=== Dateien kopieren, bewegen, umbenennen ===
https://www.macworld.com/article/222558/macos-command-line-copying-moving-files-terminal.html

cp source.txt target.txt
cp -R sourceFolder/ /Volumes/backupDrive/myBackupFolder

Terminal und Konsole auf dem Mac

2021-09-20T16:20:26Z

134.3.85.26: /* Einleitung */

Tips für die Arbeit mit dem Terminal

== Einleitung ==
Das Erscheinungsbild des Terminals kann man einfach Verbessern. Dazu kann man z.B. im Home-Directory die Dateien '''.bash_profile''' or '''.bashrc''' anpassen. Aber auch die '''.profile''' Datei Funktioniert. Je nachdem ob man die User Dateien oder die Globalen nimmt wird die Änderung global oder auf User-Ebene umgesetzt. Wenn die Dateien nicht vorhanden sind einfach hinzufügen.

== Quickstart ==
=== Datei schreiben ===
https://support.apple.com/de-de/guide/terminal/apd53500956-7c5b-496b-a362-2845f2aab4bc/2.11/mac/11.0
=== Datei ausführbar machen und ausführen ===
cd YourScriptDirectory
Gib den Befehl chmod ein. Zum Beispiel:
% chmod 755 YourScriptName.sh

Nachdem du aus der Shell-Skript-Datei eine ausführbare Datei gemacht hast, kannst du diese durch Eingeben des Pfadnamens ausführen. Zum Beispiel:
% ~/Documents/Dev/YourScriptName.sh

oder
% cd ~/Documents/Dev/
% ./YourScriptName.sh

== Links ==
=== zsh shell statt bash ab Catalina ===
https://support.apple.com/de-de/HT208050
== Prompt anpassen ==
Wie oben beschrieben z.B. in die .bash_profile datei
''Farbiges'' '''Prompt''' und Anzeige als: ''“username@hostname:cwd $”''
export PS1="\[\033[36m\]\u\[\033[m\]@\[\033[32m\]\h:\[\033[33;1m\]\w\[\033[m\]\$ "

== Farben auf Mac Terminal ==
export CLICOLOR=1
export LSCOLORS=GxFxCxDxBxegedabagaced

CLICOLOR=1 bedeutet Farbe anschalten
LSCOLORS= Farben für die anzeige im Listkommando
== Mac UNIX ==
Basiert auf UNIX

Apfel > Über diesen Mac > Software (da steht z.B. die kernel Version)

== Umgebungsvariablen, PATH Variable etc.==
siehe auch: http://wiki.zone30.info/wikizone/index.php/Linux_-_Umgebungsvariable

alle kriegt man mit
set | less
eine einzelne z.B. mit:
echo $PATH

==== PATH Variable anpassen ====
'''Hinzufügen''' eines Pfades für eine '''einzelne''' Terminal '''Session''':
PATH=MeinZusatzPfad:$PATH
export PATH
'''Exportieren''' ist wichtig wenn die neue Variable auch in '''Unterterminals''' zur Verfügung stehen soll (z.B. bei Bash Skripten)

=== Dauerhaft PATH Variable in der Bash setzen ===
Auf diese Weise stehen die PATH Variable '''bei jeder Sitzung''' zur Verfügung. Mac speichert die Bash Datei im Userverzeichnis.

Wir öffnen die bash_profile Datei im Standard Editor (wenn Sie nicht vorhanden ist wird Sie erzeugt).
touch ~/.bash_profile; open ~/.bash_profile
Jetzt können wir die Variable setzen. Hier ein Beispiel mit der Android ADT
export PATH=/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/platform-tools:/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/tools:$PATH

Durch das :$PATH am Ende wird der neue Wert zu den Standardwerten hinzugefügt oder hier besser vorangestellt)

Jetzt noch die Datei abspeichern und ausführen:

source ~/.bash_profile
== Umfangreiches .bash_profile Beispiel ==
Quelle: http://natelandau.com/my-mac-osx-bash_profile/ (2015-10)
<syntaxhighlight lang="bash">
# ---------------------------------------------------------------------------
#
# Description: This file holds all my BASH configurations and aliases
#
# Sections:
# 1. Environment Configuration
# 2. Make Terminal Better (remapping defaults and adding functionality)
# 3. File and Folder Management
# 4. Searching
# 5. Process Management
# 6. Networking
# 7. System Operations & Information
# 8. Web Development
# 9. Reminders & Notes
#
# ---------------------------------------------------------------------------

# -------------------------------
# 1. ENVIRONMENT CONFIGURATION
# -------------------------------

# Change Prompt
# ------------------------------------------------------------
export PS1="________________________________________________________________________________\n| \w @ \h (\u) \n| => "
export PS2="| => "

# Set Paths
# ------------------------------------------------------------
export PATH="$PATH:/usr/local/bin/"
export PATH="/usr/local/git/bin:/sw/bin/:/usr/local/bin:/usr/local/:/usr/local/sbin:/usr/local/mysql/bin:$PATH"

# Set Default Editor (change 'Nano' to the editor of your choice)
# ------------------------------------------------------------
export EDITOR=/usr/bin/nano

# Set default blocksize for ls, df, du
# from this: http://hints.macworld.com/comment.php?mode=view&cid=24491
# ------------------------------------------------------------
export BLOCKSIZE=1k

# Add color to terminal
# (this is all commented out as I use Mac Terminal Profiles)
# from http://osxdaily.com/2012/02/21/add-color-to-the-terminal-in-mac-os-x/
# ------------------------------------------------------------
# export CLICOLOR=1
# export LSCOLORS=ExFxBxDxCxegedabagacad

# -----------------------------
# 2. MAKE TERMINAL BETTER
# -----------------------------

alias cp='cp -iv' # Preferred 'cp' implementation
alias mv='mv -iv' # Preferred 'mv' implementation
alias mkdir='mkdir -pv' # Preferred 'mkdir' implementation
alias ll='ls -FGlAhp' # Preferred 'ls' implementation
alias less='less -FSRXc' # Preferred 'less' implementation
cd() { builtin cd "$@"; ll; } # Always list directory contents upon 'cd'
alias cd..='cd ../' # Go back 1 directory level (for fast typers)
alias ..='cd ../' # Go back 1 directory level
alias ...='cd ../../' # Go back 2 directory levels
alias .3='cd ../../../' # Go back 3 directory levels
alias .4='cd ../../../../' # Go back 4 directory levels
alias .5='cd ../../../../../' # Go back 5 directory levels
alias .6='cd ../../../../../../' # Go back 6 directory levels
alias edit='subl' # edit: Opens any file in sublime editor
alias f='open -a Finder ./' # f: Opens current directory in MacOS Finder
alias ~="cd ~" # ~: Go Home
alias c='clear' # c: Clear terminal display
alias which='type -all' # which: Find executables
alias path='echo -e ${PATH//:/\\n}' # path: Echo all executable Paths
alias show_options='shopt' # Show_options: display bash options settings
alias fix_stty='stty sane' # fix_stty: Restore terminal settings when screwed up
alias cic='set completion-ignore-case On' # cic: Make tab-completion case-insensitive
mcd () { mkdir -p "$1" && cd "$1"; } # mcd: Makes new Dir and jumps inside
trash () { command mv "$@" ~/.Trash ; } # trash: Moves a file to the MacOS trash
ql () { qlmanage -p "$*" >& /dev/null; } # ql: Opens any file in MacOS Quicklook Preview
alias DT='tee ~/Desktop/terminalOut.txt' # DT: Pipe content to file on MacOS Desktop

# lr: Full Recursive Directory Listing
# ------------------------------------------
alias lr='ls -R | grep ":$" | sed -e '\''s/:$//'\'' -e '\''s/[^-][^\/]*\//--/g'\'' -e '\''s/^/ /'\'' -e '\''s/-/|/'\'' | less'

# mans: Search manpage given in agument '1' for term given in argument '2' (case insensitive)
# displays paginated result with colored search terms and two lines surrounding each hit. Example: mans mplayer codec
# --------------------------------------------------------------------
mans () {
man $1 | grep -iC2 --color=always $2 | less
}

# showa: to remind yourself of an alias (given some part of it)
# ------------------------------------------------------------
showa () { /usr/bin/grep --color=always -i -a1 $@ ~/Library/init/bash/aliases.bash | grep -v '^\s*$' | less -FSRXc ; }

# -------------------------------
# 3. FILE AND FOLDER MANAGEMENT
# -------------------------------

zipf () { zip -r "$1".zip "$1" ; } # zipf: To create a ZIP archive of a folder
alias numFiles='echo $(ls -1 | wc -l)' # numFiles: Count of non-hidden files in current dir
alias make1mb='mkfile 1m ./1MB.dat' # make1mb: Creates a file of 1mb size (all zeros)
alias make5mb='mkfile 5m ./5MB.dat' # make5mb: Creates a file of 5mb size (all zeros)
alias make10mb='mkfile 10m ./10MB.dat' # make10mb: Creates a file of 10mb size (all zeros)

# cdf: 'Cd's to frontmost window of MacOS Finder
# ------------------------------------------------------
cdf () {
currFolderPath=$( /usr/bin/osascript <<EOT
tell application "Finder"
try
set currFolder to (folder of the front window as alias)
on error
set currFolder to (path to desktop folder as alias)
end try
POSIX path of currFolder
end tell
EOT
)
echo "cd to \"$currFolderPath\""
cd "$currFolderPath"
}

# extract: Extract most know archives with one command
# ---------------------------------------------------------
extract () {
if [ -f $1 ] ; then
case $1 in
*.tar.bz2) tar xjf $1 ;;
*.tar.gz) tar xzf $1 ;;
*.bz2) bunzip2 $1 ;;
*.rar) unrar e $1 ;;
*.gz) gunzip $1 ;;
*.tar) tar xf $1 ;;
*.tbz2) tar xjf $1 ;;
*.tgz) tar xzf $1 ;;
*.zip) unzip $1 ;;
*.Z) uncompress $1 ;;
*.7z) 7z x $1 ;;
*) echo "'$1' cannot be extracted via extract()" ;;
esac
else
echo "'$1' is not a valid file"
fi
}

# ---------------------------
# 4. SEARCHING
# ---------------------------

alias qfind="find . -name " # qfind: Quickly search for file
ff () { /usr/bin/find . -name "$@" ; } # ff: Find file under the current directory
ffs () { /usr/bin/find . -name "$@"'*' ; } # ffs: Find file whose name starts with a given string
ffe () { /usr/bin/find . -name '*'"$@" ; } # ffe: Find file whose name ends with a given string

# spotlight: Search for a file using MacOS Spotlight's metadata
# -----------------------------------------------------------
spotlight () { mdfind "kMDItemDisplayName == '$@'wc"; }

# ---------------------------
# 5. PROCESS MANAGEMENT
# ---------------------------

# findPid: find out the pid of a specified process
# -----------------------------------------------------
# Note that the command name can be specified via a regex
# E.g. findPid '/d$/' finds pids of all processes with names ending in 'd'
# Without the 'sudo' it will only find processes of the current user
# -----------------------------------------------------
findPid () { lsof -t -c "$@" ; }

# memHogsTop, memHogsPs: Find memory hogs
# -----------------------------------------------------
alias memHogsTop='top -l 1 -o rsize | head -20'
alias memHogsPs='ps wwaxm -o pid,stat,vsize,rss,time,command | head -10'

# cpuHogs: Find CPU hogs
# -----------------------------------------------------
alias cpu_hogs='ps wwaxr -o pid,stat,%cpu,time,command | head -10'

# topForever: Continual 'top' listing (every 10 seconds)
# -----------------------------------------------------
alias topForever='top -l 9999999 -s 10 -o cpu'

# ttop: Recommended 'top' invocation to minimize resources
# ------------------------------------------------------------
# Taken from this macosxhints article
# http://www.macosxhints.com/article.php?story=20060816123853639
# ------------------------------------------------------------
alias ttop="top -R -F -s 10 -o rsize"

# my_ps: List processes owned by my user:
# ------------------------------------------------------------
my_ps() { ps $@ -u $USER -o pid,%cpu,%mem,start,time,bsdtime,command ; }

# ---------------------------
# 6. NETWORKING
# ---------------------------

alias myip='curl ip.appspot.com' # myip: Public facing IP Address
alias netCons='lsof -i' # netCons: Show all open TCP/IP sockets
alias flushDNS='dscacheutil -flushcache' # flushDNS: Flush out the DNS Cache
alias lsock='sudo /usr/sbin/lsof -i -P' # lsock: Display open sockets
alias lsockU='sudo /usr/sbin/lsof -nP | grep UDP' # lsockU: Display only open UDP sockets
alias lsockT='sudo /usr/sbin/lsof -nP | grep TCP' # lsockT: Display only open TCP sockets
alias ipInfo0='ipconfig getpacket en0' # ipInfo0: Get info on connections for en0
alias ipInfo1='ipconfig getpacket en1' # ipInfo1: Get info on connections for en1
alias openPorts='sudo lsof -i | grep LISTEN' # openPorts: All listening connections
alias showBlocked='sudo ipfw list' # showBlocked: All ipfw rules inc/ blocked IPs

# ii: display useful host related informaton
# -------------------------------------------------------------------
ii() {
echo -e "\nYou are logged on ${RED}$HOST"
echo -e "\nAdditionnal information:$NC " ; uname -a
echo -e "\n${RED}Users logged on:$NC " ; w -h
echo -e "\n${RED}Current date :$NC " ; date
echo -e "\n${RED}Machine stats :$NC " ; uptime
echo -e "\n${RED}Current network location :$NC " ; scselect
echo -e "\n${RED}Public facing IP Address :$NC " ;myip
#echo -e "\n${RED}DNS Configuration:$NC " ; scutil --dns
echo
}

# ---------------------------------------
# 7. SYSTEMS OPERATIONS & INFORMATION
# ---------------------------------------

alias mountReadWrite='/sbin/mount -uw /' # mountReadWrite: For use when booted into single-user

# cleanupDS: Recursively delete .DS_Store files
# -------------------------------------------------------------------
alias cleanupDS="find . -type f -name '*.DS_Store' -ls -delete"

# finderShowHidden: Show hidden files in Finder
# finderHideHidden: Hide hidden files in Finder
# -------------------------------------------------------------------
alias finderShowHidden='defaults write com.apple.finder ShowAllFiles TRUE'
alias finderHideHidden='defaults write com.apple.finder ShowAllFiles FALSE'

# cleanupLS: Clean up LaunchServices to remove duplicates in the "Open With" menu
# -----------------------------------------------------------------------------------
alias cleanupLS="/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user && killall Finder"

# screensaverDesktop: Run a screensaver on the Desktop
# -----------------------------------------------------------------------------------
alias screensaverDesktop='/System/Library/Frameworks/ScreenSaver.framework/Resources/ScreenSaverEngine.app/Contents/MacOS/ScreenSaverEngine -background'

# ---------------------------------------
# 8. WEB DEVELOPMENT
# ---------------------------------------

alias apacheEdit='sudo edit /etc/httpd/httpd.conf' # apacheEdit: Edit httpd.conf
alias apacheRestart='sudo apachectl graceful' # apacheRestart: Restart Apache
alias editHosts='sudo edit /etc/hosts' # editHosts: Edit /etc/hosts file
alias herr='tail /var/log/httpd/error_log' # herr: Tails HTTP error logs
alias apacheLogs="less +F /var/log/apache2/error_log" # Apachelogs: Shows apache error logs
httpHeaders () { /usr/bin/curl -I -L $@ ; } # httpHeaders: Grabs headers from web page

# httpDebug: Download a web page and show info on what took time
# -------------------------------------------------------------------
httpDebug () { /usr/bin/curl $@ -o /dev/null -w "dns: %{time_namelookup} connect: %{time_connect} pretransfer: %{time_pretransfer} starttransfer: %{time_starttransfer} total: %{time_total}\n" ; }

# ---------------------------------------
# 9. REMINDERS & NOTES
# ---------------------------------------

# remove_disk: spin down unneeded disk
# ---------------------------------------
# diskutil eject /dev/disk1s3

# to change the password on an encrypted disk image:
# ---------------------------------------
# hdiutil chpass /path/to/the/diskimage

# to mount a read-only disk image as read-write:
# ---------------------------------------
# hdiutil attach example.dmg -shadow /tmp/example.shadow -noverify

# mounting a removable drive (of type msdos or hfs)
# ---------------------------------------
# mkdir /Volumes/Foo
# ls /dev/disk* to find out the device to use in the mount command)
# mount -t msdos /dev/disk1s1 /Volumes/Foo
# mount -t hfs /dev/disk1s1 /Volumes/Foo

# to create a file of a given size: /usr/sbin/mkfile or /usr/bin/hdiutil
# ---------------------------------------
# e.g.: mkfile 10m 10MB.dat
# e.g.: hdiutil create -size 10m 10MB.dmg
# the above create files that are almost all zeros - if random bytes are desired
# then use: ~/Dev/Perl/randBytes 1048576 > 10MB.dat
</syntaxhighlight>

== Tipps und Tricks ==
=== Mit Terminal auf externe Festplatte zugreifen ===
/Volumes
=== Dateien kopieren, bewegen, umbenennen ===
https://www.macworld.com/article/222558/macos-command-line-copying-moving-files-terminal.html

cp source.txt target.txt
cp -R sourceFolder/ /Volumes/backupDrive/myBackupFolder

Terminal und Konsole auf dem Mac

2021-09-20T16:12:14Z

134.3.85.26:

Tips für die Arbeit mit dem Terminal

== Einleitung ==
Das Erscheinungsbild des Terminals kann man einfach Verbessern. Dazu kann man z.B. im Home-Directory die Dateien '''.bash_profile''' or '''.bashrc''' anpassen. Aber auch die '''.profile''' Datei Funktioniert. Je nachdem ob man die User Dateien oder die Globalen nimmt wird die Änderung global oder auf User-Ebene umgesetzt. Wenn die Dateien nicht vorhanden sind einfach hinzufügen.

== Links ==
=== zsh shell statt bash ab Catalina ===
https://support.apple.com/de-de/HT208050
== Prompt anpassen ==
Wie oben beschrieben z.B. in die .bash_profile datei
''Farbiges'' '''Prompt''' und Anzeige als: ''“username@hostname:cwd $”''
export PS1="\[\033[36m\]\u\[\033[m\]@\[\033[32m\]\h:\[\033[33;1m\]\w\[\033[m\]\$ "

== Farben auf Mac Terminal ==
export CLICOLOR=1
export LSCOLORS=GxFxCxDxBxegedabagaced

CLICOLOR=1 bedeutet Farbe anschalten
LSCOLORS= Farben für die anzeige im Listkommando
== Mac UNIX ==
Basiert auf UNIX

Apfel > Über diesen Mac > Software (da steht z.B. die kernel Version)

== Umgebungsvariablen, PATH Variable etc.==
siehe auch: http://wiki.zone30.info/wikizone/index.php/Linux_-_Umgebungsvariable

alle kriegt man mit
set | less
eine einzelne z.B. mit:
echo $PATH

==== PATH Variable anpassen ====
'''Hinzufügen''' eines Pfades für eine '''einzelne''' Terminal '''Session''':
PATH=MeinZusatzPfad:$PATH
export PATH
'''Exportieren''' ist wichtig wenn die neue Variable auch in '''Unterterminals''' zur Verfügung stehen soll (z.B. bei Bash Skripten)

=== Dauerhaft PATH Variable in der Bash setzen ===
Auf diese Weise stehen die PATH Variable '''bei jeder Sitzung''' zur Verfügung. Mac speichert die Bash Datei im Userverzeichnis.

Wir öffnen die bash_profile Datei im Standard Editor (wenn Sie nicht vorhanden ist wird Sie erzeugt).
touch ~/.bash_profile; open ~/.bash_profile
Jetzt können wir die Variable setzen. Hier ein Beispiel mit der Android ADT
export PATH=/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/platform-tools:/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/tools:$PATH

Durch das :$PATH am Ende wird der neue Wert zu den Standardwerten hinzugefügt oder hier besser vorangestellt)

Jetzt noch die Datei abspeichern und ausführen:

source ~/.bash_profile
== Umfangreiches .bash_profile Beispiel ==
Quelle: http://natelandau.com/my-mac-osx-bash_profile/ (2015-10)
<syntaxhighlight lang="bash">
# ---------------------------------------------------------------------------
#
# Description: This file holds all my BASH configurations and aliases
#
# Sections:
# 1. Environment Configuration
# 2. Make Terminal Better (remapping defaults and adding functionality)
# 3. File and Folder Management
# 4. Searching
# 5. Process Management
# 6. Networking
# 7. System Operations & Information
# 8. Web Development
# 9. Reminders & Notes
#
# ---------------------------------------------------------------------------

# -------------------------------
# 1. ENVIRONMENT CONFIGURATION
# -------------------------------

# Change Prompt
# ------------------------------------------------------------
export PS1="________________________________________________________________________________\n| \w @ \h (\u) \n| => "
export PS2="| => "

# Set Paths
# ------------------------------------------------------------
export PATH="$PATH:/usr/local/bin/"
export PATH="/usr/local/git/bin:/sw/bin/:/usr/local/bin:/usr/local/:/usr/local/sbin:/usr/local/mysql/bin:$PATH"

# Set Default Editor (change 'Nano' to the editor of your choice)
# ------------------------------------------------------------
export EDITOR=/usr/bin/nano

# Set default blocksize for ls, df, du
# from this: http://hints.macworld.com/comment.php?mode=view&cid=24491
# ------------------------------------------------------------
export BLOCKSIZE=1k

# Add color to terminal
# (this is all commented out as I use Mac Terminal Profiles)
# from http://osxdaily.com/2012/02/21/add-color-to-the-terminal-in-mac-os-x/
# ------------------------------------------------------------
# export CLICOLOR=1
# export LSCOLORS=ExFxBxDxCxegedabagacad

# -----------------------------
# 2. MAKE TERMINAL BETTER
# -----------------------------

alias cp='cp -iv' # Preferred 'cp' implementation
alias mv='mv -iv' # Preferred 'mv' implementation
alias mkdir='mkdir -pv' # Preferred 'mkdir' implementation
alias ll='ls -FGlAhp' # Preferred 'ls' implementation
alias less='less -FSRXc' # Preferred 'less' implementation
cd() { builtin cd "$@"; ll; } # Always list directory contents upon 'cd'
alias cd..='cd ../' # Go back 1 directory level (for fast typers)
alias ..='cd ../' # Go back 1 directory level
alias ...='cd ../../' # Go back 2 directory levels
alias .3='cd ../../../' # Go back 3 directory levels
alias .4='cd ../../../../' # Go back 4 directory levels
alias .5='cd ../../../../../' # Go back 5 directory levels
alias .6='cd ../../../../../../' # Go back 6 directory levels
alias edit='subl' # edit: Opens any file in sublime editor
alias f='open -a Finder ./' # f: Opens current directory in MacOS Finder
alias ~="cd ~" # ~: Go Home
alias c='clear' # c: Clear terminal display
alias which='type -all' # which: Find executables
alias path='echo -e ${PATH//:/\\n}' # path: Echo all executable Paths
alias show_options='shopt' # Show_options: display bash options settings
alias fix_stty='stty sane' # fix_stty: Restore terminal settings when screwed up
alias cic='set completion-ignore-case On' # cic: Make tab-completion case-insensitive
mcd () { mkdir -p "$1" && cd "$1"; } # mcd: Makes new Dir and jumps inside
trash () { command mv "$@" ~/.Trash ; } # trash: Moves a file to the MacOS trash
ql () { qlmanage -p "$*" >& /dev/null; } # ql: Opens any file in MacOS Quicklook Preview
alias DT='tee ~/Desktop/terminalOut.txt' # DT: Pipe content to file on MacOS Desktop

# lr: Full Recursive Directory Listing
# ------------------------------------------
alias lr='ls -R | grep ":$" | sed -e '\''s/:$//'\'' -e '\''s/[^-][^\/]*\//--/g'\'' -e '\''s/^/ /'\'' -e '\''s/-/|/'\'' | less'

# mans: Search manpage given in agument '1' for term given in argument '2' (case insensitive)
# displays paginated result with colored search terms and two lines surrounding each hit. Example: mans mplayer codec
# --------------------------------------------------------------------
mans () {
man $1 | grep -iC2 --color=always $2 | less
}

# showa: to remind yourself of an alias (given some part of it)
# ------------------------------------------------------------
showa () { /usr/bin/grep --color=always -i -a1 $@ ~/Library/init/bash/aliases.bash | grep -v '^\s*$' | less -FSRXc ; }

# -------------------------------
# 3. FILE AND FOLDER MANAGEMENT
# -------------------------------

zipf () { zip -r "$1".zip "$1" ; } # zipf: To create a ZIP archive of a folder
alias numFiles='echo $(ls -1 | wc -l)' # numFiles: Count of non-hidden files in current dir
alias make1mb='mkfile 1m ./1MB.dat' # make1mb: Creates a file of 1mb size (all zeros)
alias make5mb='mkfile 5m ./5MB.dat' # make5mb: Creates a file of 5mb size (all zeros)
alias make10mb='mkfile 10m ./10MB.dat' # make10mb: Creates a file of 10mb size (all zeros)

# cdf: 'Cd's to frontmost window of MacOS Finder
# ------------------------------------------------------
cdf () {
currFolderPath=$( /usr/bin/osascript <<EOT
tell application "Finder"
try
set currFolder to (folder of the front window as alias)
on error
set currFolder to (path to desktop folder as alias)
end try
POSIX path of currFolder
end tell
EOT
)
echo "cd to \"$currFolderPath\""
cd "$currFolderPath"
}

# extract: Extract most know archives with one command
# ---------------------------------------------------------
extract () {
if [ -f $1 ] ; then
case $1 in
*.tar.bz2) tar xjf $1 ;;
*.tar.gz) tar xzf $1 ;;
*.bz2) bunzip2 $1 ;;
*.rar) unrar e $1 ;;
*.gz) gunzip $1 ;;
*.tar) tar xf $1 ;;
*.tbz2) tar xjf $1 ;;
*.tgz) tar xzf $1 ;;
*.zip) unzip $1 ;;
*.Z) uncompress $1 ;;
*.7z) 7z x $1 ;;
*) echo "'$1' cannot be extracted via extract()" ;;
esac
else
echo "'$1' is not a valid file"
fi
}

# ---------------------------
# 4. SEARCHING
# ---------------------------

alias qfind="find . -name " # qfind: Quickly search for file
ff () { /usr/bin/find . -name "$@" ; } # ff: Find file under the current directory
ffs () { /usr/bin/find . -name "$@"'*' ; } # ffs: Find file whose name starts with a given string
ffe () { /usr/bin/find . -name '*'"$@" ; } # ffe: Find file whose name ends with a given string

# spotlight: Search for a file using MacOS Spotlight's metadata
# -----------------------------------------------------------
spotlight () { mdfind "kMDItemDisplayName == '$@'wc"; }

# ---------------------------
# 5. PROCESS MANAGEMENT
# ---------------------------

# findPid: find out the pid of a specified process
# -----------------------------------------------------
# Note that the command name can be specified via a regex
# E.g. findPid '/d$/' finds pids of all processes with names ending in 'd'
# Without the 'sudo' it will only find processes of the current user
# -----------------------------------------------------
findPid () { lsof -t -c "$@" ; }

# memHogsTop, memHogsPs: Find memory hogs
# -----------------------------------------------------
alias memHogsTop='top -l 1 -o rsize | head -20'
alias memHogsPs='ps wwaxm -o pid,stat,vsize,rss,time,command | head -10'

# cpuHogs: Find CPU hogs
# -----------------------------------------------------
alias cpu_hogs='ps wwaxr -o pid,stat,%cpu,time,command | head -10'

# topForever: Continual 'top' listing (every 10 seconds)
# -----------------------------------------------------
alias topForever='top -l 9999999 -s 10 -o cpu'

# ttop: Recommended 'top' invocation to minimize resources
# ------------------------------------------------------------
# Taken from this macosxhints article
# http://www.macosxhints.com/article.php?story=20060816123853639
# ------------------------------------------------------------
alias ttop="top -R -F -s 10 -o rsize"

# my_ps: List processes owned by my user:
# ------------------------------------------------------------
my_ps() { ps $@ -u $USER -o pid,%cpu,%mem,start,time,bsdtime,command ; }

# ---------------------------
# 6. NETWORKING
# ---------------------------

alias myip='curl ip.appspot.com' # myip: Public facing IP Address
alias netCons='lsof -i' # netCons: Show all open TCP/IP sockets
alias flushDNS='dscacheutil -flushcache' # flushDNS: Flush out the DNS Cache
alias lsock='sudo /usr/sbin/lsof -i -P' # lsock: Display open sockets
alias lsockU='sudo /usr/sbin/lsof -nP | grep UDP' # lsockU: Display only open UDP sockets
alias lsockT='sudo /usr/sbin/lsof -nP | grep TCP' # lsockT: Display only open TCP sockets
alias ipInfo0='ipconfig getpacket en0' # ipInfo0: Get info on connections for en0
alias ipInfo1='ipconfig getpacket en1' # ipInfo1: Get info on connections for en1
alias openPorts='sudo lsof -i | grep LISTEN' # openPorts: All listening connections
alias showBlocked='sudo ipfw list' # showBlocked: All ipfw rules inc/ blocked IPs

# ii: display useful host related informaton
# -------------------------------------------------------------------
ii() {
echo -e "\nYou are logged on ${RED}$HOST"
echo -e "\nAdditionnal information:$NC " ; uname -a
echo -e "\n${RED}Users logged on:$NC " ; w -h
echo -e "\n${RED}Current date :$NC " ; date
echo -e "\n${RED}Machine stats :$NC " ; uptime
echo -e "\n${RED}Current network location :$NC " ; scselect
echo -e "\n${RED}Public facing IP Address :$NC " ;myip
#echo -e "\n${RED}DNS Configuration:$NC " ; scutil --dns
echo
}

# ---------------------------------------
# 7. SYSTEMS OPERATIONS & INFORMATION
# ---------------------------------------

alias mountReadWrite='/sbin/mount -uw /' # mountReadWrite: For use when booted into single-user

# cleanupDS: Recursively delete .DS_Store files
# -------------------------------------------------------------------
alias cleanupDS="find . -type f -name '*.DS_Store' -ls -delete"

# finderShowHidden: Show hidden files in Finder
# finderHideHidden: Hide hidden files in Finder
# -------------------------------------------------------------------
alias finderShowHidden='defaults write com.apple.finder ShowAllFiles TRUE'
alias finderHideHidden='defaults write com.apple.finder ShowAllFiles FALSE'

# cleanupLS: Clean up LaunchServices to remove duplicates in the "Open With" menu
# -----------------------------------------------------------------------------------
alias cleanupLS="/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user && killall Finder"

# screensaverDesktop: Run a screensaver on the Desktop
# -----------------------------------------------------------------------------------
alias screensaverDesktop='/System/Library/Frameworks/ScreenSaver.framework/Resources/ScreenSaverEngine.app/Contents/MacOS/ScreenSaverEngine -background'

# ---------------------------------------
# 8. WEB DEVELOPMENT
# ---------------------------------------

alias apacheEdit='sudo edit /etc/httpd/httpd.conf' # apacheEdit: Edit httpd.conf
alias apacheRestart='sudo apachectl graceful' # apacheRestart: Restart Apache
alias editHosts='sudo edit /etc/hosts' # editHosts: Edit /etc/hosts file
alias herr='tail /var/log/httpd/error_log' # herr: Tails HTTP error logs
alias apacheLogs="less +F /var/log/apache2/error_log" # Apachelogs: Shows apache error logs
httpHeaders () { /usr/bin/curl -I -L $@ ; } # httpHeaders: Grabs headers from web page

# httpDebug: Download a web page and show info on what took time
# -------------------------------------------------------------------
httpDebug () { /usr/bin/curl $@ -o /dev/null -w "dns: %{time_namelookup} connect: %{time_connect} pretransfer: %{time_pretransfer} starttransfer: %{time_starttransfer} total: %{time_total}\n" ; }

# ---------------------------------------
# 9. REMINDERS & NOTES
# ---------------------------------------

# remove_disk: spin down unneeded disk
# ---------------------------------------
# diskutil eject /dev/disk1s3

# to change the password on an encrypted disk image:
# ---------------------------------------
# hdiutil chpass /path/to/the/diskimage

# to mount a read-only disk image as read-write:
# ---------------------------------------
# hdiutil attach example.dmg -shadow /tmp/example.shadow -noverify

# mounting a removable drive (of type msdos or hfs)
# ---------------------------------------
# mkdir /Volumes/Foo
# ls /dev/disk* to find out the device to use in the mount command)
# mount -t msdos /dev/disk1s1 /Volumes/Foo
# mount -t hfs /dev/disk1s1 /Volumes/Foo

# to create a file of a given size: /usr/sbin/mkfile or /usr/bin/hdiutil
# ---------------------------------------
# e.g.: mkfile 10m 10MB.dat
# e.g.: hdiutil create -size 10m 10MB.dmg
# the above create files that are almost all zeros - if random bytes are desired
# then use: ~/Dev/Perl/randBytes 1048576 > 10MB.dat
</syntaxhighlight>

== Tipps und Tricks ==
=== Mit Terminal auf externe Festplatte zugreifen ===
/Volumes
=== Dateien kopieren, bewegen, umbenennen ===
https://www.macworld.com/article/222558/macos-command-line-copying-moving-files-terminal.html

cp source.txt target.txt
cp -R sourceFolder/ /Volumes/backupDrive/myBackupFolder

ProcessWire - WireMailSmtp (Module)

2021-09-17T11:43:16Z

134.3.85.26:

https://modules.processwire.com/modules/wire-mail-smtp/

Das geht recht gut wenn man das WireMailSmtp Modul verwendet. ProcessWire selbst kann nur php Mail. Es bietet aber eine Schnittstelle, die Module nutzen können um Mails auf andere Weise zu handeln. WireMailSmtp bietet auf diese Weise einen Versand über SMTP an.

# '''Modul''' installieren
# In den Einstellungen des Moduls die '''SMTP Daten''' hinterlegen
# Formbuilder erkennt das Mailer Module automatisch und nutzt es. Aber trotzdem mal in den Settings von Formbuilder nachschauen was ausgewählt ist. Im Zweifel den '''Versand auf SMTP stellen'''.
# In den '''Formbuilder Settings''' sollte eine E-Mail Adresse ausgewählt sein, die der Server zuläßt.

Einstellungen für KASSERVER:

smtp hostname z.B. webmynet.kasserver.com
port 465
allow connection without authentication off
smtp user z.B. m0551234 (siehe kas)
smtp passwort (siehe kas)
use start-tls OFF
use SSL ON
sender email address die adresse über die versendet wird

Einstellungen für Office365

smtp hostname smtp.office365.com
port 587
smtp user (e-mail adresse)
smtp pass (geheim)
use start-tls ON
crypto for tls - STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT
ssl OFF (WICHTIG)

Htaccess

2021-09-03T09:07:21Z

134.3.85.26: /* Common Cases */

== Anwendung von .htaccess - Dateien ==
=== Weiterführende Links: ===
https://jweiland.net/know-how/internet/htaccess-konfigurieren.html#c2756

http://httpd.apache.org/docs/1.3/howto/htaccess.html

von: http://www.uni-duesseldorf.de/Service/Webmaster/htaccess.php3 Juli 2006

Referenz: Apache Manual: http://www.uni-duesseldorf.de/apache-manual/

[[Apache Mod Rewrite Syntax]]

=== Wozu braucht man das ?===
An wen ein HTTP-Server Dokumente herausgibt, welche spezielle Verarbeitung er u.U. bei einer spezifischen Anforderung (einem request) durchführt - all das wird zunächst durch eine von der Server-Software abhängigen Konfiguration bestimmt, die ein Administrator - ein Webmaster - eingerichtet hat.

Oft ist es aber wünschenswert, daß einzelne Verantwortliche für eine Dokumentenhierarchie auf dem Web-Server selbst ohne Intervention des Webmasters Setzungen vornehmen können, daß z.B. auf einzelne Dokumente oder alle in einem bestimmten Verzeichnis nur ein Zugriff aus bestimmten Domains oder mit verifiziertem Usernamen möglich ist.

Beim Apache-HTTP-Server wie seinem Vorgänger, dem NCSA-httpd, gibt es diese Möglichkeiten durch die Einrichtung von .htaccess-Dateien in dem jeweiligen Verzeichnis. In der folgenden Darstellung wird als Referenz jeweils ein Verweis auf den entsprechenden Abschnitt in der lokale Kopie der Apache-Dokumentation für die Version 1.2 gegeben.

'''Achtung:''' In der Server-Konfiguration kann ein anderer Name als .htaccess vereinbart sein (AccesFileName-Direkt ive).

'''Zweiter Hinweis:''' Die Datei muß für den HTTP-Server lesbar sein, z.B. dadurch erreicht, daß sie öffentlich lesbar ist:

chmod 644 .htaccess

=== Zugriffsbeschränkung auf eine Domain ===
==== für alle Dateien in einem Verzeichnis ====
'''.htaccess'''

order deny,allow
deny from all
allow from .uni-duesseldorf.de 134.99

Alle Dateien in dem Verzeichnis werden nur an Clients ausgeliefert, die eine IP-Adresse beginnend mit 134.99 oder einen Hostnamen endend mit uni-duesseldorf.de besitzen; anderenfalls erfolgt eine Fehlermeldung des Servers (403 Forbidden).

Natürlich genügt in vielen Fällen eine der Alternativen. Beachten Sie dabei die Unterschiede:

* Die Angabe des Domain-Namens allein schließt - bewußt oder nicht - den Zugriff von PC's aus, die nicht im Domain Name System (DNS) registriert sind.
* Die Angabe des IP-Subnetzes allein kann andere ausschließen, die organisatorisch zur gleichen Domain gehören, technisch aber in einem anderen Subnetz hängen.

Wie lässt sich diese Zugriffsbeschränkung testen? Normalerweise benötigt man dazu einen Internet-Zugang über einen anderen Provider (T-Online, AOL, Compuserve etc.). Oder man benutzt einen Browser auf dem Server selbst z.B. in folgender Weise:

lynx http://localhost/Service/Webmaster/htaccess.phtml

Der Zugriff erfolgt dann über das Loopback-Interface mit der IP-Adresse 127.0.0.1.

Referenz: order, deny, allow.

==== für einzelne Dateien ====
'''.htaccess'''

<Files huh*.html>
order deny,allow
deny from all
allow from .uni-duesseldorf.de 134.99
</Files>

Die Zugriffsbeschränkung wie oben gilt jetzt nur für die Dateien, deren Namen auf das hinter Files angegebene Muster passen. Es kann ein einzelner Name angegeben werden oder ein Muster mit den Wildcard-Zeichen ? für ein beliebiges einzelnes Zeichen oder * für eine beliebige Folge von Zeichen.

Schließlich sind auch feinere Muster über reguläre Ausdrücke möglich. Die Syntax der Files-Direktive dafür ist:

<Files ~ "regexp">

Referenz: <Files>, order, deny, allow.

=== Zugriffsbeschränkung über Passwort ===
==== für ein Verzeichnis ====
'''.htaccess'''

AuthType Basic
AuthName MeyersLeute
AuthUserFile /home/meyer/passwd
require valid-user

Dokumente in einem Verzeichnis mit dieser .htaccess-Datei (oder einem Unterverzeichnis) können erst nach Eingabe eines gültigen Benutzernamen und Passwortes gelesen werden. Der Wert hinter AuthName wird vom Browser in der Dialog-Box für die Passwortabfrage angezeigt und dient gleichzeitig dazu, andere Dokumente mit dem gleichen Schutz zu erkennen und einmal eingelesene Werte für Username und Password ohne erneute Abfrage unmittelbar zu verwenden.

Hinter AuthUserFile steht der Pfad der Passwortdatei, die die Benutzernamen und (verschlüsselten) Passwörter enthält. Sie sieht etwa so aus:

/home/meyer/passwd

meyer:xm.kPd4VJc3Fo
mueller:eJFQCL8GftDXI

Auch die Passwortdatei muß für den HTTP-Server lesbar sein. Gerade deshalb sollte sie niemals in demselben Bereich liegen wie die vom Server bedienten Dokumente, da sonst zumindest die gültigen Benutzernamen lesbar wären. (Aus diesem Grund müssen Sie aber u.U. daran denken, auch das entsprechende Verzeichnis - wie /home/meyer im Beispiel - für den HTTP-Server zumindest suchbar zu setzen, also etwa:

chmod 711 /home/meyer

Angelegt und gepflegt werden kann die Passwortdatei mit dem Programm htpasswd:

htpasswd -c /home/meyer/passwd meyer
htpasswd /home/meyer/passwd mueller

Referenz: AuthType, AuthName, AuthUserFile, require.

==== für einzelne Dateien ====
'''.htaccess'''

AuthType Basic
AuthName MeyersLeute
AuthUserFile /home/meyer/passwd
<Files Huh*.html>
require user meyer mueller
</Files>

Die Kombination von 2. und 3. - Passwortschutz für einzelne Dateien in dem aktuellen Verzeichnis. Beim require wird hier noch eine andere Alternative gezeigt: die Aufzählung einzelner Benutzernamen aus der Passwortdatei. Wenn neue Benutzer in der Passwortdatei ergänzt werden, haben diese noch keinen Zugriff auf die so geschützten Seiten.

Wenn die gleiche Liste von Benutzern an mehreren Stellen verwendet werden soll, ist die Definition der Liste über eine Gruppendatei empfehlenswert. Für diese dritte Alternative bzgl. der require-Direktive sind fogende Änderungen notwendig:

1. In der .htaccess-Datei wird eine Gruppendatei angegeben:
AuthGrouprFile /home/meyer/groups
Für den Ort der Ablage dieser Datei gelten dieselben Erwägungen wie für die Passwortdatei oben.
2. In der require-Direktive wird jetzt auf eine Gruppendefinition in der Gruppendatei Bezug genommen:
require group meyers
3. Die Gruppendatei ist eine einfache Textdatei mit je einer Gruppendefinition pro Zeile in folgender Form:

/home/meyer/groups
meyers: meyer mueller

Referenz: AuthType, AuthName, AuthUserFile, AuthGroupFile, <Files>, require.

===Spezielle Optionen===
==== automatischer Index (Directory Listing)====
ausführliche Infos hier: [[htaccess - Directory Listing]]

'''.htaccess'''
Options +Indexes

Mittels der Options-Direktive können - so von der globalen Server-Konfiguration her erlaubt - Voreinstellungen für Verarbeitungsoptionen für das aktuelle Verzeichnis und Unterverzeichnisse überschrieben werden.

Die gezeigte Variante weist den Server an, bei der Referenz auf das aktuelle Verzeichnis oder ein Unterverzeichnis ein Directory-Listing als Index-Datei automatisch zu generieren. Er macht dies allerdings nur, wenn nicht schon eine Index-Datei (mit vordefiniertem Namen wie index.html) vorhanden ist. Ggf. kann man die hier bekannten Namen mit der Direktive

DirectoryIndex Welcome.html

einschränken.

Referenz: Options, DirectoryIndex.

==== Automatischer Index mit User Auth ====
(Quelle Weiland s.o.)
Directory Listing

Soll über einer geschützen Unterseite (z.B. fileadmin/downloads) des Internetauftritts ein Directory Listing realisiert werden, dann sollte die .htaccess wie folgt eingestellt werden:

AuthType Basic
AuthName "system - "
Options +Indexes
IndexOptions +FancyIndexing
AuthUserFile /*ihr_serverpfad/projektpfad/filadmin/downloads/.htpasswd
AuthGroupFile /dev/null
require valid-user

* ihr_serverpfad finden Sie in Ihrem Kundenmenu unter Technische Infos oder durch Eingabe des Befehls $PWD in der Shell.

Den User mit verschlüseltem Passwort in dem Fall in der .htpasswd vorhanden sein.

Die Unterseite mit dem Directory Listing muss von der TYPO3 index.php ausgeschlossen werden und erreichen Sie über die .htaccess in dem Projektverzeichnis mit folgenden Angaben nach der RewriteEngine On:

RewriteRule ^fileadmin/downloads/$ - [L]
RewriteRule ^fileadmin/downloads/.*$ - [L]

==== Startdatei festlegen ====
Mit dem vorigen Beispiel kann man auch festlegen welche Dateien beim Aufruf eines Verzeichnisses (oder der Webadresse) an den Browser geliefert werden sollen. Manchmal hat man den Fall das die Startdatei eines CMS index.php heißt und bei Wartungsarbeiten die Datei index.html aufgerufen werden soll.

DirectoryIndex index.html index.php start.html

weist den Apache an falls vorhanden die Datei index.html aufzurufen, wenn nicht die index.php und so weiter.

Bei Wartungsarbeiten kann man nun einfach eine index.html aufspielen die bei Aufruf der Domain angezeigt wird.

==== PHP - Werte setzen ====
Wenn der Server das erlaubt kann man es folgendermaßen machen:
===== PHP Memory Limit =====
php_value memory_limit 256M
===== PHP Execution Time =====
php_value max_execution_time 240

==== Error Reporting ====
===== Produktiv Betrieb =====
(Fehler unterdrückt aber protokolliert)

php_value error_reporting 2047
php_value display_errors 0
php_value log_errors 1
php_value error_log /eigener/pfad/fehler.log

===== Entwicklung =====
hier sollte display_errors auf 1 stehen

siehe auch [[PHP - Error Reporting / Fehlerbehandlung]]

siehe auch [[TYPO3 - Error Reporting / Fehlerbehandlung]]

==== Skripte sperren ====
z.B. bei Überlastung durch ein Skript (hier im Beispiel meineDomain.de/ajax/

<pre>
RewriteEngine On
RewriteCond %{REQUEST_URI} (.*)ajax(.*) [NC]
RewriteRule ^(.*) - [F]
</pre>

== Browser Caching ==
Beispiel:
<pre>
<IfModule mod_expires.c>
ExpiresActive On
ExpiresByType text/html "access plus 500 seconds"
ExpiresByType image/gif "access plus 14 days"
ExpiresByType image/ico "access plus 14 days"
ExpiresByType image/jpeg "access plus 14 days"
ExpiresByType image/jpg "access plus 14 days"
ExpiresByType image/png "access plus 14 days"
ExpiresByType text/css "access plus 14 days"
ExpiresByType text/javascript "access plus 14 days"
ExpiresByType application/x-javascript "access plus 14 days"
ExpiresByType application/javascript "access plus 14 days"
</IfModule>
</pre>
== Zugriff auf Ordner ==
=== Sperren ===
<pre>
# This file restricts access to the fileadmin/user_upload/_import_export_ directory. It is
# meant to protect temporary files which could contain sensible
# information. Please do not touch.

# Apache < 2.3
<IfModule !mod_authz_core.c>
Order allow,deny
Deny from all
Satisfy All
</IfModule>

# Apache ≥ 2.3
<IfModule mod_authz_core.c>
Require all denied
</IfModule>
</pre>

== Weiterleitung mit .htaccess ==
=== Beispiele mit Fokus auf TYPO3 ===
Quelle Weiland (s.o.)
====Weiterleitungen (Redirects)====
===== Common Cases =====
http auf https umleiten

Weiterleitung von http auf https ohne Berücksichtigung der Subdomain (www.)

Damit eine automatische Weiterleitung auf HTTPS erfolgt, wenn die Webseite über HTTP aufgerufen wird, müssen Sie lediglich folgenden Codeschnipsel in die .htaccess Datei Ihres Webprojekts einfügen:
<pre>
<IfModule mod_rewrite.c>

RewriteEngine On

RewriteCond %{SERVER_PORT} !^443$
RewriteRule (.*) https://%{HTTP_HOST}/$1 [R=301,L]

</IfModule>
</pre>
Die Weiterleitung funktioniert jetzt wie folgt:

http://www.domain.de wird auf https://www.domain.de weitergeleitet.
http://domain.de wird auf https://domain.de weitergleitet.

(Bitte den Platzhalter domain mit Ihrem Domainnamen ersetzen.)

Weiterleitung von http auf https mit Berücksichtigung der Subdomain (www.)

Damit sowohl die Weiterleitung von http auf https, als auch die Weiterleitung von nicht www. auf www. aktiv wird, müssen Sie den folgenden Codeschnipsel in die .htaccess Datei Ihres Webprojekts einfügen:
<pre>
<IfModule mod_rewrite.c>

RewriteEngine On

RewriteCond %{HTTP_HOST} !^www.domain.de$ [NC]
RewriteRule ^(.*)$ https://www.domain.de/$1 [L,R=301]

RewriteCond %{SERVER_PORT} !=443
RewriteRule ^(.*)$ https://www.domain.de/$1 [R=301,L]

</IfModule>
</pre>
Die Weiterleitung funktioniert jetzt wie folgt:

http://www.domain.de wird auf https://www.domain.de weitergeleitet.

http://domain.de wird auf https://www.domain.de weitergleitet.

https://domain.de wird auf https://www.domain.de weitergeleitet.

Wenn Sie die Schreibweise ohne www. bevorzugen, können Sie natürlich das Weiterleitungsziel entsprechend anpassen. Dafür müssen Sie einfach die URL Angabe bei "RewriteRule" anpassen und auf die Version ohne www. verweisen.

Einzelne Unterseiten weiterleiten

Aufrufe einer Unterseite (z.B. a.html) auf eine andere Unterseite (z.B. b.html) innerhalb der selben Domain weiterleiten.
Redirect 301 /a.html /b.html

Ganzen Ordner / Verzeichnis weiterleiten

Aufrufe eines Ordners (z.B. /a) auf einen anderen Ordner innerhalb der selben Domain (z.B. /b) weiterleiten. Die Weiterleitung wirkt sich auch auf alle Dateien innerhalb des Ordners /a aus, so wird z.B. der Aufruf von /a/test.html auf /b/test.html weitergeleitet.
Redirect 301 /a /b

Domain Weiterleitung: Ganze Domain umleiten

Aufrufe einer Unterseite (URL) von Domain A auf die selbe Unterseite (URL) unter Domain B weiterleiten.
z.B. domain-a.de/test.html auf domain-b.de/test.html weiterleiten wobei dies nicht nur für test.html, sondern auch für alle weiteren Unterseiten gilt.
Redirect 301 / http://www.domain-b.de/

Alternative Lösung mittels RewriteCond / RewriteRule:
RewriteEngine on
RewriteCond %{HTTP_HOST} domain-a.de$ [NC]
RewriteRule ^(.*) http://www.domain-b.de/$1 [R=301,L]

URLs ohne www. auf URLs mit www. weiterleiten

Standard Domain definieren und Aufrufe einer URL ohne die Subdomain www. auf die entsprechende URL mit www. weiterleiten um z.B. doppelte Inhalte für Suchmaschinen zu vermeiden.
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain.de$ [NC]
RewriteRule (.*) http://www.domain.de/$1 [R=301,L]

Alle Unterseiten auf Startseite weiterleiten

Alle Aufrufe auf Unterseiten einer Domain mit Ausnahme der index.html, der Style.css sowie aller Dateien im Ordner /img/ auf die Startseite weiterleiten.
RewriteEngine on
RewriteBase /
RewriteCond %{REQUEST_URI} !^/(index\.html|style\.css)?$ [NC]
RewriteCond %{REQUEST_URI} !^/img(/|$) [NC]
RewriteRule ^.*$ /index.html [L,R=301]
URL mit Parameter weiterleiten

Aufrufe von URLs welche einen bestimmten Parameter (z.B. test) enthalten, unabhängig von dessen Wert, auf ein Verzeichnis (z.B. /verzeichnis/) oder eine Unterseite weiterleiten.
RewriteEngine on
RewriteCond %{QUERY_STRING} ^test=(.*)$
RewriteRule ^(.*)$ /verzeichnis/? [R=301,L]

URLs mit einem bestimmten Parameterwert weiterleiten (In diesem Fall Wert "test" für den Parameter "s" auf das Verzeichnis "test" weiterleiten).
RewriteEngine on
RewriteCond %{QUERY_STRING} ^s=test$
RewriteRule ^(.*)$ /test/? [R=301,L]
Parameter aus URL entfernen

Aufrufe von URLs welche einen bestimmten Parameter (z.B. www.domain.de/verzeichnis/?test=...) enthalten, unabhängig von dessen Wert, auf die selbe URL ohne Parameter am Ende (z.B. www.domain.de/verzeichnis/) weiterleiten bzw. den den Parameter aus der URL entfernen. Falls die Regel nur für einen bestimmten Parameter Wert gelten soll, kann der Code analog zum vorherigen Beispiel modifiziert werden.
RewriteEngine on
RewriteCond %{QUERY_STRING} test=(.*)$
RewriteRule ^(.*)$ /$1? [R=301,L]

===== Allgemeines =====

Die Weiterleitung von Domains und Anfragen zu einzelnen Webseiten ist eine der Hauptanwendungen der .htaccess Datei. Das notwendige Apache Modul mod_rewrite ist in unseren Hosting Tarifen vorhanden.

Die Weiterleitung muss jedoch in der .htaccess Datei zunächst mit folgendem Eintrag aktiviert werden (in den weiteren Beispielen haben wir diese Zeile weggelassen):

RewriteEngine On
301 oder 302 Weiterleitung?

Der Weiterleitung (Redirect) sollte man noch einen Statuscode mitgeben: 301 oder 302. Worin liegt der Unterschied?

301: die Weiterleitung ist dauerhaft, z.B. weil die Navigationsstruktur einer Webseite umgestellt wurde

302: die Weiterleitung erfolgt nur vorübergehend, anschließend gilt wieder die bisherige Adresse

Am Ende der RewriteRule Zeile wird der Code für die Weiterleitung (Redirect) in eckigen Klammern angegeben. Mit dem zusätzlichen Parameter L (Letzter, Last) kann man festlegen, dass die weiteren Anweisungen in der .htaccess Datei ignoriert werden sollen. Hierzu ein Beispiel:

RewriteRule ^neues\.html$ /aktuelles.html [R=301,L]
Damit wird die Seite domain.tld/neues.html dauerhaft auf domain.tlld/aktuelles.htmlweitergeleitet.

Die Schreibweise der Rewrite Regeln basiert dabei auf "Regulären Ausdrücken" (Regular Expressions, regex).

Mit den Zeichen ^ und $ wird Anfang und Ende der umzuleitenden Seite gekennzeichnet. Der Punkt . steht in regulären Ausdrücken für ein beliebiges Zeichen, wenn wir wirklich einen Punkt meinen, dann wird dies mit einem Backslash \ gekennzeichnet (\ bedeutet also: exakt das nächste Zeichen).

====Besonderheit: Anker auf einer Seite====

Auf einer Webseite können "Anker" als Sprungmarke gesetzt sein. Beim Aufruf wird im Browser nicht auf den Anfang der Seite sondern direkt zum Ankerpunkt gesprungen. Der Anker wird durch ein Hash-Zeichen # in der URL gefolgt vom Namen der Sprungmarke gekennzeichnet. Beispiel für eine Adresse mit Anker:

domain.tld/aktuelles.html#artikel25
Soll per .htaccess Weiterleitung direkt auf eine Sprungmarke verwiesen werden, muss der zusätzliche Parameter NE (No Encoding) in eckigen Klammern angegeben werden:

RewriteRule ^neues\.html$ /aktuelles.html#artikel25 [R=301,L,NE]
Domain auf verschlüsselte Verbindung umleiten

Sollen alle Seiten einer Domain ausschließlich über eine SSL-Verbindung aufgerufen werden, so kann dies über einen Eintrag in der .htaccess Datei im Startverzeichnis der Domain eingerichtet werden:

RewriteCond %{SERVER_PORT} !^443$
RewriteRule (.*) https://%{HTTP_HOST}/$1 [L]
In der ersten Zeile wird die Funktion zum Umschreiben von URLs im Apache Webserver aktiviert. In der zweiten Zeile wird die Bedingung definiert "Wenn der Aufruf nicht auf Port 443 erfolgt" (Port 443 wird für SSL-Verschlüsselung verwendet, Port 80 für unverschlüsselte Aufrufe). Zeile 3 ist die Regel für das Umschreiben der URL. Wenn die Bedingung aus Zeile 2 zutrifft, werden die Aufrufe einer beliebigen Seite auf die gleiche Domain (${HTTP_HOST}) jedoch über das https:// Protokoll umgeleitet. Mit /$1 wird die ursprüngliche URL (z.B. impressum.html) an den Domainnamen angefügt. Mit dem Parameter [L] wird angegeben, dass das Umschreiben der URLs hier enden soll, weitere Zeilen in der .htaccess Datei werden also ignoriert.

====Domain name-of-domain.net nach name-der-domain.de umleiten====

Oftmals werden für ein Projekt mehrere Domains registriert, um verschiedene Schreibweisen abzudecken. Nach außen wird eine Hauptdomain kommunziert (Beispiel: name-der-domain.de als Hautpdomain, dazu name-of-domain.net als Zusatzdomains).

Mit folgendem Eintrag in der .htaccess Datei werden alle Aufrufe für name-of-domain.net nach name-der-domain.de weitergeleitet:

RewriteCond %{HTTP_HOST} ^(www\.)?name-of-domain\.net$ [NC]
RewriteRule ^(.*)$ http://www.name-der-domain.de/$1 [R=301,L]
Die Weiterleitung nach name-der-domain.de erfolgt dabei mit dem Statuscode 301 (permanent), so dass auch in Suchmaschinen auf Dauer nur diese erscheint. Dadurch werden Probleme mit "doppeltem Inhalt" (Duplicate Content) vermieden. Alle bei der ursprünglichen Domain übermittelten Parameter werden an die Zieldomain weitergegeben.

====Einer Domain immer www. voranstellen====

Mit folgendem Eintrag in der .htaccess Datei werden alle Aufrufe für eine Domain ohne www auf die Variante mit www weitergeleitet:

RewriteCond %{HTTP_HOST} ^name-der-domain\.de$ [NC]
RewriteRule ^(.*)$ http://www.name-der-domain.de/$1 [R=301,L]
Die Weiterleitung nach www.name-der-domain.de erfolgt dabei mit dem Statuscode 301 (permanent), so dass auch in Suchmaschinen auf Dauer nur diese erscheint.

====Domain auf eine Seite leiten====

Bestimmte Domains oder Subdomains sollen entweder mit oder ohne www auf eine bestimmte Unterseite weitergeleitet werden.

Dazu fügen Sie folgende Zeilen in Ihre .htaccess ein:

#Ohne realurl:
RewriteCond %{HTTP_HOST} ^(www\.)?name-der-domain\.de
RewriteRule ^$ /index.php?id=85

#oder realurl/simulatestatic mit html Suffix:
RewriteCond %{HTTP_HOST} ^(www\.)?name-der-domain\.de
RewriteRule ^$ /unterseite.html

#oder realurl ohne html Suffix:

RewriteCond %{HTTP_HOST} ^(www\.)?name-der-domain\.de
RewriteRule ^$ /unterseite/

====Weiterleitung auf eine andere Domain zu einer Unterseite====

RewriteCond %{HTTP_HOST} ^(www\.)?name-of-domain\.net [NC]
RewriteRule ^(.*)$ http://www.name-der-domain.de/unterseite.hmtl [R=301,L]
Redirect mit ? in der URL

http://www.domainname.de/index.php?id=7
soll nach

http://www.domainname.de/impressum.html
umgeleitet werden. Das Problem ist das ? in der alten URL und muss per QUERY_STRING in der Condition abgefragt werden.
Lösung:

RewriteCond %{QUERY_STRING} ^id=7$
RewriteRule ^.*$ http://www.domainname.de/impressum.html? [L,R=301]
Wichtig ist auch der Browser-Cache. Der sollte unbedingt geleert werden, denn wenn ein Aufruf noch im Cache drin ist kann dadurch u.U. immer auf die falsche Seite leiten.

So verhindert man, dass alte durch einen Umzug oder Neuprogrammierung nicht mehr vorhandene URLs in den Suchmaschinen zu einem schlechteren Ranking

=== Weitere Beispiele (älter) ===

Hinweis: eine Alternative hierfür ist eine PHP Weiterleitung ([[PHP - Tipps und Tricks]])
Quelle Dr.Web 28.12.2006

Sie können sowohl Zugriffe auf bestimmte Dateien als auch auf Verzeichnisse bequem weiterleiten. Das klappt innerhalb der eigenen Domain, aber auch mit externen Verweisen.

Die Datei .htaccess kann mit jedem Text-Editor bearbeitet werden. Eine Umleitung könnte so aussehen:

Redirect /beispielverzeichnis http://www.drweb.de

Ruft jemand die URL http://www.drweb.de/beispielverzeichnis auf landet er ohne weiteren Zwischenstopp direkt auf der Startseite.

Mit Einzeldateien klappt es auch:

Redirect /beispielseite.shtml http://www.drweb.de

oder

Redirect /beispielseite.shtml neueseite.shtml

Wer mag, kann die gesamte Domain auf eine andere umleiten

Redirect / http://www.drweb.de/

Nützlich während Bauarbeiten, bei Reparaturen oder wenn Dateien durch andere ersetzt wurden. Da die Umleitung serverseitig geschieht, spielt der Browser des Besuchers keine Rolle.

Weitere nützliche Beispiele:

Den Domainnamen ohne www auf den mit www umleiten. Es wird der Code 301 mitgegeben.
<pre>
RewriteEngine on
RewriteCond %{HTTP_HOST} !^www\. [NC]
RewriteRule ^(.*)$ http://www.%{HTTP_HOST}/$1 [L,R=301]
</pre>
=== Weiterleitung auf sichere Verbindung (https) ===

== Umleitung auf https ==
Sichere Seiten sind seid 2019 Standard und quasi Pflicht. Mit diesem Code kann man von http auf https weiterleiten und gibt einen 301 (Moved Permanently) Header mit.
<pre>
<IfModule mod_rewrite.c>
# Enable URL rewriting
RewriteEngine On
# Redirect to https
RewriteCond %{SERVER_PORT} !^443$
RewriteRule (.*) https://%{HTTP_HOST}/$1 [R=301,L]
</IfModule>
</pre>

=== Moved Permanently 301 Redirect ===
Quelle:http://www.fladi.de/2008/04/28/howto-webseiten-redirect-mit-301/ (25.7.2008)

Was ist ein 301 redirect?

301 redirect ist die wohl beste Möglichkeit das aktuelle Suchmaschinenranking beim Umzug einer Seite oder des gesamten Webauftritts zu behalten. Der Code “301″ steht für “moved permanently” (dauerhaft verschoben). Ein solches Redirect wird in der .htaccess Datei eintragen. Es trägt die Form (alles in einer Zeile):

redirect 301 pfad/alte/seite/datei.html http://www.domain.de/pfad/neue/seite/datei.html

Beachte, kein “http://www” in das erste Statement zu schreiben. Es muss der komplette Pfad vom Root deines Webservers angegeben werden. Schauen wir uns die Zeile nun nochmal genauer an:

* “redirect 301″ - die eigentliche Anweisung für den Webserver
* “/pfad/alte/seite/datei.html” - die Seite die umgeleitet werden soll
* “http://www.domain.de/pfad/neue/seite.datei.html” - die komplette neue URL

Wie reagiert nun ein Suchmaschinen-Spider auf eine solche Umleitung? Die .htaccess wird ja nicht vom Spider ausgelesen, sondern vom Webserver “ausgeführt”. Der Spider jedoch erkennt den Statuscode, den der Webserver liefert. Beim nächsten Update seiner Datenbank sollte die Suchmaschine nun die alte URL aus dem Index werfen und die neue aufnehmen. Häufig kommt es aber auch vor, dass alte und neue URL gemischt auftauchen. Auch leichte Änderungen im Pagerank können auftreten. Es dauert so ca. 6-8 Wochen bis sich die Änderungen an der Seite auch in den Suchergebnissen niederschlagen.

Weitere Möglichkeiten von 301 redirect:

1. Um ALLE Dateien Deiner Domain mithilfe einer .htaccess umzuleiten kannst Du (auf einem Unix/Linux-Webserver) i.d.R. folgendes verwenden:
redirect 301 ^(.*)$ http://www.domain.de
redirectMatch permanent ^(.*)$ http://www.domain.de

Um Deine alte Startseite (index.html) umzuleiten:
redirect 301 /index.html http://www.domain.de/index.html
redirect permanent /index.html http://www.domain.de/index.html

2. Wenn Du http://domain.de auf http://www.domain.de umleiten möchtest und mod_rewrite auf dem Webserver verfügbar ist, erreichst Du dies durch folgende .htaccess:

Options +FollowSymLinks
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain\.de
RewriteRule ^(.*)$ http://www.domain.de/$1 [R=permanent,L]

oder

Options +FollowSymLinks
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain\.de$ [NC]
RewriteRule ^(.*)$ http://www.domain.de/$1 [R=301,L]

3. Alle .html Dateien auf .php Dateien umzuleiten ist durch mod_rewrite auch kein großes Problem:

RewriteEngine on
RewriteBase /
RewriteRule (.*).html$ /$1.php

4. Um ein Verzeichnis und alles darunter umzuleiten:

redirectMatch 301 ^/verzeichnis-alt/(.*) http://www.domain.de/verzeichnis-neu/

=== Warum nicht per META-Tag redirect machen? ===

Die Umleitung per META-Tag erfolgt direkt in der aufgerufenen Seite. Dort wird im HEAD-Teil

<meta http-equiv=”refresh” content=”0; url=http://www.domain.de/”>
eingetragen. Hierbei bewirkt das “content=10″, dass der Browser nach 10 Sekunden die darauffolgende URL aufruft. Wenn man “content=0″ einträgt wird die Umleitung sofort ausgeführt. Ein paar alte Browser unterstützen diese Art der Umleitung nicht. Deshalb ist es besser noch zusätzlich den Link (neue Domain) mit anzugeben.

Technisch gesehen liefert die angefragte Seite, wie auch die Seite auf die umgeleitet wird, einen Statuscode “200 OK” zurück. Es sind also zwei unabhängige Seiten. Dementsprechend versucht die Suchmaschinen auch beide Seiten zu indizieren. Hier genau liegt aber das Problem. Denn der Spider des Suchmaschinenbetreibers erkennt die Umleitung und wertet Deine Seite deshalb u.U. ab, da es sich um eine beliebte SPAM-Methode handelt. So könnte man 1000 Domains mit solchen Seiten und jeder Menge Keywords einrichten. Echte Besucher (kein Spider) werden umgeleitet auf die eigentliche Seite. Indiziert wird aber nicht nur die eigentliche Seite sondern auch die 1000 Domains mit Keywords, die meist gar nichts mit dem eingentlichen Inhalt zu tun haben.

Beim 301 redirect wird hingegen nur die echte Zielseite in den Index aufgenommen und durch den Statuscode kann der Suchmaschinenbetreiber zusätzlich noch die veralteten Seite aus dem Index werfen. Dies ist also der beste Weg um alte Seiten auf neue umzuleiten und gleichzeitig wird auch der Page Rank mit übertragen.

===Weiterleitung über IP===
<pre>
Options +FollowSymlinks
RewriteEngine on

#IP Bedingung
RewriteCond %{REMOTE_HOST} ^85\.13\.128\.137

#Zielseite erlauben
RewriteCond %{REQUEST_URI} !/ip-remote\.php$

#Umleiten
#RewriteRule ^/* http://demo.webmynet.de/ip-remote.php [R,NE,NC]
RewriteRule /(.*)$ /ip-remote.php [R=302,L]
</pre>

== Erlaubte Anweisungen in .htaccess-Dateien ==

http://de.selfhtml.org/servercgi/server/htaccess.htm

Auszug (Datum des Zugriffs: 10.9.2007):
<pre>
Die Anweisung AllowOverride kann nicht innerhalb einer .htaccess notiert werden, sondern wird ausschließlich vom Server-Administrator in der zentralen Konfigurationsdatei vorgegeben. Um den AllowOverride-Wert in Erfahrung zu bringen, benötigen Sie Einsicht in die Serverkonfiguration. Kontaktieren Sie dazu gegebenenfalls Ihren Webhosting-Provider. Dieser kann den Wert auch ändern, falls Sie bestimmte bisher nicht erlaubte Anweisungen verwenden möchten. Im einzelnen gibt es dafür folgende mögliche Werte:

* Mit AllowOverride None wird der Webserver angewiesen, .htaccess-Dateien zu ignorieren. Das ist im Übrigen die Voreinstellung.
* Mit AllowOverride All wird festgelegt, dass in einer .htaccess-Datei (so gut wie) sämtliche zentrale Vorgaben überschrieben und damit abgeändert werden dürfen. Das kann bedeuten, dass Vorhaben, die eigentlich verboten sind (beispielsweise die Ausführung von CGI-Scripts), mit Hilfe einer .htaccess-Datei erlaubt werden. Als Server-Administrator werden Sie diese Anweisung also nur sehr vorsichtig einsetzen.
* Mit AllowOverride Options wird festgelegt, dass in einer .htaccess-Datei nach unten Anweisungen zur Steuerung spezieller Verzeichniseigenschaften zulässig sind.
* Mit AllowOverride Limit wird festgelegt, dass in einer .htaccess-Datei nach unten Zugriffe von bestimmten Hosts erlaubt oder untersagt werden können.
* Mit AllowOverride Indexes wird festgelegt, dass in einer .htaccess-Datei nach unten Anweisungen zur Steuerung von Verzeichnisindizes zulässig sind.
* Mit AllowOverride FileInfo wird festgelegt, dass in einer .htaccess-Datei Anweisungen zur Akzeptanz bestimmter Dokumenttypen zulässig sind - beispielsweie, um nach unten Individuelle Fehlermeldungen ausgeben zu können.
* Mit AllowOverride AuthConfig wird festgelegt, dass in einer .htaccess-Datei Autorisierungsanweisungen stehen dürfen - das betrifft beispielsweise Regelungen zum nach unten Passwortschutz.

Diese Werte können auch miteinander kombiniert werden. All ist der mächtigste Parameter, mit dem alles das zugelassen wird, was die anderen Parameter steuern.
</pre>

Nach dem Ändern muß natürlich der Server neu gestartet werden (bei Debian: apache restart)

==IP Adressen sperren==

Manchmal ist es notwendig, bestimmte IP Adressen vom Aufruf der Webseite auszusperren, z.B. bei einem Angriffsversuch auf die Webseite. Über folgenden Eintrag in der .htaccess Datei (z.B. vor dem Eintrag 'RewriteEngine On') im Startverzeichnis der Seite lassen sich unerwünschte Besucher abweisen:

order allow,deny
deny from 192.168.2.17
deny from 10.10.20.63
allow from all
Bei mehreren IP Adressen wird jede in eine eigene Zeile eingetragen. Die Einstellung gilt auch für alle Unterverzeichnisse. Wenn jemand mit einer gesperrten Adresse versucht, die Seite aufzurufen, erhält er einen 403 Fehlercode.

==HTML5 Videos / bestimmte Dateitypen zulassen ==

Falls es in einzelnen Browsern zu Problemen beim Abspielen von per HTML5 eingebundenen Videos kommt, helfen eventuell folgende Zeilen in der .htaccess Datei im Projektverzeichnis:

AddType video/ogg .ogm
AddType video/ogg .ogv
AddType video/ogg .ogg
AddType video/webm .webm
AddType audio/webm .weba
AddType video/mp4 .mp4
AddType video/x-m4v .m4v

== htaccess für Typo3 ==

http://www.typo3lexikon.de/server/htaccess.html (11/2014)

<pre>
.htaccess für TYPO3
Ich möchte auf dieser Seite nicht erklären wie .htaccess-Dateien erstellt werden. Nein. Davon gibt es schon zu genüge Dokumentationen im Web:

Allgemeines zu htaccess

URLs manipulieren

Reguläre Ausdrücke

htaccess Beispiele

Auf dieser Seite geht es mehr um das Zusammenspiel von TYPO3 und htaccess-Dateien gerade in Bezug unter der Verwendung von der Extension RealUrl. In den nächsten Zeilen werde ich Euch meine htaccess-Datei in Detail näher erklären:

RewriteEngine
Mit RewriteEngine kannst Du das Modifizieren von URLs de- bzw. aktivieren. Erst wenn diese Option aktiviert ist, kannst du z.B. alle Anfragen, die an Deinen Server gesendet werden auf eine völlig andere Webseite umleiten.
RewriteEngine On
Bestimmte Verzeichnisse nicht umschreiben
Wenn Ihr RealUrl installiert habt, dann erhaltet Ihr je nach Konfiguration URLs wie

/meine-seite/kontakt/impressum.html
Dabei sind die vermeintlichen Ordner gar keine echten Ordner auf dem Server, sondern Informationen, die an die index.php weitergeleitet werden, um dann die gewünschte Seite aufrufen zu können. Was aber, wenn wir wirklich mal einen Ordner auf dem Server öffnen wollen? Dann darf dieser Name des Ordner NICHT an die index.php weitergeleitet werden. Um das zu erreichen verwende ich das Script aus der RealUrl-Dokumentation:
RewriteRule ^typo3$ - [L]
RewriteRule ^typo3/.*$ - [L]
RewriteRule ^uploads/.*$ - [L]
RewriteRule ^fileadmin/.*$ - [L]
RewriteRule ^typo3conf/.*$ - [L]
Hinweis
[L] bedeutet, dass nach dieser Umschreibung der URL keine weiteren Umschreibungen mehr ausgeführt werden.

Der Bindestrich (-) bedeutet, dass keine Umschreibung der URL stattfinden soll.

Doppelter Content
Wer von Euch seine Seite schon mal mit www.seitwert.de bewertet hat, wird bestimmt schon mal über den Eintrag bzgl. doppelten Content/Inhalt gestoßen sein. So kommt es je nach Konfiguration vor, dass eine Seite wie sfroemken.de das Gleiche anzeigt wie www.sfroemken.de. Dieses "Problem" kann sich auch negativ auf die Position in den Suchergebnissen auswirken. Aber auch das lässt sich mit Hilfe der htaccess-Datei bereinigen:

RewriteCond %{HTTP_HOST} ^sfroemken\.de$ [NC]
RewriteRule ^(.*)$ www.sfroemken.de/$1 [R=301,L]
Erklärung
%{HTTP_HOST} kann in diesem Fall sfroemken.de oder aber auch www.sfroemken.de sein. Mit RewriteCond könnt Ihr nun überprüfen, ob der HTTP_HOST mit dem Wert sfroemken.de übereinstimmt. Dank [NC] soll die Groß- und Kleinschreibung bei diesem Vergleich nicht berücksichtigt werden.

Wenn RewriteCond nun ein true zurück gibt, dann wird die Modifikation in RewriteRule ausgeführt. Alles was durch die Klammern markiert wurde, kann im zweiten Parameter mit $1 wiederverwendet werden. [R=301]: Das R steht für redirect und die 301 ist ein bestimmter Servercode, mit dem bestimmt wird, dass es sich bei dieser Weiterleitung um eine parmanente Weiterleitung handelt.

So wird aus

sfroemken.de/kontakt/index.php
ein

www.sfroemken.de/kontakt/index.php
Subdomains
Bei Subdomains müssen wir das genau andersrum machen. Dort gibt es kein www. Da www.seitwert.de aber trotzdem überprüft, ob die Domain auch mit einem www davor erreichbar ist, müssen wir das folgendermaßen abfangen:

RewriteCond %{HTTP_HOST} ^www\.typo3\.sfroemken\.de$ [NC]
RewriteRule ^(.*)$ typo3.sfroemken.de/$1 [R=301,L]
Ordner
Leider haben sich viele Surfer daran gewöhnt Ordner auf einem Server ohne abschließendem Slash (/) anzugeben. Damit dieser Slash automatisch hinten dran gemacht wird, können wir folgendes Script verwenden:
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule (.*[^/])$ %{HTTP_HOST}/$1/ [L,R]
Erklärung
Die ersten beiden RewriteCond fragen ab, ob es sich bei der aufzurufenden URL nicht um eine Datei handelt und nicht um einen symbolischen Link. Wenn beides zutrifft, kann getrost ein zusätzlicher Slash hinten angefügt werden.

Achtung
Wenn Ihr RealUrl so konfiguriert habt, dass Ihr URLs wie

/kontakt/impressum.html
erhaltet, dann muss das Script noch etwas angepasst werden, dann ansonsten erhaltet Ihr eine URL wie diese hier:

/kontakt/impressum.html/
Hier das angepasste Script:

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteCond %{REQUEST_FILENAME} (^.htm$|^.html$)
RewriteRule (.*[^/])$ %{HTTP_HOST}/$1/ [L,R]
Heißt: Wenn die URL mit .htm oder .html endet, dann soll der zusätzliche Slash NICHT hinten dran gemacht werden.

Index-Dateien in Ordnern
Je nach Projekt und Ordner kann es vorkommen, dass Du trotz RealUrl die Index-Dateien in bestimmten Ordnern ausführen möchtest:

/fileadmin/projekt/download/index.php
Allerdings wird derzeit noch diese URL an die TYPO3-eigene index.php im Rootverzeichnis weitergeleitet. Um auch das zu unterbinden sind folgende 6 Zeilen vorgesehen:
RewriteCond %{REQUEST_FILENAME}/index.html -f
RewriteRule / %{REQUEST_URI}/index.html [L]
RewriteCond %{REQUEST_FILENAME}/index.htm -f
RewriteRule / %{REQUEST_URI}/index.htm [L]
RewriteCond %{REQUEST_FILENAME}/index.php -f
RewriteRule / %{REQUEST_URI}/index.php [L]
URL-Modifikation für RealUrl
Dieses Script ist das wichtigste Script überhaupt für RealUrl. Hier wird nun endlich gesagt, dass alle Teile aus der URL an die TYPO3-eigene index.php weitergeleitet werden sollen zur Weiterverarbeitung durch RealUrl.
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* index.php
Hinweis
Je nach Art Eurer TYPO3-Installation könnte es sein, dass Eure index.php ein symbolischer Link ist. In diesem Fall müsst Ihr die letzt Zeile folgendermaßen ändern:

RewriteRule .* /index.php
Scripmerger
Dieses Script benötigt Ihr nur, wenn Ihr die Extension scriptmerger verwenden wollt:
# Expires Header + Removal of ETag
<FilesMatch "\.(ico|png|gif|js|css|jpg|jpeg|swf)">
<IfModule mod_expires.c>
ExpiresActive on
ExpiresDefault "access plus 7 days"
ExpiresDefault "access plus 2 months"
</IfModule>

# ETag
FileETag MTime Size
<IfModule mod_headers.c>
FileETag none
Header unset Last-Modified
</IfModule>
</FilesMatch>

# Compressed Content
<FilesMatch "\.gz\.(js|css)">
<IfModule mod_headers.c>
Header set Content-Encoding gzip
</IfModule>
</FilesMatch>
</pre>
=== Shell Restriction auf all-inkl Server ===
Ab TYPO3 6 moniert das Install Tool das exec nicht augeführt werden darf. Es funktioniert wenn man die cgi Version von PHP nimmt. Das kann man per htaccess oder im KAS Backend einstellen.

Beispiele.
<pre>
AddHandler php55-cgi .php (sofern vom Server unterstützt)
AddHandler php54-cgi .php (sofern vom Server unterstützt)
AddHandler php53-cgi .php
AddHandler php52-cgi .php
AddHandler php5-cgi .php (Version entsprechend der PHP Apache-Modul Version)
</pre>

=== PHP Version auf Weiland Servern ===
Über die PHP-Versionsauswahl im Kundenmenü können Sie die PHP-Version für eine Domain ändern. Folgende Anleitung erklärt, wie Sie die PHP Version für einzelne Verzeichnisse (und deren Unterverzeichnisse) ändern können.

Das Verzeichnis kann dabei nur eine höhere PHP-Version erhalten, als die PHP-Version, die für die Domain im Kundenmenü eingestellt ist.

Das bedeutet: Ist für die Domain PHP 5.6 im Kundenmenü eingestellt, können Sie für einzelne Verzeichnisse PHP 7.0 und höher einstellen, nicht jedoch niedrigere Versionen wie PHP 5.5. *

Außerdem darf für die Domain kein Fast-CGI aktiviert sein.

Um die PHP-Version für ein Verzeichnis zu ändern, legen Sie eine .htaccess-Datei mit folgender Anweisung in dem Verzeichnis ab. Die Anweisung ist abhängig von der PHP-Version, die Sie aktivieren möchten:
AddType application/x-httpd-php72 .php

Htaccess

2021-09-03T09:05:53Z

134.3.85.26: /* Weiterleitung mit .htaccess */

== Anwendung von .htaccess - Dateien ==
=== Weiterführende Links: ===
https://jweiland.net/know-how/internet/htaccess-konfigurieren.html#c2756

http://httpd.apache.org/docs/1.3/howto/htaccess.html

von: http://www.uni-duesseldorf.de/Service/Webmaster/htaccess.php3 Juli 2006

Referenz: Apache Manual: http://www.uni-duesseldorf.de/apache-manual/

[[Apache Mod Rewrite Syntax]]

=== Wozu braucht man das ?===
An wen ein HTTP-Server Dokumente herausgibt, welche spezielle Verarbeitung er u.U. bei einer spezifischen Anforderung (einem request) durchführt - all das wird zunächst durch eine von der Server-Software abhängigen Konfiguration bestimmt, die ein Administrator - ein Webmaster - eingerichtet hat.

Oft ist es aber wünschenswert, daß einzelne Verantwortliche für eine Dokumentenhierarchie auf dem Web-Server selbst ohne Intervention des Webmasters Setzungen vornehmen können, daß z.B. auf einzelne Dokumente oder alle in einem bestimmten Verzeichnis nur ein Zugriff aus bestimmten Domains oder mit verifiziertem Usernamen möglich ist.

Beim Apache-HTTP-Server wie seinem Vorgänger, dem NCSA-httpd, gibt es diese Möglichkeiten durch die Einrichtung von .htaccess-Dateien in dem jeweiligen Verzeichnis. In der folgenden Darstellung wird als Referenz jeweils ein Verweis auf den entsprechenden Abschnitt in der lokale Kopie der Apache-Dokumentation für die Version 1.2 gegeben.

'''Achtung:''' In der Server-Konfiguration kann ein anderer Name als .htaccess vereinbart sein (AccesFileName-Direkt ive).

'''Zweiter Hinweis:''' Die Datei muß für den HTTP-Server lesbar sein, z.B. dadurch erreicht, daß sie öffentlich lesbar ist:

chmod 644 .htaccess

=== Zugriffsbeschränkung auf eine Domain ===
==== für alle Dateien in einem Verzeichnis ====
'''.htaccess'''

order deny,allow
deny from all
allow from .uni-duesseldorf.de 134.99

Alle Dateien in dem Verzeichnis werden nur an Clients ausgeliefert, die eine IP-Adresse beginnend mit 134.99 oder einen Hostnamen endend mit uni-duesseldorf.de besitzen; anderenfalls erfolgt eine Fehlermeldung des Servers (403 Forbidden).

Natürlich genügt in vielen Fällen eine der Alternativen. Beachten Sie dabei die Unterschiede:

* Die Angabe des Domain-Namens allein schließt - bewußt oder nicht - den Zugriff von PC's aus, die nicht im Domain Name System (DNS) registriert sind.
* Die Angabe des IP-Subnetzes allein kann andere ausschließen, die organisatorisch zur gleichen Domain gehören, technisch aber in einem anderen Subnetz hängen.

Wie lässt sich diese Zugriffsbeschränkung testen? Normalerweise benötigt man dazu einen Internet-Zugang über einen anderen Provider (T-Online, AOL, Compuserve etc.). Oder man benutzt einen Browser auf dem Server selbst z.B. in folgender Weise:

lynx http://localhost/Service/Webmaster/htaccess.phtml

Der Zugriff erfolgt dann über das Loopback-Interface mit der IP-Adresse 127.0.0.1.

Referenz: order, deny, allow.

==== für einzelne Dateien ====
'''.htaccess'''

<Files huh*.html>
order deny,allow
deny from all
allow from .uni-duesseldorf.de 134.99
</Files>

Die Zugriffsbeschränkung wie oben gilt jetzt nur für die Dateien, deren Namen auf das hinter Files angegebene Muster passen. Es kann ein einzelner Name angegeben werden oder ein Muster mit den Wildcard-Zeichen ? für ein beliebiges einzelnes Zeichen oder * für eine beliebige Folge von Zeichen.

Schließlich sind auch feinere Muster über reguläre Ausdrücke möglich. Die Syntax der Files-Direktive dafür ist:

<Files ~ "regexp">

Referenz: <Files>, order, deny, allow.

=== Zugriffsbeschränkung über Passwort ===
==== für ein Verzeichnis ====
'''.htaccess'''

AuthType Basic
AuthName MeyersLeute
AuthUserFile /home/meyer/passwd
require valid-user

Dokumente in einem Verzeichnis mit dieser .htaccess-Datei (oder einem Unterverzeichnis) können erst nach Eingabe eines gültigen Benutzernamen und Passwortes gelesen werden. Der Wert hinter AuthName wird vom Browser in der Dialog-Box für die Passwortabfrage angezeigt und dient gleichzeitig dazu, andere Dokumente mit dem gleichen Schutz zu erkennen und einmal eingelesene Werte für Username und Password ohne erneute Abfrage unmittelbar zu verwenden.

Hinter AuthUserFile steht der Pfad der Passwortdatei, die die Benutzernamen und (verschlüsselten) Passwörter enthält. Sie sieht etwa so aus:

/home/meyer/passwd

meyer:xm.kPd4VJc3Fo
mueller:eJFQCL8GftDXI

Auch die Passwortdatei muß für den HTTP-Server lesbar sein. Gerade deshalb sollte sie niemals in demselben Bereich liegen wie die vom Server bedienten Dokumente, da sonst zumindest die gültigen Benutzernamen lesbar wären. (Aus diesem Grund müssen Sie aber u.U. daran denken, auch das entsprechende Verzeichnis - wie /home/meyer im Beispiel - für den HTTP-Server zumindest suchbar zu setzen, also etwa:

chmod 711 /home/meyer

Angelegt und gepflegt werden kann die Passwortdatei mit dem Programm htpasswd:

htpasswd -c /home/meyer/passwd meyer
htpasswd /home/meyer/passwd mueller

Referenz: AuthType, AuthName, AuthUserFile, require.

==== für einzelne Dateien ====
'''.htaccess'''

AuthType Basic
AuthName MeyersLeute
AuthUserFile /home/meyer/passwd
<Files Huh*.html>
require user meyer mueller
</Files>

Die Kombination von 2. und 3. - Passwortschutz für einzelne Dateien in dem aktuellen Verzeichnis. Beim require wird hier noch eine andere Alternative gezeigt: die Aufzählung einzelner Benutzernamen aus der Passwortdatei. Wenn neue Benutzer in der Passwortdatei ergänzt werden, haben diese noch keinen Zugriff auf die so geschützten Seiten.

Wenn die gleiche Liste von Benutzern an mehreren Stellen verwendet werden soll, ist die Definition der Liste über eine Gruppendatei empfehlenswert. Für diese dritte Alternative bzgl. der require-Direktive sind fogende Änderungen notwendig:

1. In der .htaccess-Datei wird eine Gruppendatei angegeben:
AuthGrouprFile /home/meyer/groups
Für den Ort der Ablage dieser Datei gelten dieselben Erwägungen wie für die Passwortdatei oben.
2. In der require-Direktive wird jetzt auf eine Gruppendefinition in der Gruppendatei Bezug genommen:
require group meyers
3. Die Gruppendatei ist eine einfache Textdatei mit je einer Gruppendefinition pro Zeile in folgender Form:

/home/meyer/groups
meyers: meyer mueller

Referenz: AuthType, AuthName, AuthUserFile, AuthGroupFile, <Files>, require.

===Spezielle Optionen===
==== automatischer Index (Directory Listing)====
ausführliche Infos hier: [[htaccess - Directory Listing]]

'''.htaccess'''
Options +Indexes

Mittels der Options-Direktive können - so von der globalen Server-Konfiguration her erlaubt - Voreinstellungen für Verarbeitungsoptionen für das aktuelle Verzeichnis und Unterverzeichnisse überschrieben werden.

Die gezeigte Variante weist den Server an, bei der Referenz auf das aktuelle Verzeichnis oder ein Unterverzeichnis ein Directory-Listing als Index-Datei automatisch zu generieren. Er macht dies allerdings nur, wenn nicht schon eine Index-Datei (mit vordefiniertem Namen wie index.html) vorhanden ist. Ggf. kann man die hier bekannten Namen mit der Direktive

DirectoryIndex Welcome.html

einschränken.

Referenz: Options, DirectoryIndex.

==== Automatischer Index mit User Auth ====
(Quelle Weiland s.o.)
Directory Listing

Soll über einer geschützen Unterseite (z.B. fileadmin/downloads) des Internetauftritts ein Directory Listing realisiert werden, dann sollte die .htaccess wie folgt eingestellt werden:

AuthType Basic
AuthName "system - "
Options +Indexes
IndexOptions +FancyIndexing
AuthUserFile /*ihr_serverpfad/projektpfad/filadmin/downloads/.htpasswd
AuthGroupFile /dev/null
require valid-user

* ihr_serverpfad finden Sie in Ihrem Kundenmenu unter Technische Infos oder durch Eingabe des Befehls $PWD in der Shell.

Den User mit verschlüseltem Passwort in dem Fall in der .htpasswd vorhanden sein.

Die Unterseite mit dem Directory Listing muss von der TYPO3 index.php ausgeschlossen werden und erreichen Sie über die .htaccess in dem Projektverzeichnis mit folgenden Angaben nach der RewriteEngine On:

RewriteRule ^fileadmin/downloads/$ - [L]
RewriteRule ^fileadmin/downloads/.*$ - [L]

==== Startdatei festlegen ====
Mit dem vorigen Beispiel kann man auch festlegen welche Dateien beim Aufruf eines Verzeichnisses (oder der Webadresse) an den Browser geliefert werden sollen. Manchmal hat man den Fall das die Startdatei eines CMS index.php heißt und bei Wartungsarbeiten die Datei index.html aufgerufen werden soll.

DirectoryIndex index.html index.php start.html

weist den Apache an falls vorhanden die Datei index.html aufzurufen, wenn nicht die index.php und so weiter.

Bei Wartungsarbeiten kann man nun einfach eine index.html aufspielen die bei Aufruf der Domain angezeigt wird.

==== PHP - Werte setzen ====
Wenn der Server das erlaubt kann man es folgendermaßen machen:
===== PHP Memory Limit =====
php_value memory_limit 256M
===== PHP Execution Time =====
php_value max_execution_time 240

==== Error Reporting ====
===== Produktiv Betrieb =====
(Fehler unterdrückt aber protokolliert)

php_value error_reporting 2047
php_value display_errors 0
php_value log_errors 1
php_value error_log /eigener/pfad/fehler.log

===== Entwicklung =====
hier sollte display_errors auf 1 stehen

siehe auch [[PHP - Error Reporting / Fehlerbehandlung]]

siehe auch [[TYPO3 - Error Reporting / Fehlerbehandlung]]

==== Skripte sperren ====
z.B. bei Überlastung durch ein Skript (hier im Beispiel meineDomain.de/ajax/

<pre>
RewriteEngine On
RewriteCond %{REQUEST_URI} (.*)ajax(.*) [NC]
RewriteRule ^(.*) - [F]
</pre>

== Browser Caching ==
Beispiel:
<pre>
<IfModule mod_expires.c>
ExpiresActive On
ExpiresByType text/html "access plus 500 seconds"
ExpiresByType image/gif "access plus 14 days"
ExpiresByType image/ico "access plus 14 days"
ExpiresByType image/jpeg "access plus 14 days"
ExpiresByType image/jpg "access plus 14 days"
ExpiresByType image/png "access plus 14 days"
ExpiresByType text/css "access plus 14 days"
ExpiresByType text/javascript "access plus 14 days"
ExpiresByType application/x-javascript "access plus 14 days"
ExpiresByType application/javascript "access plus 14 days"
</IfModule>
</pre>
== Zugriff auf Ordner ==
=== Sperren ===
<pre>
# This file restricts access to the fileadmin/user_upload/_import_export_ directory. It is
# meant to protect temporary files which could contain sensible
# information. Please do not touch.

# Apache < 2.3
<IfModule !mod_authz_core.c>
Order allow,deny
Deny from all
Satisfy All
</IfModule>

# Apache ≥ 2.3
<IfModule mod_authz_core.c>
Require all denied
</IfModule>
</pre>

== Weiterleitung mit .htaccess ==
=== Beispiele mit Fokus auf TYPO3 ===
Quelle Weiland (s.o.)
====Weiterleitungen (Redirects)====
===== Common Cases =====
http auf https umleiten

Weiterleitung von http auf https mit Berücksichtigung der Subdomain (www.)

Damit sowohl die Weiterleitung von http auf https, als auch die Weiterleitung von nicht www. auf www. aktiv wird, müssen Sie den folgenden Codeschnipsel in die .htaccess Datei Ihres Webprojekts einfügen:
<pre>
<IfModule mod_rewrite.c>

RewriteEngine On

RewriteCond %{HTTP_HOST} !^www.domain.de$ [NC]
RewriteRule ^(.*)$ https://www.domain.de/$1 [L,R=301]

RewriteCond %{SERVER_PORT} !=443
RewriteRule ^(.*)$ https://www.domain.de/$1 [R=301,L]

</IfModule>
</pre>
Die Weiterleitung funktioniert jetzt wie folgt:

http://www.domain.de wird auf https://www.domain.de weitergeleitet.

http://domain.de wird auf https://www.domain.de weitergleitet.

https://domain.de wird auf https://www.domain.de weitergeleitet.

Wenn Sie die Schreibweise ohne www. bevorzugen, können Sie natürlich das Weiterleitungsziel entsprechend anpassen. Dafür müssen Sie einfach die URL Angabe bei "RewriteRule" anpassen und auf die Version ohne www. verweisen.

Einzelne Unterseiten weiterleiten

Aufrufe einer Unterseite (z.B. a.html) auf eine andere Unterseite (z.B. b.html) innerhalb der selben Domain weiterleiten.
Redirect 301 /a.html /b.html

Ganzen Ordner / Verzeichnis weiterleiten

Aufrufe eines Ordners (z.B. /a) auf einen anderen Ordner innerhalb der selben Domain (z.B. /b) weiterleiten. Die Weiterleitung wirkt sich auch auf alle Dateien innerhalb des Ordners /a aus, so wird z.B. der Aufruf von /a/test.html auf /b/test.html weitergeleitet.
Redirect 301 /a /b

Domain Weiterleitung: Ganze Domain umleiten

Aufrufe einer Unterseite (URL) von Domain A auf die selbe Unterseite (URL) unter Domain B weiterleiten.
z.B. domain-a.de/test.html auf domain-b.de/test.html weiterleiten wobei dies nicht nur für test.html, sondern auch für alle weiteren Unterseiten gilt.
Redirect 301 / http://www.domain-b.de/

Alternative Lösung mittels RewriteCond / RewriteRule:
RewriteEngine on
RewriteCond %{HTTP_HOST} domain-a.de$ [NC]
RewriteRule ^(.*) http://www.domain-b.de/$1 [R=301,L]

URLs ohne www. auf URLs mit www. weiterleiten

Standard Domain definieren und Aufrufe einer URL ohne die Subdomain www. auf die entsprechende URL mit www. weiterleiten um z.B. doppelte Inhalte für Suchmaschinen zu vermeiden.
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain.de$ [NC]
RewriteRule (.*) http://www.domain.de/$1 [R=301,L]

Alle Unterseiten auf Startseite weiterleiten

Alle Aufrufe auf Unterseiten einer Domain mit Ausnahme der index.html, der Style.css sowie aller Dateien im Ordner /img/ auf die Startseite weiterleiten.
RewriteEngine on
RewriteBase /
RewriteCond %{REQUEST_URI} !^/(index\.html|style\.css)?$ [NC]
RewriteCond %{REQUEST_URI} !^/img(/|$) [NC]
RewriteRule ^.*$ /index.html [L,R=301]
URL mit Parameter weiterleiten

Aufrufe von URLs welche einen bestimmten Parameter (z.B. test) enthalten, unabhängig von dessen Wert, auf ein Verzeichnis (z.B. /verzeichnis/) oder eine Unterseite weiterleiten.
RewriteEngine on
RewriteCond %{QUERY_STRING} ^test=(.*)$
RewriteRule ^(.*)$ /verzeichnis/? [R=301,L]

URLs mit einem bestimmten Parameterwert weiterleiten (In diesem Fall Wert "test" für den Parameter "s" auf das Verzeichnis "test" weiterleiten).
RewriteEngine on
RewriteCond %{QUERY_STRING} ^s=test$
RewriteRule ^(.*)$ /test/? [R=301,L]
Parameter aus URL entfernen

Aufrufe von URLs welche einen bestimmten Parameter (z.B. www.domain.de/verzeichnis/?test=...) enthalten, unabhängig von dessen Wert, auf die selbe URL ohne Parameter am Ende (z.B. www.domain.de/verzeichnis/) weiterleiten bzw. den den Parameter aus der URL entfernen. Falls die Regel nur für einen bestimmten Parameter Wert gelten soll, kann der Code analog zum vorherigen Beispiel modifiziert werden.
RewriteEngine on
RewriteCond %{QUERY_STRING} test=(.*)$
RewriteRule ^(.*)$ /$1? [R=301,L]

===== Allgemeines =====

Die Weiterleitung von Domains und Anfragen zu einzelnen Webseiten ist eine der Hauptanwendungen der .htaccess Datei. Das notwendige Apache Modul mod_rewrite ist in unseren Hosting Tarifen vorhanden.

Die Weiterleitung muss jedoch in der .htaccess Datei zunächst mit folgendem Eintrag aktiviert werden (in den weiteren Beispielen haben wir diese Zeile weggelassen):

RewriteEngine On
301 oder 302 Weiterleitung?

Der Weiterleitung (Redirect) sollte man noch einen Statuscode mitgeben: 301 oder 302. Worin liegt der Unterschied?

301: die Weiterleitung ist dauerhaft, z.B. weil die Navigationsstruktur einer Webseite umgestellt wurde

302: die Weiterleitung erfolgt nur vorübergehend, anschließend gilt wieder die bisherige Adresse

Am Ende der RewriteRule Zeile wird der Code für die Weiterleitung (Redirect) in eckigen Klammern angegeben. Mit dem zusätzlichen Parameter L (Letzter, Last) kann man festlegen, dass die weiteren Anweisungen in der .htaccess Datei ignoriert werden sollen. Hierzu ein Beispiel:

RewriteRule ^neues\.html$ /aktuelles.html [R=301,L]
Damit wird die Seite domain.tld/neues.html dauerhaft auf domain.tlld/aktuelles.htmlweitergeleitet.

Die Schreibweise der Rewrite Regeln basiert dabei auf "Regulären Ausdrücken" (Regular Expressions, regex).

Mit den Zeichen ^ und $ wird Anfang und Ende der umzuleitenden Seite gekennzeichnet. Der Punkt . steht in regulären Ausdrücken für ein beliebiges Zeichen, wenn wir wirklich einen Punkt meinen, dann wird dies mit einem Backslash \ gekennzeichnet (\ bedeutet also: exakt das nächste Zeichen).

====Besonderheit: Anker auf einer Seite====

Auf einer Webseite können "Anker" als Sprungmarke gesetzt sein. Beim Aufruf wird im Browser nicht auf den Anfang der Seite sondern direkt zum Ankerpunkt gesprungen. Der Anker wird durch ein Hash-Zeichen # in der URL gefolgt vom Namen der Sprungmarke gekennzeichnet. Beispiel für eine Adresse mit Anker:

domain.tld/aktuelles.html#artikel25
Soll per .htaccess Weiterleitung direkt auf eine Sprungmarke verwiesen werden, muss der zusätzliche Parameter NE (No Encoding) in eckigen Klammern angegeben werden:

RewriteRule ^neues\.html$ /aktuelles.html#artikel25 [R=301,L,NE]
Domain auf verschlüsselte Verbindung umleiten

Sollen alle Seiten einer Domain ausschließlich über eine SSL-Verbindung aufgerufen werden, so kann dies über einen Eintrag in der .htaccess Datei im Startverzeichnis der Domain eingerichtet werden:

RewriteCond %{SERVER_PORT} !^443$
RewriteRule (.*) https://%{HTTP_HOST}/$1 [L]
In der ersten Zeile wird die Funktion zum Umschreiben von URLs im Apache Webserver aktiviert. In der zweiten Zeile wird die Bedingung definiert "Wenn der Aufruf nicht auf Port 443 erfolgt" (Port 443 wird für SSL-Verschlüsselung verwendet, Port 80 für unverschlüsselte Aufrufe). Zeile 3 ist die Regel für das Umschreiben der URL. Wenn die Bedingung aus Zeile 2 zutrifft, werden die Aufrufe einer beliebigen Seite auf die gleiche Domain (${HTTP_HOST}) jedoch über das https:// Protokoll umgeleitet. Mit /$1 wird die ursprüngliche URL (z.B. impressum.html) an den Domainnamen angefügt. Mit dem Parameter [L] wird angegeben, dass das Umschreiben der URLs hier enden soll, weitere Zeilen in der .htaccess Datei werden also ignoriert.

====Domain name-of-domain.net nach name-der-domain.de umleiten====

Oftmals werden für ein Projekt mehrere Domains registriert, um verschiedene Schreibweisen abzudecken. Nach außen wird eine Hauptdomain kommunziert (Beispiel: name-der-domain.de als Hautpdomain, dazu name-of-domain.net als Zusatzdomains).

Mit folgendem Eintrag in der .htaccess Datei werden alle Aufrufe für name-of-domain.net nach name-der-domain.de weitergeleitet:

RewriteCond %{HTTP_HOST} ^(www\.)?name-of-domain\.net$ [NC]
RewriteRule ^(.*)$ http://www.name-der-domain.de/$1 [R=301,L]
Die Weiterleitung nach name-der-domain.de erfolgt dabei mit dem Statuscode 301 (permanent), so dass auch in Suchmaschinen auf Dauer nur diese erscheint. Dadurch werden Probleme mit "doppeltem Inhalt" (Duplicate Content) vermieden. Alle bei der ursprünglichen Domain übermittelten Parameter werden an die Zieldomain weitergegeben.

====Einer Domain immer www. voranstellen====

Mit folgendem Eintrag in der .htaccess Datei werden alle Aufrufe für eine Domain ohne www auf die Variante mit www weitergeleitet:

RewriteCond %{HTTP_HOST} ^name-der-domain\.de$ [NC]
RewriteRule ^(.*)$ http://www.name-der-domain.de/$1 [R=301,L]
Die Weiterleitung nach www.name-der-domain.de erfolgt dabei mit dem Statuscode 301 (permanent), so dass auch in Suchmaschinen auf Dauer nur diese erscheint.

====Domain auf eine Seite leiten====

Bestimmte Domains oder Subdomains sollen entweder mit oder ohne www auf eine bestimmte Unterseite weitergeleitet werden.

Dazu fügen Sie folgende Zeilen in Ihre .htaccess ein:

#Ohne realurl:
RewriteCond %{HTTP_HOST} ^(www\.)?name-der-domain\.de
RewriteRule ^$ /index.php?id=85

#oder realurl/simulatestatic mit html Suffix:
RewriteCond %{HTTP_HOST} ^(www\.)?name-der-domain\.de
RewriteRule ^$ /unterseite.html

#oder realurl ohne html Suffix:

RewriteCond %{HTTP_HOST} ^(www\.)?name-der-domain\.de
RewriteRule ^$ /unterseite/

====Weiterleitung auf eine andere Domain zu einer Unterseite====

RewriteCond %{HTTP_HOST} ^(www\.)?name-of-domain\.net [NC]
RewriteRule ^(.*)$ http://www.name-der-domain.de/unterseite.hmtl [R=301,L]
Redirect mit ? in der URL

http://www.domainname.de/index.php?id=7
soll nach

http://www.domainname.de/impressum.html
umgeleitet werden. Das Problem ist das ? in der alten URL und muss per QUERY_STRING in der Condition abgefragt werden.
Lösung:

RewriteCond %{QUERY_STRING} ^id=7$
RewriteRule ^.*$ http://www.domainname.de/impressum.html? [L,R=301]
Wichtig ist auch der Browser-Cache. Der sollte unbedingt geleert werden, denn wenn ein Aufruf noch im Cache drin ist kann dadurch u.U. immer auf die falsche Seite leiten.

So verhindert man, dass alte durch einen Umzug oder Neuprogrammierung nicht mehr vorhandene URLs in den Suchmaschinen zu einem schlechteren Ranking

=== Weitere Beispiele (älter) ===

Hinweis: eine Alternative hierfür ist eine PHP Weiterleitung ([[PHP - Tipps und Tricks]])
Quelle Dr.Web 28.12.2006

Sie können sowohl Zugriffe auf bestimmte Dateien als auch auf Verzeichnisse bequem weiterleiten. Das klappt innerhalb der eigenen Domain, aber auch mit externen Verweisen.

Die Datei .htaccess kann mit jedem Text-Editor bearbeitet werden. Eine Umleitung könnte so aussehen:

Redirect /beispielverzeichnis http://www.drweb.de

Ruft jemand die URL http://www.drweb.de/beispielverzeichnis auf landet er ohne weiteren Zwischenstopp direkt auf der Startseite.

Mit Einzeldateien klappt es auch:

Redirect /beispielseite.shtml http://www.drweb.de

oder

Redirect /beispielseite.shtml neueseite.shtml

Wer mag, kann die gesamte Domain auf eine andere umleiten

Redirect / http://www.drweb.de/

Nützlich während Bauarbeiten, bei Reparaturen oder wenn Dateien durch andere ersetzt wurden. Da die Umleitung serverseitig geschieht, spielt der Browser des Besuchers keine Rolle.

Weitere nützliche Beispiele:

Den Domainnamen ohne www auf den mit www umleiten. Es wird der Code 301 mitgegeben.
<pre>
RewriteEngine on
RewriteCond %{HTTP_HOST} !^www\. [NC]
RewriteRule ^(.*)$ http://www.%{HTTP_HOST}/$1 [L,R=301]
</pre>
=== Weiterleitung auf sichere Verbindung (https) ===

== Umleitung auf https ==
Sichere Seiten sind seid 2019 Standard und quasi Pflicht. Mit diesem Code kann man von http auf https weiterleiten und gibt einen 301 (Moved Permanently) Header mit.
<pre>
<IfModule mod_rewrite.c>
# Enable URL rewriting
RewriteEngine On
# Redirect to https
RewriteCond %{SERVER_PORT} !^443$
RewriteRule (.*) https://%{HTTP_HOST}/$1 [R=301,L]
</IfModule>
</pre>

=== Moved Permanently 301 Redirect ===
Quelle:http://www.fladi.de/2008/04/28/howto-webseiten-redirect-mit-301/ (25.7.2008)

Was ist ein 301 redirect?

301 redirect ist die wohl beste Möglichkeit das aktuelle Suchmaschinenranking beim Umzug einer Seite oder des gesamten Webauftritts zu behalten. Der Code “301″ steht für “moved permanently” (dauerhaft verschoben). Ein solches Redirect wird in der .htaccess Datei eintragen. Es trägt die Form (alles in einer Zeile):

redirect 301 pfad/alte/seite/datei.html http://www.domain.de/pfad/neue/seite/datei.html

Beachte, kein “http://www” in das erste Statement zu schreiben. Es muss der komplette Pfad vom Root deines Webservers angegeben werden. Schauen wir uns die Zeile nun nochmal genauer an:

* “redirect 301″ - die eigentliche Anweisung für den Webserver
* “/pfad/alte/seite/datei.html” - die Seite die umgeleitet werden soll
* “http://www.domain.de/pfad/neue/seite.datei.html” - die komplette neue URL

Wie reagiert nun ein Suchmaschinen-Spider auf eine solche Umleitung? Die .htaccess wird ja nicht vom Spider ausgelesen, sondern vom Webserver “ausgeführt”. Der Spider jedoch erkennt den Statuscode, den der Webserver liefert. Beim nächsten Update seiner Datenbank sollte die Suchmaschine nun die alte URL aus dem Index werfen und die neue aufnehmen. Häufig kommt es aber auch vor, dass alte und neue URL gemischt auftauchen. Auch leichte Änderungen im Pagerank können auftreten. Es dauert so ca. 6-8 Wochen bis sich die Änderungen an der Seite auch in den Suchergebnissen niederschlagen.

Weitere Möglichkeiten von 301 redirect:

1. Um ALLE Dateien Deiner Domain mithilfe einer .htaccess umzuleiten kannst Du (auf einem Unix/Linux-Webserver) i.d.R. folgendes verwenden:
redirect 301 ^(.*)$ http://www.domain.de
redirectMatch permanent ^(.*)$ http://www.domain.de

Um Deine alte Startseite (index.html) umzuleiten:
redirect 301 /index.html http://www.domain.de/index.html
redirect permanent /index.html http://www.domain.de/index.html

2. Wenn Du http://domain.de auf http://www.domain.de umleiten möchtest und mod_rewrite auf dem Webserver verfügbar ist, erreichst Du dies durch folgende .htaccess:

Options +FollowSymLinks
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain\.de
RewriteRule ^(.*)$ http://www.domain.de/$1 [R=permanent,L]

oder

Options +FollowSymLinks
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain\.de$ [NC]
RewriteRule ^(.*)$ http://www.domain.de/$1 [R=301,L]

3. Alle .html Dateien auf .php Dateien umzuleiten ist durch mod_rewrite auch kein großes Problem:

RewriteEngine on
RewriteBase /
RewriteRule (.*).html$ /$1.php

4. Um ein Verzeichnis und alles darunter umzuleiten:

redirectMatch 301 ^/verzeichnis-alt/(.*) http://www.domain.de/verzeichnis-neu/

=== Warum nicht per META-Tag redirect machen? ===

Die Umleitung per META-Tag erfolgt direkt in der aufgerufenen Seite. Dort wird im HEAD-Teil

<meta http-equiv=”refresh” content=”0; url=http://www.domain.de/”>
eingetragen. Hierbei bewirkt das “content=10″, dass der Browser nach 10 Sekunden die darauffolgende URL aufruft. Wenn man “content=0″ einträgt wird die Umleitung sofort ausgeführt. Ein paar alte Browser unterstützen diese Art der Umleitung nicht. Deshalb ist es besser noch zusätzlich den Link (neue Domain) mit anzugeben.

Technisch gesehen liefert die angefragte Seite, wie auch die Seite auf die umgeleitet wird, einen Statuscode “200 OK” zurück. Es sind also zwei unabhängige Seiten. Dementsprechend versucht die Suchmaschinen auch beide Seiten zu indizieren. Hier genau liegt aber das Problem. Denn der Spider des Suchmaschinenbetreibers erkennt die Umleitung und wertet Deine Seite deshalb u.U. ab, da es sich um eine beliebte SPAM-Methode handelt. So könnte man 1000 Domains mit solchen Seiten und jeder Menge Keywords einrichten. Echte Besucher (kein Spider) werden umgeleitet auf die eigentliche Seite. Indiziert wird aber nicht nur die eigentliche Seite sondern auch die 1000 Domains mit Keywords, die meist gar nichts mit dem eingentlichen Inhalt zu tun haben.

Beim 301 redirect wird hingegen nur die echte Zielseite in den Index aufgenommen und durch den Statuscode kann der Suchmaschinenbetreiber zusätzlich noch die veralteten Seite aus dem Index werfen. Dies ist also der beste Weg um alte Seiten auf neue umzuleiten und gleichzeitig wird auch der Page Rank mit übertragen.

===Weiterleitung über IP===
<pre>
Options +FollowSymlinks
RewriteEngine on

#IP Bedingung
RewriteCond %{REMOTE_HOST} ^85\.13\.128\.137

#Zielseite erlauben
RewriteCond %{REQUEST_URI} !/ip-remote\.php$

#Umleiten
#RewriteRule ^/* http://demo.webmynet.de/ip-remote.php [R,NE,NC]
RewriteRule /(.*)$ /ip-remote.php [R=302,L]
</pre>

== Erlaubte Anweisungen in .htaccess-Dateien ==

http://de.selfhtml.org/servercgi/server/htaccess.htm

Auszug (Datum des Zugriffs: 10.9.2007):
<pre>
Die Anweisung AllowOverride kann nicht innerhalb einer .htaccess notiert werden, sondern wird ausschließlich vom Server-Administrator in der zentralen Konfigurationsdatei vorgegeben. Um den AllowOverride-Wert in Erfahrung zu bringen, benötigen Sie Einsicht in die Serverkonfiguration. Kontaktieren Sie dazu gegebenenfalls Ihren Webhosting-Provider. Dieser kann den Wert auch ändern, falls Sie bestimmte bisher nicht erlaubte Anweisungen verwenden möchten. Im einzelnen gibt es dafür folgende mögliche Werte:

* Mit AllowOverride None wird der Webserver angewiesen, .htaccess-Dateien zu ignorieren. Das ist im Übrigen die Voreinstellung.
* Mit AllowOverride All wird festgelegt, dass in einer .htaccess-Datei (so gut wie) sämtliche zentrale Vorgaben überschrieben und damit abgeändert werden dürfen. Das kann bedeuten, dass Vorhaben, die eigentlich verboten sind (beispielsweise die Ausführung von CGI-Scripts), mit Hilfe einer .htaccess-Datei erlaubt werden. Als Server-Administrator werden Sie diese Anweisung also nur sehr vorsichtig einsetzen.
* Mit AllowOverride Options wird festgelegt, dass in einer .htaccess-Datei nach unten Anweisungen zur Steuerung spezieller Verzeichniseigenschaften zulässig sind.
* Mit AllowOverride Limit wird festgelegt, dass in einer .htaccess-Datei nach unten Zugriffe von bestimmten Hosts erlaubt oder untersagt werden können.
* Mit AllowOverride Indexes wird festgelegt, dass in einer .htaccess-Datei nach unten Anweisungen zur Steuerung von Verzeichnisindizes zulässig sind.
* Mit AllowOverride FileInfo wird festgelegt, dass in einer .htaccess-Datei Anweisungen zur Akzeptanz bestimmter Dokumenttypen zulässig sind - beispielsweie, um nach unten Individuelle Fehlermeldungen ausgeben zu können.
* Mit AllowOverride AuthConfig wird festgelegt, dass in einer .htaccess-Datei Autorisierungsanweisungen stehen dürfen - das betrifft beispielsweise Regelungen zum nach unten Passwortschutz.

Diese Werte können auch miteinander kombiniert werden. All ist der mächtigste Parameter, mit dem alles das zugelassen wird, was die anderen Parameter steuern.
</pre>

Nach dem Ändern muß natürlich der Server neu gestartet werden (bei Debian: apache restart)

==IP Adressen sperren==

Manchmal ist es notwendig, bestimmte IP Adressen vom Aufruf der Webseite auszusperren, z.B. bei einem Angriffsversuch auf die Webseite. Über folgenden Eintrag in der .htaccess Datei (z.B. vor dem Eintrag 'RewriteEngine On') im Startverzeichnis der Seite lassen sich unerwünschte Besucher abweisen:

order allow,deny
deny from 192.168.2.17
deny from 10.10.20.63
allow from all
Bei mehreren IP Adressen wird jede in eine eigene Zeile eingetragen. Die Einstellung gilt auch für alle Unterverzeichnisse. Wenn jemand mit einer gesperrten Adresse versucht, die Seite aufzurufen, erhält er einen 403 Fehlercode.

==HTML5 Videos / bestimmte Dateitypen zulassen ==

Falls es in einzelnen Browsern zu Problemen beim Abspielen von per HTML5 eingebundenen Videos kommt, helfen eventuell folgende Zeilen in der .htaccess Datei im Projektverzeichnis:

AddType video/ogg .ogm
AddType video/ogg .ogv
AddType video/ogg .ogg
AddType video/webm .webm
AddType audio/webm .weba
AddType video/mp4 .mp4
AddType video/x-m4v .m4v

== htaccess für Typo3 ==

http://www.typo3lexikon.de/server/htaccess.html (11/2014)

<pre>
.htaccess für TYPO3
Ich möchte auf dieser Seite nicht erklären wie .htaccess-Dateien erstellt werden. Nein. Davon gibt es schon zu genüge Dokumentationen im Web:

Allgemeines zu htaccess

URLs manipulieren

Reguläre Ausdrücke

htaccess Beispiele

Auf dieser Seite geht es mehr um das Zusammenspiel von TYPO3 und htaccess-Dateien gerade in Bezug unter der Verwendung von der Extension RealUrl. In den nächsten Zeilen werde ich Euch meine htaccess-Datei in Detail näher erklären:

RewriteEngine
Mit RewriteEngine kannst Du das Modifizieren von URLs de- bzw. aktivieren. Erst wenn diese Option aktiviert ist, kannst du z.B. alle Anfragen, die an Deinen Server gesendet werden auf eine völlig andere Webseite umleiten.
RewriteEngine On
Bestimmte Verzeichnisse nicht umschreiben
Wenn Ihr RealUrl installiert habt, dann erhaltet Ihr je nach Konfiguration URLs wie

/meine-seite/kontakt/impressum.html
Dabei sind die vermeintlichen Ordner gar keine echten Ordner auf dem Server, sondern Informationen, die an die index.php weitergeleitet werden, um dann die gewünschte Seite aufrufen zu können. Was aber, wenn wir wirklich mal einen Ordner auf dem Server öffnen wollen? Dann darf dieser Name des Ordner NICHT an die index.php weitergeleitet werden. Um das zu erreichen verwende ich das Script aus der RealUrl-Dokumentation:
RewriteRule ^typo3$ - [L]
RewriteRule ^typo3/.*$ - [L]
RewriteRule ^uploads/.*$ - [L]
RewriteRule ^fileadmin/.*$ - [L]
RewriteRule ^typo3conf/.*$ - [L]
Hinweis
[L] bedeutet, dass nach dieser Umschreibung der URL keine weiteren Umschreibungen mehr ausgeführt werden.

Der Bindestrich (-) bedeutet, dass keine Umschreibung der URL stattfinden soll.

Doppelter Content
Wer von Euch seine Seite schon mal mit www.seitwert.de bewertet hat, wird bestimmt schon mal über den Eintrag bzgl. doppelten Content/Inhalt gestoßen sein. So kommt es je nach Konfiguration vor, dass eine Seite wie sfroemken.de das Gleiche anzeigt wie www.sfroemken.de. Dieses "Problem" kann sich auch negativ auf die Position in den Suchergebnissen auswirken. Aber auch das lässt sich mit Hilfe der htaccess-Datei bereinigen:

RewriteCond %{HTTP_HOST} ^sfroemken\.de$ [NC]
RewriteRule ^(.*)$ www.sfroemken.de/$1 [R=301,L]
Erklärung
%{HTTP_HOST} kann in diesem Fall sfroemken.de oder aber auch www.sfroemken.de sein. Mit RewriteCond könnt Ihr nun überprüfen, ob der HTTP_HOST mit dem Wert sfroemken.de übereinstimmt. Dank [NC] soll die Groß- und Kleinschreibung bei diesem Vergleich nicht berücksichtigt werden.

Wenn RewriteCond nun ein true zurück gibt, dann wird die Modifikation in RewriteRule ausgeführt. Alles was durch die Klammern markiert wurde, kann im zweiten Parameter mit $1 wiederverwendet werden. [R=301]: Das R steht für redirect und die 301 ist ein bestimmter Servercode, mit dem bestimmt wird, dass es sich bei dieser Weiterleitung um eine parmanente Weiterleitung handelt.

So wird aus

sfroemken.de/kontakt/index.php
ein

www.sfroemken.de/kontakt/index.php
Subdomains
Bei Subdomains müssen wir das genau andersrum machen. Dort gibt es kein www. Da www.seitwert.de aber trotzdem überprüft, ob die Domain auch mit einem www davor erreichbar ist, müssen wir das folgendermaßen abfangen:

RewriteCond %{HTTP_HOST} ^www\.typo3\.sfroemken\.de$ [NC]
RewriteRule ^(.*)$ typo3.sfroemken.de/$1 [R=301,L]
Ordner
Leider haben sich viele Surfer daran gewöhnt Ordner auf einem Server ohne abschließendem Slash (/) anzugeben. Damit dieser Slash automatisch hinten dran gemacht wird, können wir folgendes Script verwenden:
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule (.*[^/])$ %{HTTP_HOST}/$1/ [L,R]
Erklärung
Die ersten beiden RewriteCond fragen ab, ob es sich bei der aufzurufenden URL nicht um eine Datei handelt und nicht um einen symbolischen Link. Wenn beides zutrifft, kann getrost ein zusätzlicher Slash hinten angefügt werden.

Achtung
Wenn Ihr RealUrl so konfiguriert habt, dass Ihr URLs wie

/kontakt/impressum.html
erhaltet, dann muss das Script noch etwas angepasst werden, dann ansonsten erhaltet Ihr eine URL wie diese hier:

/kontakt/impressum.html/
Hier das angepasste Script:

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteCond %{REQUEST_FILENAME} (^.htm$|^.html$)
RewriteRule (.*[^/])$ %{HTTP_HOST}/$1/ [L,R]
Heißt: Wenn die URL mit .htm oder .html endet, dann soll der zusätzliche Slash NICHT hinten dran gemacht werden.

Index-Dateien in Ordnern
Je nach Projekt und Ordner kann es vorkommen, dass Du trotz RealUrl die Index-Dateien in bestimmten Ordnern ausführen möchtest:

/fileadmin/projekt/download/index.php
Allerdings wird derzeit noch diese URL an die TYPO3-eigene index.php im Rootverzeichnis weitergeleitet. Um auch das zu unterbinden sind folgende 6 Zeilen vorgesehen:
RewriteCond %{REQUEST_FILENAME}/index.html -f
RewriteRule / %{REQUEST_URI}/index.html [L]
RewriteCond %{REQUEST_FILENAME}/index.htm -f
RewriteRule / %{REQUEST_URI}/index.htm [L]
RewriteCond %{REQUEST_FILENAME}/index.php -f
RewriteRule / %{REQUEST_URI}/index.php [L]
URL-Modifikation für RealUrl
Dieses Script ist das wichtigste Script überhaupt für RealUrl. Hier wird nun endlich gesagt, dass alle Teile aus der URL an die TYPO3-eigene index.php weitergeleitet werden sollen zur Weiterverarbeitung durch RealUrl.
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* index.php
Hinweis
Je nach Art Eurer TYPO3-Installation könnte es sein, dass Eure index.php ein symbolischer Link ist. In diesem Fall müsst Ihr die letzt Zeile folgendermaßen ändern:

RewriteRule .* /index.php
Scripmerger
Dieses Script benötigt Ihr nur, wenn Ihr die Extension scriptmerger verwenden wollt:
# Expires Header + Removal of ETag
<FilesMatch "\.(ico|png|gif|js|css|jpg|jpeg|swf)">
<IfModule mod_expires.c>
ExpiresActive on
ExpiresDefault "access plus 7 days"
ExpiresDefault "access plus 2 months"
</IfModule>

# ETag
FileETag MTime Size
<IfModule mod_headers.c>
FileETag none
Header unset Last-Modified
</IfModule>
</FilesMatch>

# Compressed Content
<FilesMatch "\.gz\.(js|css)">
<IfModule mod_headers.c>
Header set Content-Encoding gzip
</IfModule>
</FilesMatch>
</pre>
=== Shell Restriction auf all-inkl Server ===
Ab TYPO3 6 moniert das Install Tool das exec nicht augeführt werden darf. Es funktioniert wenn man die cgi Version von PHP nimmt. Das kann man per htaccess oder im KAS Backend einstellen.

Beispiele.
<pre>
AddHandler php55-cgi .php (sofern vom Server unterstützt)
AddHandler php54-cgi .php (sofern vom Server unterstützt)
AddHandler php53-cgi .php
AddHandler php52-cgi .php
AddHandler php5-cgi .php (Version entsprechend der PHP Apache-Modul Version)
</pre>

=== PHP Version auf Weiland Servern ===
Über die PHP-Versionsauswahl im Kundenmenü können Sie die PHP-Version für eine Domain ändern. Folgende Anleitung erklärt, wie Sie die PHP Version für einzelne Verzeichnisse (und deren Unterverzeichnisse) ändern können.

Das Verzeichnis kann dabei nur eine höhere PHP-Version erhalten, als die PHP-Version, die für die Domain im Kundenmenü eingestellt ist.

Das bedeutet: Ist für die Domain PHP 5.6 im Kundenmenü eingestellt, können Sie für einzelne Verzeichnisse PHP 7.0 und höher einstellen, nicht jedoch niedrigere Versionen wie PHP 5.5. *

Außerdem darf für die Domain kein Fast-CGI aktiviert sein.

Um die PHP-Version für ein Verzeichnis zu ändern, legen Sie eine .htaccess-Datei mit folgender Anweisung in dem Verzeichnis ab. Die Anweisung ist abhängig von der PHP-Version, die Sie aktivieren möchten:
AddType application/x-httpd-php72 .php

Terminal und Konsole auf dem Mac

2021-09-01T07:36:02Z

134.3.85.26: /* Dateien kopieren, bewegen, umbenennen */

Tips für die Arbeit mit dem Terminal

== Einleitung ==
Das Erscheinungsbild des Terminals kann man einfach Verbessern. Dazu kann man z.B. im Home-Directory die Dateien '''.bash_profile''' or '''.bashrc''' anpassen. Aber auch die '''.profile''' Datei Funktioniert. Je nachdem ob man die User Dateien oder die Globalen nimmt wird die Änderung global oder auf User-Ebene umgesetzt. Wenn die Dateien nicht vorhanden sind einfach hinzufügen.

== Prompt anpassen ==
Wie oben beschrieben z.B. in die .bash_profile datei
''Farbiges'' '''Prompt''' und Anzeige als: ''“username@hostname:cwd $”''
export PS1="\[\033[36m\]\u\[\033[m\]@\[\033[32m\]\h:\[\033[33;1m\]\w\[\033[m\]\$ "

== Farben auf Mac Terminal ==
export CLICOLOR=1
export LSCOLORS=GxFxCxDxBxegedabagaced

CLICOLOR=1 bedeutet Farbe anschalten
LSCOLORS= Farben für die anzeige im Listkommando
== Mac UNIX ==
Basiert auf UNIX

Apfel > Über diesen Mac > Software (da steht z.B. die kernel Version)

== Umgebungsvariablen, PATH Variable etc.==
siehe auch: http://wiki.zone30.info/wikizone/index.php/Linux_-_Umgebungsvariable

alle kriegt man mit
set | less
eine einzelne z.B. mit:
echo $PATH

==== PATH Variable anpassen ====
'''Hinzufügen''' eines Pfades für eine '''einzelne''' Terminal '''Session''':
PATH=MeinZusatzPfad:$PATH
export PATH
'''Exportieren''' ist wichtig wenn die neue Variable auch in '''Unterterminals''' zur Verfügung stehen soll (z.B. bei Bash Skripten)

=== Dauerhaft PATH Variable in der Bash setzen ===
Auf diese Weise stehen die PATH Variable '''bei jeder Sitzung''' zur Verfügung. Mac speichert die Bash Datei im Userverzeichnis.

Wir öffnen die bash_profile Datei im Standard Editor (wenn Sie nicht vorhanden ist wird Sie erzeugt).
touch ~/.bash_profile; open ~/.bash_profile
Jetzt können wir die Variable setzen. Hier ein Beispiel mit der Android ADT
export PATH=/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/platform-tools:/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/tools:$PATH

Durch das :$PATH am Ende wird der neue Wert zu den Standardwerten hinzugefügt oder hier besser vorangestellt)

Jetzt noch die Datei abspeichern und ausführen:

source ~/.bash_profile
== Umfangreiches .bash_profile Beispiel ==
Quelle: http://natelandau.com/my-mac-osx-bash_profile/ (2015-10)
<syntaxhighlight lang="bash">
# ---------------------------------------------------------------------------
#
# Description: This file holds all my BASH configurations and aliases
#
# Sections:
# 1. Environment Configuration
# 2. Make Terminal Better (remapping defaults and adding functionality)
# 3. File and Folder Management
# 4. Searching
# 5. Process Management
# 6. Networking
# 7. System Operations & Information
# 8. Web Development
# 9. Reminders & Notes
#
# ---------------------------------------------------------------------------

# -------------------------------
# 1. ENVIRONMENT CONFIGURATION
# -------------------------------

# Change Prompt
# ------------------------------------------------------------
export PS1="________________________________________________________________________________\n| \w @ \h (\u) \n| => "
export PS2="| => "

# Set Paths
# ------------------------------------------------------------
export PATH="$PATH:/usr/local/bin/"
export PATH="/usr/local/git/bin:/sw/bin/:/usr/local/bin:/usr/local/:/usr/local/sbin:/usr/local/mysql/bin:$PATH"

# Set Default Editor (change 'Nano' to the editor of your choice)
# ------------------------------------------------------------
export EDITOR=/usr/bin/nano

# Set default blocksize for ls, df, du
# from this: http://hints.macworld.com/comment.php?mode=view&cid=24491
# ------------------------------------------------------------
export BLOCKSIZE=1k

# Add color to terminal
# (this is all commented out as I use Mac Terminal Profiles)
# from http://osxdaily.com/2012/02/21/add-color-to-the-terminal-in-mac-os-x/
# ------------------------------------------------------------
# export CLICOLOR=1
# export LSCOLORS=ExFxBxDxCxegedabagacad

# -----------------------------
# 2. MAKE TERMINAL BETTER
# -----------------------------

alias cp='cp -iv' # Preferred 'cp' implementation
alias mv='mv -iv' # Preferred 'mv' implementation
alias mkdir='mkdir -pv' # Preferred 'mkdir' implementation
alias ll='ls -FGlAhp' # Preferred 'ls' implementation
alias less='less -FSRXc' # Preferred 'less' implementation
cd() { builtin cd "$@"; ll; } # Always list directory contents upon 'cd'
alias cd..='cd ../' # Go back 1 directory level (for fast typers)
alias ..='cd ../' # Go back 1 directory level
alias ...='cd ../../' # Go back 2 directory levels
alias .3='cd ../../../' # Go back 3 directory levels
alias .4='cd ../../../../' # Go back 4 directory levels
alias .5='cd ../../../../../' # Go back 5 directory levels
alias .6='cd ../../../../../../' # Go back 6 directory levels
alias edit='subl' # edit: Opens any file in sublime editor
alias f='open -a Finder ./' # f: Opens current directory in MacOS Finder
alias ~="cd ~" # ~: Go Home
alias c='clear' # c: Clear terminal display
alias which='type -all' # which: Find executables
alias path='echo -e ${PATH//:/\\n}' # path: Echo all executable Paths
alias show_options='shopt' # Show_options: display bash options settings
alias fix_stty='stty sane' # fix_stty: Restore terminal settings when screwed up
alias cic='set completion-ignore-case On' # cic: Make tab-completion case-insensitive
mcd () { mkdir -p "$1" && cd "$1"; } # mcd: Makes new Dir and jumps inside
trash () { command mv "$@" ~/.Trash ; } # trash: Moves a file to the MacOS trash
ql () { qlmanage -p "$*" >& /dev/null; } # ql: Opens any file in MacOS Quicklook Preview
alias DT='tee ~/Desktop/terminalOut.txt' # DT: Pipe content to file on MacOS Desktop

# lr: Full Recursive Directory Listing
# ------------------------------------------
alias lr='ls -R | grep ":$" | sed -e '\''s/:$//'\'' -e '\''s/[^-][^\/]*\//--/g'\'' -e '\''s/^/ /'\'' -e '\''s/-/|/'\'' | less'

# mans: Search manpage given in agument '1' for term given in argument '2' (case insensitive)
# displays paginated result with colored search terms and two lines surrounding each hit. Example: mans mplayer codec
# --------------------------------------------------------------------
mans () {
man $1 | grep -iC2 --color=always $2 | less
}

# showa: to remind yourself of an alias (given some part of it)
# ------------------------------------------------------------
showa () { /usr/bin/grep --color=always -i -a1 $@ ~/Library/init/bash/aliases.bash | grep -v '^\s*$' | less -FSRXc ; }

# -------------------------------
# 3. FILE AND FOLDER MANAGEMENT
# -------------------------------

zipf () { zip -r "$1".zip "$1" ; } # zipf: To create a ZIP archive of a folder
alias numFiles='echo $(ls -1 | wc -l)' # numFiles: Count of non-hidden files in current dir
alias make1mb='mkfile 1m ./1MB.dat' # make1mb: Creates a file of 1mb size (all zeros)
alias make5mb='mkfile 5m ./5MB.dat' # make5mb: Creates a file of 5mb size (all zeros)
alias make10mb='mkfile 10m ./10MB.dat' # make10mb: Creates a file of 10mb size (all zeros)

# cdf: 'Cd's to frontmost window of MacOS Finder
# ------------------------------------------------------
cdf () {
currFolderPath=$( /usr/bin/osascript <<EOT
tell application "Finder"
try
set currFolder to (folder of the front window as alias)
on error
set currFolder to (path to desktop folder as alias)
end try
POSIX path of currFolder
end tell
EOT
)
echo "cd to \"$currFolderPath\""
cd "$currFolderPath"
}

# extract: Extract most know archives with one command
# ---------------------------------------------------------
extract () {
if [ -f $1 ] ; then
case $1 in
*.tar.bz2) tar xjf $1 ;;
*.tar.gz) tar xzf $1 ;;
*.bz2) bunzip2 $1 ;;
*.rar) unrar e $1 ;;
*.gz) gunzip $1 ;;
*.tar) tar xf $1 ;;
*.tbz2) tar xjf $1 ;;
*.tgz) tar xzf $1 ;;
*.zip) unzip $1 ;;
*.Z) uncompress $1 ;;
*.7z) 7z x $1 ;;
*) echo "'$1' cannot be extracted via extract()" ;;
esac
else
echo "'$1' is not a valid file"
fi
}

# ---------------------------
# 4. SEARCHING
# ---------------------------

alias qfind="find . -name " # qfind: Quickly search for file
ff () { /usr/bin/find . -name "$@" ; } # ff: Find file under the current directory
ffs () { /usr/bin/find . -name "$@"'*' ; } # ffs: Find file whose name starts with a given string
ffe () { /usr/bin/find . -name '*'"$@" ; } # ffe: Find file whose name ends with a given string

# spotlight: Search for a file using MacOS Spotlight's metadata
# -----------------------------------------------------------
spotlight () { mdfind "kMDItemDisplayName == '$@'wc"; }

# ---------------------------
# 5. PROCESS MANAGEMENT
# ---------------------------

# findPid: find out the pid of a specified process
# -----------------------------------------------------
# Note that the command name can be specified via a regex
# E.g. findPid '/d$/' finds pids of all processes with names ending in 'd'
# Without the 'sudo' it will only find processes of the current user
# -----------------------------------------------------
findPid () { lsof -t -c "$@" ; }

# memHogsTop, memHogsPs: Find memory hogs
# -----------------------------------------------------
alias memHogsTop='top -l 1 -o rsize | head -20'
alias memHogsPs='ps wwaxm -o pid,stat,vsize,rss,time,command | head -10'

# cpuHogs: Find CPU hogs
# -----------------------------------------------------
alias cpu_hogs='ps wwaxr -o pid,stat,%cpu,time,command | head -10'

# topForever: Continual 'top' listing (every 10 seconds)
# -----------------------------------------------------
alias topForever='top -l 9999999 -s 10 -o cpu'

# ttop: Recommended 'top' invocation to minimize resources
# ------------------------------------------------------------
# Taken from this macosxhints article
# http://www.macosxhints.com/article.php?story=20060816123853639
# ------------------------------------------------------------
alias ttop="top -R -F -s 10 -o rsize"

# my_ps: List processes owned by my user:
# ------------------------------------------------------------
my_ps() { ps $@ -u $USER -o pid,%cpu,%mem,start,time,bsdtime,command ; }

# ---------------------------
# 6. NETWORKING
# ---------------------------

alias myip='curl ip.appspot.com' # myip: Public facing IP Address
alias netCons='lsof -i' # netCons: Show all open TCP/IP sockets
alias flushDNS='dscacheutil -flushcache' # flushDNS: Flush out the DNS Cache
alias lsock='sudo /usr/sbin/lsof -i -P' # lsock: Display open sockets
alias lsockU='sudo /usr/sbin/lsof -nP | grep UDP' # lsockU: Display only open UDP sockets
alias lsockT='sudo /usr/sbin/lsof -nP | grep TCP' # lsockT: Display only open TCP sockets
alias ipInfo0='ipconfig getpacket en0' # ipInfo0: Get info on connections for en0
alias ipInfo1='ipconfig getpacket en1' # ipInfo1: Get info on connections for en1
alias openPorts='sudo lsof -i | grep LISTEN' # openPorts: All listening connections
alias showBlocked='sudo ipfw list' # showBlocked: All ipfw rules inc/ blocked IPs

# ii: display useful host related informaton
# -------------------------------------------------------------------
ii() {
echo -e "\nYou are logged on ${RED}$HOST"
echo -e "\nAdditionnal information:$NC " ; uname -a
echo -e "\n${RED}Users logged on:$NC " ; w -h
echo -e "\n${RED}Current date :$NC " ; date
echo -e "\n${RED}Machine stats :$NC " ; uptime
echo -e "\n${RED}Current network location :$NC " ; scselect
echo -e "\n${RED}Public facing IP Address :$NC " ;myip
#echo -e "\n${RED}DNS Configuration:$NC " ; scutil --dns
echo
}

# ---------------------------------------
# 7. SYSTEMS OPERATIONS & INFORMATION
# ---------------------------------------

alias mountReadWrite='/sbin/mount -uw /' # mountReadWrite: For use when booted into single-user

# cleanupDS: Recursively delete .DS_Store files
# -------------------------------------------------------------------
alias cleanupDS="find . -type f -name '*.DS_Store' -ls -delete"

# finderShowHidden: Show hidden files in Finder
# finderHideHidden: Hide hidden files in Finder
# -------------------------------------------------------------------
alias finderShowHidden='defaults write com.apple.finder ShowAllFiles TRUE'
alias finderHideHidden='defaults write com.apple.finder ShowAllFiles FALSE'

# cleanupLS: Clean up LaunchServices to remove duplicates in the "Open With" menu
# -----------------------------------------------------------------------------------
alias cleanupLS="/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user && killall Finder"

# screensaverDesktop: Run a screensaver on the Desktop
# -----------------------------------------------------------------------------------
alias screensaverDesktop='/System/Library/Frameworks/ScreenSaver.framework/Resources/ScreenSaverEngine.app/Contents/MacOS/ScreenSaverEngine -background'

# ---------------------------------------
# 8. WEB DEVELOPMENT
# ---------------------------------------

alias apacheEdit='sudo edit /etc/httpd/httpd.conf' # apacheEdit: Edit httpd.conf
alias apacheRestart='sudo apachectl graceful' # apacheRestart: Restart Apache
alias editHosts='sudo edit /etc/hosts' # editHosts: Edit /etc/hosts file
alias herr='tail /var/log/httpd/error_log' # herr: Tails HTTP error logs
alias apacheLogs="less +F /var/log/apache2/error_log" # Apachelogs: Shows apache error logs
httpHeaders () { /usr/bin/curl -I -L $@ ; } # httpHeaders: Grabs headers from web page

# httpDebug: Download a web page and show info on what took time
# -------------------------------------------------------------------
httpDebug () { /usr/bin/curl $@ -o /dev/null -w "dns: %{time_namelookup} connect: %{time_connect} pretransfer: %{time_pretransfer} starttransfer: %{time_starttransfer} total: %{time_total}\n" ; }

# ---------------------------------------
# 9. REMINDERS & NOTES
# ---------------------------------------

# remove_disk: spin down unneeded disk
# ---------------------------------------
# diskutil eject /dev/disk1s3

# to change the password on an encrypted disk image:
# ---------------------------------------
# hdiutil chpass /path/to/the/diskimage

# to mount a read-only disk image as read-write:
# ---------------------------------------
# hdiutil attach example.dmg -shadow /tmp/example.shadow -noverify

# mounting a removable drive (of type msdos or hfs)
# ---------------------------------------
# mkdir /Volumes/Foo
# ls /dev/disk* to find out the device to use in the mount command)
# mount -t msdos /dev/disk1s1 /Volumes/Foo
# mount -t hfs /dev/disk1s1 /Volumes/Foo

# to create a file of a given size: /usr/sbin/mkfile or /usr/bin/hdiutil
# ---------------------------------------
# e.g.: mkfile 10m 10MB.dat
# e.g.: hdiutil create -size 10m 10MB.dmg
# the above create files that are almost all zeros - if random bytes are desired
# then use: ~/Dev/Perl/randBytes 1048576 > 10MB.dat
</syntaxhighlight>

== Tipps und Tricks ==
=== Mit Terminal auf externe Festplatte zugreifen ===
/Volumes
=== Dateien kopieren, bewegen, umbenennen ===
https://www.macworld.com/article/222558/macos-command-line-copying-moving-files-terminal.html

cp source.txt target.txt
cp -R sourceFolder/ /Volumes/backupDrive/myBackupFolder

Terminal und Konsole auf dem Mac

2021-09-01T07:30:02Z

134.3.85.26:

Tips für die Arbeit mit dem Terminal

== Einleitung ==
Das Erscheinungsbild des Terminals kann man einfach Verbessern. Dazu kann man z.B. im Home-Directory die Dateien '''.bash_profile''' or '''.bashrc''' anpassen. Aber auch die '''.profile''' Datei Funktioniert. Je nachdem ob man die User Dateien oder die Globalen nimmt wird die Änderung global oder auf User-Ebene umgesetzt. Wenn die Dateien nicht vorhanden sind einfach hinzufügen.

== Prompt anpassen ==
Wie oben beschrieben z.B. in die .bash_profile datei
''Farbiges'' '''Prompt''' und Anzeige als: ''“username@hostname:cwd $”''
export PS1="\[\033[36m\]\u\[\033[m\]@\[\033[32m\]\h:\[\033[33;1m\]\w\[\033[m\]\$ "

== Farben auf Mac Terminal ==
export CLICOLOR=1
export LSCOLORS=GxFxCxDxBxegedabagaced

CLICOLOR=1 bedeutet Farbe anschalten
LSCOLORS= Farben für die anzeige im Listkommando
== Mac UNIX ==
Basiert auf UNIX

Apfel > Über diesen Mac > Software (da steht z.B. die kernel Version)

== Umgebungsvariablen, PATH Variable etc.==
siehe auch: http://wiki.zone30.info/wikizone/index.php/Linux_-_Umgebungsvariable

alle kriegt man mit
set | less
eine einzelne z.B. mit:
echo $PATH

==== PATH Variable anpassen ====
'''Hinzufügen''' eines Pfades für eine '''einzelne''' Terminal '''Session''':
PATH=MeinZusatzPfad:$PATH
export PATH
'''Exportieren''' ist wichtig wenn die neue Variable auch in '''Unterterminals''' zur Verfügung stehen soll (z.B. bei Bash Skripten)

=== Dauerhaft PATH Variable in der Bash setzen ===
Auf diese Weise stehen die PATH Variable '''bei jeder Sitzung''' zur Verfügung. Mac speichert die Bash Datei im Userverzeichnis.

Wir öffnen die bash_profile Datei im Standard Editor (wenn Sie nicht vorhanden ist wird Sie erzeugt).
touch ~/.bash_profile; open ~/.bash_profile
Jetzt können wir die Variable setzen. Hier ein Beispiel mit der Android ADT
export PATH=/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/platform-tools:/Users/schlegel/Development/adt-bundle-mac-x86_64/sdk/tools:$PATH

Durch das :$PATH am Ende wird der neue Wert zu den Standardwerten hinzugefügt oder hier besser vorangestellt)

Jetzt noch die Datei abspeichern und ausführen:

source ~/.bash_profile
== Umfangreiches .bash_profile Beispiel ==
Quelle: http://natelandau.com/my-mac-osx-bash_profile/ (2015-10)
<syntaxhighlight lang="bash">
# ---------------------------------------------------------------------------
#
# Description: This file holds all my BASH configurations and aliases
#
# Sections:
# 1. Environment Configuration
# 2. Make Terminal Better (remapping defaults and adding functionality)
# 3. File and Folder Management
# 4. Searching
# 5. Process Management
# 6. Networking
# 7. System Operations & Information
# 8. Web Development
# 9. Reminders & Notes
#
# ---------------------------------------------------------------------------

# -------------------------------
# 1. ENVIRONMENT CONFIGURATION
# -------------------------------

# Change Prompt
# ------------------------------------------------------------
export PS1="________________________________________________________________________________\n| \w @ \h (\u) \n| => "
export PS2="| => "

# Set Paths
# ------------------------------------------------------------
export PATH="$PATH:/usr/local/bin/"
export PATH="/usr/local/git/bin:/sw/bin/:/usr/local/bin:/usr/local/:/usr/local/sbin:/usr/local/mysql/bin:$PATH"

# Set Default Editor (change 'Nano' to the editor of your choice)
# ------------------------------------------------------------
export EDITOR=/usr/bin/nano

# Set default blocksize for ls, df, du
# from this: http://hints.macworld.com/comment.php?mode=view&cid=24491
# ------------------------------------------------------------
export BLOCKSIZE=1k

# Add color to terminal
# (this is all commented out as I use Mac Terminal Profiles)
# from http://osxdaily.com/2012/02/21/add-color-to-the-terminal-in-mac-os-x/
# ------------------------------------------------------------
# export CLICOLOR=1
# export LSCOLORS=ExFxBxDxCxegedabagacad

# -----------------------------
# 2. MAKE TERMINAL BETTER
# -----------------------------

alias cp='cp -iv' # Preferred 'cp' implementation
alias mv='mv -iv' # Preferred 'mv' implementation
alias mkdir='mkdir -pv' # Preferred 'mkdir' implementation
alias ll='ls -FGlAhp' # Preferred 'ls' implementation
alias less='less -FSRXc' # Preferred 'less' implementation
cd() { builtin cd "$@"; ll; } # Always list directory contents upon 'cd'
alias cd..='cd ../' # Go back 1 directory level (for fast typers)
alias ..='cd ../' # Go back 1 directory level
alias ...='cd ../../' # Go back 2 directory levels
alias .3='cd ../../../' # Go back 3 directory levels
alias .4='cd ../../../../' # Go back 4 directory levels
alias .5='cd ../../../../../' # Go back 5 directory levels
alias .6='cd ../../../../../../' # Go back 6 directory levels
alias edit='subl' # edit: Opens any file in sublime editor
alias f='open -a Finder ./' # f: Opens current directory in MacOS Finder
alias ~="cd ~" # ~: Go Home
alias c='clear' # c: Clear terminal display
alias which='type -all' # which: Find executables
alias path='echo -e ${PATH//:/\\n}' # path: Echo all executable Paths
alias show_options='shopt' # Show_options: display bash options settings
alias fix_stty='stty sane' # fix_stty: Restore terminal settings when screwed up
alias cic='set completion-ignore-case On' # cic: Make tab-completion case-insensitive
mcd () { mkdir -p "$1" && cd "$1"; } # mcd: Makes new Dir and jumps inside
trash () { command mv "$@" ~/.Trash ; } # trash: Moves a file to the MacOS trash
ql () { qlmanage -p "$*" >& /dev/null; } # ql: Opens any file in MacOS Quicklook Preview
alias DT='tee ~/Desktop/terminalOut.txt' # DT: Pipe content to file on MacOS Desktop

# lr: Full Recursive Directory Listing
# ------------------------------------------
alias lr='ls -R | grep ":$" | sed -e '\''s/:$//'\'' -e '\''s/[^-][^\/]*\//--/g'\'' -e '\''s/^/ /'\'' -e '\''s/-/|/'\'' | less'

# mans: Search manpage given in agument '1' for term given in argument '2' (case insensitive)
# displays paginated result with colored search terms and two lines surrounding each hit. Example: mans mplayer codec
# --------------------------------------------------------------------
mans () {
man $1 | grep -iC2 --color=always $2 | less
}

# showa: to remind yourself of an alias (given some part of it)
# ------------------------------------------------------------
showa () { /usr/bin/grep --color=always -i -a1 $@ ~/Library/init/bash/aliases.bash | grep -v '^\s*$' | less -FSRXc ; }

# -------------------------------
# 3. FILE AND FOLDER MANAGEMENT
# -------------------------------

zipf () { zip -r "$1".zip "$1" ; } # zipf: To create a ZIP archive of a folder
alias numFiles='echo $(ls -1 | wc -l)' # numFiles: Count of non-hidden files in current dir
alias make1mb='mkfile 1m ./1MB.dat' # make1mb: Creates a file of 1mb size (all zeros)
alias make5mb='mkfile 5m ./5MB.dat' # make5mb: Creates a file of 5mb size (all zeros)
alias make10mb='mkfile 10m ./10MB.dat' # make10mb: Creates a file of 10mb size (all zeros)

# cdf: 'Cd's to frontmost window of MacOS Finder
# ------------------------------------------------------
cdf () {
currFolderPath=$( /usr/bin/osascript <<EOT
tell application "Finder"
try
set currFolder to (folder of the front window as alias)
on error
set currFolder to (path to desktop folder as alias)
end try
POSIX path of currFolder
end tell
EOT
)
echo "cd to \"$currFolderPath\""
cd "$currFolderPath"
}

# extract: Extract most know archives with one command
# ---------------------------------------------------------
extract () {
if [ -f $1 ] ; then
case $1 in
*.tar.bz2) tar xjf $1 ;;
*.tar.gz) tar xzf $1 ;;
*.bz2) bunzip2 $1 ;;
*.rar) unrar e $1 ;;
*.gz) gunzip $1 ;;
*.tar) tar xf $1 ;;
*.tbz2) tar xjf $1 ;;
*.tgz) tar xzf $1 ;;
*.zip) unzip $1 ;;
*.Z) uncompress $1 ;;
*.7z) 7z x $1 ;;
*) echo "'$1' cannot be extracted via extract()" ;;
esac
else
echo "'$1' is not a valid file"
fi
}

# ---------------------------
# 4. SEARCHING
# ---------------------------

alias qfind="find . -name " # qfind: Quickly search for file
ff () { /usr/bin/find . -name "$@" ; } # ff: Find file under the current directory
ffs () { /usr/bin/find . -name "$@"'*' ; } # ffs: Find file whose name starts with a given string
ffe () { /usr/bin/find . -name '*'"$@" ; } # ffe: Find file whose name ends with a given string

# spotlight: Search for a file using MacOS Spotlight's metadata
# -----------------------------------------------------------
spotlight () { mdfind "kMDItemDisplayName == '$@'wc"; }

# ---------------------------
# 5. PROCESS MANAGEMENT
# ---------------------------

# findPid: find out the pid of a specified process
# -----------------------------------------------------
# Note that the command name can be specified via a regex
# E.g. findPid '/d$/' finds pids of all processes with names ending in 'd'
# Without the 'sudo' it will only find processes of the current user
# -----------------------------------------------------
findPid () { lsof -t -c "$@" ; }

# memHogsTop, memHogsPs: Find memory hogs
# -----------------------------------------------------
alias memHogsTop='top -l 1 -o rsize | head -20'
alias memHogsPs='ps wwaxm -o pid,stat,vsize,rss,time,command | head -10'

# cpuHogs: Find CPU hogs
# -----------------------------------------------------
alias cpu_hogs='ps wwaxr -o pid,stat,%cpu,time,command | head -10'

# topForever: Continual 'top' listing (every 10 seconds)
# -----------------------------------------------------
alias topForever='top -l 9999999 -s 10 -o cpu'

# ttop: Recommended 'top' invocation to minimize resources
# ------------------------------------------------------------
# Taken from this macosxhints article
# http://www.macosxhints.com/article.php?story=20060816123853639
# ------------------------------------------------------------
alias ttop="top -R -F -s 10 -o rsize"

# my_ps: List processes owned by my user:
# ------------------------------------------------------------
my_ps() { ps $@ -u $USER -o pid,%cpu,%mem,start,time,bsdtime,command ; }

# ---------------------------
# 6. NETWORKING
# ---------------------------

alias myip='curl ip.appspot.com' # myip: Public facing IP Address
alias netCons='lsof -i' # netCons: Show all open TCP/IP sockets
alias flushDNS='dscacheutil -flushcache' # flushDNS: Flush out the DNS Cache
alias lsock='sudo /usr/sbin/lsof -i -P' # lsock: Display open sockets
alias lsockU='sudo /usr/sbin/lsof -nP | grep UDP' # lsockU: Display only open UDP sockets
alias lsockT='sudo /usr/sbin/lsof -nP | grep TCP' # lsockT: Display only open TCP sockets
alias ipInfo0='ipconfig getpacket en0' # ipInfo0: Get info on connections for en0
alias ipInfo1='ipconfig getpacket en1' # ipInfo1: Get info on connections for en1
alias openPorts='sudo lsof -i | grep LISTEN' # openPorts: All listening connections
alias showBlocked='sudo ipfw list' # showBlocked: All ipfw rules inc/ blocked IPs

# ii: display useful host related informaton
# -------------------------------------------------------------------
ii() {
echo -e "\nYou are logged on ${RED}$HOST"
echo -e "\nAdditionnal information:$NC " ; uname -a
echo -e "\n${RED}Users logged on:$NC " ; w -h
echo -e "\n${RED}Current date :$NC " ; date
echo -e "\n${RED}Machine stats :$NC " ; uptime
echo -e "\n${RED}Current network location :$NC " ; scselect
echo -e "\n${RED}Public facing IP Address :$NC " ;myip
#echo -e "\n${RED}DNS Configuration:$NC " ; scutil --dns
echo
}

# ---------------------------------------
# 7. SYSTEMS OPERATIONS & INFORMATION
# ---------------------------------------

alias mountReadWrite='/sbin/mount -uw /' # mountReadWrite: For use when booted into single-user

# cleanupDS: Recursively delete .DS_Store files
# -------------------------------------------------------------------
alias cleanupDS="find . -type f -name '*.DS_Store' -ls -delete"

# finderShowHidden: Show hidden files in Finder
# finderHideHidden: Hide hidden files in Finder
# -------------------------------------------------------------------
alias finderShowHidden='defaults write com.apple.finder ShowAllFiles TRUE'
alias finderHideHidden='defaults write com.apple.finder ShowAllFiles FALSE'

# cleanupLS: Clean up LaunchServices to remove duplicates in the "Open With" menu
# -----------------------------------------------------------------------------------
alias cleanupLS="/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user && killall Finder"

# screensaverDesktop: Run a screensaver on the Desktop
# -----------------------------------------------------------------------------------
alias screensaverDesktop='/System/Library/Frameworks/ScreenSaver.framework/Resources/ScreenSaverEngine.app/Contents/MacOS/ScreenSaverEngine -background'

# ---------------------------------------
# 8. WEB DEVELOPMENT
# ---------------------------------------

alias apacheEdit='sudo edit /etc/httpd/httpd.conf' # apacheEdit: Edit httpd.conf
alias apacheRestart='sudo apachectl graceful' # apacheRestart: Restart Apache
alias editHosts='sudo edit /etc/hosts' # editHosts: Edit /etc/hosts file
alias herr='tail /var/log/httpd/error_log' # herr: Tails HTTP error logs
alias apacheLogs="less +F /var/log/apache2/error_log" # Apachelogs: Shows apache error logs
httpHeaders () { /usr/bin/curl -I -L $@ ; } # httpHeaders: Grabs headers from web page

# httpDebug: Download a web page and show info on what took time
# -------------------------------------------------------------------
httpDebug () { /usr/bin/curl $@ -o /dev/null -w "dns: %{time_namelookup} connect: %{time_connect} pretransfer: %{time_pretransfer} starttransfer: %{time_starttransfer} total: %{time_total}\n" ; }

# ---------------------------------------
# 9. REMINDERS & NOTES
# ---------------------------------------

# remove_disk: spin down unneeded disk
# ---------------------------------------
# diskutil eject /dev/disk1s3

# to change the password on an encrypted disk image:
# ---------------------------------------
# hdiutil chpass /path/to/the/diskimage

# to mount a read-only disk image as read-write:
# ---------------------------------------
# hdiutil attach example.dmg -shadow /tmp/example.shadow -noverify

# mounting a removable drive (of type msdos or hfs)
# ---------------------------------------
# mkdir /Volumes/Foo
# ls /dev/disk* to find out the device to use in the mount command)
# mount -t msdos /dev/disk1s1 /Volumes/Foo
# mount -t hfs /dev/disk1s1 /Volumes/Foo

# to create a file of a given size: /usr/sbin/mkfile or /usr/bin/hdiutil
# ---------------------------------------
# e.g.: mkfile 10m 10MB.dat
# e.g.: hdiutil create -size 10m 10MB.dmg
# the above create files that are almost all zeros - if random bytes are desired
# then use: ~/Dev/Perl/randBytes 1048576 > 10MB.dat
</syntaxhighlight>

== Tipps und Tricks ==
=== Mit Terminal auf externe Festplatte zugreifen ===
/Volumes
=== Dateien kopieren, bewegen, umbenennen ===
https://www.macworld.com/article/222558/macos-command-line-copying-moving-files-terminal.html

ProcessWire - FormBuilder (Module)

2021-08-30T14:55:56Z

134.3.85.26:

https://processwire.com/store/form-builder/

== Mails per smtp versenden ==
[[ProcessWire - WireMailSmtp (Module)]]

== CSS bei einfachem embed per iFrame anpassen ==
Einfache Lösung:
* auf Basic Output stellen
* Standard CSS von /site/templates/FormBuilder/main.css kopieren
* Neuen Pfad im Formbuilder Formular eingeben.
Nachteil, das könnte für den User zu kompliziert sein.

== Import Daten für Standard Formular ==
Hiermit kann man schnell ein Formular erstellen. Einfach in Import Feld des Formbuilder kopieren.
Einfaches Standardformular:
<pre>
{
"action": "./",
"method": "post",
"roles": {
"form-submit": [
"guest"
],
"form-list": [],
"form-edit": [],
"form-delete": [],
"entries-list": [],
"entries-edit": [],
"entries-delete": [],
"entries-page": []
},
"framework": "Basic",
"submitText": "Senden",
"successMessage": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus. Zur Kontaktaufnahme benötigen wir entweder Ihre E-Mail oder Ihre Telefonnummer.",
"emailSubject": "Nachricht über Ihr Kontaktformular",
"responderSubject": "Auto-Response",
"saveFlags": 2,
"emailTo": "post@stephanschlegel.de",
"emailFrom": "e_mail",
"submitText1018": "Senden",
"successMessage1018": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage1018": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus.",
"frBasic_cssURL": "/site/templates/styles/forms.css",
"frFoundation_foundationURL": "/site/modules/FormBuilder/frameworks/foundation/",
"frFoundation_horizHeaderClass": "small-5 medium-3 right inline",
"frFoundation_horizContentClass": "small-7 medium-9",
"frUikit_ukURL": "/site/modules/FormBuilder/frameworks/uikit/",
"frUikit_css": "uikit.gradient.min.css",
"frUikit_horizHeaderWidth": 30,
"frAdmin_styleSet": "AdminThemeDefault/styles/main-classic.css",
"frBootstrap_bootURL": "/site/modules/FormBuilder/frameworks/bootstrap/",
"frBootstrap_bootHorizHeaderClass": "col-xs-5 col-sm-4 col-md-3",
"frBootstrap_bootHorizContentClass": "col-xs-7 col-sm-8 col-md-9",
"children": {
"name_1": {
"type": "Text",
"label": "Name",
"label1018": "Ihr Name",
"maxlength": 2048,
"requiredAttr": 1
},
"telefon": {
"type": "Text",
"label": "Telefon",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre Telefonnummer",
"maxlength": 2048,
"requiredAttr": 1,
"requiredIf": "e_mail=''",
"stripTags": 1
},
"e_mail": {
"type": "Text",
"label": "E-Mail",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre E-Mail",
"maxlength": 2048,
"requiredIf": "telefon=''",
"stripTags": 1
},
"ihre_nachricht": {
"type": "Textarea",
"label": "Ihre Nachricht",
"required": 1,
"label1018": "Ihre Nachricht",
"rows": 5
},
"datenschutz": {
"type": "Checkbox",
"label": "Datenschutz",
"description": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"required": 1,
"label1018": "Datenschutz",
"description1018": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"checkedValue": "Ich stimme zu"
}
}
}
</pre>
Mit Adresse...
<pre>
{
"roles": {
"form-submit": [
"guest"
],
"form-list": [],
"form-edit": [],
"form-delete": [],
"entries-list": [],
"entries-edit": [],
"entries-delete": [],
"entries-page": []
},
"framework": "Basic",
"submitText": "Senden",
"successMessage": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus. Zur Kontaktaufnahme benötigen wir entweder Ihre E-Mail oder Ihre Telefonnummer.",
"emailSubject": "Nachricht über Ihr Kontaktformular",
"responderSubject": "Auto-Response",
"saveFlags": 2,
"emailTo": "post@stephanschlegel.de",
"emailFrom": "e_mail",
"submitText1018": "Senden",
"successMessage1018": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage1018": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus.",
"frBasic_cssURL": "/site/templates/styles/forms.css",
"frFoundation_foundationURL": "/site/modules/FormBuilder/frameworks/foundation/",
"frFoundation_horizHeaderClass": "small-5 medium-3 right inline",
"frFoundation_horizContentClass": "small-7 medium-9",
"frUikit_ukURL": "/site/modules/FormBuilder/frameworks/uikit/",
"frUikit_css": "uikit.gradient.min.css",
"frUikit_horizHeaderWidth": 30,
"frAdmin_styleSet": "AdminThemeDefault/styles/main-classic.css",
"frBootstrap_bootURL": "/site/modules/FormBuilder/frameworks/bootstrap/",
"frBootstrap_bootHorizHeaderClass": "col-xs-5 col-sm-4 col-md-3",
"frBootstrap_bootHorizContentClass": "col-xs-7 col-sm-8 col-md-9",
"children": {
"name_1": {
"type": "Text",
"label": "Name",
"label1018": "Ihr Name",
"maxlength": 2048,
"requiredAttr": 1
},
"telefon": {
"type": "Text",
"label": "Telefon",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre Telefonnummer",
"maxlength": 2048,
"requiredAttr": 1,
"requiredIf": "e_mail=''",
"stripTags": 1
},
"e_mail": {
"type": "Text",
"label": "E-Mail",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre E-Mail",
"maxlength": 2048,
"requiredIf": "telefon=''",
"stripTags": 1
},
"ihre_adresse": {
"type": "Text",
"label": "Straße",
"columnWidth": 80,
"label1018": "Straße",
"requiredAttr": 1,
"maxlength": 2048,
"size": 100
},
"hausnummer": {
"type": "Text",
"label": "Hausnr.",
"required": 1,
"columnWidth": 20,
"label1018": "Hausnr.",
"maxlength": 2048
},
"plz_ort": {
"type": "Text",
"label": "PLZ Ort",
"label1018": "PLZ Ort",
"maxlength": 2048
},
"ihre_nachricht": {
"type": "Textarea",
"label": "Ihre Nachricht",
"required": 1,
"label1018": "Ihre Nachricht",
"rows": 5,
"requiredAttr": 1
},
"datenschutz": {
"type": "Checkbox",
"label": "Datenschutz",
"description": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"required": 1,
"label1018": "Datenschutz",
"description1018": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"checkedValue": "1"
}
}
}
</pre>

==Tipps und Tricks für Formbuilder==
=== Links in Checkbox-Label ===
HTML geht nicht aber Markdown funktioniert:
<pre>
Ich habe die [Datenschutzerklärung](https://fbz-vet.de/datenschutz) gelesen und willige in die dort dargestellte Verarbeitung meiner personenbezogenen Daten ein.
</pre>

ProcessWire - Troubleshooting

2021-08-23T17:09:07Z

134.3.85.26: /* Datenbank Fehler auf Strato */

Processwire Probleme lösen:

Links

* https://processwire.com/docs/tutorials/troubleshooting-guide/

== 500 Error auf 1und1 Server ==
.htaccess File anpassen:
<pre>
# -----------------------------------------------------------------------------------------------
# 19. Pass control to ProcessWire if all the above directives allow us to this point.
# For regular VirtualHosts (most installs)
# -----------------------------------------------------------------------------------------------
#RewriteRule ^(.*)$ index.php?it=$1 [L,QSA]

# -----------------------------------------------------------------------------------------------
# 20. If using VirtualDocumentRoot (500 NOTE): comment out the one above and use this one instead
# -----------------------------------------------------------------------------------------------
RewriteRule ^(.*)$ /index.php?it=$1 [L,QSA]
</pre>

== Datenbank Fehler auf Strato ==
Access Denied auf Strato obwohl die Credentials stimmen.

Diese Konfiguration hat funktioniert

<pre>
#################################################################################################
# START PROCESSWIRE HTACCESS DIRECTIVES
# @htaccessVersion 301
# @indexVersion 300
#################################################################################################

# -----------------------------------------------------------------------------------------------
# 1. Don't show directory indexes, but do follow symbolic links
# 500 NOTE: Some cloud hosting companies don't allow +FollowSymLinks.
# Uncomment +SymLinksifOwnerMatch and comment +FollowSymLinks if you have 500 errors.
# If that doesn't resolve the error, then set it back to +FollowSymLinks.
# -----------------------------------------------------------------------------------------------

Options -Indexes
Options +FollowSymLinks
# Options +SymLinksifOwnerMatch

# -----------------------------------------------------------------------------------------------
# 2. Let ProcessWire handle 404s
# -----------------------------------------------------------------------------------------------

ErrorDocument 404 /index.php

# -----------------------------------------------------------------------------------------------
# 3. Handle request for missing favicon.ico/robots.txt files (no ending quote for Apache 1.3)
# -----------------------------------------------------------------------------------------------

<Files favicon.ico>
ErrorDocument 404 "The requested file favicon.ico was not found.
</Files>

<Files robots.txt>
ErrorDocument 404 "The requested file robots.txt was not found.
</Files>

# -----------------------------------------------------------------------------------------------
# 4. Protect from XSS with Apache headers
# -----------------------------------------------------------------------------------------------

<IfModule mod_headers.c>
# prevent site from being loaded in an iframe on another site
# you will need to remove this one if you want to allow external iframes
Header always append X-Frame-Options SAMEORIGIN

# to prevent cross site scripting (IE8+ proprietary)
Header set X-XSS-Protection "1; mode=block"

# prevent mime-based attacks via content sniffing (IE+Chrome)
# Header set X-Content-Type-Options "nosniff"
</IfModule>

# -----------------------------------------------------------------------------------------------
# 5. Protect ProcessWire system files
# -----------------------------------------------------------------------------------------------

<FilesMatch "\.(inc|info|info\.json|module|sh|sql)$|^\..*$|composer\.(json|lock)$">
<IfModule mod_authz_core.c>
Require all denied
</IfModule>
<IfModule !mod_authz_core.c>
Order allow,deny
</IfModule>
</FilesMatch>

# -----------------------------------------------------------------------------------------------
# 6. Override a few PHP settings that can't be changed at runtime (not required)
# 500 NOTE: Try commenting out this entire section below if getting Apache 500 errors.
# -----------------------------------------------------------------------------------------------

<IfModule mod_php5.c>
php_flag magic_quotes_gpc off
php_flag magic_quotes_sybase off
php_flag register_globals off
</IfModule>

# -----------------------------------------------------------------------------------------------
# 7. Set default directory index files
# -----------------------------------------------------------------------------------------------

DirectoryIndex index.php index.html index.htm

# -----------------------------------------------------------------------------------------------
# 8. ProcessWire requires mod_rewrite
# -----------------------------------------------------------------------------------------------

<IfModule mod_rewrite.c>

RewriteEngine On
AddDefaultCharset UTF-8

# -----------------------------------------------------------------------------------------------
# 9. If you only want to allow HTTPS, uncomment the RewriteCond and RewriteRule lines below.
# -----------------------------------------------------------------------------------------------
# RewriteCond %{HTTPS} off
# RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

# If using an AWS load balancer, use these two lines below instead of those above:
# RewriteCond %{HTTP:X-Forwarded-Proto} =http
# RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

# -----------------------------------------------------------------------------------------------
# 10. Set an environment variable so the installer can detect that mod_rewrite is active.
# Note that some web hosts don't support this. If you get a 500 error, you might try
# commenting out this SetEnv line below.
# -----------------------------------------------------------------------------------------------

<IfModule mod_env.c>
SetEnv HTTP_MOD_REWRITE On
</IfModule>

# -----------------------------------------------------------------------------------------------
# 11. OPTIONAL: Set a rewrite base if rewrites aren't working properly on your server.
# And if your site directory starts with a "~" you will most likely have to use this.
# -----------------------------------------------------------------------------------------------

# RewriteBase /
# RewriteBase /pw/
# RewriteBase /~user/

# -----------------------------------------------------------------------------------------------
# 12. Access Restrictions: Keep web users out of dirs that begin with a period,
# but let services like Lets Encrypt use the webroot authentication method.
# -----------------------------------------------------------------------------------------------

RewriteRule "(^|/)\.(?!well-known)" - [F]

# -----------------------------------------------------------------------------------------------
# 13. OPTIONAL: Redirect users to the 'www.' version of the site (uncomment to enable).
# For example: http://processwire.com/ would be redirected to http://www.processwire.com/
# -----------------------------------------------------------------------------------------------

# RewriteCond %{HTTP_HOST} !^www\. [NC]
# RewriteRule ^ http://www.%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

# -----------------------------------------------------------------------------------------------
# 14. OPTIONAL: Send URLs with non-ASCII name-format characters to 404 page (optimization)
# -----------------------------------------------------------------------------------------------

# RewriteCond %{REQUEST_URI} "[^-_.a-zA-Z0-9/~]"
# RewriteCond %{REQUEST_FILENAME} !-f
# RewriteCond %{REQUEST_FILENAME} !-d
# RewriteRule ^(.*)$ index.php?it=/http404/ [L,QSA]

# -----------------------------------------------------------------------------------------------
# 15. Access Restrictions: Protect ProcessWire system files
# -----------------------------------------------------------------------------------------------

# Allow screenshot files (for install.php only: this 1 line below may be removed after install)
RewriteCond %{REQUEST_URI} !(^|/)site-[^/]+/install/[^/]+\.(jpg|jpeg|png|gif)$
# Block access to any htaccess files
RewriteCond %{REQUEST_URI} (^|/)\.htaccess$ [NC,OR]
# Block access to protected assets directories
RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/assets/(cache|logs|backups|sessions|config|install|tmp)($|/.*$) [OR]
# Block acceess to the /site/install/ directory
RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/install($|/.*$) [OR]
# Block dirs in /site/assets/ dirs that start with a hyphen
RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/assets.*/-.+/.* [OR]
# Block access to /wire/config.php, /site/config.php, /site/config-dev.php, and /wire/index.config.php
RewriteCond %{REQUEST_URI} (^|/)(wire|site|site-[^/]+)/(config|index\.config|config-dev)\.php$ [OR]
# Block access to any PHP-based files in /templates-admin/
RewriteCond %{REQUEST_URI} (^|/)(wire|site|site-[^/]+)/templates-admin($|/|/.*\.(php|html?|tpl|inc))$ [OR]
# Block access to any PHP or markup files in /site/templates/
RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/templates($|/|/.*\.(php|html?|tpl|inc))$ [OR]
# Block access to any PHP files in /site/assets/
RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/assets($|/|/.*\.php)$ [OR]
# Block access to any PHP files in core or core module directories
RewriteCond %{REQUEST_URI} (^|/)wire/(core|modules)/.*\.(php|inc|tpl|module|info\.json)$ [OR]
# Block access to any PHP files in /site/modules/
RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/modules/.*\.(php|inc|tpl|module|info\.json)$ [OR]
# Block access to any software identifying txt files
RewriteCond %{REQUEST_URI} (^|/)(COPYRIGHT|INSTALL|README|htaccess)\.(txt|md|textile)$ [OR]
# Block all http access to the default/uninstalled site-default directory
RewriteCond %{REQUEST_URI} (^|/)site-default/
# If any conditions above match, issue a 403 forbidden
RewriteRule ^.*$ - [F,L]

# PW-PAGENAME
# -----------------------------------------------------------------------------------------------
# 16a. Ensure that the URL follows the name-format specification required by PW
# See also directive 16b below, you should choose and use either 16a or 16b.
# -----------------------------------------------------------------------------------------------

RewriteCond %{REQUEST_URI} "^/~?[-_.a-zA-Z0-9/]*$"

# -----------------------------------------------------------------------------------------------
# 16b. Alternative name-format specification for UTF8 page name support.
# If used, comment out section 16a above and uncomment the directive below. If you have updated
# your $config->pageNameWhitelist make the characters below consistent with that.
# -----------------------------------------------------------------------------------------------

# RewriteCond %{REQUEST_URI} "^/~?[-_./a-zA-Z0-9æåäßöüđжхцчшщюяàáâèéëêěìíïîõòóôøùúûůñçčćďĺľńňŕřšťýžабвгдеёзийклмнопрстуфыэęąśłżź]*$"

# END-PW-PAGENAME

# -----------------------------------------------------------------------------------------------
# 17. If the request is for a file or directory that physically exists on the server,
# then don't give control to ProcessWire, and instead load the file
# -----------------------------------------------------------------------------------------------

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !(favicon\.ico|robots\.txt)

# -----------------------------------------------------------------------------------------------
# 18. OPTIONAL: Prevent ProcessWire from attempting to serve images or anything in /site/assets/.
# Both of these lines are optional, but can help to reduce server load. However, they
# are not compatible with the $config->pagefileSecure option (if enabled) and they
# may produce an Apache 404 rather than your regular 404. You may uncomment the two lines
# below if you don't need to use the $config->pagefileSecure option. After uncommenting, test
# a URL like domain.com/site/assets/files/test.jpg to make sure you are getting a 404 and not
# your homepage. If getting your homepage, then either: do not use this option, or comment out
# section #2 above that makes ProcessWire the 404 handler.
# -----------------------------------------------------------------------------------------------

# RewriteCond %{REQUEST_FILENAME} !\.(jpg|jpeg|gif|png|ico)$ [NC]
# RewriteCond %{REQUEST_FILENAME} !(^|/)site/assets/

# -----------------------------------------------------------------------------------------------
# 19. Pass control to ProcessWire if all the above directives allow us to this point.
# For regular VirtualHosts (most installs)
# -----------------------------------------------------------------------------------------------
RewriteRule ^(.*)$ index.php?it=$1 [L,QSA]

# -----------------------------------------------------------------------------------------------
# 20. If using VirtualDocumentRoot (500 NOTE): comment out the one above and use this one instead
# -----------------------------------------------------------------------------------------------
# RewriteRule ^(.*)$ /index.php?it=$1 [L,QSA]

</IfModule>

#################################################################################################
# END PROCESSWIRE HTACCESS DIRECTIVES
#################################################################################################

</pre>

ProcessWire - Troubleshooting

2021-08-23T17:07:25Z

134.3.85.26:

Processwire Probleme lösen:

Links

* https://processwire.com/docs/tutorials/troubleshooting-guide/

== 500 Error auf 1und1 Server ==
.htaccess File anpassen:
<pre>
# -----------------------------------------------------------------------------------------------
# 19. Pass control to ProcessWire if all the above directives allow us to this point.
# For regular VirtualHosts (most installs)
# -----------------------------------------------------------------------------------------------
#RewriteRule ^(.*)$ index.php?it=$1 [L,QSA]

# -----------------------------------------------------------------------------------------------
# 20. If using VirtualDocumentRoot (500 NOTE): comment out the one above and use this one instead
# -----------------------------------------------------------------------------------------------
RewriteRule ^(.*)$ /index.php?it=$1 [L,QSA]
</pre>

== Datenbank Fehler auf Strato ==
Access Denied auf Strato obwohl die Credentials stimmen.
<pre> htaccess ändern wie bei 1und1 </pre>

<pre>
#################################################################################################
# START PROCESSWIRE HTACCESS DIRECTIVES
# @htaccessVersion 301
# @indexVersion 300
#################################################################################################

# -----------------------------------------------------------------------------------------------
# 1. Don't show directory indexes, but do follow symbolic links
# 500 NOTE: Some cloud hosting companies don't allow +FollowSymLinks.
# Uncomment +SymLinksifOwnerMatch and comment +FollowSymLinks if you have 500 errors.
# If that doesn't resolve the error, then set it back to +FollowSymLinks.
# -----------------------------------------------------------------------------------------------

Options -Indexes
Options +FollowSymLinks
# Options +SymLinksifOwnerMatch

# -----------------------------------------------------------------------------------------------
# 2. Let ProcessWire handle 404s
# -----------------------------------------------------------------------------------------------

ErrorDocument 404 /index.php

# -----------------------------------------------------------------------------------------------
# 3. Handle request for missing favicon.ico/robots.txt files (no ending quote for Apache 1.3)
# -----------------------------------------------------------------------------------------------

<Files favicon.ico>
ErrorDocument 404 "The requested file favicon.ico was not found.
</Files>

<Files robots.txt>
ErrorDocument 404 "The requested file robots.txt was not found.
</Files>

# -----------------------------------------------------------------------------------------------
# 4. Protect from XSS with Apache headers
# -----------------------------------------------------------------------------------------------

<IfModule mod_headers.c>
# prevent site from being loaded in an iframe on another site
# you will need to remove this one if you want to allow external iframes
Header always append X-Frame-Options SAMEORIGIN

# to prevent cross site scripting (IE8+ proprietary)
Header set X-XSS-Protection "1; mode=block"

# prevent mime-based attacks via content sniffing (IE+Chrome)
# Header set X-Content-Type-Options "nosniff"
</IfModule>

# -----------------------------------------------------------------------------------------------
# 5. Protect ProcessWire system files
# -----------------------------------------------------------------------------------------------

<FilesMatch "\.(inc|info|info\.json|module|sh|sql)$|^\..*$|composer\.(json|lock)$">
<IfModule mod_authz_core.c>
Require all denied
</IfModule>
<IfModule !mod_authz_core.c>
Order allow,deny
</IfModule>
</FilesMatch>

# -----------------------------------------------------------------------------------------------
# 6. Override a few PHP settings that can't be changed at runtime (not required)
# 500 NOTE: Try commenting out this entire section below if getting Apache 500 errors.
# -----------------------------------------------------------------------------------------------

<IfModule mod_php5.c>
php_flag magic_quotes_gpc off
php_flag magic_quotes_sybase off
php_flag register_globals off
</IfModule>

# -----------------------------------------------------------------------------------------------
# 7. Set default directory index files
# -----------------------------------------------------------------------------------------------

DirectoryIndex index.php index.html index.htm

# -----------------------------------------------------------------------------------------------
# 8. ProcessWire requires mod_rewrite
# -----------------------------------------------------------------------------------------------

<IfModule mod_rewrite.c>

RewriteEngine On
AddDefaultCharset UTF-8

# -----------------------------------------------------------------------------------------------
# 9. If you only want to allow HTTPS, uncomment the RewriteCond and RewriteRule lines below.
# -----------------------------------------------------------------------------------------------
# RewriteCond %{HTTPS} off
# RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

# If using an AWS load balancer, use these two lines below instead of those above:
# RewriteCond %{HTTP:X-Forwarded-Proto} =http
# RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

# -----------------------------------------------------------------------------------------------
# 10. Set an environment variable so the installer can detect that mod_rewrite is active.
# Note that some web hosts don't support this. If you get a 500 error, you might try
# commenting out this SetEnv line below.
# -----------------------------------------------------------------------------------------------

<IfModule mod_env.c>
SetEnv HTTP_MOD_REWRITE On
</IfModule>

# -----------------------------------------------------------------------------------------------
# 11. OPTIONAL: Set a rewrite base if rewrites aren't working properly on your server.
# And if your site directory starts with a "~" you will most likely have to use this.
# -----------------------------------------------------------------------------------------------

# RewriteBase /
# RewriteBase /pw/
# RewriteBase /~user/

# -----------------------------------------------------------------------------------------------
# 12. Access Restrictions: Keep web users out of dirs that begin with a period,
# but let services like Lets Encrypt use the webroot authentication method.
# -----------------------------------------------------------------------------------------------

RewriteRule "(^|/)\.(?!well-known)" - [F]

# -----------------------------------------------------------------------------------------------
# 13. OPTIONAL: Redirect users to the 'www.' version of the site (uncomment to enable).
# For example: http://processwire.com/ would be redirected to http://www.processwire.com/
# -----------------------------------------------------------------------------------------------

# RewriteCond %{HTTP_HOST} !^www\. [NC]
# RewriteRule ^ http://www.%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

# -----------------------------------------------------------------------------------------------
# 14. OPTIONAL: Send URLs with non-ASCII name-format characters to 404 page (optimization)
# -----------------------------------------------------------------------------------------------

# RewriteCond %{REQUEST_URI} "[^-_.a-zA-Z0-9/~]"
# RewriteCond %{REQUEST_FILENAME} !-f
# RewriteCond %{REQUEST_FILENAME} !-d
# RewriteRule ^(.*)$ index.php?it=/http404/ [L,QSA]

# -----------------------------------------------------------------------------------------------
# 15. Access Restrictions: Protect ProcessWire system files
# -----------------------------------------------------------------------------------------------

# Allow screenshot files (for install.php only: this 1 line below may be removed after install)
RewriteCond %{REQUEST_URI} !(^|/)site-[^/]+/install/[^/]+\.(jpg|jpeg|png|gif)$
# Block access to any htaccess files
RewriteCond %{REQUEST_URI} (^|/)\.htaccess$ [NC,OR]
# Block access to protected assets directories
RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/assets/(cache|logs|backups|sessions|config|install|tmp)($|/.*$) [OR]
# Block acceess to the /site/install/ directory
RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/install($|/.*$) [OR]
# Block dirs in /site/assets/ dirs that start with a hyphen
RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/assets.*/-.+/.* [OR]
# Block access to /wire/config.php, /site/config.php, /site/config-dev.php, and /wire/index.config.php
RewriteCond %{REQUEST_URI} (^|/)(wire|site|site-[^/]+)/(config|index\.config|config-dev)\.php$ [OR]
# Block access to any PHP-based files in /templates-admin/
RewriteCond %{REQUEST_URI} (^|/)(wire|site|site-[^/]+)/templates-admin($|/|/.*\.(php|html?|tpl|inc))$ [OR]
# Block access to any PHP or markup files in /site/templates/
RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/templates($|/|/.*\.(php|html?|tpl|inc))$ [OR]
# Block access to any PHP files in /site/assets/
RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/assets($|/|/.*\.php)$ [OR]
# Block access to any PHP files in core or core module directories
RewriteCond %{REQUEST_URI} (^|/)wire/(core|modules)/.*\.(php|inc|tpl|module|info\.json)$ [OR]
# Block access to any PHP files in /site/modules/
RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/modules/.*\.(php|inc|tpl|module|info\.json)$ [OR]
# Block access to any software identifying txt files
RewriteCond %{REQUEST_URI} (^|/)(COPYRIGHT|INSTALL|README|htaccess)\.(txt|md|textile)$ [OR]
# Block all http access to the default/uninstalled site-default directory
RewriteCond %{REQUEST_URI} (^|/)site-default/
# If any conditions above match, issue a 403 forbidden
RewriteRule ^.*$ - [F,L]

# PW-PAGENAME
# -----------------------------------------------------------------------------------------------
# 16a. Ensure that the URL follows the name-format specification required by PW
# See also directive 16b below, you should choose and use either 16a or 16b.
# -----------------------------------------------------------------------------------------------

RewriteCond %{REQUEST_URI} "^/~?[-_.a-zA-Z0-9/]*$"

# -----------------------------------------------------------------------------------------------
# 16b. Alternative name-format specification for UTF8 page name support.
# If used, comment out section 16a above and uncomment the directive below. If you have updated
# your $config->pageNameWhitelist make the characters below consistent with that.
# -----------------------------------------------------------------------------------------------

# RewriteCond %{REQUEST_URI} "^/~?[-_./a-zA-Z0-9æåäßöüđжхцчшщюяàáâèéëêěìíïîõòóôøùúûůñçčćďĺľńňŕřšťýžабвгдеёзийклмнопрстуфыэęąśłżź]*$"

# END-PW-PAGENAME

# PROCACHE v2/a38e52c7571ac9b16e1f4985c2c29242 --------------------------------------------------
RewriteCond %{REQUEST_METHOD} !=POST
RewriteCond %{QUERY_STRING} !.*=.*
RewriteRule ^.*$ - [E=pwpcstep:pour,E=pwpcname:index]
RewriteCond %{ENV:pwpcstep} "=pour"
RewriteCond %{HTTP_COOKIE} !^.*(wire_challenge|wires_challenge).*$
RewriteRule ^.*$ - [E=pwpcstep:stir,E=pwpcpath:%{DOCUMENT_ROOT}/site/assets/ProCache-b90673484900986618ef6c6fe36cf0]
RewriteCond %{ENV:pwpcstep} "=stir"
RewriteCond %{ENV:pwpcpath}/$0/%{ENV:pwpcname}.html -f
RewriteRule ^.*$ - [E=pwpcstep:drink,E=pwpcfile:$0/%{ENV:pwpcname}.html]
RewriteCond %{ENV:pwpcstep} "=drink"
RewriteRule ^(.*) %{ENV:pwpcpath}/%{ENV:pwpcfile} [L]
<ifModule mod_headers.c>
Header set X-PWPC "ProCache" env=pwpcstep
Header set X-Powered-By "ProcessWire CMS, ProCache" env=pwpcstep
</ifModule>
RewriteCond %{REQUEST_URI} "^/~?[-_.a-zA-Z0-9/]*$"
# /PROCACHE -------------------------------------------------------------------------------------

# -----------------------------------------------------------------------------------------------
# 17. If the request is for a file or directory that physically exists on the server,
# then don't give control to ProcessWire, and instead load the file
# -----------------------------------------------------------------------------------------------

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !(favicon\.ico|robots\.txt)

# -----------------------------------------------------------------------------------------------
# 18. OPTIONAL: Prevent ProcessWire from attempting to serve images or anything in /site/assets/.
# Both of these lines are optional, but can help to reduce server load. However, they
# are not compatible with the $config->pagefileSecure option (if enabled) and they
# may produce an Apache 404 rather than your regular 404. You may uncomment the two lines
# below if you don't need to use the $config->pagefileSecure option. After uncommenting, test
# a URL like domain.com/site/assets/files/test.jpg to make sure you are getting a 404 and not
# your homepage. If getting your homepage, then either: do not use this option, or comment out
# section #2 above that makes ProcessWire the 404 handler.
# -----------------------------------------------------------------------------------------------

# RewriteCond %{REQUEST_FILENAME} !\.(jpg|jpeg|gif|png|ico)$ [NC]
# RewriteCond %{REQUEST_FILENAME} !(^|/)site/assets/

# -----------------------------------------------------------------------------------------------
# 19. Pass control to ProcessWire if all the above directives allow us to this point.
# For regular VirtualHosts (most installs)
# -----------------------------------------------------------------------------------------------
RewriteRule ^(.*)$ index.php?it=$1 [L,QSA]

# -----------------------------------------------------------------------------------------------
# 20. If using VirtualDocumentRoot (500 NOTE): comment out the one above and use this one instead
# -----------------------------------------------------------------------------------------------
# RewriteRule ^(.*)$ /index.php?it=$1 [L,QSA]

</IfModule>

#################################################################################################
# END PROCESSWIRE HTACCESS DIRECTIVES
#################################################################################################

</pre>

Htaccess

2021-08-23T12:14:49Z

134.3.85.26: /* Common Cases */

== Anwendung von .htaccess - Dateien ==
=== Weiterführende Links: ===
https://jweiland.net/know-how/internet/htaccess-konfigurieren.html#c2756

http://httpd.apache.org/docs/1.3/howto/htaccess.html

von: http://www.uni-duesseldorf.de/Service/Webmaster/htaccess.php3 Juli 2006

Referenz: Apache Manual: http://www.uni-duesseldorf.de/apache-manual/

[[Apache Mod Rewrite Syntax]]

=== Wozu braucht man das ?===
An wen ein HTTP-Server Dokumente herausgibt, welche spezielle Verarbeitung er u.U. bei einer spezifischen Anforderung (einem request) durchführt - all das wird zunächst durch eine von der Server-Software abhängigen Konfiguration bestimmt, die ein Administrator - ein Webmaster - eingerichtet hat.

Oft ist es aber wünschenswert, daß einzelne Verantwortliche für eine Dokumentenhierarchie auf dem Web-Server selbst ohne Intervention des Webmasters Setzungen vornehmen können, daß z.B. auf einzelne Dokumente oder alle in einem bestimmten Verzeichnis nur ein Zugriff aus bestimmten Domains oder mit verifiziertem Usernamen möglich ist.

Beim Apache-HTTP-Server wie seinem Vorgänger, dem NCSA-httpd, gibt es diese Möglichkeiten durch die Einrichtung von .htaccess-Dateien in dem jeweiligen Verzeichnis. In der folgenden Darstellung wird als Referenz jeweils ein Verweis auf den entsprechenden Abschnitt in der lokale Kopie der Apache-Dokumentation für die Version 1.2 gegeben.

'''Achtung:''' In der Server-Konfiguration kann ein anderer Name als .htaccess vereinbart sein (AccesFileName-Direkt ive).

'''Zweiter Hinweis:''' Die Datei muß für den HTTP-Server lesbar sein, z.B. dadurch erreicht, daß sie öffentlich lesbar ist:

chmod 644 .htaccess

=== Zugriffsbeschränkung auf eine Domain ===
==== für alle Dateien in einem Verzeichnis ====
'''.htaccess'''

order deny,allow
deny from all
allow from .uni-duesseldorf.de 134.99

Alle Dateien in dem Verzeichnis werden nur an Clients ausgeliefert, die eine IP-Adresse beginnend mit 134.99 oder einen Hostnamen endend mit uni-duesseldorf.de besitzen; anderenfalls erfolgt eine Fehlermeldung des Servers (403 Forbidden).

Natürlich genügt in vielen Fällen eine der Alternativen. Beachten Sie dabei die Unterschiede:

* Die Angabe des Domain-Namens allein schließt - bewußt oder nicht - den Zugriff von PC's aus, die nicht im Domain Name System (DNS) registriert sind.
* Die Angabe des IP-Subnetzes allein kann andere ausschließen, die organisatorisch zur gleichen Domain gehören, technisch aber in einem anderen Subnetz hängen.

Wie lässt sich diese Zugriffsbeschränkung testen? Normalerweise benötigt man dazu einen Internet-Zugang über einen anderen Provider (T-Online, AOL, Compuserve etc.). Oder man benutzt einen Browser auf dem Server selbst z.B. in folgender Weise:

lynx http://localhost/Service/Webmaster/htaccess.phtml

Der Zugriff erfolgt dann über das Loopback-Interface mit der IP-Adresse 127.0.0.1.

Referenz: order, deny, allow.

==== für einzelne Dateien ====
'''.htaccess'''

<Files huh*.html>
order deny,allow
deny from all
allow from .uni-duesseldorf.de 134.99
</Files>

Die Zugriffsbeschränkung wie oben gilt jetzt nur für die Dateien, deren Namen auf das hinter Files angegebene Muster passen. Es kann ein einzelner Name angegeben werden oder ein Muster mit den Wildcard-Zeichen ? für ein beliebiges einzelnes Zeichen oder * für eine beliebige Folge von Zeichen.

Schließlich sind auch feinere Muster über reguläre Ausdrücke möglich. Die Syntax der Files-Direktive dafür ist:

<Files ~ "regexp">

Referenz: <Files>, order, deny, allow.

=== Zugriffsbeschränkung über Passwort ===
==== für ein Verzeichnis ====
'''.htaccess'''

AuthType Basic
AuthName MeyersLeute
AuthUserFile /home/meyer/passwd
require valid-user

Dokumente in einem Verzeichnis mit dieser .htaccess-Datei (oder einem Unterverzeichnis) können erst nach Eingabe eines gültigen Benutzernamen und Passwortes gelesen werden. Der Wert hinter AuthName wird vom Browser in der Dialog-Box für die Passwortabfrage angezeigt und dient gleichzeitig dazu, andere Dokumente mit dem gleichen Schutz zu erkennen und einmal eingelesene Werte für Username und Password ohne erneute Abfrage unmittelbar zu verwenden.

Hinter AuthUserFile steht der Pfad der Passwortdatei, die die Benutzernamen und (verschlüsselten) Passwörter enthält. Sie sieht etwa so aus:

/home/meyer/passwd

meyer:xm.kPd4VJc3Fo
mueller:eJFQCL8GftDXI

Auch die Passwortdatei muß für den HTTP-Server lesbar sein. Gerade deshalb sollte sie niemals in demselben Bereich liegen wie die vom Server bedienten Dokumente, da sonst zumindest die gültigen Benutzernamen lesbar wären. (Aus diesem Grund müssen Sie aber u.U. daran denken, auch das entsprechende Verzeichnis - wie /home/meyer im Beispiel - für den HTTP-Server zumindest suchbar zu setzen, also etwa:

chmod 711 /home/meyer

Angelegt und gepflegt werden kann die Passwortdatei mit dem Programm htpasswd:

htpasswd -c /home/meyer/passwd meyer
htpasswd /home/meyer/passwd mueller

Referenz: AuthType, AuthName, AuthUserFile, require.

==== für einzelne Dateien ====
'''.htaccess'''

AuthType Basic
AuthName MeyersLeute
AuthUserFile /home/meyer/passwd
<Files Huh*.html>
require user meyer mueller
</Files>

Die Kombination von 2. und 3. - Passwortschutz für einzelne Dateien in dem aktuellen Verzeichnis. Beim require wird hier noch eine andere Alternative gezeigt: die Aufzählung einzelner Benutzernamen aus der Passwortdatei. Wenn neue Benutzer in der Passwortdatei ergänzt werden, haben diese noch keinen Zugriff auf die so geschützten Seiten.

Wenn die gleiche Liste von Benutzern an mehreren Stellen verwendet werden soll, ist die Definition der Liste über eine Gruppendatei empfehlenswert. Für diese dritte Alternative bzgl. der require-Direktive sind fogende Änderungen notwendig:

1. In der .htaccess-Datei wird eine Gruppendatei angegeben:
AuthGrouprFile /home/meyer/groups
Für den Ort der Ablage dieser Datei gelten dieselben Erwägungen wie für die Passwortdatei oben.
2. In der require-Direktive wird jetzt auf eine Gruppendefinition in der Gruppendatei Bezug genommen:
require group meyers
3. Die Gruppendatei ist eine einfache Textdatei mit je einer Gruppendefinition pro Zeile in folgender Form:

/home/meyer/groups
meyers: meyer mueller

Referenz: AuthType, AuthName, AuthUserFile, AuthGroupFile, <Files>, require.

===Spezielle Optionen===
==== automatischer Index (Directory Listing)====
ausführliche Infos hier: [[htaccess - Directory Listing]]

'''.htaccess'''
Options +Indexes

Mittels der Options-Direktive können - so von der globalen Server-Konfiguration her erlaubt - Voreinstellungen für Verarbeitungsoptionen für das aktuelle Verzeichnis und Unterverzeichnisse überschrieben werden.

Die gezeigte Variante weist den Server an, bei der Referenz auf das aktuelle Verzeichnis oder ein Unterverzeichnis ein Directory-Listing als Index-Datei automatisch zu generieren. Er macht dies allerdings nur, wenn nicht schon eine Index-Datei (mit vordefiniertem Namen wie index.html) vorhanden ist. Ggf. kann man die hier bekannten Namen mit der Direktive

DirectoryIndex Welcome.html

einschränken.

Referenz: Options, DirectoryIndex.

==== Automatischer Index mit User Auth ====
(Quelle Weiland s.o.)
Directory Listing

Soll über einer geschützen Unterseite (z.B. fileadmin/downloads) des Internetauftritts ein Directory Listing realisiert werden, dann sollte die .htaccess wie folgt eingestellt werden:

AuthType Basic
AuthName "system - "
Options +Indexes
IndexOptions +FancyIndexing
AuthUserFile /*ihr_serverpfad/projektpfad/filadmin/downloads/.htpasswd
AuthGroupFile /dev/null
require valid-user

* ihr_serverpfad finden Sie in Ihrem Kundenmenu unter Technische Infos oder durch Eingabe des Befehls $PWD in der Shell.

Den User mit verschlüseltem Passwort in dem Fall in der .htpasswd vorhanden sein.

Die Unterseite mit dem Directory Listing muss von der TYPO3 index.php ausgeschlossen werden und erreichen Sie über die .htaccess in dem Projektverzeichnis mit folgenden Angaben nach der RewriteEngine On:

RewriteRule ^fileadmin/downloads/$ - [L]
RewriteRule ^fileadmin/downloads/.*$ - [L]

==== Startdatei festlegen ====
Mit dem vorigen Beispiel kann man auch festlegen welche Dateien beim Aufruf eines Verzeichnisses (oder der Webadresse) an den Browser geliefert werden sollen. Manchmal hat man den Fall das die Startdatei eines CMS index.php heißt und bei Wartungsarbeiten die Datei index.html aufgerufen werden soll.

DirectoryIndex index.html index.php start.html

weist den Apache an falls vorhanden die Datei index.html aufzurufen, wenn nicht die index.php und so weiter.

Bei Wartungsarbeiten kann man nun einfach eine index.html aufspielen die bei Aufruf der Domain angezeigt wird.

==== PHP - Werte setzen ====
Wenn der Server das erlaubt kann man es folgendermaßen machen:
===== PHP Memory Limit =====
php_value memory_limit 256M
===== PHP Execution Time =====
php_value max_execution_time 240

==== Error Reporting ====
===== Produktiv Betrieb =====
(Fehler unterdrückt aber protokolliert)

php_value error_reporting 2047
php_value display_errors 0
php_value log_errors 1
php_value error_log /eigener/pfad/fehler.log

===== Entwicklung =====
hier sollte display_errors auf 1 stehen

siehe auch [[PHP - Error Reporting / Fehlerbehandlung]]

siehe auch [[TYPO3 - Error Reporting / Fehlerbehandlung]]

==== Skripte sperren ====
z.B. bei Überlastung durch ein Skript (hier im Beispiel meineDomain.de/ajax/

<pre>
RewriteEngine On
RewriteCond %{REQUEST_URI} (.*)ajax(.*) [NC]
RewriteRule ^(.*) - [F]
</pre>

== Browser Caching ==
Beispiel:
<pre>
<IfModule mod_expires.c>
ExpiresActive On
ExpiresByType text/html "access plus 500 seconds"
ExpiresByType image/gif "access plus 14 days"
ExpiresByType image/ico "access plus 14 days"
ExpiresByType image/jpeg "access plus 14 days"
ExpiresByType image/jpg "access plus 14 days"
ExpiresByType image/png "access plus 14 days"
ExpiresByType text/css "access plus 14 days"
ExpiresByType text/javascript "access plus 14 days"
ExpiresByType application/x-javascript "access plus 14 days"
ExpiresByType application/javascript "access plus 14 days"
</IfModule>
</pre>
== Zugriff auf Ordner ==
=== Sperren ===
<pre>
# This file restricts access to the fileadmin/user_upload/_import_export_ directory. It is
# meant to protect temporary files which could contain sensible
# information. Please do not touch.

# Apache < 2.3
<IfModule !mod_authz_core.c>
Order allow,deny
Deny from all
Satisfy All
</IfModule>

# Apache ≥ 2.3
<IfModule mod_authz_core.c>
Require all denied
</IfModule>
</pre>

== Weiterleitung mit .htaccess ==
=== Beispiele mit Fokus auf TYPO3 ===
Quelle Weiland (s.o.)
====Weiterleitungen (Redirects)====
===== Common Cases =====
Einzelne Unterseiten weiterleiten

Aufrufe einer Unterseite (z.B. a.html) auf eine andere Unterseite (z.B. b.html) innerhalb der selben Domain weiterleiten.
Redirect 301 /a.html /b.html

Ganzen Ordner / Verzeichnis weiterleiten

Aufrufe eines Ordners (z.B. /a) auf einen anderen Ordner innerhalb der selben Domain (z.B. /b) weiterleiten. Die Weiterleitung wirkt sich auch auf alle Dateien innerhalb des Ordners /a aus, so wird z.B. der Aufruf von /a/test.html auf /b/test.html weitergeleitet.
Redirect 301 /a /b

Domain Weiterleitung: Ganze Domain umleiten

Aufrufe einer Unterseite (URL) von Domain A auf die selbe Unterseite (URL) unter Domain B weiterleiten.
z.B. domain-a.de/test.html auf domain-b.de/test.html weiterleiten wobei dies nicht nur für test.html, sondern auch für alle weiteren Unterseiten gilt.
Redirect 301 / http://www.domain-b.de/

Alternative Lösung mittels RewriteCond / RewriteRule:
RewriteEngine on
RewriteCond %{HTTP_HOST} domain-a.de$ [NC]
RewriteRule ^(.*) http://www.domain-b.de/$1 [R=301,L]

URLs ohne www. auf URLs mit www. weiterleiten

Standard Domain definieren und Aufrufe einer URL ohne die Subdomain www. auf die entsprechende URL mit www. weiterleiten um z.B. doppelte Inhalte für Suchmaschinen zu vermeiden.
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain.de$ [NC]
RewriteRule (.*) http://www.domain.de/$1 [R=301,L]

Alle Unterseiten auf Startseite weiterleiten

Alle Aufrufe auf Unterseiten einer Domain mit Ausnahme der index.html, der Style.css sowie aller Dateien im Ordner /img/ auf die Startseite weiterleiten.
RewriteEngine on
RewriteBase /
RewriteCond %{REQUEST_URI} !^/(index\.html|style\.css)?$ [NC]
RewriteCond %{REQUEST_URI} !^/img(/|$) [NC]
RewriteRule ^.*$ /index.html [L,R=301]
URL mit Parameter weiterleiten

Aufrufe von URLs welche einen bestimmten Parameter (z.B. test) enthalten, unabhängig von dessen Wert, auf ein Verzeichnis (z.B. /verzeichnis/) oder eine Unterseite weiterleiten.
RewriteEngine on
RewriteCond %{QUERY_STRING} ^test=(.*)$
RewriteRule ^(.*)$ /verzeichnis/? [R=301,L]

URLs mit einem bestimmten Parameterwert weiterleiten (In diesem Fall Wert "test" für den Parameter "s" auf das Verzeichnis "test" weiterleiten).
RewriteEngine on
RewriteCond %{QUERY_STRING} ^s=test$
RewriteRule ^(.*)$ /test/? [R=301,L]
Parameter aus URL entfernen

Aufrufe von URLs welche einen bestimmten Parameter (z.B. www.domain.de/verzeichnis/?test=...) enthalten, unabhängig von dessen Wert, auf die selbe URL ohne Parameter am Ende (z.B. www.domain.de/verzeichnis/) weiterleiten bzw. den den Parameter aus der URL entfernen. Falls die Regel nur für einen bestimmten Parameter Wert gelten soll, kann der Code analog zum vorherigen Beispiel modifiziert werden.
RewriteEngine on
RewriteCond %{QUERY_STRING} test=(.*)$
RewriteRule ^(.*)$ /$1? [R=301,L]

===== Allgemeines =====

Die Weiterleitung von Domains und Anfragen zu einzelnen Webseiten ist eine der Hauptanwendungen der .htaccess Datei. Das notwendige Apache Modul mod_rewrite ist in unseren Hosting Tarifen vorhanden.

Die Weiterleitung muss jedoch in der .htaccess Datei zunächst mit folgendem Eintrag aktiviert werden (in den weiteren Beispielen haben wir diese Zeile weggelassen):

RewriteEngine On
301 oder 302 Weiterleitung?

Der Weiterleitung (Redirect) sollte man noch einen Statuscode mitgeben: 301 oder 302. Worin liegt der Unterschied?

301: die Weiterleitung ist dauerhaft, z.B. weil die Navigationsstruktur einer Webseite umgestellt wurde

302: die Weiterleitung erfolgt nur vorübergehend, anschließend gilt wieder die bisherige Adresse

Am Ende der RewriteRule Zeile wird der Code für die Weiterleitung (Redirect) in eckigen Klammern angegeben. Mit dem zusätzlichen Parameter L (Letzter, Last) kann man festlegen, dass die weiteren Anweisungen in der .htaccess Datei ignoriert werden sollen. Hierzu ein Beispiel:

RewriteRule ^neues\.html$ /aktuelles.html [R=301,L]
Damit wird die Seite domain.tld/neues.html dauerhaft auf domain.tlld/aktuelles.htmlweitergeleitet.

Die Schreibweise der Rewrite Regeln basiert dabei auf "Regulären Ausdrücken" (Regular Expressions, regex).

Mit den Zeichen ^ und $ wird Anfang und Ende der umzuleitenden Seite gekennzeichnet. Der Punkt . steht in regulären Ausdrücken für ein beliebiges Zeichen, wenn wir wirklich einen Punkt meinen, dann wird dies mit einem Backslash \ gekennzeichnet (\ bedeutet also: exakt das nächste Zeichen).

====Besonderheit: Anker auf einer Seite====

Auf einer Webseite können "Anker" als Sprungmarke gesetzt sein. Beim Aufruf wird im Browser nicht auf den Anfang der Seite sondern direkt zum Ankerpunkt gesprungen. Der Anker wird durch ein Hash-Zeichen # in der URL gefolgt vom Namen der Sprungmarke gekennzeichnet. Beispiel für eine Adresse mit Anker:

domain.tld/aktuelles.html#artikel25
Soll per .htaccess Weiterleitung direkt auf eine Sprungmarke verwiesen werden, muss der zusätzliche Parameter NE (No Encoding) in eckigen Klammern angegeben werden:

RewriteRule ^neues\.html$ /aktuelles.html#artikel25 [R=301,L,NE]
Domain auf verschlüsselte Verbindung umleiten

Sollen alle Seiten einer Domain ausschließlich über eine SSL-Verbindung aufgerufen werden, so kann dies über einen Eintrag in der .htaccess Datei im Startverzeichnis der Domain eingerichtet werden:

RewriteCond %{SERVER_PORT} !^443$
RewriteRule (.*) https://%{HTTP_HOST}/$1 [L]
In der ersten Zeile wird die Funktion zum Umschreiben von URLs im Apache Webserver aktiviert. In der zweiten Zeile wird die Bedingung definiert "Wenn der Aufruf nicht auf Port 443 erfolgt" (Port 443 wird für SSL-Verschlüsselung verwendet, Port 80 für unverschlüsselte Aufrufe). Zeile 3 ist die Regel für das Umschreiben der URL. Wenn die Bedingung aus Zeile 2 zutrifft, werden die Aufrufe einer beliebigen Seite auf die gleiche Domain (${HTTP_HOST}) jedoch über das https:// Protokoll umgeleitet. Mit /$1 wird die ursprüngliche URL (z.B. impressum.html) an den Domainnamen angefügt. Mit dem Parameter [L] wird angegeben, dass das Umschreiben der URLs hier enden soll, weitere Zeilen in der .htaccess Datei werden also ignoriert.

====Domain name-of-domain.net nach name-der-domain.de umleiten====

Oftmals werden für ein Projekt mehrere Domains registriert, um verschiedene Schreibweisen abzudecken. Nach außen wird eine Hauptdomain kommunziert (Beispiel: name-der-domain.de als Hautpdomain, dazu name-of-domain.net als Zusatzdomains).

Mit folgendem Eintrag in der .htaccess Datei werden alle Aufrufe für name-of-domain.net nach name-der-domain.de weitergeleitet:

RewriteCond %{HTTP_HOST} ^(www\.)?name-of-domain\.net$ [NC]
RewriteRule ^(.*)$ http://www.name-der-domain.de/$1 [R=301,L]
Die Weiterleitung nach name-der-domain.de erfolgt dabei mit dem Statuscode 301 (permanent), so dass auch in Suchmaschinen auf Dauer nur diese erscheint. Dadurch werden Probleme mit "doppeltem Inhalt" (Duplicate Content) vermieden. Alle bei der ursprünglichen Domain übermittelten Parameter werden an die Zieldomain weitergegeben.

====Einer Domain immer www. voranstellen====

Mit folgendem Eintrag in der .htaccess Datei werden alle Aufrufe für eine Domain ohne www auf die Variante mit www weitergeleitet:

RewriteCond %{HTTP_HOST} ^name-der-domain\.de$ [NC]
RewriteRule ^(.*)$ http://www.name-der-domain.de/$1 [R=301,L]
Die Weiterleitung nach www.name-der-domain.de erfolgt dabei mit dem Statuscode 301 (permanent), so dass auch in Suchmaschinen auf Dauer nur diese erscheint.

====Domain auf eine Seite leiten====

Bestimmte Domains oder Subdomains sollen entweder mit oder ohne www auf eine bestimmte Unterseite weitergeleitet werden.

Dazu fügen Sie folgende Zeilen in Ihre .htaccess ein:

#Ohne realurl:
RewriteCond %{HTTP_HOST} ^(www\.)?name-der-domain\.de
RewriteRule ^$ /index.php?id=85

#oder realurl/simulatestatic mit html Suffix:
RewriteCond %{HTTP_HOST} ^(www\.)?name-der-domain\.de
RewriteRule ^$ /unterseite.html

#oder realurl ohne html Suffix:

RewriteCond %{HTTP_HOST} ^(www\.)?name-der-domain\.de
RewriteRule ^$ /unterseite/

====Weiterleitung auf eine andere Domain zu einer Unterseite====

RewriteCond %{HTTP_HOST} ^(www\.)?name-of-domain\.net [NC]
RewriteRule ^(.*)$ http://www.name-der-domain.de/unterseite.hmtl [R=301,L]
Redirect mit ? in der URL

http://www.domainname.de/index.php?id=7
soll nach

http://www.domainname.de/impressum.html
umgeleitet werden. Das Problem ist das ? in der alten URL und muss per QUERY_STRING in der Condition abgefragt werden.
Lösung:

RewriteCond %{QUERY_STRING} ^id=7$
RewriteRule ^.*$ http://www.domainname.de/impressum.html? [L,R=301]
Wichtig ist auch der Browser-Cache. Der sollte unbedingt geleert werden, denn wenn ein Aufruf noch im Cache drin ist kann dadurch u.U. immer auf die falsche Seite leiten.

So verhindert man, dass alte durch einen Umzug oder Neuprogrammierung nicht mehr vorhandene URLs in den Suchmaschinen zu einem schlechteren Ranking

=== Weitere Beispiele (älter) ===

Hinweis: eine Alternative hierfür ist eine PHP Weiterleitung ([[PHP - Tipps und Tricks]])
Quelle Dr.Web 28.12.2006

Sie können sowohl Zugriffe auf bestimmte Dateien als auch auf Verzeichnisse bequem weiterleiten. Das klappt innerhalb der eigenen Domain, aber auch mit externen Verweisen.

Die Datei .htaccess kann mit jedem Text-Editor bearbeitet werden. Eine Umleitung könnte so aussehen:

Redirect /beispielverzeichnis http://www.drweb.de

Ruft jemand die URL http://www.drweb.de/beispielverzeichnis auf landet er ohne weiteren Zwischenstopp direkt auf der Startseite.

Mit Einzeldateien klappt es auch:

Redirect /beispielseite.shtml http://www.drweb.de

oder

Redirect /beispielseite.shtml neueseite.shtml

Wer mag, kann die gesamte Domain auf eine andere umleiten

Redirect / http://www.drweb.de/

Nützlich während Bauarbeiten, bei Reparaturen oder wenn Dateien durch andere ersetzt wurden. Da die Umleitung serverseitig geschieht, spielt der Browser des Besuchers keine Rolle.

Weitere nützliche Beispiele:

Den Domainnamen ohne www auf den mit www umleiten. Es wird der Code 301 mitgegeben.
<pre>
RewriteEngine on
RewriteCond %{HTTP_HOST} !^www\. [NC]
RewriteRule ^(.*)$ http://www.%{HTTP_HOST}/$1 [L,R=301]
</pre>
=== Weiterleitung auf sichere Verbindung (https) ===
== Umleitung auf https ==
Sichere Seiten sind seid 2019 Standard und quasi Pflicht. Mit diesem Code kann man von http auf https weiterleiten und gibt einen 301 (Moved Permanently) Header mit.
<pre>
<IfModule mod_rewrite.c>
# Enable URL rewriting
RewriteEngine On
# Redirect to https
RewriteCond %{SERVER_PORT} !^443$
RewriteRule (.*) https://%{HTTP_HOST}/$1 [R=301,L]
</IfModule>
</pre>

=== Moved Permanently 301 Redirect ===
Quelle:http://www.fladi.de/2008/04/28/howto-webseiten-redirect-mit-301/ (25.7.2008)

Was ist ein 301 redirect?

301 redirect ist die wohl beste Möglichkeit das aktuelle Suchmaschinenranking beim Umzug einer Seite oder des gesamten Webauftritts zu behalten. Der Code “301″ steht für “moved permanently” (dauerhaft verschoben). Ein solches Redirect wird in der .htaccess Datei eintragen. Es trägt die Form (alles in einer Zeile):

redirect 301 pfad/alte/seite/datei.html http://www.domain.de/pfad/neue/seite/datei.html

Beachte, kein “http://www” in das erste Statement zu schreiben. Es muss der komplette Pfad vom Root deines Webservers angegeben werden. Schauen wir uns die Zeile nun nochmal genauer an:

* “redirect 301″ - die eigentliche Anweisung für den Webserver
* “/pfad/alte/seite/datei.html” - die Seite die umgeleitet werden soll
* “http://www.domain.de/pfad/neue/seite.datei.html” - die komplette neue URL

Wie reagiert nun ein Suchmaschinen-Spider auf eine solche Umleitung? Die .htaccess wird ja nicht vom Spider ausgelesen, sondern vom Webserver “ausgeführt”. Der Spider jedoch erkennt den Statuscode, den der Webserver liefert. Beim nächsten Update seiner Datenbank sollte die Suchmaschine nun die alte URL aus dem Index werfen und die neue aufnehmen. Häufig kommt es aber auch vor, dass alte und neue URL gemischt auftauchen. Auch leichte Änderungen im Pagerank können auftreten. Es dauert so ca. 6-8 Wochen bis sich die Änderungen an der Seite auch in den Suchergebnissen niederschlagen.

Weitere Möglichkeiten von 301 redirect:

1. Um ALLE Dateien Deiner Domain mithilfe einer .htaccess umzuleiten kannst Du (auf einem Unix/Linux-Webserver) i.d.R. folgendes verwenden:
redirect 301 ^(.*)$ http://www.domain.de
redirectMatch permanent ^(.*)$ http://www.domain.de

Um Deine alte Startseite (index.html) umzuleiten:
redirect 301 /index.html http://www.domain.de/index.html
redirect permanent /index.html http://www.domain.de/index.html

2. Wenn Du http://domain.de auf http://www.domain.de umleiten möchtest und mod_rewrite auf dem Webserver verfügbar ist, erreichst Du dies durch folgende .htaccess:

Options +FollowSymLinks
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain\.de
RewriteRule ^(.*)$ http://www.domain.de/$1 [R=permanent,L]

oder

Options +FollowSymLinks
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain\.de$ [NC]
RewriteRule ^(.*)$ http://www.domain.de/$1 [R=301,L]

3. Alle .html Dateien auf .php Dateien umzuleiten ist durch mod_rewrite auch kein großes Problem:

RewriteEngine on
RewriteBase /
RewriteRule (.*).html$ /$1.php

4. Um ein Verzeichnis und alles darunter umzuleiten:

redirectMatch 301 ^/verzeichnis-alt/(.*) http://www.domain.de/verzeichnis-neu/

=== Warum nicht per META-Tag redirect machen? ===

Die Umleitung per META-Tag erfolgt direkt in der aufgerufenen Seite. Dort wird im HEAD-Teil

<meta http-equiv=”refresh” content=”0; url=http://www.domain.de/”>
eingetragen. Hierbei bewirkt das “content=10″, dass der Browser nach 10 Sekunden die darauffolgende URL aufruft. Wenn man “content=0″ einträgt wird die Umleitung sofort ausgeführt. Ein paar alte Browser unterstützen diese Art der Umleitung nicht. Deshalb ist es besser noch zusätzlich den Link (neue Domain) mit anzugeben.

Technisch gesehen liefert die angefragte Seite, wie auch die Seite auf die umgeleitet wird, einen Statuscode “200 OK” zurück. Es sind also zwei unabhängige Seiten. Dementsprechend versucht die Suchmaschinen auch beide Seiten zu indizieren. Hier genau liegt aber das Problem. Denn der Spider des Suchmaschinenbetreibers erkennt die Umleitung und wertet Deine Seite deshalb u.U. ab, da es sich um eine beliebte SPAM-Methode handelt. So könnte man 1000 Domains mit solchen Seiten und jeder Menge Keywords einrichten. Echte Besucher (kein Spider) werden umgeleitet auf die eigentliche Seite. Indiziert wird aber nicht nur die eigentliche Seite sondern auch die 1000 Domains mit Keywords, die meist gar nichts mit dem eingentlichen Inhalt zu tun haben.

Beim 301 redirect wird hingegen nur die echte Zielseite in den Index aufgenommen und durch den Statuscode kann der Suchmaschinenbetreiber zusätzlich noch die veralteten Seite aus dem Index werfen. Dies ist also der beste Weg um alte Seiten auf neue umzuleiten und gleichzeitig wird auch der Page Rank mit übertragen.

===Weiterleitung über IP===
<pre>
Options +FollowSymlinks
RewriteEngine on

#IP Bedingung
RewriteCond %{REMOTE_HOST} ^85\.13\.128\.137

#Zielseite erlauben
RewriteCond %{REQUEST_URI} !/ip-remote\.php$

#Umleiten
#RewriteRule ^/* http://demo.webmynet.de/ip-remote.php [R,NE,NC]
RewriteRule /(.*)$ /ip-remote.php [R=302,L]
</pre>

== Erlaubte Anweisungen in .htaccess-Dateien ==

http://de.selfhtml.org/servercgi/server/htaccess.htm

Auszug (Datum des Zugriffs: 10.9.2007):
<pre>
Die Anweisung AllowOverride kann nicht innerhalb einer .htaccess notiert werden, sondern wird ausschließlich vom Server-Administrator in der zentralen Konfigurationsdatei vorgegeben. Um den AllowOverride-Wert in Erfahrung zu bringen, benötigen Sie Einsicht in die Serverkonfiguration. Kontaktieren Sie dazu gegebenenfalls Ihren Webhosting-Provider. Dieser kann den Wert auch ändern, falls Sie bestimmte bisher nicht erlaubte Anweisungen verwenden möchten. Im einzelnen gibt es dafür folgende mögliche Werte:

* Mit AllowOverride None wird der Webserver angewiesen, .htaccess-Dateien zu ignorieren. Das ist im Übrigen die Voreinstellung.
* Mit AllowOverride All wird festgelegt, dass in einer .htaccess-Datei (so gut wie) sämtliche zentrale Vorgaben überschrieben und damit abgeändert werden dürfen. Das kann bedeuten, dass Vorhaben, die eigentlich verboten sind (beispielsweise die Ausführung von CGI-Scripts), mit Hilfe einer .htaccess-Datei erlaubt werden. Als Server-Administrator werden Sie diese Anweisung also nur sehr vorsichtig einsetzen.
* Mit AllowOverride Options wird festgelegt, dass in einer .htaccess-Datei nach unten Anweisungen zur Steuerung spezieller Verzeichniseigenschaften zulässig sind.
* Mit AllowOverride Limit wird festgelegt, dass in einer .htaccess-Datei nach unten Zugriffe von bestimmten Hosts erlaubt oder untersagt werden können.
* Mit AllowOverride Indexes wird festgelegt, dass in einer .htaccess-Datei nach unten Anweisungen zur Steuerung von Verzeichnisindizes zulässig sind.
* Mit AllowOverride FileInfo wird festgelegt, dass in einer .htaccess-Datei Anweisungen zur Akzeptanz bestimmter Dokumenttypen zulässig sind - beispielsweie, um nach unten Individuelle Fehlermeldungen ausgeben zu können.
* Mit AllowOverride AuthConfig wird festgelegt, dass in einer .htaccess-Datei Autorisierungsanweisungen stehen dürfen - das betrifft beispielsweise Regelungen zum nach unten Passwortschutz.

Diese Werte können auch miteinander kombiniert werden. All ist der mächtigste Parameter, mit dem alles das zugelassen wird, was die anderen Parameter steuern.
</pre>

Nach dem Ändern muß natürlich der Server neu gestartet werden (bei Debian: apache restart)

==IP Adressen sperren==

Manchmal ist es notwendig, bestimmte IP Adressen vom Aufruf der Webseite auszusperren, z.B. bei einem Angriffsversuch auf die Webseite. Über folgenden Eintrag in der .htaccess Datei (z.B. vor dem Eintrag 'RewriteEngine On') im Startverzeichnis der Seite lassen sich unerwünschte Besucher abweisen:

order allow,deny
deny from 192.168.2.17
deny from 10.10.20.63
allow from all
Bei mehreren IP Adressen wird jede in eine eigene Zeile eingetragen. Die Einstellung gilt auch für alle Unterverzeichnisse. Wenn jemand mit einer gesperrten Adresse versucht, die Seite aufzurufen, erhält er einen 403 Fehlercode.

==HTML5 Videos / bestimmte Dateitypen zulassen ==

Falls es in einzelnen Browsern zu Problemen beim Abspielen von per HTML5 eingebundenen Videos kommt, helfen eventuell folgende Zeilen in der .htaccess Datei im Projektverzeichnis:

AddType video/ogg .ogm
AddType video/ogg .ogv
AddType video/ogg .ogg
AddType video/webm .webm
AddType audio/webm .weba
AddType video/mp4 .mp4
AddType video/x-m4v .m4v

== htaccess für Typo3 ==

http://www.typo3lexikon.de/server/htaccess.html (11/2014)

<pre>
.htaccess für TYPO3
Ich möchte auf dieser Seite nicht erklären wie .htaccess-Dateien erstellt werden. Nein. Davon gibt es schon zu genüge Dokumentationen im Web:

Allgemeines zu htaccess

URLs manipulieren

Reguläre Ausdrücke

htaccess Beispiele

Auf dieser Seite geht es mehr um das Zusammenspiel von TYPO3 und htaccess-Dateien gerade in Bezug unter der Verwendung von der Extension RealUrl. In den nächsten Zeilen werde ich Euch meine htaccess-Datei in Detail näher erklären:

RewriteEngine
Mit RewriteEngine kannst Du das Modifizieren von URLs de- bzw. aktivieren. Erst wenn diese Option aktiviert ist, kannst du z.B. alle Anfragen, die an Deinen Server gesendet werden auf eine völlig andere Webseite umleiten.
RewriteEngine On
Bestimmte Verzeichnisse nicht umschreiben
Wenn Ihr RealUrl installiert habt, dann erhaltet Ihr je nach Konfiguration URLs wie

/meine-seite/kontakt/impressum.html
Dabei sind die vermeintlichen Ordner gar keine echten Ordner auf dem Server, sondern Informationen, die an die index.php weitergeleitet werden, um dann die gewünschte Seite aufrufen zu können. Was aber, wenn wir wirklich mal einen Ordner auf dem Server öffnen wollen? Dann darf dieser Name des Ordner NICHT an die index.php weitergeleitet werden. Um das zu erreichen verwende ich das Script aus der RealUrl-Dokumentation:
RewriteRule ^typo3$ - [L]
RewriteRule ^typo3/.*$ - [L]
RewriteRule ^uploads/.*$ - [L]
RewriteRule ^fileadmin/.*$ - [L]
RewriteRule ^typo3conf/.*$ - [L]
Hinweis
[L] bedeutet, dass nach dieser Umschreibung der URL keine weiteren Umschreibungen mehr ausgeführt werden.

Der Bindestrich (-) bedeutet, dass keine Umschreibung der URL stattfinden soll.

Doppelter Content
Wer von Euch seine Seite schon mal mit www.seitwert.de bewertet hat, wird bestimmt schon mal über den Eintrag bzgl. doppelten Content/Inhalt gestoßen sein. So kommt es je nach Konfiguration vor, dass eine Seite wie sfroemken.de das Gleiche anzeigt wie www.sfroemken.de. Dieses "Problem" kann sich auch negativ auf die Position in den Suchergebnissen auswirken. Aber auch das lässt sich mit Hilfe der htaccess-Datei bereinigen:

RewriteCond %{HTTP_HOST} ^sfroemken\.de$ [NC]
RewriteRule ^(.*)$ www.sfroemken.de/$1 [R=301,L]
Erklärung
%{HTTP_HOST} kann in diesem Fall sfroemken.de oder aber auch www.sfroemken.de sein. Mit RewriteCond könnt Ihr nun überprüfen, ob der HTTP_HOST mit dem Wert sfroemken.de übereinstimmt. Dank [NC] soll die Groß- und Kleinschreibung bei diesem Vergleich nicht berücksichtigt werden.

Wenn RewriteCond nun ein true zurück gibt, dann wird die Modifikation in RewriteRule ausgeführt. Alles was durch die Klammern markiert wurde, kann im zweiten Parameter mit $1 wiederverwendet werden. [R=301]: Das R steht für redirect und die 301 ist ein bestimmter Servercode, mit dem bestimmt wird, dass es sich bei dieser Weiterleitung um eine parmanente Weiterleitung handelt.

So wird aus

sfroemken.de/kontakt/index.php
ein

www.sfroemken.de/kontakt/index.php
Subdomains
Bei Subdomains müssen wir das genau andersrum machen. Dort gibt es kein www. Da www.seitwert.de aber trotzdem überprüft, ob die Domain auch mit einem www davor erreichbar ist, müssen wir das folgendermaßen abfangen:

RewriteCond %{HTTP_HOST} ^www\.typo3\.sfroemken\.de$ [NC]
RewriteRule ^(.*)$ typo3.sfroemken.de/$1 [R=301,L]
Ordner
Leider haben sich viele Surfer daran gewöhnt Ordner auf einem Server ohne abschließendem Slash (/) anzugeben. Damit dieser Slash automatisch hinten dran gemacht wird, können wir folgendes Script verwenden:
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule (.*[^/])$ %{HTTP_HOST}/$1/ [L,R]
Erklärung
Die ersten beiden RewriteCond fragen ab, ob es sich bei der aufzurufenden URL nicht um eine Datei handelt und nicht um einen symbolischen Link. Wenn beides zutrifft, kann getrost ein zusätzlicher Slash hinten angefügt werden.

Achtung
Wenn Ihr RealUrl so konfiguriert habt, dass Ihr URLs wie

/kontakt/impressum.html
erhaltet, dann muss das Script noch etwas angepasst werden, dann ansonsten erhaltet Ihr eine URL wie diese hier:

/kontakt/impressum.html/
Hier das angepasste Script:

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteCond %{REQUEST_FILENAME} (^.htm$|^.html$)
RewriteRule (.*[^/])$ %{HTTP_HOST}/$1/ [L,R]
Heißt: Wenn die URL mit .htm oder .html endet, dann soll der zusätzliche Slash NICHT hinten dran gemacht werden.

Index-Dateien in Ordnern
Je nach Projekt und Ordner kann es vorkommen, dass Du trotz RealUrl die Index-Dateien in bestimmten Ordnern ausführen möchtest:

/fileadmin/projekt/download/index.php
Allerdings wird derzeit noch diese URL an die TYPO3-eigene index.php im Rootverzeichnis weitergeleitet. Um auch das zu unterbinden sind folgende 6 Zeilen vorgesehen:
RewriteCond %{REQUEST_FILENAME}/index.html -f
RewriteRule / %{REQUEST_URI}/index.html [L]
RewriteCond %{REQUEST_FILENAME}/index.htm -f
RewriteRule / %{REQUEST_URI}/index.htm [L]
RewriteCond %{REQUEST_FILENAME}/index.php -f
RewriteRule / %{REQUEST_URI}/index.php [L]
URL-Modifikation für RealUrl
Dieses Script ist das wichtigste Script überhaupt für RealUrl. Hier wird nun endlich gesagt, dass alle Teile aus der URL an die TYPO3-eigene index.php weitergeleitet werden sollen zur Weiterverarbeitung durch RealUrl.
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* index.php
Hinweis
Je nach Art Eurer TYPO3-Installation könnte es sein, dass Eure index.php ein symbolischer Link ist. In diesem Fall müsst Ihr die letzt Zeile folgendermaßen ändern:

RewriteRule .* /index.php
Scripmerger
Dieses Script benötigt Ihr nur, wenn Ihr die Extension scriptmerger verwenden wollt:
# Expires Header + Removal of ETag
<FilesMatch "\.(ico|png|gif|js|css|jpg|jpeg|swf)">
<IfModule mod_expires.c>
ExpiresActive on
ExpiresDefault "access plus 7 days"
ExpiresDefault "access plus 2 months"
</IfModule>

# ETag
FileETag MTime Size
<IfModule mod_headers.c>
FileETag none
Header unset Last-Modified
</IfModule>
</FilesMatch>

# Compressed Content
<FilesMatch "\.gz\.(js|css)">
<IfModule mod_headers.c>
Header set Content-Encoding gzip
</IfModule>
</FilesMatch>
</pre>
=== Shell Restriction auf all-inkl Server ===
Ab TYPO3 6 moniert das Install Tool das exec nicht augeführt werden darf. Es funktioniert wenn man die cgi Version von PHP nimmt. Das kann man per htaccess oder im KAS Backend einstellen.

Beispiele.
<pre>
AddHandler php55-cgi .php (sofern vom Server unterstützt)
AddHandler php54-cgi .php (sofern vom Server unterstützt)
AddHandler php53-cgi .php
AddHandler php52-cgi .php
AddHandler php5-cgi .php (Version entsprechend der PHP Apache-Modul Version)
</pre>

=== PHP Version auf Weiland Servern ===
Über die PHP-Versionsauswahl im Kundenmenü können Sie die PHP-Version für eine Domain ändern. Folgende Anleitung erklärt, wie Sie die PHP Version für einzelne Verzeichnisse (und deren Unterverzeichnisse) ändern können.

Das Verzeichnis kann dabei nur eine höhere PHP-Version erhalten, als die PHP-Version, die für die Domain im Kundenmenü eingestellt ist.

Das bedeutet: Ist für die Domain PHP 5.6 im Kundenmenü eingestellt, können Sie für einzelne Verzeichnisse PHP 7.0 und höher einstellen, nicht jedoch niedrigere Versionen wie PHP 5.5. *

Außerdem darf für die Domain kein Fast-CGI aktiviert sein.

Um die PHP-Version für ein Verzeichnis zu ändern, legen Sie eine .htaccess-Datei mit folgender Anweisung in dem Verzeichnis ab. Die Anweisung ist abhängig von der PHP-Version, die Sie aktivieren möchten:
AddType application/x-httpd-php72 .php

Htaccess

2021-08-23T12:14:16Z

134.3.85.26: /* == Common Cases */

== Anwendung von .htaccess - Dateien ==
=== Weiterführende Links: ===
https://jweiland.net/know-how/internet/htaccess-konfigurieren.html#c2756

http://httpd.apache.org/docs/1.3/howto/htaccess.html

von: http://www.uni-duesseldorf.de/Service/Webmaster/htaccess.php3 Juli 2006

Referenz: Apache Manual: http://www.uni-duesseldorf.de/apache-manual/

[[Apache Mod Rewrite Syntax]]

=== Wozu braucht man das ?===
An wen ein HTTP-Server Dokumente herausgibt, welche spezielle Verarbeitung er u.U. bei einer spezifischen Anforderung (einem request) durchführt - all das wird zunächst durch eine von der Server-Software abhängigen Konfiguration bestimmt, die ein Administrator - ein Webmaster - eingerichtet hat.

Oft ist es aber wünschenswert, daß einzelne Verantwortliche für eine Dokumentenhierarchie auf dem Web-Server selbst ohne Intervention des Webmasters Setzungen vornehmen können, daß z.B. auf einzelne Dokumente oder alle in einem bestimmten Verzeichnis nur ein Zugriff aus bestimmten Domains oder mit verifiziertem Usernamen möglich ist.

Beim Apache-HTTP-Server wie seinem Vorgänger, dem NCSA-httpd, gibt es diese Möglichkeiten durch die Einrichtung von .htaccess-Dateien in dem jeweiligen Verzeichnis. In der folgenden Darstellung wird als Referenz jeweils ein Verweis auf den entsprechenden Abschnitt in der lokale Kopie der Apache-Dokumentation für die Version 1.2 gegeben.

'''Achtung:''' In der Server-Konfiguration kann ein anderer Name als .htaccess vereinbart sein (AccesFileName-Direkt ive).

'''Zweiter Hinweis:''' Die Datei muß für den HTTP-Server lesbar sein, z.B. dadurch erreicht, daß sie öffentlich lesbar ist:

chmod 644 .htaccess

=== Zugriffsbeschränkung auf eine Domain ===
==== für alle Dateien in einem Verzeichnis ====
'''.htaccess'''

order deny,allow
deny from all
allow from .uni-duesseldorf.de 134.99

Alle Dateien in dem Verzeichnis werden nur an Clients ausgeliefert, die eine IP-Adresse beginnend mit 134.99 oder einen Hostnamen endend mit uni-duesseldorf.de besitzen; anderenfalls erfolgt eine Fehlermeldung des Servers (403 Forbidden).

Natürlich genügt in vielen Fällen eine der Alternativen. Beachten Sie dabei die Unterschiede:

* Die Angabe des Domain-Namens allein schließt - bewußt oder nicht - den Zugriff von PC's aus, die nicht im Domain Name System (DNS) registriert sind.
* Die Angabe des IP-Subnetzes allein kann andere ausschließen, die organisatorisch zur gleichen Domain gehören, technisch aber in einem anderen Subnetz hängen.

Wie lässt sich diese Zugriffsbeschränkung testen? Normalerweise benötigt man dazu einen Internet-Zugang über einen anderen Provider (T-Online, AOL, Compuserve etc.). Oder man benutzt einen Browser auf dem Server selbst z.B. in folgender Weise:

lynx http://localhost/Service/Webmaster/htaccess.phtml

Der Zugriff erfolgt dann über das Loopback-Interface mit der IP-Adresse 127.0.0.1.

Referenz: order, deny, allow.

==== für einzelne Dateien ====
'''.htaccess'''

<Files huh*.html>
order deny,allow
deny from all
allow from .uni-duesseldorf.de 134.99
</Files>

Die Zugriffsbeschränkung wie oben gilt jetzt nur für die Dateien, deren Namen auf das hinter Files angegebene Muster passen. Es kann ein einzelner Name angegeben werden oder ein Muster mit den Wildcard-Zeichen ? für ein beliebiges einzelnes Zeichen oder * für eine beliebige Folge von Zeichen.

Schließlich sind auch feinere Muster über reguläre Ausdrücke möglich. Die Syntax der Files-Direktive dafür ist:

<Files ~ "regexp">

Referenz: <Files>, order, deny, allow.

=== Zugriffsbeschränkung über Passwort ===
==== für ein Verzeichnis ====
'''.htaccess'''

AuthType Basic
AuthName MeyersLeute
AuthUserFile /home/meyer/passwd
require valid-user

Dokumente in einem Verzeichnis mit dieser .htaccess-Datei (oder einem Unterverzeichnis) können erst nach Eingabe eines gültigen Benutzernamen und Passwortes gelesen werden. Der Wert hinter AuthName wird vom Browser in der Dialog-Box für die Passwortabfrage angezeigt und dient gleichzeitig dazu, andere Dokumente mit dem gleichen Schutz zu erkennen und einmal eingelesene Werte für Username und Password ohne erneute Abfrage unmittelbar zu verwenden.

Hinter AuthUserFile steht der Pfad der Passwortdatei, die die Benutzernamen und (verschlüsselten) Passwörter enthält. Sie sieht etwa so aus:

/home/meyer/passwd

meyer:xm.kPd4VJc3Fo
mueller:eJFQCL8GftDXI

Auch die Passwortdatei muß für den HTTP-Server lesbar sein. Gerade deshalb sollte sie niemals in demselben Bereich liegen wie die vom Server bedienten Dokumente, da sonst zumindest die gültigen Benutzernamen lesbar wären. (Aus diesem Grund müssen Sie aber u.U. daran denken, auch das entsprechende Verzeichnis - wie /home/meyer im Beispiel - für den HTTP-Server zumindest suchbar zu setzen, also etwa:

chmod 711 /home/meyer

Angelegt und gepflegt werden kann die Passwortdatei mit dem Programm htpasswd:

htpasswd -c /home/meyer/passwd meyer
htpasswd /home/meyer/passwd mueller

Referenz: AuthType, AuthName, AuthUserFile, require.

==== für einzelne Dateien ====
'''.htaccess'''

AuthType Basic
AuthName MeyersLeute
AuthUserFile /home/meyer/passwd
<Files Huh*.html>
require user meyer mueller
</Files>

Die Kombination von 2. und 3. - Passwortschutz für einzelne Dateien in dem aktuellen Verzeichnis. Beim require wird hier noch eine andere Alternative gezeigt: die Aufzählung einzelner Benutzernamen aus der Passwortdatei. Wenn neue Benutzer in der Passwortdatei ergänzt werden, haben diese noch keinen Zugriff auf die so geschützten Seiten.

Wenn die gleiche Liste von Benutzern an mehreren Stellen verwendet werden soll, ist die Definition der Liste über eine Gruppendatei empfehlenswert. Für diese dritte Alternative bzgl. der require-Direktive sind fogende Änderungen notwendig:

1. In der .htaccess-Datei wird eine Gruppendatei angegeben:
AuthGrouprFile /home/meyer/groups
Für den Ort der Ablage dieser Datei gelten dieselben Erwägungen wie für die Passwortdatei oben.
2. In der require-Direktive wird jetzt auf eine Gruppendefinition in der Gruppendatei Bezug genommen:
require group meyers
3. Die Gruppendatei ist eine einfache Textdatei mit je einer Gruppendefinition pro Zeile in folgender Form:

/home/meyer/groups
meyers: meyer mueller

Referenz: AuthType, AuthName, AuthUserFile, AuthGroupFile, <Files>, require.

===Spezielle Optionen===
==== automatischer Index (Directory Listing)====
ausführliche Infos hier: [[htaccess - Directory Listing]]

'''.htaccess'''
Options +Indexes

Mittels der Options-Direktive können - so von der globalen Server-Konfiguration her erlaubt - Voreinstellungen für Verarbeitungsoptionen für das aktuelle Verzeichnis und Unterverzeichnisse überschrieben werden.

Die gezeigte Variante weist den Server an, bei der Referenz auf das aktuelle Verzeichnis oder ein Unterverzeichnis ein Directory-Listing als Index-Datei automatisch zu generieren. Er macht dies allerdings nur, wenn nicht schon eine Index-Datei (mit vordefiniertem Namen wie index.html) vorhanden ist. Ggf. kann man die hier bekannten Namen mit der Direktive

DirectoryIndex Welcome.html

einschränken.

Referenz: Options, DirectoryIndex.

==== Automatischer Index mit User Auth ====
(Quelle Weiland s.o.)
Directory Listing

Soll über einer geschützen Unterseite (z.B. fileadmin/downloads) des Internetauftritts ein Directory Listing realisiert werden, dann sollte die .htaccess wie folgt eingestellt werden:

AuthType Basic
AuthName "system - "
Options +Indexes
IndexOptions +FancyIndexing
AuthUserFile /*ihr_serverpfad/projektpfad/filadmin/downloads/.htpasswd
AuthGroupFile /dev/null
require valid-user

* ihr_serverpfad finden Sie in Ihrem Kundenmenu unter Technische Infos oder durch Eingabe des Befehls $PWD in der Shell.

Den User mit verschlüseltem Passwort in dem Fall in der .htpasswd vorhanden sein.

Die Unterseite mit dem Directory Listing muss von der TYPO3 index.php ausgeschlossen werden und erreichen Sie über die .htaccess in dem Projektverzeichnis mit folgenden Angaben nach der RewriteEngine On:

RewriteRule ^fileadmin/downloads/$ - [L]
RewriteRule ^fileadmin/downloads/.*$ - [L]

==== Startdatei festlegen ====
Mit dem vorigen Beispiel kann man auch festlegen welche Dateien beim Aufruf eines Verzeichnisses (oder der Webadresse) an den Browser geliefert werden sollen. Manchmal hat man den Fall das die Startdatei eines CMS index.php heißt und bei Wartungsarbeiten die Datei index.html aufgerufen werden soll.

DirectoryIndex index.html index.php start.html

weist den Apache an falls vorhanden die Datei index.html aufzurufen, wenn nicht die index.php und so weiter.

Bei Wartungsarbeiten kann man nun einfach eine index.html aufspielen die bei Aufruf der Domain angezeigt wird.

==== PHP - Werte setzen ====
Wenn der Server das erlaubt kann man es folgendermaßen machen:
===== PHP Memory Limit =====
php_value memory_limit 256M
===== PHP Execution Time =====
php_value max_execution_time 240

==== Error Reporting ====
===== Produktiv Betrieb =====
(Fehler unterdrückt aber protokolliert)

php_value error_reporting 2047
php_value display_errors 0
php_value log_errors 1
php_value error_log /eigener/pfad/fehler.log

===== Entwicklung =====
hier sollte display_errors auf 1 stehen

siehe auch [[PHP - Error Reporting / Fehlerbehandlung]]

siehe auch [[TYPO3 - Error Reporting / Fehlerbehandlung]]

==== Skripte sperren ====
z.B. bei Überlastung durch ein Skript (hier im Beispiel meineDomain.de/ajax/

<pre>
RewriteEngine On
RewriteCond %{REQUEST_URI} (.*)ajax(.*) [NC]
RewriteRule ^(.*) - [F]
</pre>

== Browser Caching ==
Beispiel:
<pre>
<IfModule mod_expires.c>
ExpiresActive On
ExpiresByType text/html "access plus 500 seconds"
ExpiresByType image/gif "access plus 14 days"
ExpiresByType image/ico "access plus 14 days"
ExpiresByType image/jpeg "access plus 14 days"
ExpiresByType image/jpg "access plus 14 days"
ExpiresByType image/png "access plus 14 days"
ExpiresByType text/css "access plus 14 days"
ExpiresByType text/javascript "access plus 14 days"
ExpiresByType application/x-javascript "access plus 14 days"
ExpiresByType application/javascript "access plus 14 days"
</IfModule>
</pre>
== Zugriff auf Ordner ==
=== Sperren ===
<pre>
# This file restricts access to the fileadmin/user_upload/_import_export_ directory. It is
# meant to protect temporary files which could contain sensible
# information. Please do not touch.

# Apache < 2.3
<IfModule !mod_authz_core.c>
Order allow,deny
Deny from all
Satisfy All
</IfModule>

# Apache ≥ 2.3
<IfModule mod_authz_core.c>
Require all denied
</IfModule>
</pre>

== Weiterleitung mit .htaccess ==
=== Beispiele mit Fokus auf TYPO3 ===
Quelle Weiland (s.o.)
====Weiterleitungen (Redirects)====
===== Common Cases =====
Einzelne Unterseiten weiterleiten

Aufrufe einer Unterseite (z.B. a.html) auf eine andere Unterseite (z.B. b.html) innerhalb der selben Domain weiterleiten.
Redirect 301 /a.html /b.html

Ganzen Ordner / Verzeichnis weiterleiten

Aufrufe eines Ordners (z.B. /a) auf einen anderen Ordner innerhalb der selben Domain (z.B. /b) weiterleiten. Die Weiterleitung wirkt sich auch auf alle Dateien innerhalb des Ordners /a aus, so wird z.B. der Aufruf von /a/test.html auf /b/test.html weitergeleitet.
Redirect 301 /a /b

Domain Weiterleitung: Ganze Domain umleiten

Aufrufe einer Unterseite (URL) von Domain A auf die selbe Unterseite (URL) unter Domain B weiterleiten.
z.B. domain-a.de/test.html auf domain-b.de/test.html weiterleiten wobei dies nicht nur für test.html, sondern auch für alle weiteren Unterseiten gilt.
Redirect 301 / http://www.domain-b.de/

Alternative Lösung mittels RewriteCond / RewriteRule:
RewriteEngine on
RewriteCond %{HTTP_HOST} domain-a.de$ [NC]
RewriteRule ^(.*) http://www.domain-b.de/$1 [R=301,L]

URLs ohne www. auf URLs mit www. weiterleiten

Standard Domain definieren und Aufrufe einer URL ohne die Subdomain www. auf die entsprechende URL mit www. weiterleiten um z.B. doppelte Inhalte für Suchmaschinen zu vermeiden.
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain.de$ [NC]
RewriteRule (.*) http://www.domain.de/$1 [R=301,L]

Alle Unterseiten auf Startseite weiterleiten

Alle Aufrufe auf Unterseiten einer Domain mit Ausnahme der index.html, der Style.css sowie aller Dateien im Ordner /img/ auf die Startseite weiterleiten.
RewriteEngine on
RewriteBase /
RewriteCond %{REQUEST_URI} !^/(index\.html|style\.css)?$ [NC]
RewriteCond %{REQUEST_URI} !^/img(/|$) [NC]
RewriteRule ^.*$ /index.html [L,R=301]
URL mit Parameter weiterleiten

Aufrufe von URLs welche einen bestimmten Parameter (z.B. test) enthalten, unabhängig von dessen Wert, auf ein Verzeichnis (z.B. /verzeichnis/) oder eine Unterseite weiterleiten.
RewriteEngine on
RewriteCond %{QUERY_STRING} ^test=(.*)$
RewriteRule ^(.*)$ /verzeichnis/? [R=301,L]

URLs mit einem bestimmten Parameterwert weiterleiten (In diesem Fall Wert "test" für den Parameter "s" auf das Verzeichnis "test" weiterleiten).
RewriteEngine on
RewriteCond %{QUERY_STRING} ^s=test$
RewriteRule ^(.*)$ /test/? [R=301,L]
Parameter aus URL entfernen

Aufrufe von URLs welche einen bestimmten Parameter (z.B. www.domain.de/verzeichnis/?test=...) enthalten, unabhängig von dessen Wert, auf die selbe URL ohne Parameter am Ende (z.B. www.domain.de/verzeichnis/) weiterleiten bzw. den den Parameter aus der URL entfernen. Falls die Regel nur für einen bestimmten Parameter Wert gelten soll, kann der Code analog zum vorherigen Beispiel modifiziert werden.
RewriteEngine on
RewriteCond %{QUERY_STRING} test=(.*)$
RewriteRule ^(.*)$ /$1? [R=301,L]

===== Allgemeines =====

Die Weiterleitung von Domains und Anfragen zu einzelnen Webseiten ist eine der Hauptanwendungen der .htaccess Datei. Das notwendige Apache Modul mod_rewrite ist in unseren Hosting Tarifen vorhanden.

Die Weiterleitung muss jedoch in der .htaccess Datei zunächst mit folgendem Eintrag aktiviert werden (in den weiteren Beispielen haben wir diese Zeile weggelassen):

RewriteEngine On
301 oder 302 Weiterleitung?

Der Weiterleitung (Redirect) sollte man noch einen Statuscode mitgeben: 301 oder 302. Worin liegt der Unterschied?

301: die Weiterleitung ist dauerhaft, z.B. weil die Navigationsstruktur einer Webseite umgestellt wurde

302: die Weiterleitung erfolgt nur vorübergehend, anschließend gilt wieder die bisherige Adresse

Am Ende der RewriteRule Zeile wird der Code für die Weiterleitung (Redirect) in eckigen Klammern angegeben. Mit dem zusätzlichen Parameter L (Letzter, Last) kann man festlegen, dass die weiteren Anweisungen in der .htaccess Datei ignoriert werden sollen. Hierzu ein Beispiel:

RewriteRule ^neues\.html$ /aktuelles.html [R=301,L]
Damit wird die Seite domain.tld/neues.html dauerhaft auf domain.tlld/aktuelles.htmlweitergeleitet.

Die Schreibweise der Rewrite Regeln basiert dabei auf "Regulären Ausdrücken" (Regular Expressions, regex).

Mit den Zeichen ^ und $ wird Anfang und Ende der umzuleitenden Seite gekennzeichnet. Der Punkt . steht in regulären Ausdrücken für ein beliebiges Zeichen, wenn wir wirklich einen Punkt meinen, dann wird dies mit einem Backslash \ gekennzeichnet (\ bedeutet also: exakt das nächste Zeichen).

====Besonderheit: Anker auf einer Seite====

Auf einer Webseite können "Anker" als Sprungmarke gesetzt sein. Beim Aufruf wird im Browser nicht auf den Anfang der Seite sondern direkt zum Ankerpunkt gesprungen. Der Anker wird durch ein Hash-Zeichen # in der URL gefolgt vom Namen der Sprungmarke gekennzeichnet. Beispiel für eine Adresse mit Anker:

domain.tld/aktuelles.html#artikel25
Soll per .htaccess Weiterleitung direkt auf eine Sprungmarke verwiesen werden, muss der zusätzliche Parameter NE (No Encoding) in eckigen Klammern angegeben werden:

RewriteRule ^neues\.html$ /aktuelles.html#artikel25 [R=301,L,NE]
Domain auf verschlüsselte Verbindung umleiten

Sollen alle Seiten einer Domain ausschließlich über eine SSL-Verbindung aufgerufen werden, so kann dies über einen Eintrag in der .htaccess Datei im Startverzeichnis der Domain eingerichtet werden:

RewriteCond %{SERVER_PORT} !^443$
RewriteRule (.*) https://%{HTTP_HOST}/$1 [L]
In der ersten Zeile wird die Funktion zum Umschreiben von URLs im Apache Webserver aktiviert. In der zweiten Zeile wird die Bedingung definiert "Wenn der Aufruf nicht auf Port 443 erfolgt" (Port 443 wird für SSL-Verschlüsselung verwendet, Port 80 für unverschlüsselte Aufrufe). Zeile 3 ist die Regel für das Umschreiben der URL. Wenn die Bedingung aus Zeile 2 zutrifft, werden die Aufrufe einer beliebigen Seite auf die gleiche Domain (${HTTP_HOST}) jedoch über das https:// Protokoll umgeleitet. Mit /$1 wird die ursprüngliche URL (z.B. impressum.html) an den Domainnamen angefügt. Mit dem Parameter [L] wird angegeben, dass das Umschreiben der URLs hier enden soll, weitere Zeilen in der .htaccess Datei werden also ignoriert.

====Domain name-of-domain.net nach name-der-domain.de umleiten====

Oftmals werden für ein Projekt mehrere Domains registriert, um verschiedene Schreibweisen abzudecken. Nach außen wird eine Hauptdomain kommunziert (Beispiel: name-der-domain.de als Hautpdomain, dazu name-of-domain.net als Zusatzdomains).

Mit folgendem Eintrag in der .htaccess Datei werden alle Aufrufe für name-of-domain.net nach name-der-domain.de weitergeleitet:

RewriteCond %{HTTP_HOST} ^(www\.)?name-of-domain\.net$ [NC]
RewriteRule ^(.*)$ http://www.name-der-domain.de/$1 [R=301,L]
Die Weiterleitung nach name-der-domain.de erfolgt dabei mit dem Statuscode 301 (permanent), so dass auch in Suchmaschinen auf Dauer nur diese erscheint. Dadurch werden Probleme mit "doppeltem Inhalt" (Duplicate Content) vermieden. Alle bei der ursprünglichen Domain übermittelten Parameter werden an die Zieldomain weitergegeben.

====Einer Domain immer www. voranstellen====

Mit folgendem Eintrag in der .htaccess Datei werden alle Aufrufe für eine Domain ohne www auf die Variante mit www weitergeleitet:

RewriteCond %{HTTP_HOST} ^name-der-domain\.de$ [NC]
RewriteRule ^(.*)$ http://www.name-der-domain.de/$1 [R=301,L]
Die Weiterleitung nach www.name-der-domain.de erfolgt dabei mit dem Statuscode 301 (permanent), so dass auch in Suchmaschinen auf Dauer nur diese erscheint.

====Domain auf eine Seite leiten====

Bestimmte Domains oder Subdomains sollen entweder mit oder ohne www auf eine bestimmte Unterseite weitergeleitet werden.

Dazu fügen Sie folgende Zeilen in Ihre .htaccess ein:

#Ohne realurl:
RewriteCond %{HTTP_HOST} ^(www\.)?name-der-domain\.de
RewriteRule ^$ /index.php?id=85

#oder realurl/simulatestatic mit html Suffix:
RewriteCond %{HTTP_HOST} ^(www\.)?name-der-domain\.de
RewriteRule ^$ /unterseite.html

#oder realurl ohne html Suffix:

RewriteCond %{HTTP_HOST} ^(www\.)?name-der-domain\.de
RewriteRule ^$ /unterseite/

====Weiterleitung auf eine andere Domain zu einer Unterseite====

RewriteCond %{HTTP_HOST} ^(www\.)?name-of-domain\.net [NC]
RewriteRule ^(.*)$ http://www.name-der-domain.de/unterseite.hmtl [R=301,L]
Redirect mit ? in der URL

http://www.domainname.de/index.php?id=7
soll nach

http://www.domainname.de/impressum.html
umgeleitet werden. Das Problem ist das ? in der alten URL und muss per QUERY_STRING in der Condition abgefragt werden.
Lösung:

RewriteCond %{QUERY_STRING} ^id=7$
RewriteRule ^.*$ http://www.domainname.de/impressum.html? [L,R=301]
Wichtig ist auch der Browser-Cache. Der sollte unbedingt geleert werden, denn wenn ein Aufruf noch im Cache drin ist kann dadurch u.U. immer auf die falsche Seite leiten.

So verhindert man, dass alte durch einen Umzug oder Neuprogrammierung nicht mehr vorhandene URLs in den Suchmaschinen zu einem schlechteren Ranking

=== Weitere Beispiele (älter) ===

Hinweis: eine Alternative hierfür ist eine PHP Weiterleitung ([[PHP - Tipps und Tricks]])
Quelle Dr.Web 28.12.2006

Sie können sowohl Zugriffe auf bestimmte Dateien als auch auf Verzeichnisse bequem weiterleiten. Das klappt innerhalb der eigenen Domain, aber auch mit externen Verweisen.

Die Datei .htaccess kann mit jedem Text-Editor bearbeitet werden. Eine Umleitung könnte so aussehen:

Redirect /beispielverzeichnis http://www.drweb.de

Ruft jemand die URL http://www.drweb.de/beispielverzeichnis auf landet er ohne weiteren Zwischenstopp direkt auf der Startseite.

Mit Einzeldateien klappt es auch:

Redirect /beispielseite.shtml http://www.drweb.de

oder

Redirect /beispielseite.shtml neueseite.shtml

Wer mag, kann die gesamte Domain auf eine andere umleiten

Redirect / http://www.drweb.de/

Nützlich während Bauarbeiten, bei Reparaturen oder wenn Dateien durch andere ersetzt wurden. Da die Umleitung serverseitig geschieht, spielt der Browser des Besuchers keine Rolle.

Weitere nützliche Beispiele:

Den Domainnamen ohne www auf den mit www umleiten. Es wird der Code 301 mitgegeben.
<pre>
RewriteEngine on
RewriteCond %{HTTP_HOST} !^www\. [NC]
RewriteRule ^(.*)$ http://www.%{HTTP_HOST}/$1 [L,R=301]
</pre>
=== Weiterleitung auf sichere Verbindung (https) ===
== Umleitung auf https ==
Sichere Seiten sind seid 2019 Standard und quasi Pflicht. Mit diesem Code kann man von http auf https weiterleiten und gibt einen 301 (Moved Permanently) Header mit.
<pre>
<IfModule mod_rewrite.c>
# Enable URL rewriting
RewriteEngine On
# Redirect to https
RewriteCond %{SERVER_PORT} !^443$
RewriteRule (.*) https://%{HTTP_HOST}/$1 [R=301,L]
</IfModule>
</pre>

=== Moved Permanently 301 Redirect ===
Quelle:http://www.fladi.de/2008/04/28/howto-webseiten-redirect-mit-301/ (25.7.2008)

Was ist ein 301 redirect?

301 redirect ist die wohl beste Möglichkeit das aktuelle Suchmaschinenranking beim Umzug einer Seite oder des gesamten Webauftritts zu behalten. Der Code “301″ steht für “moved permanently” (dauerhaft verschoben). Ein solches Redirect wird in der .htaccess Datei eintragen. Es trägt die Form (alles in einer Zeile):

redirect 301 pfad/alte/seite/datei.html http://www.domain.de/pfad/neue/seite/datei.html

Beachte, kein “http://www” in das erste Statement zu schreiben. Es muss der komplette Pfad vom Root deines Webservers angegeben werden. Schauen wir uns die Zeile nun nochmal genauer an:

* “redirect 301″ - die eigentliche Anweisung für den Webserver
* “/pfad/alte/seite/datei.html” - die Seite die umgeleitet werden soll
* “http://www.domain.de/pfad/neue/seite.datei.html” - die komplette neue URL

Wie reagiert nun ein Suchmaschinen-Spider auf eine solche Umleitung? Die .htaccess wird ja nicht vom Spider ausgelesen, sondern vom Webserver “ausgeführt”. Der Spider jedoch erkennt den Statuscode, den der Webserver liefert. Beim nächsten Update seiner Datenbank sollte die Suchmaschine nun die alte URL aus dem Index werfen und die neue aufnehmen. Häufig kommt es aber auch vor, dass alte und neue URL gemischt auftauchen. Auch leichte Änderungen im Pagerank können auftreten. Es dauert so ca. 6-8 Wochen bis sich die Änderungen an der Seite auch in den Suchergebnissen niederschlagen.

Weitere Möglichkeiten von 301 redirect:

1. Um ALLE Dateien Deiner Domain mithilfe einer .htaccess umzuleiten kannst Du (auf einem Unix/Linux-Webserver) i.d.R. folgendes verwenden:
redirect 301 ^(.*)$ http://www.domain.de
redirectMatch permanent ^(.*)$ http://www.domain.de

Um Deine alte Startseite (index.html) umzuleiten:
redirect 301 /index.html http://www.domain.de/index.html
redirect permanent /index.html http://www.domain.de/index.html

2. Wenn Du http://domain.de auf http://www.domain.de umleiten möchtest und mod_rewrite auf dem Webserver verfügbar ist, erreichst Du dies durch folgende .htaccess:

Options +FollowSymLinks
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain\.de
RewriteRule ^(.*)$ http://www.domain.de/$1 [R=permanent,L]

oder

Options +FollowSymLinks
RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain\.de$ [NC]
RewriteRule ^(.*)$ http://www.domain.de/$1 [R=301,L]

3. Alle .html Dateien auf .php Dateien umzuleiten ist durch mod_rewrite auch kein großes Problem:

RewriteEngine on
RewriteBase /
RewriteRule (.*).html$ /$1.php

4. Um ein Verzeichnis und alles darunter umzuleiten:

redirectMatch 301 ^/verzeichnis-alt/(.*) http://www.domain.de/verzeichnis-neu/

=== Warum nicht per META-Tag redirect machen? ===

Die Umleitung per META-Tag erfolgt direkt in der aufgerufenen Seite. Dort wird im HEAD-Teil

<meta http-equiv=”refresh” content=”0; url=http://www.domain.de/”>
eingetragen. Hierbei bewirkt das “content=10″, dass der Browser nach 10 Sekunden die darauffolgende URL aufruft. Wenn man “content=0″ einträgt wird die Umleitung sofort ausgeführt. Ein paar alte Browser unterstützen diese Art der Umleitung nicht. Deshalb ist es besser noch zusätzlich den Link (neue Domain) mit anzugeben.

Technisch gesehen liefert die angefragte Seite, wie auch die Seite auf die umgeleitet wird, einen Statuscode “200 OK” zurück. Es sind also zwei unabhängige Seiten. Dementsprechend versucht die Suchmaschinen auch beide Seiten zu indizieren. Hier genau liegt aber das Problem. Denn der Spider des Suchmaschinenbetreibers erkennt die Umleitung und wertet Deine Seite deshalb u.U. ab, da es sich um eine beliebte SPAM-Methode handelt. So könnte man 1000 Domains mit solchen Seiten und jeder Menge Keywords einrichten. Echte Besucher (kein Spider) werden umgeleitet auf die eigentliche Seite. Indiziert wird aber nicht nur die eigentliche Seite sondern auch die 1000 Domains mit Keywords, die meist gar nichts mit dem eingentlichen Inhalt zu tun haben.

Beim 301 redirect wird hingegen nur die echte Zielseite in den Index aufgenommen und durch den Statuscode kann der Suchmaschinenbetreiber zusätzlich noch die veralteten Seite aus dem Index werfen. Dies ist also der beste Weg um alte Seiten auf neue umzuleiten und gleichzeitig wird auch der Page Rank mit übertragen.

===Weiterleitung über IP===
<pre>
Options +FollowSymlinks
RewriteEngine on

#IP Bedingung
RewriteCond %{REMOTE_HOST} ^85\.13\.128\.137

#Zielseite erlauben
RewriteCond %{REQUEST_URI} !/ip-remote\.php$

#Umleiten
#RewriteRule ^/* http://demo.webmynet.de/ip-remote.php [R,NE,NC]
RewriteRule /(.*)$ /ip-remote.php [R=302,L]
</pre>

== Erlaubte Anweisungen in .htaccess-Dateien ==

http://de.selfhtml.org/servercgi/server/htaccess.htm

Auszug (Datum des Zugriffs: 10.9.2007):
<pre>
Die Anweisung AllowOverride kann nicht innerhalb einer .htaccess notiert werden, sondern wird ausschließlich vom Server-Administrator in der zentralen Konfigurationsdatei vorgegeben. Um den AllowOverride-Wert in Erfahrung zu bringen, benötigen Sie Einsicht in die Serverkonfiguration. Kontaktieren Sie dazu gegebenenfalls Ihren Webhosting-Provider. Dieser kann den Wert auch ändern, falls Sie bestimmte bisher nicht erlaubte Anweisungen verwenden möchten. Im einzelnen gibt es dafür folgende mögliche Werte:

* Mit AllowOverride None wird der Webserver angewiesen, .htaccess-Dateien zu ignorieren. Das ist im Übrigen die Voreinstellung.
* Mit AllowOverride All wird festgelegt, dass in einer .htaccess-Datei (so gut wie) sämtliche zentrale Vorgaben überschrieben und damit abgeändert werden dürfen. Das kann bedeuten, dass Vorhaben, die eigentlich verboten sind (beispielsweise die Ausführung von CGI-Scripts), mit Hilfe einer .htaccess-Datei erlaubt werden. Als Server-Administrator werden Sie diese Anweisung also nur sehr vorsichtig einsetzen.
* Mit AllowOverride Options wird festgelegt, dass in einer .htaccess-Datei nach unten Anweisungen zur Steuerung spezieller Verzeichniseigenschaften zulässig sind.
* Mit AllowOverride Limit wird festgelegt, dass in einer .htaccess-Datei nach unten Zugriffe von bestimmten Hosts erlaubt oder untersagt werden können.
* Mit AllowOverride Indexes wird festgelegt, dass in einer .htaccess-Datei nach unten Anweisungen zur Steuerung von Verzeichnisindizes zulässig sind.
* Mit AllowOverride FileInfo wird festgelegt, dass in einer .htaccess-Datei Anweisungen zur Akzeptanz bestimmter Dokumenttypen zulässig sind - beispielsweie, um nach unten Individuelle Fehlermeldungen ausgeben zu können.
* Mit AllowOverride AuthConfig wird festgelegt, dass in einer .htaccess-Datei Autorisierungsanweisungen stehen dürfen - das betrifft beispielsweise Regelungen zum nach unten Passwortschutz.

Diese Werte können auch miteinander kombiniert werden. All ist der mächtigste Parameter, mit dem alles das zugelassen wird, was die anderen Parameter steuern.
</pre>

Nach dem Ändern muß natürlich der Server neu gestartet werden (bei Debian: apache restart)

==IP Adressen sperren==

Manchmal ist es notwendig, bestimmte IP Adressen vom Aufruf der Webseite auszusperren, z.B. bei einem Angriffsversuch auf die Webseite. Über folgenden Eintrag in der .htaccess Datei (z.B. vor dem Eintrag 'RewriteEngine On') im Startverzeichnis der Seite lassen sich unerwünschte Besucher abweisen:

order allow,deny
deny from 192.168.2.17
deny from 10.10.20.63
allow from all
Bei mehreren IP Adressen wird jede in eine eigene Zeile eingetragen. Die Einstellung gilt auch für alle Unterverzeichnisse. Wenn jemand mit einer gesperrten Adresse versucht, die Seite aufzurufen, erhält er einen 403 Fehlercode.

==HTML5 Videos / bestimmte Dateitypen zulassen ==

Falls es in einzelnen Browsern zu Problemen beim Abspielen von per HTML5 eingebundenen Videos kommt, helfen eventuell folgende Zeilen in der .htaccess Datei im Projektverzeichnis:

AddType video/ogg .ogm
AddType video/ogg .ogv
AddType video/ogg .ogg
AddType video/webm .webm
AddType audio/webm .weba
AddType video/mp4 .mp4
AddType video/x-m4v .m4v

== htaccess für Typo3 ==

http://www.typo3lexikon.de/server/htaccess.html (11/2014)

<pre>
.htaccess für TYPO3
Ich möchte auf dieser Seite nicht erklären wie .htaccess-Dateien erstellt werden. Nein. Davon gibt es schon zu genüge Dokumentationen im Web:

Allgemeines zu htaccess

URLs manipulieren

Reguläre Ausdrücke

htaccess Beispiele

Auf dieser Seite geht es mehr um das Zusammenspiel von TYPO3 und htaccess-Dateien gerade in Bezug unter der Verwendung von der Extension RealUrl. In den nächsten Zeilen werde ich Euch meine htaccess-Datei in Detail näher erklären:

RewriteEngine
Mit RewriteEngine kannst Du das Modifizieren von URLs de- bzw. aktivieren. Erst wenn diese Option aktiviert ist, kannst du z.B. alle Anfragen, die an Deinen Server gesendet werden auf eine völlig andere Webseite umleiten.
RewriteEngine On
Bestimmte Verzeichnisse nicht umschreiben
Wenn Ihr RealUrl installiert habt, dann erhaltet Ihr je nach Konfiguration URLs wie

/meine-seite/kontakt/impressum.html
Dabei sind die vermeintlichen Ordner gar keine echten Ordner auf dem Server, sondern Informationen, die an die index.php weitergeleitet werden, um dann die gewünschte Seite aufrufen zu können. Was aber, wenn wir wirklich mal einen Ordner auf dem Server öffnen wollen? Dann darf dieser Name des Ordner NICHT an die index.php weitergeleitet werden. Um das zu erreichen verwende ich das Script aus der RealUrl-Dokumentation:
RewriteRule ^typo3$ - [L]
RewriteRule ^typo3/.*$ - [L]
RewriteRule ^uploads/.*$ - [L]
RewriteRule ^fileadmin/.*$ - [L]
RewriteRule ^typo3conf/.*$ - [L]
Hinweis
[L] bedeutet, dass nach dieser Umschreibung der URL keine weiteren Umschreibungen mehr ausgeführt werden.

Der Bindestrich (-) bedeutet, dass keine Umschreibung der URL stattfinden soll.

Doppelter Content
Wer von Euch seine Seite schon mal mit www.seitwert.de bewertet hat, wird bestimmt schon mal über den Eintrag bzgl. doppelten Content/Inhalt gestoßen sein. So kommt es je nach Konfiguration vor, dass eine Seite wie sfroemken.de das Gleiche anzeigt wie www.sfroemken.de. Dieses "Problem" kann sich auch negativ auf die Position in den Suchergebnissen auswirken. Aber auch das lässt sich mit Hilfe der htaccess-Datei bereinigen:

RewriteCond %{HTTP_HOST} ^sfroemken\.de$ [NC]
RewriteRule ^(.*)$ www.sfroemken.de/$1 [R=301,L]
Erklärung
%{HTTP_HOST} kann in diesem Fall sfroemken.de oder aber auch www.sfroemken.de sein. Mit RewriteCond könnt Ihr nun überprüfen, ob der HTTP_HOST mit dem Wert sfroemken.de übereinstimmt. Dank [NC] soll die Groß- und Kleinschreibung bei diesem Vergleich nicht berücksichtigt werden.

Wenn RewriteCond nun ein true zurück gibt, dann wird die Modifikation in RewriteRule ausgeführt. Alles was durch die Klammern markiert wurde, kann im zweiten Parameter mit $1 wiederverwendet werden. [R=301]: Das R steht für redirect und die 301 ist ein bestimmter Servercode, mit dem bestimmt wird, dass es sich bei dieser Weiterleitung um eine parmanente Weiterleitung handelt.

So wird aus

sfroemken.de/kontakt/index.php
ein

www.sfroemken.de/kontakt/index.php
Subdomains
Bei Subdomains müssen wir das genau andersrum machen. Dort gibt es kein www. Da www.seitwert.de aber trotzdem überprüft, ob die Domain auch mit einem www davor erreichbar ist, müssen wir das folgendermaßen abfangen:

RewriteCond %{HTTP_HOST} ^www\.typo3\.sfroemken\.de$ [NC]
RewriteRule ^(.*)$ typo3.sfroemken.de/$1 [R=301,L]
Ordner
Leider haben sich viele Surfer daran gewöhnt Ordner auf einem Server ohne abschließendem Slash (/) anzugeben. Damit dieser Slash automatisch hinten dran gemacht wird, können wir folgendes Script verwenden:
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule (.*[^/])$ %{HTTP_HOST}/$1/ [L,R]
Erklärung
Die ersten beiden RewriteCond fragen ab, ob es sich bei der aufzurufenden URL nicht um eine Datei handelt und nicht um einen symbolischen Link. Wenn beides zutrifft, kann getrost ein zusätzlicher Slash hinten angefügt werden.

Achtung
Wenn Ihr RealUrl so konfiguriert habt, dass Ihr URLs wie

/kontakt/impressum.html
erhaltet, dann muss das Script noch etwas angepasst werden, dann ansonsten erhaltet Ihr eine URL wie diese hier:

/kontakt/impressum.html/
Hier das angepasste Script:

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteCond %{REQUEST_FILENAME} (^.htm$|^.html$)
RewriteRule (.*[^/])$ %{HTTP_HOST}/$1/ [L,R]
Heißt: Wenn die URL mit .htm oder .html endet, dann soll der zusätzliche Slash NICHT hinten dran gemacht werden.

Index-Dateien in Ordnern
Je nach Projekt und Ordner kann es vorkommen, dass Du trotz RealUrl die Index-Dateien in bestimmten Ordnern ausführen möchtest:

/fileadmin/projekt/download/index.php
Allerdings wird derzeit noch diese URL an die TYPO3-eigene index.php im Rootverzeichnis weitergeleitet. Um auch das zu unterbinden sind folgende 6 Zeilen vorgesehen:
RewriteCond %{REQUEST_FILENAME}/index.html -f
RewriteRule / %{REQUEST_URI}/index.html [L]
RewriteCond %{REQUEST_FILENAME}/index.htm -f
RewriteRule / %{REQUEST_URI}/index.htm [L]
RewriteCond %{REQUEST_FILENAME}/index.php -f
RewriteRule / %{REQUEST_URI}/index.php [L]
URL-Modifikation für RealUrl
Dieses Script ist das wichtigste Script überhaupt für RealUrl. Hier wird nun endlich gesagt, dass alle Teile aus der URL an die TYPO3-eigene index.php weitergeleitet werden sollen zur Weiterverarbeitung durch RealUrl.
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* index.php
Hinweis
Je nach Art Eurer TYPO3-Installation könnte es sein, dass Eure index.php ein symbolischer Link ist. In diesem Fall müsst Ihr die letzt Zeile folgendermaßen ändern:

RewriteRule .* /index.php
Scripmerger
Dieses Script benötigt Ihr nur, wenn Ihr die Extension scriptmerger verwenden wollt:
# Expires Header + Removal of ETag
<FilesMatch "\.(ico|png|gif|js|css|jpg|jpeg|swf)">
<IfModule mod_expires.c>
ExpiresActive on
ExpiresDefault "access plus 7 days"
ExpiresDefault "access plus 2 months"
</IfModule>

# ETag
FileETag MTime Size
<IfModule mod_headers.c>
FileETag none
Header unset Last-Modified
</IfModule>
</FilesMatch>

# Compressed Content
<FilesMatch "\.gz\.(js|css)">
<IfModule mod_headers.c>
Header set Content-Encoding gzip
</IfModule>
</FilesMatch>
</pre>
=== Shell Restriction auf all-inkl Server ===
Ab TYPO3 6 moniert das Install Tool das exec nicht augeführt werden darf. Es funktioniert wenn man die cgi Version von PHP nimmt. Das kann man per htaccess oder im KAS Backend einstellen.

Beispiele.
<pre>
AddHandler php55-cgi .php (sofern vom Server unterstützt)
AddHandler php54-cgi .php (sofern vom Server unterstützt)
AddHandler php53-cgi .php
AddHandler php52-cgi .php
AddHandler php5-cgi .php (Version entsprechend der PHP Apache-Modul Version)
</pre>

=== PHP Version auf Weiland Servern ===
Über die PHP-Versionsauswahl im Kundenmenü können Sie die PHP-Version für eine Domain ändern. Folgende Anleitung erklärt, wie Sie die PHP Version für einzelne Verzeichnisse (und deren Unterverzeichnisse) ändern können.

Das Verzeichnis kann dabei nur eine höhere PHP-Version erhalten, als die PHP-Version, die für die Domain im Kundenmenü eingestellt ist.

Das bedeutet: Ist für die Domain PHP 5.6 im Kundenmenü eingestellt, können Sie für einzelne Verzeichnisse PHP 7.0 und höher einstellen, nicht jedoch niedrigere Versionen wie PHP 5.5. *

Außerdem darf für die Domain kein Fast-CGI aktiviert sein.

Um die PHP-Version für ein Verzeichnis zu ändern, legen Sie eine .htaccess-Datei mit folgender Anweisung in dem Verzeichnis ab. Die Anweisung ist abhängig von der PHP-Version, die Sie aktivieren möchten:
AddType application/x-httpd-php72 .php

CSS - Baukasten

2021-08-17T15:39:56Z

134.3.85.26: /* OLD STUFF */

Alt ! Siehe auch [[CSS - Snippets]]
Ziel des Abschnittes CSS-Baukasten ist es verschiedene CSS-Skripte vorzuhalten, die für verschiedene Projekte eingesetzt werden können.

Siehe auch:

[[CSS - Tipps & Tricks]]

[[CSS - Snippets]]
== Standard Layouts ==

=== CSS - Font Starter 2020 ===
Gute Größen für Fonts (html base size 16px). Von Vice übernommen. Evtl. ist normale Schrift etwas klein auf Retina.

<pre>
--color-primary: black;
--color-accent: black;
--font-family-hed: VICE Grotesk, Helvetica Neue World, Helvetica Neue, Helvetica, Arial, sans-serif;
--font-weight-hed-normal: 500;
--font-weight-hed-bold: 900;
--line-height-hed-tight: 1;
--line-height-hed-normal: 1.3;
--line-height-hed-loose: 1.7;
--font-family-dek: VICE Grotesk, Helvetica Neue World, Helvetica Neue, Helvetica, Arial, sans-serif;
--font-weight-dek-normal: 400;
--font-weight-dek-bold: 700;
--line-height-dek-tight: 1;
--line-height-dek-normal: 1.3;
--line-height-dek-loose: 1.7;
--font-family-accent: Source Code Pro, Monaco, monospace;
--font-weight-accent-normal: 400;
--font-weight-accent-bold: 700;
--line-height-accent-tight: 1;
--line-height-accent-normal: 1.3;
--line-height-accent-loose: 1.7;
--font-family-body: Lora, Georgia, serif;
--font-weight-body-normal: 400;
--font-weight-body-bold: 700;
--line-height-body-tight: 1;
--line-height-body-normal: 1.3;
--line-height-body-loose: 1.7;
--font-size-h1: 3.125rem;
--font-size-h2: 2rem;
--font-size-h3: 1.25rem;
--font-size-h4: 1rem;
--font-size-h5: 0.8125rem;
--font-size-h6: 0.6875rem;
--font-size-body: 1.125rem;
--font-size-dropcap: 3.75rem;
--line-height-dropcap: 2.6875rem;
</pre>

== OLD STUFF ==
[[Typo3 Standard-CSS mit YUI]]

== CSS-Grid Systeme / CSS-Frameworks ==
=== Frameworks 2015 ===
==== Big ====
Bootstrap, Foundation, Grumby
==== Small ====
Pure.css, Skeleton, Cardinal, Base, KnaCSS,
=== Links ===
http://www.tripwiremagazine.com/2009/06/45-css-grid-systems-layout-generators-and-tutorials-that-every-designer-should-know.html

hiervon sind die engl. Beschreibungen

=== 1140 grid ===
* optimiert für 1280px
* skaliert bei kleineren Bildschirmen (inkl. Bilder)
* css3 queries sorgen dafür, daß es bei smartphones funktioniert

http://cssgrid.net/

=== YUI Yahoo User Interface ===

=== 960gs ===
CSS Framework that worth a look. The download includes templates for Fireworks, Photoshops, Inkscape and etc. so that you can start designing your web template immediately. The PSD file that comes with guides ready save designers a lot of time.

=== Blueprint ===
Blueprint: A CSS Framework

Blueprint includes a CSS reset that eliminates the discrepancies across different browsers. There are a lot of external tools and templates to aid your web development with Blueprint. See some live Demos
http://www.blueprintcss.org/tests/

=== YAML ===
YAML is another bulletproof CSS Framework that has a very good documentation. You can easily get started by downloading the PDF documentation and the sample project from the official site. There are some tools that will help you on your development too. For example, the YAML Builder can visually create YAML-based CSS layouts.
=== Tripoli Framework ===

Tripoli had been tested and supports virtually all available browsers, including IE5! It comes with some base files, and some plugins such as “Layout”, “Visual”, “Type”, and “Negative”. Tripoli completly resets all default browser standards and rebuilds them quietly with modern web development in mind.

Tripoli is not a CSS framework. It doesn’t tell you how to code your web site. Instead, it forms a solid HTML rendering engine and a base for creating dynamic layouts without interfering with typographic measurements.

=== BlueTrip ===

BlueTrip is a full featured and beautiful framework that combines advantages from different CSS Framework. The official site has a complete Documentation and Demos.

Blueprint: A CSS Framework

Blueprint includes a CSS reset that eliminates the discrepancies across different browsers. There are a lot of external tools and templates to aid your web development with Blueprint. See some live Demos

=== 960 Grid System ===

[[960 Grid System (960gs)]]

CSS Framework that worth a look. The download includes templates for Fireworks, Photoshops, Inkscape and etc. so that you can start designing your web template immediately. The PSD file that comes with guides ready save designers a lot of time.

=== Tripoli Framework ===

Tripoli had been tested and supports virtually all available browsers, including IE5! It comes with some base files, and some plugins such as “Layout”, “Visual”, “Type”, and “Negative”. Tripoli completly resets all default browser standards and rebuilds them quietly with modern web development in mind.

Tripoli is not a CSS framework. It doesn’t tell you how to code your web site. Instead, it forms a solid HTML rendering engine and a base for creating dynamic layouts without interfering with typographic measurements.

=== YAML – Yet Another Multicolumn Layout ===

YAML is another bulletproof CSS Framework that has a very good documentation. You can easily get started by downloading the PDF documentation and the sample project from the official site. There are some tools that will help you on your development too. For example, the YAML Builder can visually create YAML-based CSS layouts.

=== BlueTrip ===

BlueTrip is a full featured and beautiful framework that combines advantages from different CSS Framework. The official site has a complete Documentation and Demos.

=== YUI Grid CSS ===

YUI Grids CSS support fluid-width layouts as well as fixed-width layouts. This is the advantage of YUI Grids CSS over the other CSS Frameworks. To get started with YUI Grids CSS, you can download the cheat sheet and YUI Grids Builder from the official site.

=== Elastic CSS Framework ===

Elastic provides a declarative language to define the layout structure and behavior. This is a young framework, and the best site to demo the usage of Elastic is the official site itself. The Elastic CSS Framework has a lot of classes and helpers that will aid in the process of webdesign.

=== SenCSS ===

SenCSS doesn’t include a layout system, but it does provide other things such as baseline, fonts, paddings, margins and more. It comes with a commented version and a minified version which suitable for production use.

=== The Golden Grid ===

The Golden Grid is a web grid system. It ‘s a product of the search for the perfect modern grid system. It ‘s meant to be a CSS tool for grid based web sites.

=== Content With Style ===

This is a fixed width layout and the zip files contains a few layouts such as vertical navigation with 1 content column, vertical navigation with 2 content columns, and etc.

===CSS-boilerplate===

As one of the original authors of Blueprint CSS I’ve decided to re-factor my ideas into a stripped down framework which provides the bare essentials to begin any project. This framework will be lite and strive not to suggest un-semantic naming conventions. You’re the designer and your craft is important.

=== Typogridphy ===

Typogridphy is a CSS framework constructed to allow web designers and front-end developers to quickly code typograhically pleasing grid layouts.

Based on the popular 960 Grid System, Typogridphy allows you to create grid layouts which are versatile and great looking. Typogridphy is made of fully validate, semantic and strict xHTML, and validate CSS.

=== Logicss ===
The Logic CSS framework is a collection of CSS files and a toolset designed to cut development times for web-standards compliant web layouts and templates.

* Common cross-browser rendering behavior approach (not a reset).
* Beautiful font stacks.
* Typography with text resizing capabilities and vertical baseline/rhythm.
* Three totally flexible layout grid templates, customizable with the toolset.
o Elastic layout using EMs.
o Liquid layout with percentages.
o Fixed layout using pixel dimensions.

== Bausteine für die CSS - Navigation ==
ToDo Bilder machen

Tipp ein umschließendes Div mit Klassen wie .nav-v, .nav-h etc. um die Code-Schnipsel leicht einbinden zu können
=== CSS-Navigation: Vertikale Liste ===
Beispiel 1 (basierend auf TYPO3)

<pre>

.nav-v {

float:left;
margin:0 0 0 -50px;
padding:0;
}
.nav-v #nav-sub{

}
.nav-v ul {
/*padding:0 0 10px 0;*/
/*ie8..*/
float: left;
width:180px;
background: url("../media/nav-divider.png");
background-repeat: no-repeat;
background-position: bottom;
/*padding-bottom: 1px;*/
font-size: 12px;
}

.nav-v li.first{

}

.nav-v li {
background: url("../media/nav-divider.png");
background-repeat: no-repeat;
font-weight:normal;
list-style-position:outside;
margin: 0;
padding: 0;
/* ie8 */
width:180px;
float: left;
}

.nav-v li.last {
margin-bottom: 1px;
}

.nav-v li a {
display:block;
height: 23px;
line-height:23px;
text-decoration:none;
}

.nav-v li a,
.nav-v li a{
color: #333;
}

.nav-v li a:hover,
.nav-v li.cur a,
.nav-v li.act a
{
color: #FFF;
background: url("../media/bg-over.png");
background-repeat: no-repeat;
background-position: 0 1px;
}

/* Level 2 */
.nav-v ul ul{
padding: 0;
}
.nav-v li li {
display: inline;
font-size:11px;
/* ie8 */
border-bottom: 0px;

}
.nav-v li li a{
border-top: 1px dotted #e4e5e6;
background:#014674;
height: 24px;
line-height: 24px;
}

.nav-v li.act li a,
.nav-v li.cur li a{
color:#e4e5e6;
}

.nav-v li li a:hover,
.nav-v li li.cur a:visited,
.nav-v li li.cur a:link
{
color: #FFF;
}
.nav-v li li.act a:visited,
.nav-v li li.act a:link{

}

.nav-v li li.act {
}
.nav-v li li.act a:link,
.nav-v li li.act a:visited {
}

</pre>
=== CSS-Navigation: Horizontale Liste ===
Beispiel

===CSS-Navi: Verschachtelte Rollover Liste===
aus: http://css.maxdesign.com.au/
<pre>
HTML
<div id="navcontainer">
<ul id="navlist">
<li id="active"><a href="#" id="current">Item one</a>
<ul id="subnavlist">
<li id="subactive"><a href="#" id="subcurrent">Subitem one</a></li>
<li><a href="#">Subitem two</a></li>
<li><a href="#">Subitem three</a></li>
<li><a href="#">Subitem four</a></li>
</ul>

</li>
<li><a href="#">Item two</a></li>
<li><a href="#">Item three</a></li>
<li><a href="#">Item four</a></li>
</ul>
</div>

CSS
#navcontainer { margin-left: 30px; }

#navcontainer ul
{
margin: 0;
padding: 0;
list-style-type: none;
font-family: verdana, arial, Helvetica, sans-serif;
}

#navcontainer li { margin: 0 0 1px 0; }

#navcontainer a
{
display: block;
padding: 5px 10px;
width: 140px;
color: #fff;
background-color: #036;
text-decoration: none;
}

#navcontainer a:hover
{
color: #fff;
background-color: #69C;
text-decoration: none;
}

#navcontainer ul ul li { margin: 0 0 1px 0; }

#navcontainer ul ul a
{
display: block;
padding: 5px 5px 5px 30px;
width: 125px;
color: #fff;
background-color: #369;
text-decoration: none;
}

#navcontainer ul ul a:hover
{
color: #fff;
background-color: #69C;
text-decoration: none;
}

ABOUT THE CODE
Some lists within the Listamatic site had to be modified so that they could work on Listamatic's simple list model. When in doubt, use the external resource first, or at least compare both models to see which one suits your needs.
</pre>

In Anlehnukng an YAML werden die Dateien möglichst Modular vorgehalten und über ein Zentrales Sylesheet eingebunden

== Konzept-Richtlinien ==
ToDo - evt. verwerfen erhalten bleibt das Konzept BAukastenmäßig das CSS zu verteilen. Evt. so daß man für sich funkionsfähige Skripte macht und diese durch einen Div Wrap später auf den Bereich beschränkt wo sie eingesetzt werden.
=== Struktur ===
/main.css
ToDo

== Zentrales Stylesheet base.css==

Hier werden die verschiedenen benötigten Dateien eingebunden und einige Grundeinstellungen definiert.
In einer späteren Ausbaustufe werden diese evt. ebenfalls ausgelagert
In Typo3 Projekten könnten die CSS-Dateien auch über TypoScript eingebunden werden dann entfällt die base.css
<pre>
/*
### "CSS-Baukasten (c)2006 Stephan Schlegel" ###
### Version: 0.1
### Datei : base.css
### Funktion : Zentrales Stylesheet, Grundeinstellungen + Einbindung der CSS-Module
*/

@import url(main/base.css);
@import url(mods/basemod.css);
@import url(mods/basemod_layout_xcol_xyz.css);
@import url(navi/nav_slidingdoor.css);
@import url(main/content.css);
@import url(print/print_003.css);
</pre>

CSS - Baukasten

2021-08-17T15:35:29Z

134.3.85.26: /* CSS - Font Starter 2020 */

Alt ! Siehe auch [[CSS - Snippets]]
Ziel des Abschnittes CSS-Baukasten ist es verschiedene CSS-Skripte vorzuhalten, die für verschiedene Projekte eingesetzt werden können.

Siehe auch:

[[CSS - Tipps & Tricks]]

[[CSS - Snippets]]
== Standard Layouts ==

=== CSS - Font Starter 2020 ===
Gute Größen für Fonts (html base size 16px). Von Vice übernommen. Evtl. ist normale Schrift etwas klein auf Retina.

<pre>
--color-primary: black;
--color-accent: black;
--font-family-hed: VICE Grotesk, Helvetica Neue World, Helvetica Neue, Helvetica, Arial, sans-serif;
--font-weight-hed-normal: 500;
--font-weight-hed-bold: 900;
--line-height-hed-tight: 1;
--line-height-hed-normal: 1.3;
--line-height-hed-loose: 1.7;
--font-family-dek: VICE Grotesk, Helvetica Neue World, Helvetica Neue, Helvetica, Arial, sans-serif;
--font-weight-dek-normal: 400;
--font-weight-dek-bold: 700;
--line-height-dek-tight: 1;
--line-height-dek-normal: 1.3;
--line-height-dek-loose: 1.7;
--font-family-accent: Source Code Pro, Monaco, monospace;
--font-weight-accent-normal: 400;
--font-weight-accent-bold: 700;
--line-height-accent-tight: 1;
--line-height-accent-normal: 1.3;
--line-height-accent-loose: 1.7;
--font-family-body: Lora, Georgia, serif;
--font-weight-body-normal: 400;
--font-weight-body-bold: 700;
--line-height-body-tight: 1;
--line-height-body-normal: 1.3;
--line-height-body-loose: 1.7;
--font-size-h1: 3.125rem;
--font-size-h2: 2rem;
--font-size-h3: 1.25rem;
--font-size-h4: 1rem;
--font-size-h5: 0.8125rem;
--font-size-h6: 0.6875rem;
--font-size-body: 1.125rem;
--font-size-dropcap: 3.75rem;
--line-height-dropcap: 2.6875rem;
</pre>

=== OLD STUFF ===
[[Typo3 Standard-CSS mit YUI]]

== CSS-Grid Systeme / CSS-Frameworks ==
=== Frameworks 2015 ===
==== Big ====
Bootstrap, Foundation, Grumby
==== Small ====
Pure.css, Skeleton, Cardinal, Base, KnaCSS,
=== Links ===
http://www.tripwiremagazine.com/2009/06/45-css-grid-systems-layout-generators-and-tutorials-that-every-designer-should-know.html

hiervon sind die engl. Beschreibungen

=== 1140 grid ===
* optimiert für 1280px
* skaliert bei kleineren Bildschirmen (inkl. Bilder)
* css3 queries sorgen dafür, daß es bei smartphones funktioniert

http://cssgrid.net/

=== YUI Yahoo User Interface ===

=== 960gs ===
CSS Framework that worth a look. The download includes templates for Fireworks, Photoshops, Inkscape and etc. so that you can start designing your web template immediately. The PSD file that comes with guides ready save designers a lot of time.

=== Blueprint ===
Blueprint: A CSS Framework

Blueprint includes a CSS reset that eliminates the discrepancies across different browsers. There are a lot of external tools and templates to aid your web development with Blueprint. See some live Demos
http://www.blueprintcss.org/tests/

=== YAML ===
YAML is another bulletproof CSS Framework that has a very good documentation. You can easily get started by downloading the PDF documentation and the sample project from the official site. There are some tools that will help you on your development too. For example, the YAML Builder can visually create YAML-based CSS layouts.
=== Tripoli Framework ===

Tripoli had been tested and supports virtually all available browsers, including IE5! It comes with some base files, and some plugins such as “Layout”, “Visual”, “Type”, and “Negative”. Tripoli completly resets all default browser standards and rebuilds them quietly with modern web development in mind.

Tripoli is not a CSS framework. It doesn’t tell you how to code your web site. Instead, it forms a solid HTML rendering engine and a base for creating dynamic layouts without interfering with typographic measurements.

=== BlueTrip ===

BlueTrip is a full featured and beautiful framework that combines advantages from different CSS Framework. The official site has a complete Documentation and Demos.

Blueprint: A CSS Framework

Blueprint includes a CSS reset that eliminates the discrepancies across different browsers. There are a lot of external tools and templates to aid your web development with Blueprint. See some live Demos

=== 960 Grid System ===

[[960 Grid System (960gs)]]

CSS Framework that worth a look. The download includes templates for Fireworks, Photoshops, Inkscape and etc. so that you can start designing your web template immediately. The PSD file that comes with guides ready save designers a lot of time.

=== Tripoli Framework ===

Tripoli had been tested and supports virtually all available browsers, including IE5! It comes with some base files, and some plugins such as “Layout”, “Visual”, “Type”, and “Negative”. Tripoli completly resets all default browser standards and rebuilds them quietly with modern web development in mind.

Tripoli is not a CSS framework. It doesn’t tell you how to code your web site. Instead, it forms a solid HTML rendering engine and a base for creating dynamic layouts without interfering with typographic measurements.

=== YAML – Yet Another Multicolumn Layout ===

YAML is another bulletproof CSS Framework that has a very good documentation. You can easily get started by downloading the PDF documentation and the sample project from the official site. There are some tools that will help you on your development too. For example, the YAML Builder can visually create YAML-based CSS layouts.

=== BlueTrip ===

BlueTrip is a full featured and beautiful framework that combines advantages from different CSS Framework. The official site has a complete Documentation and Demos.

=== YUI Grid CSS ===

YUI Grids CSS support fluid-width layouts as well as fixed-width layouts. This is the advantage of YUI Grids CSS over the other CSS Frameworks. To get started with YUI Grids CSS, you can download the cheat sheet and YUI Grids Builder from the official site.

=== Elastic CSS Framework ===

Elastic provides a declarative language to define the layout structure and behavior. This is a young framework, and the best site to demo the usage of Elastic is the official site itself. The Elastic CSS Framework has a lot of classes and helpers that will aid in the process of webdesign.

=== SenCSS ===

SenCSS doesn’t include a layout system, but it does provide other things such as baseline, fonts, paddings, margins and more. It comes with a commented version and a minified version which suitable for production use.

=== The Golden Grid ===

The Golden Grid is a web grid system. It ‘s a product of the search for the perfect modern grid system. It ‘s meant to be a CSS tool for grid based web sites.

=== Content With Style ===

This is a fixed width layout and the zip files contains a few layouts such as vertical navigation with 1 content column, vertical navigation with 2 content columns, and etc.

===CSS-boilerplate===

As one of the original authors of Blueprint CSS I’ve decided to re-factor my ideas into a stripped down framework which provides the bare essentials to begin any project. This framework will be lite and strive not to suggest un-semantic naming conventions. You’re the designer and your craft is important.

=== Typogridphy ===

Typogridphy is a CSS framework constructed to allow web designers and front-end developers to quickly code typograhically pleasing grid layouts.

Based on the popular 960 Grid System, Typogridphy allows you to create grid layouts which are versatile and great looking. Typogridphy is made of fully validate, semantic and strict xHTML, and validate CSS.

=== Logicss ===
The Logic CSS framework is a collection of CSS files and a toolset designed to cut development times for web-standards compliant web layouts and templates.

* Common cross-browser rendering behavior approach (not a reset).
* Beautiful font stacks.
* Typography with text resizing capabilities and vertical baseline/rhythm.
* Three totally flexible layout grid templates, customizable with the toolset.
o Elastic layout using EMs.
o Liquid layout with percentages.
o Fixed layout using pixel dimensions.

== Bausteine für die CSS - Navigation ==
ToDo Bilder machen

Tipp ein umschließendes Div mit Klassen wie .nav-v, .nav-h etc. um die Code-Schnipsel leicht einbinden zu können
=== CSS-Navigation: Vertikale Liste ===
Beispiel 1 (basierend auf TYPO3)

<pre>

.nav-v {

float:left;
margin:0 0 0 -50px;
padding:0;
}
.nav-v #nav-sub{

}
.nav-v ul {
/*padding:0 0 10px 0;*/
/*ie8..*/
float: left;
width:180px;
background: url("../media/nav-divider.png");
background-repeat: no-repeat;
background-position: bottom;
/*padding-bottom: 1px;*/
font-size: 12px;
}

.nav-v li.first{

}

.nav-v li {
background: url("../media/nav-divider.png");
background-repeat: no-repeat;
font-weight:normal;
list-style-position:outside;
margin: 0;
padding: 0;
/* ie8 */
width:180px;
float: left;
}

.nav-v li.last {
margin-bottom: 1px;
}

.nav-v li a {
display:block;
height: 23px;
line-height:23px;
text-decoration:none;
}

.nav-v li a,
.nav-v li a{
color: #333;
}

.nav-v li a:hover,
.nav-v li.cur a,
.nav-v li.act a
{
color: #FFF;
background: url("../media/bg-over.png");
background-repeat: no-repeat;
background-position: 0 1px;
}

/* Level 2 */
.nav-v ul ul{
padding: 0;
}
.nav-v li li {
display: inline;
font-size:11px;
/* ie8 */
border-bottom: 0px;

}
.nav-v li li a{
border-top: 1px dotted #e4e5e6;
background:#014674;
height: 24px;
line-height: 24px;
}

.nav-v li.act li a,
.nav-v li.cur li a{
color:#e4e5e6;
}

.nav-v li li a:hover,
.nav-v li li.cur a:visited,
.nav-v li li.cur a:link
{
color: #FFF;
}
.nav-v li li.act a:visited,
.nav-v li li.act a:link{

}

.nav-v li li.act {
}
.nav-v li li.act a:link,
.nav-v li li.act a:visited {
}

</pre>
=== CSS-Navigation: Horizontale Liste ===
Beispiel

===CSS-Navi: Verschachtelte Rollover Liste===
aus: http://css.maxdesign.com.au/
<pre>
HTML
<div id="navcontainer">
<ul id="navlist">
<li id="active"><a href="#" id="current">Item one</a>
<ul id="subnavlist">
<li id="subactive"><a href="#" id="subcurrent">Subitem one</a></li>
<li><a href="#">Subitem two</a></li>
<li><a href="#">Subitem three</a></li>
<li><a href="#">Subitem four</a></li>
</ul>

</li>
<li><a href="#">Item two</a></li>
<li><a href="#">Item three</a></li>
<li><a href="#">Item four</a></li>
</ul>
</div>

CSS
#navcontainer { margin-left: 30px; }

#navcontainer ul
{
margin: 0;
padding: 0;
list-style-type: none;
font-family: verdana, arial, Helvetica, sans-serif;
}

#navcontainer li { margin: 0 0 1px 0; }

#navcontainer a
{
display: block;
padding: 5px 10px;
width: 140px;
color: #fff;
background-color: #036;
text-decoration: none;
}

#navcontainer a:hover
{
color: #fff;
background-color: #69C;
text-decoration: none;
}

#navcontainer ul ul li { margin: 0 0 1px 0; }

#navcontainer ul ul a
{
display: block;
padding: 5px 5px 5px 30px;
width: 125px;
color: #fff;
background-color: #369;
text-decoration: none;
}

#navcontainer ul ul a:hover
{
color: #fff;
background-color: #69C;
text-decoration: none;
}

ABOUT THE CODE
Some lists within the Listamatic site had to be modified so that they could work on Listamatic's simple list model. When in doubt, use the external resource first, or at least compare both models to see which one suits your needs.
</pre>

In Anlehnukng an YAML werden die Dateien möglichst Modular vorgehalten und über ein Zentrales Sylesheet eingebunden

== Konzept-Richtlinien ==
ToDo - evt. verwerfen erhalten bleibt das Konzept BAukastenmäßig das CSS zu verteilen. Evt. so daß man für sich funkionsfähige Skripte macht und diese durch einen Div Wrap später auf den Bereich beschränkt wo sie eingesetzt werden.
=== Struktur ===
/main.css
ToDo

== Zentrales Stylesheet base.css==

Hier werden die verschiedenen benötigten Dateien eingebunden und einige Grundeinstellungen definiert.
In einer späteren Ausbaustufe werden diese evt. ebenfalls ausgelagert
In Typo3 Projekten könnten die CSS-Dateien auch über TypoScript eingebunden werden dann entfällt die base.css
<pre>
/*
### "CSS-Baukasten (c)2006 Stephan Schlegel" ###
### Version: 0.1
### Datei : base.css
### Funktion : Zentrales Stylesheet, Grundeinstellungen + Einbindung der CSS-Module
*/

@import url(main/base.css);
@import url(mods/basemod.css);
@import url(mods/basemod_layout_xcol_xyz.css);
@import url(navi/nav_slidingdoor.css);
@import url(main/content.css);
@import url(print/print_003.css);
</pre>

CSS - Baukasten

2021-08-17T15:28:55Z

134.3.85.26: /* Standard Layouts */

Alt ! Siehe auch [[CSS - Snippets]]
Ziel des Abschnittes CSS-Baukasten ist es verschiedene CSS-Skripte vorzuhalten, die für verschiedene Projekte eingesetzt werden können.

Siehe auch:

[[CSS - Tipps & Tricks]]

[[CSS - Snippets]]
== Standard Layouts ==

=== CSS - Font Starter 2020 ===
Gute Größen für Fonts (html base size 16px. Von Vice übernommen. Evtl. ist normale Schrift etwas klein auf Retina.

<pre>
--color-primary: black;
--color-accent: black;
--font-family-hed: VICE Grotesk, Helvetica Neue World, Helvetica Neue, Helvetica, Arial, sans-serif;
--font-weight-hed-normal: 500;
--font-weight-hed-bold: 900;
--line-height-hed-tight: 1;
--line-height-hed-normal: 1.3;
--line-height-hed-loose: 1.7;
--font-family-dek: VICE Grotesk, Helvetica Neue World, Helvetica Neue, Helvetica, Arial, sans-serif;
--font-weight-dek-normal: 400;
--font-weight-dek-bold: 700;
--line-height-dek-tight: 1;
--line-height-dek-normal: 1.3;
--line-height-dek-loose: 1.7;
--font-family-accent: Source Code Pro, Monaco, monospace;
--font-weight-accent-normal: 400;
--font-weight-accent-bold: 700;
--line-height-accent-tight: 1;
--line-height-accent-normal: 1.3;
--line-height-accent-loose: 1.7;
--font-family-body: Lora, Georgia, serif;
--font-weight-body-normal: 400;
--font-weight-body-bold: 700;
--line-height-body-tight: 1;
--line-height-body-normal: 1.3;
--line-height-body-loose: 1.7;
--font-size-h1: 3.125rem;
--font-size-h2: 2rem;
--font-size-h3: 1.25rem;
--font-size-h4: 1rem;
--font-size-h5: 0.8125rem;
--font-size-h6: 0.6875rem;
--font-size-body: 1.125rem;
--font-size-dropcap: 3.75rem;
--line-height-dropcap: 2.6875rem;
</pre>
=== OLD STUFF ===
[[Typo3 Standard-CSS mit YUI]]

== CSS-Grid Systeme / CSS-Frameworks ==
=== Frameworks 2015 ===
==== Big ====
Bootstrap, Foundation, Grumby
==== Small ====
Pure.css, Skeleton, Cardinal, Base, KnaCSS,
=== Links ===
http://www.tripwiremagazine.com/2009/06/45-css-grid-systems-layout-generators-and-tutorials-that-every-designer-should-know.html

hiervon sind die engl. Beschreibungen

=== 1140 grid ===
* optimiert für 1280px
* skaliert bei kleineren Bildschirmen (inkl. Bilder)
* css3 queries sorgen dafür, daß es bei smartphones funktioniert

http://cssgrid.net/

=== YUI Yahoo User Interface ===

=== 960gs ===
CSS Framework that worth a look. The download includes templates for Fireworks, Photoshops, Inkscape and etc. so that you can start designing your web template immediately. The PSD file that comes with guides ready save designers a lot of time.

=== Blueprint ===
Blueprint: A CSS Framework

Blueprint includes a CSS reset that eliminates the discrepancies across different browsers. There are a lot of external tools and templates to aid your web development with Blueprint. See some live Demos
http://www.blueprintcss.org/tests/

=== YAML ===
YAML is another bulletproof CSS Framework that has a very good documentation. You can easily get started by downloading the PDF documentation and the sample project from the official site. There are some tools that will help you on your development too. For example, the YAML Builder can visually create YAML-based CSS layouts.
=== Tripoli Framework ===

Tripoli had been tested and supports virtually all available browsers, including IE5! It comes with some base files, and some plugins such as “Layout”, “Visual”, “Type”, and “Negative”. Tripoli completly resets all default browser standards and rebuilds them quietly with modern web development in mind.

Tripoli is not a CSS framework. It doesn’t tell you how to code your web site. Instead, it forms a solid HTML rendering engine and a base for creating dynamic layouts without interfering with typographic measurements.

=== BlueTrip ===

BlueTrip is a full featured and beautiful framework that combines advantages from different CSS Framework. The official site has a complete Documentation and Demos.

Blueprint: A CSS Framework

Blueprint includes a CSS reset that eliminates the discrepancies across different browsers. There are a lot of external tools and templates to aid your web development with Blueprint. See some live Demos

=== 960 Grid System ===

[[960 Grid System (960gs)]]

CSS Framework that worth a look. The download includes templates for Fireworks, Photoshops, Inkscape and etc. so that you can start designing your web template immediately. The PSD file that comes with guides ready save designers a lot of time.

=== Tripoli Framework ===

Tripoli had been tested and supports virtually all available browsers, including IE5! It comes with some base files, and some plugins such as “Layout”, “Visual”, “Type”, and “Negative”. Tripoli completly resets all default browser standards and rebuilds them quietly with modern web development in mind.

Tripoli is not a CSS framework. It doesn’t tell you how to code your web site. Instead, it forms a solid HTML rendering engine and a base for creating dynamic layouts without interfering with typographic measurements.

=== YAML – Yet Another Multicolumn Layout ===

YAML is another bulletproof CSS Framework that has a very good documentation. You can easily get started by downloading the PDF documentation and the sample project from the official site. There are some tools that will help you on your development too. For example, the YAML Builder can visually create YAML-based CSS layouts.

=== BlueTrip ===

BlueTrip is a full featured and beautiful framework that combines advantages from different CSS Framework. The official site has a complete Documentation and Demos.

=== YUI Grid CSS ===

YUI Grids CSS support fluid-width layouts as well as fixed-width layouts. This is the advantage of YUI Grids CSS over the other CSS Frameworks. To get started with YUI Grids CSS, you can download the cheat sheet and YUI Grids Builder from the official site.

=== Elastic CSS Framework ===

Elastic provides a declarative language to define the layout structure and behavior. This is a young framework, and the best site to demo the usage of Elastic is the official site itself. The Elastic CSS Framework has a lot of classes and helpers that will aid in the process of webdesign.

=== SenCSS ===

SenCSS doesn’t include a layout system, but it does provide other things such as baseline, fonts, paddings, margins and more. It comes with a commented version and a minified version which suitable for production use.

=== The Golden Grid ===

The Golden Grid is a web grid system. It ‘s a product of the search for the perfect modern grid system. It ‘s meant to be a CSS tool for grid based web sites.

=== Content With Style ===

This is a fixed width layout and the zip files contains a few layouts such as vertical navigation with 1 content column, vertical navigation with 2 content columns, and etc.

===CSS-boilerplate===

As one of the original authors of Blueprint CSS I’ve decided to re-factor my ideas into a stripped down framework which provides the bare essentials to begin any project. This framework will be lite and strive not to suggest un-semantic naming conventions. You’re the designer and your craft is important.

=== Typogridphy ===

Typogridphy is a CSS framework constructed to allow web designers and front-end developers to quickly code typograhically pleasing grid layouts.

Based on the popular 960 Grid System, Typogridphy allows you to create grid layouts which are versatile and great looking. Typogridphy is made of fully validate, semantic and strict xHTML, and validate CSS.

=== Logicss ===
The Logic CSS framework is a collection of CSS files and a toolset designed to cut development times for web-standards compliant web layouts and templates.

* Common cross-browser rendering behavior approach (not a reset).
* Beautiful font stacks.
* Typography with text resizing capabilities and vertical baseline/rhythm.
* Three totally flexible layout grid templates, customizable with the toolset.
o Elastic layout using EMs.
o Liquid layout with percentages.
o Fixed layout using pixel dimensions.

== Bausteine für die CSS - Navigation ==
ToDo Bilder machen

Tipp ein umschließendes Div mit Klassen wie .nav-v, .nav-h etc. um die Code-Schnipsel leicht einbinden zu können
=== CSS-Navigation: Vertikale Liste ===
Beispiel 1 (basierend auf TYPO3)

<pre>

.nav-v {

float:left;
margin:0 0 0 -50px;
padding:0;
}
.nav-v #nav-sub{

}
.nav-v ul {
/*padding:0 0 10px 0;*/
/*ie8..*/
float: left;
width:180px;
background: url("../media/nav-divider.png");
background-repeat: no-repeat;
background-position: bottom;
/*padding-bottom: 1px;*/
font-size: 12px;
}

.nav-v li.first{

}

.nav-v li {
background: url("../media/nav-divider.png");
background-repeat: no-repeat;
font-weight:normal;
list-style-position:outside;
margin: 0;
padding: 0;
/* ie8 */
width:180px;
float: left;
}

.nav-v li.last {
margin-bottom: 1px;
}

.nav-v li a {
display:block;
height: 23px;
line-height:23px;
text-decoration:none;
}

.nav-v li a,
.nav-v li a{
color: #333;
}

.nav-v li a:hover,
.nav-v li.cur a,
.nav-v li.act a
{
color: #FFF;
background: url("../media/bg-over.png");
background-repeat: no-repeat;
background-position: 0 1px;
}

/* Level 2 */
.nav-v ul ul{
padding: 0;
}
.nav-v li li {
display: inline;
font-size:11px;
/* ie8 */
border-bottom: 0px;

}
.nav-v li li a{
border-top: 1px dotted #e4e5e6;
background:#014674;
height: 24px;
line-height: 24px;
}

.nav-v li.act li a,
.nav-v li.cur li a{
color:#e4e5e6;
}

.nav-v li li a:hover,
.nav-v li li.cur a:visited,
.nav-v li li.cur a:link
{
color: #FFF;
}
.nav-v li li.act a:visited,
.nav-v li li.act a:link{

}

.nav-v li li.act {
}
.nav-v li li.act a:link,
.nav-v li li.act a:visited {
}

</pre>
=== CSS-Navigation: Horizontale Liste ===
Beispiel

===CSS-Navi: Verschachtelte Rollover Liste===
aus: http://css.maxdesign.com.au/
<pre>
HTML
<div id="navcontainer">
<ul id="navlist">
<li id="active"><a href="#" id="current">Item one</a>
<ul id="subnavlist">
<li id="subactive"><a href="#" id="subcurrent">Subitem one</a></li>
<li><a href="#">Subitem two</a></li>
<li><a href="#">Subitem three</a></li>
<li><a href="#">Subitem four</a></li>
</ul>

</li>
<li><a href="#">Item two</a></li>
<li><a href="#">Item three</a></li>
<li><a href="#">Item four</a></li>
</ul>
</div>

CSS
#navcontainer { margin-left: 30px; }

#navcontainer ul
{
margin: 0;
padding: 0;
list-style-type: none;
font-family: verdana, arial, Helvetica, sans-serif;
}

#navcontainer li { margin: 0 0 1px 0; }

#navcontainer a
{
display: block;
padding: 5px 10px;
width: 140px;
color: #fff;
background-color: #036;
text-decoration: none;
}

#navcontainer a:hover
{
color: #fff;
background-color: #69C;
text-decoration: none;
}

#navcontainer ul ul li { margin: 0 0 1px 0; }

#navcontainer ul ul a
{
display: block;
padding: 5px 5px 5px 30px;
width: 125px;
color: #fff;
background-color: #369;
text-decoration: none;
}

#navcontainer ul ul a:hover
{
color: #fff;
background-color: #69C;
text-decoration: none;
}

ABOUT THE CODE
Some lists within the Listamatic site had to be modified so that they could work on Listamatic's simple list model. When in doubt, use the external resource first, or at least compare both models to see which one suits your needs.
</pre>

In Anlehnukng an YAML werden die Dateien möglichst Modular vorgehalten und über ein Zentrales Sylesheet eingebunden

== Konzept-Richtlinien ==
ToDo - evt. verwerfen erhalten bleibt das Konzept BAukastenmäßig das CSS zu verteilen. Evt. so daß man für sich funkionsfähige Skripte macht und diese durch einen Div Wrap später auf den Bereich beschränkt wo sie eingesetzt werden.
=== Struktur ===
/main.css
ToDo

== Zentrales Stylesheet base.css==

Hier werden die verschiedenen benötigten Dateien eingebunden und einige Grundeinstellungen definiert.
In einer späteren Ausbaustufe werden diese evt. ebenfalls ausgelagert
In Typo3 Projekten könnten die CSS-Dateien auch über TypoScript eingebunden werden dann entfällt die base.css
<pre>
/*
### "CSS-Baukasten (c)2006 Stephan Schlegel" ###
### Version: 0.1
### Datei : base.css
### Funktion : Zentrales Stylesheet, Grundeinstellungen + Einbindung der CSS-Module
*/

@import url(main/base.css);
@import url(mods/basemod.css);
@import url(mods/basemod_layout_xcol_xyz.css);
@import url(navi/nav_slidingdoor.css);
@import url(main/content.css);
@import url(print/print_003.css);
</pre>

Processwire - API

2021-08-15T06:42:27Z

134.3.85.26:

== Links ==
https://processwire.com/api/ref/

== Allgemeine Tipps ==
* Wenn kein Zugriff auf das Pages Objekt möglich ist kann man über wire()->pages auf die Funktionen zugreifen.

== ProcessWire API - Page Manipulation ==
[[ProcessWire API - Page Manipulation]]

== ProcessWire API Variable ==
ProcessWire hat einige nützliche Variablen die man ständig benötigt. Außerdem kann man außer über eine Variable auf viele Objekte auch als Funktion zugreifen.
Wichtig sind z.B. folgende Objekte
Page
Pages
Config
Wire
User
=== Zugriff auf Variablen ===
Es gibt unterschiedliche Wege mit unterschiedlichen Vor- und Nachteilen auf API Variablen zuzugreifen.
https://processwire.com/docs/start/variables/

$page the most common access as a variable.
page() accessing as a function can be very convenient, when available.
wire('page') This works anywhere, and with any version of ProcessWire.
$this->page This is how you might access it from within a Wire-derived class.
$this->wire('page') A slightly more efficient way you can access from within a Wire-derived class.
$pages->wire('page') API variables can also access all other API variables, by way of their wire() method. In this example, we are accessing the $page API variable from the $pages API variable. So if you have any one API variable, then you actually have them all.

Accessing API variables as a function rather than a variable can be more convenient when the variable version may be out of scope, or if your IDE highlights API variables as undefined. So whenever we refer to an API variable, make note that access it however you'd like.

This is just an introduction to some of ProcessWire's API variables. Once you are familiar with these, you'll want to use ProcessWire's full API reference instead.

Processwire - API

2021-08-15T06:40:56Z

134.3.85.26:

== Allgemeine Tipps ==
* Wenn kein Zugriff auf das Pages Objekt möglich ist kann man über wire()->pages auf die Funktionen zugreifen.

== ProcessWire API - Page Manipulation ==
[[ProcessWire API - Page Manipulation]]

== ProcessWire API Variable ==
ProcessWire hat einige nützliche Variablen die man ständig benötigt. Außerdem kann man außer über eine Variable auf viele Objekte auch als Funktion zugreifen.
Wichtig sind z.B. folgende Objekte
Page
Pages
Config
Wire
User
=== Zugriff auf Variablen ===
Es gibt unterschiedliche Wege mit unterschiedlichen Vor- und Nachteilen auf API Variablen zuzugreifen.
https://processwire.com/docs/start/variables/

$page the most common access as a variable.
page() accessing as a function can be very convenient, when available.
wire('page') This works anywhere, and with any version of ProcessWire.
$this->page This is how you might access it from within a Wire-derived class.
$this->wire('page') A slightly more efficient way you can access from within a Wire-derived class.
$pages->wire('page') API variables can also access all other API variables, by way of their wire() method. In this example, we are accessing the $page API variable from the $pages API variable. So if you have any one API variable, then you actually have them all.

Accessing API variables as a function rather than a variable can be more convenient when the variable version may be out of scope, or if your IDE highlights API variables as undefined. So whenever we refer to an API variable, make note that access it however you'd like.

This is just an introduction to some of ProcessWire's API variables. Once you are familiar with these, you'll want to use ProcessWire's full API reference instead.

ProcessWire - Field Rendering

2021-07-22T10:15:26Z

134.3.85.26: /* Field Templates */

Siehe auch
[[ProcessWire - Fields]]

== Field Templates ==
https://processwire.com/blog/posts/more-repeaters-repeater-matrix-and-new-field-rendering/
In Processwire kann man (zumindest ab Version 3.x) eine verbesserte render() Funktion nutzen.
Dabei '''sucht ProcessWire automatisch''' in verschiedenen Verzeichnissen nach einem passenden Template File.

Angenommen man möchte ein Textfeld mit dem Namen "body" im Template basic_page.php rendern.
echo $page->render('body'); // looks for /site/templates/fields/body.php to return markup
Dann sucht PW nach dem passenden Subtemplete im fields Verzeichnis.

Ab 3.0.7 sucht Processwire außerdem in
/site/templates/fields/body/basic-page.php
/site/templates/fields/basic-page/body.php
/site/templates/fields/body.php (default/fallback)
bis es eine Definition findet. Außderdem kann man jetzt auch auf einfache Art Varianten erzeugen. https://processwire.com/blog/posts/processwire-3.0.7-expands-field-rendering-page-path-history-and-more/#field-rendering-with-template-files

== Custom Views ==
https://processwire.com/blog/posts/processwire-3.0.7-expands-field-rendering-page-path-history-and-more/#field-rendering-with-template-files

Es gibt viele Möglichkeiten sehr Komplexe Setups mit Varianten aufzusetzen. Der Link oben gibt einen guten Einstieg.

JavaScript - Smooth Scrolling

2021-07-22T06:22:16Z

134.3.85.26:

Es wäre so einfach mit CSS wenn es alle unterstützen würden. Edge, IE und Safari tun es stand 2020 nicht :-(

Die unkomplizierteste Lösung für mich 2020 ist immer noch ein jQuery Snippet

<syntaxhighlight lang="javascript">
$( document ).ready(function() {
//sscroll
//$(document).on('click', '.nav a[href^="#"]', function (event) {
shift = 58
duration = 250
scrollElement = 'a.scroll'
$(document).on('click', scrollElement, function (event) {
event.preventDefault();
$('html, body').animate({
scrollTop: $($.attr(this, 'href')).offset().top - shift
}, duration);
});
});

</syntaxhighlight>

Viele andere Löungen inklusive. Polyfills, haben in Safari nicht funktioniert. Eine Vanilla Lösung
Daher mit JavaScript (siehe auch Snippets für jQuery Lösungen).

https://perishablepress.com/vanilla-javascript-scroll-anchor/

More smooth scroll techniques
Smooth Scroll (Vanilla JS)
Smooth Scrolling (jQuery)
Skinny.js (jQuery)

== cferdinandi smooth-scroll ==
Eines der verbreitetsten und recht schmal ist dieses Vanilla JS
https://github.com/cferdinandi/smooth-scroll

== Only CSS Solution ==
Funktioniert 2021 überall außer IE und Safari (dort nur im experimental mode).

Beispiel
<pre>
.module {
scroll-behavior: [ auto | smooth ];
}
</pre>
More infos at CSS-Tricks and caniuse. Thanks to DKeu for the tip!

JavaScript - Smooth Scrolling

2021-07-22T06:21:44Z

134.3.85.26:

Es wäre so einfach mit CSS wenn es alle unterstützen würden. Edge, IE und Safari tun es stand 2020 nicht :-(

Die unkomplizierteste Lösung für mich 2020 ist immer noch ein jQuery Snippet

<syntaxhighlight lang="javascript">
$( document ).ready(function() {
//sscroll
//$(document).on('click', '.nav a[href^="#"]', function (event) {
shift = 58
duration = 250
scrollElement = 'a.scroll'
$(document).on('click', scrollElement, function (event) {
event.preventDefault();
$('html, body').animate({
scrollTop: $($.attr(this, 'href')).offset().top - shift
}, duration);
});
});

</syntaxhighlight>

Viele andere Löungen inklusive. Polyfills, haben in Safari nicht funktioniert. Eine Vanilla Lösung
Daher mit JavaScript (siehe auch Snippets für jQuery Lösungen).

https://perishablepress.com/vanilla-javascript-scroll-anchor/

More smooth scroll techniques
Smooth Scroll (Vanilla JS)
Smooth Scrolling (jQuery)
Skinny.js (jQuery)

== Only CSS Solution ==
Funktioniert 2021 überall außer IE und Safari (dort nur im experimental mode).

Beispiel
<pre>
.module {
scroll-behavior: [ auto | smooth ];
}
</pre>
More infos at CSS-Tricks and caniuse. Thanks to DKeu for the tip!

== cferdinandi smooth-scroll ==
Eines der verbreitetsten und recht schmal ist dieses Vanilla JS
https://github.com/cferdinandi/smooth-scroll

JavaScript - Smooth Scrolling

2021-07-22T06:20:31Z

134.3.85.26:

Es wäre so einfach mit CSS wenn es alle unterstützen würden. Edge, IE und Safari tun es stand 2020 nicht :-(

Die unkomplizierteste Lösung für mich 2020 ist immer noch ein jQuery Snippet

<syntaxhighlight lang="javascript">
$( document ).ready(function() {
//sscroll
//$(document).on('click', '.nav a[href^="#"]', function (event) {
shift = 58
duration = 250
scrollElement = 'a.scroll'
$(document).on('click', scrollElement, function (event) {
event.preventDefault();
$('html, body').animate({
scrollTop: $($.attr(this, 'href')).offset().top - shift
}, duration);
});
});

</syntaxhighlight>

Viele andere Löungen inklusive. Polyfills, haben in Safari nicht funktioniert. Eine Vanilla Lösung
Daher mit JavaScript (siehe auch Snippets für jQuery Lösungen).

https://perishablepress.com/vanilla-javascript-scroll-anchor/

More smooth scroll techniques
Smooth Scroll (Vanilla JS)
Smooth Scrolling (jQuery)
Skinny.js (jQuery)

CSS solution

Just a heads up for latest Chrome, Firefox, or Opera, you can enable smooth scroll via the scroll-behavior property (no JS required!), for example:
<pre>
.module {
scroll-behavior: [ auto | smooth ];
}
</pre>
More infos at CSS-Tricks and caniuse. Thanks to DKeu for the tip!

== cferdinandi smooth-scroll ==
Eines der verbreitetsten und recht schmal ist dieses Vanilla JS
https://github.com/cferdinandi/smooth-scroll

JavaScript - Smooth Scrolling

2021-07-22T06:19:34Z

134.3.85.26:

Es wäre so einfach mit CSS wenn es alle unterstützen würden. Edge, IE und Safari tun es stand 2020 nicht :-(

Die unkomplizierteste Lösung für mich 2020 ist immer noch ein jQuery Snippet
<syntaxhighlight lang="javascript">
$( document ).ready(function() {
//sscroll
//$(document).on('click', '.nav a[href^="#"]', function (event) {
shift = 58
duration = 250
scrollElement = 'a.scroll'
$(document).on('click', scrollElement, function (event) {
event.preventDefault();
$('html, body').animate({
scrollTop: $($.attr(this, 'href')).offset().top - shift
}, duration);
});
});

</syntaxhighlight>
Viele andere Löungen inklusive. Polyfills, haben in Safari nicht funktioniert. Eine Vanilla Lösung
Daher mit JavaScript (siehe auch Snippets für jQuery Lösungen).

https://perishablepress.com/vanilla-javascript-scroll-anchor/

More smooth scroll techniques
Smooth Scroll (Vanilla JS)
Smooth Scrolling (jQuery)
Skinny.js (jQuery)
CSS solution
Just a heads up for latest Chrome, Firefox, or Opera, you can enable smooth scroll via the scroll-behavior property (no JS required!), for example:

.module {
scroll-behavior: [ auto | smooth ];
}
More infos at CSS-Tricks and caniuse. Thanks to DKeu for the tip!

== cferdinandi smooth-scroll ==
Eines der verbreitetsten und recht schmal ist dieses Vanilla JS
https://github.com/cferdinandi/smooth-scroll

ProcessWire - Page Reference (Field)

2021-07-16T09:30:20Z

134.3.85.26: /* Überprüfe Seitenreferenz */

Page Reference Felder enthalten Verbindungen zu anderen Seiten.
== API Zugriff auf Page Reference ==
=== Einfache Beispiele ===
<pre>
// examples
$someOtherPage = $pages->get(1234);
$page->your_page_field = $someOtherPage;// @note: not sure it works in all contexts
$page->your_page_field->add($someOtherPage);
$page->your_page_field->add(1234);

// Manipulate page reference this way...
$p = $pages->get(1234);
$p->of(false); // always switch of output formatting when manipulating and save back values
$p->page_reference_field->add(1111); // add another page by id
$p->save();
</pre>

=== Finde Seiten die auf Diese zeigen ===
https://processwire.com/api/ref/page/references/
Available since version 3.0.107.

// basic usage
$items = $page->references();

// usage with all arguments
$items = $page->references($selector = '', $field = '');

=== Komplexe Referenzierung ===
https://processwire.com/talk/topic/1224-selector-and-page-reference-field/
Finde Seiten mit dem Template '''poi''' die ein Seitenreferenz auf eine Seite mit dem Titel '''Zoo''' haben. Das PR Feld hat den Namen poi_type
<syntaxhighlight lang="php">
$pr = $pages->get("title=Zoo"); // $pr enthält das Pageobjekt
$poi = $pages->find("template=poi, poi_type=$pr"); // Pageobjekt als Parameter für den Selektor
</syntaxhighlight>

Es kann auch ein PageArray Objekt zum Suchen genutzt werden.
<syntaxhighlight lang="php">
$prs = $pages->find("title=Zoo|Theme park|Museum"); // maybe also use the name or id
$poi = $pages->find("template=poi, poi_type=$prs");
</syntaxhighlight>

==== PageReference in Repeater ====
template client enthält einen Repeater r_assignment und dieser die Seitenreferenzen pr_contact und pr_function

pr_contact enthält PageReferences auf Seiten mit dem Template contact.

Ich möchte in einer Seite mit dem Template '''contact''' alle Seiten des Templates '''client''' finden, die im Repeater Feld r_assignment ein Pagereference pr_contact haben dass auf meine Seite (also $page) zeigt
<syntaxhighlight lang="php">
$clients = pages()->find("template=key_account_client,r_contact_function_assignment.pr_contact=$page,sort=title");
</syntaxhighlight>

=== Erstelle Seitenreferenzen ===

$myPage->pReferences = $page; // creates one reference
$myPage->save(); // make sure to save page somewhere

This of course doesn't work with multiple pages. I tried this (found from current docs, used in images):

$myPage->pReferences->add($page); // adds a page reference, allows more than one add (if field allows this).
$myPage->save();
=== Entferne Seitenreferenzen ===
https://processwire.com/talk/topic/1936-remove-entry-from-pagesfield-via-api/
<syntaxhighlight lang="php">
$page->[field-name]->remove($[page-you-want-to-remove]);
$page->save();

//For example, if you wanted to remove the first page:

$p = $page->related_pages->first();
$page->related_pages->remove($p);
$page->save();
</syntaxhighlight>

=== Überprüfe Seitenreferenz ===
Assuming you're trying to remove a page from a page field if it is there already and otherwise add it there:
<syntaxhighlight lang="php">
if($user->abos->has($p)) {
$user->abos->remove($p);
} else {
$user->abos->add($p);
}
</syntaxhighlight>

== Umgekehrter Zugriff auf Page Reference ==
Manchmal möchte man von der "anderen Seite" also von der referenzierten Seite auf Seiten zugreifen, die auf diese Seite zeigen. Entweder man möchte über die Api effektiv drauf zugreifen, oder man möchte im Backend bessere Bearbeitungsmöglichkeiten.

=== Hilfsmodule ===
Ich editiere eine Seite und möchte eine Referenz auf diese Seite bearbeiten oder einfügen. Ich möchte die Seite aber nicht verlassen müssen sondern alles in einem Rutsch erledigen.
http://modules.processwire.com/modules/admin-page-field-edit-links/
Ermöglicht das Bearbeiten von Seitenreferenzen in einem Inline Frame.

http://modules.processwire.com/modules/connect-page-fields/
Ermöglicht das Synchronisieren von zwei Seiten die sich gegenseitig referenzieren. In mySQL würde man hier lieber eine m:n Verbindung nehmen anstatt zwei Felder zu nutzen, da man hier zwei Datensätze pflegt (redundant und Gefahr das es mal asynchron ist). Vorteil ist aber, dass man über die API Performancevorteile hat, weil man niemals eine Suche nach "was zeigt hierher" machen muss.

== Selektoren die helfen ==
Selektoren die einem helfen Seiten die eine Referenz auf die aktuelle Seite zu finden.
page()->references()
und der
owner
Selektor

ProcessWire - Page Reference (Field)

2021-07-16T09:29:57Z

134.3.85.26: /* Entferne Seitenreferenzen */

Page Reference Felder enthalten Verbindungen zu anderen Seiten.
== API Zugriff auf Page Reference ==
=== Einfache Beispiele ===
<pre>
// examples
$someOtherPage = $pages->get(1234);
$page->your_page_field = $someOtherPage;// @note: not sure it works in all contexts
$page->your_page_field->add($someOtherPage);
$page->your_page_field->add(1234);

// Manipulate page reference this way...
$p = $pages->get(1234);
$p->of(false); // always switch of output formatting when manipulating and save back values
$p->page_reference_field->add(1111); // add another page by id
$p->save();
</pre>

=== Finde Seiten die auf Diese zeigen ===
https://processwire.com/api/ref/page/references/
Available since version 3.0.107.

// basic usage
$items = $page->references();

// usage with all arguments
$items = $page->references($selector = '', $field = '');

=== Komplexe Referenzierung ===
https://processwire.com/talk/topic/1224-selector-and-page-reference-field/
Finde Seiten mit dem Template '''poi''' die ein Seitenreferenz auf eine Seite mit dem Titel '''Zoo''' haben. Das PR Feld hat den Namen poi_type
<syntaxhighlight lang="php">
$pr = $pages->get("title=Zoo"); // $pr enthält das Pageobjekt
$poi = $pages->find("template=poi, poi_type=$pr"); // Pageobjekt als Parameter für den Selektor
</syntaxhighlight>

Es kann auch ein PageArray Objekt zum Suchen genutzt werden.
<syntaxhighlight lang="php">
$prs = $pages->find("title=Zoo|Theme park|Museum"); // maybe also use the name or id
$poi = $pages->find("template=poi, poi_type=$prs");
</syntaxhighlight>

==== PageReference in Repeater ====
template client enthält einen Repeater r_assignment und dieser die Seitenreferenzen pr_contact und pr_function

pr_contact enthält PageReferences auf Seiten mit dem Template contact.

Ich möchte in einer Seite mit dem Template '''contact''' alle Seiten des Templates '''client''' finden, die im Repeater Feld r_assignment ein Pagereference pr_contact haben dass auf meine Seite (also $page) zeigt
<syntaxhighlight lang="php">
$clients = pages()->find("template=key_account_client,r_contact_function_assignment.pr_contact=$page,sort=title");
</syntaxhighlight>

=== Erstelle Seitenreferenzen ===

$myPage->pReferences = $page; // creates one reference
$myPage->save(); // make sure to save page somewhere

This of course doesn't work with multiple pages. I tried this (found from current docs, used in images):

$myPage->pReferences->add($page); // adds a page reference, allows more than one add (if field allows this).
$myPage->save();
=== Entferne Seitenreferenzen ===
https://processwire.com/talk/topic/1936-remove-entry-from-pagesfield-via-api/
<syntaxhighlight lang="php">
$page->[field-name]->remove($[page-you-want-to-remove]);
$page->save();

//For example, if you wanted to remove the first page:

$p = $page->related_pages->first();
$page->related_pages->remove($p);
$page->save();
</syntaxhighlight>

== Überprüfe Seitenreferenz ==
Assuming you're trying to remove a page from a page field if it is there already and otherwise add it there:
<syntaxhighlight lang="php">
if($user->abos->has($p)) {
$user->abos->remove($p);
} else {
$user->abos->add($p);
}
</syntaxhighlight>

== Umgekehrter Zugriff auf Page Reference ==
Manchmal möchte man von der "anderen Seite" also von der referenzierten Seite auf Seiten zugreifen, die auf diese Seite zeigen. Entweder man möchte über die Api effektiv drauf zugreifen, oder man möchte im Backend bessere Bearbeitungsmöglichkeiten.

=== Hilfsmodule ===
Ich editiere eine Seite und möchte eine Referenz auf diese Seite bearbeiten oder einfügen. Ich möchte die Seite aber nicht verlassen müssen sondern alles in einem Rutsch erledigen.
http://modules.processwire.com/modules/admin-page-field-edit-links/
Ermöglicht das Bearbeiten von Seitenreferenzen in einem Inline Frame.

http://modules.processwire.com/modules/connect-page-fields/
Ermöglicht das Synchronisieren von zwei Seiten die sich gegenseitig referenzieren. In mySQL würde man hier lieber eine m:n Verbindung nehmen anstatt zwei Felder zu nutzen, da man hier zwei Datensätze pflegt (redundant und Gefahr das es mal asynchron ist). Vorteil ist aber, dass man über die API Performancevorteile hat, weil man niemals eine Suche nach "was zeigt hierher" machen muss.

== Selektoren die helfen ==
Selektoren die einem helfen Seiten die eine Referenz auf die aktuelle Seite zu finden.
page()->references()
und der
owner
Selektor

ProcessWire - Page Reference (Field)

2021-07-16T08:59:38Z

134.3.85.26: /* Erstelle Seitenreferenzen */

Page Reference Felder enthalten Verbindungen zu anderen Seiten.
== API Zugriff auf Page Reference ==
=== Einfache Beispiele ===
<pre>
// examples
$someOtherPage = $pages->get(1234);
$page->your_page_field = $someOtherPage;// @note: not sure it works in all contexts
$page->your_page_field->add($someOtherPage);
$page->your_page_field->add(1234);

// Manipulate page reference this way...
$p = $pages->get(1234);
$p->of(false); // always switch of output formatting when manipulating and save back values
$p->page_reference_field->add(1111); // add another page by id
$p->save();
</pre>

=== Finde Seiten die auf Diese zeigen ===
https://processwire.com/api/ref/page/references/
Available since version 3.0.107.

// basic usage
$items = $page->references();

// usage with all arguments
$items = $page->references($selector = '', $field = '');

=== Komplexe Referenzierung ===
https://processwire.com/talk/topic/1224-selector-and-page-reference-field/
Finde Seiten mit dem Template '''poi''' die ein Seitenreferenz auf eine Seite mit dem Titel '''Zoo''' haben. Das PR Feld hat den Namen poi_type
<syntaxhighlight lang="php">
$pr = $pages->get("title=Zoo"); // $pr enthält das Pageobjekt
$poi = $pages->find("template=poi, poi_type=$pr"); // Pageobjekt als Parameter für den Selektor
</syntaxhighlight>

Es kann auch ein PageArray Objekt zum Suchen genutzt werden.
<syntaxhighlight lang="php">
$prs = $pages->find("title=Zoo|Theme park|Museum"); // maybe also use the name or id
$poi = $pages->find("template=poi, poi_type=$prs");
</syntaxhighlight>

==== PageReference in Repeater ====
template client enthält einen Repeater r_assignment und dieser die Seitenreferenzen pr_contact und pr_function

pr_contact enthält PageReferences auf Seiten mit dem Template contact.

Ich möchte in einer Seite mit dem Template '''contact''' alle Seiten des Templates '''client''' finden, die im Repeater Feld r_assignment ein Pagereference pr_contact haben dass auf meine Seite (also $page) zeigt
<syntaxhighlight lang="php">
$clients = pages()->find("template=key_account_client,r_contact_function_assignment.pr_contact=$page,sort=title");
</syntaxhighlight>

=== Erstelle Seitenreferenzen ===

$myPage->pReferences = $page; // creates one reference
$myPage->save(); // make sure to save page somewhere

This of course doesn't work with multiple pages. I tried this (found from current docs, used in images):

$myPage->pReferences->add($page); // adds a page reference, allows more than one add (if field allows this).
$myPage->save();
=== Entferne Seitenreferenzen ===
https://processwire.com/talk/topic/1936-remove-entry-from-pagesfield-via-api/
<syntaxhighlight lang="php">
$page->[field-name]->remove($[page-you-want-to-remove]);
$page->save();

//For example, if you wanted to remove the first page:

$p = $page->related_pages->first();
$page->related_pages->remove($p);
$page->save();
</syntaxhighlight>

== Umgekehrter Zugriff auf Page Reference ==
Manchmal möchte man von der "anderen Seite" also von der referenzierten Seite auf Seiten zugreifen, die auf diese Seite zeigen. Entweder man möchte über die Api effektiv drauf zugreifen, oder man möchte im Backend bessere Bearbeitungsmöglichkeiten.

=== Hilfsmodule ===
Ich editiere eine Seite und möchte eine Referenz auf diese Seite bearbeiten oder einfügen. Ich möchte die Seite aber nicht verlassen müssen sondern alles in einem Rutsch erledigen.
http://modules.processwire.com/modules/admin-page-field-edit-links/
Ermöglicht das Bearbeiten von Seitenreferenzen in einem Inline Frame.

http://modules.processwire.com/modules/connect-page-fields/
Ermöglicht das Synchronisieren von zwei Seiten die sich gegenseitig referenzieren. In mySQL würde man hier lieber eine m:n Verbindung nehmen anstatt zwei Felder zu nutzen, da man hier zwei Datensätze pflegt (redundant und Gefahr das es mal asynchron ist). Vorteil ist aber, dass man über die API Performancevorteile hat, weil man niemals eine Suche nach "was zeigt hierher" machen muss.

== Selektoren die helfen ==
Selektoren die einem helfen Seiten die eine Referenz auf die aktuelle Seite zu finden.
page()->references()
und der
owner
Selektor

ProcessWire - Page Reference (Field)

2021-07-16T08:54:54Z

134.3.85.26: /* Reverse Page Reference */

Page Reference Felder enthalten Verbindungen zu anderen Seiten.
== API Zugriff auf Page Reference ==
=== Einfache Beispiele ===
<pre>
// examples
$someOtherPage = $pages->get(1234);
$page->your_page_field = $someOtherPage;// @note: not sure it works in all contexts
$page->your_page_field->add($someOtherPage);
$page->your_page_field->add(1234);

// Manipulate page reference this way...
$p = $pages->get(1234);
$p->of(false); // always switch of output formatting when manipulating and save back values
$p->page_reference_field->add(1111); // add another page by id
$p->save();
</pre>

=== Finde Seiten die auf Diese zeigen ===
https://processwire.com/api/ref/page/references/
Available since version 3.0.107.

// basic usage
$items = $page->references();

// usage with all arguments
$items = $page->references($selector = '', $field = '');

=== Komplexe Referenzierung ===
https://processwire.com/talk/topic/1224-selector-and-page-reference-field/
Finde Seiten mit dem Template '''poi''' die ein Seitenreferenz auf eine Seite mit dem Titel '''Zoo''' haben. Das PR Feld hat den Namen poi_type
<syntaxhighlight lang="php">
$pr = $pages->get("title=Zoo"); // $pr enthält das Pageobjekt
$poi = $pages->find("template=poi, poi_type=$pr"); // Pageobjekt als Parameter für den Selektor
</syntaxhighlight>

Es kann auch ein PageArray Objekt zum Suchen genutzt werden.
<syntaxhighlight lang="php">
$prs = $pages->find("title=Zoo|Theme park|Museum"); // maybe also use the name or id
$poi = $pages->find("template=poi, poi_type=$prs");
</syntaxhighlight>

==== PageReference in Repeater ====
template client enthält einen Repeater r_assignment und dieser die Seitenreferenzen pr_contact und pr_function

pr_contact enthält PageReferences auf Seiten mit dem Template contact.

Ich möchte in einer Seite mit dem Template '''contact''' alle Seiten des Templates '''client''' finden, die im Repeater Feld r_assignment ein Pagereference pr_contact haben dass auf meine Seite (also $page) zeigt
<syntaxhighlight lang="php">
$clients = pages()->find("template=key_account_client,r_contact_function_assignment.pr_contact=$page,sort=title");
</syntaxhighlight>

=== Erstelle Seitenreferenzen ===

$myPage->pReferences = $page; // creates one reference
$myPage->save(); // make sure to save page somewhere

This of course doesn't work with multiple pages. I tried this (found from current docs, used in images):

$myPage->pReferences->add($page); // adds a page reference, allows more than one add (if field allows this).
$myPage->save();

== Umgekehrter Zugriff auf Page Reference ==
Manchmal möchte man von der "anderen Seite" also von der referenzierten Seite auf Seiten zugreifen, die auf diese Seite zeigen. Entweder man möchte über die Api effektiv drauf zugreifen, oder man möchte im Backend bessere Bearbeitungsmöglichkeiten.

=== Hilfsmodule ===
Ich editiere eine Seite und möchte eine Referenz auf diese Seite bearbeiten oder einfügen. Ich möchte die Seite aber nicht verlassen müssen sondern alles in einem Rutsch erledigen.
http://modules.processwire.com/modules/admin-page-field-edit-links/
Ermöglicht das Bearbeiten von Seitenreferenzen in einem Inline Frame.

http://modules.processwire.com/modules/connect-page-fields/
Ermöglicht das Synchronisieren von zwei Seiten die sich gegenseitig referenzieren. In mySQL würde man hier lieber eine m:n Verbindung nehmen anstatt zwei Felder zu nutzen, da man hier zwei Datensätze pflegt (redundant und Gefahr das es mal asynchron ist). Vorteil ist aber, dass man über die API Performancevorteile hat, weil man niemals eine Suche nach "was zeigt hierher" machen muss.

== Selektoren die helfen ==
Selektoren die einem helfen Seiten die eine Referenz auf die aktuelle Seite zu finden.
page()->references()
und der
owner
Selektor