PHP 8.0 이상을 쓰다 보면 갑자기 마주하는 에러가 있다. 함수나 메서드에 정수를 넘겨야 하는데 문자열을 넘겼다거나, 배열을 기대했는데 객체를 전달했을 때 발생하는 TypeError다. 문제는 이 에러가 개발 중엔 잘 안 보이다가 프로덕션 환경에서 특정 사용자의 요청이 들어올 때만 터진다는 것이다.대부분의 개발자는 이 에러를 만나면 타입 힌트를 제거하거···
Stripe API로 결제를 연동했는데 Webhook 요청이 자꾸 거부되거나, 서명 검증에 실패해서 결제 완료 후 주문이 등록되지 않는 경험을 해봤을까. 다만 대부분의 개발자들은 Webhook의 정체, 왜 서명 검증이 필요한지, 그리고 구체적으로 어떻게 구현해야 하는지 정확히 모르고 인터넷에서 가져온 코드를 무작정 복사해 붙인다. 이번에는 Stripe We···
백엔드 API나 DB 연동 과정에서 전달받은 중첩 다차원 배열에서 특정 깊이의 키 값만 모아 추출할 때, 매번 foreach와 isset()을 지저분하게 중첩 사용해본 경험이 있을 것이다. 다만 PHP 기본 제공 함수만으로는 깊은 계층의 데이터(예: 'users.*.profile.name')나 객체가 혼합된 복잡한 구조를 깔끔하게 뽑아내기 어렵다는 문제가 ···
PHP 개발자라면 strtotime() 함수로 날짜 문자열을 Unix 타임스탬프로 변환하려다 예상과 다른 결과를 얻은 경험이 있을 것이다. "2024-01-15 14:30:00"을 파싱했는데 엉뚱한 값이 나오거나, 특정 날짜 형식에서는 아예 false가 반환되기도 한다. 다만 대부분의 개발자들은 왜 이런 일이 발생하는지 정확히 모른 채 그냥 date() 함···
검색엔진에 당신의 사이트 구조를 제대로 알려주지 못해 페이지가 색인되지 않는 경험을 했을까? 많은 개발자들이 콘텐츠만 잘 만들면 자동으로 검색 결과에 나타날 거라고 생각한다. 하지만 구글이나 네이버는 당신의 사이트 지도를 받아야 모든 페이지를 효율적으로 크롤링할 수 있다. XML 사이트맵은 검색엔진에게 당신의 웹사이트에 어떤 페이지들이 있는지, 언제 마지막···
서버에서 불시에 발생한 Fatal Error나 DB 연결 장애로 웹 서비스가 마비되었을 때, 고객 제보가 오기 전까지 까맣게 잊고 있던 경험이 한번쯤 있을 것이다.로그 파일에는 지속적으로 에러 기록이 쌓이지만, 실시간 알림 로직을 제대로 갖추지 못해 장애 초기 대응 타이밍을 놓치는 경우가 많다.이번에는 Discord Webhook API가 정확히 무엇인지,···
PHP 애플리케이션을 운영하다 보면 갑자기 'Fatal error: Allowed memory size of X bytes exhausted' 에러가 터진다. 서버는 멀쩡한데, 갑자기 메모리가 부족하다는 것. 대부분의 개발자는 단순히 php.ini의 memory_limit을 올리고 문제를 덮어버린다. 하지만 이건 근본 해결이 아니다. 이번에는 왜 메모리가 ···
대용량 파일 업로드 기능을 구현하고 서버에 테스트 파일인 10MB짜리 이미지를 전송했을 때 브라우저 화면에 '413 Request Entity Too Large' 에러가 발생하는 경험을 해봤을 것이다. 단순한 프론트엔드 유효성 검사 누락이나 파일 파싱 문제라고 생각하기 쉽다.다만 Nginx 웹 서버와 PHP-FPM 애플리케이션 간의 업로드 용량 제한 설정 ···
MySQL 5.7에서 8.0으로 버전을 올려서 최신 DB 환경을 구축했거나 Docker로 MySQL 인스턴스를 새로 띄운 뒤 PHP로 접속을 시도하다가 SQLSTATE[HY000] [2054] 에러를 마주친 적이 있을 것이다. DB 서버는 올바르게 동작하고 접속 정보도 분명 정확한데 PHP 스크립트를 실행하는 즉시 커넥션이 튕겨나간다.다만 정확한 원인이나 ···
사용자가 로그인한 상태에서 나도 모르게 비밀번호가 변경되거나 결제 요청이 승인되는 아찔한 보안 사고를 경험해봤을 것이다. 웹 서비스를 개발하다 보면 인증된 사용자의 권한을 악용하는 CSRF(Cross-Site Request Forgery) 공격을 쉽게 지나치는 경우가 많다. 다만 대부분의 개발자들은 CSRF 공격이 정확히 어떤 원리로 동작하는지 모르거나 단···
Google Firebase가 오랜 기간 사용되어 온 FCM Legacy HTTP API 지원을 중단하면서 기존 서버 키(Server Key) 기반의 푸시 알림 발송 방식이 작동하지 않는 문제를 겪어봤을 것이다. 웹 문서나 기존 블로그 글을 찾아보아도 예전 서버 키 방식을 안내하는 경우가 많아 대체 어떻게 전환해야 할지 막막할 수 있다.이번 글에서는 FCM···
배열에서 중복 값을 제거하려고 array_unique()를 썼는데, 예상과 다르게 중복이 남아있거나 필요한 값까지 사라져버린 경험이 있을까? 대부분의 개발자는 array_unique()가 단순히 '같은 값'을 찾아 제거하는 함수라고 생각하지만, 실제로는 타입 비교 방식에 따라 결과가 크게 달라진다. 이번에는 array_unique()가 정확히 뭔지, 왜 예···
배열에 요소를 추가하는 작업은 PHP에서 가장 기본이면서도 성능 차이가 나는 부분이다. 많은 개발자들이 array_push()와 직접 할당($arr[] = $value)을 구분 없이 사용하는데, 실제로는 상황에 따라 성능과 가독성이 크게 달라진다. 이번에는 두 방법의 정확한 차이, 언제 어떤 것을 써야 하는지, 그리고 실제 성능 테스트 결과까지 완벽하게 정···
PHP 개발 중 갑자기 나타나는 'Call to undefined method' 에러. 메서드를 분명히 정의했는데 왜 찾을 수 없다고 할까? 대부분의 개발자들은 이 에러가 단순한 오타나 함수 정의 누락 탓이라고 생각하고, 인터넷에서 찾은 코드를 그냥 복사해 붙인다. 하지만 실제 원인은 클래스 상속 구조, 인터페이스 구현, 네임스페이스, 트레이트 적용 과정에···
PHP에서 문자열을 자르는 작업은 일상적이다. 그런데 한글, 일본어, 중국어 같은 멀티바이트 문자를 다룰 때 substr()을 썼다가 문자가 깨지는 경험을 해봤을까? 대부분의 개발자는 이 문제가 왜 발생하는지, substr()과 mb_substr()의 정확한 차이가 뭔지 모른 채 인터넷에서 찾은 답을 그냥 적용한다. 이번에는 바이트 단위와 문자 단위의 차이···
웹 서비스를 운영하다 보면 동일한 콘텐츠가 여러 URL 경로로 접속되는 경우를 흔히 경험해봤을 것이다. 도메인 앞의 www 유무, HTTP와 HTTPS의 접속 혼용, 또는 쇼핑몰 상품 리스트의 정렬 파라미터(?sort=price_asc) 때문에 완전히 같은 내용의 페이지인데도 주소가 수십 개로 갈라지곤 한다. 문제는 검색엔진 크롤러가 이 주소들을 각각 서로···
지도 기반 서비스를 만들다 보면 주소를 좌표로 변환하거나, 두 지점 간의 거리를 계산해야 하는 상황이 자주 생긴다. 다만 대부분의 개발자들은 Google Maps Platform이 단순한 지도 표시 도구일 줄 알고, 실제로는 매우 강력한 Geocoding, Distance Matrix, Places 같은 API들이 있다는 걸 모르는 경우가 많다. 이번에는 ···
Slack을 업무 커뮤니케이션 도구로 쓰는 팀이라면, 자동화된 알림을 단순히 채널에 뿌리는 것보다 기존 메시지에 스레드로 답장하는 게 훨씬 깔끔하다. 하지만 대부분의 개발자들은 Slack API 문서를 읽어도 thread_ts라는 개념이 명확하지 않아서, 스레드 기능을 포기하고 그냥 일반 메시지만 보낸다. 이번에는 Slack API에서 스레드를 다루는 정확···
다차원 설정 배열이나 외부 API 응답 데이터를 병합할 때 PHP의 기본 함수인 array_merge_recursive()를 썼다가 기존 값이 덮어씌워지지 않고 원치 않게 배열로 감싸지는 이상한 현상을 경험해봤을 것이다.다만 왜 이런 동작이 발생하는지, 기본 함수만으로는 다차원 연관 배열의 깊은 병합(Deep Merge)을 제대로 처리할 수 없다는 사실을 ···
웹 서버에 접근할 때 사용자명과 비밀번호를 입력하는 팝업 창을 본 적 있을까. 그것이 HTTP Basic Authentication이다. 대부분의 개발자들은 이 방식이 웹 서버(Nginx, Apache) 설정에서만 가능하다고 생각해서, 애플리케이션 레벨에서 구현할 생각을 안 한다. 하지만 PHP 코드 내에서 직접 Basic Auth를 검증하고 제어할 수 있···