{"id":1072,"date":"2021-04-12T16:03:07","date_gmt":"2021-04-12T16:03:07","guid":{"rendered":"https:\/\/phptutorial.net\/?page_id=1072"},"modified":"2025-04-07T13:47:43","modified_gmt":"2025-04-07T13:47:43","slug":"php-array_shift","status":"publish","type":"page","link":"https:\/\/www.phptutorial.net\/php-tutorial\/php-array_shift\/","title":{"rendered":"PHP array_shift"},"content":{"rendered":"\n<p><strong>Summary<\/strong>: in this tutorial, you will learn how to use the PHP <code>array_shift()<\/code> function to remove an element from the beginning of an array.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id='introduction-to-the-php-array_shift-function'>Introduction to the PHP array_shift function <a href=\"#introduction-to-the-php-array_shift-function\" class=\"anchor\" id=\"introduction-to-the-php-array_shift-function\" title=\"Anchor for Introduction to the PHP array_shift function\">#<\/a><\/h2>\n\n\n\n<p>The <code>array_shift()<\/code> function removes the first element from an <a href=\"https:\/\/phptutorial.net\/php-tutorial\/php-array\/\">array<\/a> and returns it.<\/p>\n\n\n\n<p>The following shows the syntax of the <code>array_shift()<\/code> function:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-1\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\">array_shift(<span class=\"hljs-keyword\">array<\/span> &amp;$array): mixed<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-1\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>In this syntax, the <code>$array<\/code> is the input array from which you want to remove the first element.<\/p>\n\n\n\n<p>If the <code>$array<\/code> is empty or is not an array, the <code>array_shift()<\/code> function returns <code>null<\/code>.<\/p>\n\n\n\n<p>Note that the <code>array_shift()<\/code> function changes the input array by shortening it by one element. It also modifies numerical array keys so that the first element in the modified array has a key starting from zero.<\/p>\n\n\n\n<p class=\"note\">To remove an element from the end of an array and return it, you use the <code><a href=\"https:\/\/phptutorial.net\/php-tutorial\/php-array_pop\/\">array_pop()<\/a><\/code> function.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id='php-array_shift-function-example'>PHP array_shift() function example <a href=\"#php-array_shift-function-example\" class=\"anchor\" id=\"php-array_shift-function-example\" title=\"Anchor for PHP array_shift() function example\">#<\/a><\/h2>\n\n\n\n<p>The following example uses the <code>array_shift()<\/code> function to remove the first element of an array:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-2\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\"><span class=\"hljs-meta\">&lt;?php<\/span>\n\n$numbers = &#91;<span class=\"hljs-number\">1<\/span>, <span class=\"hljs-number\">2<\/span>, <span class=\"hljs-number\">3<\/span>];\n\n$first_number = array_shift($numbers);\n\nprint_r($numbers);<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-2\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p><a href=\"https:\/\/phptutorial.net\/playground\/?q=PD9waHAKCiRudW1iZXJzID0gWzEsIDIsIDNdOwoKJGZpcnN0X251bWJlciA9IGFycmF5X3NoaWZ0KCRudW1iZXJzKTsKCnByaW50X3IoJG51bWJlcnMpOw\" target=\"_blank\" rel=\"noreferrer noopener\">Try it<\/a><\/p>\n\n\n\n<p>Output:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-3\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\"><span class=\"hljs-keyword\">Array<\/span>\n(\n    &#91;<span class=\"hljs-number\">0<\/span>] =&gt; <span class=\"hljs-number\">2<\/span>\n    &#91;<span class=\"hljs-number\">1<\/span>] =&gt; <span class=\"hljs-number\">3<\/span>\n)<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-3\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>How it works.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>First, define an array with three numbers 1, 2, and 3.<\/li>\n\n\n\n<li>Second, remove the first element of the <code>$numbers<\/code> array and assign it to the <code>$first_number<\/code> variable.<\/li>\n\n\n\n<li>Third, show the elements of the <code>$numbers<\/code> array.<\/li>\n<\/ul>\n\n\n\n<p>The output indicates that the number of elements of the <code>$numbers<\/code> array is 2 after the removal. Additionally, its index also changes.<\/p>\n\n\n\n<p>Since the <code>array_shift()<\/code> needs to reindex the array after removing the first element, the function will be pretty slow if the input array is large.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id='removing-elements-from-an-associative-array'>Removing elements from an associative array <a href=\"#removing-elements-from-an-associative-array\" class=\"anchor\" id=\"removing-elements-from-an-associative-array\" title=\"Anchor for Removing elements from an associative array\">#<\/a><\/h2>\n\n\n\n<p>The following example shows how to use the array_shift() function to remove the first element of an associative array:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-4\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\"><span class=\"hljs-meta\">&lt;?php<\/span>\n\n$scores = &#91;\n    <span class=\"hljs-string\">\"John\"<\/span> =&gt; <span class=\"hljs-string\">\"A\"<\/span>,\n    <span class=\"hljs-string\">\"Jane\"<\/span> =&gt; <span class=\"hljs-string\">\"B\"<\/span>,\n    <span class=\"hljs-string\">\"Alice\"<\/span> =&gt; <span class=\"hljs-string\">\"C\"<\/span>\n];\n\n$score = array_shift($scores);\n\n<span class=\"hljs-keyword\">echo<\/span> $score . <span class=\"hljs-string\">'&lt;br&gt;'<\/span>;\nprint_r($scores);<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-4\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p><a href=\"https:\/\/phptutorial.net\/playground\/?q=PD9waHAKCiRzY29yZXMgPSBbCiAgICAiSm9obiIgPT4gIkEiLAogICAgIkphbmUiID0-ICJCIiwKICAgICJBbGljZSIgPT4gIkMiCl07Cgokc2NvcmUgPSBhcnJheV9zaGlmdCgkc2NvcmVzKTsKCmVjaG8gJHNjb3JlIC4gJzxicj4nOwpwcmludF9yKCRzY29yZXMpOw\" target=\"_blank\" rel=\"noreferrer noopener\">Try it<\/a><\/p>\n\n\n\n<p>Output:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-5\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\">A\n<span class=\"hljs-keyword\">Array<\/span> ( &#91;Jane] =&gt; B &#91;Alice] =&gt; C )<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-5\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>In this example, the <code>array_shift()<\/code> function removes the first element of the <code>$scores<\/code> array and returns the value of the element, which is <code>\"A\"<\/code>. It also preserves the keys in the array. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id='summary'>Summary <a href=\"#summary\" class=\"anchor\" id=\"summary\" title=\"Anchor for Summary\">#<\/a><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Use the PHP <code>array_shift()<\/code> function to remove an array from the beginning of an array and return it.<\/li>\n<\/ul>\n<div class=\"helpful-block-content\" data-title=\"\">\n\t<header>\n\t\t<div class=\"wth-question\">Did you find this tutorial useful?<\/div>\n\t\t<div class=\"wth-thumbs\">\n\t\t\t<button\n\t\t\t\tdata-post=\"1072\"\n\t\t\t\tdata-post-url=\"https:\/\/www.phptutorial.net\/php-tutorial\/php-array_shift\/\"\n\t\t\t\tdata-post-title=\"PHP array_shift\"\n\t\t\t\tdata-response=\"1\"\n\t\t\t\tclass=\"wth-btn-rounded wth-yes-btn\"\n\t\t\t>\n\t\t\t\t<svg\n\t\t\t\t\txmlns=\"http:\/\/www.w3.org\/2000\/svg\"\n\t\t\t\t\tviewBox=\"0 0 24 24\"\n\t\t\t\t\tfill=\"none\"\n\t\t\t\t\tstroke=\"currentColor\"\n\t\t\t\t\tstroke-width=\"2\"\n\t\t\t\t\tstroke-linecap=\"round\"\n\t\t\t\t\tstroke-linejoin=\"round\"\n\t\t\t\t\tclass=\"feather feather-thumbs-up block w-full h-full\"\n\t\t\t\t>\n\t\t\t\t\t<path\n\t\t\t\t\t\td=\"M14 9V5a3 3 0 0 0-3-3l-4 9v11h11.28a2 2 0 0 0 2-1.7l1.38-9a2 2 0 0 0-2-2.3zM7 22H4a2 2 0 0 1-2-2v-7a2 2 0 0 1 2-2h3\"\n\t\t\t\t\t><\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t<span class=\"sr-only\"> Yes <\/span>\n\t\t\t<\/button>\n\n\t\t\t<button\n\t\t\t\tdata-response=\"0\"\n\t\t\t\tdata-post=\"1072\"\n\t\t\t\tdata-post-url=\"https:\/\/www.phptutorial.net\/php-tutorial\/php-array_shift\/\"\n\t\t\t\tdata-post-title=\"PHP array_shift\"\n\t\t\t\tclass=\"wth-btn-rounded wth-no-btn\"\n\t\t\t>\n\t\t\t\t<svg\n\t\t\t\t\txmlns=\"http:\/\/www.w3.org\/2000\/svg\"\n\t\t\t\t\tviewBox=\"0 0 24 24\"\n\t\t\t\t\tfill=\"none\"\n\t\t\t\t\tstroke=\"currentColor\"\n\t\t\t\t\tstroke-width=\"2\"\n\t\t\t\t\tstroke-linecap=\"round\"\n\t\t\t\t\tstroke-linejoin=\"round\"\n\t\t\t\t>\n\t\t\t\t\t<path\n\t\t\t\t\t\td=\"M10 15v4a3 3 0 0 0 3 3l4-9V2H5.72a2 2 0 0 0-2 1.7l-1.38 9a2 2 0 0 0 2 2.3zm7-13h2.67A2.31 2.31 0 0 1 22 4v7a2.31 2.31 0 0 1-2.33 2H17\"\n\t\t\t\t\t><\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t<span class=\"sr-only\"> No <\/span>\n\t\t\t<\/button>\n\t\t<\/div>\n\t<\/header>\n\n\t<div class=\"wth-form hidden\">\n\t\t<div class=\"wth-form-wrapper\">\n\t\t\t<div class=\"wth-title\"><\/div>\n\t\t\t\n\t\t\t<textarea class=\"wth-message\"><\/textarea>\n\n\t\t\t<button class=\"btn btn-primary wth-btn-submit\">Send<\/button>\n\t\t\t<button class=\"btn wth-btn-cancel\">Cancel<\/button>\n\t\t\n\t\t<\/div>\n\t<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>In this tutorial, you will learn how to use the PHP array_shift() function to remove an element from the beginning of an array.<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":15,"menu_order":48,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1072","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.phptutorial.net\/wp-json\/wp\/v2\/pages\/1072","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.phptutorial.net\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.phptutorial.net\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.phptutorial.net\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.phptutorial.net\/wp-json\/wp\/v2\/comments?post=1072"}],"version-history":[{"count":5,"href":"https:\/\/www.phptutorial.net\/wp-json\/wp\/v2\/pages\/1072\/revisions"}],"predecessor-version":[{"id":3277,"href":"https:\/\/www.phptutorial.net\/wp-json\/wp\/v2\/pages\/1072\/revisions\/3277"}],"up":[{"embeddable":true,"href":"https:\/\/www.phptutorial.net\/wp-json\/wp\/v2\/pages\/15"}],"wp:attachment":[{"href":"https:\/\/www.phptutorial.net\/wp-json\/wp\/v2\/media?parent=1072"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}