UBB-Code

Alles, was PHP betrifft, kann hier besprochen werden.

UBB-Code

Postby Knight1 » 12. September 2004 13:40

Hi Leute,
ich bin zur Zeit an einem Clan-Portal dran welches ich selbst geschrieben habe umzubauen.
Dabei möchte ich gerne den UBB-Code einbauen. Nur habe ich keine Ahnung wie ich das anstellen soll.
Ich weis zwar in etwas dass es mit der preg_replace()-Funktion geht.
Da ich aber keine Ahnung habe wie das mit der Funktion geht.

Könntet Ihr mir das bitt erklären? Am besten auch mit Beispiel.


Danke schon im vorraus.


Kai aka Knight1
Image
User avatar
Knight1
 
Posts: 310
Joined: 18. October 2003 10:03
Location: Trier
Operating System: Windows 7 Ultimate x64

Postby docker » 12. September 2004 15:47

Du möchtest also Pattern :D

PHP bietet mehrere Funktionen, in denen reguläre Ausdrücke zum Einsatz kommen können. Hier wird nur die preg-Funktionen besprochen, da sie schneller als ereg-Funktionen sind und die Patterns genauso in Perl und den meisten anderen Anwendungen, die reguläre Ausdrücke unterstützen, benutzt werden können. Diese Funktionen sind ab PHP 3.0.9 verfügbar. Die zwei wichtigsten preg-Funktionen sind:
preg_match()

Syntax:

int preg_match (string pattern, string subject [, array matches])

Verwendungsweise:

"pattern" enthält das Pattern, "subject" enthält die Zeichenkette, auf die das Pattern angewendet werden soll. Der Rückgabewert dieser Funktion ist 1, wenn das Pattern gefunden wurde, ansonsten 0. Ist der letztes Parameter "matches" (ein Array) angegeben, so wird dieser mit Backreferences gefüllt - mehr dazu im Abschnitt "Backreferences".
preg_replace()

Syntax:

mixed preg_replace (mixed pattern, mixed replacement, mixed subject [, int limit])

Verwendungsweise:

"pattern" enthält das Pattern, "replacement" enthält die Zeichenkette, durch die das Pattern ersetzt werden soll. "subject" ist die Zeichenkette, in der nach "pattern" gesucht und ggf. "replacement" dafür eingesetzt wird. Der Rückgabewert der Funktion ist die neue Zeichenkette. "limit" ist optional und kann angegeben werden, um die Anzahl der Ersetzungen zu begrenzen.
Modifier
i

Dies ist der wohl am meisten gebrauchte Modifier. Bei regulären Ausdrücken wird standardmäßig zwischen Groß- und Kleinschreibung unterschieden - dieser Modifier schaltet dies aus.
s

Der s-Modifier veranlasst den Parser dazu, die Zeichenkette, auf die der reguläre Ausdruck angewendet wird, in einzelne Zeilen zu unterteilen - das Pattern wird hierbei also nicht auf die ganze Zeichenkette bezogen, sondern jede Zeile einzeln behandelt
m

Der m-Modifier ist das Komplement zum s-Modifier: Die Zeichenkette wird nicht in Zeilen aufgetrennt, sondern im Ganzen behandelt.

Die Modifier können beliebig kombiniert werden, s und m zusammen machen allerdings wenig Sinn.
Metacharaktere

Metacharaktere stehen für einen bestimmten Teil der Zeichenkette. Die folgende Aufstellung zeigt deren Bedeutungen.
.

Der Punkt steht für jedes beliebige Zeichen, außer einem Zeilenumbruch, wenn der m-Modifier nicht explizit angegeben wurde.
Beispiel: /./

Dieser Ausdruck trifft auf jede Zeichenkette zu, die genau ein beliebiges Zeichen an irgendeiner Stelle enthält -

sie trifft also auf alle Zeichenketten zu, die nicht leer sind.
^

Der Zirkumflex steht für den Anfang der Zeichenkette.

Beispiel: /^a/i

Trifft auf alle Zeichenketten zu, die mit einem kleinen oder großen "a" beginnen.
$

Das Dollarzeichen ist das Gegenteil zum Zirkumflex, es steht für das Ende der Zeichenkette.

Beispiel 1: /a$/

Trifft auf alle Zeichenketten zu, die ein kleines "a" am Ende einer Zeile haben.

Beispiel 2: /a$/m

Trifft auf alle Zeichenketten zu, die an ihrem Ende ein kleines "a" haben.
|

Dieses Zeichen wird verwendet, um Alternativen anzugeben (oder).

Beispiel: /^a|b$/

Trifft auf alle Zeichenketten zu, die aus genau einem kleinen "a" oder genau einem kleinen "b" bestehen.
( )

Die runden Klammern können benutzt werden, um Teile des Patterns zusammenzufassen und von anderen abzugrenzen.

Beispiel 1: /^a(b|z$)/

Trifft auf die Zeichenketten "ab" und "az" zu.

Beispiel 2: /^(a|b)(c|d)$/

Trifft auf die Zeichenketten "ac", "ad", "bc" und "bd" zu.

Beispiel 3:/^(a(b|c)|def)$/

Klammern können beliebig geschachtelt werden, dieser Ausdruck trifft daher auf die Zeichenketten

"ab", "ac" oder "def" zu.
[ ]

Die eckigen Klammern dienen zur Angabe von Zeichenklassen, mehr dazu im entsprechenden Abschnitt.
{ }

Die geschweiften Klammern dienen zur numerischen Angabe von Zeichenanzahlen, wir werden sie im folgenden Abschnitt "Quantifier" besprechen.

Soll ein Zeichen nicht als Metacharakter (hierzu zählt auch der gewählte Delimiter), sondern als normales Zeichen aufgefasst werden, so ist diesem Zeichen ein umgekehrter Schrägstrich (Backslash) voranzustellen:

Beispiel: /\(abc\)/

Dieser Ausdruck trifft auf jede Zeichenkette zu, die "(abc)" enthält.
Quantifier

Mit Quantifiern ist es möglich, eine minimale, maximale oder exakte Anzahl für ein oder mehrere Zeichen festzulegen. Wir kein Quantifier angegeben, so wird angenommen, dass das Zeichen genau einmal vorkommen muss.

Standard-Quantifier sind:
*

Der Stern steht für Anzahlen von 0 oder mehr.

Beispiel: /.*/

Trifft auf jede beliebige Zeichenkette (auch eine leere) zu.
+

Das Pluszeichen steht für Anzahlen von 1 oder mehr.

Beispiel: /a+/

Steht für eine Zeichenkette mit mindestens einem "a".
?

Das Fragezeichen steht für Anzahlen von 0 oder exakt 1.

Beispiel:/^(abc)?$/

Steht für "abc" oder eine leere Zeichenkette, nicht aber für "abcabc".
{n}

Steht für eine Anzahl von genau n Zeichen.

Beispiel: /a{6}/

Steht für exakt sechs "a".
{n,}

Steht für eine Anzahl von mindestens n Zeichen

Beispiel: /a{1,}/

Steht für mindestens ein "a" und ist somit äquivalent zu den Ausdrücken /a/ und /a+/.
{n,m}

Steht für eine Anzahl von mindestens n, aber höchstens m Zeichen.

Beispiel: /a{2,4}/

Trifft auf alle Zeichenketten zu, die 2, 3 oder 4 "a" hintereinander haben.

Standardmäßig versuchen die Quantifier, auf einen so großen Text wie möglich zu passen. Dies kann zu Problemen führen: Angenommen es liegt eine Zeichenkette $str = "texttexttext" vor, und wir möchten daraus "<b>text</b>text<b>text</b>" machen. Versuchen wir es folgendermaßen:

$str = preg_replace("!\[b\](.*)\[/b\]!","<b>text</b>",$str);

so erhalten wir als Ergebnis "<b>text[/b]text[b]text</b>" - nicht ganz das, was wir wollten. Um dieses Verhalten abzustellen, setzen wir hinter den Quantifier ein Fragezeichen "?":

$str = preg_replace("!\[b\](.*?)\[/b\]!","<b>text</b>",$str);

und das gewünschte Ergebnis ist erreicht! Jeder der oben beschriebenen Quantifier kann durch ein angehängtes "?" zu diesem Verhalten bewegt werden, so z.B. {1,4}? oder +?.
Charakterklassen

Eine Auswahl von erlaubten Zeichen kann in eckigen Klammern angegeben werden:

/^a[bc]$/ trifft beispielsweise auf "ab" oder "ac" zu.

In einer Charakterklasse haben zwei Zeichen eine Sonderbedeutung: Ein vorangestelltes "^" bedeutet in diesem Kontext eine Negierung der angegebenen Zeichen - man kann auch sagen, dass dann nur die komplementären Zeichen gelten.

/^a[^bc]$/ trifft also auf alles außer "ab" und "ac"zu.

Das zweite Zeichen mit Sonderbedeutung ist der Bindestrich "-". Zwischen zwei Zeichen eingesetzt, gibt er eine Reichweite an. Beispiele hierzu:

/^[a-zA-Z]+$/ trifft also auf alle Zeichenketten mit Groß- und Kleinbuchstaben, aber ohne Zahlen zu.

/^[a-Z]+$/ bewirkt das gleiche, ist jedoch aufgrund der unterschiedlichen Zeichendisponierung bei verschiedenen Systemen unsicher.
Backreferences

Backreferences sind Rückbezüge, sie beziehen sich also auf einen vorangegangenen Teil des Patterns (in runden Klammern) und enthalten deren Inhalt. Es gibt zwei Syntaxes, die neuere davon ist $n, wobei n für die n-te Klammerngruppe steht.

Beispiel:

!(<b>|<i>)(.*?)(</$1>)! trifft auf "<b>text</b>" und "<i>text</i>" zu, aber nicht auf "<b>text</i>".

Am nützlichsten sind Backreferences jedoch bei Ersetzungsoperationen mit preg_replace():

$str = preg_replace("!-anfang-(.*?)-ende-!","<anfang>$1<ende>",$str);

Dieses Konstrukt würde also z.B. die Zeichenkette "-anfang-text hier-ende-" durch "<anfang>text hier<ende>" ersetzen.
Erweiterte Patterns

Erweiterte Patterns bestehen aus runden Klammern, einem Fragezeichen am Anfang, einem dem Fragezeichen folgenden Operator ound dem Pattern xxxan sich: (?oxxx)

Die nützlichsten hierbei sind:
(?:xxx)

Verhält sich wie eine normale Klammerngruppe, erzeugt jedoch keine Backreference.

Beispiel: /(?:ab)(cd)/

$1enhält nun die Zeichenkette "cd".
(?!xxx)

Negiert das angegebene Pattern und wirkt sich auf das vorangehende aus.

Beispiel: /text1(?!text2)/

Trifft auf eine Zeichenkette zu, die "text1" enthält, aber kein "text2" danach.
(?<!xxx)

Negiert das angegebene Pattern und wirkt sich auf das nachfolgende aus.

Beispiel:/(?<!text1)text2/

Trifft auf eine Zeichenkette zu, die "text2" enthält, aber nur, wenn "text1" nicht davor kommt.
Anwendungsbeispiele
Postleitzahlencheck (Deutschland)

Ein sehr einfaches Beispiel. Eine deutsche Postleitzahl besteht immer aus genau 5 Ziffern:

/^[0-9]{5}$/
eMail-Adressencheck

Hierzu lassen sich recht komplexe Ansätze entwerfen. Eine eMail-Adresse darf nur aus Buchstaben, Ziffern, Bindestrichen, Unterstrichen, Punkten und einem "@" als Trenner bestehen. Die Toplevel-Domains sind ebenfalls festgelegt.

Fangen wir also mit einem "@" als Trenner und den erlaubten Zeichen davor und danach an:

/[\.a-z0-9_-]+@[\.a-z0-9-]+/i

[Bemerkungen:

1) Die Kleinbuchstaben reichen aus, da wir ja den i-Modifier angegeben haben

2) Der Bindestrich muss hier auch nicht extra maskiert werden, da er am Ende der Charakterklasse steht.]

Nach dem "@"dürfen allerdings keine Punkte oder Unterstriche sein - genausowenig wie ein Punkt direkt am Anfang der Adresse - also verbieten wir sie dort und bauen noch die Domains ein:

/[a-z0-9_-]+(\.[a-z0-9_-]+)*@([0-9a-z][0-9a-z-]*[0-9a-z]\.)+([a-z]{2,4}|museum)/i
Zeilenumbrüche konvertieren

Linux/Unix, der MacIntosh und Windows haben verschiedene Zeilenumbrüche:
Linux/Unix: \noder \012 in Oktalschreibweise
MacIntosh: \r oder \015 in Oktalschreibweise
Windows: \r\n oder \015\012 in Oktalschreibweise

Es ist wünschenswert, diese zu vereinheitlichen - die Funktion nl2br() von PHP wandelt z.B. nur \n in HTML-Zeilenumbrüche (<br>) um. Dies erreichen wir mit folgendem Konstrukt:

$str = preg_replace("!(\r\n)|(\r)!","\n",$str);

Dies war nun ein kleiner Ausschnitt aus den Anwendungsmöglichkeiten von regulären Ausdrücken.
Wer weiss schon, wieviel er wissen muss, um zu wissen, dass er noch zu wenig weiss.
User avatar
docker
 
Posts: 11
Joined: 25. January 2003 17:58
Location: Deutschland

Postby Corvin Gröning » 13. September 2004 05:31

Hi,

am besten erstmal das von docker lesen.

Und dann noch mal ein Beispiel (anhand des [ url ]-Tags):
Code: Select all
$str = preg_replace("/\[url=(.*)](.*)\[\/url\]/siU","<a href=\"\\1\" target='_blank'>\\2</a>",$str);
Corvin Gröning
 

Postby Knight1 » 24. December 2004 13:55

Hi Leute,
ich habe es mittlerweile hinbekommen das Pattern in das Portal einzubauen.
Allerdings habe ich noch das Problem eingegebene URL's ohne den URL-Tag ([url]) automatisch umzuwandeln.

Könntet Ihr mir da einen Tipp geben wie ich das hin bekommen könnte?

Danke schon im vorraus.


Kai aka Knight1
Image
User avatar
Knight1
 
Posts: 310
Joined: 18. October 2003 10:03
Location: Trier
Operating System: Windows 7 Ultimate x64


Return to PHP

Who is online

Users browsing this forum: No registered users and 1 guest