Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
PHP: Text Spinner Class - Nested spinning supported.
<?PHP
/**
* Spintax - A helper class to process Spintax strings.
*
* @author Jason Davis - https://www.codedevelopr.com/
*
* Tutorial: https://www.codedevelopr.com/articles/php-spintax-class/
*
* Updated with suggested performance improvement by @PhiSYS.
*/
class Spintax
{
public function process($text)
{
return preg_replace_callback(
'/\{(((?>[^\{\}]+)|(?R))*?)\}/x',
array($this, 'replace'),
$text
);
}
public function replace($text)
{
$text = $this->process($text[1]);
$parts = explode('|', $text);
return $parts[array_rand($parts)];
}
}
/* EXAMPLE USAGE */
$spintax = new Spintax();
$string = '{Hello|Howdy|Hola} to you, {Mr.|Mrs.|Ms.} {Smith|Williams|Davis}!';
echo $spintax->process($string);
/* NESTED SPINNING EXAMPLE */
echo $spintax->process('{Hello|Howdy|Hola} to you, {Mr.|Mrs.|Ms.} {{Jason|Malina|Sara}|Williams|Davis}');
@ranggacyber
Copy link

ranggacyber commented Sep 18, 2014

it's pretty cool .. many thanks

@salvatorecapolupo
Copy link

salvatorecapolupo commented Jan 1, 2015

Interesting, thank you

@NealWalters
Copy link

NealWalters commented Jan 28, 2015

Nice short code! Can you help explain the regex pattern: /{(((?>[^{}]+)|(?R))*)}/x
I'm trying to rewrite in Powershell/.NET. Especially, what is the ?R

@lury
Copy link

lury commented Mar 7, 2015

@NealWalters here you go:

/
  \{                    # opening curly ({) bracket
  (                     # group $1
    (                   # group $2
      (?>               # group $3
                        # Atomic group - Matches the longest possible substring in the group and doesn't allow later backtracking to reevaluate the group.
        [^\{\}]+        # one or more characters which are not "{" or "}"
      )
      |                 # or
      (?R)              # recursive match on the pattern itself - next nesting level of {}
    )*                  # zero or more times
  )
  \}                    # ended with curly (}) bracket
/x                      # PCRE_EXTENDED - whitespaces are ignored, # means comments

@soulfreeza
Copy link

soulfreeza commented Apr 1, 2015

thank you, anyway is it possible for making this spin work if only for first opening file and not working after it has been refresh ?

@erm3nda
Copy link

erm3nda commented Jul 5, 2015

Perfectly working. Thank you so much for the explanation about the regexp.
Regexp are really cool, but not so easy to understand/explain, also has a really HUGE syntax :)

@fer-ri
Copy link

fer-ri commented Sep 19, 2015

Simple but powerful :)

Thanks

@cantrikndelik
Copy link

cantrikndelik commented Oct 21, 2015

[ask] it is possible to spin the title also ?

@andrija-naglic
Copy link

andrija-naglic commented Apr 21, 2016

If you want to use the [square|brackets|syntax] use this line in the process function:

'/\[(((?>[^\[\]]+)|(?R))*)\]/x',

thanks @lury

@duytanqb
Copy link

duytanqb commented Aug 1, 2016

Thank for very helpful code.
How can I use PHP to find match text in data then replace
example my content:
$content = 'The speedy black wolf bounded over the lazy hound';
$patten = array('{the|a|}',{black|red|yellow}....);

Expect result after replace : $content = '{the|a|} speedy {black|red|yellow} wolf bounded over the lazy hound';
they will find 1 of some word in {} and if 1 of some word by | match, they will replace to the content.

@b3rday
Copy link

b3rday commented Aug 3, 2016

thank you for this

@verma-ashish
Copy link

verma-ashish commented Mar 10, 2017

Is there way to ignore spin for "first capital alphabet word" (e,g. names, country, etc.)?

@iznubadd
Copy link

iznubadd commented Mar 20, 2017

hi
i love this scripts. is any ideas on how can it be implement with mysql data? like storing the synonyms in a database

more power

@herahadi
Copy link

herahadi commented Mar 29, 2017

hi, if i want to calculate maximum number of my spintax combination can generate unique article how to do that?

@haknudsen
Copy link

haknudsen commented May 19, 2017

Is there a way I could show all the possible variations?

@fbparis
Copy link

fbparis commented Nov 10, 2017

The problem with this kind of spinners is that spuns do not have the same probability to be chosen.
For example, something like '{A|{B|C|D|E|F}}' will have 50% of 'A'.
I've coded another one with Python where every possible spuns have the same probability to be chosen, also you can retrieve the number of every possible spuns that can be generated from a spintax string.
You can have a look here : https://gist.github.com/fbparis/738c52e253639edb3cb41f90ea0b490c

@mamunur34
Copy link

mamunur34 commented Aug 4, 2018

Very interesting. Pretty cool. As it is very slim in size and heavy in working.

@patrykkp
Copy link

patrykkp commented Sep 24, 2018

great! very useful - thanks!

@juanma386
Copy link

juanma386 commented Dec 27, 2018

is posible? {
Mensaje001
|Mensaje 002
{
Mensaje 002-1
|
Mensaje 002-2
}
}
To infinity data spintax.

@kamiljanicki
Copy link

kamiljanicki commented Jan 20, 2019

Hello! Generally class working great even with 3rd or 4th nesting level. But i think there is some mysterious bug.

Spintax works fine with short texts, but when text is longer than 8.000 character (whole text including synonims in brackets {}) then class cause HTTP errors (connecion reset).

I make a test in separated file where was only class definition, one object and variable with text.

Can somone help me with this?

In php ini i have declared 2GB of ram and unlimited time of execution.

Regards!

@PhiSYS
Copy link

PhiSYS commented Jul 3, 2019

I guess we could make the asterisk lazy for a little performance boost '/{(((?>[^\{\}]+)|(?R))*?)}/x'.

/\{(((?>[^\{\}]+)|(?R))*)\}/x 816 matches, 11424 steps (~30ms)
816 matches, 11424 steps, 30ms

/\{(((?>[^\{\}]+)|(?R))*?)\}/x 816 matches, 9792 steps (~13ms)
816 matches, 9792 steps, 13ms

@EmilioNicolas
Copy link

EmilioNicolas commented Jul 3, 2019

I guess we could make the asterisk lazy for a little performance boost '/{(((?>[^{}]+)|(?R))*?)}/x'.

I forked this optimized solution and added seed rand in order to fix the spin text with srand.

@jakama
Copy link

jakama commented Aug 4, 2020

Hello!

Great job. It is helping me a lot!

I'm trying to get the parts of the spintax text separately, but I only get the ones between {}

For example, in this text:
{Hi|Hello}{ Mr.|} Irfaq Syed. {How are you?|How about the day?}

I get:
{Hi | Hello}
{Mr. |}
{How are you? | How about the day?}

But not the text in the middle, that is, I don't get:

Irfaq Syed.

There is any Regex to get all, the spintax groups and the plain text?

Thanks!

@naufalkh
Copy link

naufalkh commented Jan 14, 2021

Very interesting!
How to make the reverse?
Input: Hello to you, Mr. Smith!
Output: {Hello|Howdy|Hola} to you, {Mr.|Mrs.|Ms.} {Smith|Williams|Davis}!

@herahadi
Copy link

herahadi commented Jul 5, 2022

how to output an array of all possible combinations?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment