Subscribe to PHP Freaks RSS

507 Insufficient Storage

syndicated from planet-php.net on August 20, 2019

507 Insufficient Storage is a status code that’s introduced by the WebDAV, specification. It allows a HTTP server to tell a client that for example their PUT or POST operation couldn’t succeed, maybe because it’s too large to fit on a disk.



Even though it was written for WebDAV, it can be used outside of WebDAV servers though.



Example:



HTTP/1.1 507 Insufficient Storage
Content-Type: text/plain

Wow, that's a big file. Can you store it somewhere else? We're pretty cramped
here.


Many WebDAV clients handle this status pretty well, and will inform the user that a disk is full.



Should I use this?



Even though I think this status is applicable outside of WebDAV, I think the reality is that the usefulness of this status is somewhat limited.



Because 507 is specifically a server-side error, it kind of indicates that the error was server side. Maybe the disk being full was not by design or intentional.



When using a status like this for REST API’s, I feel that it’s probably more likely that you’ll want to return an error when a user ran out of space, and intentionally send back a message to a user telling them ‘YOU ran out of quota’, instead of ‘OUR disk is full’.



If the intent is to inform the user that they exceeded their quota, it’s better to use the more appropriate 413 Payload Too Large.



References