PHP: str_replace

<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>PHP: str_replace - Manual </title> <link rel="icon" type="image/svg+xml" sizes="any" href="https://www.php.net/favicon.svg?v=2"> <link rel="icon" type="image/png" sizes="196x196" href="https://www.php.net/favicon-196x196.png?v=2"> <link rel="icon" type="image/png" sizes="32x32" href="https://www.php.net/favicon-32x32.png?v=2"> <link rel="icon" type="image/png" sizes="16x16" href="https://www.php.net/favicon-16x16.png?v=2"> <link rel="shortcut icon" href="https://www.php.net/favicon.ico?v=2"> <link rel="search" type="application/opensearchdescription+xml" href="http://php.net/phpnetimprovedsearch.src" title="Add PHP.net search"> <link rel="alternate" type="application/atom+xml" href="https://www.php.net/releases/feed.php" title="PHP Release feed"> <link rel="alternate" type="application/atom+xml" href="https://www.php.net/feed.atom" title="PHP: Hypertext Preprocessor"> <link rel="canonical" href="https://www.php.net/manual/en/function.str-replace.php"> <link rel="shorturl" href="https://www.php.net/str-replace"> <link rel="alternate" href="https://www.php.net/str-replace" hreflang="x-default"> <link rel="contents" href="https://www.php.net/manual/en/index.php"> <link rel="index" href="https://www.php.net/manual/en/ref.strings.php"> <link rel="prev" href="https://www.php.net/manual/en/function.str-repeat.php"> <link rel="next" href="https://www.php.net/manual/en/function.str-rot13.php"> <link rel="alternate" href="https://www.php.net/manual/en/function.str-replace.php" hreflang="en"> <link rel="alternate" href="https://www.php.net/manual/de/function.str-replace.php" hreflang="de"> <link rel="alternate" href="https://www.php.net/manual/es/function.str-replace.php" hreflang="es"> <link rel="alternate" href="https://www.php.net/manual/fr/function.str-replace.php" hreflang="fr"> <link rel="alternate" href="https://www.php.net/manual/it/function.str-replace.php" hreflang="it"> <link rel="alternate" href="https://www.php.net/manual/ja/function.str-replace.php" hreflang="ja"> <link rel="alternate" href="https://www.php.net/manual/pt_BR/function.str-replace.php" hreflang="pt_BR"> <link rel="alternate" href="https://www.php.net/manual/ru/function.str-replace.php" hreflang="ru"> <link rel="alternate" href="https://www.php.net/manual/tr/function.str-replace.php" hreflang="tr"> <link rel="alternate" href="https://www.php.net/manual/uk/function.str-replace.php" hreflang="uk"> <link rel="alternate" href="https://www.php.net/manual/zh/function.str-replace.php" hreflang="zh"> <link rel="stylesheet" type="text/css" href="/cached.php?t=1707321815&f=/fonts/Fira/fira.css" media="screen"> <link rel="stylesheet" type="text/css" href="/cached.php?t=1707321815&f=/fonts/Font-Awesome/css/fontello.css" media="screen"> <link rel="stylesheet" type="text/css" href="/cached.php?t=1738926002&f=/styles/theme-base.css" media="screen"> <link rel="stylesheet" type="text/css" href="/cached.php?t=1730558402&f=/styles/theme-medium.css" media="screen"> <base href="https://www.php.net/manual/en/function.str-replace.php"> <meta name="Description" content="PHP is a popular general-purpose scripting language that powers everything from your blog to the most popular websites in the world." /> <meta name="twitter:card" content="summary_large_image" /> <meta name="twitter:site" content="@official_php" /> <meta name="twitter:title" content="PHP: Hypertext Preprocessor" /> <meta name="twitter:description" content="PHP is a popular general-purpose scripting language that powers everything from your blog to the most popular websites in the world." /> <meta name="twitter:creator" content="@official_php" /> <meta name="twitter:image:src" content="https://www.php.net/images/meta-image.png" /> <meta itemprop="name" content="PHP: Hypertext Preprocessor" /> <meta itemprop="description" content="PHP is a popular general-purpose scripting language that powers everything from your blog to the most popular websites in the world." /> <meta itemprop="image" content="https://www.php.net/images/meta-image.png" /> <meta property="og:image" content="https://www.php.net/images/meta-image.png" /> <meta property="og:description" content="PHP is a popular general-purpose scripting language that powers everything from your blog to the most popular websites in the world." /> <link href="https://fosstodon.org/@php" rel="me" />  <script> var _paq = window._paq = window._paq || []; /* tracker methods like "setCustomDimension" should be called before "trackPageView" */ _paq.push(["setDoNotTrack", true]); _paq.push(["disableCookies"]); _paq.push(['trackPageView']); _paq.push(['enableLinkTracking']); (function() { var u="https://analytics.php.net/"; _paq.push(['setTrackerUrl', u+'matomo.php']); _paq.push(['setSiteId', '1']); var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s); })(); </script>  </head> <body class="docs "> <nav class="navbar navbar-fixed-top"> <div class="navbar__inner"> <a href="/" aria-label="PHP Home" class="navbar__brand"> <img src="/images/logos/php-logo-white.svg" aria-hidden="true" width="80" height="40" > </a> <div id="navbar__offcanvas" tabindex="-1" class="navbar__offcanvas" aria-label="Menu" > <button id="navbar__close-button" class="navbar__icon-item navbar_icon-item--visually-aligned navbar__close-button" > <svg xmlns="http://www.w3.org/2000/svg" width="24" viewBox="0 0 24 24" fill="currentColor"><path d="M19,6.41L17.59,5L12,10.59L6.41,5L5,6.41L10.59,12L5,17.59L6.41,19L12,13.41L17.59,19L19,17.59L13.41,12L19,6.41Z" /></svg> </button> <ul class="navbar__nav"> <li class="navbar__item"> <a href="/downloads.php" class="navbar__link " > Downloads </a> </li> <li class="navbar__item"> <a href="/docs.php" aria-current="page" class="navbar__link navbar__link--active " > Documentation </a> </li> <li class="navbar__item"> <a href="/get-involved.php" class="navbar__link " > Get Involved </a> </li> <li class="navbar__item"> <a href="/support.php" class="navbar__link " > Help </a> </li> <li class="navbar__item"> <a href="/releases/8.4/index.php" class="navbar__link navbar__release" > <img src="/images/php8/logo_php8_4.svg" alt="PHP 8.4"> </a> </li> </ul> </div> <div class="navbar__right">  <form action="/manual-lookup.php" class="navbar__search-form" > <label for="navbar__search-input" aria-label="Search docs"> <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" > <circle cx="11" cy="11" r="8"></circle> <line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> </label> <input type="search" name="pattern" id="navbar__search-input" class="navbar__search-input" placeholder="Search docs" accesskey="s" > <input type="hidden" name="scope" value="quickref"> </form>  <button id="navbar__search-button" class="navbar__search-button" hidden > <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" > <circle cx="11" cy="11" r="8"></circle> <line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> Search docs </button>  <a id="navbar__search-link" href="/lookup-form.php" aria-label="Search docs" class="navbar__icon-item navbar__search-link" > <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" > <circle cx="11" cy="11" r="8"></circle> <line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> </a> <a id="navbar__menu-link" href="/menu.php" aria-label="Menu" class="navbar__icon-item navbar_icon-item--visually-aligned navbar_menu-link" > <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="currentColor" > <path d="M3,6H21V8H3V6M3,11H21V13H3V11M3,16H21V18H3V16Z" /> </svg> </a>  <button id="navbar__search-button-mobile" aria-label="Search docs" class="navbar__icon-item navbar__search-button-mobile" hidden > <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" > <circle cx="11" cy="11" r="8"></circle> <line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> </button> <button id="navbar__menu-button" aria-label="Menu" class="navbar__icon-item navbar_icon-item--visually-aligned" hidden > <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="currentColor" > <path d="M3,6H21V8H3V6M3,11H21V13H3V11M3,16H21V18H3V16Z" /> </svg> </button> </div> <div id="navbar__backdrop" class="navbar__backdrop" ></div> </div> <div id="flash-message"></div> </nav> <div class="headsup"><a href='/conferences/index.php#2025-03-14-1'>PHP Conference Odawara 2025</a></div> <nav id="trick"><div><dl> <dt><a href='/manual/en/getting-started.php'>Getting Started</a></dt> <dd><a href='/manual/en/introduction.php'>Introduction</a></dd> <dd><a href='/manual/en/tutorial.php'>A simple tutorial</a></dd> <dt><a href='/manual/en/langref.php'>Language Reference</a></dt> <dd><a href='/manual/en/language.basic-syntax.php'>Basic syntax</a></dd> <dd><a href='/manual/en/language.types.php'>Types</a></dd> <dd><a href='/manual/en/language.variables.php'>Variables</a></dd> <dd><a href='/manual/en/language.constants.php'>Constants</a></dd> <dd><a href='/manual/en/language.expressions.php'>Expressions</a></dd> <dd><a href='/manual/en/language.operators.php'>Operators</a></dd> <dd><a href='/manual/en/language.control-structures.php'>Control Structures</a></dd> <dd><a href='/manual/en/language.functions.php'>Functions</a></dd> <dd><a href='/manual/en/language.oop5.php'>Classes and Objects</a></dd> <dd><a href='/manual/en/language.namespaces.php'>Namespaces</a></dd> <dd><a href='/manual/en/language.enumerations.php'>Enumerations</a></dd> <dd><a href='/manual/en/language.errors.php'>Errors</a></dd> <dd><a href='/manual/en/language.exceptions.php'>Exceptions</a></dd> <dd><a href='/manual/en/language.fibers.php'>Fibers</a></dd> <dd><a href='/manual/en/language.generators.php'>Generators</a></dd> <dd><a href='/manual/en/language.attributes.php'>Attributes</a></dd> <dd><a href='/manual/en/language.references.php'>References Explained</a></dd> <dd><a href='/manual/en/reserved.variables.php'>Predefined Variables</a></dd> <dd><a href='/manual/en/reserved.exceptions.php'>Predefined Exceptions</a></dd> <dd><a href='/manual/en/reserved.interfaces.php'>Predefined Interfaces and Classes</a></dd> <dd><a href='/manual/en/reserved.attributes.php'>Predefined Attributes</a></dd> <dd><a href='/manual/en/context.php'>Context options and parameters</a></dd> <dd><a href='/manual/en/wrappers.php'>Supported Protocols and Wrappers</a></dd> </dl> <dl> <dt><a href='/manual/en/security.php'>Security</a></dt> <dd><a href='/manual/en/security.intro.php'>Introduction</a></dd> <dd><a href='/manual/en/security.general.php'>General considerations</a></dd> <dd><a href='/manual/en/security.cgi-bin.php'>Installed as CGI binary</a></dd> <dd><a href='/manual/en/security.apache.php'>Installed as an Apache module</a></dd> <dd><a href='/manual/en/security.sessions.php'>Session Security</a></dd> <dd><a href='/manual/en/security.filesystem.php'>Filesystem Security</a></dd> <dd><a href='/manual/en/security.database.php'>Database Security</a></dd> <dd><a href='/manual/en/security.errors.php'>Error Reporting</a></dd> <dd><a href='/manual/en/security.variables.php'>User Submitted Data</a></dd> <dd><a href='/manual/en/security.hiding.php'>Hiding PHP</a></dd> <dd><a href='/manual/en/security.current.php'>Keeping Current</a></dd> <dt><a href='/manual/en/features.php'>Features</a></dt> <dd><a href='/manual/en/features.http-auth.php'>HTTP authentication with PHP</a></dd> <dd><a href='/manual/en/features.cookies.php'>Cookies</a></dd> <dd><a href='/manual/en/features.sessions.php'>Sessions</a></dd> <dd><a href='/manual/en/features.file-upload.php'>Handling file uploads</a></dd> <dd><a href='/manual/en/features.remote-files.php'>Using remote files</a></dd> <dd><a href='/manual/en/features.connection-handling.php'>Connection handling</a></dd> <dd><a href='/manual/en/features.persistent-connections.php'>Persistent Database Connections</a></dd> <dd><a href='/manual/en/features.commandline.php'>Command line usage</a></dd> <dd><a href='/manual/en/features.gc.php'>Garbage Collection</a></dd> <dd><a href='/manual/en/features.dtrace.php'>DTrace Dynamic Tracing</a></dd> </dl> <dl> <dt><a href='/manual/en/funcref.php'>Function Reference</a></dt> <dd><a href='/manual/en/refs.basic.php.php'>Affecting PHP's Behaviour</a></dd> <dd><a href='/manual/en/refs.utilspec.audio.php'>Audio Formats Manipulation</a></dd> <dd><a href='/manual/en/refs.remote.auth.php'>Authentication Services</a></dd> <dd><a href='/manual/en/refs.utilspec.cmdline.php'>Command Line Specific Extensions</a></dd> <dd><a href='/manual/en/refs.compression.php'>Compression and Archive Extensions</a></dd> <dd><a href='/manual/en/refs.crypto.php'>Cryptography Extensions</a></dd> <dd><a href='/manual/en/refs.database.php'>Database Extensions</a></dd> <dd><a href='/manual/en/refs.calendar.php'>Date and Time Related Extensions</a></dd> <dd><a href='/manual/en/refs.fileprocess.file.php'>File System Related Extensions</a></dd> <dd><a href='/manual/en/refs.international.php'>Human Language and Character Encoding Support</a></dd> <dd><a href='/manual/en/refs.utilspec.image.php'>Image Processing and Generation</a></dd> <dd><a href='/manual/en/refs.remote.mail.php'>Mail Related Extensions</a></dd> <dd><a href='/manual/en/refs.math.php'>Mathematical Extensions</a></dd> <dd><a href='/manual/en/refs.utilspec.nontext.php'>Non-Text MIME Output</a></dd> <dd><a href='/manual/en/refs.fileprocess.process.php'>Process Control Extensions</a></dd> <dd><a href='/manual/en/refs.basic.other.php'>Other Basic Extensions</a></dd> <dd><a href='/manual/en/refs.remote.other.php'>Other Services</a></dd> <dd><a href='/manual/en/refs.search.php'>Search Engine Extensions</a></dd> <dd><a href='/manual/en/refs.utilspec.server.php'>Server Specific Extensions</a></dd> <dd><a href='/manual/en/refs.basic.session.php'>Session Extensions</a></dd> <dd><a href='/manual/en/refs.basic.text.php'>Text Processing</a></dd> <dd><a href='/manual/en/refs.basic.vartype.php'>Variable and Type Related Extensions</a></dd> <dd><a href='/manual/en/refs.webservice.php'>Web Services</a></dd> <dd><a href='/manual/en/refs.utilspec.windows.php'>Windows Only Extensions</a></dd> <dd><a href='/manual/en/refs.xml.php'>XML Manipulation</a></dd> <dd><a href='/manual/en/refs.ui.php'>GUI Extensions</a></dd> </dl> <dl> <dt>Keyboard Shortcuts</dt><dt>?</dt> <dd>This help</dd> <dt>j</dt> <dd>Next menu item</dd> <dt>k</dt> <dd>Previous menu item</dd> <dt>g p</dt> <dd>Previous man page</dd> <dt>g n</dt> <dd>Next man page</dd> <dt>G</dt> <dd>Scroll to bottom</dd> <dt>g g</dt> <dd>Scroll to top</dd> <dt>g h</dt> <dd>Goto homepage</dd> <dt>g s</dt> <dd>Goto search (current page)</dd> <dt>/</dt> <dd>Focus search box</dd> </dl></div></nav> <div id="goto"> <div class="search"> <div class="text"></div> <div class="results"><ul></ul></div> </div> </div> <div id="breadcrumbs" class="clearfix"> <div id="breadcrumbs-inner"> <div class="next"> <a href="function.str-rot13.php"> str_rot13 » </a> </div> <div class="prev"> <a href="function.str-repeat.php"> « str_repeat </a> </div> <ul> <li><a href='index.php'>PHP Manual</a></li> <li><a href='funcref.php'>Function Reference</a></li> <li><a href='refs.basic.text.php'>Text Processing</a></li> <li><a href='book.strings.php'>Strings</a></li> <li><a href='ref.strings.php'>String Functions</a></li> </ul> </div> </div> <div id="layout" class="clearfix"> <section id="layout-content"> <div class="page-tools"> <div class="change-language"> <form action="/manual/change.php" method="get" id="changelang" name="changelang"> <fieldset> <label for="changelang-langs">Change language:</label> <select onchange="document.changelang.submit()" name="page" id="changelang-langs"> <option value='en/function.str-replace.php' selected="selected">English</option> <option value='de/function.str-replace.php'>German</option> <option value='es/function.str-replace.php'>Spanish</option> <option value='fr/function.str-replace.php'>French</option> <option value='it/function.str-replace.php'>Italian</option> <option value='ja/function.str-replace.php'>Japanese</option> <option value='pt_BR/function.str-replace.php'>Brazilian Portuguese</option> <option value='ru/function.str-replace.php'>Russian</option> <option value='tr/function.str-replace.php'>Turkish</option> <option value='uk/function.str-replace.php'>Ukrainian</option> <option value='zh/function.str-replace.php'>Chinese (Simplified)</option> <option value='help-translate.php'>Other</option> </select> </fieldset> </form> </div> </div><div id="function.str-replace" class="refentry"> <div class="refnamediv"> <h1 class="refname">str_replace</h1> (PHP 4, PHP 5, PHP 7, PHP 8)str_replace — Replace all occurrences of the search string with the replacement string </div> <div class="refsect1 description" id="refsect1-function.str-replace-description"> <h3 class="title">Description</h3> <div class="methodsynopsis dc-description"> str_replace(     <a href="language.types.array.php" class="type array">array</a>|<a href="language.types.string.php" class="type string">string</a> <code class="parameter">$search</code>,     <a href="language.types.array.php" class="type array">array</a>|<a href="language.types.string.php" class="type string">string</a> <code class="parameter">$replace</code>,     <a href="language.types.string.php" class="type string">string</a>|<a href="language.types.array.php" class="type array">array</a> <code class="parameter">$subject</code>,     <a href="language.types.integer.php" class="type int">int</a> <code class="parameter reference">&$count</code> = <code><a href="reserved.constants.php#constant.null">null</a></code> ): <a href="language.types.string.php" class="type string">string</a>|<a href="language.types.array.php" class="type array">array</a></div> This function returns a string or an array with all occurrences of <code class="parameter">search</code> in <code class="parameter">subject</code> replaced with the given <code class="parameter">replace</code> value. To replace text based on a pattern rather than a fixed string, use <a href="function.preg-replace.php" class="function">preg_replace()</a>. </div> <div class="refsect1 parameters" id="refsect1-function.str-replace-parameters"> <h3 class="title">Parameters</h3> If <code class="parameter">search</code> and <code class="parameter">replace</code> are arrays, then str_replace() takes a value from each array and uses them to search and replace on <code class="parameter">subject</code>. If <code class="parameter">replace</code> has fewer values than <code class="parameter">search</code>, then an empty string is used for the rest of replacement values. If <code class="parameter">search</code> is an array and <code class="parameter">replace</code> is a string, then this replacement string is used for every value of <code class="parameter">search</code>. The converse would not make sense, though. If <code class="parameter">search</code> or <code class="parameter">replace</code> are arrays, their elements are processed first to last. <dl> <dt><code class="parameter">search</code></dt> <dd> The value being searched for, otherwise known as the needle. An array may be used to designate multiple needles. </dd> <dt><code class="parameter">replace</code></dt> <dd> The replacement value that replaces found <code class="parameter">search</code> values. An array may be used to designate multiple replacements. </dd> <dt><code class="parameter">subject</code></dt> <dd> The string or array being searched and replaced on, otherwise known as the haystack. If <code class="parameter">subject</code> is an array, then the search and replace is performed with every entry of <code class="parameter">subject</code>, and the return value is an array as well. </dd> <dt><code class="parameter">count</code></dt> <dd> If passed, this will be set to the number of replacements performed. </dd> </dl> </div> <div class="refsect1 returnvalues" id="refsect1-function.str-replace-returnvalues"> <h3 class="title">Return Values</h3> This function returns a string or an array with the replaced values. </div> <div class="refsect1 examples" id="refsect1-function.str-replace-examples"> <h3 class="title">Examples</h3> <div class="example" id="example-5043"> Example #1 Basic str_replace() examples <div class="example-contents"> <div class="phpcode"><code><?php // Provides: <body text='black'> $bodytag = str_replace("%body%", "black", "<body text='%body%'>"); // Provides: Hll Wrld f PHP $vowels = array("a", "e", "i", "o", "u", "A", "E", "I", "O", "U"); $onlyconsonants = str_replace($vowels, "", "Hello World of PHP"); // Provides: You should eat pizza, beer, and ice cream every day $phrase = "You should eat fruits, vegetables, and fiber every day."; $healthy = array("fruits", "vegetables", "fiber"); $yummy = array("pizza", "beer", "ice cream"); $newphrase = str_replace($healthy, $yummy, $phrase); // Provides: 2 $str = str_replace("ll", "", "good golly miss molly!", $count); echo $count; ?></code></div> </div> </div> <div class="example" id="example-5044"> Example #2 Examples of potential str_replace() gotchas <div class="example-contents"> <div class="phpcode"><code><?php // Order of replacement $str = "Line 1\nLine 2\rLine 3\r\nLine 4\n"; $order = array("\r\n", "\n", "\r"); $replace = ' '; // Processes \r\n's first so they aren't converted twice. $newstr = str_replace($order, $replace, $str); // Outputs F because A is replaced with B, then B is replaced with C, and so on... // Finally E is replaced with F, because of left to right replacements. $search = array('A', 'B', 'C', 'D', 'E'); $replace = array('B', 'C', 'D', 'E', 'F'); $subject = 'A'; echo str_replace($search, $replace, $subject); // Outputs: apearpearle pear // For the same reason mentioned above $letters = array('a', 'p'); $fruit = array('apple', 'pear'); $text = 'a p'; $output = str_replace($letters, $fruit, $text); echo $output; ?></code></div> </div> </div> </div> <div class="refsect1 notes" id="refsect1-function.str-replace-notes"> <h3 class="title">Notes</h3> <blockquote class="note">Note: This function is binary-safe.</blockquote> <div class="caution">Caution <h1 class="title">Replacement order gotcha</h1> Because str_replace() replaces left to right, it might replace a previously inserted value when doing multiple replacements. See also the examples in this document. </div> <blockquote class="note">Note: This function is case-sensitive. Use <a href="function.str-ireplace.php" class="function">str_ireplace()</a> for case-insensitive replace. </blockquote> </div> <div class="refsect1 seealso" id="refsect1-function.str-replace-seealso"> <h3 class="title">See Also</h3> <ul class="simplelist"> <li><a href="function.str-ireplace.php" class="function" rel="rdfs-seeAlso">str_ireplace()</a> - Case-insensitive version of str_replace</li> <li><a href="function.substr-replace.php" class="function" rel="rdfs-seeAlso">substr_replace()</a> - Replace text within a portion of a string</li> <li><a href="function.preg-replace.php" class="function" rel="rdfs-seeAlso">preg_replace()</a> - Perform a regular expression search and replace</li> <li><a href="function.strtr.php" class="function" rel="rdfs-seeAlso">strtr()</a> - Translate characters or replace substrings</li> </ul> </div> </div> <div class="contribute"> <h3 class="title">Found A Problem?</h3> <div> </div> <div class="edit-bug"> <a href="https://github.com/php/doc-base/blob/master/README.md" title="This will take you to our contribution guidelines on GitHub" target="_blank" rel="noopener noreferrer">Learn How To Improve This Page</a> • <a href="https://github.com/php/doc-en/blob/master/reference/strings/functions/str-replace.xml">Submit a Pull Request</a> • <a href="https://github.com/php/doc-en/issues/new?body=From%20manual%20page:%20https:%2F%2Fphp.net%2Ffunction.str-replace%0A%0A---">Report a Bug</a> </div> </div><section id="usernotes"> <div class="head"> <a href="/manual/add-note.php?sect=function.str-replace&repo=en&redirect=https://www.php.net/manual/en/function.str-replace.php">＋add a note</a> <h3 class="title">User Contributed Notes 33 notes</h3> </div><div id="allnotes"> <div class="note" id="100871"> <div class="votes"> <div id="Vu100871"> <a href="/manual/vote-note.php?id=100871&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd100871"> <a href="/manual/vote-note.php?id=100871&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V100871" title="72% like this..."> 269 </div> </div> <a href="#100871" class="name"> nikolaz dot tang at hotmail dot com</a><a class="genanchor" href="#100871"> ¶</a><div class="date" title="2010-11-11 08:57">14 years ago</div> <div class="text" id="Hcom100871"> <div class="phpcode"><code>A faster way to replace the strings in multidimensional array is to json_encode() it, do the str_replace() and then json_decode() it, like this: <?php function str_replace_json($search, $replace, $subject){ return json_decode(str_replace($search, $replace, json_encode($subject))); } ?> This method is almost 3x faster (in 10000 runs.) than using recursive calling and looping method, and 10x simpler in coding. Compared to: <?php function str_replace_deep($search, $replace, $subject) { if (is_array($subject)) { foreach($subject as &$oneSubject) $oneSubject = str_replace_deep($search, $replace, $oneSubject); unset($oneSubject); return $subject; } else { return str_replace($search, $replace, $subject); } } ?></code></div> </div> </div> <div class="note" id="126182"> <div class="votes"> <div id="Vu126182"> <a href="/manual/vote-note.php?id=126182&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd126182"> <a href="/manual/vote-note.php?id=126182&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V126182" title="85% like this..."> 10 </div> </div> <a href="#126182" class="name"> ressing1 at gmail dot com</a><a class="genanchor" href="#126182"> ¶</a><div class="date" title="2021-06-21 08:34">3 years ago</div> <div class="text" id="Hcom126182"> <div class="phpcode"><code>To remove all characters from string $b that exist in string $a: $a="ABC"; $b="teAsBtC"; echo str_replace(str_split($a),'',$b); Output: test To remove all characters from string $b that don't exist in string $a: $a="ABC"; $b="teAsBtC"; echo str_replace(str_split(str_replace(str_split($a),'',$b)),'',$b); Output: ABC</code></div> </div> </div> <div class="note" id="91536"> <div class="votes"> <div id="Vu91536"> <a href="/manual/vote-note.php?id=91536&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd91536"> <a href="/manual/vote-note.php?id=91536&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V91536" title="66% like this..."> 50 </div> </div> <a href="#91536" class="name"> Alberto Lepe</a><a class="genanchor" href="#91536"> ¶</a><div class="date" title="2009-06-15 07:44">15 years ago</div> <div class="text" id="Hcom91536"> <div class="phpcode"><code>Be careful when replacing characters (or repeated patterns in the FROM and TO arrays): For example: <?php $arrFrom = array("1","2","3","B"); $arrTo = array("A","B","C","D"); $word = "ZBB2"; echo str_replace($arrFrom, $arrTo, $word); ?> I would expect as result: "ZDDB" However, this return: "ZDDD" (Because B = D according to our array) To make this work, use "strtr" instead: <?php $arr = array("1" => "A","2" => "B","3" => "C","B" => "D"); $word = "ZBB2"; echo strtr($word,$arr); ?> This returns: "ZDDB"</code></div> </div> </div> <div class="note" id="105939"> <div class="votes"> <div id="Vu105939"> <a href="/manual/vote-note.php?id=105939&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd105939"> <a href="/manual/vote-note.php?id=105939&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V105939" title="64% like this..."> 59 </div> </div> <a href="#105939" class="name"> moostende at gmail dot com</a><a class="genanchor" href="#105939"> ¶</a><div class="date" title="2011-09-26 11:20">13 years ago</div> <div class="text" id="Hcom105939"> <div class="phpcode"><code>Note that this does not replace strings that become part of replacement strings. This may be a problem when you want to remove multiple instances of the same repetative pattern, several times in a row. If you want to remove all dashes but one from the string '-aaa----b-c-----d--e---f' resulting in '-aaa-b-c-d-e-f', you cannot use str_replace. Instead, use preg_replace: <?php $challenge = '-aaa----b-c-----d--e---f'; echo str_replace('--', '-', $challenge).' '; echo preg_replace('/--+/', '-', $challenge).' '; ?> This outputs the following: -aaa--b-c---d-e--f -aaa-b-c-d-e-f</code></div> </div> </div> <div class="note" id="115946"> <div class="votes"> <div id="Vu115946"> <a href="/manual/vote-note.php?id=115946&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd115946"> <a href="/manual/vote-note.php?id=115946&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V115946" title="65% like this..."> 8 </div> </div> <a href="#115946" class="name"> karst at onlinq dot nl</a><a class="genanchor" href="#115946"> ¶</a><div class="date" title="2014-10-17 01:57">10 years ago</div> <div class="text" id="Hcom115946"> <div class="phpcode"><code>"If search is an array and replace is a string, then this replacement string is used for every value of search. The converse would not make sense, though. " I think one important (and not at all vaguely theoretical) use-case is completely ignored here. Take, for example, the way the PDO handles parameter replacement. If we have the following query: "SELECT * FROM my_table WHERE (id = ? AND my_column = ? AND other_column = ?);" The "?"s should be replaced by each successive variable in a $parameters array. That is EXACTLY the use case for "search" being a value and "replace" being an array. Considering that this is not only a real-world example but also part of a core PHP functionality I find it very strange that it's dismissed so easily here.</code></div> </div> </div> <div class="note" id="95198"> <div class="votes"> <div id="Vu95198"> <a href="/manual/vote-note.php?id=95198&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd95198"> <a href="/manual/vote-note.php?id=95198&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V95198" title="60% like this..."> 38 </div> </div> <a href="#95198" class="name"> Wes Foster</a><a class="genanchor" href="#95198"> ¶</a><div class="date" title="2009-12-17 01:32">15 years ago</div> <div class="text" id="Hcom95198"> <div class="phpcode"><code>Feel free to optimize this using the while/for or anything else, but this is a bit of code that allows you to replace strings found in an associative array. For example: <?php $replace = array( 'dog' => 'cat', 'apple' => 'orange' 'chevy' => 'ford' ); $string = 'I like to eat an apple with my dog in my chevy'; echo str_replace_assoc($replace,$string); // Echo: I like to eat an orange with my cat in my ford ?> Here is the function: <?php function strReplaceAssoc(array $replace, $subject) { return str_replace(array_keys($replace), array_values($replace), $subject); } ?> [Jun 1st, 2010 - EDIT BY thiago AT php DOT net: Function has been replaced with an updated version sent by ljelinek AT gmail DOT com]</code></div> </div> </div> <div class="note" id="119793"> <div class="votes"> <div id="Vu119793"> <a href="/manual/vote-note.php?id=119793&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd119793"> <a href="/manual/vote-note.php?id=119793&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V119793" title="62% like this..."> 4 </div> </div> <a href="#119793" class="name"> viundan at gmail dot com</a><a class="genanchor" href="#119793"> ¶</a><div class="date" title="2016-08-26 04:08">8 years ago</div> <div class="text" id="Hcom119793"> <div class="phpcode"><code>Decision to avoid problem "it might replace a previously inserted value when doing multiple replacements. See also the examples in this document." $urls - array of urls i want to replace with tag <a> and urls could be similar <a href="http://abc.com/parameter/" rel="nofollow" target="_blank">http://abc.com/parameter/</a> <a href="http://abc.com/" rel="nofollow" target="_blank">http://abc.com/</a> // at first sort by length to have longest firstly usort($urls,'sortByLen'); $replaces=[]; // replace all urls with unique foreach($urls as $url){ $replace = '__REPLACE' . uniqid() . '__'; $text = str_replace($url,$replace, $text); $replaces[$replace] = '<a href="' . $url . '">' . $url . '</a>'; } foreach($replaces as $key => $replace){ $text = str_replace($key,$replace, $text); } -------------- function sortByLen($a,$b){ return strlen($b)-strlen($a); } Hope it will help others like me</code></div> </div> </div> <div class="note" id="122929"> <div class="votes"> <div id="Vu122929"> <a href="/manual/vote-note.php?id=122929&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd122929"> <a href="/manual/vote-note.php?id=122929&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V122929" title="60% like this..."> 8 </div> </div> <a href="#122929" class="name"> ravenswd at gmail dot com</a><a class="genanchor" href="#122929"> ¶</a><div class="date" title="2018-07-11 01:33">6 years ago</div> <div class="text" id="Hcom122929"> <div class="phpcode"><code>This is what happens when the search and replace arrays are different sizes: <?php $search = array('a', 'b', 'c', 'd', 'e'); $replace = array('A', 'B', 'C'); $subject = 'abcdefg'; echo str_replace($search, $replace, $subject); // result: 'ABCfg' $search = array('a', 'b', 'c'); $replace = array('A', 'B', 'C', 'D', 'E'); $subject = 'abcdefg'; echo str_replace($search, $replace, $subject); // result: 'ABCdefg' ?> No warning or error is generated in either of these cases.</code></div> </div> </div> <div class="note" id="88569"> <div class="votes"> <div id="Vu88569"> <a href="/manual/vote-note.php?id=88569&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd88569"> <a href="/manual/vote-note.php?id=88569&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V88569" title="61% like this..."> 11 </div> </div> <a href="#88569" class="name"> michael dot moussa at gmail dot com</a><a class="genanchor" href="#88569"> ¶</a><div class="date" title="2009-01-29 06:38">16 years ago</div> <div class="text" id="Hcom88569"> <div class="phpcode"><code>As previous commentators mentioned, when $search contains values that occur earlier in $replace, str_replace will factor those previous replacements into the process rather than operating solely on the original string. This may produce unexpected output. Example: <?php $search = array('A', 'B', 'C', 'D', 'E'); $replace = array('B', 'C', 'D', 'E', 'F'); $subject = 'ABCDE'; echo str_replace($search, $replace, $subject); // output: 'FFFFFF' ?> In the above code, the $search and $replace should replace each occurrence in the $subject with the next letter in the alphabet. The expected output for this sample is 'BCDEF'; however, the actual output is 'FFFFF'. To more clearly illustrate this, consider the following example: <?php $search = array('A', 'B', 'C', 'D', 'E'); $replace = array('B', 'C', 'D', 'E', 'F'); $subject = 'A'; echo str_replace($search, $replace, $subject); // output: 'F' ?> Since 'A' is the only letter in the $search array that appears in $subject, one would expect the result to be 'B'; however, replacement number $n does *not* operate on $subject, it operates on $subject after the previous $n-1 replacements have been completed. The following function utilizes array_combine and strtr to produce the expected output, and I believe it is the most efficient way to perform the desired string replacement without prior replacements affecting the final result. <?php /** * When using str_replace(...), values that did not exist in the original string (but were put there by previous * replacements) will be replaced continuously. This string replacement function is designed replace the values * in $search with those in $replace while not factoring in prior replacements. Note that this function will * always look for the longest possible match first and then work its way down to individual characters. * * The "o" in "stro_replace" represents "original", indicating that the function operates only on the original string. * * @param array $search list of strings or characters that need to be replaced * @param array $replace list of strings or characters that will replace the corresponding values in $search * @param string $subject the string on which this operation is being performed * * @return string $subject with all substrings in the $search array replaced by the values in the $replace array */ function stro_replace($search, $replace, $subject) { return strtr( $subject, array_combine($search, $replace) ); } $search = array('A', 'B', 'C', 'D', 'E'); $replace = array('B', 'C', 'D', 'E', 'F'); $subject = 'ABCDE'; echo stro_replace($search, $replace, $subject); // output: 'BCDEF' ?> Some other examples: <?php $search = array(' ', '&'); $replace = array('&nbsp;', '&amp;'); $subject = 'Hello & goodbye!'; // We want to replace the spaces with &nbsp; and the ampersand with &amp; echo str_replace($search, $replace, $subject); // output: "Hello&amp;nbsp&amp;&amp;nbspgoodbye!" - wrong! echo stro_replace($search, $replace, $subject); // output: "Hello&nbsp;&amp;&nbsp;goodbye!" - correct! /* Note: Run the above code in the CLI or view source on your web browser - the replacement strings for stro_replace are HTML entities which the browser interprets. */ ?> <?php $search = array('ERICA', 'AMERICA'); $replace = array('JON', 'PHP'); $subject = 'MIKE AND ERICA LIKE AMERICA'; // We want to replace the name "ERICA" with "JON" and the word "AMERICA" with "PHP" echo str_replace($search, $replace, $subject); // output: "MIKE AND JON LIKE AMJON", which is not correct echo stro_replace($search, $replace, $subject); // output: "MIKE AND JON LIKE PHP", which is correct ?></code></div> </div> </div> <div class="note" id="117026"> <div class="votes"> <div id="Vu117026"> <a href="/manual/vote-note.php?id=117026&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd117026"> <a href="/manual/vote-note.php?id=117026&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V117026" title="58% like this..."> 10 </div> </div> <a href="#117026" class="name"> mrrehbein at gmail dot com</a><a class="genanchor" href="#117026"> ¶</a><div class="date" title="2015-04-03 01:25">9 years ago</div> <div class="text" id="Hcom117026"> <div class="phpcode"><code>nikolaz dot tang at hotmail dot com's solution of using json_encode/decode is interesting, but a couple of issues to be aware of with it. <?php // From: nikolaz dot tang at hotmail dot com's post function str_replace_json($search, $replace, $subject){ return json_decode(str_replace($search, $replace, json_encode($subject))); } ?> json_decode will return objects, where arrays are probably expected. This is easily remedied by adding 2nd parameter 'true' to json_decode. $search and $replace could contain strings that match json encoding, which will either change the structure returned by this method, or break the json. ie: <?php var_dump(str_replace_json('":"', '","', ['this' => 'stuff'])); var_dump(str_replace_json('this":"', 'this" : "thing", "with":"', ['this' => 'stuff'])); ?></code></div> </div> </div> <div class="note" id="118785"> <div class="votes"> <div id="Vu118785"> <a href="/manual/vote-note.php?id=118785&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd118785"> <a href="/manual/vote-note.php?id=118785&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V118785" title="58% like this..."> 13 </div> </div> <a href="#118785" class="name"> David Holt</a><a class="genanchor" href="#118785"> ¶</a><div class="date" title="2016-02-05 02:59">9 years ago</div> <div class="text" id="Hcom118785"> <div class="phpcode"><code>Be aware that if you use this for filtering & sanitizing some form of user input, or remove ALL instances of a string, there's another gotcha to watch out for: // Remove all double characters $string="1001011010"; $string=str_replace(array("11","00"),"",$string); // Output: "110010" $string="<ht<html>ml> Malicious code </<html>html> etc"; $string=str_replace(array("<html>","</html>"),"",$string); // Output: "<html> Malicious code </html> etc"</code></div> </div> </div> <div class="note" id="98511"> <div class="votes"> <div id="Vu98511"> <a href="/manual/vote-note.php?id=98511&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd98511"> <a href="/manual/vote-note.php?id=98511&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V98511" title="60% like this..."> 5 </div> </div> <a href="#98511" class="name"> apmuthu at usa dot net</a><a class="genanchor" href="#98511"> ¶</a><div class="date" title="2010-06-19 12:31">14 years ago</div> <div class="text" id="Hcom98511"> <div class="phpcode"><code>If we have a html template that contains placeholders in curly braces that need to be replaced in runtime, the following function will do it using str_replace: <?php function parse_template($filename, $data) { // example template variables {a} and {bc} // example $data array // $data = Array("a" => 'one', "bc" => 'two'); $q = file_get_contents($filename); foreach ($data as $key => $value) { $q = str_replace('{'.$key.'}', $value, $q); } return $q; } ?></code></div> </div> </div> <div class="note" id="97574"> <div class="votes"> <div id="Vu97574"> <a href="/manual/vote-note.php?id=97574&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd97574"> <a href="/manual/vote-note.php?id=97574&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V97574" title="58% like this..."> 11 </div> </div> <a href="#97574" class="name"> jbarnett at jmbelite dot com</a><a class="genanchor" href="#97574"> ¶</a><div class="date" title="2010-04-26 01:23">14 years ago</div> <div class="text" id="Hcom97574"> <div class="phpcode"><code>Might be worth mentioning that a SIMPLE way to accomplish Example 2 (potential gotchas) is to simply start your "replacements" in reverse. So instead of starting from "A" and ending with "E": <?php $search = array('A', 'B', 'C', 'D', 'E'); $replace = array('B', 'C', 'D', 'E', 'F'); // replaces A to B, B to C, C to D, D to E, E to F (makes them all F) // start from "E" and end with "A": $search = array('E', 'D', 'C', 'B', 'A'); $replace = array('F', 'E', 'D', 'C', 'B'); // replaces E to F, D to E, C to D, B to C, A to B (prevents from // multiple replacements of already replaced values) ?> So basically start from the "end" and put the replacements in an order where the "replaced value" won't equal a value that exists later in the "search array".</code></div> </div> </div> <div class="note" id="102465"> <div class="votes"> <div id="Vu102465"> <a href="/manual/vote-note.php?id=102465&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd102465"> <a href="/manual/vote-note.php?id=102465&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V102465" title="58% like this..."> 13 </div> </div> <a href="#102465" class="name"> jay_knows_(all)uk at hotmail dot com</a><a class="genanchor" href="#102465"> ¶</a><div class="date" title="2011-02-16 07:16">14 years ago</div> <div class="text" id="Hcom102465"> <div class="phpcode"><code>This strips out horrible MS word characters. Just keep fine tuning it until you get what you need, you'll see ive commented some out which caused problems for me. There could be some that need adding in, but its a start to anyone who wishes to make their own custom function. <?php function msword_conversion($str) { $str = str_replace(chr(130), ',', $str); // baseline single quote $str = str_replace(chr(131), 'NLG', $str); // florin $str = str_replace(chr(132), '"', $str); // baseline double quote $str = str_replace(chr(133), '...', $str); // ellipsis $str = str_replace(chr(134), '**', $str); // dagger (a second footnote) $str = str_replace(chr(135), '***', $str); // double dagger (a third footnote) $str = str_replace(chr(136), '^', $str); // circumflex accent $str = str_replace(chr(137), 'o/oo', $str); // permile $str = str_replace(chr(138), 'Sh', $str); // S Hacek $str = str_replace(chr(139), '<', $str); // left single guillemet // $str = str_replace(chr(140), 'OE', $str); // OE ligature $str = str_replace(chr(145), "'", $str); // left single quote $str = str_replace(chr(146), "'", $str); // right single quote // $str = str_replace(chr(147), '"', $str); // left double quote // $str = str_replace(chr(148), '"', $str); // right double quote $str = str_replace(chr(149), '-', $str); // bullet $str = str_replace(chr(150), '-–', $str); // endash $str = str_replace(chr(151), '--', $str); // emdash // $str = str_replace(chr(152), '~', $str); // tilde accent // $str = str_replace(chr(153), '(TM)', $str); // trademark ligature $str = str_replace(chr(154), 'sh', $str); // s Hacek $str = str_replace(chr(155), '>', $str); // right single guillemet // $str = str_replace(chr(156), 'oe', $str); // oe ligature $str = str_replace(chr(159), 'Y', $str); // Y Dieresis $str = str_replace('°C', '&deg;C', $str); // Celcius is used quite a lot so it makes sense to add this in $str = str_replace('£', '&pound;', $str); $str = str_replace("'", "'", $str); $str = str_replace('"', '"', $str); $str = str_replace('–', '&ndash;', $str); return $str; } ?></code></div> </div> </div> <div class="note" id="63783"> <div class="votes"> <div id="Vu63783"> <a href="/manual/vote-note.php?id=63783&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd63783"> <a href="/manual/vote-note.php?id=63783&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V63783" title="59% like this..."> 8 </div> </div> <a href="#63783" class="name"> matt wheaton</a><a class="genanchor" href="#63783"> ¶</a><div class="date" title="2006-03-30 07:40">18 years ago</div> <div class="text" id="Hcom63783"> <div class="phpcode"><code>As an effort to remove those Word copy and paste smart quotes, I've found that this works with UTF8 encoded strings (where $text in the following example is UTF8). Also the elipsis and em and en dashes are replaced. There is an "invisible" character after the â€ for the right side double smart quote that doesn't seem to display here. It is chr(157). <?php $find[] = 'â€œ'; // left side double smart quote $find[] = 'â€'; // right side double smart quote $find[] = 'â€˜'; // left side single smart quote $find[] = 'â€™'; // right side single smart quote $find[] = 'â€¦'; // elipsis $find[] = 'â€”'; // em dash $find[] = 'â€“'; // en dash $replace[] = '"'; $replace[] = '"'; $replace[] = "'"; $replace[] = "'"; $replace[] = "..."; $replace[] = "-"; $replace[] = "-"; $text = str_replace($find, $replace, $text); ?></code></div> </div> </div> <div class="note" id="97526"> <div class="votes"> <div id="Vu97526"> <a href="/manual/vote-note.php?id=97526&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd97526"> <a href="/manual/vote-note.php?id=97526&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V97526" title="57% like this..."> 7 </div> </div> <a href="#97526" class="name"> pjcdawkins at googlemail dot com</a><a class="genanchor" href="#97526"> ¶</a><div class="date" title="2010-04-23 05:23">14 years ago</div> <div class="text" id="Hcom97526"> <div class="phpcode"><code>Here's a deep replace function allowing multi-dimensional arrays in $search, $replace and $subject. The keys and other structure of $subject are preserved. <?php // Auxiliary function: function _replaceWithAnything($search,$replace,$subject){ if(!is_array($search) || !is_array($replace)){ $search=array($search); $replace=array($replace); } $match=array_search($subject,$search,true); if($match!==false && array_key_exists($match,$replace)) $subject=$replace[$match]; return $subject; } // Main function: function deepReplace($search,$replace,$subject){ if(!is_array($subject)) return _replaceWithAnything($search,$replace,$subject); foreach($subject as &$val){ if(is_array($val)){ $val=deepReplace($search,$replace,$val); continue; } $val=_replaceWithAnything($search,$replace,$val); } return $subject; } ?></code></div> </div> </div> <div class="note" id="108196"> <div class="votes"> <div id="Vu108196"> <a href="/manual/vote-note.php?id=108196&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd108196"> <a href="/manual/vote-note.php?id=108196&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V108196" title="55% like this..."> 5 </div> </div> <a href="#108196" class="name"> Denzel Morris</a><a class="genanchor" href="#108196"> ¶</a><div class="date" title="2012-04-06 02:43">12 years ago</div> <div class="text" id="Hcom108196"> <div class="phpcode"><code>Maybe obvious to veteran PHP programmers but less so to novice PHP programmers is the fact that this is invalid: <?php str_replace($search, $replace, $subject, 1); ?> At a glance it appears to be a reasonable request, until you realize that the fourth parameter must be a variable in order to be passed as a reference. A replacement: <?php str_replace($search, $replace, $subject, $temp = 1); // or $temp = 1; str_replace($search, $replace, $subject, $temp); ?></code></div> </div> </div> <div class="note" id="115660"> <div class="votes"> <div id="Vu115660"> <a href="/manual/vote-note.php?id=115660&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd115660"> <a href="/manual/vote-note.php?id=115660&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V115660" title="54% like this..."> 4 </div> </div> <a href="#115660" class="name"> Ing. Mirko Plazotta</a><a class="genanchor" href="#115660"> ¶</a><div class="date" title="2014-09-04 09:27">10 years ago</div> <div class="text" id="Hcom115660"> <div class="phpcode"><code><?php // a very beatiful way to do multiple replacements is this one, using just one array $replaceThis = Array( 'old word' => 'new word', 'was' => 'it', 'past' => 'future', ); $originalText = "every old word was a thing of the past..."; $replacedText = str_replace(array_keys($replaceThis), $replaceThis, $originalText); echo $replacedText; ?></code></div> </div> </div> <div class="note" id="121739"> <div class="votes"> <div id="Vu121739"> <a href="/manual/vote-note.php?id=121739&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd121739"> <a href="/manual/vote-note.php?id=121739&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V121739" title="53% like this..."> 1 </div> </div> <a href="#121739" class="name"> Oyedele Hammed Horlah - itz dot harmid at gmail dot com</a><a class="genanchor" href="#121739"> ¶</a><div class="date" title="2017-10-08 08:05">7 years ago</div> <div class="text" id="Hcom121739"> <div class="phpcode"><code>this is a simple function to replace all newlines to tags. \r\n - windows line break \n - linux line break \r - mac line break <?php function nl_to_br($str) { return str_replace(array("\r\n","\n","\r"), " ", $str); } echo nl_to_br('Hello world\n I am Oyedele Hammed Horlah'); // => Hello World I am Oyedele Hammed Horlah ?> Enjoy</code></div> </div> </div> <div class="note" id="109487"> <div class="votes"> <div id="Vu109487"> <a href="/manual/vote-note.php?id=109487&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd109487"> <a href="/manual/vote-note.php?id=109487&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V109487" title="53% like this..."> 4 </div> </div> <a href="#109487" class="name"> kriscraig at php dot net</a><a class="genanchor" href="#109487"> ¶</a><div class="date" title="2012-07-20 11:03">12 years ago</div> <div class="text" id="Hcom109487"> <div class="phpcode"><code><?php /** * Convert foreign 8859-1 characters into HTML entities. * * @param string $str * The string being parsed. * * @return string * The converted string. */ public static function convert_chars_to_entities( $str ) { $str = str_replace( 'À', '&#192;', $str ); $str = str_replace( 'Á', '&#193;', $str ); $str = str_replace( 'Â', '&#194;', $str ); $str = str_replace( 'Ã', '&#195;', $str ); $str = str_replace( 'Ä', '&#196;', $str ); $str = str_replace( 'Å', '&#197;', $str ); $str = str_replace( 'Æ', '&#198;', $str ); $str = str_replace( 'Ç', '&#199;', $str ); $str = str_replace( 'È', '&#200;', $str ); $str = str_replace( 'É', '&#201;', $str ); $str = str_replace( 'Ê', '&#202;', $str ); $str = str_replace( 'Ë', '&#203;', $str ); $str = str_replace( 'Ì', '&#204;', $str ); $str = str_replace( 'Í', '&#205;', $str ); $str = str_replace( 'Î', '&#206;', $str ); $str = str_replace( 'Ï', '&#207;', $str ); $str = str_replace( 'Ð', '&#208;', $str ); $str = str_replace( 'Ñ', '&#209;', $str ); $str = str_replace( 'Ò', '&#210;', $str ); $str = str_replace( 'Ó', '&#211;', $str ); $str = str_replace( 'Ô', '&#212;', $str ); $str = str_replace( 'Õ', '&#213;', $str ); $str = str_replace( 'Ö', '&#214;', $str ); $str = str_replace( '×', '&#215;', $str ); // Yeah, I know. But otherwise the gap is confusing. --Kris $str = str_replace( 'Ø', '&#216;', $str ); $str = str_replace( 'Ù', '&#217;', $str ); $str = str_replace( 'Ú', '&#218;', $str ); $str = str_replace( 'Û', '&#219;', $str ); $str = str_replace( 'Ü', '&#220;', $str ); $str = str_replace( 'Ý', '&#221;', $str ); $str = str_replace( 'Þ', '&#222;', $str ); $str = str_replace( 'ß', '&#223;', $str ); $str = str_replace( 'à', '&#224;', $str ); $str = str_replace( 'á', '&#225;', $str ); $str = str_replace( 'â', '&#226;', $str ); $str = str_replace( 'ã', '&#227;', $str ); $str = str_replace( 'ä', '&#228;', $str ); $str = str_replace( 'å', '&#229;', $str ); $str = str_replace( 'æ', '&#230;', $str ); $str = str_replace( 'ç', '&#231;', $str ); $str = str_replace( 'è', '&#232;', $str ); $str = str_replace( 'é', '&#233;', $str ); $str = str_replace( 'ê', '&#234;', $str ); $str = str_replace( 'ë', '&#235;', $str ); $str = str_replace( 'ì', '&#236;', $str ); $str = str_replace( 'í', '&#237;', $str ); $str = str_replace( 'î', '&#238;', $str ); $str = str_replace( 'ï', '&#239;', $str ); $str = str_replace( 'ð', '&#240;', $str ); $str = str_replace( 'ñ', '&#241;', $str ); $str = str_replace( 'ò', '&#242;', $str ); $str = str_replace( 'ó', '&#243;', $str ); $str = str_replace( 'ô', '&#244;', $str ); $str = str_replace( 'õ', '&#245;', $str ); $str = str_replace( 'ö', '&#246;', $str ); $str = str_replace( '÷', '&#247;', $str ); // Yeah, I know. But otherwise the gap is confusing. --Kris $str = str_replace( 'ø', '&#248;', $str ); $str = str_replace( 'ù', '&#249;', $str ); $str = str_replace( 'ú', '&#250;', $str ); $str = str_replace( 'û', '&#251;', $str ); $str = str_replace( 'ü', '&#252;', $str ); $str = str_replace( 'ý', '&#253;', $str ); $str = str_replace( 'þ', '&#254;', $str ); $str = str_replace( 'ÿ', '&#255;', $str ); return $str; } ?></code></div> </div> </div> <div class="note" id="119293"> <div class="votes"> <div id="Vu119293"> <a href="/manual/vote-note.php?id=119293&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd119293"> <a href="/manual/vote-note.php?id=119293&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V119293" title="53% like this..."> 1 </div> </div> <a href="#119293" class="name"> Mohsin Ali (puregenius02 at gmail dot com)</a><a class="genanchor" href="#119293"> ¶</a><div class="date" title="2016-05-06 10:28">8 years ago</div> <div class="text" id="Hcom119293"> <div class="phpcode"><code>$myString = “It was the best of mine it was the worst of mine,”; // Displays “It was the best of bananas, it was the worst of bananas,” echo str_replace( “mine”, “bananas”, $myString ); If you want to know how many times the search string was replaced, pass in a variable as an optional fourth argument. After the function runs, this variable holds the number of replacements: $myString = “It was the best of mine, it was the worst of mine,”; // Displays “It was the best of bananas, it was the worst of bananas,” echo str_replace( “mine”, “bananas”, $myString, $num ) . “ ”; // Displays “The text was replaced 2 times.” echo “The text was replaced $num times. ”;</code></div> </div> </div> <div class="note" id="104890"> <div class="votes"> <div id="Vu104890"> <a href="/manual/vote-note.php?id=104890&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd104890"> <a href="/manual/vote-note.php?id=104890&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V104890" title="54% like this..."> 3 </div> </div> <a href="#104890" class="name"> mbullard at accuvista dot co dot uk</a><a class="genanchor" href="#104890"> ¶</a><div class="date" title="2011-07-14 02:42">13 years ago</div> <div class="text" id="Hcom104890"> <div class="phpcode"><code>Insert space after comma. If you have a form that stores results in a database field as comma separated values, when you display this data you can use the following to insert a space after each comma: <?php $find[] = ','; $replace[] = '&#44;&nbsp;'; $text = str_replace($find, $replace, $row_rsRecordset['Field']); print_r($text); ?> Notes: 1) To get round the Replacement Order Gotcha, the comma is also replaced with its code equivalent: &#44; 2) You can adapt the $replace section to suit your needs: swap out the &nbsp; code with or replace comma and space with &nbsp;&middot;&nbsp; etc.</code></div> </div> </div> <div class="note" id="122463"> <div class="votes"> <div id="Vu122463"> <a href="/manual/vote-note.php?id=122463&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd122463"> <a href="/manual/vote-note.php?id=122463&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V122463" title="50% like this..."> 0 </div> </div> <a href="#122463" class="name"> jefrey at forteras dot tech</a><a class="genanchor" href="#122463"> ¶</a><div class="date" title="2018-03-02 02:54">7 years ago</div> <div class="text" id="Hcom122463"> <div class="phpcode"><code>NEVER USE this function to protect against SQL Injection. It may sound ridiculous but I've seen a couple of developers doing so. It's interesting that these developers use str_replace (let's ignore the fact that they don't even use the str_ireplace which is case-insensitive) to remove common SQL commands such as "SELECT" or "DROP" from user-entered inputs. A funny thing to note is that: <?php $input = "SELSELECTECT"; echo str_replace("SELECT", null, $input); // = SELECT ?> Yeah you could loop it, but str_replace was never meant to be used this way. There are proper ways to protect against SQL Injections, such as using prepared statements (placeholders).</code></div> </div> </div> <div class="note" id="115625"> <div class="votes"> <div id="Vu115625"> <a href="/manual/vote-note.php?id=115625&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd115625"> <a href="/manual/vote-note.php?id=115625&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V115625" title="50% like this..."> 0 </div> </div> <a href="#115625" class="name"> markem at sim1 dot us</a><a class="genanchor" href="#115625"> ¶</a><div class="date" title="2014-08-27 08:04">10 years ago</div> <div class="text" id="Hcom115625"> <div class="phpcode"><code>I was working with MySQL and displaying the title to things on the web page. I'd written a script to ensure single and double quotes were removed from the title. I used $title = str_replace( "'", "", $title ); and $title = str_replace( '"', "", $title ); But still the single and double quotes continued. So I wrote a bit of code to print out each character separated by a dash. Like so: for( $i=0; $i<strlen($title); $i++ ){ echo "$i-"; } echo " \n"; This displayed: m-y-c-o-m-p-a-n-y- b-b-&-#-3-9-;-s Which made me go "Oh! I get it." The MySQL function real_escape_string modifies the single quotes to be &#39; and double quotes as &#34; These still show up as single and double quotes under HTML and most importantly - JAVASCRIPT sees the &#34; and &#39; as actual single or double quotes. So if you are passing arguments to a function you have to get rid of them or else you will get an error on trying to call a given function. Example: <a href="javascript:func1('mycompany bbs&#39;s")'"> becomes <a href="javascript:func1('mycompany bbs's');"> Which then will give you an error because there is a single quote inside of the single quoted string. HOWEVER, the $title = str_replace( "'", "", $title ); WILL NOT FIND a single quote. Instead, you have to do this: $title = str_replace( "&#39;", "'", $title ); and $title = str_relace( "&#34;", '"', $title ); (Or you could just get rid of them.) So remember! If you are trying to remove single and double quotes and are using MySQL and MySQL's real_escape_string() function that you might be having single and double quotes hanging around which are defined as &#39; and &#34; but which show up as single and double quotes as well as causing problems in your Javascripts.</code></div> </div> </div> <div class="note" id="119930"> <div class="votes"> <div id="Vu119930"> <a href="/manual/vote-note.php?id=119930&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd119930"> <a href="/manual/vote-note.php?id=119930&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V119930" title="48% like this..."> -1 </div> </div> <a href="#119930" class="name"> flame2000 at mail dot ru</a><a class="genanchor" href="#119930"> ¶</a><div class="date" title="2016-09-21 07:17">8 years ago</div> <div class="text" id="Hcom119930"> <div class="phpcode"><code>Replace chars in multi-byte string. In example, replacing 'f'=>'b', 'o'=>'e', 't'=>'r' and etc. <?php function mb_chars_replace($from, $to, $subj, $delSymb='_') { $nsubj=''; preg_match_all('/(.)/u', $subj, $subj);$subj=$subj[1]; if (!is_array($from)) {preg_match_all('/(.)/u', $from, $from);$from=$from[1];} if (!is_array($to)) {preg_match_all('/(.)/u', $to, $to);$to=$to[1];} if (count($from)!==count($to)) return false; foreach($subj as $s) { foreach($from as $k=>$f) { if($s===$f) { $s=$to[$k]; break; } } if($s!==$delSymb) $nsubj.=$s; } return $nsubj; } //examples: $from="fotber, "; $to="berfot+_"; // or $from=array("f","o","t","b","e","r",","," "); $to=array("b","e","r","f","o","t","+","_"); //out: echo mb_chars_replace($from,$to,"foot, beer"); //beer+foot ?></code></div> </div> </div> <div class="note" id="108134"> <div class="votes"> <div id="Vu108134"> <a href="/manual/vote-note.php?id=108134&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd108134"> <a href="/manual/vote-note.php?id=108134&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V108134" title="48% like this..."> -1 </div> </div> <a href="#108134" class="name"> cc at cc dot com</a><a class="genanchor" href="#108134"> ¶</a><div class="date" title="2012-03-31 05:26">12 years ago</div> <div class="text" id="Hcom108134"> <div class="phpcode"><code>I found a pretty low tech solution to avoid the "gotcha" without worrying about the array order of how things are replaced. I could not "order" the replacement array easily because it was being read from a database table. Anyway if you add an identifiable token to each replaced word, then just filter this out at the very end, no nested search terms are found. I just dynamically add the %% after the first char of each word before pumping it into the str_ireplace function. $find = array("as1", "as2", "as3", "flex"); $replace = array("<a href = \"#as1\">A%%uto S%%entry R%%ev. A%%</a>", "<a href = \"#as2\">A%%uto S%%entry E%%xp</a>", "<a href = \"#as3\">A%%uto S%%entry f%%lex</a>", "<a style = \"color: red;\" href = \"#flex\">f%%lex</a>"); $text = str_ireplace($find, $replace, $text); echo str_ireplace("%%", "", $text); In this case I am using %% as my token as this is an unlikely char combo for me.</code></div> </div> </div> <div class="note" id="108430"> <div class="votes"> <div id="Vu108430"> <a href="/manual/vote-note.php?id=108430&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd108430"> <a href="/manual/vote-note.php?id=108430&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V108430" title="47% like this..."> -2 </div> </div> <a href="#108430" class="name"> christof dot rieger at r-tron dot de</a><a class="genanchor" href="#108430"> ¶</a><div class="date" title="2012-04-25 08:41">12 years ago</div> <div class="text" id="Hcom108430"> <div class="phpcode"><code>In many countries the numeric format is 1.000,33 in english it is 1,000.33 This function converts numeric arguments always into the PHP confirm numeric format. If only one seperator is into the numericstring so it is interpreted as the decimalpoint. function dp($zahl) { if ((strpos($zahl,".") > "-1") | (strpos($zahl,",") > "-1")) { if ((strpos($zahl,".") > "-1") & (strpos($zahl,",") > "-1")) { if (strpos($zahl,".") > strpos($zahl,",")){ return str_replace(",","",$zahl); } else { return str_replace(",",".",str_replace(".","",$zahl)); } } else { if (strpos($zahl,".") > "-1") { if (strpos($zahl,".") == strrpos($zahl,".")) { return $zahl; } else { return str_replace(".","",$zahl); } } else { if (strpos($zahl,",") == strrpos($zahl,",")) { return str_replace(",",".",$zahl); } else { return str_replace(",","",$zahl); } } } } else { return $zahl; } }</code></div> </div> </div> <div class="note" id="116797"> <div class="votes"> <div id="Vu116797"> <a href="/manual/vote-note.php?id=116797&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd116797"> <a href="/manual/vote-note.php?id=116797&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V116797" title="46% like this..."> -2 </div> </div> <a href="#116797" class="name"> borasahin at gmail dot com</a><a class="genanchor" href="#116797"> ¶</a><div class="date" title="2015-03-02 08:59">10 years ago</div> <div class="text" id="Hcom116797"> <div class="phpcode"><code>jSON Turkish Characters Problem - (PHP < 5.4 for example) <?php function json_decode_tr($json){ $json_char = array("u00e7","u0131","u00fc","u011f","u00f6","u015f","u0130","u011e","u00dc","u00d6","u015e","u00c7"); $turkish = array("ç","ı","ü","ğ","ö","ş","İ","Ğ","Ü","Ö","Ş","Ç"); $result = str_replace($json_char, $turkish, $json); return json_decode($json); } ?></code></div> </div> </div> <div class="note" id="112749"> <div class="votes"> <div id="Vu112749"> <a href="/manual/vote-note.php?id=112749&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd112749"> <a href="/manual/vote-note.php?id=112749&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V112749" title="45% like this..."> -3 </div> </div> <a href="#112749" class="name"> Anonymous</a><a class="genanchor" href="#112749"> ¶</a><div class="date" title="2013-07-19 10:01">11 years ago</div> <div class="text" id="Hcom112749"> <div class="phpcode"><code>@moostende at gmail dot com If you want to remove all dashes but one from the string '-aaa----b-c-----d--e---f' resulting in '-aaa-b-c-d-e-f', you CAN use str_replace ! <?php function foo($str) { do { $str = str_replace("--", "-", $str, $count); } while ($count > 0); return $str; } echo foo("-aaa----b-c-----d--e---f"); ?> This outputs the following: -aaa-b-c-d-e-f</code></div> </div> </div> <div class="note" id="122751"> <div class="votes"> <div id="Vu122751"> <a href="/manual/vote-note.php?id=122751&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd122751"> <a href="/manual/vote-note.php?id=122751&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V122751" title="43% like this..."> -2 </div> </div> <a href="#122751" class="name"> ASchmidt at Anamera dot net</a><a class="genanchor" href="#122751"> ¶</a><div class="date" title="2018-05-20 04:22">6 years ago</div> <div class="text" id="Hcom122751"> <div class="phpcode"><code>Escaping strings with control characters, quotes and backslashes for subsequent use in MySQL commands. MySQL has documented a number of backslash escape sequences that need to be used to pass certain values in SQL commands: <a href="https://dev.mysql.com/doc/refman/5.7/en/string-literals.html" rel="nofollow" target="_blank">https://dev.mysql.com/doc/refman/5.7/en/string-literals.html</a> It's crucial to escape existing backslashes first to prevent double-escaping, before escaping the various control sequences: <?php $result = str_replace( array( '\\', "\0", "'", "\x8" /* BS */, "\n", "\r", "\t", "\x1A" /* Ctrl+Z */ ), array( '\\\\', '\\0', '\\\'', '\\b', '\\n', '\\r', '\\t', '\\Z' ), $value ); ?> This code is NOT intended to protect against SQL insertions, it's intended to PRESERVE string content correctly, if it contains control characters.</code></div> </div> </div> <div class="note" id="125165"> <div class="votes"> <div id="Vu125165"> <a href="/manual/vote-note.php?id=125165&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd125165"> <a href="/manual/vote-note.php?id=125165&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V125165" title="42% like this..."> -2 </div> </div> <a href="#125165" class="name"> hyperzlib at outlook dot com</a><a class="genanchor" href="#125165"> ¶</a><div class="date" title="2020-07-04 12:33">4 years ago</div> <div class="text" id="Hcom125165"> <div class="phpcode"><code>Use str_replace to remove all dashes but one from the string '-aaa----b-c-----d--e---f' (resulting is: '-aaa-b-c-d-e-f') <?php $challenge = '-aaa----b-c-----d--e---f'; do $challenge = str_replace('--', '-', $challenge, $count); while($count); echo $challenge; ?></code></div> </div> </div> <div class="note" id="97904"> <div class="votes"> <div id="Vu97904"> <a href="/manual/vote-note.php?id=97904&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd97904"> <a href="/manual/vote-note.php?id=97904&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V97904" title="38% like this..."> -4 </div> </div> <a href="#97904" class="name"> christian dot reinecke at web dot de</a><a class="genanchor" href="#97904"> ¶</a><div class="date" title="2010-05-14 12:06">14 years ago</div> <div class="text" id="Hcom97904"> <div class="phpcode"><code>If you need to replace a string in another, but only once but still in all possible combinations (f.e. to replace "a" with "x" in "aba" to get array("xba", "abx")) you can use this function: <?php function getSingleReplaceCombinations($replace, $with, $inHaystack) { $splits = explode($replace, $inHaystack); $result = array(); for ($i = 1, $ix = count($splits); $i < $ix; ++$i) { $previous = array_slice($splits, 0, $i); $next = array_slice($splits, $i); $combine = array_pop($previous) . $with . array_shift($next); $result[] = implode($replace, array_merge($previous, array($combine), $next)); } return $result; } var_dump(getSingleReplaceCombinations("a", "x", "aba")); // result as mentioned above ?> It may not be the best in performance, but it works.</code></div> </div> </div> <div class="note" id="121612"> <div class="votes"> <div id="Vu121612"> <a href="/manual/vote-note.php?id=121612&page=function.str-replace&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd121612"> <a href="/manual/vote-note.php?id=121612&page=function.str-replace&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V121612" title="35% like this..."> -5 </div> </div> <a href="#121612" class="name"> vuabid at hotmail dot com</a><a class="genanchor" href="#121612"> ¶</a><div class="date" title="2017-09-06 08:44">7 years ago</div> <div class="text" id="Hcom121612"> <div class="phpcode"><code>Consider this while using str_replace function when $search and $replace are arrays. $search = array( 'login_reactivate', 'login_reactivate_date' ); $replace = array( 'login reactivate status', 'login reactivate date' ); $subject = "fname, email, login_reactivate, login_reactivate_date"; $returnValue = str_replace( $search, $replace, $subject ); $returnValue will be: fname, email, login reactivate status, login reactivate status_date You can see we are expecting "login_reactivate_date" to be replaced with "login reactivate date" but it will replace to "login reactivate status_date"</code></div> </div> </div></div> <div class="foot"><a href="/manual/add-note.php?sect=function.str-replace&repo=en&redirect=https://www.php.net/manual/en/function.str-replace.php">＋add a note</a></div> </section> </section> <aside class='layout-menu'> <ul class='parent-menu-list'> <li> <a href="ref.strings.php">String Functions</a> <ul class='child-menu-list'> <li class=""> <a href="function.addcslashes.php" title="addcslashes">addcslashes</a> </li> <li class=""> <a href="function.addslashes.php" title="addslashes">addslashes</a> </li> <li class=""> <a href="function.bin2hex.php" title="bin2hex">bin2hex</a> </li> <li class=""> <a href="function.chop.php" title="chop">chop</a> </li> <li class=""> <a href="function.chr.php" title="chr">chr</a> </li> <li class=""> <a href="function.chunk-split.php" title="chunk_split">chunk_split</a> </li> <li class=""> <a href="function.convert-uudecode.php" title="convert_uudecode">convert_uudecode</a> </li> <li class=""> <a href="function.convert-uuencode.php" title="convert_uuencode">convert_uuencode</a> </li> <li class=""> <a href="function.count-chars.php" title="count_chars">count_chars</a> </li> <li class=""> <a href="function.crc32.php" title="crc32">crc32</a> </li> <li class=""> <a href="function.crypt.php" title="crypt">crypt</a> </li> <li class=""> <a href="function.echo.php" title="echo">echo</a> </li> <li class=""> <a href="function.explode.php" title="explode">explode</a> </li> <li class=""> <a href="function.fprintf.php" title="fprintf">fprintf</a> </li> <li class=""> <a href="function.get-html-translation-table.php" title="get_html_translation_table">get_html_translation_table</a> </li> <li class=""> <a href="function.hebrev.php" title="hebrev">hebrev</a> </li> <li class=""> <a href="function.hex2bin.php" title="hex2bin">hex2bin</a> </li> <li class=""> <a href="function.html-entity-decode.php" title="html_entity_decode">html_entity_decode</a> </li> <li class=""> <a href="function.htmlentities.php" title="htmlentities">htmlentities</a> </li> <li class=""> <a href="function.htmlspecialchars.php" title="htmlspecialchars">htmlspecialchars</a> </li> <li class=""> <a href="function.htmlspecialchars-decode.php" title="htmlspecialchars_decode">htmlspecialchars_decode</a> </li> <li class=""> <a href="function.implode.php" title="implode">implode</a> </li> <li class=""> <a href="function.join.php" title="join">join</a> </li> <li class=""> <a href="function.lcfirst.php" title="lcfirst">lcfirst</a> </li> <li class=""> <a href="function.levenshtein.php" title="levenshtein">levenshtein</a> </li> <li class=""> <a href="function.localeconv.php" title="localeconv">localeconv</a> </li> <li class=""> <a href="function.ltrim.php" title="ltrim">ltrim</a> </li> <li class=""> <a href="function.md5.php" title="md5">md5</a> </li> <li class=""> <a href="function.md5-file.php" title="md5_file">md5_file</a> </li> <li class=""> <a href="function.metaphone.php" title="metaphone">metaphone</a> </li> <li class=""> <a href="function.nl-langinfo.php" title="nl_langinfo">nl_langinfo</a> </li> <li class=""> <a href="function.nl2br.php" title="nl2br">nl2br</a> </li> <li class=""> <a href="function.number-format.php" title="number_format">number_format</a> </li> <li class=""> <a href="function.ord.php" title="ord">ord</a> </li> <li class=""> <a href="function.parse-str.php" title="parse_str">parse_str</a> </li> <li class=""> <a href="function.print.php" title="print">print</a> </li> <li class=""> <a href="function.printf.php" title="printf">printf</a> </li> <li class=""> <a href="function.quoted-printable-decode.php" title="quoted_printable_decode">quoted_printable_decode</a> </li> <li class=""> <a href="function.quoted-printable-encode.php" title="quoted_printable_encode">quoted_printable_encode</a> </li> <li class=""> <a href="function.quotemeta.php" title="quotemeta">quotemeta</a> </li> <li class=""> <a href="function.rtrim.php" title="rtrim">rtrim</a> </li> <li class=""> <a href="function.setlocale.php" title="setlocale">setlocale</a> </li> <li class=""> <a href="function.sha1.php" title="sha1">sha1</a> </li> <li class=""> <a href="function.sha1-file.php" title="sha1_file">sha1_file</a> </li> <li class=""> <a href="function.similar-text.php" title="similar_text">similar_text</a> </li> <li class=""> <a href="function.soundex.php" title="soundex">soundex</a> </li> <li class=""> <a href="function.sprintf.php" title="sprintf">sprintf</a> </li> <li class=""> <a href="function.sscanf.php" title="sscanf">sscanf</a> </li> <li class=""> <a href="function.str-contains.php" title="str_contains">str_contains</a> </li> <li class=""> <a href="function.str-decrement.php" title="str_decrement">str_decrement</a> </li> <li class=""> <a href="function.str-ends-with.php" title="str_ends_with">str_ends_with</a> </li> <li class=""> <a href="function.str-getcsv.php" title="str_getcsv">str_getcsv</a> </li> <li class=""> <a href="function.str-increment.php" title="str_increment">str_increment</a> </li> <li class=""> <a href="function.str-ireplace.php" title="str_ireplace">str_ireplace</a> </li> <li class=""> <a href="function.str-pad.php" title="str_pad">str_pad</a> </li> <li class=""> <a href="function.str-repeat.php" title="str_repeat">str_repeat</a> </li> <li class="current"> <a href="function.str-replace.php" title="str_replace">str_replace</a> </li> <li class=""> <a href="function.str-rot13.php" title="str_rot13">str_rot13</a> </li> <li class=""> <a href="function.str-shuffle.php" title="str_shuffle">str_shuffle</a> </li> <li class=""> <a href="function.str-split.php" title="str_split">str_split</a> </li> <li class=""> <a href="function.str-starts-with.php" title="str_starts_with">str_starts_with</a> </li> <li class=""> <a href="function.str-word-count.php" title="str_word_count">str_word_count</a> </li> <li class=""> <a href="function.strcasecmp.php" title="strcasecmp">strcasecmp</a> </li> <li class=""> <a href="function.strchr.php" title="strchr">strchr</a> </li> <li class=""> <a href="function.strcmp.php" title="strcmp">strcmp</a> </li> <li class=""> <a href="function.strcoll.php" title="strcoll">strcoll</a> </li> <li class=""> <a href="function.strcspn.php" title="strcspn">strcspn</a> </li> <li class=""> <a href="function.strip-tags.php" title="strip_tags">strip_tags</a> </li> <li class=""> <a href="function.stripcslashes.php" title="stripcslashes">stripcslashes</a> </li> <li class=""> <a href="function.stripos.php" title="stripos">stripos</a> </li> <li class=""> <a href="function.stripslashes.php" title="stripslashes">stripslashes</a> </li> <li class=""> <a href="function.stristr.php" title="stristr">stristr</a> </li> <li class=""> <a href="function.strlen.php" title="strlen">strlen</a> </li> <li class=""> <a href="function.strnatcasecmp.php" title="strnatcasecmp">strnatcasecmp</a> </li> <li class=""> <a href="function.strnatcmp.php" title="strnatcmp">strnatcmp</a> </li> <li class=""> <a href="function.strncasecmp.php" title="strncasecmp">strncasecmp</a> </li> <li class=""> <a href="function.strncmp.php" title="strncmp">strncmp</a> </li> <li class=""> <a href="function.strpbrk.php" title="strpbrk">strpbrk</a> </li> <li class=""> <a href="function.strpos.php" title="strpos">strpos</a> </li> <li class=""> <a href="function.strrchr.php" title="strrchr">strrchr</a> </li> <li class=""> <a href="function.strrev.php" title="strrev">strrev</a> </li> <li class=""> <a href="function.strripos.php" title="strripos">strripos</a> </li> <li class=""> <a href="function.strrpos.php" title="strrpos">strrpos</a> </li> <li class=""> <a href="function.strspn.php" title="strspn">strspn</a> </li> <li class=""> <a href="function.strstr.php" title="strstr">strstr</a> </li> <li class=""> <a href="function.strtok.php" title="strtok">strtok</a> </li> <li class=""> <a href="function.strtolower.php" title="strtolower">strtolower</a> </li> <li class=""> <a href="function.strtoupper.php" title="strtoupper">strtoupper</a> </li> <li class=""> <a href="function.strtr.php" title="strtr">strtr</a> </li> <li class=""> <a href="function.substr.php" title="substr">substr</a> </li> <li class=""> <a href="function.substr-compare.php" title="substr_compare">substr_compare</a> </li> <li class=""> <a href="function.substr-count.php" title="substr_count">substr_count</a> </li> <li class=""> <a href="function.substr-replace.php" title="substr_replace">substr_replace</a> </li> <li class=""> <a href="function.trim.php" title="trim">trim</a> </li> <li class=""> <a href="function.ucfirst.php" title="ucfirst">ucfirst</a> </li> <li class=""> <a href="function.ucwords.php" title="ucwords">ucwords</a> </li> <li class=""> <a href="function.vfprintf.php" title="vfprintf">vfprintf</a> </li> <li class=""> <a href="function.vprintf.php" title="vprintf">vprintf</a> </li> <li class=""> <a href="function.vsprintf.php" title="vsprintf">vsprintf</a> </li> <li class=""> <a href="function.wordwrap.php" title="wordwrap">wordwrap</a> </li> </ul> </li> <li> Deprecated <ul class="child-menu-list"> <li class=""> <a href="function.convert-cyr-string.php" title="convert_cyr_string">convert_cyr_string</a> </li> <li class=""> <a href="function.hebrevc.php" title="hebrevc">hebrevc</a> </li> <li class=""> <a href="function.money-format.php" title="money_format">money_format</a> </li> <li class=""> <a href="function.utf8-decode.php" title="utf8_decode">utf8_decode</a> </li> <li class=""> <a href="function.utf8-encode.php" title="utf8_encode">utf8_encode</a> </li> </ul> </li> </ul> </aside> </div> <footer> <div class="container footer-content"> <div class="row-fluid"> <ul class="footmenu"> <li><a href="/manual/en/copyright.php">Copyright © 2001-2025 The PHP Documentation Group</a></li> <li><a href="/my.php">My PHP.net</a></li> <li><a href="/contact.php">Contact</a></li> <li><a href="/sites.php">Other PHP.net sites</a></li> <li><a href="/privacy.php">Privacy policy</a></li> </ul> </div> </div> </footer> <script src="/cached.php?t=1731172202&f=/js/ext/jquery-3.6.0.min.js"></script> <script src="/cached.php?t=1723177202&f=/js/ext/FuzzySearch.min.js"></script> <script src="/cached.php?t=1707321815&f=/js/ext/mousetrap.min.js"></script> <script src="/cached.php?t=1707321815&f=/js/ext/jquery.scrollTo.min.js"></script> <script src="/cached.php?t=1738028401&f=/js/search.js"></script> <script src="/cached.php?t=1738742401&f=/js/common.js"></script> <script type="module" src="/cached.php?t=1741309802&f=/js/interactive-examples.js"></script> <a id="toTop" href="javascript:;"><img width="40" height="40" alt="To Top" src="/images/to-top@2x.png"></a> <div id="search-modal__backdrop" class="search-modal__backdrop"> <div role="dialog" aria-label="Search modal" id="search-modal" class="search-modal" > <div class="search-modal__header"> <div class="search-modal__form"> <div class="search-modal__input-icon">  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" > <circle cx="11" cy="11" r="8"></circle> <line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> </div> <input type="search" id="search-modal__input" class="search-modal__input" placeholder="Search docs" aria-label="Search docs" /> </div> <button aria-label="Close" class="search-modal__close">  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" > <path d="M19,6.41L17.59,5L12,10.59L6.41,5L5,6.41L10.59,12L5,17.59L6.41,19L12,13.41L17.59,19L19,17.59L13.41,12L19,6.41Z"/> </svg> </button> </div> <div role="listbox" aria-label="Search results" id="search-modal__results" class="search-modal__results" ></div> <div class="search-modal__helper-text"> <div> <kbd>↑</kbd> and <kbd>↓</kbd> to navigate • <kbd>Enter</kbd> to select • <kbd>Esc</kbd> to close </div> <div> Press <kbd>Enter</kbd> without selection to search using Google </div> </div> </div> </div> </body> </html>

CINXE.COM

PHP: str_replace - Manual