쿼리 문자열은 링크에서 물음표 뒤의 쿼리 문을 나타냅니다. 형식은 키=값입니다. 여러 쿼리 문은 & 기호로 구분됩니다. add_query_arg() 함수는 하나 이상의 쿼리 문을 링크에 추가하는 데 도움이 될 수 있도록 WordPress에서 제공하는 편리한 함수입니다.
어떤 사람들은 링크 바로 뒤에 쿼리 문자열을 직접 추가할 수는 없냐고 물을 수도 있습니다. 이것은 때때로 작동하지만 링크 자체에 쿼리 문자열이 있으면 형식 오류가 발생하고 PHP 작성 및 관리에 도움이 되지 않습니다. add_query_arg() 함수는 필요한 Just만 제공하면 됩니다. 쿼리 문자열과 하나 이상의 키 값 및 키 이름에 대한 링크를 추가합니다.
사용방법
add_query_arg( $key, $value, $old_query_or_uri ); add_query_arg( $query, $old_query_or_uri );
매개변수
add_query_arg()에는 두 가지 사용법이 있습니다. 첫 번째 사용법에는 세 개의 매개변수가 필요합니다.
$키
(정수 | 문자열) (필수) 추가할 매개변수의 키값은 배열처럼 문자열이면 이름, 숫자이면 N번째 매개변수를 선택합니다.
기본값: 없음
$값
(혼합) (필수) 추가할 값입니다.
기본값: 없음
$old_query_or_uri
(문자열) (선택 사항) 처리할 링크입니다.
기본값: False, $_SERVER['REQUEST_URI']에 False를 씁니다.
두 번째 사용법에는 배열을 사용하여 링크에 추가할 쿼리 문자열을 전달하는 두 개의 매개변수가 필요합니다.
$쿼리
(배열) (필수) 키 값 및 키 이름에 해당하는 추가할 쿼리입니다.
기본값: 없음
$old_query_or_uri
(문자열) (선택 사항) 처리할 링크입니다.
기본값: False, $_SERVER['REQUEST_URI']에 False를 씁니다.
반환값
(문자열) 쿼리 문자열에 링크를 추가합니다.
예
첫 번째 사용:
echo add_query_arg( 'id', 123, 'http://www.jb51.net' );
두 번째 사용법:
echo add_query_arg( array( 'id' => 123 ), 'http://www.jb51.net' );
둘 다 결과는 http://www.jb51.net?id=123
기타 특수 상황:
echo add_query_arg( array( 'id' => 123 ), 'http://www.jb51.net?query=post' );//http://www.jb51.net?query=post&id=123 echo add_query_arg( array( 'id' => 123, 'cat' => 'themes' ), 'http://www.jb51.net?query=post' );//http://www.jb51.net?query=post&id=123&cat=themes echo add_query_arg( array( 'id' => 123, 'cat' => 'themes', 'query' => 'page' ), 'http://www.jb51.net?query=post' );//http://www.jb51.net?query=page&id=123&cat=themes
예
이 기능은 wp-includes/functions.php에 있습니다