Edit Report a Bug

    strtolower

    (PHP 4, PHP 5, PHP 7, PHP 8)

    strtolower — Converte uma string para minúsculas

    Descrição

    strtolower(string $string): string

    Retorna uma string com todos os caracteres alfabéticos ASCII convertidos para minúsculas.

    Bytes na faixa "A" (0x41) a "Z" (0x5a) serão convertidos para a letra minúscula correspondente pela adição de 32 a cada valor de byte.

    Esta função pode ser usada para converter caracteres ASCII em string codificadas com UTF-8, já que os caracteres multibyte UTF-8 serão ignorados. Para converter caracteres multibyte não-ASCII, use mb_strtolower().

    Parâmetros

    string

    A string de entrada.

    Valor Retornado

    Retorna a string minúscula.

    Registro de Alterações

    Versão Descrição
    8.2.0 A conversão de maiúsculas e minúsculas não depende mais da localidade definida com setlocale(). Somente caracteres ASCII serão convertidos.

    Exemplos

    Exemplo #1 Exemplo de strtolower()

    <?php
    $str     = "Mary Had A Little Lamb and She LOVED It So";
    $str = strtolower($str);
    echo     $str; // Prints mary had a little lamb and she loved it so
    ?>

    Notas

    Nota: Esta função é compatível com dados binários.

    Veja Também

    add a note add a note

    User Contributed Notes 16 notes

    up
    113
    marcin at maydesign dot pl
    14 years ago
    strtolower(); doesn't work for polish chars

    <?php strtolower("mĄkA"); ?>
    will return: mĄka;

    the best solution - use mb_strtolower()

    <?php mb_strtolower("mĄkA",'UTF-8'); ?>
    will return: mąka
    up
    35
    coder at bulgaria dot bg
    15 years ago
    for cyrillic and UTF 8 use  mb_convert_case

    exampel

    <?php
    $string     = "Австралия";
    $string = mb_convert_case($string, MB_CASE_LOWER, "UTF-8");
    echo     $string;

    //output is: австралия
    ?>
    up
    24
    helvete at bahno dot net
    9 years ago
    It is worth noting that
    <?php
    var_dump    (strtolower(null))
    ?>
    returns:
    string(0) ""
    up
    11
    dbers26 at gmail dot com
    15 years ago
    the function  arraytolower will create duplicate entries since keys are case sensitive. 

    <?php
    $array     = array('test1' => 'asgAFasDAAd', 'TEST2' => 'ASddhshsDGb', 'TeSt3 '=> 'asdasda@asdadadASDASDgh');

    $array = arraytolower($array);
    ?>
    /*
    Array
    (
        [test1] => asgafasdaad
        [TEST2] => ASddhshsDGb
        [TeSt3] => asdasda@asdadadASDASDgh
        [test2] => asddhshsdgb
        [test3] => asdasda@asdadadasdasdgh
    )
    */

    I prefer this method

    <?php
          function arraytolower($array, $include_leys=false) {
       
        if(    $include_leys) {
          foreach(    $array as $key => $value) {
            if(    is_array($value))
                  $array2[strtolower($key)] = arraytolower($value, $include_leys);
            else
                  $array2[strtolower($key)] = strtolower($value);
          }
              $array = $array2;
        }
        else {
          foreach(    $array as $key => $value) {
            if(    is_array($value))
                  $array[$key] = arraytolower($value, $include_leys);
            else
                  $array[$key] = strtolower($value);  
          }
        }
       
        return     $array;
      }
    ?>

    which when used like this

    <?php
    $array     = $array = array('test1' => 'asgAFasDAAd', 'TEST2' => 'ASddhshsDGb', 'TeSt3 '=> 'asdasda@asdadadASDASDgh');

    $array1 = arraytolower($array);
    $array2 = arraytolower($array,true);

    print_r($array1);
    print_r($array2);
    ?>

    will give output of

    Array
    (
        [test1] => asgafasdaad
        [TEST2] => asddhshsdgb
        [TeSt3] => asdasda@asdadadasdasdgh
    )
    Array
    (
        [test1] => asgafasdaad
        [test2] => asddhshsdgb
        [test3] => asdasda@asdadadasdasdgh
    )
    up
    5
    patricia at steuerungb dot de
    17 years ago
    When you're not sure, how the current locale is set, you might find the following function useful. It's strtolower for utf8-formatted text:

    <?php
    function strtolower_utf8($inputString) {
            $outputString    = utf8_decode($inputString);
            $outputString    = strtolower($outputString);
            $outputString    = utf8_encode($outputString);
        return     $outputString;
    }
    ?>

    It's not suitable for every occasion, but it surely gets in handy. I use it for lowering German 'Umlauts' like ä and ö.
    up
    2
    rok dot kralj at gmail dot com
    17 years ago
    Slovenian characters

    <?php
            function strtolower_slovenian($string)
        {
                $low=array("Č" => "č", "Ž" => "ž", "Š" => "š");
            return     strtolower(strtr($string,$low));
        }

    ?>
    up
    3
    rodrigoATsistemasparainternetDOTcomDOTbr
    16 years ago
    <?php
    function fullLower($str){
           // convert to entities
           $subject = htmlentities($str,ENT_QUOTES);
           $pattern = '/&([a-z])(uml|acute|circ';
           $pattern.= '|tilde|ring|elig|grave|slash|horn|cedil|th);/e';
           $replace = "'&'.strtolower('\\1').'\\2'.';'";
           $result = preg_replace($pattern, $replace, $subject);
           // convert from entities back to characters
           $htmltable = get_html_translation_table(HTML_ENTITIES);
       foreach(    $htmltable as $key => $value) {
              $result = ereg_replace(addslashes($value),$key,$result);
       }
       return(    strtolower($result));
    }

    echo     fullLower("Ã É Ò Õ ÚÙÛ");

    //results ã é ò õ úùû
    //adapted from fullUpper on strtoupper manual
    ?>
    up
    0
    marco at recchiuti dot it
    17 years ago
    Maybe it is not so elegant, but it Works.
    It's just a fast Idea and it is what I need.
    Any hacks for other characters (link !, ? etc etc) should help.

    function RemoveShouting($string)
    {
         $frase = "";   
         $astri = explode(".", $string);
         foreach ($astri as $elem)
        $frase .= " ".ucfirst(trim(strtolower($elem))).". ";
          
        return trim($frase);
    }

    Cheers!
    M
    up
    0
    mhuggins57 at yahoo dot com
    19 years ago
    There's a ucfirst "function" to make the first character uppercase, but there's no "lcfirst" function to make the first character lowercase.  Here's my own code to accomplish this.

    <?
    function lcfirst($str) {
        return     strtolower(substr($str, 0, 1)) . substr($str, 1);
    }
    ?>

    I found this particularly useful for generating XML nodes with the Reflection class.
    up
    0
    bkimble at ebaseweb dot com
    21 years ago
    Heres a small function I wrote to stop people from submitting data that is ALL IN CAPS SO THEY CAN GET MORE ATTENTION THAT THE REST OF THE USER SUBMITTED DATA on my website :) If you can make it better, by all means do so. This function splits up words delimited by a space, and makes only the first letter of each word capitalized. You can easily modify it so it's only the very first word of the string. I've also added some exceptions so you don't make things like roman numerals look like "Iii" or "Xcmii" or something.

    function RemoveShouting($string)
    {
    $lower_exceptions = array(
            "to" => "1", "a" => "1", "the" => "1", "of" => "1"
    );

    $higher_exceptions = array( 
            "I" => "1", "II" => "1", "III" => "1", "IV" => "1", 
            "V" => "1", "VI" => "1", "VII" => "1", "VIII" => "1",
            "XI" => "1", "X" => "1"
    );

    $words = split(" ", $string);
    $newwords = array();
    foreach ($words as $word)
    {
      if (!$higher_exceptions[$word]) $word = strtolower($word);
      if (!$lower_exceptions[$word]) $word[0] = strtoupper($word[0]);
      array_push($newwords, $word);
    }
    return join(" ", $newwords);
    }

    BK
    up
    -1
    Patrick
    18 years ago
    If you're considering using the below unhtmlentities function from phpContrib, I would suggest this one as an alternative:

    <?php
    function unhtmlentities($string)
    {
           // replace numeric entities
           $string = preg_replace('~&#x([0-9a-f]+);~ei', 'chr(hexdec("\\1"))', $string);
           $string = preg_replace('~&#([0-9]+);~e', 'chr(\\1)', $string);
           // replace literal entities
           $trans_tbl = get_html_translation_table(HTML_ENTITIES);
           $trans_tbl = array_flip($trans_tbl);
       return     strtr($string, $trans_tbl);
    }
    ?>

    That was copied exactly from the html_entity_decode manual page.  It'll handle numeric entities correctly, the below function won't.
    up
    -2
    RCube
    13 years ago
    To convert an entire array to lower, I prefer this method;

    <?php
    function arraytolower(array $array, $round = 0){
      return     unserialize(strtolower(serialize($array)));
    }
    ?>

    3 lines of code seem a lot less overhead than 10-40.
    If there's any intrinsic problem with this method, please post it.
    up
    -6
    leha_grobov
    15 years ago
    the strtolower version to support most amount of languages including russian, french and so on:

    <?php
    function strtolower_utf8($string){
          $convert_to = array(
            "a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u",
            "v", "w", "x", "y", "z", "à", "á", "â", "ã", "ä", "å", "æ", "ç", "è", "é", "ê", "ë", "ì", "í", "î", "ï",
            "ð", "ñ", "ò", "ó", "ô", "õ", "ö", "ø", "ù", "ú", "û", "ü", "ý", "а", "б", "в", "г", "д", "е", "ё", "ж",
            "з", "и", "й", "к", "л", "м", "н", "о", "п", "р", "с", "т", "у", "ф", "х", "ц", "ч", "ш", "щ", "ъ", "ы",
            "ь", "э", "ю", "я"
          );
          $convert_from = array(
            "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U",
            "V", "W", "X", "Y", "Z", "À", "Á", "Â", "Ã", "Ä", "Å", "Æ", "Ç", "È", "É", "Ê", "Ë", "Ì", "Í", "Î", "Ï",
            "Ð", "Ñ", "Ò", "Ó", "Ô", "Õ", "Ö", "Ø", "Ù", "Ú", "Û", "Ü", "Ý", "А", "Б", "В", "Г", "Д", "Е", "Ё", "Ж",
            "З", "И", "Й", "К", "Л", "М", "Н", "О", "П", "Р", "С", "Т", "У", "Ф", "Х", "Ц", "Ч", "Ш", "Щ", "Ъ", "Ъ",
            "Ь", "Э", "Ю", "Я"
          );

      return     str_replace($convert_from, $convert_to, $string);
    }
    ?>
    up
    -5
    kmcdermott at perimeterinstitute dot ca
    19 years ago
    To do case insensitive comparisons in a database, strtolower() can be a quick and dirty solution:

    $Sql = "SELECT * FROM tablename WHERE LOWER(column_name) = '".strtolower($my_var)."'";
    up
    -11
    spiceee ddotty spiceee com
    18 years ago
    If you ever need to strtolower a string with href tags on it and doesn't want to mess with the characters inside a tag, this is for you.

    <?php

    function loweroutsidetags ($str) {
            $chars = preg_split ("//", $str);
            $tolower = true;
            $str = '';

        foreach (    $chars as $k) {
            if (    $k == '<') { $tolower = false; }
            if (    $tolower) { $k = strtolower ($k); }
                $str .= $k;   
            if (    $k == '>') { $tolower = true; }
        }
        return     $str;
    }

    ?>

    this:
    echo loweroutsidetags('aALalala <a href="?q=CASEsENSITIVINESSinURLSareSTUPID">')

    will give:
    aalalala <a href="?q=CASEsENSITIVINESSinURLSareSTUPID">
    up
    -12
    Daniel Klein
    8 years ago
    When the locale is set to "utf8" or "C" I can't get strtolower() to convert accented characters encoded as UTF-8, so here is my workaround.

    <?php
    function tolower($string) {
      if (    $old_locale = setlocale(LC_CTYPE, 0)) {
            // 'fr_FR.ISO-8859-1' for *nix, 'French_France.1252' fallback for Windows
            if ($newlocale = setlocale(LC_CTYPE, 'fr_FR.ISO-8859-1', 'French_France.1252')) {
              preg_match('/\.(?<encoding>.+)$/', $newlocale, $match);
              $string = utf8_encode(strtolower(utf8_decode($string)));
        }
            setlocale(LC_CTYPE, $old_locale);
      }
      return     $string;
    }

    print(    tolower('DÉJÀ-VU'));  // prints déjà-vu
    ?>

    Change the language-country codes if you want some language other than French.
    add a note add a note
    To Top