PHP fopen 함수 모드 및 사용법 가이드

• 목록
• 스크랩

그누보드 운영 및 PHP 파일 제어 시 필수적인 fopen 함수의 읽기·쓰기 모드 조합과 사용법을 확인합니다.

fopen 함수의 r+, w+, a+ 모드 차이점

PHP 파일 시스템 함수 fopen에서 읽기와 쓰기를 동시에 지원하는 조합 모드인 r+, w+, a+는 파일 존재 여부와 기존 내용의 유지 여부에 따라 다음과 같이 동작합니다.

모드별 상세 동작

• r+ (읽기/쓰기)
  • 조건: 존재하는 파일 대상
  • 동작: 파일을 읽기와 쓰기 모두 가능하도록 엽니다. 파일이 없을 경우 에러가 발생하며, 기존 내용을 지우거나 새 파일을 강제로 생성하지 않습니다. 파일 쓰기 권한이 없는 경우 fopen 호출 시 에러가 발생할 수 있으므로, 파일 시스템의 쓰기 권한(퍼미션)을 먼저 확인해야 합니다.
• w+ (새로운 파일 생성 및 읽기/쓰기)
  • 조건: 파일 존재 여부와 무관
  • 동작: 새로운 파일을 만듭니다. 같은 파일이 이미 존재하는 경우 기존 내용을 모두 지우고(0 길이로 잘라내기) 중복하여 쓰기 작업을 합니다.
• a+ (갱신 및 추가 쓰기)
  • 조건: 파일 존재 여부와 무관
  • 동작: 파일이 존재하면 갱신용으로 열고 파일 작업 위치를 끝으로 이동시킵니다. 파일이 없는 경우에는 새로운 파일을 생성하여 엽니다.

텍스트 모드와 2진 모드(b, t)의 조합 및 사용 방법

PHP 및 C 언어 계열의 fopen 함수를 사용할 때 기본 접근 모드(r, w, a, r+, w+, a+) 뒤에 데이터 형식을 지정하는 b 또는 t 속성을 조합하여 파일 입출력 방식을 세밀하게 제어할 수 있습니다.

모드별 의미

• b: 바이너리(Binary) 데이터 형식 입출력을 의미합니다. rb, wb 등으로 사용합니다.
• t: 텍스트(Text) 데이터 형식 입출력을 의미합니다. rt, wt 등으로 사용합니다.

조합 및 활용 규칙

• 기본 모드 문자 뒤에 b 또는 t를 붙여서 조합합니다. (예: rt, wb, at, r+t, wb+ 등)
• 텍스트 모드의 경우 't'는 생략이 가능하므로 단순히 r이나 w로만 지정해도 텍스트 모드로 동작할 수 있습니다.
• 주의: 텍스트 모드(t) 사용 시 운영체제에 따라 줄바꿈 문자(`

,

) 처리가 달라질 수 있습니다. 데이터의 형태를 그대로 유지해야 하는 파일(이미지, 압축 파일 등)은 반드시 바이너리 모드(b`)를 사용해야 합니다.

• r+t, r+b, w+t, w+b 등의 조합은 각각 rt+, rb+, wt+, wb+ 와 동일하게 취급됩니다.
• 텍스트용으로 파일을 읽기 전용으로 열고 싶다면 "rt"를 사용하고, 2진 데이터용 파일을 쓰기 가능으로 만들어 열려면 "wb"를 사용합니다. 기존 파일이 존재할 때 텍스트용으로 내용을 추가하려면 "at"을 사용할 수 있습니다.

상황별 fopen 모드 선택 가이드

• 내 상황: 기존 파일을 덮어쓰지 않고 읽기와 쓰기를 동시에 처리해야 할 때
  • 선택 기준: 파일이 반드시 존재해야 하며 기존 내용을 보존해야 하는 경우
  • 다음 행동: r+ 모드를 적용하여 파일을 열고 작업 포인터 위치를 조절합니다.
• 내 상황: 로그 파일처럼 기존 내용 뒤에 새로운 내용을 계속 덧붙여 기록해야 할 때
  • 선택 기준: 파일이 없으면 새로 만들고, 있으면 작업 위치를 항상 맨 끝으로 이동시켜야 하는 경우
  • 다음 행동: a 또는 a+ 모드를 사용하여 파일을 엽니다.

실전 FAQ

Q. fopen으로 파일을 열 때 'w'와 'w+' 모드는 기존 파일에 어떤 영향을 주나요?

• A: 두 모드 모두 파일이 존재할 경우 기존 내용을 모두 지우고(0 길이로 잘라내기) 새로 작성합니다. 기존 내용을 유지한 채 추가하거나 수정하려면 r+나 a+ 모드를 검토해야 합니다.

참고자료

기타 참고자료

• codedragon.tistory.com — fopen() & fclose() - 파일의 접근 모드 (r, w, a, r+, w+, a+), 파일 입출력 모드, 대표적인 표준 입출력 함수와 표준 파일…
• m.blog.naver.com — fopen, fopen_s에서 r, rb, rt의 차이점 : 네이버 블로그
• aniostudio.tistory.com — Anio Studio :: ● fopen() 함수에서 r+, w+ 모드의 차이 파일처리
• cyworld.tistory.com — fopen()의 r+와 w+의 차이
• sir.kr — 그누보드 설치 시 오류가 나면서 data 폴더 안에 파일 생성이 안됩니다. - SIR - 개발자 커뮤니티