Pagination in Couchbase Server with N1QL and PHP

온우카 기드온은 수년간 웹 애플리케이션을 설계 및 코딩하고 복잡한 문제를 해결한 경험이 있는 프리랜서 풀 스택 개발자입니다. 그는 보안, 글쓰기, 새로운 기술에 대한 토론을 좋아합니다.

많은 수의 문서를 다루는 애플리케이션을 구축할 때는 페이지 매김을 사용하여 페이지별로 행을 가져오는 것이 중요합니다.

이 글에서는 N1QL과 PHP로 작업할 때 페이지 매김을 구현하는 방법을 보여드리겠습니다.

N1QL에 대해 조금 알아보기

Couchbase N1QL은 JSON용 SQL을 확장하는 선언적 쿼리 언어입니다. 네이티브 프레임워크 및 언어 통합, 유창한 API 또는 JDBC/ODBC 드라이버를 통해 데이터를 쿼리할 수 있습니다. N1QL은 개발자에게 데이터를 쿼리하고 조작할 수 있는 표현력이 풍부하고 강력하며 완벽한 언어를 제공합니다.

전제 조건

카우치베이스에 대한 기본 지식과 서버에 설정된 카우치베이스(카우치베이스 설치)
N1QL에 대한 기본 지식
PHP에 대한 기본 지식(모든 언어를 사용할 수 있으므로 선택 사항)
사용 가능한 카우치베이스 SDK(여기로 이동)

우리가 구축할 것

이 글에서는 기본적으로 데이터베이스에서 데이터를 가져와서 페이지 번호를 매기고 표시하는 PHP 환경을 빠르게 설정해 보겠습니다.

환경 설정

1단계: 새 버킷 만들기

Couchbase 관리 영역에 로그인하여 새 버킷 이름을 만듭니다. 댓글 달기.

2단계: 새 버킷에 대한 인덱스를 만듭니다: 댓글 달기

쿼리 탭을 클릭하고 아래에 나열된 쿼리를 입력한 후 실행을 클릭합니다.

create primary index on `commenting` using gsi;

1	create 기본 색인 on `댓글 달기` 사용 gsi;

모든 것이 순조롭게 진행되면 문서 작성을 시작해도 좋습니다.

3단계: 프로젝트 스타터 파일 복제하기

이 튜토리얼에서 사용할 파일의 기본 파일 구조를 만들었습니다.

명령줄을 열고 github에서 리포지토리를 복제합니다.

$ git clone git@github.com:dongido001/php-couchbase-pagination_complete.git

1	$ git 복제 git@github.com:dongido001/php-카우치베이스-페이지 매김 완료.git

이제 브라우저에서 방금 복제한 파일을 엽니다. 다음 페이지가 표시됩니다:

파일 구조

방금 복제한 리포지토리에는 3개의 PHP 파일이 포함되어 있습니다: config.php, db.php및 index.php.

그리고 config.php 파일은 데이터베이스의 정보를 정의하는 곳입니다:

<?php
//some configs
define("C_USERNAMAE", "Administrator");
define("C_PASSWORD", "password");
define("C_URL", "http://127.0.0.1:8091/"); //eg: localhost:8091
define("DEFAULT_BUCKET", "commenting");

<?php

//일부 구성

정의("C_USERNAMAE", "관리자");

정의("C_PASSWORD", "비밀번호");

정의("C_URL", "http://127.0.0.1:8091/"); //eg: localhost:8091

정의("기본_버킷", "댓글 달기");

에서 db.php를 클릭한 후 CouchBase에 연결하여 버킷을 열었으며, CouchBase 정보에 맞게 세부 정보를 변경해야 합니다.

<?php

$authenticator = new \Couchbase\ClassicAuthenticator();
$authenticator->cluster(C_USERNAMAE, C_PASSWORD);

$cluster = new \Couchbase\Cluster(C_URL);

$cluster->authenticate($authenticator);

$bucket = $cluster->openBucket(DEFAULT_BUCKET);

In the `index.php`, we have some PHP code at the top of the file and at the bottom, we also

<?php

$인증자 = new \카우치베이스\클래식 인증자();

$인증자->클러스터(C_USERNAMAE, C_PASSWORD);

$클러스터 = new \카우치베이스\클러스터(C_URL);

$클러스터->인증($인증자);

$버킷 = $클러스터->오픈버킷(DEFAULT_BUCKET);

In 의 `색인.php`, 우리 가지고 일부 PHP 코드 에서 의 top 의 의 파일 그리고 에서 의 하단, 우리 또한

HTML 코드가 있습니다.

//index.php

<?php

//include config details

require_once('config.php');

//include connection to the database.

require_once('db.php');

if( $_SERVER['REQUEST_METHOD'] == "POST"){

$uid = uniqid();

$comment = [

"_id"        => $uid,
"name"       => $_POST["name"],
"comment"    => $_POST["comment"],
"created_at" => date("Y-m-d H:i:s")
];

$bucket->insert($uid, $comment);

}

?>

...

//index.php

<?php

//설정 세부 정보 포함

require_once('config.php');

//데이터베이스에 대한 연결을 포함합니다.

require_once('db.php');

만약( $_SERVER['요청_방법'] == "POST"){

$uid = 유니키드();

$댓글 = [

"_id" => $uid,

"name" => $_POST["name"],

"댓글" => $_POST["댓글"],

"created_at" => 날짜("Y-m-d H:i:s")

];

$버킷->삽입($uid, $댓글);

}

...

두 파일을 포함했습니다, config.php 그리고 db.php 그런 다음 양식이 제출될 때 데이터베이스에 몇 가지 주석을 삽입하는 로직을 작성했습니다.

//index.php

...

<!DOCTYPE html>
<html lang="en">
<head>
<!-- Required meta tags -->
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">

<!-- Bootstrap CSS -->
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0-beta/css/bootstrap.min.css" integrity="sha384-/Y6pD6FV/Vv2HJnA6t+vslU6fwYXjCFtcEpHbNJ0lyAFsXTsjBbfaDjzALeQsN6M" crossorigin="anonymous">
</head>
<body>

<div class="container">

<div class="container" style="margin-left: auto; margin-right: auto; width: 400px;">
<h4 class="text-center">Add a comment</h4>

<form action="" method="POST">
<div class="form-group">
<label for="name">Name:</label>
<input type="text" class="form-control" name="name" required>
</div>

<div class="form-group">
<label for="comment">Comment:</label>
<textarea class="form-control" rows="5" name="comment" required> </textarea>
</div>

<button type="submit" class="btn btn-primary">Submit</button>
</form> <br />

<div >
<h4 class="text-center">Listing comments</h4>

</div>

<div id="pagination">

</div>

</div>

</div>

</body>
</html>

//index.php

...

<!DOCTYPE html>

<head>

<메타 문자셋="utf-8">

<메타 이름="뷰포트" 콘텐츠="너비=장치 너비, 초기 스케일=1, 맞춤 축소=아니오">

<링크 rel="스타일시트" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0-beta/css/bootstrap.min.css" 무결성="sha384-/Y6pD6FV/Vv2HJnA6t+vslU6fwYXjCFtcEpHbNJ0lyAFsXTsjBbfaDjzALeQsN6M" 크로스오리진="익명">

</head>

<body>

<양식 액션="" 메서드="POST">

<레이블 에 대한="name">이름:</레이블>

<입력 유형="text" 클래스="form-control" 이름="name" 필수>

</div>

<레이블 에 대한="댓글">댓글:</레이블>

<텍스트 영역 클래스="form-control" 행="5" 이름="댓글" 필수> </텍스트 영역>

</div>

<버튼 유형="제출" 클래스="btn btn-primary">제출하기</버튼>

</양식> <br />

<div >

</div>

</div>

</body>

</html>

HTML 코드는 댓글을 추가하고 나열할 수 있는 양식을 표시합니다.

이제 시작해 보겠습니다!

페이지에서 원하는 만큼 댓글을 추가합니다. 곧 해당 데이터에 페이지 번호를 매길 예정입니다.

데이터베이스에서 페이지 매김된 콘텐츠 가져오기

의 헤더 부분에 다음을 추가합니다. index.php 는 상단의 모든 PHP 코드 아래에 있습니다.

&nbsp;//Select all contentin our query 

$no_per_page = 4; //This is the number of Items we want per page

&nbsp;$current_page = (isset($_GET['page_id'])) ? $_GET['page_id'] : 1; //Gets the current page, if not set, default to page 1

$skip = ($current_page - 1) * $no_per_page; //Gets the total number of page we want to skip when making request. When we are on page one, We don't need to skip any Item.

$query = \Couchbase\N1qlQuery::fromString("SELECT * FROM `commenting` &nbsp;LIMIT $no_per_page OFFSET $skip");

$result = $bucket->query($query);

//count total number of result in the database

$total = $bucket->query(\Couchbase\N1qlQuery::fromString("SELECT COUNT(comment) total FROM `commenting`"));

$total = $total->rows[0]->total;

$number_of_pages = ceil( $total/$no_per_page ); //calculate number of pages

 //쿼리에서 모든 콘텐츠 선택

$no_per_page = 4; //페이지당 원하는 항목 수입니다.

 $현재_페이지 = (발행($_GET['page_id'])) ? $_GET['page_id'] : 1; //현재 페이지를 가져옵니다(설정되지 않은 경우 기본값은 1페이지).

$건너뛰기 = ($현재_페이지 - 1) * $no_per_page; //요청할 때 건너뛸 총 페이지 수를 가져옵니다. 1페이지에 있을 때는 어떤 항목도 건너뛸 필요가 없습니다.

$쿼리 = \카우치베이스\N1qlQuery::fromString("SELECT * FROM `commenting` LIMIT $no_per_page OFFSET $skip");

$결과 = $버킷->쿼리($쿼리);

//데이터베이스의 총 결과 수를 계산합니다.

$합계 = $버킷->쿼리(\카우치베이스\N1qlQuery::fromString("SELECT COUNT(comment) total FROM `commenting`"));

$합계 = $합계->행[0]->합계;

$number_of_pages = ceil( $합계/$no_per_페이지 ); //페이지 수 계산

위의 코드에 주석을 추가하여 각각의 기능을 설명했습니다. 여기에서는 LIMIT AND 오프셋 을 사용하여 각 쿼리가 반환해야 하는 결과의 수를 제한할 수 있었습니다. 오프셋은 현재 액세스 중인 페이지 번호에 따라 쿼리할 때 데이터의 양을 건너뛰는 데 사용되었습니다.

LIMIT: LIMIT 절은 SELECT가 결과 집합에서 반환할 수 있는 최대 개체 수를 지정합니다. 음수 값 또는 9223372036854775295(1 - 512의 결과)보다 큰 값은 LIMIT 0으로 간주됩니다.

오프셋: OFFSET 절은 건너뛸 개체 수를 지정합니다. LIMIT 절이 있는 경우 LIMIT보다 먼저 OFFSET이 적용됩니다. OFFSET 값은 음수가 아닌 정수여야 합니다.

쿼리 결과를 페이지에 채우기

아래 코드를 추가하여 index.php 이 태그 바로 뒤에 <h4 class="text-center">댓글 나열</h4> .

      <?php foreach( $result->rows as $comment ):?>
<div>
<div class="alert alert-success" role="alert">
<h5 class="alert-heading"> By: <?=$comment->commenting->name?>, Created At: <?=$comment->commenting->created_at?> </h5><br>
<p> <?=$comment->commenting->comment?></p>
<hr>
</div>

</div>
<?php endforeach; ?>

<?php foreach( 1TP4결과->행 as $댓글 ):?>

<div>

<h5 클래스="경고 제목"> 으로: <?=$댓글->댓글 달기->이름?>, 생성됨 에서: <?=$댓글->댓글 달기->created_at?> </h5><br>

<hr>

</div>

<?php endforeach; ?>

페이지 매김 링크 추가

이 HTML 태그 사이에 아래 코드를 추가합니다. <div id="pagination"> </div> 를 추가합니다.

    <nav aria-label="Page navigation example">
<ul class="pagination">
<?php for($i = 1; $i <= $number_of_pages; $i++): ?>
<li class="page-item"><a class="page-link" href="?page_id=<?=$i?>"><?=$i?></a></li>
<?php endfor; ?>
</ul>
</nav>

<탐색 아리아-레이블="페이지 탐색 예제">

<?php 에 대한($i = 1; $i <= $number_of_pages; $i++): ?>

<?php endfor; ?>

</ul>

</탐색>

여기서는 페이지의 페이지 수만 인쇄하고 있습니다.

예! 이제 페이지 매김이 작동합니다.

결론

이 글에서는 N1QL을 사용하여 페이지 매김을 구현하는 방법을 배웠습니다. 또한 오프셋 그리고 LIMIT 그리고 기본적으로 N1QL을 사용하여 Couchbase에서 쿼리를 실행하는 방법을 설명합니다. 전체 앱은 여기에서 다운로드할 수 있습니다: (git@github.com:dongido001/php-couchbase-pagination_complete.git)

읽어주셔서 감사합니다. 여러분의 의견이나 궁금한 점이 있으면 알려주세요.

이 게시물은 카우치베이스 커뮤니티 글쓰기 프로그램의 일부입니다.

Laura Czajkowski, 개발자 커뮤니티 관리자, Couchbase

Platform

Self-Managed

Services

Capabilities

Why Couchbase?

Migrate to Capella

By Use Case

By Industry

By Application Need

Popular Docs

By Developer Role

Quickstart

Resource Center

About

Partnerships

Our Services

Partners: Register a Deal

Ready to register a deal with Couchbase?

Marriott

모든 게시물

N1QL 및 PHP를 사용한 카우치베이스 서버의 페이지 매김

N1QL에 대해 조금 알아보기

전제 조건

우리가 구축할 것

파일 구조

결론

작성자

게시자 Laura Czajkowski, 개발자 커뮤니티 관리자, Couchbase

댓글 남기기 응답 취소