PHP: in_array - Manual

<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" lang="de"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>PHP: in_array - 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/de/function.in-array.php"> <link rel="shorturl" href="https://www.php.net/in-array"> <link rel="alternate" href="https://www.php.net/in-array" hreflang="x-default"> <link rel="contents" href="https://www.php.net/manual/de/index.php"> <link rel="index" href="https://www.php.net/manual/de/ref.array.php"> <link rel="prev" href="https://www.php.net/manual/de/function.extract.php"> <link rel="next" href="https://www.php.net/manual/de/function.key.php"> <link rel="alternate" href="https://www.php.net/manual/en/function.in-array.php" hreflang="en"> <link rel="alternate" href="https://www.php.net/manual/de/function.in-array.php" hreflang="de"> <link rel="alternate" href="https://www.php.net/manual/es/function.in-array.php" hreflang="es"> <link rel="alternate" href="https://www.php.net/manual/fr/function.in-array.php" hreflang="fr"> <link rel="alternate" href="https://www.php.net/manual/it/function.in-array.php" hreflang="it"> <link rel="alternate" href="https://www.php.net/manual/ja/function.in-array.php" hreflang="ja"> <link rel="alternate" href="https://www.php.net/manual/pt_BR/function.in-array.php" hreflang="pt_BR"> <link rel="alternate" href="https://www.php.net/manual/ru/function.in-array.php" hreflang="ru"> <link rel="alternate" href="https://www.php.net/manual/tr/function.in-array.php" hreflang="tr"> <link rel="alternate" href="https://www.php.net/manual/uk/function.in-array.php" hreflang="uk"> <link rel="alternate" href="https://www.php.net/manual/zh/function.in-array.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=1732428602&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/de/function.in-array.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#2024-12-09-1'>ConFoo 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.key.php"> key » </a> </div> <div class="prev"> <a href="function.extract.php"> « extract </a> </div> <ul> <li><a href='index.php'>PHP-Handbuch</a></li> <li><a href='funcref.php'>Funktionsreferenz</a></li> <li><a href='refs.basic.vartype.php'>Variablen- und typbezogene Erweiterungen</a></li> <li><a href='book.array.php'>Arrays</a></li> <li><a href='ref.array.php'>Array Funktionen</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.in-array.php'>English</option> <option value='de/function.in-array.php' selected="selected">German</option> <option value='es/function.in-array.php'>Spanish</option> <option value='fr/function.in-array.php'>French</option> <option value='it/function.in-array.php'>Italian</option> <option value='ja/function.in-array.php'>Japanese</option> <option value='pt_BR/function.in-array.php'>Brazilian Portuguese</option> <option value='ru/function.in-array.php'>Russian</option> <option value='tr/function.in-array.php'>Turkish</option> <option value='uk/function.in-array.php'>Ukrainian</option> <option value='zh/function.in-array.php'>Chinese (Simplified)</option> <option value='help-translate.php'>Other</option> </select> </fieldset> </form> </div> </div><div id="function.in-array" class="refentry"> <div class="refnamediv"> <h1 class="refname">in_array</h1> (PHP 4, PHP 5, PHP 7, PHP 8)in_array — Prüft, ob ein Wert in einem Array existiert </div> <div class="refsect1 description" id="refsect1-function.in-array-description"> <h3 class="title">Beschreibung</h3> <div class="methodsynopsis dc-description"> in_array(<a href="language.types.mixed.php" class="type mixed">mixed</a> <code class="parameter">$needle</code>, <a href="language.types.array.php" class="type array">array</a> <code class="parameter">$haystack</code>, <a href="language.types.boolean.php" class="type bool">bool</a> <code class="parameter">$strict</code> = <code><a href="reserved.constants.php#constant.false">false</a></code>): <a href="language.types.boolean.php" class="type bool">bool</a></div> Diese Funktion sucht in <code class="parameter">haystack</code> nach <code class="parameter">needle</code>. Wenn <code class="parameter">strict</code> gesetzt ist, wird dabei auch der Typ des Elements beachtet. </div> <div class="refsect1 parameters" id="refsect1-function.in-array-parameters"> <h3 class="title">Parameter-Liste</h3> <dl> <dt><code class="parameter">needle</code></dt> <dd> Der gesuchte Wert. <blockquote class="note">Hinweis: Ist <code class="parameter">needle</code> ein String, so wird bei der Suche die Groß- und Kleinschreibung beachtet. </blockquote> </dd> <dt><code class="parameter">haystack</code></dt> <dd> Das zu durchsuchende Array. </dd> <dt><code class="parameter">strict</code></dt> <dd> Wenn der dritte Parameter auf <code><a href="reserved.constants.php#constant.true">true</a></code> gesetzt wird, vergleicht in_array() nicht nur den Wert, sondern auch den <a href="language.types.php" class="link">Typ</a> des gesuchten Wertes <code class="parameter">needle</code> mit den Elementen des Arrays. <blockquote class="note">Hinweis: Vor PHP 8.0.0 passt ein <code class="parameter">needle</code>-Wert vom Typ <code class="literal">string</code> im nicht-strikten Modus auf einen Array-Wert von <code class="literal">0</code> und umgekehrt. Das kann zu unerwünschten Ergebnissen führen. Ähnliche Grenzfälle gibt es auch für andere Typen. Wenn nicht absolut sicher ist, um welche Art von Werten es sich handelt, sollte immer das Flag <code class="parameter">strict</code> verwendet werden, um ein unerwartetes Verhalten zu vermeiden. </blockquote> </dd> </dl> </div> <div class="refsect1 returnvalues" id="refsect1-function.in-array-returnvalues"> <h3 class="title">Rückgabewerte</h3> Gibt <code><a href="reserved.constants.php#constant.true">true</a></code> zurück wenn <code class="parameter">needle</code> im Array gefunden wird, sonst <code><a href="reserved.constants.php#constant.false">false</a></code>. </div> <div class="refsect1 examples" id="refsect1-function.in-array-examples"> <h3 class="title">Beispiele</h3> <div class="example" id="example-5159"> Beispiel #1 in_array()-Beispiel <div class="example-contents"> <div class="phpcode"><code><?php $os = array("Mac", "NT", "Irix", "Linux"); if (in_array("Irix", $os)) { echo "Irix enthalten"; } if (in_array("mac", $os)) { echo "mac enthalten"; } ?></code></div> </div> <div class="example-contents"> Der zweite Vergleich schlägt fehl, da in_array() Groß- und Kleinschreibung unterscheidet, die Ausgabe sieht daher so aus: </div> <div class="example-contents screen"> <div class="examplescode"><pre class="examplescode">Irix enthalten</pre> </div> </div> </div> <div class="example" id="example-5160"> Beispiel #2 in_array()-Beispiel mit 'strict' <div class="example-contents"> <div class="phpcode"><code><?php $a = array('1.10', 12.4, 1.13); if (in_array('12.4', $a, true)) { echo "'12.4' bei strenger Prüfung gefunden\n"; } if (in_array(1.13, $a, true)) { echo "1.13 Bei strenger Prüfung gefunden\n"; } ?></code></div> </div> <div class="example-contents">Das oben gezeigte Beispiel erzeugt folgende Ausgabe:</div> <div class="example-contents screen"> <div class="examplescode"><pre class="examplescode">1.13 bei strenger Prüfung gefunden</pre> </div> </div> </div> <div class="example" id="example-5161"> Beispiel #3 in_array() mit Array als Suchwert <div class="example-contents"> <div class="phpcode"><code><?php $a = array(array('p', 'h'), array('p', 'r'), 'o'); if (in_array(array('p', 'h'), $a)) { echo "'ph' gefunden\n"; } if (in_array(array('f', 'i'), $a)) { echo "'fi' gefunden\n"; } if (in_array('o', $a)) { echo "'o' gefunden\n"; } ?></code></div> </div> <div class="example-contents">Das oben gezeigte Beispiel erzeugt folgende Ausgabe:</div> <div class="example-contents screen"> <div class="examplescode"><pre class="examplescode">'ph' gefunden 'o' gefunden</pre> </div> </div> </div> </div> <div class="refsect1 seealso" id="refsect1-function.in-array-seealso"> <h3 class="title">Siehe auch</h3> <ul class="simplelist"> <li><a href="function.array-search.php" class="function" rel="rdfs-seeAlso">array_search()</a> - Durchsucht ein Array nach einem Wert und liefert bei Erfolg den zugehörigen Schlüssel</li> <li><a href="function.isset.php" class="function" rel="rdfs-seeAlso">isset()</a> - Prüft, ob eine Variable deklariert ist und sich von null unterscheidet</li> <li><a href="function.array-key-exists.php" class="function" rel="rdfs-seeAlso">array_key_exists()</a> - Prüft, ob ein gegebener Schlüssel in einem Array existiert</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-de/blob/master/reference/array/functions/in-array.xml">Submit a Pull Request</a> • <a href="https://github.com/php/doc-de/issues/new?body=From%20manual%20page:%20https:%2F%2Fphp.net%2Ffunction.in-array%0A%0A---">Report a Bug</a> </div> </div><section id="usernotes"> <div class="head"> <a href="/manual/add-note.php?sect=function.in-array&repo=de&redirect=https://www.php.net/manual/de/function.in-array.php">＋add a note</a> <h3 class="title">User Contributed Notes 6 notes</h3> </div><div id="allnotes"> <div class="note" id="106319"> <div class="votes"> <div id="Vu106319"> <a href="/manual/vote-note.php?id=106319&page=function.in-array&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd106319"> <a href="/manual/vote-note.php?id=106319&page=function.in-array&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V106319" title="78% like this..."> 414 </div> </div> <a href="#106319" class="name"> beingmrkenny at gmail dot com</a><a class="genanchor" href="#106319"> ¶</a><div class="date" title="2011-10-27 03:35">13 years ago</div> <div class="text" id="Hcom106319"> <div class="phpcode"><code>Loose checking returns some crazy, counter-intuitive results when used with certain arrays. It is completely correct behaviour, due to PHP's leniency on variable types, but in "real-life" is almost useless. The solution is to use the strict checking option. <?php // Example array $array = array( 'egg' => true, 'cheese' => false, 'hair' => 765, 'goblins' => null, 'ogres' => 'no ogres allowed in this array' ); // Loose checking -- return values are in comments // First three make sense, last four do not in_array(null, $array); // true in_array(false, $array); // true in_array(765, $array); // true in_array(763, $array); // true in_array('egg', $array); // true in_array('hhh', $array); // true in_array(array(), $array); // true // Strict checking in_array(null, $array, true); // true in_array(false, $array, true); // true in_array(765, $array, true); // true in_array(763, $array, true); // false in_array('egg', $array, true); // false in_array('hhh', $array, true); // false in_array(array(), $array, true); // false ?></code></div> </div> </div> <div class="note" id="128598"> <div class="votes"> <div id="Vu128598"> <a href="/manual/vote-note.php?id=128598&page=function.in-array&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd128598"> <a href="/manual/vote-note.php?id=128598&page=function.in-array&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V128598" title="57% like this..."> 3 </div> </div> <a href="#128598" class="name"> Julian Sawicki</a><a class="genanchor" href="#128598"> ¶</a><div class="date" title="2023-06-09 10:04">1 year ago</div> <div class="text" id="Hcom128598"> <div class="phpcode"><code>Here is a recursive in_array function: <?php $myNumbers = [ [1,2,3,4,5], [6,7,8,9,10], ]; $array = [ 'numbers' => $myNumbers ]; // Let's try to find number 7 within $array $hasNumber = in_array(7, $array, true); // bool(false) $hasNumber = in_array_recursive(7, $array, true); // bool(true) function in_array_recursive(mixed $needle, array $haystack, bool $strict): bool { foreach ($haystack as $element) { if ($element === $needle) { return true; } $isFound = false; if (is_array($element)) { $isFound = in_array_recursive($needle, $element, $strict); } if ($isFound === true) { return true; } } return false; }</code></div> </div> </div> <div class="note" id="88260"> <div class="votes"> <div id="Vu88260"> <a href="/manual/vote-note.php?id=88260&page=function.in-array&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd88260"> <a href="/manual/vote-note.php?id=88260&page=function.in-array&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V88260" title="57% like this..."> 11 </div> </div> <a href="#88260" class="name"> rhill at xenu-directory dot net</a><a class="genanchor" href="#88260"> ¶</a><div class="date" title="2009-01-17 01:05">15 years ago</div> <div class="text" id="Hcom88260"> <div class="phpcode"><code>I found out that in_array will *not* find an associative array within a haystack of associative arrays in strict mode if the keys were not generated in the *same order*: <?php $needle = array( 'fruit'=>'banana', 'vegetable'=>'carrot' ); $haystack = array( array('vegetable'=>'carrot', 'fruit'=>'banana'), array('fruit'=>'apple', 'vegetable'=>'celery') ); echo in_array($needle, $haystack, true) ? 'true' : 'false'; // Output is 'false' echo in_array($needle, $haystack) ? 'true' : 'false'; // Output is 'true' ?> I had wrongly assumed the order of the items in an associative array were irrelevant, regardless of whether 'strict' is TRUE or FALSE: The order is irrelevant *only* if not in strict mode.</code></div> </div> </div> <div class="note" id="127901"> <div class="votes"> <div id="Vu127901"> <a href="/manual/vote-note.php?id=127901&page=function.in-array&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd127901"> <a href="/manual/vote-note.php?id=127901&page=function.in-array&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V127901" title="54% like this..."> 3 </div> </div> <a href="#127901" class="name"> leonhard dot radonic+phpnet at gmail dot com</a><a class="genanchor" href="#127901"> ¶</a><div class="date" title="2022-11-08 10:26">2 years ago</div> <div class="text" id="Hcom127901"> <div class="phpcode"><code>I got an unexpected behavior working with in_array. I'm using following code: <?php // ... $someId = getSomeId(); // it gets generated/fetched by another service, so I don't know what value it will have. P.S.: it's an integer // The actual data in my edge-case scenario: // $someId = 0; // $anyArray = ['dataOne', 'dataTwo']; if (in_array($someId, $anyArray)) { // do some work } // ... ?> With PHP7.4, in_array returns boolean true. With PHP8.1, in_array returns boolean false. It took me quite some time to find out what's going on.</code></div> </div> </div> <div class="note" id="129889"> <div class="votes"> <div id="Vu129889"> <a href="/manual/vote-note.php?id=129889&page=function.in-array&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd129889"> <a href="/manual/vote-note.php?id=129889&page=function.in-array&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V129889" title="100% like this..."> 1 </div> </div> <a href="#129889" class="name"> eurorusty at yahoo dot ca</a><a class="genanchor" href="#129889"> ¶</a><div class="date" title="2024-11-27 06:23">13 days ago</div> <div class="text" id="Hcom129889"> <div class="phpcode"><code>I'm not sure why PHP doesn't provide a way to specify a binary search. Here's an example of the performance gains, for this array size, about 50x improvement using interpreted PHP. If built in, it could probably achieve around 1000x improvement, again for this array size. <?php // Set up sorted array $X = array(1); for ($j = 1; $j < 50000; ++$j) $X[] = $X[$j - 1] + rand(1, 6); // Using in_array $x = -microtime(true); $m = 0; for ($j = 0; $j < 10000; ++$j) $m += in_array(rand(1, 175000), $X); $x += microtime(true); echo $x.PHP_EOL; // Using binarySearch $x = -microtime(true); $m = 0; for ($j = 0; $j < 10000; ++$j) $m += binarySearch($X, rand(1, 175000)); $x += microtime(true); echo $x.PHP_EOL; function binarySearch($array, $value) { $low = 0; $high = count($array) - 1; while ($low <= $high) { $pivot = floor(($low + $high) / 2); if ($array[$pivot] == $value) return true; if ($value < $array[$pivot]) $high = $pivot - 1; else $low = $pivot + 1; } // No match return false; } /* Sample outputs, first is in_array, second is binarySearch 1.3544600009918 0.026464939117432 1.6158990859985 0.033976078033447 1.5184400081635 0.026461124420166 */</code></div> </div> </div> <div class="note" id="128220"> <div class="votes"> <div id="Vu128220"> <a href="/manual/vote-note.php?id=128220&page=function.in-array&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd128220"> <a href="/manual/vote-note.php?id=128220&page=function.in-array&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V128220" title="37% like this..."> -4 </div> </div> <a href="#128220" class="name"> Armands Rieksti</a><a class="genanchor" href="#128220"> ¶</a><div class="date" title="2023-02-14 10:45">1 year ago</div> <div class="text" id="Hcom128220"> <div class="phpcode"><code>I'd like to point out that, if you're using Enum data structures and want to compare whether an array of strings has a certain string Enum in it, you need to cast it to a string. From what I've tested, the function works correctly: if the array is filled with strings and you're searching for a string; if the array is filled with Enums and you're searching for an Enum.</code></div> </div> </div></div> <div class="foot"><a href="/manual/add-note.php?sect=function.in-array&repo=de&redirect=https://www.php.net/manual/de/function.in-array.php">＋add a note</a></div> </section> </section> <aside class='layout-menu'> <ul class='parent-menu-list'> <li> <a href="ref.array.php">Array Funktionen</a> <ul class='child-menu-list'> <li class=""> <a href="function.array.php" title="array">array</a> </li> <li class=""> <a href="function.array-all.php" title="array_all">array_all</a> </li> <li class=""> <a href="function.array-any.php" title="array_any">array_any</a> </li> <li class=""> <a href="function.array-change-key-case.php" title="array_change_key_case">array_change_key_case</a> </li> <li class=""> <a href="function.array-chunk.php" title="array_chunk">array_chunk</a> </li> <li class=""> <a href="function.array-column.php" title="array_column">array_column</a> </li> <li class=""> <a href="function.array-combine.php" title="array_combine">array_combine</a> </li> <li class=""> <a href="function.array-count-values.php" title="array_count_values">array_count_values</a> </li> <li class=""> <a href="function.array-diff.php" title="array_diff">array_diff</a> </li> <li class=""> <a href="function.array-diff-assoc.php" title="array_diff_assoc">array_diff_assoc</a> </li> <li class=""> <a href="function.array-diff-key.php" title="array_diff_key">array_diff_key</a> </li> <li class=""> <a href="function.array-diff-uassoc.php" title="array_diff_uassoc">array_diff_uassoc</a> </li> <li class=""> <a href="function.array-diff-ukey.php" title="array_diff_ukey">array_diff_ukey</a> </li> <li class=""> <a href="function.array-fill.php" title="array_fill">array_fill</a> </li> <li class=""> <a href="function.array-fill-keys.php" title="array_fill_keys">array_fill_keys</a> </li> <li class=""> <a href="function.array-filter.php" title="array_filter">array_filter</a> </li> <li class=""> <a href="function.array-find.php" title="array_find">array_find</a> </li> <li class=""> <a href="function.array-find-key.php" title="array_find_key">array_find_key</a> </li> <li class=""> <a href="function.array-flip.php" title="array_flip">array_flip</a> </li> <li class=""> <a href="function.array-intersect.php" title="array_intersect">array_intersect</a> </li> <li class=""> <a href="function.array-intersect-assoc.php" title="array_intersect_assoc">array_intersect_assoc</a> </li> <li class=""> <a href="function.array-intersect-key.php" title="array_intersect_key">array_intersect_key</a> </li> <li class=""> <a href="function.array-intersect-uassoc.php" title="array_intersect_uassoc">array_intersect_uassoc</a> </li> <li class=""> <a href="function.array-intersect-ukey.php" title="array_intersect_ukey">array_intersect_ukey</a> </li> <li class=""> <a href="function.array-is-list.php" title="array_is_list">array_is_list</a> </li> <li class=""> <a href="function.array-key-exists.php" title="array_key_exists">array_key_exists</a> </li> <li class=""> <a href="function.array-key-first.php" title="array_key_first">array_key_first</a> </li> <li class=""> <a href="function.array-key-last.php" title="array_key_last">array_key_last</a> </li> <li class=""> <a href="function.array-keys.php" title="array_keys">array_keys</a> </li> <li class=""> <a href="function.array-map.php" title="array_map">array_map</a> </li> <li class=""> <a href="function.array-merge.php" title="array_merge">array_merge</a> </li> <li class=""> <a href="function.array-merge-recursive.php" title="array_merge_recursive">array_merge_recursive</a> </li> <li class=""> <a href="function.array-multisort.php" title="array_multisort">array_multisort</a> </li> <li class=""> <a href="function.array-pad.php" title="array_pad">array_pad</a> </li> <li class=""> <a href="function.array-pop.php" title="array_pop">array_pop</a> </li> <li class=""> <a href="function.array-product.php" title="array_product">array_product</a> </li> <li class=""> <a href="function.array-push.php" title="array_push">array_push</a> </li> <li class=""> <a href="function.array-rand.php" title="array_rand">array_rand</a> </li> <li class=""> <a href="function.array-reduce.php" title="array_reduce">array_reduce</a> </li> <li class=""> <a href="function.array-replace.php" title="array_replace">array_replace</a> </li> <li class=""> <a href="function.array-replace-recursive.php" title="array_replace_recursive">array_replace_recursive</a> </li> <li class=""> <a href="function.array-reverse.php" title="array_reverse">array_reverse</a> </li> <li class=""> <a href="function.array-search.php" title="array_search">array_search</a> </li> <li class=""> <a href="function.array-shift.php" title="array_shift">array_shift</a> </li> <li class=""> <a href="function.array-slice.php" title="array_slice">array_slice</a> </li> <li class=""> <a href="function.array-splice.php" title="array_splice">array_splice</a> </li> <li class=""> <a href="function.array-sum.php" title="array_sum">array_sum</a> </li> <li class=""> <a href="function.array-udiff.php" title="array_udiff">array_udiff</a> </li> <li class=""> <a href="function.array-udiff-assoc.php" title="array_udiff_assoc">array_udiff_assoc</a> </li> <li class=""> <a href="function.array-udiff-uassoc.php" title="array_udiff_uassoc">array_udiff_uassoc</a> </li> <li class=""> <a href="function.array-uintersect.php" title="array_uintersect">array_uintersect</a> </li> <li class=""> <a href="function.array-uintersect-assoc.php" title="array_uintersect_assoc">array_uintersect_assoc</a> </li> <li class=""> <a href="function.array-uintersect-uassoc.php" title="array_uintersect_uassoc">array_uintersect_uassoc</a> </li> <li class=""> <a href="function.array-unique.php" title="array_unique">array_unique</a> </li> <li class=""> <a href="function.array-unshift.php" title="array_unshift">array_unshift</a> </li> <li class=""> <a href="function.array-values.php" title="array_values">array_values</a> </li> <li class=""> <a href="function.array-walk.php" title="array_walk">array_walk</a> </li> <li class=""> <a href="function.array-walk-recursive.php" title="array_walk_recursive">array_walk_recursive</a> </li> <li class=""> <a href="function.arsort.php" title="arsort">arsort</a> </li> <li class=""> <a href="function.asort.php" title="asort">asort</a> </li> <li class=""> <a href="function.compact.php" title="compact">compact</a> </li> <li class=""> <a href="function.count.php" title="count">count</a> </li> <li class=""> <a href="function.current.php" title="current">current</a> </li> <li class=""> <a href="function.end.php" title="end">end</a> </li> <li class=""> <a href="function.extract.php" title="extract">extract</a> </li> <li class="current"> <a href="function.in-array.php" title="in_array">in_array</a> </li> <li class=""> <a href="function.key.php" title="key">key</a> </li> <li class=""> <a href="function.key-exists.php" title="key_exists">key_exists</a> </li> <li class=""> <a href="function.krsort.php" title="krsort">krsort</a> </li> <li class=""> <a href="function.ksort.php" title="ksort">ksort</a> </li> <li class=""> <a href="function.list.php" title="list">list</a> </li> <li class=""> <a href="function.natcasesort.php" title="natcasesort">natcasesort</a> </li> <li class=""> <a href="function.natsort.php" title="natsort">natsort</a> </li> <li class=""> <a href="function.next.php" title="next">next</a> </li> <li class=""> <a href="function.pos.php" title="pos">pos</a> </li> <li class=""> <a href="function.prev.php" title="prev">prev</a> </li> <li class=""> <a href="function.range.php" title="range">range</a> </li> <li class=""> <a href="function.reset.php" title="reset">reset</a> </li> <li class=""> <a href="function.rsort.php" title="rsort">rsort</a> </li> <li class=""> <a href="function.shuffle.php" title="shuffle">shuffle</a> </li> <li class=""> <a href="function.sizeof.php" title="sizeof">sizeof</a> </li> <li class=""> <a href="function.sort.php" title="sort">sort</a> </li> <li class=""> <a href="function.uasort.php" title="uasort">uasort</a> </li> <li class=""> <a href="function.uksort.php" title="uksort">uksort</a> </li> <li class=""> <a href="function.usort.php" title="usort">usort</a> </li> </ul> </li> <li> Deprecated <ul class="child-menu-list"> <li class=""> <a href="function.each.php" title="each">each</a> </li> </ul> </li> </ul> </aside> </div> <footer> <div class="container footer-content"> <div class="row-fluid"> <ul class="footmenu"> <li><a href="/manual/de/copyright.php">Copyright © 2001-2024 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=1733296801&f=/js/search.js"></script> <script src="/cached.php?t=1732876201&f=/js/common.js"></script> <script type="module" src="/cached.php?t=1733276402&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: in_array - Manual